]> git.stg.codes - stg.git/blob - doc/help/xslt/params/make.clean.html.xml
--stringparam base.path replaces with -o
[stg.git] / doc / help / xslt / params / make.clean.html.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="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 functions
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>