docbook-apps

Another person and I are consistently seeing errors when we run xsltproc,
including not just our own files (which validate to docbook 5.0 in xmlmind)
but also with the test files provided with xlstproc. The files are still
created and all the links work. We are using current versions of libxml2 and
libxslt.

C:\>xsltproc c:\xmltools\docbook-xsl\xhtml\chunk.xsl
c:\xmltools\docbook-xsl\tests\refentry.007.ns.xml

Note: namesp. cut : stripped namespace before processing Unit
Test: refentry.007
WARNING: cannot add @xml:base to node set root element. Relative paths may
not work.
Note: namesp. cut : processing stripped document Unit
Test: refentry.007
Writing rn01re01.html for refentry
Writing rn01.html for reference
Writing index.html for book

Thoughts?

Ancillary n00b question: I thought the namespace declaration was key to 5.0,
q.v. http://www.docbook.org/docs/howto/ . So why strip the namespace?


--
--
| Karen G. Schneider
| Community Librarian
| Equinox Software Inc. "The Evergreen Experts"
| Toll-free: 1.877.Open.ILS (1.877.673.6457) x712
| kgs@esilibrary.com
| Web: http://www.esilibrary.com
| Be a part of the Evergreen International Conference, May 20-22, 2009!
| http://www.solinet.net/evergreen

Hi Karen,

The messages you see are described in Bob Stayton's DocBook XSL: The
Complete Guide, here:
http://www.sagehill.net/docbookxsl/Db5Tools.html#ConvertToDb5

"""
Using DocBook 4 stylesheets with DocBook 5

The original DocBook XSL stylesheets written for Docbook 4 documents
would not normally work with DocBook 5 documents. That's because a
pattern match in an XSL template must match on any namespace as well
as the local name of an element. When you process a DocBook 5 document
with the original stylesheets, none of the pattern matching templates
include the DocBook 5 namespace, so none of the templates will match
any elements in the document.

The stylesheets work around this problem with a simple mechanism. If
the stylesheet detects a document whose root element is in the DocBook
5 namespace, it first copies the entire document into a variable while
stripping out the namespace from all the elements. The stylesheet then
converts the variable into a node set, and applies templates to the
node set normally. Because the elements in the node set are no longer
in the DocBook 5 namespace, its elements will match the patterns in
the original stylesheets. All this takes place automatically before
the actual processing starts.

The result is that you can process DocBook 5 documents with the same
commands as for DocBook 4 documents. You will see these messages
indicating what is going on:

Stripping namespace from DocBook 5 document.
Processing stripped document.
"""

Regards,
Keith

This is a very diplomatic way of goosing me to buy and read the book -- now
scooted up to "can I find a copy in Tallahassee today to drag with me to
next week's conference so I can sit in the back of the room and read." thank
you. And thanks to Bob Stayton for his slides, which a documentation intern
with our project also found extremely helpful.

Buying! Reading! Now!

Karen

On Fri, Feb 20, 2009 at 9:33 AM, Keith Fahlgren <abdelazer@gmail.com> wrote:

> Hi Karen,
>
> The messages you see are described in Bob Stayton's DocBook XSL: The
> Complete Guide, here:
> http://www.sagehill.net/docbookxsl/Db5Tools.html#ConvertToDb5
>
> """
> Using DocBook 4 stylesheets with DocBook 5
>
> The original DocBook XSL stylesheets written for Docbook 4 documents
> would not normally work with DocBook 5 documents. That's because a
> pattern match in an XSL template must match on any namespace as well
> as the local name of an element. When you process a DocBook 5 document
> with the original stylesheets, none of the pattern matching templates
> include the DocBook 5 namespace, so none of the templates will match
> any elements in the document.
>
> The stylesheets work around this problem with a simple mechanism. If
> the stylesheet detects a document whose root element is in the DocBook
> 5 namespace, it first copies the entire document into a variable while
> stripping out the namespace from all the elements. The stylesheet then
> converts the variable into a node set, and applies templates to the
> node set normally. Because the elements in the node set are no longer
> in the DocBook 5 namespace, its elements will match the patterns in
> the original stylesheets. All this takes place automatically before
> the actual processing starts.
>
> The result is that you can process DocBook 5 documents with the same
> commands as for DocBook 4 documents. You will see these messages
> indicating what is going on:
>
> Stripping namespace from DocBook 5 document.
> Processing stripped document.
> """
>
> Regards,
> Keith
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
>
>


--
--
| Karen G. Schneider
| Community Librarian
| Equinox Software Inc. "The Evergreen Experts"
| Toll-free: 1.877.Open.ILS (1.877.673.6457) x712
| kgs@esilibrary.com
| Web: http://www.esilibrary.com
| Be a part of the Evergreen International Conference, May 20-22, 2009!
| http://www.solinet.net/evergreen