/contrib/groff/contrib/mom/momdoc/rectoverso.html

https://bitbucket.org/freebsd/freebsd-head/ · HTML · 253 lines · 226 code · 24 blank · 3 comment · 0 complexity · abca72f6650ecd2c0eac5c6816f8aa87 MD5 · raw file

  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
  2. <html>
  3. <head>
  4. <meta http-equiv="content-type" content="text/html;charset=iso-8859-1">
  5. <title>Mom -- Document Processing, Recto/verso printing</title>
  6. </head>
  7. <body bgcolor="#dfdfdf">
  8. <!====================================================================>
  9. <a href="cover.html#TOP">Next</a>&nbsp;&nbsp;
  10. <a href="headfootpage.html#TOP">Prev</a>&nbsp;&nbsp;
  11. <a href="toc.html">Back to Table of Contents</a>
  12. <p>
  13. <a name="TOP"></a>
  14. <a name="INDEX_RECTOVERSO"></a>
  15. <a name="RECTOVERSO">
  16. <h1 align="center"><u>RECTO/VERSO PRINTING and COLLATING</u></h1>
  17. </a>
  18. <ul>
  19. <li><a href="#RECTOVERSO_INTRO">Introduction to recto/verso</a>
  20. <ul>
  21. <li><a href="#RECTOVERSO_LIST">Macro list</a>
  22. </ul>
  23. <li><a href="#COLLATE_INTRO">Introduction to collating</a>
  24. <ul>
  25. <li><a href="#COLLATE">The COLLATE macro</a>
  26. </ul>
  27. </ul>
  28. <a name="RECTOVERSO_INTRO">
  29. <h2><u>Introduction to recto/verso</u></h2>
  30. </a>
  31. Recto/verso printing allows you to set up a <strong>mom</strong>
  32. document in such a way that it can be printed on both sides of a
  33. printer sheet and subsequently bound.
  34. <p>
  35. With recto/verso, <strong>mom</strong> automatically takes control
  36. of the following aspects of alternating page layout:
  37. <br>
  38. <ul>
  39. <li>switching left and right margins (if they're not equal)
  40. <li>switching the left and right parts of the default 3-part
  41. <a href="definitions.html#TERMS_HEADER">headers</a>
  42. or
  43. <a href="definitions.html#TERMS_FOOTER">footers</a>
  44. (see the
  45. <a href="headfootpage.html#DESCRIPTION_GENERAL">General description of headers</a>)
  46. <li>switching
  47. <a href="headfootpage.html#HDRFTR_RECTOVERSO">HEADER_RECTO</a>
  48. and
  49. <a href="headfootpage.html#HDRFTR_RECTOVERSO">HEADER_VERSO</a>
  50. if user-defined, single string recto/verso headers
  51. or footers are used in place of the default 3-part
  52. headers or footers
  53. <li>switching the page number position (if page numbers are not centred)
  54. </ul>
  55. <p>
  56. It is beyond the scope of this documentation to cover the different
  57. ways in which you can make your printer print on both sides of a sheet.
  58. A simple but effective method for those of us with &quot;dumb&quot;
  59. printers is to open the document (after it's been processed into
  60. PostScript by groff -- see
  61. <a href="using.html#USING_INVOKING">How to invoke groff with mom</a>)
  62. in <strong>gv</strong> (ghostview),
  63. click the &quot;odd pages&quot; icon, then click &quot;Print
  64. Marked&quot;. After printing is complete, rearrange the sheets
  65. appropriately, put them back in your printer, and have
  66. <strong>gv</strong> print the &quot;even pages&quot;. If you prefer to
  67. work from the command line, check out the man pages for
  68. <strong>pstops</strong> and <strong>psbook</strong>. There are other
  69. programs out there as well to help with two-sided printing.
  70. <p>
  71. <a name="RECTOVERSO_LIST">
  72. <h3><u>Recto/verso macros list</u></h3>
  73. </a>
  74. <ul>
  75. <li><a href="#RECTO_VERSO">RECTO_VERSO</a>
  76. <li><a href="#SWITCH_HDRFTR">SWITCH_HEADERS (also FOOTERS)</a>
  77. </ul>
  78. <p>
  79. <hr>
  80. <!---RECTO_VERSO--->
  81. <a name="RECTO_VERSO">
  82. <h3><u>Recto/verso printing</u></h3>
  83. </a>
  84. Macro: <strong>RECTO_VERSO</strong>
  85. <p>
  86. If you want <strong>mom</strong> to set up alternating pages for
  87. recto/verso printing, simply invoke <strong>RECTO_VERSO</strong>
  88. with no argument.
  89. <p>
  90. <strong>NOTE:</strong>
  91. <br>
  92. Recto/verso always switches the left and right parts of
  93. <a href="definitions.html#TERMS_HEADER">headers</a>
  94. or
  95. <a href="definitions.html#TERMS_FOOTER">footers</a>
  96. on odd/even pages. However, it only switches the left and right
  97. margins if the margins aren't equal. Consequently, it is your
  98. responsibility to set the appropriate differing left and right
  99. margins with
  100. <a href="typesetting.html#L_MARGIN">L_MARGIN</a>
  101. and
  102. <a href="typesetting.html#R_MARGIN">R_MARGIN</a>
  103. (prior to
  104. <a href="docprocessing.html#START">START</a>)
  105. or with
  106. <a href="docprocessing.html#DOC_LEFT_MARGIN">DOC_LEFT_MARGIN</a>
  107. and
  108. <a href="docprocessing.html#DOC_RIGHT_MARGIN">DOC_RIGHT_MARGIN</a>
  109. (before or after <strong>START</strong>).
  110. <p>
  111. Equally, recto/verso only switches the page number position if page
  112. numbers aren't centred, which means you have to set the page
  113. number position with
  114. <a href="headfootpage.html#PAGENUM_POS">PAGENUM_POS</a>
  115. (before or after <strong>START</strong>).
  116. <p>
  117. <!---SWITCH_HDRFTR--->
  118. <hr width="66%" align="left">
  119. <a name="SWITCH_HDRFTR">
  120. <h3><u>Switch header left part/right part</u></h3>
  121. </a>
  122. Macro: <strong>SWITCH_HEADERS</strong>
  123. <p>
  124. <strong>SWITCH_HEADERS</strong> switches the location of the
  125. header left string (by default, the author) and the header right
  126. string (by default, the document title). If you don't like
  127. <strong>mom</strong>'s default placement of author and title, use
  128. <strong>SWITCH_HEADERS</strong> to reverse it.
  129. <p>
  130. <strong>SWITCH_HEADERS</strong> can also be useful in conjunction
  131. with
  132. <a href="#RECTO_VERSO">RECTO_VERSO</a>.
  133. The assumption of <strong>RECTO_VERSO</strong> is that the first
  134. page of a document (recto/odd) represents the norm for header-left
  135. and header-right, meaning that the second (and all subsequent even)
  136. page(s) of the document exchange header-left and header-right.
  137. <p>
  138. If <strong>mom</strong>'s behaviour in this matter is not what
  139. you want, simply invoke <strong>SWITCH_HEADERS</strong> on the
  140. first page of your recto/verso document to reverse her default
  141. treatment of header parts. The remainder of your document (with
  142. respect to headers) will come out as you want.
  143. <p>
  144. <strong>NOTE:</strong> Replace <strong>_HEADERS</strong>, above,
  145. with <strong>_FOOTERS</strong> if your document uses footers.
  146. <p>
  147. <hr>
  148. <!=====================================================================>
  149. <a name="COLLATE_INTRO">
  150. <h2><u>Introduction to collating</u></h2>
  151. </a>
  152. The macro <strong>COLLATE</strong> lets you join documents together.
  153. Primarily, it's a convenience for printing long documents that
  154. comprise several chapters, although it could be used for any
  155. document type (except <strong>LETTER</strong>).
  156. <p>
  157. Personally, I prefer to keep chapters in separate files and print
  158. them out as needed. However, that means keeping track of the correct
  159. starting page number for each chapter, a problem circumvented by the
  160. use of <strong>COLLATE</strong>.
  161. <p>
  162. When collating chapters, you need only put <code>.COLLATE</code>
  163. at the end of a chapter, follow it with any
  164. <a href="docprocessing.html#REFERENCE_MACROS">reference macros</a>
  165. needed for the new chapter, e.g.
  166. <a href="docprocessing.html#CHAPTER">CHAPTER</a>
  167. or
  168. <a href="docprocessing.html#CHAPTER_STRING">CHAPTER_STRING</a>
  169. (have a look at the
  170. <a href="#CHAPTER_NOTE">Special Note on CHAPTER</a>)
  171. make any pertinent style changes to the document (unlikely, but
  172. possible), and re-invoke the
  173. <a href="docprocessing.html#START">START</a>
  174. macro. Your new chapter will begin on a fresh page and behave
  175. as expected.
  176. <p>
  177. <strong>COLLATE</strong> assumes you are collating documents/files
  178. with similar type-style parameters hence there's no need for
  179. <strong>PRINTSTYLE</strong> to appear after <strong>COLLATE</strong>,
  180. although if you're collating documents that were created as separate
  181. files, chances are the <strong>PRINTSTYLE</strong>'s already there.
  182. <p>
  183. <a name="CAUTION"></a>
  184. <strong><u>Two words of caution:</u></strong>
  185. <ol>
  186. <li>Do not collate documents of differing
  187. <strong>PRINTSTYLES</strong> (i.e. don't try to
  188. collate a TYPESET document and TYPEWRITE document).
  189. <li>Use <strong>DOC_FAMILY</strong> instead of
  190. <strong>FAMILY</strong> if, for some reason, you want
  191. to change the family of all the document elements after
  192. <strong>COLLATE</strong>. <strong>FAMILY</strong>, by
  193. itself, will change the family of paragraph text only.
  194. </ol>
  195. <p>
  196. <!---COLLATE--->
  197. <hr width="66%" align="left">
  198. <a name="COLLATE">
  199. <h3><u>Collate document files</u></h3>
  200. </a>
  201. Macro: <strong>COLLATE</strong>
  202. <p>
  203. The most basic (and most likely) collating situation looks like
  204. this:
  205. <p>
  206. <pre>
  207. .COLLATE
  208. .CHAPTER 17
  209. .START
  210. </pre>
  211. A slightly more complex version of the same thing, for chapters
  212. that require their own titles, looks like this:
  213. <p>
  214. <pre>
  215. .COLLATE
  216. .CHAPTER_TITLE "Geek Fatigue: Symptoms and Causes"
  217. .START
  218. </pre>
  219. <strong>NOTE:</strong> See the
  220. <a href="#CAUTION">two words of caution</a>,
  221. above.
  222. <p>
  223. <hr>
  224. <a href="cover.html#TOP">Next</a>&nbsp;&nbsp;
  225. <a href="headfootpage.html#TOP">Prev</a>&nbsp;&nbsp;
  226. <a href="#TOP">Top</a>&nbsp;&nbsp;
  227. <a href="toc.html">Back to Table of Contents</a>
  228. </body>
  229. </html>