stylesheets/evergreen_docbook_files/docbook-xsl-1.75.2/params/l10n.gentext.use.xref.language.xml

   1 <refentry xmlns="http://docbook.org/ns/docbook"\r
   2           xmlns:xlink="http://www.w3.org/1999/xlink"\r
   3           xmlns:xi="http://www.w3.org/2001/XInclude"\r
   4           xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"\r
   5           xmlns:xsl="http://www.w3.org/1999/XSL/Transform"\r
   6           version="5.0" xml:id="l10n.gentext.use.xref.language">\r
   7 <refmeta>\r
   8 <refentrytitle>l10n.gentext.use.xref.language</refentrytitle>\r
   9 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
  10 </refmeta>\r
  11 <refnamediv>\r
  12 <refname>l10n.gentext.use.xref.language</refname>\r
  13 <refpurpose>Use the language of target when generating cross-reference text?</refpurpose>\r
  14 </refnamediv>\r
  15 \r
  16 <refsynopsisdiv>\r
  17 <src:fragment xml:id="l10n.gentext.use.xref.language.frag">\r
  18 <xsl:param name="l10n.gentext.use.xref.language" select="0"/>\r
  19 </src:fragment>\r
  20 </refsynopsisdiv>\r
  21 \r
  22 <refsection><info><title>Description</title></info>\r
  23 \r
  24 <para>If non-zero, the language of the target will be used when\r
  25 generating cross reference text. Usually, the <quote>current</quote>\r
  26 language is used when generating text (that is, the language of the\r
  27 element that contains the cross-reference element). But setting this parameter\r
  28 allows the language of the element <emphasis>pointed to</emphasis> to control\r
  29 the generated text.</para>\r
  30 \r
  31 <para>Consider the following example:</para>\r
  32 \r
  33 <informalexample>\r
  34 <programlisting>&lt;para lang="en"&gt;See also &lt;xref linkend="chap3"/&gt;.&lt;/para&gt;\r
  35 </programlisting>\r
  36 </informalexample>\r
  37 \r
  38 <para>Suppose that Chapter 3 happens to be written in German.\r
  39 If <parameter>l10n.gentext.use.xref.language</parameter> is non-zero, the\r
  40 resulting text will be something like this:</para>\r
  41 \r
  42 <blockquote>\r
  43 <para>See also Kapital 3.</para>\r
  44 </blockquote>\r
  45 \r
  46 <para>Where the more traditional rendering would be:</para>\r
  47 \r
  48 <blockquote>\r
  49 <para>See also Chapter 3.</para>\r
  50 </blockquote>\r
  51 \r
  52 </refsection>\r
  53 </refentry>\r