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

Re: DocBook: Need Example Files and Scripts



On Tue, Sep 17, 2002 at 09:34:11PM -0400, Abdul Latip wrote:
> Greetings:
> 
> I am not sure if this belongs to debian-doc or debian-user; so I
> send it to this list. May I know, where and how to get the SGML
> source of Debian Documents?

Sure, http://www.debian.org/doc/cvs


> Or, could someone send me or show me an URL about a recent example
> of using DocBook (DTD or XML): a real simple article or simple book,
> and its scripts.  Version 4.1 or higher is prefarable, but 3.1 is OK
> too.

It's old, but I found this article from Mark Galassi at Cygnus very
useful to get started with DocBook
http://nis-www.lanl.gov/~rosalia/mydocs/docbook-intro/docbook-intro.html

 
> I have read all documents I know:
> - DocBook: The Definitive Guide
> - LDP Author Guide
> - HOWTO-Template
> - SGMLTOOLS lite
> 
> Unfortunately, I could not find sufficient working examples.
> E.g.:
> - How make/add  a simple style modification?

I generally use the DSSSL stylesheets (Debian package docbook-dsssl),
documentation on customizing them can be found here:

  http://docbook.sourceforge.net/release/dsssl/current/doc/


> - How to change things like "Table of Contents" into
>   another language.

As far as I know, the DSSSL stylesheets really aren't well suited to
internationalization.  On the other hand, the less mature XSL
stylesheets (Debian package docbook-xsl) have internationalization
support as one of its stated design goals.  You might be better off
working with those.  Find more info here:

  http://nwalsh.com/docs/articles/dbdesign/
  http://docbook.sourceforge.net/release/xsl/current/doc/


> Therefore, I would be very happy if someone could send me
> this information.

I hope the above is useful to you.

There is also an excellent mailing list for docbook-specific
questions, more info here:
  http://www.oasis-open.org/committees/docbook/mailinglist/index.shtml

Best of luck, 
-Gleef

-- 
 



Reply to: