OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]

Subject: Re: DOCBOOK: Re: Which Variant of DocBook (SGML or XML)?

/ Karl Eichwalder <keichwa@gmx.net> was heard to say:
| Norman Walsh <ndw@nwalsh.com> writes:
| > To the greatest extent possible, there are no differences between the
| > two versions. With an eye to the future, if you have no SGML legacy,
| > you should use the XML version.
| With the XML version you're not able to detect "errors" like
|   <para><footnote>
|     <para>
|      <footnote><para></para></footnote>
|     </para>
|    </footnote>
|   </para>
| XML lacks inclusion/exlusion exceptions.

Right. The lack of inclusions and exclusions and INCLUDE/IGNORE marked
sections in a document are examples of things beyond "the greatest
extent possible". But I stand by my assertion, if you don't have SGML
legacy, XML is the future.

| Once available, a SCHEME based
| validation process might help.  Maybe, a DTD based validation isn't
| strong enough for your purposes; in this case you'll have to wait for
| a schema implementation.

It would be fairly easy to write a validator to check for things like
nested footnotes, if you're concerned that your authors might do that.
This XSL stylesheet will do the trick, in fact:

<?xml version='1.0'?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"

<xsl:output method="text"/>

<xsl:template match="text()">
  <!-- suppress -->

<xsl:template match="*">

<xsl:template match="footnote//footnote">
  <xsl:message>Warning: document contains nested footnotes.</xsl:message>


| > Note that you can process the XML version with either XSL or DSSSL
| > (because XML is SGML).  (And you could, in theory, process the SGML
| > version with XSL too, if someone would write an SGML-based XSLT
| > processor.
| Isn't it enough to run `sgmlnorm' and `sx' on any SGML document?  I'm

Yes, it's usually sufficient to run sgmlnorm and sx, I was merely
pointing out that there's nothing about XSLT that requires the input
byte-stream to be an XML document. XSLT is a tree-to-tree
transformation process.

| not aware of an XSLT processor which requires an XML schema.

I don't follow. I was talking about SGML, not XML Schemas.

                                        Be seeing you,

Norman Walsh <ndw@nwalsh.com>      | The function of the imagination is
http://www.oasis-open.org/docbook/ | not to make strange things
Chair, DocBook Technical Committee | settled, so much as it is to make
                                   | settled things strange.--G. K.
                                   | Chesterton

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]

Powered by eList eXpress LLC