]> git.stg.codes - stg.git/blob - doc/xslt/params/default.table.rules.xml
Merge branch 'master' into ticket
[stg.git] / doc / xslt / params / default.table.rules.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="default.table.rules">
7 <refmeta>
8 <refentrytitle>default.table.rules</refentrytitle>
9 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
10 </refmeta>
11 <refnamediv>
12 <refname>default.table.rules</refname>
13 <refpurpose>The default column and row rules for tables using HTML markup</refpurpose>
14 </refnamediv>
15
16 <refsynopsisdiv>
17 <src:fragment xml:id="default.table.rules.frag">
18 <xsl:param name="default.table.rules">none</xsl:param>
19 </src:fragment>
20 </refsynopsisdiv>
21
22 <refsection><info><title>Description</title></info>
23
24 <para>Tables using HTML markup elements can use an attribute
25 named <tag class="attribute">rules</tag> on the <tag>table</tag> or
26 <tag>informaltable</tag> element
27 to specify whether column and row border rules should be 
28 displayed. This parameter lets you specify a global default
29 style for all HTML tables that don't otherwise have
30 that attribute.</para>
31 <para>These are the supported values:</para>
32
33 <variablelist>
34 <varlistentry><term>all</term>
35 <listitem>
36 <para>Rules will appear between all rows and columns.</para>
37 </listitem>
38 </varlistentry>
39
40 <varlistentry><term>rows</term>
41 <listitem>
42 <para>Rules will appear between rows only.</para>
43 </listitem>
44 </varlistentry>
45
46 <varlistentry><term>cols</term>
47 <listitem>
48 <para>Rules will appear between columns only.</para>
49 </listitem>
50 </varlistentry>
51
52 <varlistentry><term>groups</term>
53 <listitem>
54 <para>Rules will appear between row groups (thead, tfoot, tbody).
55 No support for rules between column groups yet.
56 </para>
57 </listitem>
58 </varlistentry>
59
60 <varlistentry><term>none</term>
61 <listitem>
62 <para>No rules.  This is the default value.
63 </para>
64 </listitem>
65 </varlistentry>
66
67 </variablelist>
68
69 <para>The border after the last row and the border after
70 the last column are not affected by
71 this setting. Those borders are controlled by
72 the <tag class="attribute">frame</tag> attribute on the table element.
73 </para>
74
75 </refsection>
76 </refentry>