docbook-apps

  • 1.  Stripping namespace from DocBook 5 document

    Posted 07-19-2007 19:30
    When I "compile" my DocBook file from within emacs's nxml mode:

    -*- mode: compilation; default-directory: "~/public_html--Hayek.name/" -*-
    Compilation started at Thu Jul 19 20:58:29

    make -k html
    env XML_CATALOG_FILES=/etc/xml/catalog \
    xsltproc \
    --output book.html \
    _xsl/html--docbook.xsl \
    book.xml
    Stripping namespace from DocBook 5 document.
    WARNING: cannot add @xml:base to node set root element. Relative paths may not work.
    Processing stripped document.

    Compilation finished at Thu Jul 19 20:58:31

    I'm getting a few strange messages:

    Stripping namespace from DocBook 5 document.
    WARNING: cannot add @xml:base to node set root element. Relative paths may not work.
    Processing stripped document.

    This is how my document starts:





    I am sure I did not get those messages, when I used DocBook 4.5,
    only when I migrated to DocBook 5, I introduced "that namespace stuff"
    and I started getting these messages.

    Maybe I haven't gotten it entirely right ...


    How serious shall I take those 3 messages?
    And what impact do they really have?
    Can I get rid of a few of them?

    I mean, I only introduced "that namespace stuff", so that nxml mode wouldn't mourn at me
    and so that the document complies to what I found at

    http://www.oasis-open.org/docbook/specs/docbook-5.0b6-spec-wd-01.html

    which looks to me (according to http://www.oasis-open.org/docbook/specs/)
    like the latest document on DocBook 5.



  • 2.  Re: [docbook-apps] Stripping namespace from DocBook 5 document

    Posted 07-23-2007 10:38
    Jochen+oasis-open@Hayek.name, 2007-07-19 21:30 +0200:

    > I'm getting a few strange messages:
    >
    > Stripping namespace from DocBook 5 document.
    > WARNING: cannot add @xml:base to node set root element. Relative paths may not work.
    > Processing stripped document.
    [...]
    > How serious shall I take those 3 messages?
    > And what impact do they really have?

    As Bob has pointed out, the "Stripping..." and "Processing..."
    messages are informative messages that indicate normal, expected
    behavior. So you can effectively ignore them.

    The message about the xml:base issue is a warning. I think it
    indicates that if you have used relative paths (to images or
    whatever), they may not work as expected. But it's not an outright
    error.

    > Can I get rid of a few of them?

    (Also as Bob has pointed out), If you're working with namespaced
    (DocBook 5) documents, you should probably use the docbook-xsl-ns
    stylesheets. The latest releases versions of those are here:

    http://docbook.sf.net/files/xsl-ns/latest

    --
    Michael(tm) Smith
    http://people.w3.org/mike/
    http://sideshowbarker.net/