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

  2. <html>
    3. 

  3. <head>
    4. 

  4. <meta http-equiv="content-type" content="text/html;charset=iso-8859-1">
    5. 

  5. <title>Mom -- Document Processing, Recto/verso printing</title>
    6. 

  6. </head>
    7. 

  7. <body bgcolor="#dfdfdf">
    8. 

  8. 

  9. <!====================================================================>
    10. 

  10. 

  11. <a href="cover.html#TOP">Next</a>&nbsp;&nbsp;
    12. 

  12. <a href="headfootpage.html#TOP">Prev</a>&nbsp;&nbsp;
    13. 

  13. <a href="toc.html">Back to Table of Contents</a>
    14. 

  14. <p>
    15. 

  15. 

  16. <a name="TOP"></a>
    17. 

  17. <a name="INDEX_RECTOVERSO"></a>
    18. 

  18. <a name="RECTOVERSO">
    19. 

  19. 	<h1 align="center"><u>RECTO/VERSO PRINTING and COLLATING</u></h1>
    20. 

  20. </a>
    21. 

  21. 

  22. <ul>
    23. 

  23. 	<li><a href="#RECTOVERSO_INTRO">Introduction to recto/verso</a>
    24. 

  24. 	<ul>
    25. 

  25. 		<li><a href="#RECTOVERSO_LIST">Macro list</a>
    26. 

  26. 	</ul>
    27. 

  27. 	<li><a href="#COLLATE_INTRO">Introduction to collating</a>
    28. 

  28. 	<ul>
    29. 

  29. 		<li><a href="#COLLATE">The COLLATE macro</a>
    30. 

  30. 	</ul>
    31. 

  31. </ul>
    32. 

  32. 

  33. <a name="RECTOVERSO_INTRO">
    34. 

  34. 	<h2><u>Introduction to recto/verso</u></h2>
    35. 

  35. </a>
    36. 

  36. 

  37. Recto/verso printing allows you to set up a <strong>mom</strong>
    38. 

  38. document in such a way that it can be printed on both sides of a
    39. 

  39. printer sheet and subsequently bound.
    40. 

  40. <p>
    41. 

  41. With recto/verso, <strong>mom</strong> automatically takes control
    42. 

  42. of the following aspects of alternating page layout:
    43. 

  43. <br>
    44. 

  44. <ul>
    45. 

  45. 	<li>switching left and right margins (if they're not equal)
    46. 

  46. 	<li>switching the left and right parts of the default 3-part
    47. 

  47. 		<a href="definitions.html#TERMS_HEADER">headers</a>
    48. 

  48. 		or
    49. 

  49. 		<a href="definitions.html#TERMS_FOOTER">footers</a>
    50. 

  50. 		(see the
    51. 

  51. 		<a href="headfootpage.html#DESCRIPTION_GENERAL">General description of headers</a>)
    52. 

  52. 	<li>switching
    53. 

  53. 		<a href="headfootpage.html#HDRFTR_RECTOVERSO">HEADER_RECTO</a>
    54. 

  54. 		and
    55. 

  55. 		<a href="headfootpage.html#HDRFTR_RECTOVERSO">HEADER_VERSO</a>
    56. 

  56. 		if user-defined, single string recto/verso headers
    57. 

  57. 		or footers are used in place of the default 3-part
    58. 

  58. 		headers or footers
    59. 

  59. 	<li>switching the page number position (if page numbers are not centred)
    60. 

  60. </ul>
    61. 

  61. <p>
    62. 

  62. It is beyond the scope of this documentation to cover the different
    63. 

  63. ways in which you can make your printer print on both sides of a sheet.
    64. 

  64. A simple but effective method for those of us with &quot;dumb&quot;
    65. 

  65. printers is to open the document (after it's been processed into
    66. 

  66. PostScript by groff -- see
    67. 

  67. <a href="using.html#USING_INVOKING">How to invoke groff with mom</a>)
    68. 

  68. in <strong>gv</strong> (ghostview),
    69. 

  69. click the &quot;odd pages&quot; icon, then click &quot;Print
    70. 

  70. Marked&quot;.  After printing is complete, rearrange the sheets
    71. 

  71. appropriately, put them back in your printer, and have
    72. 

  72. <strong>gv</strong> print the &quot;even pages&quot;.  If you prefer to
    73. 

  73. work from the command line, check out the man pages for
    74. 

  74. <strong>pstops</strong> and <strong>psbook</strong>.  There are other
    75. 

  75. programs out there as well to help with two-sided printing.
    76. 

  76. <p>
    77. 

  77. 

  78. <a name="RECTOVERSO_LIST">
    79. 

  79. 	<h3><u>Recto/verso macros list</u></h3>
    80. 

  80. </a>
    81. 

  81. 

  82. <ul>
    83. 

  83. 	<li><a href="#RECTO_VERSO">RECTO_VERSO</a>
    84. 

  84. 	<li><a href="#SWITCH_HDRFTR">SWITCH_HEADERS (also FOOTERS)</a>
    85. 

  85. </ul>
    86. 

  86. <p>
    87. 

  87. 

  88. <hr>
    89. 

  89. <!---RECTO_VERSO--->
    90. 

  90. 

  91. <a name="RECTO_VERSO">
    92. 

  92. 	<h3><u>Recto/verso printing</u></h3>
    93. 

  93. </a>
    94. 

  94. Macro: <strong>RECTO_VERSO</strong>
    95. 

  95. 

  96. <p>
    97. 

  97. If you want <strong>mom</strong> to set up alternating pages for
    98. 

  98. recto/verso printing, simply invoke <strong>RECTO_VERSO</strong>
    99. 

  99. with no argument.
    100. 

  100. <p>
    101. 

  101. <strong>NOTE:</strong>
    102. 

  102. <br>
    103. 

  103. Recto/verso always switches the left and right parts of
    104. 

  104. <a href="definitions.html#TERMS_HEADER">headers</a>
    105. 

  105. or
    106. 

  106. <a href="definitions.html#TERMS_FOOTER">footers</a>
    107. 

  107. on odd/even pages.  However, it only switches the left and right
    108. 

  108. margins if the margins aren't equal.  Consequently, it is your
    109. 

  109. responsibility to set the appropriate differing left and right
    110. 

  110. margins with
    111. 

  111. <a href="typesetting.html#L_MARGIN">L_MARGIN</a>
    112. 

  112. and
    113. 

  113. <a href="typesetting.html#R_MARGIN">R_MARGIN</a>
    114. 

  114. (prior to
    115. 

  115. <a href="docprocessing.html#START">START</a>)
    116. 

  116. or with
    117. 

  117. <a href="docprocessing.html#DOC_LEFT_MARGIN">DOC_LEFT_MARGIN</a>
    118. 

  118. and
    119. 

  119. <a href="docprocessing.html#DOC_RIGHT_MARGIN">DOC_RIGHT_MARGIN</a>
    120. 

  120. (before or after <strong>START</strong>).
    121. 

  121. <p>
    122. 

  122. Equally, recto/verso only switches the page number position if page
    123. 

  123. numbers aren't centred, which means you have to set the page
    124. 

  124. number position with
    125. 

  125. <a href="headfootpage.html#PAGENUM_POS">PAGENUM_POS</a>
    126. 

  126. (before or after <strong>START</strong>).
    127. 

  127. <p>
    128. 

  128. 

  129. <!---SWITCH_HDRFTR--->
    130. 

  130. 

  131. <hr width="66%" align="left">
    132. 

  132. <a name="SWITCH_HDRFTR">
    133. 

  133. 	<h3><u>Switch header left part/right part</u></h3>
    134. 

  134. </a>
    135. 

  135. Macro: <strong>SWITCH_HEADERS</strong>
    136. 

  136. 

  137. <p>
    138. 

  138. <strong>SWITCH_HEADERS</strong> switches the location of the
    139. 

  139. header left string (by default, the author) and the header right
    140. 

  140. string (by default, the document title).  If you don't like
    141. 

  141. <strong>mom</strong>'s default placement of author and title, use
    142. 

  142. <strong>SWITCH_HEADERS</strong> to reverse it.
    143. 

  143. <p>
    144. 

  144. <strong>SWITCH_HEADERS</strong> can also be useful in conjunction
    145. 

  145. with
    146. 

  146. <a href="#RECTO_VERSO">RECTO_VERSO</a>.
    147. 

  147. The assumption of <strong>RECTO_VERSO</strong> is that the first
    148. 

  148. page of a document (recto/odd) represents the norm for header-left
    149. 

  149. and header-right, meaning that the second (and all subsequent even)
    150. 

  150. page(s) of the document exchange header-left and header-right.
    151. 

  151. <p>
    152. 

  152. If <strong>mom</strong>'s behaviour in this matter is not what
    153. 

  153. you want, simply invoke <strong>SWITCH_HEADERS</strong> on the
    154. 

  154. first page of your recto/verso document to reverse her default
    155. 

  155. treatment of header parts.  The remainder of your document (with
    156. 

  156. respect to headers) will come out as you want.
    157. 

  157. <p>
    158. 

  158. <strong>NOTE:</strong> Replace <strong>_HEADERS</strong>, above,
    159. 

  159. with <strong>_FOOTERS</strong> if your document uses footers.
    160. 

  160. <p>
    161. 

  161. <hr>
    162. 

  162. 

  163. <!=====================================================================>
    164. 

  164. 

  165. <a name="COLLATE_INTRO">
    166. 

  166. 	<h2><u>Introduction to collating</u></h2>
    167. 

  167. </a>
    168. 

  168. 

  169. The macro <strong>COLLATE</strong> lets you join documents together.
    170. 

  170. Primarily, it's a convenience for printing long documents that
    171. 

  171. comprise several chapters, although it could be used for any
    172. 

  172. document type (except <strong>LETTER</strong>).
    173. 

  173. <p>
    174. 

  174. Personally, I prefer to keep chapters in separate files and print
    175. 

  175. them out as needed.  However, that means keeping track of the correct
    176. 

  176. starting page number for each chapter, a problem circumvented by the
    177. 

  177. use of <strong>COLLATE</strong>.
    178. 

  178. <p>
    179. 

  179. When collating chapters, you need only put <code>.COLLATE</code>
    180. 

  180. at the end of a chapter, follow it with any
    181. 

  181. <a href="docprocessing.html#REFERENCE_MACROS">reference macros</a>
    182. 

  182. needed for the new chapter, e.g.
    183. 

  183. <a href="docprocessing.html#CHAPTER">CHAPTER</a>
    184. 

  184. or
    185. 

  185. <a href="docprocessing.html#CHAPTER_STRING">CHAPTER_STRING</a>
    186. 

  186. (have a look at the
    187. 

  187. <a href="#CHAPTER_NOTE">Special Note on CHAPTER</a>)
    188. 

  188. make any pertinent style changes to the document (unlikely, but
    189. 

  189. possible), and re-invoke the
    190. 

  190. <a href="docprocessing.html#START">START</a>
    191. 

  191. macro.  Your new chapter will begin on a fresh page and behave
    192. 

  192. as expected.
    193. 

  193. <p>
    194. 

  194. <strong>COLLATE</strong> assumes you are collating documents/files
    195. 

  195. with similar type-style parameters hence there's no need for
    196. 

  196. <strong>PRINTSTYLE</strong> to appear after <strong>COLLATE</strong>,
    197. 

  197. although if you're collating documents that were created as separate
    198. 

  198. files, chances are the <strong>PRINTSTYLE</strong>'s already there.
    199. 

  199. <p>
    200. 

  200. <a name="CAUTION"></a>
    201. 

  201. <strong><u>Two words of caution:</u></strong>
    202. 

  202. <ol>
    203. 

  203. 	<li>Do not collate documents of differing
    204. 

  204. 		<strong>PRINTSTYLES</strong> (i.e. don't try to
    205. 

  205. 		collate a TYPESET document and TYPEWRITE document).
    206. 

  206. 	<li>Use <strong>DOC_FAMILY</strong> instead of
    207. 

  207. 		<strong>FAMILY</strong> if, for some reason, you want
    208. 

  208. 		to change the family of all the document elements after
    209. 

  209. 		<strong>COLLATE</strong>.  <strong>FAMILY</strong>, by
    210. 

  210. 		itself, will change the family of paragraph text only.
    211. 

  211. </ol>
    212. 

  212. <p>
    213. 

  213. 

  214. <!---COLLATE--->
    215. 

  215. 

  216. <hr width="66%" align="left">
    217. 

  217. <a name="COLLATE">
    218. 

  218. 	<h3><u>Collate document files</u></h3>
    219. 

  219. </a>
    220. 

  220. 

  221. Macro: <strong>COLLATE</strong>
    222. 

  222. 

  223. <p>
    224. 

  224. The most basic (and most likely) collating situation looks like
    225. 

  225. this:
    226. 

  226. <p>
    227. 

  227. <pre>
    228. 

  228. 	.COLLATE
    229. 

  229. 	.CHAPTER 17
    230. 

  230. 	.START
    231. 

  231. </pre>
    232. 

  232. 

  233. A slightly more complex version of the same thing, for chapters
    234. 

  234. that require their own titles, looks like this:
    235. 

  235. <p>
    236. 

  236. <pre>
    237. 

  237. 	.COLLATE
    238. 

  238. 	.CHAPTER_TITLE "Geek Fatigue: Symptoms and Causes"
    239. 

  239. 	.START
    240. 

  240. </pre>
    241. 

  241. 

  242. <strong>NOTE:</strong> See the
    243. 

  243. <a href="#CAUTION">two words of caution</a>,
    244. 

  244. above.
    245. 

  245. <p>
    246. 

  246. 

  247. <hr>
    248. 

  248. <a href="cover.html#TOP">Next</a>&nbsp;&nbsp;
    249. 

  249. <a href="headfootpage.html#TOP">Prev</a>&nbsp;&nbsp;
    250. 

  250. <a href="#TOP">Top</a>&nbsp;&nbsp;
    251. 

  251. <a href="toc.html">Back to Table of Contents</a>
    252. 

  252. </body>
    253. 

  253. </html>
    254.