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