diff options
author | Luca Falavigna <dktrkranz@debian.org> | 2014-04-26 15:11:58 +0200 |
---|---|---|
committer | Luca Falavigna <dktrkranz@debian.org> | 2014-04-26 15:11:58 +0200 |
commit | a3a0ab66f0da855e75e3a0e2acfb8aa106b46510 (patch) | |
tree | 5352edff1387c3d7e5a8b49ec56524f085c22782 /src/engine/SCons/Tool/docbook/docbook-xsl-1.76.1/params/generate.id.attributes.xml | |
parent | 51fa4e4acb6fc8fc7a2af0fbdc21fd1e8feddb3a (diff) | |
parent | 140d836e9cd54fb67b969fd82ef7ed19ba574d40 (diff) |
Merge tag 'upstream/2.3.1'
Upstream version 2.3.1
Diffstat (limited to 'src/engine/SCons/Tool/docbook/docbook-xsl-1.76.1/params/generate.id.attributes.xml')
-rw-r--r-- | src/engine/SCons/Tool/docbook/docbook-xsl-1.76.1/params/generate.id.attributes.xml | 59 |
1 files changed, 59 insertions, 0 deletions
diff --git a/src/engine/SCons/Tool/docbook/docbook-xsl-1.76.1/params/generate.id.attributes.xml b/src/engine/SCons/Tool/docbook/docbook-xsl-1.76.1/params/generate.id.attributes.xml new file mode 100644 index 0000000..6326841 --- /dev/null +++ b/src/engine/SCons/Tool/docbook/docbook-xsl-1.76.1/params/generate.id.attributes.xml @@ -0,0 +1,59 @@ +<refentry xmlns="http://docbook.org/ns/docbook" + xmlns:xlink="http://www.w3.org/1999/xlink" + xmlns:xi="http://www.w3.org/2001/XInclude" + xmlns:src="http://nwalsh.com/xmlns/litprog/fragment" + xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + version="5.0" xml:id="generate.id.attributes"> +<refmeta> +<refentrytitle>generate.id.attributes</refentrytitle> +<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo> +</refmeta> +<refnamediv> +<refname>generate.id.attributes</refname> +<refpurpose>Generate ID attributes on container elements?</refpurpose> +</refnamediv> + +<refsynopsisdiv> +<src:fragment xml:id="generate.id.attributes.frag"> +<xsl:param name="generate.id.attributes" select="0"/> +</src:fragment> +</refsynopsisdiv> + +<refsection><info><title>Description</title></info> + +<para>If non-zero, the HTML stylesheet will generate ID attributes on +containers. For example, the markup:</para> + +<screen><section id="foo"><title>Some Title</title> +<para>Some para.</para> +</section></screen> + +<para>might produce:</para> + +<screen><div class="section" id="foo"> +<h2>Some Title</h2> +<p>Some para.</p> +</div></screen> + +<para>The alternative is to generate anchors:</para> + +<screen><div class="section"> +<h2><a name="foo"></a>Some Title</h2> +<p>Some para.</p> +</div></screen> + +<para>Because the <tag class="attribute">name</tag> attribute of +the <tag>a</tag> element and the <tag class="attribute">id</tag> +attribute of other tags are both of type <quote>ID</quote>, producing both +generates invalid documents.</para> + +<para>As of version 1.50, you can use this switch to control which type of +identifier is generated. For backwards-compatibility, generating +<tag>a</tag> anchors is preferred.</para> + +<para>Note: at present, this switch is incompletely implemented. +Disabling ID attributes will suppress them, but enabling ID attributes +will not suppress the anchors.</para> + +</refsection> +</refentry> |