[Lcd4linux-devel] how to make documentation ? maybe xslt !

[Xavier V. <xav...@fr...>]

Hello list ! (Jerry, I put you in CC in case you weren't in the list)

While browsing blogs, I found a discussion about php versus xslt versus
m4 versus docbook versus Perl ... on how to automatically generate html
pages with scripts, and I remembered our little project (which seems
sleeping this month).

I don't renounce to php, don't panic ;) But there was the problem of
documentation. Somebody (me ?) proposed to look at docbook, but it's
definitely too hard for me to create dsssl stylesheets, and moreover my
docbook installation seems broken :/ Another solution was to use XML
stylesheets with docbook, but the situation is even worse in my poor
woody.
A good solution appeared to me : XSLT. Don't rush on
google.[fr|at|com|de|...] and read more : XSLT works with a xml document
containing the text and some markup and a xsl stylesheet, which defines
how to do the transfomation from xml to whatever other markup language
(in our case, xhtml). The best (most complete) xslt processor seems to
be xsltproc and it does very well its job.

So, then I found the logidee-tools. It's avaible at
www.logidee.com/tools/ or in a debian package for the power users ;).
It's a compilation of stylesheets and make scripts to write courses and
publish them in html or pdf/ps (via LaTeX). And it's written by two
frenchies ;)
We can't use the stylesheets as is, but I'll be easy to adapt them to
our needs (one for the website, another for documentation in the
tarball). I'll try work on it soon, but I have to go back to school
tomorrow :(

Bye !
--------
Xavier VELLO