stylesheets/styleguide/docbook-xsl-1.75.2/params/variablelist.max.termlength.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="variablelist.max.termlength">\r
   7 <refmeta>\r
   8 <refentrytitle>variablelist.max.termlength</refentrytitle>\r
   9 <refmiscinfo class="other" otherclass="datatype">number</refmiscinfo>\r
  10 </refmeta>\r
  11 <refnamediv>\r
  12 <refname>variablelist.max.termlength</refname>\r
  13 <refpurpose>Specifies the longest term in variablelists</refpurpose>\r
  14 </refnamediv>\r
  15 \r
  16 <refsynopsisdiv>\r
  17 <src:fragment xml:id="variablelist.max.termlength.frag">\r
  18 <xsl:param name="variablelist.max.termlength">24</xsl:param>\r
  19 </src:fragment>\r
  20 </refsynopsisdiv>\r
  21 \r
  22 <refsection><info><title>Description</title></info>\r
  23 \r
  24 <para>In variablelists, the <tag>listitem</tag>\r
  25 is indented to leave room for the \r
  26 <tag>term</tag> elements. That indent may be computed\r
  27 if it is not specified with a <tag class="attribute">termlength</tag>\r
  28 attribute on the <tag>variablelist</tag> element.\r
  29 </para>\r
  30 <para>\r
  31 The computation counts characters in the \r
  32 <tag>term</tag> elements in the list\r
  33 to find the longest term.  However, some terms are very long\r
  34 and would produce extreme indents.  This parameter lets you\r
  35 set a maximum character count.  Any terms longer than the maximum\r
  36 would line wrap.  The default value is 24.\r
  37 </para>\r
  38 <para>\r
  39 The character counts are converted to physical widths\r
  40 by multiplying by 0.50em. There will be some variability\r
  41 in how many actual characters fit in the space\r
  42 since some characters are wider than others.\r
  43 </para>\r
  44 \r
  45 </refsection>\r
  46 </refentry>\r