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

[Jerry S. <ye...@th...>]

Hello,

On Sun, Apr 18, 2004 at 10:30:20PM +0200, Xavier VELLO wrote:
> Hello list ! (Jerry, I put you in CC in case you weren't in the list)
> 
> 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.

Nod.  I have converted my original man page over to docbook.  I've been
meaning to work more on the conversion to html.

> 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.

I agree that XSLT is easier to use than dsssl and think it would be 
a better choice to transform the docbook source to html.

> 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 ;)

Aha!  I should have known! ;)

> 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 :(

Bah.  lcd4linux will still be here once school is done. :)

As for as logidee is concerned, one problem with it is the
documentation.  Since there is no documentation written in English,
it leaves english-only speakers such as myself in the dark.  You would
have to do it all...

Is the logidee package simply a set of XSLT transforms, or is there more
to it?

Do you want the documentation that is in (X)html format to be only html,
or do you need to have php source in them so that they integrate with
the rest of the website?

Jerry

-- 
Jerry Seutter

Email: ye...@th...
Web: http://www.thegeeks.net/~yello
Gallery: www.thegeeks.net/~yello/gallery (email me for username and password).