Re: [docbook-apps] db4 xsl stylesheets 2006-03-11 snapshot ignoring xml:base

["Michael(tm) Smith" <smith@sideshowbarker.net>]

Chris Chiasson <chris@chiasson.name> writes:

> Also, the new stylesheets are printing out reams of warnings about not
> having an id attribute on every chapter, section, etc...

That's by design. If you want to suppress the warnings, you can do
it by setting the value of the "id.warnings" param to 0.

  http://docbook.xml-doc.org/snapshots/xsl/doc/html/id.warnings.html

Description of that param -

  If non-zero, the stylesheet will issue a warning for any element
  (other than the root element) which has a title but does not
  have an ID.

So the best way to fix it is actually to put "id" attributes and
values on all your elements that have titles. In the absence of id
values, the stylesheets have to generate a random ID like "d0e807"
for each of those. Which means for one thing that you end up with
hyperlinks that look like this:

  http://docbook.xml-doc.org/snapshots/xsl/doc/extensions.html#d0e807

When it would be much better to have id="using" on the section
that links to, so that the link would instead be:

  http://docbook.xml-doc.org/snapshots/xsl/doc/extensions.html#using

smime.p7s