[Scilab-Dev] Trying to update help_from_sci

[Pierre Vuillemin]

Thanks for the answers and the hints, I have finally managed to do what
I wanted using xmltojar and add_help_chapter.

The xml file generated with help_from_sci seems to have some quirk, is
there a reference page concerning the xml that should be produced? The
main reference I have found is this page [1] but I don't know if it is
still up to date.

Besides, I am thinking about extending the features of the routine so
that is supports some flavour of markdown (or similar stuff like
Matlab's publishing features [2]). 
Has there already been some reflection in that direction? 

Regards, 

Pierre

Le 10.05.2017 12:33, sgougeon at free.fr a écrit : 

> Hello,
> 
>> De: "Clément David"
>> 
>> Hello Pierre,
>> 
>> Currently the easiest way is to put the resulting xml file as an exemple of an empty toolbox and
>> build/load this toolbox to check for the rendering.
>> 
>> HTML files can also be used as an easy content to check using a standard web browser (eg. without
>> loading the toolbox). See xmltoweb() to generate it.
>> 
>> AFAIK Samuel usually commit updated help files using the pdf format produced by xmltopdf(). As this
>> PDF backend is not the main one, I tend to prefer the HTML ones but PDF might be a good alternative.
> 
> AFAIRemember, xmltopdf() has some issue, so i use now PDF Creator
> applied the HTML.
> To illustrate the whole page setting and rendering, PDF does not need
> to be zipped,
> whereas HTML needs it to include css dependencies etc.
> 
> Anyway, the rendering of the HTML (zipped in the .jar) through the
> Scilab helpbrowser
> is limited wrt the true HTML as it appears in web browsers: Many
> attributes or style
> values are well built but are not rendered... But this is another thread.
> 
> Regards
> Samuel
> 
> _______________________________________________
> dev mailing list
> dev at lists.scilab.org
> http://lists.scilab.org/mailman/listinfo/dev
 

Links:
------
[1] https://help.scilab.org/docs/6.0.0/fr_FR/man.html
[2]
https://fr.mathworks.com/help/matlab/matlab_prog/marking-up-matlab-comments-for-publishing.html
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.scilab.org/pipermail/dev/attachments/20170510/c44e01b9/attachment.htm>