index.term.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.term.separator">
  7. <refmeta>
  8. <refentrytitle>index.term.separator</refentrytitle>
  9. <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
  10. </refmeta>
  11. <refnamediv>
  12. <refname>index.term.separator</refname>
  13. <refpurpose>Override for punctuation separating an index term
  14. from its list of page references in an index</refpurpose>
  15. </refnamediv>
  16. <refsynopsisdiv>
  17. <src:fragment xml:id="index.term.separator.frag">
  18. <xsl:param name="index.term.separator"></xsl:param>
  19. </src:fragment>
  20. </refsynopsisdiv>
  21. <refsection><info><title>Description</title></info>
  22. <para>This parameter permits you to override
  23. the text to insert between
  24. the end of an index term and its list of page references.
  25. Typically that might be a comma and a space.
  26. </para>
  27. <para>Because this text may be locale dependent,
  28. this parameter's value is normally taken from a gentext
  29. template named 'term-separator' in the
  30. context 'index' in the stylesheet
  31. locale file for the language
  32. of the current document.
  33. This parameter can be used to override the gentext string,
  34. and would typically be used on the command line.
  35. This parameter would apply to all languages.
  36. </para>
  37. <para>So this text string can be customized in two ways.
  38. You can reset the default gentext string using
  39. the <parameter>local.l10n.xml</parameter> parameter, or you can
  40. fill in the content for this normally empty
  41. override parameter.
  42. The content can be a simple string, or it can be
  43. something more complex such as a call-template.
  44. For fo output, it could be an <tag>fo:leader</tag>
  45. element to provide space of a specific length, or a dot leader.
  46. </para>
  47. </refsection>
  48. </refentry>