Re: [docbook-apps] Entity newbie question

["Bob Stayton" <bobs@sagehill.net>]

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
bobs@sagehill.net


----- Original Message ----- 
From: "Andreas Kehlenbach" <keh@parsytec.de>
To: <docbook-apps@lists.oasis-open.org>
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: docbook-apps-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org