OLD | NEW |
| (Empty) |
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="make.clean.html"> | |
7 <refmeta> | |
8 <refentrytitle>make.clean.html</refentrytitle> | |
9 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo> | |
10 </refmeta> | |
11 <refnamediv> | |
12 <refname>make.clean.html</refname> | |
13 <refpurpose>Make HTML conform to modern coding standards</refpurpose> | |
14 </refnamediv> | |
15 | |
16 <refsynopsisdiv> | |
17 <src:fragment xml:id="make.clean.html.frag"> | |
18 <xsl:param name="make.clean.html" select="0"/> | |
19 </src:fragment> | |
20 </refsynopsisdiv> | |
21 | |
22 <refsection><info><title>Description</title></info> | |
23 | |
24 <para>If <parameter>make.clean.html</parameter> is true, the stylesheets take | |
25 extra effort to ensure that the resulting HTML is conforms to | |
26 modern HTML coding standards. In addition to eliminating | |
27 excessive and noncompliant coding, it moves presentation | |
28 HTML coding to a CSS stylesheet.</para> | |
29 | |
30 <para>The resulting HTML is dependent on | |
31 CSS for formatting, and so the stylesheet is capable of | |
32 generating a supporting CSS file. The <parameter>docbook.css.source</parameter> | |
33 and <parameter>custom.css.source</parameter> parameters control | |
34 how a CSS file is generated.</para> | |
35 | |
36 <para>If you require your CSS to reside in the HTML | |
37 <tag>head</tag> element, then the <parameter>generate.css.header</parameter> | |
38 can be used to do that.</para> | |
39 | |
40 <para>The <parameter>make.clean.html</parameter> parameter is | |
41 different from <parameter>html.cleanup</parameter> | |
42 because the former changes the resulting markup; it does not use extension funct
ions | |
43 like the latter to manipulate result-tree-fragments, | |
44 and is therefore applicable to any XSLT processor.</para> | |
45 | |
46 <para>If <parameter>make.clean.html</parameter> is set to zero (the default), | |
47 then the stylesheet retains its original | |
48 <quote>old style</quote> | |
49 HTML formatting features.</para> | |
50 </refsection> | |
51 </refentry> | |
OLD | NEW |