[docbook-apps] customize xref to title

[Neil Roeth <neil@occamsrazor.net>]

On Jan 23, Kevin Dunn (kdunn@hsc.edu) wrote:
 > I would like to allow xrefs to titles. I have customized my dsl stylesheets to generate the page number on which the title appears, so, for example:
 > 
 > <xref linkend="A_SECTION"/><xref linkend="TITLE_OF_SECTION"/>
 > 
 > Produces the text:
 > 
 > Section 6.7 (p. 68)
 > 
 > The stylesheet works perfectly, but jade complains:
 > 
 > [xref to title unsupported]
 > 
 > This is just an annoyance, since the pdf target is correcly generated, but I would like to get rid of the error messages.
 > How can I customize the dtd to allow xref to titles? I tried:
 > 
 > <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.1/docbookx.dtd";[
 > <!ENTITY % local.title.attrib "xref">
 > 
 >  but that didn't do it. 

It appears to me that message is generated in the common/dbl1en.dsl file, and
you need to add an item to en-xref-strings (in the same file), something like this:

(list (normalize "title") "")

I defined this to be an empty string because I presume you do some special
handling to get the page number and format the text so that the result is like
your example above, so that the normal generation of the xref string is not
needed.

I think you could either create a local copy of the dbl1en.dsl file and make
sure it gets used instead of the standard one, or you might be able to just
append the new item to the variable en-xref-strings in your custom stylesheet.

-- 
Neil Roeth