params/force.blank.pages.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="force.blank.pages">
   7 <refmeta>
   8 <refentrytitle>force.blank.pages</refentrytitle>
   9 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
  10 </refmeta>
  11 <refnamediv>
  12 <refname>force.blank.pages</refname>
  13 <refpurpose>Generate blank page to end on even page number</refpurpose>
  14 </refnamediv>
  15
  16 <refsynopsisdiv>
  17 <src:fragment xml:id="force.blank.pages.frag">
  18 <xsl:param name="force.blank.pages" select="1"/>
  19 </src:fragment>
  20 </refsynopsisdiv>
  21
  22 <refsection><info><title>Description</title></info>
  23
  24 <para>If non-zero (the default), then each page sequence will be forced to
  25 end on an even-numbered page, by inserting a blank page
  26 if necessary. This will force the next page sequence to start
  27 on an odd-numbered page, which is a standard convention
  28 for printed and bound books.</para>
  29
  30 <para>If zero, then such blank pages will not be inserted.
  31 Chapters will start on the next available page,
  32 regardless of whether it is an even or odd number.
  33 This is useful when publishing online where blank
  34 pages are not needed.
  35 </para>
  36
  37 <para>This param is independent of the
  38 <parameter>double.sided</parameter> parameter, which
  39 just triggers the use of even and odd page sequence
  40 masters that differ in their header and footer placement.
  41 So you can combine the two params for alternating
  42 headers/footers and no blank pages.
  43 </para>
  44
  45 </refsection>
  46 </refentry>