force.blank.pages.xml 1.6 KB

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