[scilab-Users] Add chapters to Scilab help system

[José Luis Volta Grau]

Thank you, Eric, that really help me a lot;

I'd writen some help files in XML language, following the scheme of the "help_skeleton" function; then I translate them using the "xmltohtml" function; to load these .htmls' in the Scilab help system I ran "add_help_chapter" function; this works fine in 4.1.2 release.

Do you mean I should have to change "xmltohtml" by "xmltojar"; or maybe I have to use the new version of XML "help_skeleton" with Sci-5.2 ?

I will try both...

J.L.
  ----- Original Message ----- 
  From: Eric Dubois 
  To: users at lists.scilab.org 
  Sent: Friday, December 25, 2009 6:51 AM
  Subject: Re: [scilab-Users] Add chapters to Scilab help system


  Hi

  There are indeed big differences between the 4.1.2 and the 5.2.0.

  The greatest is that help files must now be written in the XML langage and strictly comply with Scilab specifications.

  When your help files comply with Scilab specifications that you have to run xml2jar('avaHelp',helps_dirs,helps_titles)

  And once it has been done, you must run:
  add_help_chapter(your title','helps_dir',%f);

  To understand how it works, you can for instance have a look at Torbjørn Pettersen toolbox guimaker (1.2) (http://www.scilab.org/contrib/index_contrib.php?page=listdyn&order=date).

  If it can help, I have written a Scilab function html2xml.sci to translate my help files. Altough it is only suited to my needs, I think it could be adapted to your needs relatively easily. I join also a html file and its xml version to help you understand how it works. If you need more examples, you can download on my web site (http://dubois.ensae.net/grocer.html) the version of my toolbox for Siclab-4.1.2 and the one for Scilab-5.> and compare the html and xml files resulting from this translation.

  Hope it will help.

  Eric.




  2009/12/24 José Luis Volta Grau <jlvolta at hipuu.com.py>

    Hi,
    I've tried to add a help chapter for my functions to the Scilab-5.2.0 help system, as I did with version 4.1.2
    But Scilab rises an error when I try to access the global constant "%helps", and nothing happens when I use the "add_help_chapter" function (my help chapter doesn't appear).
    What's the difference between the 5.2.0 and 4.1.2 versions ?

    I would appreciate some help,
    J.L.V.

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.scilab.org/pipermail/users/attachments/20091225/91bb1578/attachment.htm>