[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Planning an Italian manual

Ardo van Rangelrooij <ardo.van.rangelrooij@tip.nl> writes:

> > I've started with base structure and used debiandoc-sgml. With
> > debiandoc-sgml is possible to add tables, figures and index? Is
> > planned some internationalization, like "chapter"->"capitolo"?
> Yes, internationalization is definitely planned.  I'm the maintainer
> of the debiandoc-sgml tool and this is one of the first things to be
> done soon. 

Can you please have a look on DocBook!? I encourage to switch to the
DocBook DTD because it is very well designed. This DTD is used by many
companies for their system documentation. Look at
http://www.ora.com/davenport/ for more information about the founders
of DocBook. (And this DTD is actively maintained).

We can use different tools to process the SGML code into HTML and/or
the printing devices. I'm using Norman Welsh Modular DocBook
Stylesheets (http://www.berkshire.net/~norm/dsssl/docbook/). We can
use these style sheets to customize the output for our needs. It's a
very flexible and easy to use approach.

To "Get Going With DocBook" you can read

I really think that improving debiandoc-sgml is a waste of time. I've
modified debiandoc-sgml to support the german language and have
written a debiandoc2latex script including the appropriate latex2e
class. This is all included in the installmanual-de package.

Debiandoc-sgml is much better (cleaner) than the sgml-tools. Ian
Jackson decision for debiandoc was very wise. But in the last few
months there come better (even cleaner, more flexible, more powerful)
tools on the free software market (i.e. jade the DSSSL driven sgml to
HTML, RTF and TeX processor).

All peaces are available as Debian packages from the main

Please have a close look on the mentioned pages and tools.


Christian Leutloff, Aachen, Germany         leutloff@sundancer.oche.de  
      http://www.oche.de/~leutloff/         leutloff@debian.org      

            Debian GNU/Linux - http://www.de.debian.org/

Attachment: pgprnoo4C1ryi.pgp
Description: PGP signature

Reply to: