Re: [Glsdk-devel] Documentation

[Branan R. <br...@gm...>]

In most linux distributions, there are already tools that convert
docbook to other formats - for example, the docbook-utils package has
several commands that read docbook files and output PDF, html, man
pages, even RTF.

If there is a set of tools like this that is available cross-platform,
we don't have to worry about writing any java/c/python/whatever code
to handle docbook files - we just tell people that want to build the
docs themselves what they need to download.

If we just want to convert docbook to HTML or another XML format, a
home-grown XSLT-based solution is probably fine. If we want to be able
to make other formats, an already-written tool is probably better.

Branan

On Fri, Aug 29, 2008 at 11:01 AM, Jason McKesson <ko...@gm...> wrote:
> On Fri, Aug 29, 2008 at 9:46 AM, Branan Riley <br...@gm...> wrote:
>> Yes, technically XSLT is the only way to transform it. I meant there
>> are a number of programs already created that are already layered on
>> top of XSLT, at least in Linux. I don't know about the Windows and Mac
>> worlds. If we can use on of those, it saves us the trouble of writing
>> our own.
>
> I'm not sure I understand what you're talking about when you refer to
> programs that are "layered on top of XSLT." Can you give me an
> example?
>
> We should not be looking for any XSLT implementation on the host
> system. Instead, our system for building documents should use a
> specific XSLT implementation (which takes specific command-line
> arguments), and we should simply deliver the results.
>
> -------------------------------------------------------------------------
> This SF.Net email is sponsored by the Moblin Your Move Developer's challenge
> Build the coolest Linux based applications with Moblin SDK & win great prizes
> Grand prize is a trip for two to an Open Source event anywhere in the world
> http://moblin-contest.org/redirect.php?banner_id=100&url=/
> _______________________________________________
> Glsdk-devel mailing list
> Gls...@li...
> https://lists.sourceforge.net/lists/listinfo/glsdk-devel
>