doc/xslt/params/variablelist.as.table.xml

   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="variablelist.as.table">
   7 <refmeta>
   8 <refentrytitle>variablelist.as.table</refentrytitle>
   9 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
  10 </refmeta>
  11 <refnamediv>
  12 <refname>variablelist.as.table</refname>
  13 <refpurpose>Format <tag>variablelist</tag>s as tables?</refpurpose>
  14 </refnamediv>
  15
  16 <refsynopsisdiv>
  17 <src:fragment xml:id="variablelist.as.table.frag">
  18 <xsl:param name="variablelist.as.table" select="0"/>
  19 </src:fragment>
  20 </refsynopsisdiv>
  21
  22 <refsection><info><title>Description</title></info>
  23
  24 <para>If non-zero, <tag>variablelist</tag>s will be formatted as
  25 tables. A processing instruction exists to specify a particular width for the
  26 column containing the <tag>term</tag>s:
  27 <tag class="xmlpi">dbhtml term-width=".25in"</tag></para>
  28
  29 <para>You can override this setting with a processing instruction as the
  30 child of <tag>variablelist</tag>: <tag class="xmlpi">dbhtml
  31 list-presentation="table"</tag> or <tag class="xmlpi">dbhtml
  32 list-presentation="list"</tag>.</para>
  33
  34 <para>This parameter only applies to the HTML transformations. In the
  35 FO case, proper list markup is robust enough to handle the formatting.
  36 But see also <parameter>variablelist.as.blocks</parameter>.</para>
  37
  38 <programlisting>  &lt;variablelist&gt;
  39         &lt;?dbhtml list-presentation="table"?&gt;
  40         &lt;?dbhtml term-width="1.5in"?&gt;
  41         &lt;?dbfo list-presentation="list"?&gt;
  42         &lt;?dbfo term-width="1in"?&gt;
  43         &lt;varlistentry&gt;
  44           &lt;term&gt;list&lt;/term&gt;
  45           &lt;listitem&gt;
  46                 &lt;para&gt;
  47                   Formatted as a table even if variablelist.as.table is set to 0.
  48                 &lt;/para&gt;
  49           &lt;/listitem&gt;
  50         &lt;/varlistentry&gt;
  51   &lt;/variablelist&gt;</programlisting>
  52
  53 </refsection>
  54 </refentry>