RE: [docbook] including a customized en.xml file

["Mauritz Jeanson" <mj@johanneberg.com>]

> -----Original Message-----
> From: ettinger@gmail.com 
> 
> How is it included now? It isn't in docbook.xsl directly.
> 
> I don't really want l10n living in my top-level customization layer,
> there must be a way somehow.


1. The standard en.xml is found via the l10n.xml parameter in
common/l10n.xsl:

 <xsl:param name="l10n.xml" select="document('../common/l10n.xml')"/>

The l10n.xml file collects all gentext strings for all supported languages.
The lookup mechanism in l10n.xsl locates the strings for a particular
language depending on the value of the lang (xml:lang in DocBook 5)
attribute in the XML source ("en" is the default).

2. Your own customized generated text is located by the local.l10n.xml
parameter: 

 <xsl:param name="local.l10n.xml" select="document('')"/>

The document() function with an empty argument means the stylesheet itself.
So the stylesheet looks into itself to find the customized strings.

3. If you want, you can put all customizations related to generated text in
a separate file. Here is how:

A. Put your gentext customizations in a file that is structured like this:

<l:i18n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0";>
  <l:l10n language="en" english-language-name="English">
  
    <!-- Your customizations go here, for example: -->
    <l:context name="xref-number-and-title">
      <l:template name="chapter" text="Chapter %n: &#8220;%t&#8221;"/>
    </l:context>
	 
 </l:l10n>
</l:i18n>

B. Name this file local.en.xml (or whatever you want) and save it in the
same directory as your already existing stylesheet customization.

C. Modify local.l10n.xml in your stylesheet customization:

 <xsl:param name="local.l10n.xml" select="document('local.en.xml')"/>

/MJ