Swiftdiff options
| author | Remko Tronçon <git@el-tramo.be> | 2010-03-28 19:43:32 (GMT) |
|---|---|---|
| committer | Remko Tronçon <git@el-tramo.be> | 2010-03-28 19:44:49 (GMT) |
| commit | 3afa4f741c26360245dc313bc368f508b26a6b96 (patch) | |
| tree | 4fc9fedac990a099010fed8a4ee09ddc51c21cc5 /3rdParty/DocBook/XSL/params/generate.id.attributes.xml | |
| parent | 7548dabae7d10e48816142e508be651ada9f7bc3 (diff) | |
| download | swift-contrib-3afa4f741c26360245dc313bc368f508b26a6b96.zip swift-contrib-3afa4f741c26360245dc313bc368f508b26a6b96.tar.bz2 | |
Added DocBook infrastructure.
Imported most of "DocBook kit".
Added placeholder for Swiften developers guide.
Diffstat (limited to '3rdParty/DocBook/XSL/params/generate.id.attributes.xml')
| -rw-r--r-- | 3rdParty/DocBook/XSL/params/generate.id.attributes.xml | 59 |
1 files changed, 59 insertions, 0 deletions
diff --git a/3rdParty/DocBook/XSL/params/generate.id.attributes.xml b/3rdParty/DocBook/XSL/params/generate.id.attributes.xml new file mode 100644 index 0000000..6326841 --- /dev/null +++ b/3rdParty/DocBook/XSL/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> |