Mailinglist Archive: opensuse-doc (40 mails)

< Previous Next >
Re: [opensuse-doc] Thread summary and announcement [was:The openSUSE distribution chages are way ahead of documentation?]
  • From: Thomas Schraitle <thomas.schraitle@xxxxxxx>
  • Date: Tue, 10 Oct 2006 14:44:47 +0200
  • Message-id: <200610101444.48232.thomas.schraitle@xxxxxxx>
Hi Alexey,

On Tuesday 10 October 2006 10:22, Alexey Eremenko wrote:
> [...]
> I am a bit afraid of the new format, DocBook. Why use it ?
> I feel more comfortable with HTML for documentation.

If you know how to write HTML then you shouldn't have any difficulties
using DocBook.

If you write in a single source environment HTML is not a good option.
DocBook is one of the formats that is used frequently by
documentation people (although DITA seems to get some speed, but
that's another story.)

DocBook is a stable DTD with very good XSLT stylesheets that can
create HTML, Manpages, PDF and other useful things. Do you know the
Linux Documentation Project[1]? A lot of documentation there is
written in DocBook. KDE and GNOME use it too. And Subversion, and ...
you got it. :)


Tom

-------
[1] http://www.tldp.org/

--
Thomas Schraitle

----------------------------------------------------------------------
SUSE LINUX GmbH >o) Documentation Specialist
Maxfeldstrasse 5 /\\
90409 Nuernberg _\_v http://en.opensuse.org/Documentation_Team
---------------------------------------------------------------------
To unsubscribe, e-mail: opensuse-doc+unsubscribe@xxxxxxxxxxxx
For additional commands, e-mail: opensuse-doc+help@xxxxxxxxxxxx

< Previous Next >