discuss: LinuxDoc vs. DocBook, was Re: part of the review?
Subject:
LinuxDoc vs. DocBook, was Re: part of the review?
From:
David Lawyer ####@####.####
Date:
16 Jul 2001 05:23:31 -0000
Message-Id: <20010715221156.B448@lafn.org>
On Sat, Jul 14, 2001 at 11:22:50PM -0700, Poet/Joshua Drake wrote:
> Hello,
>
> We are never going to get anywhere with this David. It is purely opinion.
> On one hand, we have the opinion of major publishers and documentation
> projects that using DocBook is a good choice.
A good choice for them but not for volunteers who may only write a
few pages.
Some things are facts: Here is a comparison of LinuxDoc vs DocBook:
-----------------------------------------------------------------
Comparison of DocBook to LinuxDoc (short).
by David Lawyer, June 23, 2000, revised July 2001
Using DocBook instead of LinuxDoc requires many more tags and the tags
tend to be longer. DocBook tags tend to be nested. The tag clutter
makes DocBook harder to read. Thus DocBook is not nearly as easy to
do by hand. Even with an editor that supports it, there is a lot
more complexity to DocBook.
LinuxDoc is quoted with LD; DocBook with DB.
----------------------------------------------------------------------
Example 1, start of a section
DB <sect>
DB <title>Introduction</title>
LD <sect>Introduction
LD <p>
----------------------------------------------------------------------
Example 2, index terms
DB <indexterm>
DB <primary>disk!introduction</primary>
DB </indexterm>
LD <nidx>disk!introduction</nidx>
---------------------------------------------------------------------
Example 3, paragraphs
DB <para>
DB LinuxDoc needs no paragraph tags. Double spacing suffices.
DB </para>
LD LinuxDoc needs no paragraph tags. Double spacing suffices.
----------------------------------------------------------------------
Example 4, emphasis
DB <emphasis>release</emphasis> release.
LD <em>release</em>.
----------------------------------------------------------------------
Example 5, Itemized lists
DB <ItemizedList>
DB <ListItem> <Para>
DB This is the first item
DB </Para> </ListItem>
DB
DB <ListItem> <Para>
DB This is the second item
DB </Para> </ListItem>
DB
DB <ListItem> <Para>
DB This is the third item
DB </Para> </ListItem>
DB </ItemizedList>
LD <itemize>
LD <item> This is the first item
LD <item> This is the second item
LD <item> This is the third item
LD </itemize>