index.number.separator.xml 1.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354
  1. <refentry xmlns="http://docbook.org/ns/docbook"
  2. xmlns:xlink="http://www.w3.org/1999/xlink"
  3. xmlns:xi="http://www.w3.org/2001/XInclude"
  4. xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
  5. xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
  6. version="5.0" xml:id="index.number.separator">
  7. <refmeta>
  8. <refentrytitle>index.number.separator</refentrytitle>
  9. <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
  10. </refmeta>
  11. <refnamediv>
  12. <refname>index.number.separator</refname>
  13. <refpurpose>Override for punctuation separating page numbers in index</refpurpose>
  14. </refnamediv>
  15. <refsynopsisdiv>
  16. <src:fragment xml:id="index.number.separator.frag">
  17. <xsl:param name="index.number.separator"></xsl:param>
  18. </src:fragment>
  19. </refsynopsisdiv>
  20. <refsection><info><title>Description</title></info>
  21. <para>This parameter permits you to override the text to insert between
  22. page references in a formatted index entry. Typically
  23. that would be a comma and a space.
  24. </para>
  25. <para>Because this text may be locale dependent,
  26. this parameter's value is normally taken from a gentext
  27. template named 'number-separator' in the
  28. context 'index' in the stylesheet
  29. locale file for the language
  30. of the current document.
  31. This parameter can be used to override the gentext string,
  32. and would typically be used on the command line.
  33. This parameter would apply to all languages.
  34. </para>
  35. <para>So this text string can be customized in two ways.
  36. You can reset the default gentext string using
  37. the <parameter>local.l10n.xml</parameter> parameter, or you can
  38. override the gentext with the content of this parameter.
  39. The content can be a simple string, or it can be
  40. something more complex such as a call-template.
  41. </para>
  42. <para>In HTML index output, section title references are used instead of
  43. page number references. This punctuation appears between
  44. such section titles in an HTML index.
  45. </para>
  46. </refsection>
  47. </refentry>