/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
- <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
- <html>
- <head>
- <meta http-equiv="content-type" content="text/html;charset=iso-8859-1">
- <title>Mom -- Document Processing, Recto/verso printing</title>
- </head>
- <body bgcolor="#dfdfdf">
- <!====================================================================>
- <a href="cover.html#TOP">Next</a>
- <a href="headfootpage.html#TOP">Prev</a>
- <a href="toc.html">Back to Table of Contents</a>
- <p>
- <a name="TOP"></a>
- <a name="INDEX_RECTOVERSO"></a>
- <a name="RECTOVERSO">
- <h1 align="center"><u>RECTO/VERSO PRINTING and COLLATING</u></h1>
- </a>
- <ul>
- <li><a href="#RECTOVERSO_INTRO">Introduction to recto/verso</a>
- <ul>
- <li><a href="#RECTOVERSO_LIST">Macro list</a>
- </ul>
- <li><a href="#COLLATE_INTRO">Introduction to collating</a>
- <ul>
- <li><a href="#COLLATE">The COLLATE macro</a>
- </ul>
- </ul>
- <a name="RECTOVERSO_INTRO">
- <h2><u>Introduction to recto/verso</u></h2>
- </a>
- Recto/verso printing allows you to set up a <strong>mom</strong>
- document in such a way that it can be printed on both sides of a
- printer sheet and subsequently bound.
- <p>
- With recto/verso, <strong>mom</strong> automatically takes control
- of the following aspects of alternating page layout:
- <br>
- <ul>
- <li>switching left and right margins (if they're not equal)
- <li>switching the left and right parts of the default 3-part
- <a href="definitions.html#TERMS_HEADER">headers</a>
- or
- <a href="definitions.html#TERMS_FOOTER">footers</a>
- (see the
- <a href="headfootpage.html#DESCRIPTION_GENERAL">General description of headers</a>)
- <li>switching
- <a href="headfootpage.html#HDRFTR_RECTOVERSO">HEADER_RECTO</a>
- and
- <a href="headfootpage.html#HDRFTR_RECTOVERSO">HEADER_VERSO</a>
- if user-defined, single string recto/verso headers
- or footers are used in place of the default 3-part
- headers or footers
- <li>switching the page number position (if page numbers are not centred)
- </ul>
- <p>
- It is beyond the scope of this documentation to cover the different
- ways in which you can make your printer print on both sides of a sheet.
- A simple but effective method for those of us with "dumb"
- printers is to open the document (after it's been processed into
- PostScript by groff -- see
- <a href="using.html#USING_INVOKING">How to invoke groff with mom</a>)
- in <strong>gv</strong> (ghostview),
- click the "odd pages" icon, then click "Print
- Marked". After printing is complete, rearrange the sheets
- appropriately, put them back in your printer, and have
- <strong>gv</strong> print the "even pages". If you prefer to
- work from the command line, check out the man pages for
- <strong>pstops</strong> and <strong>psbook</strong>. There are other
- programs out there as well to help with two-sided printing.
- <p>
- <a name="RECTOVERSO_LIST">
- <h3><u>Recto/verso macros list</u></h3>
- </a>
- <ul>
- <li><a href="#RECTO_VERSO">RECTO_VERSO</a>
- <li><a href="#SWITCH_HDRFTR">SWITCH_HEADERS (also FOOTERS)</a>
- </ul>
- <p>
- <hr>
- <!---RECTO_VERSO--->
- <a name="RECTO_VERSO">
- <h3><u>Recto/verso printing</u></h3>
- </a>
- Macro: <strong>RECTO_VERSO</strong>
- <p>
- If you want <strong>mom</strong> to set up alternating pages for
- recto/verso printing, simply invoke <strong>RECTO_VERSO</strong>
- with no argument.
- <p>
- <strong>NOTE:</strong>
- <br>
- Recto/verso always switches the left and right parts of
- <a href="definitions.html#TERMS_HEADER">headers</a>
- or
- <a href="definitions.html#TERMS_FOOTER">footers</a>
- on odd/even pages. However, it only switches the left and right
- margins if the margins aren't equal. Consequently, it is your
- responsibility to set the appropriate differing left and right
- margins with
- <a href="typesetting.html#L_MARGIN">L_MARGIN</a>
- and
- <a href="typesetting.html#R_MARGIN">R_MARGIN</a>
- (prior to
- <a href="docprocessing.html#START">START</a>)
- or with
- <a href="docprocessing.html#DOC_LEFT_MARGIN">DOC_LEFT_MARGIN</a>
- and
- <a href="docprocessing.html#DOC_RIGHT_MARGIN">DOC_RIGHT_MARGIN</a>
- (before or after <strong>START</strong>).
- <p>
- Equally, recto/verso only switches the page number position if page
- numbers aren't centred, which means you have to set the page
- number position with
- <a href="headfootpage.html#PAGENUM_POS">PAGENUM_POS</a>
- (before or after <strong>START</strong>).
- <p>
- <!---SWITCH_HDRFTR--->
- <hr width="66%" align="left">
- <a name="SWITCH_HDRFTR">
- <h3><u>Switch header left part/right part</u></h3>
- </a>
- Macro: <strong>SWITCH_HEADERS</strong>
- <p>
- <strong>SWITCH_HEADERS</strong> switches the location of the
- header left string (by default, the author) and the header right
- string (by default, the document title). If you don't like
- <strong>mom</strong>'s default placement of author and title, use
- <strong>SWITCH_HEADERS</strong> to reverse it.
- <p>
- <strong>SWITCH_HEADERS</strong> can also be useful in conjunction
- with
- <a href="#RECTO_VERSO">RECTO_VERSO</a>.
- The assumption of <strong>RECTO_VERSO</strong> is that the first
- page of a document (recto/odd) represents the norm for header-left
- and header-right, meaning that the second (and all subsequent even)
- page(s) of the document exchange header-left and header-right.
- <p>
- If <strong>mom</strong>'s behaviour in this matter is not what
- you want, simply invoke <strong>SWITCH_HEADERS</strong> on the
- first page of your recto/verso document to reverse her default
- treatment of header parts. The remainder of your document (with
- respect to headers) will come out as you want.
- <p>
- <strong>NOTE:</strong> Replace <strong>_HEADERS</strong>, above,
- with <strong>_FOOTERS</strong> if your document uses footers.
- <p>
- <hr>
- <!=====================================================================>
- <a name="COLLATE_INTRO">
- <h2><u>Introduction to collating</u></h2>
- </a>
- The macro <strong>COLLATE</strong> lets you join documents together.
- Primarily, it's a convenience for printing long documents that
- comprise several chapters, although it could be used for any
- document type (except <strong>LETTER</strong>).
- <p>
- Personally, I prefer to keep chapters in separate files and print
- them out as needed. However, that means keeping track of the correct
- starting page number for each chapter, a problem circumvented by the
- use of <strong>COLLATE</strong>.
- <p>
- When collating chapters, you need only put <code>.COLLATE</code>
- at the end of a chapter, follow it with any
- <a href="docprocessing.html#REFERENCE_MACROS">reference macros</a>
- needed for the new chapter, e.g.
- <a href="docprocessing.html#CHAPTER">CHAPTER</a>
- or
- <a href="docprocessing.html#CHAPTER_STRING">CHAPTER_STRING</a>
- (have a look at the
- <a href="#CHAPTER_NOTE">Special Note on CHAPTER</a>)
- make any pertinent style changes to the document (unlikely, but
- possible), and re-invoke the
- <a href="docprocessing.html#START">START</a>
- macro. Your new chapter will begin on a fresh page and behave
- as expected.
- <p>
- <strong>COLLATE</strong> assumes you are collating documents/files
- with similar type-style parameters hence there's no need for
- <strong>PRINTSTYLE</strong> to appear after <strong>COLLATE</strong>,
- although if you're collating documents that were created as separate
- files, chances are the <strong>PRINTSTYLE</strong>'s already there.
- <p>
- <a name="CAUTION"></a>
- <strong><u>Two words of caution:</u></strong>
- <ol>
- <li>Do not collate documents of differing
- <strong>PRINTSTYLES</strong> (i.e. don't try to
- collate a TYPESET document and TYPEWRITE document).
- <li>Use <strong>DOC_FAMILY</strong> instead of
- <strong>FAMILY</strong> if, for some reason, you want
- to change the family of all the document elements after
- <strong>COLLATE</strong>. <strong>FAMILY</strong>, by
- itself, will change the family of paragraph text only.
- </ol>
- <p>
- <!---COLLATE--->
- <hr width="66%" align="left">
- <a name="COLLATE">
- <h3><u>Collate document files</u></h3>
- </a>
- Macro: <strong>COLLATE</strong>
- <p>
- The most basic (and most likely) collating situation looks like
- this:
- <p>
- <pre>
- .COLLATE
- .CHAPTER 17
- .START
- </pre>
- A slightly more complex version of the same thing, for chapters
- that require their own titles, looks like this:
- <p>
- <pre>
- .COLLATE
- .CHAPTER_TITLE "Geek Fatigue: Symptoms and Causes"
- .START
- </pre>
- <strong>NOTE:</strong> See the
- <a href="#CAUTION">two words of caution</a>,
- above.
- <p>
- <hr>
- <a href="cover.html#TOP">Next</a>
- <a href="headfootpage.html#TOP">Prev</a>
- <a href="#TOP">Top</a>
- <a href="toc.html">Back to Table of Contents</a>
- </body>
- </html>