docbook-apps

Which is the preferred mode for editing DocBook V5.0 docs? Which is
the most popular? Is psgml being deprecated? Does psgml have a lot of
features that are missing in nXML? I've got nXML working with a
V5.0CR5 docbook.rnc. It seems pretty good.

I wanted to try out psgml to compare, but I haven't got it to work. My
test file is below. If I run sgml-parse-prolog it seems to run without
errors.

If I C-c C-o I get ``XML is not in any name group for element
ARTICLE'', pointing to the : in xml:lang in the article tag.

If I make the article tag simply

I get ``Start-tag of
undefined element ARTICLE; assume O O ANY'' from C-c C-o.

I wonder if the problem is with the "file:/home/jra/..." in .... If I make it "/home/jra/..." (no file:) or "file://home/jra/..."
(use //) I get:

sgml-error: Name expected; at: :id ID #IMPL
- line 2 col 11 entity db.common.attributes
/home/jra/usr/DocBook_V5.0CR5/docbook.dtd line 42 col 30 entity ARTICLE
/home/jra/Projects/Side-Projects/docbook/test-dtd/testdoc.sgml line 2 col 101

The line in the dtd it is complaining about is:

xmlns CDATA #FIXED "http://docbook.org/ns/docbook"
role CDATA #IMPLIED
%db.common.attributes; <------- THIS ONE
%db.common.linking.attributes;
>

Any ideas? Is it worth looking into psgml, or should I just run with nXML?

Thanks, Jason


"file:/home/jra/usr/DocBook_V5.0CR5/docbook.dtd">

<info>

</info>
<sect1>

<sect2>

<para>
Xxxx xxxxxx xxxxxxxx xxx xxxxxx xx xxxxxx xxx x x xxxx.
</para>
</sect2>
</sect1>

> Which is the preferred mode for editing DocBook V5.0 docs? Which is
> the most popular? Is psgml being deprecated? Does psgml have a lot of
> features that are missing in nXML? I've got nXML working with a
> V5.0CR5 docbook.rnc. It seems pretty good.

I have been using DocBook 5.0 and nXML intensively for the last 3-4 months
and I'm very happy with it.

I have had to do a lot of customization layer hacking to satisfy the SAE
standards document style requirements, and I've had to write transforms to
convert custom XML specifications to DocBook tables.

The ability to register xsl files and apply them to XML within emacs using
xslt is fast and convenient. The schema element completion <C-return> is
fast and helpful.

I keep an oXygen project current for the rest of the team and have
occasionally used oXygen's excellent debugging facilities, but for
day-to-day DocBook XML and customization layer work, I use emacs/nXML.

PSGML may be way better, but I haven't needed to try it. Anyone?

Jim