doc/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>