Hi Andreas,
Thanks for bringing this up, because it made me realize I had introduced a
bug.
The 'lang' entity is used internally by the DocBook XSL stylesheets, so it
is not an entity you need to set in your documents. Your document should
have a lang or xml:lang attribute on the root element to establish the
document's language code.
The "kimber" method of indexing uses Saxon extension functions written by
Eliot Kimber to enable more advanced functions for grouping and sorting
index entries. It requires an XSL key that includes the current lang, but
a key cannot accept a parameter value. So the stylesheet uses an entity
which is populated when the stylesheet runs.
The bug is the "en" at the end of the concat function in the entity
declaration. That was a test I was doing to see if I could create a
fallback lang if none were specified. It didn't work, because it was
always appended, leading to lang entity values like "de-DEen" rather than
"de-DE". I didn't mean to leave that in the distribution. As it is, the
kimber method won't work with it in there. I just checked a fix into the
source tree, and I'll test it when we get the builds working again.
It does mean that to use the kimber indexing method, your documents must
have a lang or xml:lang attribute on the root element, and the
configuration file for the kimber method (as described in the Isogen
whitepaper) must have a index_config element containing a national_language
element whose value matches that lang string.
Bob Stayton
Sagehill Enterprises
DocBook Consulting
----- Original Message -----
From: "Andreas Kehlenbach" <>
To: <>
Sent: Wednesday, July 12, 2006 4:12 AM
Subject: [docbook-apps] Entity newbie question
Hi folks,
I have a problem with this Entity.
<!-- Documents using the kimber index method must have a lang attribute
-->
<!-- Only one of these should be present in the entity -->
<!ENTITY lang 'concat(/*/@lang, /*/@xml:lang, "en")'>
Found in the html/autoidx.xsl .
What is the function of these Entity, i didn't found any wring Syntax in
my XML document. I declared an lang="en" attribute in the <book> -tag.
What's going wrong?
Greez Andreas
---------------------------------------------------------------------
To unsubscribe, e-mail:
For additional commands, e-mail: