Re: DOCBOOK: Primer needed: XML-encoded documents using SGML tools.

[Robert Withrow <bwithrow at nortelnetworks dot com>]

Norm and Mark:

Thanks for the replies.  I think this topic is ripe for treatment in
the next edition of the Book, since it touches a lot of different
areas: tools, catalogs, etc.  No one document seems to cover it all
and it is a scary area for us beginners.  The the call for a primer.

It turns out that to use jade with XML, the jade documentation says:

  To enable SP's support for XML 1.0: 

    Set the SP_CHARSET_FIXED environment variable to YES. 
    Set the SP_ENCODING environment variable to XML. 
    Set the SGML_CATALOG_FILES environment variable to point to the file pubtext/xml.soc. 
    Use the -wxml option. 

The "pubtext" directory wasn't installed for some reason by the
FreeBSD port (I'll let the port maintainer know).  I installed it.

If I follow the above directions and set:

  SGML_CATALOG_FILES=/usr/local/share/sgml/pubtext/xml.soc:/usr/local/share/sgml/catalog

and have the /usr/local/share/sgml/catalog file contain:

  CATALOG "/usr/local/share/sgml/jade/catalog"
  CATALOG "iso8879/catalog"
  CATALOG "docbook/catalog"
  CATALOG "/usr/local/share/xml/catalog"

Then I get the following (still problematic results).

For this document:

  <?xml version='1.0'?> <!-- -*- DocBook -*- -->
  <!DOCTYPE figure
    PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd";>
  <figure><title>The Figure</title>
  <graphic fileref="foo.gif" format="GIF"></graphic>
  </figure>

I get:

  bash-2.03$ nsgmls -s -wxml figure.xml
  nsgmls:figure.xml.orig:4:60:E: URL not supported by this version
  nsgmls:figure.xml.orig:4:60:E: DTD did not contain element declaration for document type name
  nsgmls:figure.xml.orig:6:7:E: element "figure" undefined
  nsgmls:figure.xml.orig:6:14:E: element "title" undefined
  nsgmls:figure.xml.orig:7:17:E: there is no attribute "fileref"
  nsgmls:figure.xml.orig:7:34:E: there is no attribute "format"
  nsgmls:figure.xml.orig:7:39:E: element "graphic" undefined

For this version (deleting the http:... stuff):

  <?xml version='1.0'?> <!-- -*- DocBook -*- -->
  <!DOCTYPE figure
    PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN">
  <figure><title>The Figure</title>
  <graphic fileref="foo.gif" format="GIF"></graphic>
  </figure>

I get:

  bash-2.03$ nsgmls -s -wxml figure.xml
  nsgmls:figure.xml:3:47:W: no system id specified

So, is this just a tool problem?  The "not supported by this version"
is suspicious, but the DOCTYPE declaration is correct, no?.  I'm using
jade-1.2.1.

Thanks!

------------------------------------------------------------------
To unsubscribe from this elist send a message with the single word
"unsubscribe" in the body to: docbook-request@lists.oasis-open.org