| 1 |
% \iffalse meta-comment |
| 2 |
% !TEX TS-program = dtxmk |
| 3 |
% |
| 4 |
% Copyright (C) 2002-2020 by John Burt <[email protected]> |
| 5 |
% -------------------------------------------------- |
| 6 |
% |
| 7 |
% This file may be distributed and/or modified under the |
| 8 |
% conditions of the LaTeX Project Public License, either version 1.3c |
| 9 |
% of this license or (at your option) any later version. |
| 10 |
% The latest version of this license is in: |
| 11 |
% |
| 12 |
% http://www.latex-project.org/lppl.txt |
| 13 |
% |
| 14 |
% This work has the LPPL maintenance status `maintained'. |
| 15 |
% |
| 16 |
% The Current Maintainer of this work is John Burt. |
| 17 |
% |
| 18 |
% This work consists of the files poemscol.dtx and poemscol.ins |
| 19 |
% and the derived file poemscol.sty. |
| 20 |
% |
| 21 |
% \fi |
| 22 |
% |
| 23 |
% \iffalse |
| 24 |
%<package>\NeedsTeXFormat{LaTeX2e}[1997/12/01] |
| 25 |
%<package>\ProvidesPackage{poemscol} |
| 26 |
%<package> [2020/06/12 v3.1415926 poemscol file] |
| 27 |
% |
| 28 |
%<*driver> |
| 29 |
\documentclass{ltxdoc} |
| 30 |
\usepackage{makeidx,multicol,keyval,ifthen} |
| 31 |
\setlength\IndexMin{100pt} |
| 32 |
\EnableCrossrefs |
| 33 |
\CodelineIndex |
| 34 |
\RecordChanges |
| 35 |
\begin{document} |
| 36 |
\DocInput{poemscol.dtx} |
| 37 |
\end{document} |
| 38 |
%</driver> |
| 39 |
% \fi |
| 40 |
% |
| 41 |
% \CheckSum{10704} |
| 42 |
% |
| 43 |
% \CharacterTable |
| 44 |
% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z |
| 45 |
% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z |
| 46 |
% Digits \0\1\2\3\4\5\6\7\8\9 |
| 47 |
% Exclamation \! Double quote \" Hash (number) \# |
| 48 |
% Dollar \$ Percent \% Ampersand \& |
| 49 |
% Acute accent \' Left paren \( Right paren \) |
| 50 |
% Asterisk \* Plus \+ Comma \, |
| 51 |
% Minus \- Point \. Solidus \/ |
| 52 |
% Colon \: Semicolon \; Less than \< |
| 53 |
% Equals \= Greater than \> Question mark \? |
| 54 |
% Commercial at \@ Left bracket \[ Backslash \\ |
| 55 |
% Right bracket \] Circumflex \^ Underscore \_ |
| 56 |
% Grave accent \` Left brace \{ Vertical bar \| |
| 57 |
% Right brace \} Tilde \~} |
| 58 |
% |
| 59 |
% |
| 60 |
% \changes{v1.0}{2002/06/05}{Initial version} |
| 61 |
% \changes{v1.01}{2002/06/25}{Added commands for titles of poems without |
| 62 |
% formal titles. Corrected typographical errors in manual.} |
| 63 |
% \changes{v1.1}{2003/04/18}{Added commands to change mark in cases |
| 64 |
% where page break fall (or does not fall) on stanza break. Added |
| 65 |
% command to change the amount of indentation in runover lines in |
| 66 |
% verse. Removed special geometry to make the program more generic.} |
| 67 |
% \changes{v1.11}{2005/02/12}{Corrected bugs in headers for |
| 68 |
% explanatory notes and emendations.} |
| 69 |
% \changes{v1.2}{2005/2/19}{Accidentals and typescript variants test |
| 70 |
% to see whether textual notes are being made. Corrected a bug when |
| 71 |
% quoting verse in note sections. Added a command to change the page |
| 72 |
% number of the table of contents. Added a command to input the table |
| 73 |
% of contents file. Added commands to input the external files for |
| 74 |
% emendations, explanatory notes, textual notes, and the index of |
| 75 |
% titles and first lines. Added a command to test whether there is an |
| 76 |
% .aux file from a previous run and to prevent typesetting of the |
| 77 |
% external files for emendations, explanatory notes, textual notes if |
| 78 |
% there is not. Added a command to restore the main page style after |
| 79 |
% the table of contents.} \changes{v1.7}{2005/2/22}{Changed how labels |
| 80 |
% are made for use in contents and notes sections. Control sequences |
| 81 |
% in titles (such as for italics and so on) no longer require special |
| 82 |
% commands, although those commands are retained for backward |
| 83 |
% compatibility.} \changes{v2.01}{2005/2/22}{Rewrote all of the title |
| 84 |
% commands in order to make them easier to maintain. Added environment |
| 85 |
% for flushing runover lines in verse to the right margin. Added |
| 86 |
% information on how to customize titles.} |
| 87 |
% \changes{v2.02}{2005/2/28}{Corrected an error in setting poems |
| 88 |
% without formal titles} \changes{v2.12}{2005/3/19}{Notes sections can |
| 89 |
% take ranges of lines.} \changes{v2.13}{2005/3/20}{tsentry no longer |
| 90 |
% needs an unskip if the entry starts with a comma.} |
| 91 |
% \changes{v2.2}{2005/3/23}{The user can create new kinds of endnote.} |
| 92 |
% \changes{v2.21}{2005/3/24}{Cross references can refer to line |
| 93 |
% numbers} \changes{v2.22}{2005/3/25}{Removed dependence upon |
| 94 |
% marn.sty. Enabled multiple levels of block-formatted footnotes} |
| 95 |
% \changes{v2.24}{2005/4/02}{commands to aid typesetting parallel |
| 96 |
% texts.} \changes{v2.25}{2005/5/06}{Bug fix in running headers to |
| 97 |
% notes sections} \changes{v2.26}{2005/5/09}{Fix no unskip in vertical |
| 98 |
% mode error} \changes{v2.27}{2005/5/09}{Changed name of linelabel |
| 99 |
% command, to prepare for making poemscol and lineno compatible} |
| 100 |
% \changes{v2.30}{2005/5/16}{Prose sections such as Authors' |
| 101 |
% Introductions are line numbered by lineno.sty. Textnotes, |
| 102 |
% emendations, and explanatory notes for prose sections may be either |
| 103 |
% footnotes or endnotes, and the latter are sent to the same place as |
| 104 |
% their verse equivalents. Good solution to ``missing number'' |
| 105 |
% problem on first runs.} \changes{v2.301}{2005/5/31}{Corrected small |
| 106 |
% bug in table of contents commands, rewrote manual for clarity} |
| 107 |
% \changes{v2.31}{2005/6/3}{Ranges of line for notes sections (in |
| 108 |
% verse or prose sections) need no longer involve counting of lines. |
| 109 |
% Lemmas may be nested, may overlap, and may cross stanza boundaries.} |
| 110 |
% \changes{v2.32}{2005/6/29}{Simpler configuration of marginal line |
| 111 |
% numbers, revision of manual} \changes{v2.33}{2005/7/03}{Fixed a bug |
| 112 |
% in index generation, compensated for odd interaction between |
| 113 |
% fancyhdr and reversemarginpar} \changes{v2.34}{2005/7/17}{Easier |
| 114 |
% modification of format of tables of contents} |
| 115 |
% \changes{v2.35}{2005/7/18}{poemscol can break the lines for long |
| 116 |
% titles in the table of contents on its own without making a mess of |
| 117 |
% it. poemscol can break the lines for long titles on its own without |
| 118 |
% making a mess of it. Modified commands for volume titles to use the |
| 119 |
% facilities for poem titles.} \changes{v2.36}{2005/8/16}{Versions of |
| 120 |
% note commands for typescript variants and accidentals for annotated |
| 121 |
% prose. Commands for marking up and annotating prose by paragraph and |
| 122 |
% sentence number. Commands for cross references by sentence and |
| 123 |
% paragraph number.} \changes{v2.37}{2005/8/30}{In cases of broken |
| 124 |
% lines or runover lines you can choose whether to set the line number |
| 125 |
% with the beginning of the line or with the end of the line. Also, |
| 126 |
% you can choose to have it set the number always at the beginning if |
| 127 |
% the line number is at the left, and always at the end if it is at |
| 128 |
% the right.} \changes{v2.38}{2005/9/04}{Checked cases where commands |
| 129 |
% might introduce extra white space. Made sure that line numbers for |
| 130 |
% verse, prose, and paragraph-sentence prose line up. Fixed |
| 131 |
% overlapping of paragraph and line numbers for paragraph-sentence |
| 132 |
% mode. Up to four sentences can appear on a line in paragraph-line |
| 133 |
% mode without having their marginal line numbers overlap. Fixed a |
| 134 |
% bug that added an extra colon in footnotes in paragraph-sentence |
| 135 |
% format. Changed ``gutter'' and ``outer'' line numbering in verse |
| 136 |
% and paragraph-sentence prose to use Peter Wilson's sidepars rather |
| 137 |
% than marginpars.} \changes{v2.39}{2005/9/07}{Left a DeclareOption |
| 138 |
% hanging in version 2.38. Fixed that.} |
| 139 |
% \changes{v2.391}{2005/10/06}{Corrections to user's guide.} |
| 140 |
% \changes{v2.392}{2005/10/13}{More corrections to user's guide.} |
| 141 |
% \changes{v2.394}{2005/12/10}{More corrections to user's guide.} |
| 142 |
% \changes{v2.4}{2006/02/25}{Commands to make new kinds of endnotes |
| 143 |
% also make notes for line numbered prose sections and for prose |
| 144 |
% sections with paragraph and sentence numbering.} |
| 145 |
% \changes{v2.41}{2006/03/02}{Fixed a bug in line numbers of new kinds |
| 146 |
% of prose note.} \changes{v2.42}{2006/03/04}{Fixed error in handling |
| 147 |
% conditionals when setting prose numbered by sentence and paragraph.} |
| 148 |
% \changes{v2.43}{2006/03/06}{Notes in prose numbered by sentence and |
| 149 |
% paragraph number can refer only to the sentence number even when |
| 150 |
% paragraphs are also being counted.} |
| 151 |
% \changes{v2.44}{2006/03/07}{Fixed a bug which caused new kinds of |
| 152 |
% endnotes in prose sections to add unwanted white space to the |
| 153 |
% output.} \changes{v2.45}{2006/04/08}{Use of sidepar in v2.38 |
| 154 |
% introduced a problem, causing line numbers sometimes to drift up a |
| 155 |
% point. Changed commands for putting verse line numbers, but not |
| 156 |
% paragraph and sentence numbers, to use marginpars again.} |
| 157 |
% \changes{v2.46}{2006/04/10}{Changed definition of sidepar so that it |
| 158 |
% uses struts to find the depth of the line, restored line number |
| 159 |
% commands to use sidepar and its variants.} |
| 160 |
% \changes{v2.47}{2006/04/12}{Changed name of sidepar to pcmclsidepar |
| 161 |
% to avoid conflicts with the sidepar command from the memoir class, |
| 162 |
% since they are no longer exactly the same. Added commands to put a |
| 163 |
% marginal reference to the notes section in the margins of poem |
| 164 |
% titles.} \changes{v2.48}{2006/04/13}{Added more general form of the |
| 165 |
% commands to put a marginal reference to the notes section in the |
| 166 |
% margins of poem titles.} \changes{v2.49}{2006/04/25}{Changed |
| 167 |
% marginal reference command to use marginpar rather than pmclsidepar |
| 168 |
% (alas, it still adds vertical white space after the title with |
| 169 |
% pmclsidepar). Added marginal reference commands for sequences and |
| 170 |
% sequence sections. Fixed errors in manual. } |
| 171 |
% \changes{v2.50}{2006/05/13}{Added marginal reference commands for |
| 172 |
% poem sections, poem subtitles, epigraphs, and dedications. These |
| 173 |
% commands no longer require an additional label command to set the |
| 174 |
% label to which they refer. Added commands to make marginal |
| 175 |
% references to the pages in notes sections where comments on |
| 176 |
% individual lines may be found, for textual notes, explanatory notes, |
| 177 |
% emendations, and user-defined notes. Added commands for changing |
| 178 |
% the names of the Table of Contents, the various endnotes sections, |
| 179 |
% and the running headers for the contents and endnotes sections, in |
| 180 |
% order to facilitate editions of works in languages other than |
| 181 |
% English.} \changes{v2.51}{2006/05/22}{Changed prose section |
| 182 |
% environment so that it does not always assume that the modulo for |
| 183 |
% line numbers in prose is the same as the number in verse. Corrected |
| 184 |
% a problem with alignment of line numbers in the prosesectionnoreset |
| 185 |
% environment. Added commands to support generation of multiple |
| 186 |
% indices using the splitindex package. Fixed a variety of small |
| 187 |
% bugs, including a newly introduced one in the correction to textual |
| 188 |
% notes for quoted verse.} \changes{v2.52}{2007/07/10}{Changed |
| 189 |
% dedication to poemdedication to avoid a conflict with a command in |
| 190 |
% koma-script. dedication command is provided using providecommand |
| 191 |
% for compatibility} \changes{v2.53}{2007/07/14}{Changed the name of |
| 192 |
% an internal token register to avoid a conflict with babel} |
| 193 |
% \changes{v2.531}{2011/08/16}{Fixed a typo in example code.} |
| 194 |
% \GetFileInfo{poemscol.sty} \changes{v2.6}{2012/08/31}{Added an |
| 195 |
% optional argument to the poem environment to center the text block |
| 196 |
% of the poem on the longest line. Added a switch to enable titles to |
| 197 |
% be centered on the page.} \changes{v2.61}{2013/02/06}{Added a |
| 198 |
% boolean to switch notes to one note per paragraph form. Boolean to |
| 199 |
% switch off poem titles in notes. Two column formatting for notes sections.} |
| 200 |
% \changes{v2.62}{2013/05/22}{You can adjust the margins of |
| 201 |
% epigraphs, dedications, and similar things. Made the appearance of |
| 202 |
% entries in the table of contents for endnotes sections |
| 203 |
% customizable. Fixed a bug which caused user-defined |
| 204 |
% endnotes to put extra white space in prose passages.} |
| 205 |
% \changes{v2.63}{2013/06/01}{Revisions to manual.} |
| 206 |
% \changes{v2.64}{2013/08/02}{Bug fix: remove extra white space in |
| 207 |
% custom endnotes for prose sections when notes are in single paragraph mode. Fix |
| 208 |
% appearance of page number in endnote sections.} |
| 209 |
% \changes{v2.65}{2013/12/20}{Modifications to parallel text commands, |
| 210 |
% corrections to manual.} |
| 211 |
% \changes{v2.66}{2015/5/14}{Change to page styles} |
| 212 |
% \changes{v2.7}{2015/6/18}{Improvements to parallel texts.} |
| 213 |
% \changes{v2.72}{2015/6/25}{Improvements to parallel texts. Generic note types for parallel texts. |
| 214 |
% corrections to manual.} |
| 215 |
% \changes{v2.8}{2017/8/25}{Changes in default values about where line numbers |
| 216 |
% are placed. verselinenumberstoleft and related commands no longer change |
| 217 |
% marginparsep. Endnote sections may have normal or hanging paragraphs. |
| 218 |
% Endnotes may have multiple paragraphs.} |
| 219 |
% \changes{v2.81}{2017/8/30}{Versemarginadjust to |
| 220 |
% adjust margins of the verse block. Line numbers automatically move closer to |
| 221 |
% the text when the text block is centered on the longest line. New boolean to |
| 222 |
% force line numbers to the margins when the text block is centered. New commands to |
| 223 |
% control the distance of line numbers from margins of centered text block. New default |
| 224 |
% values for marginparwidth and marginparsep.} |
| 225 |
% \changes{v2.85}{2017/9/03}{Boolean to turn centering of verse block on and off. |
| 226 |
% Subtitles center when centertitles is issued. New boolean to adjust placement of marginal |
| 227 |
% reference markers in jhtextnote and related commands.} |
| 228 |
% \changes{v2.87}{2017/10/23}{Notes to appear at the end of individual poems.} |
| 229 |
% \changes{v2.88}{2017/10/29}{Revisions to manual.} |
| 230 |
% \changes{v2.89}{2017/11/30}{Append the date to the end of the poem.} |
| 231 |
% \changes{v2.9}{2017/12/02}{Date aligns with left margin of poem even when poem is centered.} |
| 232 |
% \changes{v2.95}{2017/12/20}{Long poems can put firstline---lastline in running header. |
| 233 |
% Revisions to manual. Textual notes, emendation notes, and explanatory notes can also be |
| 234 |
% placed at the end of the poem rather than at the bottom of the page or in an endnote section. |
| 235 |
% Commands to set the title only in the contents and only in the notes.} |
| 236 |
% \changes{v2.96}{2018/01/02}{Epigraphs, headnotes, dedications, and attributions move |
| 237 |
% towards the center when titles are centered. Easier customization of epigraphs and similar things.} |
| 238 |
% \changes{v2.97}{2018/01/05}{Correction to JHepigraphs. Epigraphenvironment for |
| 239 |
% headnotes with more than one stanza or paragraph. Corrections to manual.} |
| 240 |
% \changes{v2.98}{2018/01/11}{Corrections to manual.} |
| 241 |
% \changes{v2.99}{2019/08/02}{Hierarchy of indented stanzas} |
| 242 |
% \changes{v3}{2019/08/03}{With centered verse you can align the title, epigraphs, |
| 243 |
% attributions, and so on with the left margin of the verse block.} |
| 244 |
% \changes{v3.01}{2019/08/04}{Corrections to manual} |
| 245 |
% \changes{v3.04}{2019/08/18}{Appendix sections. New contents entries.} |
| 246 |
% \changes{v3.08}{2019/09/03}{Indentations of species of titles in text can be independently changed without changing the |
| 247 |
% definition of the title. Appendix and Foreword section titles can be indented differently from notes section titles. } |
| 248 |
% \changes{v3.081}{2019/09/05}{Fixed centertitles bug for subsections} |
| 249 |
% \changes{v3.09}{2019/09/06}{New schemes for titles. Titles can be placed |
| 250 |
% according the indentation schemes introduced in version 3.08, at the left text margin, at |
| 251 |
% the left verse margin, centered over the longest line of a verse block at the left verse margin, |
| 252 |
% at the left margin of a verse block centered on the longest line, and centered over a verse |
| 253 |
% block centered over the longest line.} |
| 254 |
% \changes{v3.1}{2019/09/08}{New commands shortpoemepigraph, shortpoemdedication, |
| 255 |
% shortpoemattribution, JHshortepigraph, JHshortdedication. These |
| 256 |
% commands are controlled by the same booleans that control placement |
| 257 |
% of titles.} |
| 258 |
% \changes{v3.12}{2019/09/05}{Bug fix. Fix command clash with titlesec. Manual revision} |
| 259 |
% \changes{v3.13}{2019/09/15}{Fixed subtitles in emendations and explanations, Fixed bug in sequencesectiontitlefirstline, changed sequence hierarchy of indentations, subsubsections of sequences no longer appear in contents} |
| 260 |
% \changes{v3.14}{2019/09/27}{Bug fix: ifpagenumberinnotesfalse, Manual revision} |
| 261 |
% \changes{v3.141}{2019/10/27}{Manual revisions. Fixed spacing of sentence and |
| 262 |
% paragraph numbers in |
| 263 |
% sections numbered by paragraph and sentence. You can suppress the appearance of the |
| 264 |
% first sentence number, whether in the margin or in the running text. You can suppress |
| 265 |
% the appearance of the first paragraph number, whether in the margin or in the running text.} |
| 266 |
% \changes{v3.1415}{2020/05/25}{Changed controlling how to place |
| 267 |
% marginal marks in JHpoemtitle and its siblings, and in JHtextnote |
| 268 |
% and its siblings. Marginal marks are now set using their own inserts, rather than using marginpar.} |
| 269 |
% \changes{v3.14159}{2020/06/02}{Marginal marks set by JHpoemtitle now work with the different |
| 270 |
% title placement schemes.} |
| 271 |
% \changes{v3.141592}{2020/06/12}{Special commands for titles with footnotes (where the footnotes |
| 272 |
% are authorial and part of the title). Title footnotes can be set at the bottom of the page, like |
| 273 |
% traditional footnotes, at the bottom of the page like ``Layered'' footnotes, or at the |
| 274 |
% end of the poem. Marginal marks set by JHpoemtitle can be placed |
| 275 |
% independently of the marginal marks produced by margreftextnote..} |
| 276 |
% \changes{v3.1415926}{2020/08/08}{Bug fix. Extra white space problem. Thanks to David Carlisle.} |
| 277 |
% \DoNotIndex{\newcommand,\newenvironment,\def,\edef,\else,\renewcommand,\makeatletter,\makeatother} |
| 278 |
% \DoNotIndex{\abovedisplayskip,\belowdisplayskip,\abovedisplayshortskip,\belowdisplayshortskip} |
| 279 |
% \DoNotIndex{\newcommand, \section, \subsection, \subsubsection, |
| 280 |
% \fileversion,} \DoNotIndex{\filedate, \docdate, \leavevmode, |
| 281 |
% \vspace, \small, \normalsize, \fontsize,} \DoNotIndex{\newcommand, |
| 282 |
% \section, \subsection, \subsubsection, \fileversion} |
| 283 |
% \DoNotIndex{\filedate, \docdate, \leavevmode, \vspace, \small, |
| 284 |
% \normalsize, \fontsize} \DoNotIndex{\selectfont, \abovedisplayskip, |
| 285 |
% \belowdisplayskip, \setlength, \item} \DoNotIndex{\global, \input, |
| 286 |
% \def, \edef, \texttt, \textsf, \setcounter} |
| 287 |
% \DoNotIndex{\pagenumbering, \oddsidemargin, \evensidemargin, |
| 288 |
% \newdimen, \renewcommand} \DoNotIndex{\makeatletter, \let, \@listi, |
| 289 |
% \@listl, \z@, \@xpt, \@xipt, \p@ , \@plus2} \DoNotIndex{\@minus5, |
| 290 |
% \@minus3, \@plus3, \makeatother, \@minus4, \relax, \pagestyle} |
| 291 |
% \DoNotIndex{\fancyhead, \fancyfoot, \thepage, \@ixp} |
| 292 |
% \DoNotIndex{\begin \botmark, \botmark, \catcode, \croppadbot, |
| 293 |
% \croppadtop} \DoNotIndex{\croppagewidth, \endverse, \equal, |
| 294 |
% \fancyfoot, \fancyhead, \fancyhf} \DoNotIndex{\fancypagestyle, |
| 295 |
% \firstmark, \footrulewidth, \hbox, \hbox, \headrulewidth} |
| 296 |
% \DoNotIndex{\hfil, \hspace, \ifthenelse, \immediate, \itemindent, |
| 297 |
% \listparindent} \DoNotIndex{\makeatletter, \nolinebreak, \openout, |
| 298 |
% \raggedbottom, \setcounter, \textrm} \DoNotIndex{\value, \vspace, |
| 299 |
% \write} \DoNotIndex{\afterpoemtitleskip, \addtocounter, \advance, |
| 300 |
% \begin, \bf, \bigskip} \DoNotIndex{\bigskipamount, \fi, \@fulltitle, |
| 301 |
% \label, \large, \leftheader} \DoNotIndex{\leftheadervalue, |
| 302 |
% \leftmargin, \leftmargini} \DoNotIndex{\medskip, \newcounter, |
| 303 |
% \nobreak, \par, \textbf} |
| 304 |
% \DoNotIndex{\closeout,\em,\emph,\expandafter,\Huge,\it,\jobname,\kern,\newif, |
| 305 |
% \newwrite,\p@,\pageref,\renewenvironment,\rm,\scriptsize,\string, |
| 306 |
% \textsc, \unskip} |
| 307 |
% \setcounter{IndexColumns}{2} |
| 308 |
% \MakeShortVerb{|} |
| 309 |
% \def\fileversion{3.1415926} |
| 310 |
% \def\filedate{8 August 2020} |
| 311 |
% \def\docdate{8 August 2020} |
| 312 |
% \title{Typesetting Poetry Collections with |
| 313 |
% \textsf{poemscol}\thanks{This document corresponds to |
| 314 |
% \textsf{poemscol}~\fileversion, dated \filedate.}} |
| 315 |
% \author{John Burt |
| 316 |
% \\ \texttt{[email protected]}} |
| 317 |
% \date{8 August 2020} |
| 318 |
% \maketitle |
| 319 |
% \begin{abstract} \textsf{poemscol} provides commands for \LaTeX\ for |
| 320 |
% setting collections of poetry. It is especially suited for setting |
| 321 |
% collections of poetry in which several volumes are combined, such as |
| 322 |
% in a critical edition of a poet's Collected Poems. It provides the |
| 323 |
% structures required to produce a critical edition of the kind |
| 324 |
% specified by the Modern Language Association's Committee on |
| 325 |
% Scholarly Editions, and it automatically marks every occasion where |
| 326 |
% a stanza break falls on a page break. \end{abstract} |
| 327 |
% \tableofcontents \hfuzz=50pt \section{Introduction} |
| 328 |
% |
| 329 |
% \textsf{poemscol} provides the structures necessary for editing a |
| 330 |
% critical edition of a volume of poems (or of a collection of a poet's |
| 331 |
% works) such as those required by the Modern Language Association's |
| 332 |
% Committee on Scholarly Editions. \textsf{poemscol} numbers the lines, and produces separate, |
| 333 |
% formatted endnote sections (or, optionally, |
| 334 |
%multiple layers of footnotes) for emendations, textual collations, and |
| 335 |
% explanatory notes, tying |
| 336 |
% each note to the range of lines upon which it is a comment. |
| 337 |
% |
| 338 |
% Producing line numbers for verse is something for which \LaTeX\ |
| 339 |
% would seem to be especially suited. A line of verse, after all, is |
| 340 |
% not a carriage return but a logical unit, an element of |
| 341 |
% versification more than of typesetting, perhaps running over several |
| 342 |
% physical lines, or perhaps split into half-lines as speakers or |
| 343 |
% subjects change. With \textsf{poemscol} you mark lines, stanzas, |
| 344 |
% and entire poems up as logical units, and \LaTeX\ does the |
| 345 |
% formatting and counting. Once you have marked out the logical units |
| 346 |
% of the poem, \textsf{poemscol} will automatically mark every textual |
| 347 |
% note, emendation, or explanatory note with the range of line |
| 348 |
% numbers to which it applies. |
| 349 |
% |
| 350 |
% Editions of Collected Poetry might also require special structures |
| 351 |
% to reflect the fact that they are made up of the contents of several |
| 352 |
% volumes of poetry. In particular, such editions require |
| 353 |
% facilities for setting up specially formatted divider pages between |
| 354 |
% volumes. They also require tables of contents and other front matter, as well |
| 355 |
% as an index of titles and first lines (or, optionally, several separate indices) |
| 356 |
% and other sorts of back matter. |
| 357 |
% \textsf{poemscol} automatically generates a table of contents, an index of titles |
| 358 |
% and first lines, and divider pages for the sections of the volumes. |
| 359 |
% It produces running headers of the form ``Emendations to pp.~xx-yy'' |
| 360 |
% for the note sections. |
| 361 |
% |
| 362 |
% In poetry which does not have a regular stanzaic form, it is useful |
| 363 |
% to be able to mark automatically occasions where there is a stanza |
| 364 |
% break at the bottom of a page which the reader might not notice. |
| 365 |
% Doing this by hand is not only tedious and easy to get wrong, but |
| 366 |
% also a process you will have to start over again if anything about |
| 367 |
% your volume changes --- if you add a poem, say, or even decide to break |
| 368 |
% a title across two lines. \textsf{poemscol} takes care of this |
| 369 |
% process, so that the editor need never worry about it, automatically |
| 370 |
% marking cases where the page break coincides with a stanza break |
| 371 |
% with a symbol. |
| 372 |
% |
| 373 |
% \textsf{poemscol} includes facilities for typesetting parallel text editions |
| 374 |
% of poems, for instance to compare different versions or translations of the same poem |
| 375 |
% on the recto and verso pages. \textsf{poemscol} will keep the line |
| 376 |
% numbering of the two texts separate, will provide separate endnote sections |
| 377 |
% for textual notes, emendations, and explanatory notes for the different texts, |
| 378 |
% and will also make marginal markers to tie lines in the verso text to the |
| 379 |
% equivalent line in the recto text. |
| 380 |
% |
| 381 |
% \textsf{poemscol} is also suited for verse drama, and the package |
| 382 |
% \textsf{dramatist} has been modified to work with \textsf{poemscol}. |
| 383 |
% |
| 384 |
% \textsf{poemscol} can provide line numbers and notes for prose |
| 385 |
% sections such as the author's introduction or prose poetry. (It |
| 386 |
% can also handle inset prose passages in the midst of verse, pausing and |
| 387 |
% restarting verse line numbering as the editor desires.) |
| 388 |
% It also has some limited facilities for typesetting and annotating |
| 389 |
% line-numbered parallel passages in prose. |
| 390 |
% \textsf{poemscol} is not, however, designed for typesetting critical editions of large |
| 391 |
% scale prose works, although very possibly it could be tweaked to |
| 392 |
% work. For critical editions of prose works, several |
| 393 |
% other packages are available, including the \texttt{EDMAC} format, a |
| 394 |
% \TeX\ format analogous to but distinct from \LaTeX, by John |
| 395 |
% Lavagnino and Dominik Wujastyk, or \textsf{ledmac}, a port of |
| 396 |
% \texttt{EDMAC} into \LaTeX\ originally by Peter Wilson and |
| 397 |
% now maintained as \textsf{reledmac} by Ma\"{\i}eul Rouquette, or \textsf{ednotes}, a |
| 398 |
% completely independent set of commands for critical editions which |
| 399 |
% builds on \textsf{manypar} and \textsf{lineno}, by Uwe L\"{u}ck. |
| 400 |
% |
| 401 |
% \textsf{poemscol} can number and annotate prose marked in |
| 402 |
% ``paragraph number: sentence number'' |
| 403 |
% format (or bible chapter and verse). The advantage of this method of numbering lines |
| 404 |
% of prose is that what is numbered is something the author chose to create |
| 405 |
% (sentences and paragraphs) |
| 406 |
% rather than an accidental feature of typesetting (line numbers). Paragraph and sentence |
| 407 |
% numbering will also be stable across multiple editions, and, like line numbers in verse, |
| 408 |
% provides a common system of reference. |
| 409 |
% |
| 410 |
% \textsf{poemscol} provides |
| 411 |
% the ability to make cross references to verse line numbers, to line numbers in prose sections, |
| 412 |
% or to paragraph and sentence numbers in sections with ``paragraph and sentence'' annotation. |
| 413 |
% |
| 414 |
% \textsf{poemscol} also provides a few bells and whistles, such as the ability |
| 415 |
% to create new endnote or footnote sections on the fly, the ability |
| 416 |
% to center a poem on the longest line (or to move the margin of the |
| 417 |
% verse block wherever you wish), and the ability to place a mark in the margin |
| 418 |
% indicating where in the apparatus commentary on that line can be found. |
| 419 |
% For long poems, \textsf{poemscol} can provide a |
| 420 |
% a special running header which indicates the range of lines to be |
| 421 |
% found on the page. |
| 422 |
% It has a special command to place |
| 423 |
% the publication date under the poem just at the left margin of the verse block even |
| 424 |
% when the verse block is centered. |
| 425 |
% \textsf{poemscol} also provides notes |
| 426 |
% to be placed just after a poem (rather than at the bottom of the page |
| 427 |
% or in the endnote sections). It gives the user |
| 428 |
% fine control over the placement of line numbers and the placement and format of titles |
| 429 |
% including multi-line titles. |
| 430 |
% The user can choose whether to concatenate the notes for a poem into a single paragraph, |
| 431 |
% or to give each note a separate paragraph. The user can print the notes |
| 432 |
% in single or multicolumn format. The names of things like the Contents can |
| 433 |
% be changed to facilitate editions in languages other than English. |
| 434 |
% Just about every feature of \textsf{poemscol} can be |
| 435 |
% easily customized. |
| 436 |
% |
| 437 |
% The best features of \textsf{poemscol} are of course simply that it |
| 438 |
% is \TeX: it uses \TeX's automatic kerning and setting of ligatures, |
| 439 |
% its algorithm for justifying lines (in prose sections), and \LaTeX's |
| 440 |
% way of setting verse. |
| 441 |
% |
| 442 |
% Using \LaTeX\ to typeset critical editions offers more advantages |
| 443 |
% than simply the ability to automate tedious and easy to fumble |
| 444 |
% tasks. \TeX\ compilers have the ability to produce |
| 445 |
% output in Adobe pdf format. Adobe pdf output can be used as camera |
| 446 |
% ready copy, saving your publisher time and expense, and perhaps |
| 447 |
% making a marginally economic critical edition a bit easier to bring |
| 448 |
% to press. Furthermore, since typesetting the edition yourself in |
| 449 |
% \LaTeX\ obviates the publisher's own typesetting of your text, it |
| 450 |
% removes another possible source of new errors. (You should expect |
| 451 |
% to work with your publisher on the final design of the book, but |
| 452 |
% \LaTeX\ is a flexible language which will enable you to reproduce |
| 453 |
% most book designs.) |
| 454 |
% |
| 455 |
% Editions made in the formats of proprietary software such as |
| 456 |
% QuarkXPress\copyright\ or InDesign\copyright\ will become not only obsolete |
| 457 |
% but unreadable if those programs pass from use. Since your \LaTeX\ |
| 458 |
% sources for your edition are in ASCII, or perhaps Unicode, they provide a permanent |
| 459 |
% record of your local intentions at every point in your edition, |
| 460 |
% whether or not those who wish to consult your files have access to a |
| 461 |
% \LaTeX\ compiler, or indeed (since most of the commands have self-explanatory names) |
| 462 |
% whether or not they can read \LaTeX\ |
| 463 |
% code. |
| 464 |
% |
| 465 |
% Although \LaTeX\ is a typesetting language, not a content |
| 466 |
% markup language, the ability to create new commands which the |
| 467 |
% language offers comes very close to enabling one to realize the |
| 468 |
% ideal of completely separating content markup from formatting. One |
| 469 |
% advantage of this kind of markup is that even if the appearance of |
| 470 |
% the poem on the page may be ambiguous, the editor's intentions about |
| 471 |
% the logical structure of the poem will be preserved in the \LaTeX\ |
| 472 |
% source. Should you wish later to produce an electronic edition of |
| 473 |
% your work, perhaps using the XML markup approved by the Text |
| 474 |
% Encoding Initiative, transforming your texts from \LaTeX\ to XML |
| 475 |
% would largely (although not entirely) be a matter of performing a |
| 476 |
% series of global search-and-replaces, and could conceivably be done |
| 477 |
% with XSLT or with perl. |
| 478 |
% |
| 479 |
% This is a long manual, but there is no need to study it all before beginning. |
| 480 |
% In the first place, it includes all the commented-on source code for the |
| 481 |
% package, which will only matter to you if you are planning to customize |
| 482 |
% it in some way I didn't anticipate, or if you need to know how the commands |
| 483 |
% work internally. (The code section begins on page \pageref{implementation}.) |
| 484 |
% The most important commands are explained in the first 30 pages, and even there |
| 485 |
% many sections discuss things you may not need to know immediately. Also, |
| 486 |
% many sections conclude with a subsection which suggests ways of customizing |
| 487 |
% the output, usually giving suggestions in increasing order of difficulty. You'll |
| 488 |
% have to be the judge of what to skip the first time through. |
| 489 |
% |
| 490 |
% \section{Dependencies and compatibility with other packages} |
| 491 |
% |
| 492 |
%\subsection{~General} |
| 493 |
% \textsf{poemscol} depends upon several other packages, which you |
| 494 |
% should be sure you have in your preamble and search path: |
| 495 |
% \textsf{fancyhdr} for managing the running headers, \textsf{makeidx} |
| 496 |
% and \textsf{multicol} for managing the index, \textsf{geometry}, and |
| 497 |
% \textsf{ifthen} and \textsf{keyval} to simplify page geometry. |
| 498 |
% |
| 499 |
% If you are planning to generate multiple indices, substitute |
| 500 |
% \textsf{splitindex} for \textsf{makeidx} in your list of packages. |
| 501 |
% |
| 502 |
% |
| 503 |
% \subsection{~Prose sections} |
| 504 |
% If you plan to number lines in prose contexts, and to make textual |
| 505 |
% notes, emendations, or explanatory notes in prose contexts, you will |
| 506 |
% need to add the \textsf{lineno} package to your preamble. I use the |
| 507 |
% ``right'' and ``modulo'' options with this package, but you can set |
| 508 |
% the options however you wish to make how you number the lines of |
| 509 |
% prose sections consistent with how you number the lines of verse |
| 510 |
% sections. |
| 511 |
% |
| 512 |
% \subsection{~Multi-layer footnotes} If you plan to use |
| 513 |
% paragraph-formatted footnotes rather than endnotes, you should load |
| 514 |
% \textsf{manyfoot}. You should load it with the ``ruled,'' and |
| 515 |
% ``para'' options. (\textsf{poemscol's} footnote commands are just a |
| 516 |
% wrapper around \textsf{manyfoot}.) \textsf{manyfoot} inherited some |
| 517 |
% of the limitations of \LaTeX\ in dealing with long inserts at the |
| 518 |
% end of the page, so you may have to do some fiddling. As fixes to |
| 519 |
% these problems emerge, I will incorporate them into |
| 520 |
% \textsf{poemscol}. \textsf{manyfoot} does not allow multiple |
| 521 |
% paragraph footnotes when typesetting in ``para'' mode. This is |
| 522 |
% probably a feature, not a bug, since one would want such notes to be |
| 523 |
% set in several paragraphs, rather than running them together into |
| 524 |
% one, as \textsf{manyfoot} would naturally want to do in para mode. |
| 525 |
% For that reason, I have defined the two traditional classes of note |
| 526 |
% in which multiple paragraph notes are likely to appear, ``sources,'' |
| 527 |
% and ``explanatory notes,'' to be typeset in ``plain'' mode, which |
| 528 |
% opens a new paragraph with each note. If your textual notes or |
| 529 |
% emendations sections also have multiple paragraph notes, you should |
| 530 |
% re-define them in order to produce footnotes in plain rather than in |
| 531 |
% para mode, if you wish to produce footnotes rather than endnotes. |
| 532 |
% |
| 533 |
% \textsf{manyfoot} sometimes gets into conflicts with other packages |
| 534 |
% over the number of |\counts| it uses, causing \LaTeX\ to complain |
| 535 |
% that there is no room for a |\newcount|. If this happens, |
| 536 |
% issue |\usepackage{etex}| and |\reserveinserts| in your preamble. |
| 537 |
% |
| 538 |
% \subsection{~Special running header for long poems} |
| 539 |
% For long poems, it is a convenience to have a running header |
| 540 |
% that includes information about what lines of the poem appear |
| 541 |
% on that page in the form firstline--lastline. The fancypagestyle |longpoem| |
| 542 |
% will set that information in the running header. That page style |
| 543 |
% uses the |\marks| mechanism, and requires more |\marks| than |
| 544 |
% are available by default. To use it, you will need to add the \textsf{etex} and |
| 545 |
% \textsf{emarks} packages to your preamble. |
| 546 |
% |
| 547 |
% \subsection{~Verse drama and \textsf{dramatist}} |
| 548 |
% Massimiliano Dominici has made his \textsf{dramatist} package |
| 549 |
% compatible with \textsf{poemscol}, for which I am very grateful. |
| 550 |
% Versions 1.2a or later of \textsf{dramatist} are compatible with |
| 551 |
% versions 2.3 or later of \textsf{poemscol}. |
| 552 |
% |
| 553 |
% |
| 554 |
% \subsection{~Parallel text editions} |
| 555 |
% \begin{sloppypar} |
| 556 |
% If you are using the six pre-defined endnote sections |
| 557 |
% for parallel text editions (|\rectotexnote|, |\versotextnote|, |\rectoemendation|, |\versoemendation|, |
| 558 |
% |\rectoexplanatory|, |\versoexplanatory| and their prose equivalents |\rectoprosetextnote| |
| 559 |
% and so on) you won't need to add any new packages. If |
| 560 |
% you are defining your own endnote sections using |\definenewnotetype| you may need |
| 561 |
% the |\keeptitlestraight| hack described below at section \ref{parallelhack}, |
| 562 |
% page \pageref{parallelhack}. If you use |\keeptitlesstraight| you should add \textsf{etoolbox} |
| 563 |
% to your package list.\end{sloppypar} |
| 564 |
% |
| 565 |
% \subsection{~Crop marks} |
| 566 |
% \textsf{poemscol} no longer provides cropmarks, but is compatible with |
| 567 |
% the style packages that do. I use \textsf{crop}, with the |
| 568 |
% letter,pdftex,cam, and center options. |
| 569 |
% |
| 570 |
% |
| 571 |
% |
| 572 |
% |
| 573 |
% \subsection{~Incompatibility with \textsf{memoir} and \textsf{verse}} |
| 574 |
% Unfortunately, \textsf{poemscol} is not compatible with the |
| 575 |
% \textsf{memoir} class and the \textsf{verse} package, because they |
| 576 |
% share some command names. I will eventually prepare a workaround for this |
| 577 |
% problem. |
| 578 |
% |
| 579 |
% \subsection{~Conflict with \textsf{BibLaTeX} } |
| 580 |
% \BibTeX\ works with \textsf{poemscol} with no problem. But a bug I haven't |
| 581 |
% yet tracked down (probably involving |\makeatletter|) |
| 582 |
% complicates the use of \textsf{BibLaTeX}. To use \textsf{BibLaTeX} |
| 583 |
% you will need to open up the .bbl file. You will find near the top |
| 584 |
% the following lines:\\ |
| 585 |
% |\makeatletter|\\ |
| 586 |
% |\@ifundefined{[email protected]}|\\ |
| 587 |
% | {\@latex@error|\\ |
| 588 |
% |{Missing 'biblatex' package}|\\ |
| 589 |
% | {The bibliography requires the 'biblatex' package.}|\\ |
| 590 |
% | \aftergroup\endinput}|\\ |
| 591 |
% |{}|\\ |
| 592 |
% Just comment out these lines and you will be able to use the .bbl file as usual. |
| 593 |
% |
| 594 |
% |
| 595 |
% \subsection{~Compatibility with earlier versions of |
| 596 |
% \textsf{poemscol}} Making \textsf{poemscol} compatible with |
| 597 |
% \textsf{lineno} required me also to change the commands for turning |
| 598 |
% verse line numbering on and off, which means that version 2.3 of |
| 599 |
% \textsf{poemscol} is incompatible with prior versions. The old |
| 600 |
% command |\makelinenumbers| has been replaced with |
| 601 |
% |\makeverselinenumbers| to distinguish it from a command from the |
| 602 |
% \textsf{lineno} world. (|\makelinenumbers| will still work, but I |
| 603 |
% have deprecated it.) To turn on verse line numbering, issue |
| 604 |
% |\makeverselinenumbers|. Because the counter ``linenumber'' has |
| 605 |
% been changed to ``verselinenumber,'' you must use |
| 606 |
% |\global\verselinenumbersfalse| to turn off line numbering, rather |
| 607 |
% than |\global\linenumbersfalse| as before. |
| 608 |
% |
| 609 |
% Up to version 2.44 \textsf{poemscol} borrowed the code for |
| 610 |
% |\sidepar| non-floating marginal paragraphs from the memoir class, |
| 611 |
% and also made |\leftsidepar| and |\rightsidepar| commands on their |
| 612 |
% model. Version 2.46 modified Peter Wilson's original code for |
| 613 |
% |\sidepar|, so therefore I have changed the names of |\sidepar|, |
| 614 |
% |\leftsidepar|, and |\rightsidepar| to |\pmclsidepar|, |
| 615 |
% |\pmclleftsidepar| and |\pmclrightsidepar| respectively. If you |
| 616 |
% used any of these commands in your files, you will need to change |
| 617 |
% their names. |
| 618 |
% |
| 619 |
% Up to version 2.5 the |\definenewnotetype| command took four |
| 620 |
% arguments, using the third argument for both the running header for |
| 621 |
% the notes section and for the entry in the table of contents. In |
| 622 |
% order to make it easier to handle titles in languages other than |
| 623 |
% English I have found it necessary to separate these two uses, so |
| 624 |
% |\definenewnotetype| now takes five arguments. You will need to |
| 625 |
% retrofit files that use the old version of this command. You can |
| 626 |
% see the details at section \ref{definingnewnotes}, page |
| 627 |
% \pageref{definingnewnotes}. |
| 628 |
% |
| 629 |
%\begin{sloppypar} |
| 630 |
% Version 3 introduced the boolean |\ifleftaligntitles|, for aligning the title with |
| 631 |
% the left edge of a verse block centered on the longest line. Version 3.1 introduces |
| 632 |
% new title placement schemes, including one which |
| 633 |
% centers the title on the longest line of a verse block at the left margin. This made |
| 634 |
% the meaning of |\ifleftaligntitles| ambiguous. So I have changed that boolean to |
| 635 |
% |\iftitlesatleftmarginofcenteredblock.|\end{sloppypar} |
| 636 |
% |
| 637 |
% Up to version 3.141 the marginal marks associated with poem titles |
| 638 |
% set by |\JHpoemtitle| and |\margreftextnote| moved in towards the |
| 639 |
% verse block when the verse block is centered on the longest line. |
| 640 |
% These marks could be returned to their normal position in the |
| 641 |
% margin by setting the boolean |\margrefstomargin| to true. As of |
| 642 |
% version 3.141 these marks are set in the margin by default even |
| 643 |
% when verse block centering is in effect. The boolean |\margrefstomargin| controls |
| 644 |
% nothing, but has been left in case I decide to restore the possibility |
| 645 |
% of moving the marginal marks in when the lines are centered. You can control |
| 646 |
% the horizontal placement of these marginal marks by changing the value |
| 647 |
% of the length |\JHmarginparsep|. |
| 648 |
% |
| 649 |
% \section{Marking up individual poems} |
| 650 |
% First, a word about the command names. The command names may seem |
| 651 |
% ugly and long. And there are separate commands for many tasks that |
| 652 |
% seem closely related, such as a command to mark the title of a |
| 653 |
% section of a poetic sequence, and a separate command to mark a |
| 654 |
% subsection. But the names do describe pretty much what |
| 655 |
% each command does, and they do specify exactly what the object they |
| 656 |
% mark is supposed to be. The markup is designed to look like content |
| 657 |
% markup, marking objects as a poem title, as a stanza, as a line, and so on. |
| 658 |
% \textsf{poemscol} gives all of these content terms typographical |
| 659 |
% meaning. |
| 660 |
% |
| 661 |
% There are also many commands for special purposes whose necessity |
| 662 |
% may not seem clear until the editor finds him or herself in the jam |
| 663 |
% the command was designed for. For instance, \textsf{poemscol} |
| 664 |
% normally encourages a page break before the title of a poem, or |
| 665 |
% before the title of a section of a poetic sequence, to discourage |
| 666 |
% page breaks between the title and the poem. But for the first |
| 667 |
% section of a poetic sequence, or the first section of a poem in |
| 668 |
% sections, one does not want to encourage \LaTeX\ to break the page |
| 669 |
% before the section title, since that would leave the title of the sequence |
| 670 |
% or the title of the larger poem as an orphan on the previous page. |
| 671 |
% |\sequencefirstsectiontitle| and its siblings are designed for this |
| 672 |
% situation. Although all commands like |\sequencefirstsectiontitle| |
| 673 |
% discourage page breaks before the title (and all of the commands |
| 674 |
% discourage page breaks after the title), widowed or orphaned titles, |
| 675 |
% and orphaned first lines will still sometimes |
| 676 |
% happen, particularly if you have a multi-line sequence title |
| 677 |
% followed by a multi-line section title. For these cases, a page |
| 678 |
% break at some other suitable point will have to be explicitly issued to |
| 679 |
% move widowed or orphaned lines to better places. |
| 680 |
% |
| 681 |
% \subsection{~The title of the poem} |
| 682 |
% |
| 683 |
% \DescribeMacro{\poemtitle}|\poemtitle|, as its name implies, sets |
| 684 |
% its argument as the title of the poem. |
| 685 |
%The command takes one |
| 686 |
% argument --- the title, of course. The command typesets the title in |
| 687 |
% the body of the volume (testing first to see whether there is enough |
| 688 |
% space at the bottom of the page to get the title and a couple of |
| 689 |
% lines of the poem in), typesets the title in the table of contents |
| 690 |
% (with the page number), typesets the title in the textual notes |
| 691 |
% (adding the page number, and checking to see whether there is room |
| 692 |
% enough on the page), and prepares similar entries in the lists of |
| 693 |
% emendations and in the explanatory notes (if you need them) |
| 694 |
% as well as in the endnote sections for any species of endnote you have defined for yourself. |
| 695 |
% \textsf{poemscol} gives default values for |
| 696 |
% such things as the font size, the separation between the top of the |
| 697 |
% title and the bottom of the previous poem, the separation between |
| 698 |
% the bottom of the title and the first line, and so on. It also sets |
| 699 |
% penalties in order to encourage page breaks just before a title, and |
| 700 |
% to discourage page breaks between a title and a poem. |
| 701 |
% |
| 702 |
% You can |
| 703 |
% change all these values in your preamble by changing the value of |
| 704 |
% the parameters for the relevant commands, listed below in the implementation section, using |
| 705 |
% either |\setlength| or |\renewcommand| (depending upon what you are |
| 706 |
% changing). Some common values you might change are described in section |
| 707 |
% \ref{titlecustomization}. |
| 708 |
% |
| 709 |
% \subsubsection{Title placement schemes} |
| 710 |
% \begin{sloppypar} |
| 711 |
% There are a number of places where a title might be set. I have |
| 712 |
% defined for this purpose five ``title placement schemes.'' For each |
| 713 |
% one there is a boolean which turns on the choice, and a ``scheme'' |
| 714 |
% command which switches that boolean on and switches off the |
| 715 |
% booleans for the other schemes. They are |
| 716 |
% |
| 717 |
% \begin{itemize} |
| 718 |
%\item Aligned with the left print margin, or |
| 719 |
% indented from it according to the scheme of title indentations (whether it is |
| 720 |
% the title to a poem, to a section, to a subsection, or so on). The |
| 721 |
% hierarchy of indentations for various kinds of title is described |
| 722 |
% below at section \ref{customtitleindentations}, |
| 723 |
% page \pageref{customtitleindentations}. |
| 724 |
% I will call the boolean that describes this |
| 725 |
% situation |\ifnormaltitleindentation| because it was the default for |
| 726 |
% \textsf{poemscol}. You invoke this title scheme with the command |
| 727 |
% |\normaltitleindentationscheme| |
| 728 |
% |
| 729 |
% \item Aligned with the left margin of a left-aligned verse block. |
| 730 |
% The verse block is normally inset from the left print margin by the length |
| 731 |
% |\leftmargini | (the default distance between the left margin of |
| 732 |
% a list environment --- I defined titles as lists --- and the surrounding text). |
| 733 |
% I will call the boolean that describes |
| 734 |
% title placement at the left verse margin |\iftitlesatleftversemargin|. You invoke this title |
| 735 |
% scheme with the command |\titlesatleftversemarginscheme|. |
| 736 |
% |
| 737 |
% \item Centered over the longest line of a left-aligned verse block. |
| 738 |
% I will call the boolean that describes this title placement |
| 739 |
% |\iftitlescenteredonleftverseblock|. The corresponding command is |
| 740 |
% |\titlescenteredonleftverseblockscheme|. |
| 741 |
% |
| 742 |
% \item Aligned with the left margin of a verse block centered on the |
| 743 |
% page on the longest line. This will be associated with the boolean |
| 744 |
% |\iftitlesatleftmarginofcenteredblock|. (In version 3.0 this boolean |
| 745 |
% was called |\ifleftaligntitles|. I have removed that boolean |
| 746 |
% because its meaning is ambiguous now.) The command to invoke this |
| 747 |
% title scheme is |\titlesatleftmarginofcenteredblockscheme|. |
| 748 |
% |
| 749 |
% |
| 750 |
% \item Titles centered over a centered verse block. I call this |
| 751 |
% |\ifcentertitleson|. The corresponding command is |
| 752 |
% |\centertitlesscheme|. I have retained the command |\centertitles| |
| 753 |
% from earlier versions of \textsf{poemscol} for compatibility. This |
| 754 |
% scheme can also be used to center the titles (and epigraphs, headnotes |
| 755 |
% and other top matter) over a non-centered verseblock too, if you |
| 756 |
% don't use the optional argument to |\begin{poem}| describe in the next |
| 757 |
% section, or if you turn off centering of the verse block by issuing the |
| 758 |
% boolean |\textcenteringturnedonfalse|. |
| 759 |
%\end{itemize}\end{sloppypar} |
| 760 |
% |
| 761 |
% \subsubsection{Using title placement schemes: verse width and title width} |
| 762 |
% \begin{sloppypar} |
| 763 |
% |\centertitlesscheme|, |\titlescenteredonleftverseblockscheme|, and \\ |
| 764 |
% |\titlesatleftmarginofcenteredblockscheme| require additional information |
| 765 |
% about each poem. Here are some details about the uses of these schemes.\end{sloppypar} |
| 766 |
% |
| 767 |
% \DescribeMacro{\centertitlesscheme} For each poem you wish to center you will have |
| 768 |
% to set the length of the length variable |\versewidth| to the |
| 769 |
% width of the longest line. To do this, use |\settowidth| as |
| 770 |
% follows:\\ |\settowidth{\versewidth}{text of longest line}|.\\ |
| 771 |
% |\centertitlesscheme| will center the |
| 772 |
% titles even if you do not center the verse block on the longest |
| 773 |
% line. |
| 774 |
% To center the verseblock use the optional argument to |\begin{poem}| as follows:\\ |
| 775 |
% |\begin{poem}[\versewidth].| \\ (For further instructions about |
| 776 |
% how to center the verse block on the longest line, see section \ref{centeringtextblock} |
| 777 |
% on page \pageref{centeringtextblock}.) |
| 778 |
% |
| 779 |
% |\centertitlesscheme| also moves in epigraphs, headnotes, |
| 780 |
% attributions, and dedications towards the center. Since an epigraph or a headnote may be |
| 781 |
% a prose paragraph, or a passage of verse, it would be unwise to set them in a centering |
| 782 |
% environment, so |\centertitles| just moves the margins of epigraphs and headnotes in |
| 783 |
% towards the center. To adjust the placement |
| 784 |
% of epigraphs and similar things, see section \ref{centerepigraphs}, page \pageref{centerepigraphs}. |
| 785 |
% Single line epigraphs, attributions, and dedications, however, |
| 786 |
% will be centered if |\centertitlesscheme| |
| 787 |
% is in effect. There are special commands for single line epigraphs, attributions, or dedications. |
| 788 |
% To set these, issue |
| 789 |
% |\shortpoemepigraph|, |\shortpoemdedication|, or |\shortpoemattribution|. |
| 790 |
% |
| 791 |
% \DescribeMacro{\titlescenteredonleftverseblockscheme} |
| 792 |
% |
| 793 |
% Using |\titlescenteredonleftverseblockscheme| |
| 794 |
% scheme will require you to make known the width of the longest line |
| 795 |
% of the poem being set \emph{and} the width of the title. You will need to |
| 796 |
% use the |\settowidth| command to set the length of |\versewidth| and |
| 797 |
% |\poemtitlewidth|. For example: \begin{quotation} |
| 798 |
% \noindent |\settowidth{\poemtitlewidth}{poem title}| \\ |
| 799 |
% |\settowidth{\versewidth}{text of longest line}|. \end{quotation} |
| 800 |
% Normally |
| 801 |
% you should not use the optional argument to |\begin{poem}| with this |
| 802 |
% title scheme. But you may have already marked up all your poems |
| 803 |
% such a way as to leave open the choice of centering them. You can |
| 804 |
% turn off centering of the verse block, without erasing all of the optional arguments, by |
| 805 |
% issuing |\textcenteringturnedonfalse|. You can turn on centering the |
| 806 |
% text block again by issuing |\textcenteringturnedontrue|. |
| 807 |
% |
| 808 |
% \begin{sloppypar} |
| 809 |
% In this scheme, |\shortpoemepigraph|, |\shortdedication|, and |\shortattribution| will |
| 810 |
% not center their arguments on the line, but set them flush with the beginning of the title. |
| 811 |
% \end{sloppypar} |
| 812 |
% |
| 813 |
% If you don't set the length of |\poemtitlewidth| this scheme will simply set the |
| 814 |
% left margin of the title over the center of the poem. (This may be an effect you want.) |
| 815 |
% |
| 816 |
% Note: this scheme will only yield proper results if the title is shorter than |
| 817 |
% the longest line is. |
| 818 |
% |
| 819 |
% |
| 820 |
% \DescribeMacro{\titlesatleftmarginofcenteredblockscheme} |
| 821 |
%\begin{sloppypar} |
| 822 |
%Rather than centering the title over |
| 823 |
% a centered block of verse, one might prefer to align the title with |
| 824 |
% the left margin of the centered verse block. The length |\versewidth| |
| 825 |
% is used both to center the verse block and to place the title at the verse block's left margin. |
| 826 |
% You will need to use |\settowidth| to set the length of |\versewidth| before |
| 827 |
% issuing |\poemtitle| or the other title-making commands (such as |\sequencesectiontitle|). |
| 828 |
% Issue |\settowidth{\versewidth}{Text to be used for centering}| just |
| 829 |
% before you issue the |\poemtitle| or |\epigraph| command. |
| 830 |
% In addition, you must center to verse block by using the optional argument |\versewidth| |
| 831 |
% to |\begin{poem}|, for example: |\begin{poem}[\versewidth]| |
| 832 |
% |
| 833 |
% For more about how to use |\settowidth| to center the |
| 834 |
% verse block or to align titles, epigraphs, and so forth with the left margin of the |
| 835 |
% verse block, see section \ref{centeringtextblock}, page \pageref{centeringtextblock}. |
| 836 |
% |
| 837 |
% Consult the table to see when you should issue |\settowidth| and when you should |
| 838 |
% use the optional argument to |\begin{poem}|. |
| 839 |
%\begin{table}[h] |
| 840 |
%\caption{Placement in Title Schemes} |
| 841 |
%\bigskip |
| 842 |
%{\scriptsize |
| 843 |
%\begin{tabular}{l l l} |
| 844 |
%\hline |
| 845 |
%Scheme & Lengths to Set & Argument to |\begin{poem}|\\ |
| 846 |
%\hline |
| 847 |
%|\normalindentationtitlescheme| & None & None\\ |
| 848 |
%|\titlesatversemarginscheme| & None & None\\ |
| 849 |
%|\titlescenteredonleftverseblockscheme| & |\poemtitlewidth| |\versewidth| & None\\ |
| 850 |
%|\titlesatleftmarginofcenteredblockscheme| & |\versewidth| & |\begin{poem}[\versewidth]| \\ |
| 851 |
%|\centertitlesscheme| & |\versewidth| & |\begin{poem}[\versewidth]| \\ |
| 852 |
%\end{tabular} |
| 853 |
%} |
| 854 |
%\end{table} |
| 855 |
% \end{sloppypar} |
| 856 |
% |
| 857 |
%\subsubsection{Customization of titles}\label{titlecustomization} |
| 858 |
% |
| 859 |
%\begin{sloppypar} |
| 860 |
% \DescribeMacro{\leftalignepigraphs} You |
| 861 |
% may also wish to align epigraphs, dedications, attributions, or |
| 862 |
% headnotes with the left margin of the verse block (even if you |
| 863 |
% center the titles). To do this, issue |\leftalignepigraphstrue| to |
| 864 |
% set the boolean |\ifleftalignepigraphs|. |
| 865 |
% |\leftalignepigraphstrue| will also align attributions, |
| 866 |
% dedications, and other pre-texts of poems. (It will not affect the |
| 867 |
% dedications and attributions on volume title pages, which are set |
| 868 |
% using the |\volumededication|, |\volumeepigraph|, and |
| 869 |
% |\volumeattribution| commands.) A new group of commands, |
| 870 |
% |\shortpoemepigraph|, |\shortpoemdedication|, |\shortpoemattribution|, |
| 871 |
% |\JHshortepigraph| and |\JHshortdedication| will appear at the places |
| 872 |
% controlled by the new ``title schemes'' listed above. These commands will not |
| 873 |
% obey |\leftalignepigraphs|. |
| 874 |
% \end{sloppypar} |
| 875 |
% |
| 876 |
% \begin{sloppypar} |
| 877 |
% \DescribeMacro{\poemtitlefont} |
| 878 |
% |\poemtitlefont| globally sets the font size (and |
| 879 |
% leading) for all poem titles in the main text. |
| 880 |
% For instance, you can change the font parameters for the font for |
| 881 |
% setting poem titles from 14 points type on 18 points leading to 12 on 14 by issuing |
| 882 |
% |\renewcommand{\poemtitlefont}{\fontsize{12}{14}\selectfont}| in |
| 883 |
% your preamble. There are similar commands to set the font size and leading for |
| 884 |
% the titles of poetic sequences, |
| 885 |
% sequence sections, titles of volumes, and so on. |
| 886 |
% You can find a complete list of those font parameters at section \ref{internal font size commands}, |
| 887 |
% page \pageref{internal font size commands}. |
| 888 |
% |
| 889 |
% |\poemtitlefont| and its siblings do not change the |
| 890 |
% default typeface. To change the default typeface to, say, Times Roman, or |
| 891 |
% Tex Gyre Pagella, use the commands \LaTeX\ |
| 892 |
% or Xe\LaTeX\ provide for that purpose (e.g.\ |\usepackage{tgpagella}|). Changing the default |
| 893 |
% typeface is probably something you would want |
| 894 |
% to do globally, not at the level of classes of title, anyway. |
| 895 |
%\end{sloppypar} |
| 896 |
% |
| 897 |
% \DescribeMacro{\contentspoemtitlefont} |
| 898 |
% |\contentspoemtitlefont| globally sets the font size (and leading) |
| 899 |
% for poem titles in the table of contents. There are similar commands for each of the |
| 900 |
% other kinds of titles in the table of contents. They can be changed just as the font |
| 901 |
% parameters for titles in the main text are changed, using |\renewcommand|. |
| 902 |
% You can find a complete list of those font parameters at section \ref{internal font size commands}, |
| 903 |
% page \pageref{internal font size commands}. |
| 904 |
% |
| 905 |
% \begin{sloppypar} |
| 906 |
% \DescribeMacro{\afterpoemtitleskip} |
| 907 |
% |\afterpoemtitleskip| |
| 908 |
% sets the vertical separation between a poem and its title. To change |
| 909 |
% its value, for instance, to |\medskip| (the default is |\smallskip|), |
| 910 |
% issue |\renewcommand{\afterpoemtitleskip}{\medskip}| in your preamble. |
| 911 |
% |\afterpoemskip| sets the vertical separation between the end of a |
| 912 |
% poem and the title of the next poem. ``Skips'' for other kinds of title can be |
| 913 |
% changed the same way. You can find a complete list of these skips at |
| 914 |
% section \ref{skiplist}, page \pageref{skiplist}.\end{sloppypar} |
| 915 |
% |
| 916 |
% \DescribeMacro{\poemtitlepenalty} |
| 917 |
% |\poemtitlepenalty| encourages |
| 918 |
% but does not require a page break just before a poem title. To change |
| 919 |
% the penalty, for instance, from -1000 to -3000, |
| 920 |
% issue |\renewcommand{\poemtitlepenalty}{\penalty-3000}| |
| 921 |
% in your preamble. Penalties for other kinds of title can be changed the same way. |
| 922 |
% A |
| 923 |
% complete list of all of the special commands for setting font sizes, |
| 924 |
% skips, and penalties, is in section \ref{changingfontsandleading}, page |
| 925 |
% \pageref{changingfontsandleading}, below. |
| 926 |
% |
| 927 |
% \DescribeMacro{\putpagenumberinnotesfalse} |
| 928 |
% If you don't want the entry in the notes section for this poem to include |
| 929 |
% the page number of the poem, issue |\putpagenumberinnotesfalse|. |
| 930 |
% |
| 931 |
% \DescribeMacro{\titleindent} |\titleindent| is an internal command for indented parts of titles. |
| 932 |
% You should change it with caution. In the |
| 933 |
% commands for setting the sections and subsections of poetic sequences, |
| 934 |
% \textsf{poemscol} uses |\titleindent| internally to set up a |
| 935 |
% hierarchy of indentations. (A section of a sequence is indented one |
| 936 |
% |\titleindent|. A subsection is indented two. And so on.) |
| 937 |
% |\titleindent| is also used internally in the commands for multiple |
| 938 |
% line titles. Instructions about changing the value of |\titleindent| |
| 939 |
% can be found in section \ref{changingfontsandleading}. Each kind of title, |
| 940 |
% for poems, sections of poems, sequences, and so forth, has its own default |
| 941 |
% indentation both in the text and in the table of contents. You can see a list of these |
| 942 |
% default values, and instructions about how to change them, at \ref{customtitleindentations}, |
| 943 |
% page \pageref{customtitleindentations}. |
| 944 |
% |
| 945 |
% \subsubsection{Subtitles and special titles} |
| 946 |
% \DescribeMacro{\poemsubtitle} Subtitles of poems should be issued as |
| 947 |
% the arguments to the |\poemsubtitle| command. |
| 948 |
% |
| 949 |
% Multiple line titles (if it matters how they are broken up on page), |
| 950 |
% titles of subsections of poems, titles of |
| 951 |
% sequences of poems, titles of the elements of a sequence of |
| 952 |
% poems, and ``empty'' titles (for untitled poems) |
| 953 |
% are all special cases, with special commands, which will be |
| 954 |
% dealt with below at sections \ref{multilinetitles} and \ref{poeticsequences}. |
| 955 |
%You can also create new varieties of title. For instructions |
| 956 |
% on how to do this, see section \ref{customizing titles} below, page \pageref{customizing titles}. |
| 957 |
% |
| 958 |
% \subsection{~The body of the poem} |
| 959 |
% |
| 960 |
% \subsubsection{The poem environment} |
| 961 |
% \DescribeEnv{poem} The body of every poem should be placed in a |
| 962 |
% |poem| environment. Putting the body of the poem between |
| 963 |
% |\begin{poem}| and |\end{poem}| resets the line counter to 1, |
| 964 |
% puts the poem in a modified |verse| environment (to handle run over lines |
| 965 |
% automatically), and turns off automatic hyphenation with the |poem| environment. |
| 966 |
% |
| 967 |
% \DescribeEnv{pmclverse} \textsf{poemscol} slightly modifies the |verse| |
| 968 |
% environment from the standard \LaTeX\ definition, increasing the |
| 969 |
% indentation used for run over lines, in order to make the difference |
| 970 |
% between the indented run over portion of a long line, on one hand, |
| 971 |
% and an explicitly indented second line, on the other, more obvious in the output. |
| 972 |
% \textsf{poemscol} also adds a little bit |
| 973 |
% more white space between stanzas than the standard \LaTeX\ |verse| |
| 974 |
% environment does. (I found that the standard stanza breaks did not |
| 975 |
% leap out on the page as stanza breaks.) |
| 976 |
% The verse environment for \textsf{poemscol} is |pmclverse|, defined |
| 977 |
% below on page \pageref{versedefine}. You don't have to place poems explicitly in |
| 978 |
% the |pmclverse| environment. The |poem| environment automatically opens (and closes) |
| 979 |
% |pmclverse|. |
| 980 |
% |
| 981 |
% \subsubsection{Customizing the poem environment} |
| 982 |
% \DescribeMacro{\versewidth} |
| 983 |
% The |poem| environment uses an optional argument to center the verse block on a |
| 984 |
% line of a given width. If your poem has |
| 985 |
% short lines, and you wish to center it on the page, rather than set |
| 986 |
% it against the left margin of the normal |poem| environment, you can |
| 987 |
% give the width of the line you want to use to center the poem as the optional |
| 988 |
% argument. To center a verse block 30 ems wide, for instance, issue |
| 989 |
% |\begin{poem}[30em]|. |
| 990 |
% |
| 991 |
% \label{centeringtextblock} |
| 992 |
% Rather than specifying the length explicitly, you can use the length |
| 993 |
% |\versewidth| as the optional |
| 994 |
% argument to |\begin{poem}|. You can set the length of |\versewidth| to the proper |
| 995 |
% amount using |\settowidth| as follows: |
| 996 |
% \begin{center} |\settowidth{\versewidth}{Text of line to use for centering}|. \end{center} |
| 997 |
% Once you have set |\versewidth| |
| 998 |
% to center the poem on a sample line, you use it to center the |poem| environment this way: |
| 999 |
% \begin{center} |\begin{poem}[\versewidth]|.\end{center} |
| 1000 |
% Notice that the optional argument is in square braces, |
| 1001 |
% not in curly braces. |
| 1002 |
% |
| 1003 |
% If you are planning to align the poem title with the |
| 1004 |
% left margin of the centered verse block you should use the |\versewidth| method |
| 1005 |
% to center the verse block, since |\versewidth| is used to place the title in that case. |
| 1006 |
% (You can just enter a length into the optional argument of |\begin{poem}|, but in that case, |
| 1007 |
% if you are left-aligning the poem title, you should set |\versewidth| to that value |
| 1008 |
% by issuing e.g. |\setlength{\versewidth}{30em}|.) |
| 1009 |
% |
| 1010 |
% \DescribeMacro{\linenumberscenteredwithverse} |
| 1011 |
% If you want to center the verse on the page using the optional argument to |\begin{poem}|, |
| 1012 |
% you probably also want |
| 1013 |
% to move the line numbers in, so as to be closer to the line. |
| 1014 |
% \textsf{poemscol} will do this by default. If you wish to leave the line |
| 1015 |
% numbers at the margin, set the boolean |\linenumberscenteredwithverse| to |
| 1016 |
% false. For centered verse, the distance between the line numbers and the |
| 1017 |
% verse can be set by setting the length of |\marginparsepmin| (not |
| 1018 |
% |\marginparsep|). The default |
| 1019 |
% value of |\marginparsepmin| is 2 em. |
| 1020 |
% |
| 1021 |
% \begin{sloppypar} |
| 1022 |
% \DescribeMacro{\centertitles} |
| 1023 |
% \DescribeMacro{\ifcenterepigraphson} |
| 1024 |
% If you center the poem on a sample |
| 1025 |
% line, you probably also want to center the title of the poem too, |
| 1026 |
% which you can do by issuing |\centertitles|. |
| 1027 |
% (|\centertitles| invokes the title centeringscheme.) If you decide against centering the title, |
| 1028 |
% you can either just remove or comment out the |\centertitles| command, or |
| 1029 |
% switch a boolean by issuing |\centertitlesonfalse|. By default, |\centertitles| |
| 1030 |
% also moves epigraphs, dedications, headnotes, and attributions toward the center. |
| 1031 |
% To prevent this, issue |\centerepigraphsonfalse|. This boolean applies to the |
| 1032 |
% regular |\epigraph|, |\headnote| and |\dedication| commands, not to the |
| 1033 |
%single-line |\shortpoemepigraph|, |\shortpoemdedication| and |\shortpoemattribution| commands, |
| 1034 |
%whose places are defined by the title scheme that is in force when they are issued. |
| 1035 |
%\end{sloppypar} |
| 1036 |
% |
| 1037 |
% \DescribeMacro{\iftextcenteringturnedon} Suppose you have marked up many poems with |
| 1038 |
% the optional second argument to |\begin{poem}|, which would cause the text |
| 1039 |
% block to be centered on the longest line, but change your mind about |
| 1040 |
% centering all the poems. You can turn off centering, without |
| 1041 |
% erasing all of the second arguments, by issuing |\textcenteringturnedonfalse|. |
| 1042 |
% You can turn on centering the text block again by issuing |
| 1043 |
% |\textcenteringturnedontrue|. |
| 1044 |
% |
| 1045 |
% \DescribeMacro{\versemarginadjust} |
| 1046 |
% If you don't want to center the verse block on the longest line, but do want |
| 1047 |
% to adjust its horizontal placement, you can adjust the |
| 1048 |
% placement of the verse block by changing the value of the |
| 1049 |
% length |\versemarginadjust|. For most commonly used type sizes, setting |
| 1050 |
% |\versemarginadjust| to 28pts will put the verse block at the left margin, aligned |
| 1051 |
% with the page number. |
| 1052 |
% |
| 1053 |
% \subsubsection{Hyphenation is off in the poem environment} |
| 1054 |
% \textsf{poemscol} turns off automatic hyphenation in poetry |
| 1055 |
% environments. The idea here is that every hyphen in the printed |
| 1056 |
% poem is authorial, obviating the need for you to compile a |
| 1057 |
% hyphenated-lines list to distinguish between authorial hyphens and |
| 1058 |
% hyphens you added for lineation purposes. Line-ending hyphens |
| 1059 |
% should not be a feature of verse anyway, I think. |
| 1060 |
% |
| 1061 |
% You may wish to restore automatic hyphenation in poetry environments |
| 1062 |
% for your own edition. |
| 1063 |
% If you do so you must keep track of added hyphens yourself. This |
| 1064 |
% list will be easy to compile, however, because only authorial |
| 1065 |
% hyphens will appear in your source code. Automatically added |
| 1066 |
% hyphens will appear only in the output. (You might even modify the |
| 1067 |
% output routine so that automatically added hyphens have a different |
| 1068 |
% look. That would be non-trivial, but Donald Knuth has an exercise |
| 1069 |
% about doing just that in \emph{The \TeX book}.) To |
| 1070 |
% restore automatic hyphenation, copy the definition of the |poem| |
| 1071 |
% environment (below at page \pageref{poemdef}) and redefine the |
| 1072 |
% environment using |\renewenvironment|, commenting out the line that reads |
| 1073 |
% |\language=255|. Place the renewed definition of the environment in your preamble, |
| 1074 |
% with |\makeatletter| before the renewed definition and |\makeatother| after it. |
| 1075 |
% If you are restoring automatic hyphenation for a parallel-text |
| 1076 |
% edition, be aware that |\startparalleltexts| also (defined below at |
| 1077 |
% page \pageref{startparalleltexts}) redefines the |poem| |
| 1078 |
% environment, so you will have to change |\startparalleltexts| using |
| 1079 |
% |\renewcommand| as well. |
| 1080 |
% |
| 1081 |
% \textsf{poemscol} |
| 1082 |
% turns automatic hyphenation back on in prose contexts, so if you |
| 1083 |
% wish to keep a hyphenation list for such things as authorial |
| 1084 |
% prefaces and so on, you must do so yourself manually. |
| 1085 |
% (Alternatively, you can turn automatic hyphenation off in those |
| 1086 |
% contexts as well, by setting the |\language| to 255. For an example |
| 1087 |
% of how to do this, look at the definition of the |poem| environment |
| 1088 |
% in the implementation section below. If you do turn automatic |
| 1089 |
% hyphenation off, it would be wise to restrict the change to some |
| 1090 |
% particular environment, rather than changing the |\language| |
| 1091 |
% globally. You might wish, for instance, to turn automatic |
| 1092 |
% hyphenation off in the |prosesection| environment.) |
| 1093 |
% |
| 1094 |
% \subsubsection{The stanza environment} |
| 1095 |
% \DescribeEnv{stanza} Every stanza should be placed in its own stanza |
| 1096 |
% environment. Every poem should have at least one stanza. Marking |
| 1097 |
% the beginning and end of every stanza (with |\begin{stanza}| and |
| 1098 |
% |\end{stanza}|) provides \textsf{poemscol} with a way of detecting |
| 1099 |
% cases in which a page boundary falls on a stanza break, since in |
| 1100 |
% those cases a page turn happens when one is \emph{inside} a poem |
| 1101 |
% environment but \emph{not} inside a stanza environment. Further, |
| 1102 |
% marking the beginning and end of every stanza makes the logical |
| 1103 |
% structure of the poem (and the editor's intentions about it) clear |
| 1104 |
% to readers of your source code. If you want to change the |stanza| environment |
| 1105 |
% consult its definition below at page \pageref{stanzadefine}. |
| 1106 |
% |
| 1107 |
% \DescribeMacro{indentedverse} To indent stanzas (or stretches of verse) relative to the margin |
| 1108 |
% you can use the |indentedverse| environment. |
| 1109 |
% You can also |
| 1110 |
% set different stanzas or passages at a hierarchy of levels of indentation. |
| 1111 |
% (For how to do this, see section \ref{indentedverse} below, page \pageref{indentedverse}.) |
| 1112 |
% |
| 1113 |
% \DescribeMacro{\stanzaatbottom} |
| 1114 |
% \DescribeMacro{\nostanzaatbottom} |
| 1115 |
% If you wish to change the symbol used to mark cases in which a |
| 1116 |
% break falls on a page turn, issue the command |\stanzaatbottom|, |
| 1117 |
% using as the argument whatever you wish to use to mark such cases. |
| 1118 |
% The default is |\stanzaatbottom{*}|, which is suitable for a published volume. If you |
| 1119 |
% are preparing a typescript for submission, you may wish to set |
| 1120 |
% |\stanzaatbottom| to ``stanza break.'' |
| 1121 |
% |
| 1122 |
% If you wish also to mark all cases where there is \emph{not} a stanza break |
| 1123 |
% at the bottom of the page, issue the command |\nostanzaatbottom|, |
| 1124 |
% using as the argument whatever you wish to mark such cases. The |
| 1125 |
% default is |\relax| (which is to say, ``don't do anything''). |
| 1126 |
% |
| 1127 |
% \subsubsection{Verse lines and line numbering} |
| 1128 |
% \DescribeMacro{\verseline} |\verseline| should mark the end of every |
| 1129 |
% line, except the last line of every stanza (which should be marked |
| 1130 |
% with |\end{stanza}|). |\verseline| marks the end of every line as a |
| 1131 |
% prosodic unit (since a line of verse is not simply a carriage |
| 1132 |
% return), and advances the line counter. There are commands below |
| 1133 |
% for changing the line counter's horizontal placement (how close it |
| 1134 |
% is to the left or right margin of the line) and appearance. (See |
| 1135 |
% section \ref{marginalgeometry} for these.) |
| 1136 |
% |
| 1137 |
% |
| 1138 |
% \DescribeMacro{\setverselinemodulo} |\setverselinemodulo| sets how |
| 1139 |
% often a marginal line number appears. To print a line number every |
| 1140 |
% five lines, issue |\setverselinemodulo{5}|. The default value is |
| 1141 |
% 10. |
| 1142 |
% |
| 1143 |
% |
| 1144 |
% \DescribeMacro{\makeverselinenumbers} |
| 1145 |
% Marginal verse line numbering is on by default. To turn line |
| 1146 |
% numbering off, issue |\global\verselinenumbersfalse|. To turn it |
| 1147 |
% back on, issue |\makeverselinenumbers|. |
| 1148 |
% |
| 1149 |
% \begin{sloppypar} |
| 1150 |
% \DescribeMacro{\verselinenumberstoright} |
| 1151 |
% \DescribeMacro{\verselinenumberstoleft} |
| 1152 |
% To put all of the line numbers to the left, issue |\verselinenumberstoleft| in |
| 1153 |
% your preamble. |\verselinenumberstoright| puts the line numbers in the right |
| 1154 |
% margin. (These two commands use non-floating marginal note commands derived |
| 1155 |
% from the \textsf{memoir} class, |\pmclleftsidepar| and |\pmclrightsidepar|, |
| 1156 |
% respectively.) |
| 1157 |
% \end{sloppypar} |
| 1158 |
% |
| 1159 |
% \DescribeMacro{\verselinenumbersouter} |
| 1160 |
% \DescribeMacro{\verselinenumbersgutter} |
| 1161 |
% If you wish the line numbers to appear in the outer margins of each two-page spread, issue |
| 1162 |
% |\verselinenumbersouter| in your preamble. If you want the line numbers to |
| 1163 |
% appear in the inner margins, issue |\verselinenumbersgutter| in your preamble. |
| 1164 |
% (These two commands use |\pmclsidepar|, derived from |\sidepar| from the |
| 1165 |
% \textsf{memoir} class, but modified by Dan Leucking.) |
| 1166 |
% |
| 1167 |
% \begin{sloppypar} |
| 1168 |
% \DescribeMacro{\marginparsep} |
| 1169 |
% You can adjust the |
| 1170 |
% distance between the marginal line number and the text with |
| 1171 |
% |\setlength{\marginparsep}{your length}|. The default value for |\marginparsep| is 18pt, |
| 1172 |
% and the default value for the width of the box in which the line numbers are |
| 1173 |
% set, |\marginparwidth|, is 18 pt. If you are setting with the line numbers to |
| 1174 |
% the right, |\marginparwidth| can be as small as you wish, although your log |
| 1175 |
% file will be full of complaints if you make it too small. But if you are |
| 1176 |
% setting with the line numbers to the left, if |\marginparwidth| is narrower |
| 1177 |
% than the width of the line number, the line number will be moved down a line. |
| 1178 |
% Setting |\marginparsep| to zero lines the verse line numbers up with the page |
| 1179 |
% numbers, and puts both at the margin. If you move the verse line numbers by |
| 1180 |
% changing |\marginparsep|, you can move the page numbers to keep them aligned |
| 1181 |
% by changing |\headoffsetlength| to the same value. |
| 1182 |
% \end{sloppypar} |
| 1183 |
% |
| 1184 |
% \DescribeMacro{\marginparsepmin} |
| 1185 |
% If the verse block is centered on the longest line, the distance between the line numbers and the |
| 1186 |
% verse can be set by setting the length of |\marginparsepmin| (not |
| 1187 |
% |\marginparsep|). The default |
| 1188 |
% value of |\marginparsepmin| is 2em. |
| 1189 |
% |
| 1190 |
% \DescribeMacro{\pmclsideparvshift} |
| 1191 |
% The line numbers should print on the baseline. You can adjust them |
| 1192 |
% to move them up or down by changing the value of a length called |
| 1193 |
% |\pmclsideparvshift|. The default value is |
| 1194 |
% |\setlength{\pmclsideparvshift}{0ex}|. |
| 1195 |
% |
| 1196 |
% \subsection{~Special line markup} |
| 1197 |
% \subsubsection{Indentation, line breaks, runover, and broken lines} |
| 1198 |
% \begin{sloppypar} |
| 1199 |
% \DescribeMacro{\verseindent} The |\verseindent| command is to be |
| 1200 |
% used for formally indented lines. It should not be used to indent |
| 1201 |
% the run over portion of long lines (which \textsf{poemscol} handles |
| 1202 |
% automatically anyway). |\verseindent| indents the line a bit less |
| 1203 |
% than the run over portion of long ``bent'' lines are indented, so |
| 1204 |
% that the two cases can be visually distinguished. By default, the |
| 1205 |
% length of |\verseindent| is 2 em. To change it, say to 3 em, you should change |
| 1206 |
% the length |\verseindentamount| by |
| 1207 |
% issuing |\setlength{\verseindentamount}{3em}|.\end{sloppypar}\goodbreak |
| 1208 |
% |
| 1209 |
% You can create a hierarchy of indentations by issuing |\verseindent| |
| 1210 |
% multiple times. But you can also use an optional argument to |\verseindent|, with |
| 1211 |
% the number indicating how many levels of indentation to add to this line, like so |
| 1212 |
% |\verseindent[3]| for the third level of indentation, (with each level being one |\verseindent| |
| 1213 |
% deep). If you use this option, don't put any white space between the end of the |
| 1214 |
% |\verseindent| command and the beginning of the poetic text, otherwise |
| 1215 |
% poemscol will add about 10pt of unwanted extra white space. (The only real |
| 1216 |
% consequence of forgetting about this will be that |\verseindent[1]| will be about |
| 1217 |
% 10pts deeper than plain |\verseindent|, which may not really be an issue for you.) |
| 1218 |
% |
| 1219 |
% \begin{sloppypar} |
| 1220 |
% \DescribeMacro{indentedverse} \label{indentedverse} You might want to indent whole stanzas, |
| 1221 |
% or perhaps extended passages of verse, relative to the rest of the poem (you might, |
| 1222 |
% for instance, want to indent refrains systematically). This would be tedious to |
| 1223 |
% do using |\verseindent|. Put stretches of |
| 1224 |
% verse you wish to indent in the |indentedverse| environment. Whatever is |
| 1225 |
% in this environment will be indented. The indentation will be of the length |
| 1226 |
% |\indentedstanzaamount|, which is by default set to |\verseindentamount|, |
| 1227 |
% which by default is 2 em. You can change |\indentedstanzaamount| to 3em, by issuing |
| 1228 |
% |\setlength{\indentedstanzaamount}{3em}|. |
| 1229 |
% |
| 1230 |
% You can also set a hierarchy of intended stanzas |
| 1231 |
% or passages by issuing an optional argument to |\begin{indentedverse}|. So, for instance, |
| 1232 |
% |\begin{indentedverse}[2]| will indent that environment by two |\indentedstanzaamount|s |
| 1233 |
% (4 em), and |\begin{indentedverse}[3]| will indent that environment by three |
| 1234 |
% |\indentedstanzaamount|s, or 6 em. Note that if you use the optional argument, you |
| 1235 |
% must enclose it in square brackets, not curly ones. Note also that (for reasons |
| 1236 |
% I have not been able to track down) |\indentedverse[1]| indents the stanza |
| 1237 |
% slightly more deeply than plain |\indentedverse|. To preserve a |
| 1238 |
% consistent look for a hierarchy of indented stanzas, use |\indentedverse[1]| for the |
| 1239 |
% lowest level of indentation, not plain |\indentedverse|. \end{sloppypar} |
| 1240 |
% |
| 1241 |
% \DescribeMacro{\linebend} \textsf{poemscol} automatically runs over |
| 1242 |
% long lines, indenting the run over portion on the next physical |
| 1243 |
% line. If you are unhappy with where \textsf{poemscol} has run over |
| 1244 |
% a particular line, you can ``bend'' that line by issuing |\linebend| |
| 1245 |
% at the point where you wish it to run over. The run over portion of |
| 1246 |
% the line will be indented just as if \textsf{poemscol} had ``bent'' |
| 1247 |
% the line at your selected point. This command only works if you |
| 1248 |
% have chosen to bend the line at some point earlier than |
| 1249 |
% \textsf{poemscol} would have chosen on its own. |
| 1250 |
% |
| 1251 |
% You may also wish to use |\linebend| to reproduce how your author |
| 1252 |
% broke up long lines on the page (if you know that your author cared |
| 1253 |
% about such things and did not leave them up to the typesetter). |
| 1254 |
% |
| 1255 |
% |\linebend| should only be used for managing run over lines, not for |
| 1256 |
% cases in which a line is to be broken into separate half-lines. For |
| 1257 |
% cases in which a line is to be broken into half-lines, use the |
| 1258 |
% |\brokenline| command. The two commands do similar (but not identical) |
| 1259 |
% things. But a ``linebend'' is a feature of typesetting, and a |
| 1260 |
% ``broken line'' is a feature of versification, and it seems best to |
| 1261 |
% distinguish them logically. (|\linebend|, like |\brokenline|, issues |
| 1262 |
% a carriage return without incrementing the line number, but |
| 1263 |
% |\linebend| adds indentation to the next line.) |
| 1264 |
% |
| 1265 |
% If you |
| 1266 |
% want to extend a line further into the right margin, beyond the normal break point, you can |
| 1267 |
% probably do so by using a combination of |\nobreak| and |\hbox|, |
| 1268 |
% or by turning all of the spaces in that line into unbreakable |
| 1269 |
% spaces, marked with |~| in your source. But \textsf{poemscol} will |
| 1270 |
% complain if you do this, and rightly so, since the result is likely |
| 1271 |
% to be ugly. It would probably be wiser to adjust the lengths |\leftmargin| |
| 1272 |
% and |\rightmargin| in the definition of the |pmclverse| environment, |
| 1273 |
% allowing all of the lines to be a little bit longer. The |pmclverse| environment |
| 1274 |
% is defined below, at section \ref{versedefine}, page \pageref{versedefine}. |
| 1275 |
% |
| 1276 |
% \DescribeMacro{\runoverindent} To change the indentation for the run |
| 1277 |
% over portion of verse lines globally, issue the amount of |
| 1278 |
% indentation you desire as the argument to |\runoverindent|. |
| 1279 |
% |\runoverindent| is currently set to 6 em, rather more than the |
| 1280 |
% standard amount in the definition of the \LaTeX\ |verse| |
| 1281 |
% environment. By default, the runover portion of long lines is |
| 1282 |
% indented. You may wish to flush the runover portion to the right |
| 1283 |
% margin instead. For instructions about how to do this, see section |
| 1284 |
% \ref{rightflushverse}, page \pageref{rightflushverse}. |
| 1285 |
% |
| 1286 |
% \DescribeMacro{\brokenline} |
| 1287 |
% \DescribeMacro{\versephantom}|\brokenline| should be used where you |
| 1288 |
% wish to break the line without incrementing the line counter. |
| 1289 |
% Authors often break a line into two half-lines, setting the |
| 1290 |
% beginning of the second half-line flush with the end of the first |
| 1291 |
% half-line. (Sometimes these broken lines indicate a change of |
| 1292 |
% speaker. Sometimes they just indicate a change of subject, usually |
| 1293 |
% an abrupt one, a change which calls attention to itself by |
| 1294 |
% interrupting a line rather than waiting for a line break or stanza |
| 1295 |
% break). |\brokenline| is normally used with |\versephantom|, |
| 1296 |
% which adds white space exactly as long as its argument would have |
| 1297 |
% been had it been set in type. |\versephantom| thus provides an easy |
| 1298 |
% way of setting the beginning of the second half-line flush with the |
| 1299 |
% end of the first, whatever the font size or special formatting of the |
| 1300 |
% first line. |
| 1301 |
% |
| 1302 |
% |
| 1303 |
% The sestet of Yeats's sonnet ``Leda and the Swan,'' has such a broken |
| 1304 |
% line: |
| 1305 |
% \begin{verse} |
| 1306 |
% A shudder in the loins engenders there\\ |
| 1307 |
% The broken wall, the burning roof and tower\\ |
| 1308 |
% And Agamemnon dead.\\ |
| 1309 |
% $\phantom{And Agamemnon dead.~}$ Being so caught up,\\ |
| 1310 |
% So mastered by the brute blood of the air,\\ |
| 1311 |
% Did she put on his knowledge with his power\\ |
| 1312 |
% Before the indifferent beak could let her drop?\end{verse} |
| 1313 |
% |
| 1314 |
% To set the broken line properly, issue: |
| 1315 |
% \begin{verse} |
| 1316 |
% And Agamemnon dead.|\brokenline|\\ |
| 1317 |
% |\versephantom{And Agamemnon dead.}| Being so caught up,|\verseline| |
| 1318 |
% \end{verse} |
| 1319 |
% |
| 1320 |
% \DescribeMacro{\stanzalinestraddle} |
| 1321 |
% Some poets (such as Robert Penn Warren) occasionally introduce a |
| 1322 |
% stanza break in the middle of a broken line, considering the line to |
| 1323 |
% be a single metrical unit despite the fact that it straddles a stanza |
| 1324 |
% break. To record these cases, mark the end of the first half-line |
| 1325 |
% with |\end{stanza}| as usual. But instead of opening the next stanza |
| 1326 |
% with |\begin{stanza}| issue |\stanzalinestraddle| instead. This will |
| 1327 |
% make sure that the line counter counts the straddling line as only one |
| 1328 |
% line, despite the stanza break. |\stanzalinestraddle| is usually used |
| 1329 |
% with |\versephantom|. |
| 1330 |
% |
| 1331 |
% \subsubsection{Customizing broken lines} |
| 1332 |
% \DescribeMacro{\tweakbrokenline} |
| 1333 |
% By default, \textsf{poemscol} sets the line numbers level with the |
| 1334 |
% ends of broken lines. If the line numbers are set to the right of |
| 1335 |
% the text, this seems the obvious choice. Conceivably you might want |
| 1336 |
% to set the line number level with the beginning of a broken line |
| 1337 |
% when the line numbers are set to the left. To ensure that the line |
| 1338 |
% numbers of broken lines are set level with the beginning of a |
| 1339 |
% broken line when the line number is on the left, issue |
| 1340 |
% |\tweakbrokenline| in your preamble. |
| 1341 |
% |
| 1342 |
% You should issue |\tweakbrokenline| with caution, because although |
| 1343 |
% it changes how |\brokenline| is handled, it does not change the |
| 1344 |
% handling of long lines with runover. Runover lines will still set |
| 1345 |
% the line number level with the end of the line. You can have |
| 1346 |
% runover lines set their line number level with the beginning of the |
| 1347 |
% line by issuing |\startverseline| at the beginning of the line. |
| 1348 |
% |
| 1349 |
% \DescribeMacro{\brokenlineatbeginning} Conceivably you might want |
| 1350 |
% |\brokenline| to set the line number level with the beginning of |
| 1351 |
% the line in every case. To do this, issue |\brokenlineatbeginning| |
| 1352 |
% in your preamble. If you do this, you should be prepared to mark |
| 1353 |
% the beginning of runover lines with |\startverseline|. |
| 1354 |
% |
| 1355 |
% \DescribeMacro{\startverseline} |
| 1356 |
% If you begin a verse line with |\startverseline| the line number |
| 1357 |
% will be set level with the beginning of the line rather than with |
| 1358 |
% the end. This is useful, for instance, if you want to ensure that |
| 1359 |
% the line number of a line with runover is set level with the |
| 1360 |
% beginning of the line. You can, if you don't want to keep track of |
| 1361 |
% where runover lines are, start every line with |\startverseline|. |
| 1362 |
% |
| 1363 |
% \DescribeMacro{\tweakstartverseline} |
| 1364 |
% Rather than setting the line number of every runover line level with |
| 1365 |
% the beginning of the line, it may make more sense for you to set the |
| 1366 |
% line number level with the beginning in cases where the line number |
| 1367 |
% is to the left, and level with the end in cases where the line |
| 1368 |
% number is to the right. You might want to do this, for instance, if |
| 1369 |
% you have decided to set all the verse lines at the outer margin (by |
| 1370 |
% issuing |\verselinenumbersouter| in your preamble), or have decided to |
| 1371 |
% set all the verse lines at the inner margin (by issuing |
| 1372 |
% |\verselinenumbersgutter| in your preamble). To ensure that |
| 1373 |
% |\startverseline| does this, issue |\tweakstartverseline| in your |
| 1374 |
% preamble. |
| 1375 |
% |
| 1376 |
% \subsubsection{Right-flushed runover lines} |
| 1377 |
% \DescribeEnv{rightflushverse} |
| 1378 |
% \DescribeMacro{\rightversebegin}\label{rightflushverse} By default, |
| 1379 |
% \textsf{poemscol} indents the runover portion of long lines by the |
| 1380 |
% amount |\runoverindent| (by default 6 em). It is possible to set |
| 1381 |
% verse so that the runover portion is flushed to the right margin. |
| 1382 |
% To do this, you should put the |\rightflushverse| environment inside |
| 1383 |
% the |\poem| environment. And you must mark the beginning of each |
| 1384 |
% verse line with |\rightversebegin|. Christian Ebert has reminded me |
| 1385 |
% that the |\rightflushverse| environment must be issued \emph{inside} |
| 1386 |
% the poem environment. Otherwise it simply flushes every line to the |
| 1387 |
% right. |
| 1388 |
% |
| 1389 |
% It is rather clumsy to need a special environment for verse with |
| 1390 |
% right flushed runover. I plan to provide a command for switching |
| 1391 |
% between a verse environment that indents runover lines and a verse |
| 1392 |
% environment that flushes runover lines to the right. I have seen |
| 1393 |
% examples of this kind of environment from Markus Kohm and Christian |
| 1394 |
% Ebert, but so far I haven't been able to persuade them to play well with \textsf{poemscol} |
| 1395 |
% |
| 1396 |
% \subsection{Cross references by line number} |
| 1397 |
% \DescribeMacro{\poemlinelabel} \label{poemlinelabel} |
| 1398 |
% |\poemlinelabel| enables crossreferences by line number. To make |
| 1399 |
% a line label, issue |\poemlinelabel{text of label}| right after the |
| 1400 |
% line to which you wish to refer, where ``text of label'' is some |
| 1401 |
% distinctive label you can use for a reference elsewhere. (You |
| 1402 |
% should issue the command \emph{after} the |\verseline| or |
| 1403 |
% |\end{stanza}| command, to make sure that the line number will be |
| 1404 |
% correct.) To produce the reference, just issue |\ref{text of label}| as usual. |
| 1405 |
% (|\poemlinelabel| is just a crudely hacked |
| 1406 |
% version of |\label| from \LaTeX.) |\pageref{text of label}| will set |
| 1407 |
% the page number of the page on which the label appears. |
| 1408 |
% |
| 1409 |
% \section{Making a table of contents} |
| 1410 |
% \subsection{~Setup} |
| 1411 |
% \DescribeMacro{\makepoemcontents} |
| 1412 |
% I found the normal \LaTeX\ commands for making tables of contents for scholarly works |
| 1413 |
% unsuited for making tables of contents of poetry, so I have provided my own. To make a table of |
| 1414 |
% contents for your poems, issue |\makepoemcontents|. |
| 1415 |
% |
| 1416 |
% |\makepoemcontents| takes an optional argument, which |
| 1417 |
% sets the page number for the table of contents. If your publisher |
| 1418 |
% wishes to add some front matter so that the contents will appear on |
| 1419 |
% page vii, you should issue |\makepoemcontents[7]|. |
| 1420 |
% |
| 1421 |
% It might seem |
| 1422 |
% as though you would want to issue this command in your preamble. In |
| 1423 |
% fact it is better to issue it in the body of the document, |
| 1424 |
% immediately \emph{after} issuing the |\putpoemcontents|, the command which |
| 1425 |
% inputs and typesets a table of contents from a prior run. If you issue |\makepoemcontents| |
| 1426 |
% before issuing |\putpoemcontents|, you will simply erase the table of contents |
| 1427 |
% from the prior run (the one which will have all the contents information you |
| 1428 |
% are intending to use) and enter an empty table of contents into your document. |
| 1429 |
% |
| 1430 |
% \subsection{~Printing the table of contents} |
| 1431 |
% \DescribeMacro{\putpoemcontents}\label{putpoemcontents} |
| 1432 |
% Information for your table of contents will be written to an |
| 1433 |
% external file with the extension .ctn. |\makepoemcontents| creates this file, and |
| 1434 |
% opens an output channel to send information to it. |\putpoemcontents| closes |
| 1435 |
% the file and reads it into your document. |
| 1436 |
% |
| 1437 |
% You will need to run your |
| 1438 |
% book through \LaTeX\ twice in order to generate a table of contents, |
| 1439 |
% the first time to generate the titles and the references for the page numbers, and the second |
| 1440 |
% time to use the labels to which the references point |
| 1441 |
% to enter the page numbers. (Under some circumstances --- if |
| 1442 |
% you have an index, for instance --- you may need three passes rather |
| 1443 |
% than two.) |
| 1444 |
% |
| 1445 |
% \DescribeMacro{\resetpagestyle} |
| 1446 |
% Because the |
| 1447 |
% table of contents uses a special page style and special fonts |
| 1448 |
% |\putpoemcontents| issues |\resetpagestyle|, |
| 1449 |
% which restores the default fancy page style to ``main'' once it has |
| 1450 |
% input the contents, and restores the font size to |\normalsize| as well. |
| 1451 |
% |
| 1452 |
% \DescribeMacro{\pagenumbering} |
| 1453 |
% Be sure to |
| 1454 |
% reset the style of page numbering (from |\pagenumbering{roman}| to |
| 1455 |
% |\pagenumbering{arabic}|) after issuing |\putpoemcontents|, since |
| 1456 |
% when you read in the external file created by |\makepoemcontents| |
| 1457 |
% the page numbering will be set to roman numerals. The command |
| 1458 |
% |\resetpagestyle| (which is called by |\putpoemcontents|) will reset |
| 1459 |
% the fancy page style to that used in the main body of the volume, |
| 1460 |
% but it won't change the page numbering to arabic, in case there is |
| 1461 |
% some frontmatter between the contents and the main text, so you |
| 1462 |
% should be sure to do so yourself. (Front matter is normally given page numbers |
| 1463 |
% in roman numerals.) If you neglect to issue |
| 1464 |
% |\pagenumbering{arabic}| at the end of your front matter, the |
| 1465 |
% page numbering will remain in roman numerals. The notes sections |
| 1466 |
% use the page numbers from the poem to construct running headers of |
| 1467 |
% the form ``Notes to pp.~xx--yy.'' If those numbers are roman |
| 1468 |
% numerals rather than arabic ones, \textsf{poemscol} will not |
| 1469 |
% recognize them as numbers, and you will get the infamous ``Missing |
| 1470 |
% Number'' error that puzzles so many users of \LaTeX. |
| 1471 |
% |
| 1472 |
% \subsection{~Contents entries for notes sections and the index} |
| 1473 |
% |
| 1474 |
% \begin{sloppypar}\DescribeMacro{\puttextnotes} |
| 1475 |
% \DescribeMacro{\putemendations} |
| 1476 |
% \DescribeMacro{\putexplanatory} |
| 1477 |
% |\puttextnotes|, and its siblings |\putemendations| and |
| 1478 |
% |\putexplanatory|, input the formatted endnotes |
| 1479 |
% sections into your document, and put entries for them into your table of contents. |
| 1480 |
% You will have to run \LaTeX\ again to set the page numbers of those sections |
| 1481 |
% in the |
| 1482 |
% table of contents properly. The first run sets the title of the endnotes section and a label to find the |
| 1483 |
% page number to add to the table of contents, and the second run |
| 1484 |
% actually sets page number. (These commands are described |
| 1485 |
% below, in section \ref{putexternalfiles}.) All of these commands |
| 1486 |
% also restore normal hyphenation for the endnotes sections. \end{sloppypar} |
| 1487 |
% |
| 1488 |
% \DescribeMacro{\putpoemindex} |
| 1489 |
% |\putpoemindex| inputs the formatted index (after your raw entries have been |
| 1490 |
% processed by MakeIndex), and adds an entry |
| 1491 |
% for it into the table of contents. |
| 1492 |
% Remember that if you are making an index of titles and first lines |
| 1493 |
% you may need to run your file through \LaTeX\ twice more after running |
| 1494 |
% MakeIndex, to put the entry for the index and its correct page number into your table of |
| 1495 |
% contents. |
| 1496 |
% |
| 1497 |
% \DescribeMacro{\putmultiplepoemindex} |
| 1498 |
% Use |\putmultiplepoemindex| instead if |
| 1499 |
% you are making several indices. For instructions about |
| 1500 |
% |\putmultiplepoemindex| see section \ref{multipleindex}, |
| 1501 |
% p.~\pageref{multipleindex}. |
| 1502 |
% |
| 1503 |
% \subsection{~Customizing contents entries} |
| 1504 |
% Lines in the table of contents usually include an indent (how |
| 1505 |
% much of one depends upon what the entry is --- whether it is a |
| 1506 |
% volume title, a poem title, or something else), then the title |
| 1507 |
% itself. If the entry is for a poem, for a section of a poem, for a poetic sequence, or for |
| 1508 |
% a section or subsection of a poetic sequence, a slash follows the title, followed |
| 1509 |
% by the page number. |
| 1510 |
% All of the commands that generate lines in the table of contents are |
| 1511 |
% somewhat messy and somewhat rigid, but you can modify them if you |
| 1512 |
% wish. Here are some ways of customizing contents |
| 1513 |
% entries, in increasing order of difficulty. |
| 1514 |
% |
| 1515 |
%\DescribeMacro{\setcontentsleaders} By default the title and the page |
| 1516 |
% are separated by a slash (actually by |~/~|). If you wish to change |
| 1517 |
% this, say to put dot leaders in instead, issue what you wish to use |
| 1518 |
% as the argument to |\setcontentsleaders|. For instance |
| 1519 |
% |\setcontentsleaders{\poemdotfill}| will flush the number to |
| 1520 |
% the right margin, and insert leading dots up to the number. |
| 1521 |
% The argument to |\setcontentsleaders| can be whatever you wish |
| 1522 |
% to use to separate the title from the page number, such as a colon, |
| 1523 |
% a hard space (|~|), or even |\hfil| to flush the page number to the right margin. |
| 1524 |
% |
| 1525 |
% \DescribeMacro{\contentspoemtitlefont} |
| 1526 |
% You can change the font sizes that are used to set particular classes of title |
| 1527 |
% in the contents by redefining the commands that are used to set the font size |
| 1528 |
% for that kind of title. For instance, if you wanted to set the titles of all |
| 1529 |
% poems in 12 point type on 14.5 point leading, issue \begin{verbatim} |
| 1530 |
% \renewcommand{\contentspoemtitlefont}{\fontsize{12}{14.5}\selectfont} |
| 1531 |
% \end{verbatim} |
| 1532 |
% in your preamble. You can find a list of the various relevant font size commands |
| 1533 |
% below at section \ref{internal font size commands}, page \pageref{internal font size commands}. |
| 1534 |
% |
| 1535 |
% \DescribeMacro{\contentsindentoneamount} |
| 1536 |
% You can also change the amount of the indentations used in the hierarchy of indentations |
| 1537 |
% in the table of contents by changing the value of the elements of |
| 1538 |
% that hierarchy. You can change ``contentsindentoneamount'' |
| 1539 |
% (the amount a poem title is normally indented, by default 24pt) to, |
| 1540 |
% say, 36pt, by issuing |\contentsindentoneamount=36pt| in your preamble. You |
| 1541 |
% can find all of the values in the contents indentation hierarchy at section |
| 1542 |
% \ref{contents indentation hierarchy}, page \pageref{contents indentation hierarchy}. |
| 1543 |
% |
| 1544 |
% \DescribeMacro{\pmclcontentsentry} There is a simple way of adding a new contents |
| 1545 |
% entry using the command |\pmclcontentsentry|. The command creates an entry on the model |
| 1546 |
% of the entry for the textual notes section. It takes three arguments. The first is the title of |
| 1547 |
% the section. The second is the indentation of the entry (typically |\contentsindentone| |
| 1548 |
% |\contentsindenttwo|, or |\contentsindentthree|, but any indentation command will do). |
| 1549 |
% The third is the page number. |
| 1550 |
% Remember that |\contentsindentone| is a command, not a length. The length of |
| 1551 |
% the indentation is |\contentsindentoneamount|. |
| 1552 |
% The command is defined as |\hspace{contentsindentoneamount}|. |
| 1553 |
% You can suppress the page number by setting the boolean |\putpagenumbersincontentsfalse|. |
| 1554 |
% |
| 1555 |
% A more general way to add a entry in the table |
| 1556 |
% of contents is to use the command |\pmclecontentsentrydefaults|. This command takes |
| 1557 |
% four arguments: (1) The title (2) the indentation command (3) the font size (e.g. |\contentendnotesfont| for the |
| 1558 |
% same font size used in contents entries for the endnotes sections) and (4) the page number. Here |
| 1559 |
% also you can suppress the page number by setting the boolean |\putpagenumbersincontentsfalse|. |
| 1560 |
% |
| 1561 |
% \DescribeMacro{\setlength} To change the amount various kinds of title are indented in the Table |
| 1562 |
% of Contents, see below at section \ref{contentsindentations}, page \pageref{contentsindentations}. |
| 1563 |
% |
| 1564 |
% \DescribeMacro{\renewcommand} |
| 1565 |
% You can also make global changes to the appearance of a particular kind of contents entry. To |
| 1566 |
% change the appearance of a kind of entry (for all sections of |
| 1567 |
% sequences of poems, for instance), go to the definition of the title |
| 1568 |
% of that kind of entry (e.g.\ |\sequencesectiontitle|) below, |
| 1569 |
% and copy the definition into a |\renewcommand| for that kind of title; |
| 1570 |
% find where that command calls the |
| 1571 |
% |\c@ntentsinfo| command, and change the arguments |
| 1572 |
% to that command to suit you. (You should consult section \ref{customizing titles}, page |
| 1573 |
% \pageref{customizing titles}, to see what all of the arguments to |\c@ontentsinfo| do.) |
| 1574 |
% Put the whole renewed version of the title command into your preamble, being |
| 1575 |
% sure to issue |\makeatletter| before the |\renewcommand| and to issue |
| 1576 |
% |\makeatother| after it. |
| 1577 |
% (You have to put this whole |\renewcommand| between |\makeatletter| and |\makeatother| because |
| 1578 |
% |\c@ntentsinfo| and several other commands called to set titles include |
| 1579 |
%the |@| character, which you can't use in command names |
| 1580 |
% except in the .sty file. Internal commands like |\c@ntentsinfo|, which are used by |
| 1581 |
% other commands but are under most circumstances not meant to be invoked |
| 1582 |
% by users directly, have an |@| in their names so that the user won't accidentally |
| 1583 |
% redefine them.) |
| 1584 |
% You can find the commands for making titles below at |
| 1585 |
% section \ref{poemtitlecode}, page \pageref{poemtitlecode}. |
| 1586 |
% |
| 1587 |
% Here, for instance, is the code that defines titles for sections of poetic sequences: |
| 1588 |
% \begin{verbatim} |
| 1589 |
% \newcommand{\sequencesectiontitle}[1]{% |
| 1590 |
% \set@p@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont} |
| 1591 |
% {\titleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak} |
| 1592 |
% {\titleindentamount} |
| 1593 |
% \c@ntentsinfo{#1}{\contentsindenttwo}{\contentspoemtitlefont} |
| 1594 |
% {\contentsindentthreeamount} |
| 1595 |
% \t@xtnotesinfo{#1}} |
| 1596 |
% \end{verbatim} |
| 1597 |
% Notice in the above that entries for sequence sections in the table |
| 1598 |
% of contents are given the indentation |
| 1599 |
% |\contentsindenttwo|. To give them the indentation |\contentsindentthree| |
| 1600 |
% and to set the runover portion of long titles with the indentation |\contentsindentfour| put this in |
| 1601 |
% your preamble: |
| 1602 |
% \begin{verbatim} |
| 1603 |
% \makeatletter |
| 1604 |
% \renewcommand{\sequencesectiontitle}[1]{% |
| 1605 |
% \set@p@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont} |
| 1606 |
% {\titleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak} |
| 1607 |
% {\titleindentamount} |
| 1608 |
% \c@ntentsinfo{#1}{\poemsectiontitleindent}{\contentspoemtitlefont} |
| 1609 |
% {\contentsindentfouramount} |
| 1610 |
% \t@xtnotesinfo{#1}} |
| 1611 |
% \makeatother |
| 1612 |
% \end{verbatim} |
| 1613 |
% |
| 1614 |
% \DescribeMacro{\c@ntentsinfo} |
| 1615 |
% You can make even more sweeping and fundmental changes in the look of your |
| 1616 |
% table of contents by redefining the |\c@ntentsinfo| command itself, which can be found |
| 1617 |
% below at section \ref{poemtitlecode}. Think very hard about this before doing it. |
| 1618 |
% |
| 1619 |
% \section{Making an index of titles and first lines} |
| 1620 |
% \subsection{~Setup} |
| 1621 |
% \DescribeMacro{\indexingontrue} First you must add the \textsf{makeidx} package |
| 1622 |
% to the list of packages you call in your preamble. (If you are planning to set several |
| 1623 |
% indices, call \textsf{splitindex} instead.) Then, to set up the Index section of your |
| 1624 |
% volume, issue |\indexingontrue| in your preamble. This will create |
| 1625 |
% the external file for your index information and send that file the |
| 1626 |
% typesetting information for its title. You must process this |
| 1627 |
% external file (the .idx file) with MakeIndex to create a properly organized and |
| 1628 |
% formatted index. MakeIndex sorts the various multi-level ``index |
| 1629 |
% cards'' generated by all of the |\index| commands in your source |
| 1630 |
% files. |
| 1631 |
% |
| 1632 |
% \subsection{~Printing the index} |
| 1633 |
% \DescribeMacro{\putpoemindex} |
| 1634 |
%Once you have processed your .idx file with MakeIndex, and |
| 1635 |
% generated the sorted and formatted .ind file for your book, the |
| 1636 |
% |\putpoemindex| command will insert the typeset index where you |
| 1637 |
% issue it, and put an entry for your index in your table of contents. |
| 1638 |
% You will have to run your file through \LaTeX\ twice again to make the |
| 1639 |
% page number for that entry correct. |
| 1640 |
% |
| 1641 |
% \textsf{poemscol} sets up a two-column index with a simple running |
| 1642 |
% header. (Setting up a two-column index, however, requires that you |
| 1643 |
% include the \textsf{multicol} package in your |\usepackage| list.) |
| 1644 |
% To turn indexing off, issue |\global\indexingonfalse|. |
| 1645 |
% |
| 1646 |
% Enter the individual index entries in the poems as you normally |
| 1647 |
% would for use by MakeIndex (say, after each title and first line). One of |
| 1648 |
% the nice features of MakeIndex is that every entry has two parts, |
| 1649 |
% one for specifying the sort key of the entry (or subentry), the other |
| 1650 |
% for specifying the font and typesetting information of the entry (or |
| 1651 |
% subentry). This enables you to drop all of the initial uses of |
| 1652 |
% ``the'' in titles for sorting purposes, while still including the |
| 1653 |
% ``the'' in the title. It also enables you to distinguish titles |
| 1654 |
% from first lines (by italicizing them), and to include typesetting |
| 1655 |
% information (such as italicization) in titles or first lines without |
| 1656 |
% messing up their sort order. |
| 1657 |
% |
| 1658 |
% \subsection{~Making multiple indices}\label{multipleindex} |
| 1659 |
% \textsf{poemscol} can work with \textsf{splitindex} to generate |
| 1660 |
% more than one index. You might, for instance, wish a separate index |
| 1661 |
% of titles and index of first lines, or an index of proper names. To |
| 1662 |
% do this, call \textsf{splitindex} in your list of packages. Then, |
| 1663 |
% in your preamble, declare the indices you are planning to use, e.g.: |
| 1664 |
% \begin{verbatim} |
| 1665 |
% \newindex[Index of Titles]{idx} |
| 1666 |
% \newindex[Index of First Lines]{fir} |
| 1667 |
% \newindex[Onomastic Index]{ono} |
| 1668 |
% \end{verbatim}The second argument is the |
| 1669 |
% ``shortcut'' defined by \textsf{splitindex}, and will be used to |
| 1670 |
% mark index entries in your text (see below), and used also as the extension |
| 1671 |
% for the external index files used by MakeIndex. |
| 1672 |
% |
| 1673 |
% Then mark up individual entries. Some entries (in the example |
| 1674 |
% above, the ``Index of Titles'' examples) can be marked up with |
| 1675 |
% |\index| just as if you were using only one index. Entries for |
| 1676 |
% other indices should be marked using the |\sindex| command from |
| 1677 |
% \textsf{splitindex}, as follows |
| 1678 |
% \begin{verbatim} |
| 1679 |
% \sindex[fir]{Of Man's first disobedience and the fruit} |
| 1680 |
% \end{verbatim} |
| 1681 |
% where the |
| 1682 |
% first argument is the ``shortcut'' and the second is the index |
| 1683 |
% entry. If you are loading \textsf{splitindex} with the |
| 1684 |
% \textsf{split} option, the different types of index entry will be |
| 1685 |
% sent to separate output streams, which each must be processed separately |
| 1686 |
% with MakeIndex. \TeX\ has only a limited number of such output |
| 1687 |
% streams, however, so it is probably wiser not to choose that |
| 1688 |
% option, but to use splitindex.tex, splitindex.pl, or one of the |
| 1689 |
% other means provided with the \textsf{splitindex} package to break |
| 1690 |
% up the index into the separate parts, each of which must be |
| 1691 |
% processed with MakeIndex separately. |
| 1692 |
% |
| 1693 |
% To include the indices, and to add entries for them to the table of |
| 1694 |
% contents, issue |\putmultiplepoemindex| for each one. |
| 1695 |
% |\putmultiplepoemindex| takes four arguments, which are: 1.\ The |
| 1696 |
% three letter ``shortcut'' used by |\splitindex|, 2.\ The title of |
| 1697 |
% the Index on its first page, 3.\ The running header for that index |
| 1698 |
% section, and 4.\ The name of the section as you wish it to appear in |
| 1699 |
% the Table of Contents. So, for instance |
| 1700 |
% \begin{verbatim} |
| 1701 |
% \putmultiplepoemindex{fir}{INDEX OF FIRST LINES}{Index of First |
| 1702 |
% Lines}{First Line Index} \end{verbatim} |
| 1703 |
% includes an index with shortcut ``fir,'' title ``INDEX OF FIRST |
| 1704 |
% LINES,'' running header ``Index of First Lines,'' and contents |
| 1705 |
% entry ``First Line Index.'' |
| 1706 |
% \section{Collections with multiple volumes} |
| 1707 |
% \DescribeEnv{volumetitlepage} \DescribeEnv{maintitlepage} |
| 1708 |
% The |volumetitlepage| environment is an |
| 1709 |
% environment for divider pages in collections made up of several |
| 1710 |
% volumes. Volume title pages will always appear on recto pages with blank verso pages. |
| 1711 |
% \textsf{poemscol} will also automatically create a blank verso page |
| 1712 |
% preceding the volume title page if it is necessary. The |
| 1713 |
% |maintitlepage| environment is for the title page of the whole |
| 1714 |
% book. The main title page will also automatically always be on a |
| 1715 |
% recto page. These divider pages have special |
| 1716 |
% page styles, with no page numbers and no running headers. |
| 1717 |
% |
| 1718 |
% \begin{sloppypar} |
| 1719 |
% \DescribeMacro{\wholebooktitle} \DescribeMacro{\volumetitle} |
| 1720 |
% |\wholebooktitle| is for the title of the entire collection. |
| 1721 |
% |\volumetitle| is for the title of an individual volume within a |
| 1722 |
% Collected Poems. |\wholebooktitle| |
| 1723 |
% merely sets its argument in a very large font. |\volumetitle| also sets an entry |
| 1724 |
% in the table of contents (with no page number, but followed by extra |
| 1725 |
% vertical space) and in the endnotes (with |
| 1726 |
% no page number). |
| 1727 |
% |
| 1728 |
% \DescribeMacro{\volumetitlefirstline} |
| 1729 |
% \DescribeMacro{\volumetitlemiddleline} |
| 1730 |
% \DescribeMacro{\volumetitlelastline} |
| 1731 |
% \DescribeMacro{\volumesubtitle} |
| 1732 |
% The |\volumetitlefirstline|, |
| 1733 |
% |\volumetitlemiddleline|, and |\volumetitlelastline| commands are |
| 1734 |
% for multi-line titles of volumes gathered into the collection. (Use |
| 1735 |
% these last commands if you want to specify how a long title is |
| 1736 |
% broken up both in the text and in the table of contents. |
| 1737 |
% \textsf{poemscol} will break up long titles on its own anyway |
| 1738 |
% if you don't specify how to break them up, but |
| 1739 |
% you might not be happy with how it breaks up the lines.) |
| 1740 |
% |\volumesubtitle| is for setting the subtitle to a volume. |
| 1741 |
% In addition to setting the text in the body of your |
| 1742 |
% edition, these commands send the title (and the formatting |
| 1743 |
% information about it) to the table of contents file and to the |
| 1744 |
% various endnotes files.\end{sloppypar} |
| 1745 |
% |
| 1746 |
% \DescribeMacro{\volumesectiontitle} |
| 1747 |
% |\volumesectiontitle| is for setting the title of a section of a |
| 1748 |
% volume. |\volumesectiontitle| merely prints the title in a large font in boldface |
| 1749 |
% in the text. It always prints at the top of a page, but it does not ensure that that |
| 1750 |
% page is a recto page, does not reserve the whole |
| 1751 |
% page for the title, or put a blank verso page following the title. It prints the title |
| 1752 |
% in the contents without a page number, and prints the title in the textual notes |
| 1753 |
% (but not in the other endnote sections) in boldface on a separate line. |
| 1754 |
% Because it is so different from other titles, it does not use the three internal |
| 1755 |
% commands (|\set@p@emtitle|, |\c@ntentsinfo|, and |\t@xtnotesinfo|) that |
| 1756 |
% all of the other title commands use, so modifying those internal commands will not |
| 1757 |
% change |\volumesectiontitle|. |
| 1758 |
% |
| 1759 |
% \DescribeMacro{\volumeepigraph} \DescribeMacro{\volumeattribution} |
| 1760 |
% |\volumeepigraph| and |
| 1761 |
% |\volumeattribution| are for epigraphs and attributions on the |
| 1762 |
% divider pages. \goodbreak |
| 1763 |
% |
| 1764 |
% \DescribeMacro{\volumeheader} \DescribeMacro{\leftheader} \DescribeMacro{\rightheader} |
| 1765 |
% |\volumeheader| or |\rightheader| is for setting the right |
| 1766 |
% running header for that volume (except for divider pages, the table |
| 1767 |
% of contents, the notes sections, and other special cases). Normally |
| 1768 |
% that is just the name of the particular volume. |\leftheader| is for setting |
| 1769 |
% the left running header for the entire book (except for divider |
| 1770 |
% pages, the table of contents, the notes sections, and other special |
| 1771 |
% cases). Normally that is the name of the entire book. |
| 1772 |
% |
| 1773 |
% \section{Recording textual notes, emendations, and explanatory notes}\label{recordingtextualnotes} |
| 1774 |
% \subsection{~Setup for endnote sections} |
| 1775 |
% \DescribeMacro{\maketextnotes} \DescribeMacro{\makeemendations} |
| 1776 |
% \DescribeMacro{\makeexplanatorynotes} |
| 1777 |
% To collect textual collations, issue |\maketextnotes| in your |
| 1778 |
% preamble. |
| 1779 |
% To collect emendation notes, issue |\makeemendations| in your preamble. |
| 1780 |
% To collect explanatory notes, issue |
| 1781 |
% |\makeexplanatorynotes| in your preamble. |
| 1782 |
% These commands open external files for emendations, textual |
| 1783 |
% collations, and explanatory notes (with extensions .emd, .ent, and |
| 1784 |
% .enx respectively). \textsf{poemscol} reads these files back into the main document |
| 1785 |
% at the place you specify |
| 1786 |
% with |\puttextnotes|, |\putexplanatory|, or |\putemendations|, or at |
| 1787 |
% the end (if you use the |\finish| command). |
| 1788 |
% These commands also send to the external files the commands for typesetting the |
| 1789 |
% title of each section (e.g. Explanatory Notes), for making an entry in the table |
| 1790 |
% of contents for each endnote section, and for modifying the |
| 1791 |
% running headers of the notes sections to xx--yy format (e.g. |
| 1792 |
% ``Explanatory Notes to pp.~55--7''). |
| 1793 |
% |
| 1794 |
% \textsf{poemscol} opens an entry (headed with |
| 1795 |
% the title, and the page the poem appears on in the body of the |
| 1796 |
% text, in boldface) in the textual notes |
| 1797 |
% section for every poem (since, minimally, you want to include |
| 1798 |
% information about the variants and copy text of the poem). |
| 1799 |
% In the emendations or explanatory notes sections |
| 1800 |
% \textsf{poemscol} |
| 1801 |
% sets this information only if you actually have emendations or explanatory notes on that poem. |
| 1802 |
% If you have defined a new endnote section using |\definenewnotetype| \textsf{poemscol} |
| 1803 |
% will also only set the poem heading in the notes if there actually is a note for that poem. |
| 1804 |
% |
| 1805 |
% The notes for each poem are set in a block paragraph, with a new |
| 1806 |
% paragraph for every |\poemtitle| command, and the line counter for |
| 1807 |
% the notes is reset to 1 with every |\begin{poem}|. (For long poems |
| 1808 |
% in books or cantos, it you might use |\poemtitle| for the |
| 1809 |
% canto names or numbers, or perhaps you might want to design a new species |
| 1810 |
% of title using the commands described below at section \ref{customizing titles}, |
| 1811 |
% page \pageref{customizing titles}.) |
| 1812 |
% |
| 1813 |
% By default, there is one paragraph per poem, with a hanging indent to give |
| 1814 |
% prominence to the page number. |
| 1815 |
% |
| 1816 |
% If you wish to use multi-layer footnotes rather than endnotes, you |
| 1817 |
% do not need to issue |\maketextnotes| or its relatives (but you |
| 1818 |
% should of course issue |\textnotesatfoot| or its relatives). You can mix |
| 1819 |
% footnotes or endnotes as you wish. You may, for instance, wish to |
| 1820 |
% set explanatory notes as footnotes, and textual notes and |
| 1821 |
% emendations as endnotes. Instructions for setting up |
| 1822 |
% \textsf{poemscol} to make such footnotes are in section |
| 1823 |
% \ref{makingfootnotes} below. |
| 1824 |
% |
| 1825 |
% \subsection{~Customizing endnotes} |
| 1826 |
% \begin{sloppypar} |
| 1827 |
% \DescribeMacro{\iftextnotessinglepar} |
| 1828 |
% \DescribeMacro{\ifemendationssingplepar} |
| 1829 |
% \DescribeMacro{\ifexplanationssinglepar} |
| 1830 |
% You may, |
| 1831 |
% particularly if you are annotating long poems, wish each |
| 1832 |
% note to appear in its own paragraph rather than in a block paragraph |
| 1833 |
% with the other notes to that poem. To do this, you need to set |
| 1834 |
% the relevant boolean. Issue |\textnotessinglepartrue| |
| 1835 |
% |\emendationssingplepartrue| or |\explanationssinglepartrue| to give |
| 1836 |
% each such note a separate paragraph. (Similar booleans will be automatically |
| 1837 |
% defined for any species of endnote you create.) By default, these notes will have a |
| 1838 |
% hanging indent, to give prominence to the line number. |
| 1839 |
% \end{sloppypar} |
| 1840 |
% |
| 1841 |
% \begin{sloppypar} |
| 1842 |
% \DescribeMacro{\noteindentation} |
| 1843 |
% You may have notes with multiple paragraphs. The default settings for all of |
| 1844 |
% the forms of endnotes set them with hanging indentation, which probably is not |
| 1845 |
% a good idea for multiple paragraph notes. There are two ways of approaching |
| 1846 |
% this problem. The first way is to change all of the paragraphs of the notes to |
| 1847 |
% normal indentation, which you can do by issuing |
| 1848 |
% |\literaltextnote{\setlength{\parindent}{\noteindentation}}| just after issuing |\maketextnotes| . |
| 1849 |
% You can change the amount of indentation by changing the value of the |
| 1850 |
% length |\noteindentation| (the default value is 1 em). |
| 1851 |
% You should remember to issue similar |
| 1852 |
% commands for emendations, explanatory notes, and whatever kinds of notes you |
| 1853 |
% create using |\definenewnotetype|. |
| 1854 |
% \end{sloppypar} |
| 1855 |
% |
| 1856 |
% \DescribeMacro{\noteparbreak} |
| 1857 |
% Alternatively, if you want to keep the hanging indent for the page number, but still have paragraph |
| 1858 |
% breaks in the note, issue |\noteparbreak| whenever you want a paragraph break |
| 1859 |
% in the midst of a note. The first paragraph will have a hanging indent for the |
| 1860 |
% page number, but every paragraph that follows a |\noteparbreak| will have normal |
| 1861 |
% paragraph indentation. By default, |\noteparbreak| indents the new paragraph |
| 1862 |
% 1em. You can change this by changing the value of the length |
| 1863 |
% |\noteindentation|. |
| 1864 |
% |
| 1865 |
% \DescribeMacro{\iftextnotestwocol} |
| 1866 |
% \DescribeMacro{\ifemendationstwocol} |
| 1867 |
% \DescribeMacro{\ifexplanationstwocol} |
| 1868 |
% By default, notes are set in single columns. To set them in two column mode, |
| 1869 |
% set the relevant booleans to true, e.g. |\textnotestwocoltrue|. Again, any note type |
| 1870 |
% you create with |\definenewnotetype| will automatically define the ``twocol'' boolean |
| 1871 |
% that goes with it. |
| 1872 |
% |
| 1873 |
% \DescribeMacro{\putpagenumberinnotesfalse} |
| 1874 |
% \DescribeMacro{\puttitleinnotesfalse} |
| 1875 |
% You may not wish to have the poem's page number and title appear in |
| 1876 |
% the notes. To turn off the appearance of the page number in the |
| 1877 |
% notes, issue |\putpagenumberinnotesfalse|. You may also not wish to |
| 1878 |
% put the poem's title in the notes. To turn off the appearance of the |
| 1879 |
% poem's title in the notes, issue |\puttitleinnotesfalse|. \textsf{poemscol} assumes |
| 1880 |
% that the notes to a poem will begin with either the poem's title, or its page number, or both, |
| 1881 |
% so although you can set either boolean to ``false,'' don't set both of them to ``false." |
| 1882 |
% \textsf{poemscol} will let you do this, but the results will be strange. Also, |\putitleinnotesfalse| |
| 1883 |
% applies only the textnotes. Emendations, explanatory notes, and any note types you create |
| 1884 |
% with |\definenewnotetype| will include the title of the poem. |
| 1885 |
% |
| 1886 |
% \goodbreak |
| 1887 |
% \DescribeMacro{\contentsendnotesindent} |
| 1888 |
% \DescribeMacro{\contentsendnotesfont} |
| 1889 |
% You can control the appearance of the entry for endnote sections in |
| 1890 |
% the table of contents by changing the definition of |
| 1891 |
% |\contentsendnotesindent| (set by default to |\contentsindentone|) |
| 1892 |
% or |\contentsendnotesfont| (set by default to |
| 1893 |
% |\contentspoemtitlefont|.) |
| 1894 |
% |
| 1895 |
% \subsection{~Textual notes of various kinds} |
| 1896 |
% \DescribeMacro{\sources} To record information about the copy text, |
| 1897 |
% editions and publication history of individual poems, or any |
| 1898 |
% information not tied to specific lines in the poem, you should place |
| 1899 |
% that information in the argument to the |\sources| command. |
| 1900 |
% |\sources| sends information to the external file for textual notes, but does not |
| 1901 |
% tag what it sends with line numbers, hence its use for sending ``sources.'' |
| 1902 |
% Typically, you should issue this command after you have issued |
| 1903 |
% |\poemtitle| and before you issue |\begin{poem}|. That way the ``sources'' will |
| 1904 |
% appear in the textual notes section just after the title of the poem, but before the |
| 1905 |
% notes on particular lines. |
| 1906 |
% You could conceivably use |\sources| |
| 1907 |
% send typesetting information to the textual notes file (such as to force a page |
| 1908 |
% break), but I prefer to do that |
| 1909 |
% by using |\literaltextnote|, which also sends information to the external |
| 1910 |
% file for textnotes without sending line numbers. Although they do the same thing, I use |\sources| to |
| 1911 |
% send editorial information to the texual note section, but use |
| 1912 |
% |\literaltexnote| to send formatting instructions to the textual note section, so that |
| 1913 |
% the different purposes of the note are clear at first glance. You can send |
| 1914 |
% typesetting information to other sections by using |
| 1915 |
% |\literalemend|, |\literalexplain|, or |\literalcontents|. \textsf{poemscol} also |
| 1916 |
% creates a similar ``literal'' command for any type of endnote you create on the fly |
| 1917 |
% using |\definenewnotetype|. |
| 1918 |
% |
| 1919 |
% There is one subtle difference between |\sources| and |\literaltextnote|. If you |
| 1920 |
% issue the commands to set your textual notes as footnotes rather than endnotes, |
| 1921 |
% notes issued with |\sources| will be set as footnotes, but anything issued using |\literaltextnote| |
| 1922 |
% will be discarded. To set textual notes as footnotes, |
| 1923 |
% see section \ref{makingfootnotes}, page \pageref{makingfootnotes}, below. |
| 1924 |
% |
| 1925 |
% \DescribeMacro{\textnote} |
| 1926 |
% \DescribeMacro{\emendation} |
| 1927 |
% \DescribeMacro{\explanatory} |
| 1928 |
% |\textnote| is used to capture variants and tie them to the |
| 1929 |
% correct line number. You don't have to count line numbers; |
| 1930 |
% \textsf{poemscol} keeps track of them for you. Issue |\textnote| |
| 1931 |
% immediately after the |\verseline| command which marks the ending of |
| 1932 |
% the line you wish to comment upon. Put the text of your note (which |
| 1933 |
% may be simply the recording of a variant in standard notation) into |
| 1934 |
% the argument of the command. You should put both the lemma and the |
| 1935 |
% variants or comment in the argument to the |\textnote| command. |
| 1936 |
% For emendations, use |\emendation|, and for explanatory notes, |
| 1937 |
% use |\explanatory|. These notes go to their own endnote sections. The |
| 1938 |
% only difference is that each poem opens a new paragraph (headed with the |
| 1939 |
% poem's title and page number) for its own |
| 1940 |
% textual notes, but such paragraphs for explanatory notes or emendations are only |
| 1941 |
% opened if there actually are explanatory notes or emendations for that poem. |
| 1942 |
% |
| 1943 |
% \DescribeMacro{\sameword} |
| 1944 |
% \DescribeMacro{\missingpunct} |
| 1945 |
% To |
| 1946 |
% put the $\sim$ glyph in your note (used for recording places where |
| 1947 |
% the variant and the copy text have the same word, as for instance |
| 1948 |
% when recording a variation of punctuation) use |\sameword|. To put |
| 1949 |
% the ${}_{\wedge}$ glyph into your text (used for recording places |
| 1950 |
% where a punctuation mark is missing in a variant), use |
| 1951 |
% |\missingpunct|. |
| 1952 |
% |
| 1953 |
% For notes that refer to ranges of lines, |\textnote|, |\emendation|, |
| 1954 |
% and |\explanatory| have an optional argument, which records how many |
| 1955 |
% lines the note refers to. There are two ways of using this |
| 1956 |
% argument. The grubby but simple way is simply to put into the |
| 1957 |
% argument the number of lines it refers to. If, for instance, you |
| 1958 |
% issue |\textnote[4]{lemma] rest of note}|, \textsf{poemscol}, rather |
| 1959 |
% than printing merely the number of the line which closed just before |
| 1960 |
% you issued |\textnote|, will print a line range, beginning at that |
| 1961 |
% line, and ending at the fourth line after it. If that |\textnote| |
| 1962 |
% were issued after line 214, this is to say, the output in the |
| 1963 |
% textual notes would be: 214--218: lemma] rest of note. |
| 1964 |
% |
| 1965 |
% \begin{sloppypar} It seems clumsy to count the lines referred to by |
| 1966 |
% a note, especially since you don't have to count lines to set where |
| 1967 |
% the note begins. A more sophisticated way, and one which involves |
| 1968 |
% no counting, is to make a unique poem line label for the last line |
| 1969 |
% of the range by issuing |\poemlinelabel{some unique label}| just |
| 1970 |
% after the |\verseline| or |\end{stanza}| that ends the range. (To |
| 1971 |
% use |\poemlinelabel| see section \ref{poemlinelabel}.) Then, back |
| 1972 |
% after the |\verseline| or |\end{stanza}| command that closes the |
| 1973 |
% first line of the range, put the text of the label into the optional |
| 1974 |
% argument of |\textnote| as follows: |\textnote[some unique label]{lemma]rest of note}|. |
| 1975 |
%This is the preferred method. The |
| 1976 |
% line-counting method is deprecated, but retained for backwards |
| 1977 |
% compatibility with earlier versions. If you use the label method, |
| 1978 |
% you will have to run your file through \LaTeX\ twice, once to define |
| 1979 |
% the labels, and once to set the text.\end{sloppypar} |
| 1980 |
% |
| 1981 |
% Here is a complete example: |
| 1982 |
%\begin{verbatim} |
| 1983 |
%Yes, then I met the beast. Well, better, indeed,\verseline |
| 1984 |
%\textnote[had it been the]{better, indeed, / Had it been the] better if |
| 1985 |
%it / Had been the 1953TS (revised in black pencil |
| 1986 |
%on 1953TS to 1953)} |
| 1987 |
%Had it been the manifest beast and the circumstantial\verseline |
| 1988 |
%\poemlinelabel{had it been the} |
| 1989 |
%Avatar of destruction. But no beast then: the towering\verseline |
| 1990 |
%Definition, angelic, arrogant, abstract,\verseline |
| 1991 |
%Greaved in glory, thewed with light, the bright\verseline |
| 1992 |
%Brow tall as dawn. I could not see the eyes.\end{stanza} |
| 1993 |
% \end{verbatim} |
| 1994 |
% |
| 1995 |
% Overlapping lemmas, or lemmas that |
| 1996 |
% include stanza breaks, do not pose any difficulties for |poemscol|. |
| 1997 |
% |
| 1998 |
% |\emendation| and |\explanatory| are used exactly as |\textnote| |
| 1999 |
% is. Issue the emendation or the explanatory note as the argument to |
| 2000 |
% the command. Place the command immediately after the |\verseline| that |
| 2001 |
% concludes the line to which it is a comment. These commands also can |
| 2002 |
% take optional arguments to specify line ranges. |
| 2003 |
% |
| 2004 |
% \begin{sloppypar} |
| 2005 |
% \DescribeMacro{\accidental} |\accidental| behaves exactly like |
| 2006 |
% |\textnote|. Accidentals |
| 2007 |
% are included by default, but if you issue |\global\includeaccidentalstrue| |
| 2008 |
% in your preamble, you will remind yourself of that fact. |
| 2009 |
% If you wish to distinguish between accidentals and |
| 2010 |
% substantives, using |\accidental| provides a way of doing so.\end{sloppypar} |
| 2011 |
% |
| 2012 |
% If you wish to exclude accidentals from your printed output, but to |
| 2013 |
% mark them in your source files, so that your published collation in the |
| 2014 |
% textual notes endnotes section |
| 2015 |
% consists only of substantives, issue |
| 2016 |
% |\global\includeaccidentalsfalse| in your preamble. Many publishers |
| 2017 |
% are reluctant to publish accidentals, believing that they are, well, |
| 2018 |
% less substantive than substantives. Using the |\accidental| |
| 2019 |
% command allows you to exclude accidentals from the published version |
| 2020 |
% should your publisher insist, while preserving the information about |
| 2021 |
% them in your source files should the publisher's mind change. In the very worst case, if |
| 2022 |
% you have marked all the accidentals in this way you can still |
| 2023 |
% produce a list of accidentals for later use, and other scholars can |
| 2024 |
% search for accidentals in your source files simply by searching for |
| 2025 |
% the string |\accidental|. |
| 2026 |
% |
| 2027 |
% \textsf{poemscol} does not provide for a separate backmatter section |
| 2028 |
% for accidentals, but it would be trivial to construct one, using |
| 2029 |
% |\definenewnotetype|, described in section \ref{definingnewnotes} |
| 2030 |
% below. You may, for instance, use |\definenewnotetype| to create a command called |
| 2031 |
% |\newaccidental|, then issue| \let\accidental=\newaccidental|. |
| 2032 |
% |
| 2033 |
% \DescribeMacro{\tsvariant} \DescribeMacro{\tsentry} Some publishers |
| 2034 |
% may turn up their noses at typescript or manuscript variants (changes on |
| 2035 |
% a manuscript or typescript as opposed to differences between published versions) in just |
| 2036 |
% the way they turn up their noses at accidentals. If you wish to |
| 2037 |
% distinguish between published variants and typescript, |
| 2038 |
% man\-u\-script, or galley variants, |\tsvariant| (for a whole note) |
| 2039 |
% and |\tsentry| (for a typescript entry in a list of variants in a |
| 2040 |
% textual note that includes other kinds of variant) provide ways of |
| 2041 |
% doing so. By default, typescript variants are included. To exclude |
| 2042 |
% typescript variants, issue |\global\includetypescriptsfalse| in your |
| 2043 |
% preamble. You can issue |\global||\includetypescriptstrue| in your |
| 2044 |
% preamble, to remind yourself that you are including typescript |
| 2045 |
% variants. In that (default) case |\tsvariant| will behave exactly |
| 2046 |
% like |\textnote|, and entries in other notes marked with |
| 2047 |
% |\tsentry| will be included in your output. |
| 2048 |
% |
| 2049 |
% Here is how to use |\tsentry|: |
| 2050 |
% if you wish to include typescript entries in a single note including |
| 2051 |
% those entries in a list with variants from other published versions |
| 2052 |
% (as for instance when a word appears in a typescript but only in |
| 2053 |
% the second edition of the published poem), simply issue |
| 2054 |
% |\textnote| as usual, marking the relevant variant in the list of |
| 2055 |
% variants with the |\tsentry| command. If typescript variants |
| 2056 |
% are excluded, the typescript entry will also be excluded. |
| 2057 |
% |
| 2058 |
% Here is a typical use of the |\tsentry| command: |
| 2059 |
% \begin{verbatim} |
| 2060 |
% Of moonlit desert. A stallion, white and flashing, slips,\verseline |
| 2061 |
% \textnote{Of moonlit] Of the moonlit {\em NY\/}\tsentry{, SP85TS |
| 2062 |
% (revised in black pen to SP85)}} |
| 2063 |
% \end{verbatim} |
| 2064 |
% |
| 2065 |
% Notice that since the |\tsentry| comes in the middle of the list, |
| 2066 |
% it begins with a comma. You might expect an |\unskip| command |
| 2067 |
% before the comma, to prevent |
| 2068 |
% \LaTeX\ from adding white space before the comma. \textsf{poemscol} |
| 2069 |
% automatically provides the |\unskip| if the entry starts with a |
| 2070 |
% comma or a semicolon. |
| 2071 |
% |
| 2072 |
% You can |
| 2073 |
% mark individual variants with |\tsentry| in the arguments to the |
| 2074 |
% |\explanatory| and |\emendation| commands as well, and |
| 2075 |
% |\tsentry| will also behave normally in any endnote or footnote section |
| 2076 |
% you define using |\definenewnotetype|. |
| 2077 |
% |
| 2078 |
% \textsf{poemscol} does not provide for a separate backmatter section |
| 2079 |
% for typescript variants, but it would be trivial to construct one, |
| 2080 |
% again using |\definenewnotetype|. To do this, you would also have to |
| 2081 |
% copy all of the emendations, explanatory notes, and textual notes |
| 2082 |
% which have a |\tsentry| in their arguments, and add |
| 2083 |
% |\tsvariant| commands in those places. For information about |
| 2084 |
% |\definenewnotetype| see section \ref{definingnewnotes}. |
| 2085 |
% |
| 2086 |
% \DescribeMacro{\margreftextnote} |
| 2087 |
% \DescribeMacro{\margrefexplanatory} |
| 2088 |
% \DescribeMacro{\margrefemendation} |
| 2089 |
% Some editions include a marginal mark in the text showing where in the |
| 2090 |
% apparatus a textual note on that line can be found. (The edition of William |
| 2091 |
% Blake's poetry and prose edited by Harold Bloom and David V. Erdman, for instance, |
| 2092 |
% includes such marks.) |
| 2093 |
% |\margreftextnote| sets a label in the textual notes section, and |
| 2094 |
% sets a marginal note with a page reference to that label in the main text. Issue |
| 2095 |
% |\margreftextnote| \emph{before} issuing the |\verseline| or |
| 2096 |
% |\end{stanza}| that closes the line to which it refers. (The textual |
| 2097 |
% note itself can be an ordinary |\textnote|, and should be placed, as |
| 2098 |
% usual, \emph{after} the |\verseline| or |\end{stanza}|.) |
| 2099 |
% |\margrefexplanatory| does the same thing for explanatory notes, and |
| 2100 |
% |\margrefemendation| does the same thing for emendations. |
| 2101 |
% If you define a new kind of endnote with |\definenewnotetype|, you |
| 2102 |
% will automatically also define a new |\margref| command for that kind of note. For |
| 2103 |
% details about how these markers work, see |
| 2104 |
% section \ref{margreftextnote}, page \pageref{margreftextnote}. |
| 2105 |
% |
| 2106 |
% \DescribeMacro{\quotedversecorrectiontextnote} |
| 2107 |
% If you quote verse \emph{within} a textual note, an explanatory |
| 2108 |
% note, or an emendation, you may want to use the normal \LaTeX\ |
| 2109 |
% |verse| environment for that quotation, rather than the special markup |
| 2110 |
% for \textsf{poemscol}. You can also use the special |pmclverse| environment, which |
| 2111 |
% enlarges the indentation of runover lines and the white space |
| 2112 |
% between stanzas. But you should not use the |poem| environment within the textual notes. |
| 2113 |
% |
| 2114 |
% If a textual note |
| 2115 |
% \emph{ends} with a quotation in verse, you should |
| 2116 |
% follow the |\textnote| entry with |
| 2117 |
% |\quotedversecorrectiontextnote|. I found that if I quoted verse in |
| 2118 |
% the note sections a dirty trick I used to send the notes to the |
| 2119 |
% external files would cause the following notes on that poem in the |
| 2120 |
% notes sections to be set in a new paragraph. (This is of course not |
| 2121 |
% a problem if the quoted verse is the last thing in the notes to that |
| 2122 |
% poem, since the next poem will open a new paragraph in the notes |
| 2123 |
% anyway. It is also not a problem if more of the individual textnote |
| 2124 |
% follows the verse. It's only a problem if the last thing in the |
| 2125 |
% note is quoted verse, and the note is not the last one on that |
| 2126 |
% poem.) The command should set it flush as it is, but I have found |
| 2127 |
% odd cases I can't understand in which that doesn't work, so the |
| 2128 |
% command has an optional argument, which should be the additional |
| 2129 |
% length you need to adjust the next line by to make it flush. The |
| 2130 |
% default is 0pt. |\quotedversecorrectionexplanatory| and |
| 2131 |
% |\quotedversecorrectionemendation| should follow explanatory notes |
| 2132 |
% or emendations that end with snippets of verse. These three |
| 2133 |
% commands are an embarrassing kludge on my part. They simply send |
| 2134 |
% commands to the relevant note sections that prohibit opening a new |
| 2135 |
% paragraph. You should issue this command in the main text right |
| 2136 |
% after the close of the textnote (not in the text of the textnote |
| 2137 |
% itself). |
| 2138 |
% |
| 2139 |
% \section{Creating new kinds of endnote} \label{definingnewnotes} |
| 2140 |
% \DescribeMacro{\definenewnotetype} The |\definenewnotetype| command |
| 2141 |
% can be used to create new kinds of endnote, in case the kinds |
| 2142 |
% \textsf{poemscol} has predefined do not suffice. |\definenewnotetype| |
| 2143 |
% takes five arguments. They are (assuming you are creating a new |
| 2144 |
% kind of note to be called a ``mynote''): \begin{enumerate} \item A base name |
| 2145 |
% used to construct \begin{itemize} \item some |\if| variables (e.g.\ |
| 2146 |
% |\ifmynoteson| to see whether you are collecting ``mynotes'', |
| 2147 |
% |\ifnomynoteyet| to see whether you have written a ``mynote'' for a |
| 2148 |
% particular poem yet, |\ifmynotestwocol| to set the notes in two |
| 2149 |
% column mode, and |\ifmynotesinglepar| to set the notes in |
| 2150 |
% one paragraph per note form, rather than in block paragraphs). |
| 2151 |
% \textsf{poemscol} will only open an entry for a poem in the |
| 2152 |
% ``mynotes'' section if there actually is a ``mynote'' on that poem. |
| 2153 |
% Note that every |\if| that refers to a section is plural |
| 2154 |
% (|\ifmynoteson|, |\ifmynotestwocol|, |\ifmynotessinglepar|) and |
| 2155 |
% that every |\if| that refers to a singular note |
| 2156 |
% is singular (|\ifnomynoteyet|). \item The name for the output |
| 2157 |
% channel for writing the notes to the appropriate external file. |
| 2158 |
% This name will always be plural (e.g.\ ``mynotes"). \item The name for the ``literal'' |
| 2159 |
% command for writing literal, unexpanded text on the file (as |
| 2160 |
% |\literaltextnote| does on the textnotes file), and for the note |
| 2161 |
% command that sends the actual textual note (line number and all) to |
| 2162 |
% the section (e.g.\ |\literalmynote| and |\mynote|), also the command to write notes in |
| 2163 |
% line-numbered prose (e.g.\ |\prosemynote|) or prose numbered by |
| 2164 |
% paragraph and sentence (e.g.\ |\pmmynote|). These commands will |
| 2165 |
% always be singular. \item The name of the |\put| command (e.g.\ |
| 2166 |
% |\putmynotes|) which closes the external file for the notes section, |
| 2167 |
% reads it back in to your document, and adds an entry in the table of |
| 2168 |
% contents for that notes section. This command will always be |
| 2169 |
% plural. (There won't be a |\makemynotes| command, |
| 2170 |
% because |\definenewnotetype| takes its place.) |
| 2171 |
% \item The name of the |\margref| command for putting a |
| 2172 |
% marginal mark next to a line giving the page number in the apparatus |
| 2173 |
% where a note is to be found (e.g.\ |\margrefmynote|) \end{itemize} |
| 2174 |
% \item The extension for the external file which will hold the notes |
| 2175 |
% as you generate them. ``Emendations'' for instance, are written to |
| 2176 |
% an external file called |\jobname.emd| The file name will always be |
| 2177 |
% |\jobname|, and the different species of endnotes will all have |
| 2178 |
% distinctive extensions. (|\jobname| is a command that always expands |
| 2179 |
% to the name of your top level source file. If, for instance, I am |
| 2180 |
% setting running a file called ``myfile.tex'' through \LaTeX\, |
| 2181 |
% |\jobname.emd| translates to ``myfile.emd.'') \item The title of the |
| 2182 |
% notes section as you wish it to appear in the running header (e.g. |
| 2183 |
% ``Mynotes to ''). \item The title of the notes section as you wish |
| 2184 |
% it to appear on the first page of the notes section (e.g. |
| 2185 |
% ``MYNOTES''). \item The title of the notes section as you wish |
| 2186 |
% it to appear in the table of contents (e.g.\ ``Mynotes''). \end{enumerate} |
| 2187 |
% |
| 2188 |
% \begin{sloppypar} So, for instance,\begin{verbatim} |
| 2189 |
% \definenewnotetype{xyznote}{xyz}{Xyznotes to}{XYZNOTES}{Xyznotes} |
| 2190 |
% \end{verbatim} |
| 2191 |
% creates the booleans |\ifxyznoteson|, |\ifnoxyznoteyet|, and |
| 2192 |
% |\ifxyznotessinglepar|, the |
| 2193 |
% commands |\xyznote|, |\literalxyznote|, |\prosexyznote|, |
| 2194 |
% |\pmxyznote|, and |\putxyznotes| (and, although you don't ever have |
| 2195 |
% to use it explicitly, |\firstxyznote|) the output channel xyznotes, |
| 2196 |
% the external file |\jobname.xyz|, an entry in the contents for |
| 2197 |
% ``Xyznotes'', and an endnotes section with a running header of the |
| 2198 |
% form ``Xyznotes to pp.~xx--yy'' and a title XYZNOTES. \end{sloppypar} |
| 2199 |
% |
| 2200 |
% |\xyznote| |
| 2201 |
% takes the same arguments that |\textnote| does (which is to say, |
| 2202 |
% an optional argument for a label for entering line ranges, and an |
| 2203 |
% argument for the lemma and the comment). There won't be an entry |
| 2204 |
% for a poem in the ``Xyznotes'' endnotes section unless there |
| 2205 |
% actually is an xyznote for the poem. |
| 2206 |
% |
| 2207 |
%|\prosexyznote| |
| 2208 |
% (for ``xyznotes'' on line-numbered prose passages) takes the same |
| 2209 |
% arguments |\prosetextnote| does (which is to say, an optional |
| 2210 |
% argument for a label for entering line ranges, an argument for a |
| 2211 |
% label to capture the line number of the first line, and an argument |
| 2212 |
% for the lemma and the comment). For notes on passages of line-numbered |
| 2213 |
% prose, see section \ref{prosesections}, page \pageref{prosesections}. |
| 2214 |
% |
| 2215 |
% |\pmxyznote| (for prose passages |
| 2216 |
% numbered by paragraph and sentence) takes the same arguments as |
| 2217 |
% |\pmtextnote|. For notes on passages of prose numbered by |
| 2218 |
% paragraph and sentence, see section \ref{paragraphsentence}, page |
| 2219 |
% \pageref{paragraphsentence}. |
| 2220 |
% |
| 2221 |
% \section{Multi-level footnotes} \label{makingfootnotes} |
| 2222 |
% \DescribeMacro{\textnotesatfoot} \textsf{poemscol} will set multiple |
| 2223 |
% levels of footnotes in block paragraphs, separating each level with |
| 2224 |
% a rule. To enable this feature, call the \textsf{manyfoot} package |
| 2225 |
% as follows in your preamble: |\usepackage[ruled,para*]{manyfoot}|. |
| 2226 |
% |
| 2227 |
% To set your textual notes as footnotes, issue |\textnotesatfoot| in |
| 2228 |
% your preamble. If you do this, \textsf{poemscol} will actually |
| 2229 |
% create two sets of footnotes for textnotes, one for those that are |
| 2230 |
% called with |\textnote|, which will produce an unindented block of |
| 2231 |
% notes, and one for those that are called with |\sources|, which will |
| 2232 |
% produce individual indented paragraphs, opening a new paragraph with |
| 2233 |
% every note. |\sources| notes often have several paragraphs, so they |
| 2234 |
% are inappropriate for block-paragraph or ``para'' mode, and because |
| 2235 |
% those paragraphs are often in fact prose paragraphs, rather than |
| 2236 |
% blocks of notations, they are indented, so that they will be read as |
| 2237 |
% prose. To set your emendations as footnotes, issue |
| 2238 |
% |\emendationsatfoot| in your preamble. These notes will be set by |
| 2239 |
% default as block paragraphs. If you have multiple-paragraph notes |
| 2240 |
% in your emendations, you should redefine these notes to set plain |
| 2241 |
% rather than para style notes. (See the next paragraph for how to do |
| 2242 |
% this.) To set your explanatory notes as |
| 2243 |
% footnotes, issue |\explanationsatfoot|. These notes will also, by |
| 2244 |
% default, be plain style notes, with one indented paragraph per note. |
| 2245 |
% You do not need to issue |\maketextnotes|, |\makeemendations| or |
| 2246 |
% |\makeexplanatorynotes| if you set those notes as footnotes. If you |
| 2247 |
% use |\literaltextnote| anywhere in your file, however, you will lose |
| 2248 |
% the text it would have put in your textnotes, since |\literaltextnote| |
| 2249 |
% just writes its argument onto the external file for textual notes. |
| 2250 |
% The arguments to |\literalexplain| and |\literalemendation| will |
| 2251 |
% be discarded as well if explanatory notes or emendation notes are set as footnotes. |
| 2252 |
% |
| 2253 |
% \DescribeMacro{\iftextfootnotespara} |
| 2254 |
% \DescribeMacro{\ifsourcesfootnotespara} |
| 2255 |
% \DescribeMacro{\ifemendationfootnotespara} |
| 2256 |
% \DescribeMacro{\ifexplanfootnotespara} |
| 2257 |
% To change the style of your footnotes between plain and |
| 2258 |
% para modes, globally change the values some of the following |
| 2259 |
% booleans. |\ifsourcesfootnotespara|, obviously, is true if |
| 2260 |
% footnotes from the |\sources| command are set in ``para'' mode |
| 2261 |
% (default is false). |\iftextfootnotespara| is true if footnotes |
| 2262 |
% from |\textnote| are set in ``para'' mode (default is true). |
| 2263 |
% |\ifemendationfootnotespara|, or |\ifexplanfootnotespara| are the |
| 2264 |
% booleans which set the style of footnotes from |\emendation| and |
| 2265 |
% |\explanatory| respectively. By default, footnotes from |
| 2266 |
% |\emendation| are set in ``para'' mode (|\emendationfootnotesparatrue|), and footnotes from |
| 2267 |
% |\explanatory| are set in ``plain'' mode (|\explanfootnotesparafalse|). To change explanatory |
| 2268 |
% footnotes from plain to para mode, for instance, issue |
| 2269 |
% |\global\explanfootnotesparatrue|. Counterintuitive as it sounds, |
| 2270 |
% you must issue this \emph{before} issuing |\textnotesatfoot|, |\emendationsatfoot|, |
| 2271 |
% or |\explanationsatfoot|. |
| 2272 |
% |
| 2273 |
% When |\sources| is defined to send endnotes to the textual notes |
| 2274 |
% section, they usually appear immediately underneath the title of |
| 2275 |
% the volume or poem they comment upon in the endnotes section. If you are having |\sources| |
| 2276 |
% output footnotes, it would be a good idea to open the note with the |
| 2277 |
% title of the volume or poem it is a comment upon, in case there is |
| 2278 |
% more than one poem on the page. |
| 2279 |
% |
| 2280 |
% When note classes are set as footnotes, the symbol which marks |
| 2281 |
% cases in which a page turn falls on a stanza break will be set |
| 2282 |
% \emph{beneath} the footnotes. This is a consequence of the way |
| 2283 |
% \textsf{poemscol} uses the |\mark| mechanism to keep track of these |
| 2284 |
% cases, so I have not figured out how to change it. But it may well |
| 2285 |
% be more of an idiosyncrasy than a bug, particularly if the symbol |
| 2286 |
% is changed from * to something like ``stanza break at page turn.'' |
| 2287 |
% |
| 2288 |
% \DescribeMacro{\DeclareNewFootnote} |
| 2289 |
% To create a new level of footnote, you must first declare it to |
| 2290 |
% make it known to \textsf{manyfoot}, which requires each level of |
| 2291 |
% footnote to be given a unique suffix (usually a capital letter of |
| 2292 |
% the alphabet). You can declare a new footnote level called |
| 2293 |
% |\footnoteE| for instance, by issuing |
| 2294 |
% |\DeclareNewFootnote[para]{E}|. You will want notes which don't put |
| 2295 |
% a mark in the body of the text, and begin with the line number or |
| 2296 |
% range of line numbers of the lemma. To define a footnote called |
| 2297 |
% |\mynote|, first declare new footnote |\footnoteE| (A, B, C and D |
| 2298 |
% are reserved for sources, textual notes, emendations, and explanatory notes, |
| 2299 |
% respectively, and H is reserved for use for titles with |
| 2300 |
% authorial footnotes). Then issue: \begin{verbatim} |
| 2301 |
% \newcommand{\mynote}[2][0]{\setlemmarange{#1}\\ |
| 2302 |
% \FootnotetextE{\citerange}{#2} |
| 2303 |
% \resetlemmacounters} \end{verbatim} |
| 2304 |
% |\setlemmarange|, |\citerange|, and |
| 2305 |
% |\resetlemmacounters| are internal commands to enable your footnote to handle line ranges in |
| 2306 |
% the lemma. They are defined in the implementation section below, at section |
| 2307 |
% \ref{notetools}. If a |\mynote| refers to a range of lines, you can issue |
| 2308 |
% the same kinds of optional argument that are used with |\textnote|. |
| 2309 |
% |
| 2310 |
% \section{Notes at the end of poems} |
| 2311 |
% \DescribeMacro{\poemendnote} |
| 2312 |
% \DescribeMacro{\makepoemendnotes} |
| 2313 |
% \DescribeMacro{\putpoemendnotes} |
| 2314 |
% You may wish, rather than using endnotes or footnotes, simply to print your |
| 2315 |
% notes at the end of each poem. To do this for simple notes, issue |\makepoemendnotes| just |
| 2316 |
% after |\begin{poem}|. Issue |\poemendnote| where you wish to make a note, |
| 2317 |
% using the same conventions for line ranges you use for |\textnote|. Where you want to output |
| 2318 |
% the notes, issue |\putpoemendnotes|. These notes can have multi-line lemmas, |
| 2319 |
% just like textual notes. |
| 2320 |
% |
| 2321 |
% \DescribeMacro{\ifpoemendnotessinglepar} |
| 2322 |
% By default, each poem end note is given its own paragraph. To concatenate |
| 2323 |
% them into one big paragraph, issue |\poemendnotessingleparfalse|. |
| 2324 |
% |
| 2325 |
% \DescribeMacro{\poemendemendationnote} |
| 2326 |
% \DescribeMacro{\makepoemendemendationnotes} |
| 2327 |
% \DescribeMacro{\putpoemendemendationnotes} |
| 2328 |
% You can also print emendation notes at the end of each poem. |
| 2329 |
% To do this, issue |\makepoemendemendationnotes| just |
| 2330 |
% after |\begin{poem}|. Issue |\poemendemendationnote| where you wish to make a note, |
| 2331 |
% using the same conventions you use for |\textnote|. Where you want to output |
| 2332 |
% the notes, issue |\putpoemendemendationnotes|. These notes can have multi-line lemmas, |
| 2333 |
% just like textual notes. |
| 2334 |
% |
| 2335 |
% By default, each poem end note is given its own paragraph. To concatenate |
| 2336 |
% them into one big paragraph, issue |\poemendemendationnotessingleparfalse|. |
| 2337 |
% |
| 2338 |
% \begin{sloppypar} |
| 2339 |
% \DescribeMacro{\poemendexplanatorynote} |
| 2340 |
% \DescribeMacro{\makepoemendexplanatorynotes} |
| 2341 |
% \DescribeMacro{\putpoemendexplanatorynotes} |
| 2342 |
% You can print explanatory notes at the end of each poem. |
| 2343 |
% To do this, issue |\makepoemendexplanatorynotes| just |
| 2344 |
% after |\begin{poem}|. Issue |\poemendexplanatorynote| where you wish to make a note, |
| 2345 |
% using the same conventions you use for |\textnote|. Where you want to output |
| 2346 |
% the notes, issue |\putpoemendexplanatorynotes|. These notes can have multi-line lemmas, |
| 2347 |
% just like textual notes.\end{sloppypar} |
| 2348 |
% |
| 2349 |
% By default, each poem end note is given its own paragraph. To concatenate |
| 2350 |
% them into one big paragraph, issue |\poemendexplanatorynotessingleparfalse|. |
| 2351 |
% |
| 2352 |
% \DescribeMacro{\poemendtextnote} |
| 2353 |
% \DescribeMacro{\makepoemendtextnotes} |
| 2354 |
% \DescribeMacro{\putpoemendtextnotes} |
| 2355 |
% You can print textual |
| 2356 |
% notes at the end of each poem. To do this, issue |\makepoemendtextnotes| just |
| 2357 |
% after |\begin{poem}|. Issue |\poemendtextnote| where you wish to make a note, |
| 2358 |
% using the same conventions you use for |\textnote|. Where you want to output |
| 2359 |
% the notes, issue |\putpoemendtextnotes|. These notes can have multi-line lemmas, |
| 2360 |
% just like textual notes. |
| 2361 |
% |
| 2362 |
% \DescribeMacro{\ifpoemendtextnotessinglepar} |
| 2363 |
% By default, each poem end note is given its own paragraph. To concatenate |
| 2364 |
% them into one big paragraph, issue |\poemendtextnotessingleparfalse|. |
| 2365 |
% |
| 2366 |
% \section{Printing endnotes and index} |
| 2367 |
% \DescribeMacro{\testforauxonfirstrun} If you don't want to listen to |
| 2368 |
% \LaTeX\ complain about missing references during your first run, |
| 2369 |
% issue |\testforauxonfirstrun|, which won't let |\finish|, |
| 2370 |
% |\putexplanatory|, |\puttextnotes|, or |\putemendations| run unless |
| 2371 |
% there is an .aux file for a previous run. \emph{Be sure to issue |
| 2372 |
% this command before issuing} |\begin{document}|, \emph{since that |
| 2373 |
% reads in the existing .aux file, and overwrites it with a new one.} |
| 2374 |
% |
| 2375 |
% \label{putexternalfiles} |
| 2376 |
% \DescribeMacro{\putemendations} This command closes the external file |
| 2377 |
% for emendations and reads it in. It also puts an entry for the |
| 2378 |
% emendations section into your table of contents. After |
| 2379 |
% |\putemendations| has read in the external file for emendations, you |
| 2380 |
% will need to run your file through \LaTeX\ again, to put the correct |
| 2381 |
% page number in the table of contents file. |
| 2382 |
% |
| 2383 |
% \DescribeMacro{\puttextnotes} |
| 2384 |
% \DescribeMacro{\putexplanatory} |\puttextnotes| and |
| 2385 |
% |\putexplanatory| do the same thing for the textual |
| 2386 |
% notes and for the explanatory notes. |
| 2387 |
% |
| 2388 |
% Each of these last three commands restores normal hyphenation. Since |
| 2389 |
% all three are printed with the |\small| font size, the hyphen |
| 2390 |
% character is defined only for that size. This should not create |
| 2391 |
% other issues, however, because the commands that prohibit |
| 2392 |
% hyphenation in the |poem| environment (and in the |contentsentry| |
| 2393 |
% environment) are local to those environments, so the restoration of |
| 2394 |
% the hyphen character may be redundant. |
| 2395 |
% |
| 2396 |
% \DescribeMacro{\putpoemindex} |\putpoemindex| reads in the index at |
| 2397 |
% this point, and adds an entry for the index to external file for the |
| 2398 |
% table of contents. |
| 2399 |
% |
| 2400 |
% \DescribeMacro{\putmultiplepoemindex} If you are generating |
| 2401 |
% several indices using \textsf{splitindex} |\putmultiplepoemindex| |
| 2402 |
% reads in one of them at this point. For instructions about this |
| 2403 |
% command, see section \ref{multipleindex}, p.~\pageref{multipleindex}. |
| 2404 |
% |
| 2405 |
% \DescribeMacro{\finish} The |
| 2406 |
% |\finish| command is deprecated but still available. It is designed |
| 2407 |
% to be placed just before |\end{document}| (which, in fact, it |
| 2408 |
% replaces --- but you should still put an |\end{document}| at the end |
| 2409 |
% of your document for form's sake). |\finish| closes the external |
| 2410 |
% files for the three notes sections and reads them back into the |
| 2411 |
% document (turning the automatic hyphenation back on for these |
| 2412 |
% sections). It adds entries to the table of contents file for the |
| 2413 |
% notes sections. It reads in the formatted index file (which you |
| 2414 |
% have made from your raw .idx file using MakeIndex between \LaTeX\ |
| 2415 |
% runs) and adds an entry for the index to the table of contents. |
| 2416 |
% Then it closes the external file for the table of contents and reads |
| 2417 |
% that in (putting it at the end of the document, as I explained |
| 2418 |
% before). Then it adds a page explaining that the symbol (by default |
| 2419 |
% *) at the bottom of certain pages marks places where a stanza break |
| 2420 |
% and a page break coincide. If you have an editor's introduction |
| 2421 |
% preceding your notes section, or a list of abbreviations, you may |
| 2422 |
% wish to consult the |\finish| command for suggestions about how to add |
| 2423 |
% the lines to read those files in and add entries for them in the |
| 2424 |
% table of contents. |
| 2425 |
% |
| 2426 |
% \section{Forewords, Appendices, Contents Entries} |
| 2427 |
% |
| 2428 |
% \DescribeMacro{\makeappendix} To make a an Appendix, or any other inserted |
| 2429 |
% prose section, use |\makeappendix|. |\makeappendix| takes one argument, the title. |
| 2430 |
% The new section will open on a recto page, and its first page will be in the empty page style. |
| 2431 |
% The title of the section will appear on the page in the style of the textual notes section. |
| 2432 |
% The title of the section will appear in the running header of subsequent pages. |
| 2433 |
% An entry for the new section, with the page number, |
| 2434 |
% will be added to the table of contents. The entry will |
| 2435 |
% be formatted the way the entries for textual notes and explanatory notes are formatted. |
| 2436 |
% |
| 2437 |
% \DescribeMacro{\appendixtitle} If you wish to add an Appendix which you don't |
| 2438 |
% want to start on a new page but do want |
| 2439 |
% to have a contents entry for, use |\appendixtitle| instead of |\makeappendix|. |
| 2440 |
% |
| 2441 |
% \DescribeMacro{\makesubappendix} |\makesubappendix| behaves exactly as |makeappendix| does, |
| 2442 |
% except the contents entry will be indented by the length |\subappendixtitleindentamount|. |
| 2443 |
% |
| 2444 |
% \DescribeMacro{\subappendixtitle} If you wish to add an Subappendix which you don't |
| 2445 |
% want to start on a new page but do want |
| 2446 |
% to have a contents entry for, use |\subappendixtitle| instead of |\makesubappendix|. |
| 2447 |
% |
| 2448 |
% \DescribeMacro{\appendixincontents} If you wish to suppress contents entries for |
| 2449 |
% appendices, issue the boolean |\appendixincontentsfalse|. Contents entries for |
| 2450 |
% appendices or subappendices will be suppressed so long as that boolean is set to false. |
| 2451 |
% |
| 2452 |
% |
| 2453 |
% \DescribeMacro{\makeforeword} |\makeforeword| and |\forewordtitle| behave basically the way |
| 2454 |
% |\makeappendix| and |\appendixtitle|. I provided separate commands because it occurred to |
| 2455 |
% me that one might want to treat front matter and back matter sections differently in the |
| 2456 |
% table of contents, so I have allowed for different indentations for their contents entries. |
| 2457 |
% |
| 2458 |
% \DescribeMacro{\pmclcontentsentry} \label{pmclcontentsentry} If you want to add a |
| 2459 |
% line to the table of contents that |
| 2460 |
% will follow the formatting of other entries in the contents, issue |\pmclcontentsentry|. |
| 2461 |
% |\pmclcontentsentry| takes three arguments. The first is the title you wish to put in the contents. |
| 2462 |
% The second is the length of the indentation to appear in the contents (usually |\contentsindentone|, |
| 2463 |
% |\contentsindenttwo|, or |\contentsindentthree|, but you can use any arbitrary length). |
| 2464 |
% The third argument is the page number. The argument could be a |\pageref| rather than a number. |
| 2465 |
% if you define the |\label| for that |\pageref| somewhere else in your file. |
| 2466 |
% |
| 2467 |
% |
| 2468 |
% \section{Special cases} |
| 2469 |
% \subsection{~Epigraphs, attributions etc.} \label{centerepigraphs} |
| 2470 |
% \DescribeMacro{\epigraph} \DescribeMacro{\headnote} |
| 2471 |
% \DescribeMacro{\attribution} \DescribeMacro{\poemdedication} |
| 2472 |
% |\epigraph|, |\headnote|, |\attribution|, and |\poemdedication| set |
| 2473 |
% their arguments as epigraphs, headnotes, attributions, or |
| 2474 |
% dedications for poems or poetic sequences. |
| 2475 |
% There are in addition the special commands |\JHepigraph| and |\JHdedication|, which place |
| 2476 |
% a mark in the margin |
| 2477 |
% showing where in the notes comments on that epigraph or dedication may be found. |
| 2478 |
% |
| 2479 |
% \DescribeMacro{\volumeepigraph} If you have dedications, epigraphs, or attributions on |
| 2480 |
% the divider pages of editions that combine several volumes of |
| 2481 |
% poetry, use |\volumededication|, |\volumeepigraph|, and |
| 2482 |
% |\volumeattribution|. |
| 2483 |
% |
| 2484 |
% \DescribeMacro{\centertitles} |
| 2485 |
% If |\centertitles| or |\centeritlescheme| is in effect, epigraphs, headnotes, dedications, |
| 2486 |
% and attributions will all be centered on the page. (|\volumeepigraph|, |\volumededication|, |
| 2487 |
% and |\volumeattribution|, however, are unaffected by |\centertitles|.) |
| 2488 |
% If your epigraph or headnote is a prose passage of more than one line, or |
| 2489 |
% of more than one paragraph, or a verse |
| 2490 |
% passage of more than line, or even more than one stanza, the |\epigraph| command will work |
| 2491 |
% properly if |\centertitles| is in effect, which is to say it will draw the margins in towards the center, |
| 2492 |
% rather than centering the epigraph line by line. |
| 2493 |
% |
| 2494 |
% Issuing |\centertitles| moves the margins in on both sides by the length |
| 2495 |
% |\centerepigraphindentation| (the default is 6em). The margins for |
| 2496 |
% uncentered epigraphs and the like are controlled by the length |\normalepigraphindentation| |
| 2497 |
% (the default is 1.5em). Both values can be adjusted by using |\setlength|. |
| 2498 |
% |
| 2499 |
% After issuing |\centertitles| you can move epigraphs and similar things back to the margin |
| 2500 |
% by issuing |\centerepigraphsonfalse|. After issuing |\centertitles| you can put titles at the margin |
| 2501 |
% while leaving epigraphs alone by issuing |\centertitlesonfalse|. |
| 2502 |
% |
| 2503 |
% If you use the standard \LaTeX\ |verse| |
| 2504 |
% environment within an epigraph, you may wish to add a |\smallskip| between |
| 2505 |
% stanzas. (To my eye that environment does not leave enough white space between |
| 2506 |
% stanzas.) Alternatively, you can use the special |pmclverse| environment. |
| 2507 |
% You can even use |
| 2508 |
% the |poem| environment, but if |
| 2509 |
% you do this, you should so mark line breaks with |\\| and stanza breaks |
| 2510 |
% with a blank line, as in the standard |verse| environment. If |
| 2511 |
% you mark up the epigraph with things like |\verseline| and |\end{stanza}| you may wind |
| 2512 |
% up with marginal line numbers in your epigraph. |
| 2513 |
% |
| 2514 |
% \begin{sloppypar}You |
| 2515 |
% may also wish to align epigraphs, dedications, attributions, or |
| 2516 |
% headnotes with the left margin of the verse block (even if you |
| 2517 |
% center the titles). To do this, issue |\leftalignepigraphstrue| to |
| 2518 |
% set the boolean |\ifleftalignepigraphs|. Remember that for |\leftalignepigraphstrue| to |
| 2519 |
% work, you will need to use the |\settowidth| command. Issue |
| 2520 |
% |\settowidth{\versewidth}{Text to be used for centering.}| just |
| 2521 |
% before you issue the |\poemtitle| command. |
| 2522 |
% |\leftalignepigraphstrue| will also align attributions, |
| 2523 |
% dedications, and other pre-texts of poems. \end{sloppypar} |
| 2524 |
% |
| 2525 |
% \DescribeMacro{\shortpoemepigraph} |
| 2526 |
% \DescribeMacro{\shortpoemdedication} |
| 2527 |
% \DescribeMacro{\shortpoemattribution} |
| 2528 |
% Because |\centerepigraphs| merely |
| 2529 |
% draws in the margins on both sides rather than centering each line |
| 2530 |
% line by line, short epigraphs may not appear |
| 2531 |
% well centered. |\shortpoemepigraph| |\shortpoemdedication| and |
| 2532 |
% |\shortpoemattribution|, are better for single line epigraphs, |
| 2533 |
% since they will center their arguments line by line. |
| 2534 |
% |
| 2535 |
% \begin{sloppypar} The commands |
| 2536 |
% |\shortpoemepigraph| |\shortpoemdedication| and |
| 2537 |
% |\shortpoemattribution| will all place their texts in |
| 2538 |
% accordance with the title placement scheme you select in your |
| 2539 |
% preamble. |
| 2540 |
% |\normaltitleindentationscheme| will place them near the left text |
| 2541 |
% margin. |
| 2542 |
% |\titlesatleftversemarginscheme| will place them at the left verse |
| 2543 |
% margin. |
| 2544 |
% |\titlescenteredonleftverseblockscheme| will center them over the |
| 2545 |
% longest line of a left-flushed verse block. |
| 2546 |
% |\titlesatleftmarginofcenteredblockscheme| will place them at the |
| 2547 |
% left margin of a centered verse block. |
| 2548 |
% |\centertitlesscheme| will center them over a centered verse block. |
| 2549 |
% You can center epigraphs and similar things on the page over an uncentered verse block |
| 2550 |
% by issuing the boolean |\centerepigraphson|. |
| 2551 |
% |
| 2552 |
% \DescribeMacro{\JHshortepigraph} |
| 2553 |
% I have also defined |
| 2554 |
% |\JHshortepigraph| and |\JHshortdedication|, which set marginal |
| 2555 |
% marks pointing to where notes on the epigraph or dedication in the textual notes section may be |
| 2556 |
% found, in the manner of |\JHpoemtitle|. |
| 2557 |
% These commands too obey the title placement scheme that may be in effect. \end{sloppypar} |
| 2558 |
% |
| 2559 |
% \subsection{~Appending publication date} |
| 2560 |
% \DescribeMacro{\poemdate} You can append the date of the poem |
| 2561 |
% with |\poemdate|. Issue |\poemdate| just after |\end{poem}|. You can |
| 2562 |
% include both the composition and publication date if you wish simply by |
| 2563 |
% including both dates in the argument. |
| 2564 |
% (In fact, you can put anything in the argument, not just dates.) By default |\poemdate| places the |
| 2565 |
% date one |\bigskip| under the left margin of the verse block of the poem, |
| 2566 |
% whether the poem is set at the left |
| 2567 |
% margin or whether the verse block is centered on the longest line. |
| 2568 |
% You can move the placement of the date left or right |
| 2569 |
% by changing the value of the length |\dateindent|. If you wish to change |
| 2570 |
% |\dateindent| you will have to issue |\setlength{\dateindent}{your value}| before |
| 2571 |
% each instance of |\poemdate|, since \textsf{poemscol} recalculates |
| 2572 |
% |\dateindent| freshly for every poem. |
| 2573 |
% |
| 2574 |
% There is a slight bug in |\poemdate|. If there is a page turn between the last line of the |
| 2575 |
% poem and the date, and the last line has a runover portion, the date will be set |
| 2576 |
% flush with the indented runover portion of the line rather than with the beginning |
| 2577 |
% of the line. This should not in practice |
| 2578 |
% be a problem, because you should use |\longpage| or several |\shortpage| commands |
| 2579 |
% to move the widowed date line anyway. |
| 2580 |
% (For |\longpage| and |\shortpage| see section \ref{longpage}, |
| 2581 |
% page \pageref{longpage}.) |
| 2582 |
% |
| 2583 |
% \subsection{~Pausing line numbering} |
| 2584 |
% \DescribeMacro{\saveverselinenumber} |
| 2585 |
% \DescribeMacro{\restoreverselinenumber} There are cases in which you |
| 2586 |
% might want to pause and resume line numbering later at the same number. |
| 2587 |
% For instance, you may have inset prose |
| 2588 |
% passages which do not take line numbers, but you wish to resume line numbering the verse |
| 2589 |
% after the passage. The way to set this is to issue |\end{stanza}| |
| 2590 |
% at the end of the stanza before the prose insert. Then issue |
| 2591 |
% |\saveverselinenumber|. Then issue |\end{poem}|. Insert the prose |
| 2592 |
% quotation (perhaps followed by |\attribution|). Then issue |
| 2593 |
% |\begin{poem}| followed by |\restoreverselinenumber| and |\begin{stanza}|. |
| 2594 |
% Then begin entering the rest of the poem as usual. Longer, independent prose |
| 2595 |
% sections (such as the author's preface or prose poems) require |
| 2596 |
% different handling. To provide line numbers and notes for such |
| 2597 |
% prose sections, see section \ref{prosesections}. |
| 2598 |
% |
| 2599 |
% \subsection{~Quoted verse} |
| 2600 |
% Sometimes you wish to quote verse within verse (as when a speaker |
| 2601 |
% in a verse play quotes a poem). \DescribeMacro{quotedverse} The |
| 2602 |
% |quotedverse| environment is designed for this contingency. If |
| 2603 |
% you issue |\verseline| commands or the |stanza| environment, line counting |
| 2604 |
% and annotation will proceed as usual in quoted verse. |
| 2605 |
% |
| 2606 |
% \subsection{~Multiline poem titles}\label{multilinetitles} |
| 2607 |
% \DescribeMacro{\poemtitlefirstline} |
| 2608 |
% \DescribeMacro{\poemtitlemiddleline} |
| 2609 |
% \DescribeMacro{\poemtitlelastline} |
| 2610 |
% Very long titles present special problems. In the first place, they |
| 2611 |
% require special provisions to make sure that page breaks don't |
| 2612 |
% happen in the middle of a title, or immediately after a title. In |
| 2613 |
% the second place, they raise questions about how the author wished |
| 2614 |
% to break them up over several lines. If you think it might matter, |
| 2615 |
% these commands make it possible for you to ensure that long titles are |
| 2616 |
% broken in exactly the same way in your text and in your table of |
| 2617 |
% contents. (I didn't pursue this question for titles in notes |
| 2618 |
% sections, and in notes sections these commands simply concatenate a |
| 2619 |
% long title.) |
| 2620 |
% |
| 2621 |
% There are similar commands for most but not all of the whole series of |
| 2622 |
% titles for sequences, sequence sections, sequence subsections, and so on. |
| 2623 |
% If you need commands for a kind of multi-line title that is not already |
| 2624 |
% defined, see below at section \ref{customizing titles}, page \pageref{customizing titles}. |
| 2625 |
% |
| 2626 |
% Alternatively, you can just let \textsf{poemscol} handle the long |
| 2627 |
% titles by itself. If you are pretty sure that the author did not |
| 2628 |
% care how long titles were broken up, this would probably be the |
| 2629 |
% best thing to do. Remember also that if \textsf{poemscol} breaks a |
| 2630 |
% title across two lines, you can always force it not break the line |
| 2631 |
% by using enclosing the argument to |\poemtitle| in an |\hbox|. You |
| 2632 |
% may get a complaint on your log file about an overfull |\hbox| if |
| 2633 |
% you do this, however. |
| 2634 |
% |
| 2635 |
% \subsection{~Poems in sections} |
| 2636 |
% |
| 2637 |
% \begin{sloppypar} |
| 2638 |
% \DescribeMacro{\poemsectiontitle} |
| 2639 |
% |\poemsectiontitle| and |\poemsubsectiontitle|, as their |
| 2640 |
% names imply, set their arguments as the titles of sections or subsections of poems. |
| 2641 |
% |\poemfirstsectiontitle| is for the first section |
| 2642 |
% of a poem with many sections. (It differs from |\poemsectiontitle| |
| 2643 |
% in that it tries to make it harder for a page break to separate the |
| 2644 |
% title of a poem from the title of its first section.) |
| 2645 |
% |\poemsectiontitlefirstline|, |\poemsectiontitlemiddleline|, |
| 2646 |
% |\poemsectiontitlelastline|, |\poemsectiontitlenocontents|, and |
| 2647 |
% |\poemsectiontitlebaretitle|), as their titles imply, are used for |
| 2648 |
% special cases such as long section titles, if you wish to specify |
| 2649 |
% explicitly how the title is to be broken up in the text and in the |
| 2650 |
% table of contents. You can construct variants of these commands for |
| 2651 |
% dealing with special cases I didn't anticipate by using |
| 2652 |
% the commands described in section \ref{customizing titles}. |
| 2653 |
%\end{sloppypar} |
| 2654 |
% |
| 2655 |
% \subsection{~Poetic sequences}\label{poeticsequences} |
| 2656 |
% |
| 2657 |
% \DescribeMacro{\sequencetitle} \DescribeMacro{\sequencesectiontitle} |
| 2658 |
% \DescribeMacro{\sequencefirstsectiontitle} |
| 2659 |
% \DescribeMacro{\sequencesubsectiontitle} Sequences of related |
| 2660 |
% poems, perhaps with an over-title, demand special handling in the |
| 2661 |
% text, in the notes sections, and in the table of contents. (A |
| 2662 |
% moment's thought will show that they are different in some ways from |
| 2663 |
% poems in sections. For one thing, a sequence manifests a different |
| 2664 |
% relationship between part and whole than a poem in sections does, |
| 2665 |
% and often provides stronger experiences of momentary closure between |
| 2666 |
% sections.) |\sequencetitle| sets its argument as the title of the sequence, |
| 2667 |
% |\sequencesectiontitle| sets the titles of the sections of the |
| 2668 |
% sequence, and |\sequencesubsectiontitle| sets the titles of |
| 2669 |
% subsections of the sequence (there is even a command for the title |
| 2670 |
% of sub-subsections, |\sequencesubsubsectiontitle|). |
| 2671 |
% |\sequencefirstsectiontitle| gives a little more |
| 2672 |
% vertical space between the main title and the first section title |
| 2673 |
% than |\sequencesectiontitle| gives between adjacent sections later |
| 2674 |
% on in the sequence (since the over-title for the sequence is in |
| 2675 |
% larger type) and adjusts the page breaking penalties to reflect the |
| 2676 |
% fact that such titles should not occur near the bottom of a page, |
| 2677 |
% since there should be no page break between the sequence title and |
| 2678 |
% the title of the first section of the sequence (although page breaks |
| 2679 |
% are permissible, indeed even slightly favored, between later |
| 2680 |
% sections). There should also never be a page break between a |
| 2681 |
% section title and the first or second line of the section. The |
| 2682 |
% penalties \textsf{poemscol} sets should take care of these |
| 2683 |
% automatically, but you may still have cases which require you to |
| 2684 |
% specify a page break with |\pagebreak| or |\newpage|. There are a |
| 2685 |
% host of other commands, all with self-explanatory titles, that deal |
| 2686 |
% with some special situations that arise in setting the elements of |
| 2687 |
% poetic sequences, such as cases where you wish to specify how long |
| 2688 |
% titles will be broken up into lines, or where you wish no entry to |
| 2689 |
% be made for the section in the table of contents or in the notes |
| 2690 |
% sections. These commands don't of course exhaust the dizzying |
| 2691 |
% possibilities, but from them you can construct whatever other commands |
| 2692 |
% you may need. |
| 2693 |
% |
| 2694 |
% Here is a list of all of the defined title commands. |
| 2695 |
% |
| 2696 |
% \begin{itemize} |
| 2697 |
% \item Commands for Poem titles |
| 2698 |
% \begin{itemize} |
| 2699 |
% \item |\poemtitle| |
| 2700 |
% \item |\poemtitlefirstline| |
| 2701 |
% \item |\poemtitlemiddleline| |
| 2702 |
% \item |\poemtitlelastline| |
| 2703 |
% \item |\poemsubtitle| |
| 2704 |
% \item |\poemtitlenotitle| |
| 2705 |
% \item |\poemtitlenocontents| |
| 2706 |
% \item |\poemtitlebaretitle| |
| 2707 |
% \item |\poemtitleonlycontents| |
| 2708 |
% \item |\poemtitleonlynotes| |
| 2709 |
% \end{itemize} |
| 2710 |
% \item Poems in Sections |
| 2711 |
% \begin{itemize} |
| 2712 |
% \item |\poemsectiontitle| |
| 2713 |
% \item |\poemsectiontitlefirstline| |
| 2714 |
% \item |\poemsectiontitlemiddleline| |
| 2715 |
% \item |\poemsectiontitlelastline| |
| 2716 |
% \item |\poemsectiontitlenocontents| |
| 2717 |
% \item |\poemsectiontitlebaretitle| |
| 2718 |
% \item |\poemfirstsectiontitle| |
| 2719 |
% \item |\poemfirstsectiontitlebaretitle| |
| 2720 |
% \item |\poemsubsectiontitle| |
| 2721 |
% \end{itemize} |
| 2722 |
% \item Sequence Titles |
| 2723 |
% \begin{itemize} |
| 2724 |
% \item |\sequencetitle| |
| 2725 |
% \item |\sequencetitlefirstline| |
| 2726 |
% \item |\sequencetitlemiddleline| |
| 2727 |
% \item |\sequencetitlelastline| |
| 2728 |
% \item |\sequencetitlenonotes| |
| 2729 |
% \end{itemize} \goodbreak |
| 2730 |
% \item Sequence Sections |
| 2731 |
% \begin{itemize} |
| 2732 |
% \item |\sequencesectiontitle| |
| 2733 |
% \item |\sequencesectiontitlenocontents| |
| 2734 |
% \item |\sequencesectiontitlenonotes| |
| 2735 |
% \item |\sequencesectiontitlebaretitle| |
| 2736 |
% \item |\sequencesectiontitlefirstline| |
| 2737 |
% \item |\sequencesectiontitlemiddleline| |
| 2738 |
% \item |\sequencesectiontitlelastline| |
| 2739 |
% \item |\sequencefirstsectiontitle| |
| 2740 |
% \item |\sequencefirstsectiontitlenocontents| |
| 2741 |
% \item |\sequencefirstsectiontitlenonotes| |
| 2742 |
% \item |\sequencefirstsectiontitlefirstline| |
| 2743 |
% \item |\sequencefirstsectiontitlemiddleline| |
| 2744 |
% \item |\sequencefirstsectiontitlelastline| |
| 2745 |
% \item |\sequencesectionsubtitle| |
| 2746 |
% \end{itemize} |
| 2747 |
% \item Sequence Subsections |
| 2748 |
% \begin{itemize} |
| 2749 |
% \item |\sequencesubsectiontitle| |
| 2750 |
% \item |\sequencesubsectiontitlenocontents| |
| 2751 |
% \item |\sequencefirstsubsectiontitle| |
| 2752 |
% \item |\sequencefirstsubsectiontitlenocontents| |
| 2753 |
% \item |\sequencesubsectiontitlefirstline| |
| 2754 |
% \item |\sequencesubsectiontitlemiddleline| |
| 2755 |
% \item |\sequencesubsectiontitlelastline| |
| 2756 |
% \item |\sequencefirstsubsectiontitlefirstline| |
| 2757 |
% \item |\sequencefirstsubsectiontitlemiddleline| |
| 2758 |
% \item |\sequencefirstsubsectiontitlelastline| |
| 2759 |
% |
| 2760 |
% \item |\sequencesubsubsectiontitle| |
| 2761 |
% \item |\sequencesubsubsectiontitlenocontents| |
| 2762 |
% \item |\sequencefirstsubsubsectiontitlenocontents| |
| 2763 |
% \end{itemize} |
| 2764 |
% \end{itemize} |
| 2765 |
% |
| 2766 |
% \subsection{~Titles with marginal markers} |
| 2767 |
% \DescribeMacro{\JHpoemtitle} |
| 2768 |
% In his edition of the poetry of Jos\'e Maria Heredia, Tilmann |
| 2769 |
% Altenberg placed a marker in the margin next to poem titles with a |
| 2770 |
% reference to where in the apparatus notes on that poem could be |
| 2771 |
% found. To do this, use the |\JHpoemtitle| command. This command |
| 2772 |
% takes two arguments: first, the title of the poem, second, the label |
| 2773 |
% used by the |\label| command on the page of the notes section to |
| 2774 |
% which the title refers. So, you would issue the poem title command |
| 2775 |
% this way: |\JHpoemtitle{Los desvelados}{EP_LosDesvelados_AC}|. |
| 2776 |
% |
| 2777 |
% (Up to |
| 2778 |
% version 2.49 of \textsf{poemscol} you had to be sure to define the |
| 2779 |
% label in the notes sections by issuing |
| 2780 |
% |\literaltextnote{\label{EP_LosDesvelados_AC}}|. This is no longer |
| 2781 |
% necessary, and |\JHpoemtitle| defines both the |\label| and the |
| 2782 |
% |\pageref|.) |
| 2783 |
% |
| 2784 |
% Instructions are given in section \ref{JHpoemtitle}, |
| 2785 |
% p.~\pageref{JHpoemtitle} for how to construct similar commands for |
| 2786 |
% sequences, sequence sections, and so on. |
| 2787 |
% The following related commands are defined already: |
| 2788 |
% \begin{itemize} |
| 2789 |
% \item |\JHsequencetitle| \item |\JHsequencefirstsectiontitle| |
| 2790 |
% \item |\JHsequencesectiontitle| \item |\JHsequencesubsectiontitle| |
| 2791 |
% \item |\JHpoemsectiontitle| \item |\JHpoemfirstsectiontitle| |
| 2792 |
% \item |\JHpoemsubtitle| \item |\JHepigraph| \item |\JHprosesectiontitle| |
| 2793 |
% \item |\JHdedication| \end{itemize} |
| 2794 |
% |
| 2795 |
% |
| 2796 |
% \DescribeMacro{\setmargpoemtitle} |
| 2797 |
% |\setmargpoemtitle| is a more general version of |
| 2798 |
% |\JHpoemtitle|, with the second argument being any commands you |
| 2799 |
% want to be issued just after the title is processed. |
| 2800 |
% |
| 2801 |
% \DescribeMacro{\margreftextnote}\label{margreftextnote} |
| 2802 |
% Another feature of Altenberg's Heredia edition is a marginal mark |
| 2803 |
% attached to lines to which text notes refer showing where in the |
| 2804 |
% apparatus a comment upon that line is to be found. |
| 2805 |
% |\margreftextnote| sets a label in the textual notes section, and |
| 2806 |
% sets a marginal note with a page reference to that label in the main text. Issue |
| 2807 |
% |\margreftextnote| \emph{before} issuing the |\verseline| or |
| 2808 |
% |\end{stanza}| that closes the line to which it refers. (The textual |
| 2809 |
% note itself can be an ordinary |\textnote|, and should be placed, as |
| 2810 |
% usual, \emph{after} the |\verseline| or |\end{stanza}|.) |
| 2811 |
% |
| 2812 |
% |\margreftextnote| generates its own label, so there is no need to |
| 2813 |
% make up one yourself. |
| 2814 |
% |
| 2815 |
%\begin{sloppy} |
| 2816 |
% |\margreftextnote| and its siblings use a |
| 2817 |
% new kind of insert, |\JHmarginpar|, to set the marginal marks. |
| 2818 |
% This is so that you can control the placement of these marks |
| 2819 |
% independently of how you place the line numbers (which use |
| 2820 |
% |\pmclsidepar|) or other marginal marks you may define using |
| 2821 |
% |\marginpar|. |
| 2822 |
% |
| 2823 |
% Horizontal placement of the mark is controlled by the |
| 2824 |
% length |\JHmarginparsep|, which is set by default to 0 pt. Vertical |
| 2825 |
% placement of the marginal mark for a textual note, relative to the baseline, is set by |
| 2826 |
% the length |\JHmarginparvshift|, which is set by default to 0 pt. |
| 2827 |
% The horizontal placement of the |
| 2828 |
% marginal mark set by |\JHpoemtitle|, and its siblings, however, |
| 2829 |
% is controlled by the length |\JHtitlemarginparsep|. |\JHtitlemarginparsep| |
| 2830 |
% is set by default to value of |\JHmarginparsep|, |
| 2831 |
% so that the two |
| 2832 |
% kinds of mark |
| 2833 |
% should align with each other by default. |
| 2834 |
% \end{sloppy} |
| 2835 |
% |
| 2836 |
% By default these marginal references are placed in the right |
| 2837 |
% margin. If you wish to set them in the left margin, issue the |
| 2838 |
% command |\JHmarksleft|. If you wish to place them back into the |
| 2839 |
% right margin, issue the command |\JHmarksright|. |
| 2840 |
% If you wish the |
| 2841 |
% marks to aways be in the outer margin, issue the command |
| 2842 |
% |\JHmarksouter|. If you wish the marks to always be in the inner |
| 2843 |
% margin, issue |\JHmarksgutter|. (The marks for titles and the marks for |
| 2844 |
% notes always appear on the same side of the page, and the different |\JHmarks| commands |
| 2845 |
% always move both kinds of mark.) |
| 2846 |
% |
| 2847 |
% If you are centering the verse block on the longest line, the verse |
| 2848 |
% line numbers normally move in towards the verse block. (To center |
| 2849 |
% the verse block on the longest line, see section |
| 2850 |
% \ref{centeringtextblock}.) The marginal |
| 2851 |
% marks for |\margeftextnote| do not do this, since they are designed to |
| 2852 |
% line up with the marginal mark produced by |\JHpoemtitle|. You can change |
| 2853 |
% the alignment if you wish by changing the value of either the length |\JHmarginparsep|, |
| 2854 |
% which controls the placement of marginal marks for notes, or changing the value |
| 2855 |
% of the length |\JHtitlemarginparsep|, which controls the placement of the marginal |
| 2856 |
% marks for titles. |
| 2857 |
% |
| 2858 |
% \begin{sloppypar} |
| 2859 |
% If you define a new endnote type using |\definenewnotetype|, |
| 2860 |
% |\definenewnotetype| will also define a new |\margref| command to go |
| 2861 |
% with it. So, for example, if you define a new note type called |
| 2862 |
% |\mynote|, you will automatically also define a ``margref'' command |
| 2863 |
% called |\margrefmynote| which will place a mark in the margin with |
| 2864 |
% a label showing where in the end notes sections the text of that |
| 2865 |
% |\mynote| can be found. \end{sloppypar} |
| 2866 |
% |
| 2867 |
% \DescribeMacro{\setmargrefmarker} Altenberg's edition used a ding |
| 2868 |
% from the pifonts collection in the marginal marks made by |
| 2869 |
% |\margreftextnote| and its siblings. I have set the default to |
| 2870 |
% |\dag|, so as not to depend upon yet another style package. You can |
| 2871 |
% choose another mark using |\setmargrefmarker| (e.g.\ |
| 2872 |
% |\setmargrefmarker{\ding{228}}|). |
| 2873 |
% |
| 2874 |
% \DescribeMacro{\settitlemargrefmarker} Altenberg's edition also used a |
| 2875 |
% different marker for marginal marks for the titles of poems from that used |
| 2876 |
% for marginal marks made by |\margreftextnote|. By default that marker |
| 2877 |
% is |\dag|, but you can change it by using |\settitlemargrefmarker|, |
| 2878 |
% |
| 2879 |
% \DescribeMacro{\margrefemendation} |\margrefemendation| is a |
| 2880 |
% version of |\margreftextnote| for emendations. |
| 2881 |
% |
| 2882 |
% \DescribeMacro{\margrefexplanatory}|\margrefexplanatory| is a |
| 2883 |
% version of |\margreftextnote| for explanatory notes. |
| 2884 |
% |
| 2885 |
% \subsection{~Titles with footnotes} |
| 2886 |
% In James Benstead's edition of the collected poems of Hugh |
| 2887 |
% MacDiarmid, many of the titles of the poems have footnotes by the |
| 2888 |
% author. Under most circumstances, one can put a note about the title |
| 2889 |
% in the textual notes section simply by, after the |\begin{poem}| |
| 2890 |
% command, issuing something like this: |\literaltextnote{title] text of note}|. |
| 2891 |
% (One can make similar notes for the explanatory notes |
| 2892 |
% section or for the emendations section.) But MacDiarmid's notes are |
| 2893 |
% authorial, not editorial, and should be considered part of the |
| 2894 |
% title. At the same time, the notes should not be printed in the Table |
| 2895 |
% of Contents, nor for that matter in the endnotes sections. |
| 2896 |
% |
| 2897 |
% \DescribeMacro{\footnotepoemtitle} |\footnotepoemtitle| is for the default |
| 2898 |
% case. It takes two arguments. The first argument is the title of |
| 2899 |
% the poem. The second is the text of the footnote. |
| 2900 |
% |
| 2901 |
% \begin{sloppypar} |
| 2902 |
% \DescribeMacro{\footnotepoemtitlefirstline} |
| 2903 |
% |\footnotepoemtitlefirstline| |\footnotepoemtitlemiddleline| and |
| 2904 |
% |\footnotepoemtitlelastline| are for long titles in which how the |
| 2905 |
% author broke up the title on the page matters, and one or more of |
| 2906 |
% the lines has a footnote. These commands also take two arguments, |
| 2907 |
% of which the first is the title line and the second is the text of |
| 2908 |
% the footnote. You can intersperse these commands with |
| 2909 |
% |\poemtitlefirstline| |
| 2910 |
% |\poemtitlemiddleline| or |\poemtitlelastline| (depending on which |
| 2911 |
% line has the footnote). The lines will be broken in the same way in |
| 2912 |
% the text and in the table of contents. \end{sloppypar} |
| 2913 |
% |
| 2914 |
% \DescribeMacro{\footnotesplitpoemtitle} |\footnotesplitpoemtitle| |
| 2915 |
% is for the most general case. Use it if there is a footnote in the middle |
| 2916 |
% of the title, or if you have a long title and don't need to ensure |
| 2917 |
% that it is broken in the text and in the table of contents in the |
| 2918 |
% same way. |\footnotesplitpoemtitle| takes three arguments. The first |
| 2919 |
% argument is the first part of the title, up to the footnote mark, |
| 2920 |
% the second is the text of the footnote, and the third is the rest |
| 2921 |
% of the title. |
| 2922 |
% |
| 2923 |
% I have not created footnoted titles for sequences, sequence |
| 2924 |
% sections, and so on. But if you compare how those titles are |
| 2925 |
% defined in the implementation section below and how footnoted |
| 2926 |
% titles are defined at \ref{footnotetitles} |
| 2927 |
% (page \pageref{footnotetitles}), how to write those commands should be clear. |
| 2928 |
% |
| 2929 |
% You can control where the footnotes for footnoted titles are placed. |
| 2930 |
% By default, those footnotes are conventional footnotes (and all |
| 2931 |
% their parameters are set in the way normal \LaTeX\ footnotes are |
| 2932 |
% set). You can force the default setting by issuing the command |
| 2933 |
% |\maketitlefootnotesplain| in your preamble. If you are setting |
| 2934 |
% your textual notes or other notes at the foot of the page using |
| 2935 |
% ``layers'' of footnotes, you can treat these footnotes as just |
| 2936 |
% another layer by issuing the command |\maketitlefootnoteslayered| in |
| 2937 |
% your preamble. (``Layered'' footnotes are described at section \ref{makingfootnotes}, |
| 2938 |
% page \pageref{makingfootnotes}.) If you wish to place these footnotes at the end of |
| 2939 |
% the poem, you must issue |\maketitlefootnotesatpoemend| in the |
| 2940 |
% preamble. Just before you declare a title with a footnote, issue |
| 2941 |
% |\makepoemendnotes|, and just after issuing |\end{poem}| for that |
| 2942 |
% poem, issue |\putpoemendnotes|. |
| 2943 |
% |
| 2944 |
% \subsection{~Empty poem titles and italicized poem titles} |
| 2945 |
% |
| 2946 |
% \DescribeMacro{\poemtitlenotitle} |
| 2947 |
% |\poemtitlenotitle|, with its paradoxical name, is for poems |
| 2948 |
% without formal titles. Usually such poems are referred to by their |
| 2949 |
% first lines. This command does not produce a title in the text, but |
| 2950 |
% sets its argument in the table of contents and in the notes. Usually |
| 2951 |
% you use the first line as the moral equivalent of a title. |
| 2952 |
% |
| 2953 |
% \DescribeMacro{\poemtitleitalic} |
| 2954 |
% Titles |
| 2955 |
% with italics or other special formatting posed special problems in |
| 2956 |
% earlier versions (before version 1.7) since the typesetting commands |
| 2957 |
% gummed up how I passed parameters around that I was unable to solve |
| 2958 |
% using |\protect|. All of these commands are obsolete now, but are |
| 2959 |
% retained for backward compatibility. |
| 2960 |
% |\poemtitleitalic| takes |
| 2961 |
% two arguments. The first is the title of the poem with the italics |
| 2962 |
% (or small capitals or international characters or what have you), |
| 2963 |
% for typesetting, and the second is the title without the commands, |
| 2964 |
% for cross reference purposes. (Actually, now that \textsf{poemscol} |
| 2965 |
% no longer needs to treat italics in titles in a different way, it can |
| 2966 |
% be anything you want, since the second argument is discarded.) |
| 2967 |
% |
| 2968 |
% \begin{sloppypar} |
| 2969 |
% \DescribeMacro{\poemtitlenotitleitalic} |
| 2970 |
% |\poemtitlenotitleitalic|, with its doubly paradoxical name, |
| 2971 |
% is for poems without formal titles but with italicized words in their |
| 2972 |
% first lines. |\poemtitlenotitleitalic| takes two arguments. The |
| 2973 |
% first is the first line with the italics (for typesetting |
| 2974 |
% purposes), and the second is the |
| 2975 |
% first line without the italics (for crossreference purposes). This command |
| 2976 |
% is obsolete now that italics in titles no longer require special |
| 2977 |
% handing, but is retained for backwards compatibility.\end{sloppypar} |
| 2978 |
% |
| 2979 |
% \subsection{~Problem titles} |
| 2980 |
% \DescribeMacro{\poemtitlebaretitle} |
| 2981 |
% \DescribeMacro{\poemtitleonlycontents} |
| 2982 |
% \DescribeMacro{\poemtitleonlynotes} |
| 2983 |
% If you have a problem title, one for instance |
| 2984 |
% in which the title in the text might cause problems in the contents or in the notes, |
| 2985 |
% you can send information |
| 2986 |
% separately to the places it will be used. |
| 2987 |
% For example, a user planned to attach a footnote to a poem title, |
| 2988 |
% but didn't want the mark or the text of the |
| 2989 |
% note to show up in the contents or in the endnotes. I would usually |
| 2990 |
% have advised him to use |\sources| to send the text of the note to the endnotes, |
| 2991 |
% but he really wanted the title to include the footnote mark and to put the footnote |
| 2992 |
% on the same page. The solution to this problem |
| 2993 |
% was to set the title in the text separately from setting it in the notes and in the contents. |
| 2994 |
% |\poemtitlebaretitle|, for instance simply sets the title in the text. Then |
| 2995 |
% you can use |\poemtitleonlycontents| to send the title to the contents |
| 2996 |
% and |\poemtitleonlynotes| to send the title to the notes. These commands |
| 2997 |
% are defined for poem titles, and for some but not all of the whole range of titles including |
| 2998 |
% sequence titles, sequence section titles, sequence section subtitles, and so on. But |
| 2999 |
% it would be easy to roll your own versions of these commands by looking below at |
| 3000 |
% section \ref{customizing titles}, page \pageref{customizing titles}, or at the |
| 3001 |
% models in the code below at section \ref{poemtitlecode}, page \pageref{poemtitlecode}. |
| 3002 |
% |
| 3003 |
% \DescribeMacro{\poemtitlenocontents} |
| 3004 |
% \DescribeMacro{\poemtitlenonotes} |
| 3005 |
% \DescribeMacro{\poemtitlenotitle} |
| 3006 |
% There are also commands to send information to any two of the relevant locations |
| 3007 |
% but not the third. |\poemtitlenocontents| sends the title to the text and to the notes, |
| 3008 |
% but not to the contents. |\poemtitlenonotes| sends the title to the text and to the |
| 3009 |
% contents, but not to the notes. |\poemtitlenotitle| sends the title to the contents and the |
| 3010 |
% notes, but not to the main text. |
| 3011 |
% |
| 3012 |
% Remember that in the last resort, you can send information to the contents section |
| 3013 |
% with |\literalcontents|. To actually set a contents entry using |\literalcontents| is a tall order, |
| 3014 |
% however, since you would have to include all the information from the |\c@ntentsinfo| command |
| 3015 |
% for the relevant type of title. (For what |\c@ntentsinfo| does, |
| 3016 |
% see section \ref{customizing titles}, below.) |
| 3017 |
% For instance, for a poem called |
| 3018 |
% Test Poem, that would be: |
| 3019 |
% |
| 3020 |
% \begin{verbatim} |
| 3021 |
% \literalcontents{\setlength\contentsentryoverrun{\contentsindenttwoamount } |
| 3022 |
% \begin{contentsentryenvironment} |
| 3023 |
% \contentsindentone |
| 3024 |
% {\contentspoemtitlefont |
| 3025 |
% Test |
| 3026 |
% Poem} |
| 3027 |
% \contentsleaders |
| 3028 |
% \pageref{testpoemlabel} % pick a unique label |
| 3029 |
% \end{contentsentryenvironment} |
| 3030 |
% \par} |
| 3031 |
% \end{verbatim} |
| 3032 |
% |
| 3033 |
% Another tricky thing about this method is the |\pageref| line in the above, which is a pageref to find |
| 3034 |
% and set in the contents the number of the |
| 3035 |
% page the poem appears on. You should put |\label{testpoemlabel}|, with any unique |
| 3036 |
% text for the label (so long as it is the same one used in the |\pageref| line), |
| 3037 |
% on the page of the text where the poem occurs, in order to capture |
| 3038 |
% the correct page number. (Alternatively, you could just put the actual page number in |
| 3039 |
% what you send to the contents with |\literalcontents| instead of the pageref line, but you will |
| 3040 |
% have to remember to change this number if anything changes in your edition.) |
| 3041 |
% |
| 3042 |
% Remember also that you can send information to the relevant notes sections using |
| 3043 |
% |\literaltextnote|, |\literalexplain|, and |\literalemend|. |
| 3044 |
% |
| 3045 |
% |
| 3046 |
% \subsection{~Customizing titles} \label{customizing titles} \textsf{poemscol} provides a large |
| 3047 |
% number of ways of setting titles, but conceivably you may wish to |
| 3048 |
% define your own. Here is a template for designing a new kind of |
| 3049 |
% title. Suppose you wish to create a kind of title called |
| 3050 |
% |\mytitle|. It would take one argument, which would be the title |
| 3051 |
% itself. The command defining the |\mytitle| command should call three commands, |
| 3052 |
% |\set@p@emtitle|, to set the title in the main text and make the |
| 3053 |
% label for use by the contents and notes sections, |\c@ntentsinfo| to |
| 3054 |
% set the title in the table of contents, and |\t@xtnotesinfo|, which |
| 3055 |
% sets the title in the notes sections. (You should enclose the whole thing |
| 3056 |
% between |\makeatletter| and |\makeatother|.) |
| 3057 |
% |
| 3058 |
%\DescribeMacro{\set@p@emtitle} |
| 3059 |
% |\set@p@emtitle| |
| 3060 |
% takes six arguments, which are, in order, (1) the title (which, if |
| 3061 |
% you are calling this command inside of the definition of |\mytitle| |
| 3062 |
% should just be |#1|), (2) commands to be issued before setting the |
| 3063 |
% title (minimally, a penalty, such as |\poemtitlepenalty|), (3) the |
| 3064 |
% font size in which the title is to be set in the text (such as |
| 3065 |
% |\poemtitlefont| or |\large|), (4) any indentation of the title |
| 3066 |
% (|\relax| for |\poemtitle|, or |\titleindent| for |
| 3067 |
% |\sequencesectiontitle|), (5) commands to be issued after the |
| 3068 |
% title is set (such as |\afterpoemtitleskip|) and (6) the amount |
| 3069 |
% overrun lines in the title should be indented. |
| 3070 |
% |
| 3071 |
%\DescribeMacro{\c@ntentsinfo} |
| 3072 |
%|\c@ntentsinfo| takes |
| 3073 |
% four arguments, which are, in order, (1) the title, (2) the |
| 3074 |
% indentation of the title in the table of contents (such as |
| 3075 |
% |\contentsindentone|), (3), the font size in which the title |
| 3076 |
% should be set (such as |\contentspoemtitlefont|) and (4) the amount |
| 3077 |
% overrun lines in the table of contents should be indented (such as |
| 3078 |
% |\contentsindenttwoamount|). |
| 3079 |
% |
| 3080 |
% \DescribeMacro{\t@xtnotesinfo} |
| 3081 |
% |\t@xtnotesinfo| |
| 3082 |
% takes one argument, the title. |
| 3083 |
% |
| 3084 |
% So, for example, to create a new kind of title called |\mytitle| which looks |
| 3085 |
% just like |\poemtitle|, issue |
| 3086 |
% \begin{verbatim} |
| 3087 |
% \makeatletter |
| 3088 |
% \newcommand{\mytitle}[1]{% |
| 3089 |
% \set@p@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}% |
| 3090 |
% {\relax}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\z@}% |
| 3091 |
% \c@ntentsinfo{#1}{\contentsindentone}{\contentspoemtitlefont}% |
| 3092 |
% {\contentsindenttwoamount}% |
| 3093 |
% \t@xtnotesinfo{#1}% |
| 3094 |
% } |
| 3095 |
% \makeatother |
| 3096 |
% \end{verbatim} |
| 3097 |
% |
| 3098 |
% (The |\z@| which is the sixth argument to |\set@p@emtitle| above is |
| 3099 |
% a constant set to zero. You will also notice that I became completely hysterical |
| 3100 |
% on the subject of preventing a page break after a poem title.) |
| 3101 |
|
| 3102 |
% By default, \textsf{poemscol} |
| 3103 |
% does not indent the overrun portion of titles relative to the first |
| 3104 |
% line of the title, but if that first line is indented will set the |
| 3105 |
% overrun portions to be indented the same amount. Overrun portions |
| 3106 |
% of titles in the table of contents will be indented by one |
| 3107 |
% |\contentsindentamount| more than the first line is indented. Both |
| 3108 |
% of these behaviors can be changed by changing the arguments to |
| 3109 |
% |\set@p@emtitle| or |\c@ntentsinfo|. |
| 3110 |
% |
| 3111 |
%\DescribeMacro{\firstlinesettings} |
| 3112 |
%\DescribeMacro{\middlelinesettings} |
| 3113 |
%\DescribeMacro{\lastlinesettings} |
| 3114 |
%\DescribeMacro{\restoresinglelinesettings} |
| 3115 |
% If you wish to design a title which might have multiple lines, |
| 3116 |
% and you wish to specify how those lines are broken up, you |
| 3117 |
% will need to write three commands: one for the first line, one for |
| 3118 |
% middle lines, and one for the last lines. |
| 3119 |
% (This only matters if you care how the title is broken up. You |
| 3120 |
% can choose to let \LaTeX\ do the breaking if you wish.) Before issuing |
| 3121 |
% |\set@p@emtitle| issue |\firstlinesettings|, |\middlelinesettings|, |
| 3122 |
% or |\lastlinesettings| (as the case may require). And issue |
| 3123 |
% |\restoresinglelinesettings| last of all in each of your three |
| 3124 |
% commands. The lines will be broken in the table of contents and in |
| 3125 |
% the body of the text in the same way, but will be run in in the |
| 3126 |
% notes sections. |
| 3127 |
% |
| 3128 |
% \subsection{~Customizing indentations in titles in the text body}\label{customtitleindentations} |
| 3129 |
% Titles of poems, subtitles, titles of sequences, sections of sequences (and subsections and so on), |
| 3130 |
% appear in the text with a hierarchy of indentations. If you want to change anything |
| 3131 |
% about these indentations, you don't need to modify the various title-setting commands, but only to |
| 3132 |
% change the length of the relevant indentation command. I |
| 3133 |
% have given the indentations for each class of title a defined length, which you can change |
| 3134 |
% by changing the definition of the indentation command. (e.g. |
| 3135 |
% |\renewcommand{\poemtitleindent}{\hspace{3em}}.)| For many of these |
| 3136 |
% indentations you can also simply change the applicable length (e.g. |
| 3137 |
% |\setlength{\sequencesubtitleindentmount}{\titleindenttwoamount}|. ) |
| 3138 |
% |
| 3139 |
% The ``amount'' part in the command |
| 3140 |
% is important. |\poemtitleindentamount| is a length. On the other |
| 3141 |
% hand, |\sequencesectiontitleindentindent| is a command, defined |
| 3142 |
% defined as\\ |
| 3143 |
% |\hspace{\sequencesectiontitleindenttitleindentamount}|. \\ |
| 3144 |
% The table lists all the commands for these |
| 3145 |
% indentations. In the table ``Extra Lines'' refers to the indentation for the second and third lines |
| 3146 |
% (and so on) of multi-line titles. If you wish to change the |
| 3147 |
% indentation of any of the titles whose default length is listed as |
| 3148 |
% 0 in the table, you must use the |\renewcommand| method. (I |
| 3149 |
% found that setting the length of one of the indentations to 0pt |
| 3150 |
% added a few points of white space I could not figure out how to get |
| 3151 |
% rid of, so by default those commands are defined not by using a |
| 3152 |
% length but by, for example, |\newcommand{\poemtitleindent}{\relax}|.) |
| 3153 |
% |
| 3154 |
%\begin{table}[t] |
| 3155 |
%\caption{Indentations in Titles} |
| 3156 |
%\bigskip |
| 3157 |
%{\scriptsize |
| 3158 |
%\begin{tabular}{l l l} |
| 3159 |
%\hline |
| 3160 |
%Entity Title & Indentation & Default Length\\ |
| 3161 |
%\hline |
| 3162 |
%Volume & |\volumetitleindentamount| & |0pt| \\ |
| 3163 |
%Extra Lines & |\volumetitlesecondlineindentamount| & |0pt| \\ |
| 3164 |
%Volume Subtitle & |\volumesubtitleindentamount| & |\titleindentamount| (1pc)\\ |
| 3165 |
%Extra Lines & |\volumesubtitlesecondlineindentamount| & |\titleindentamount| \\ |
| 3166 |
%Volume Section & |\volumesectiontitleindentamount| & |0pt| \\ |
| 3167 |
%Extra Lines & |\volumesectiontitlesecondlineindentamount| & |0pt| \\ |
| 3168 |
%Poem & |\poemtitleindentamount| & |0pt| \\ |
| 3169 |
%Extra Lines & |\poemtitlesecondlineindentamount| & |0pt| \\ |
| 3170 |
%Poem Subtitle & |\poemsubtitleindentamount| & |\titleindentamount| \\ |
| 3171 |
%Poem Section & |\poemsectiontitleindentamount| & |\titleindentamount| \\ |
| 3172 |
%Extra Lines & |\poemsectiontitlesecondlineindentamount| & |\titleindentamount| \\ |
| 3173 |
%Poem Subsection & |\poemsubsectiontitleindentamount| & | \titleindenttwoamount| \\ |
| 3174 |
%Sequence & |\sequencetitleindentamount| & |0pt| \\ |
| 3175 |
%Extra Lines & |\sequencetitlesecondlineindentamount| & |0pt| \\ |
| 3176 |
%Sequence Subtitle & |\sequencesubtitleindent | & |\titleindentamount| \\ |
| 3177 |
%Extra Lines & |\sequencesubtitlesecondlineindentamount| & |\titleindentamount| \\ |
| 3178 |
%Sequence Section & |\sequencesectiontitleindentamount| & |\titleindentamount| \\ |
| 3179 |
%Extra Lines & |\sequencesectiontitlesecondlineindentamount| & |\titleindentamount| \\ |
| 3180 |
%Sequence Section Subtitle & |\sequencesectionsubtitleindentamount| & |\titleindenttwoamount| \\ |
| 3181 |
%Extra Lines & |\sequencesectionsubtitlesecondlineindentamount| & |\titleindenttwoamount| \\ |
| 3182 |
%Sequence Subsection & |\sequencesubsectiontitleindentamount| & |\titleindenttwoamount| \\ |
| 3183 |
%Sequence Subsubsection & |\sequencesubsubsectiontitleindentamount| & |\titleindentathreeamount| \\ |
| 3184 |
%Appendix & |\appendixtitleindentamount| & |0pt| \\ |
| 3185 |
%SubAppendix & |\subappendixtitleindentamount| & |\titleindentamount| \\ |
| 3186 |
%Foreword & |\forewordtitleindentamount| & |0pt| \\ |
| 3187 |
%Notes Sections & |\notestitleindentamount| & |0pt| |
| 3188 |
%\end{tabular}} |
| 3189 |
%\end{table} |
| 3190 |
% |
| 3191 |
% \subsection{~Customizing indentations in titles in the Contents}\label{contentsindentations} |
| 3192 |
% There is also a hierarchy of indentations for titles in the Table of Contents. Again, |
| 3193 |
% to change the indentations in the Contents, you don't need to redefine the title-setting |
| 3194 |
% commands, only to change the value of the relevant length. The table shows the hierarchy |
| 3195 |
% of indentations in the Table of Contents: |
| 3196 |
% |
| 3197 |
%\begin{table}[t] |
| 3198 |
%\caption{Indentations in Contents} |
| 3199 |
%\bigskip |
| 3200 |
%{\scriptsize |
| 3201 |
%\begin{tabular}{l l l} |
| 3202 |
%\hline |
| 3203 |
%Entity Title & Indentation & Default Length\\ |
| 3204 |
%\hline |
| 3205 |
%Volume & |\contentsvolumetitleindentamount| & |0pt| \\ |
| 3206 |
%Extra Lines & |\contentsvolumetitlesecondlineindentamount| & |0pt| \\ |
| 3207 |
%Volume Subtitle & |\contentsvolumesubtitleindentamount| & |\contentsindentoneamount| (24pt)\\ |
| 3208 |
%Extra Lines & |\contentsvolumesubtitlesecondlineindentamount| & |\contentsindentoneamount| \\ |
| 3209 |
%Volume Section & |\contentsvolumesectiontitleindentamount| & |0pt| \\ |
| 3210 |
%Extra Lines & |\contentsvolumesectiontitlesecondlineindentamount| & |0pt| \\ |
| 3211 |
%Poem & |\contentspoemtitleindentamount| & |\contentsindentoneamount| \\ |
| 3212 |
%Extra Lines & |\contentspoemtitlesecondlineindentamount| & |\contentsindentoneamount| \\ |
| 3213 |
%Poem Section & |\contentspoemsectiontitleindentamount| & |\contentsindenttwoamount| \\ |
| 3214 |
%Extra Lines & |\poemsectiontitlesecondlineindentamount| & |\contentsindenttwoamount| \\ |
| 3215 |
%Sequence & |\contentssequencetitleindentamount| & |\contentsindentoneamount|\ \\ |
| 3216 |
%Extra Lines & |\contentssequencetitlesecondlineindentamount| & |\contentsindentoneamount| \\ |
| 3217 |
%Sequence Section & |\contentssequencesectiontitleindentamount| & |\contentsindenttwoamount| \\ |
| 3218 |
%Extra Lines & |\contentssequencesectiontitlesecondlineindentamount| & |\contentsindenttwoamount| \\ |
| 3219 |
%Sequence Subsection & |\contentssequencesubsectiontitleindentamount| & |\contentsindentthreeamount| \\ |
| 3220 |
% Sequnce Subsubsection & Does not appear in Contents & \\ |
| 3221 |
%Appendix or Foreword & |\contentsappendixtitleindentamount| & |0pt| \\ |
| 3222 |
%Notes Sections & |\contentsnotestitleindentamount| & |0pt| |
| 3223 |
% |
| 3224 |
%\end{tabular}} |
| 3225 |
%\end{table} |
| 3226 |
% |
| 3227 |
% \subsection{~Visual formatting} |
| 3228 |
% \DescribeMacro{\longpage} |
| 3229 |
% \DescribeMacro{\shortpage} |
| 3230 |
% \label{longpage} |
| 3231 |
% The ideal in \LaTeX\ is to separate |
| 3232 |
% content markup and formatting as completely as possible. In the text |
| 3233 |
% itself you simply mark the logical units (a poem, a title, a stanza, |
| 3234 |
% a textual note), and a header program (like \textsf{poemscol}) interprets the |
| 3235 |
% meaning of those terms typographically. However, one still winds up |
| 3236 |
% having to do some visual formatting. Especially in prose sections, |
| 3237 |
% such as in the textual notes, you will sometimes have to enlarge or |
| 3238 |
% shrink a page by one line in order to avoid an intractable widow or |
| 3239 |
% club line, and when one does so one must be careful to do the same to |
| 3240 |
% the other member of the two-page spread of which that page is a part |
| 3241 |
% so that the spread will be properly balanced. |
| 3242 |
% These commands enable one to wiggle pagelength enough to handle these |
| 3243 |
% problems. Since verse sections should be set with |\raggedbottom| |
| 3244 |
% in effect, the commands are not necessary in verse sections. |
| 3245 |
% |
| 3246 |
% |\longpage| and |\shortpage| are cumulative: issuing |\longpage| twice lengthens the |
| 3247 |
% page by two lines, and issuing |\shortpage| twice shortens the page by two lines. |
| 3248 |
% |
| 3249 |
% \section{Customizing page geometry and page styles} |
| 3250 |
% |
| 3251 |
% |
| 3252 |
% \subsection{~Font sizes, skips, sinks, indents, and penalties} |
| 3253 |
% |
| 3254 |
% \label{changingfontsandleading} |
| 3255 |
% \textsf{poemscol} sets the font sizes, but not the typeface, of |
| 3256 |
% fonts for many common tasks, in order to create a hierarchy of |
| 3257 |
% sizes. They can be changed with a |\renewcommand| of the following |
| 3258 |
% form, where the first number is the font size in points and the |
| 3259 |
% second is the leading:\\ |
| 3260 |
% |\renewcommand{\volumetitlefont}{\fontsize{18}{23}\selectfont}| |
| 3261 |
% |
| 3262 |
% |
| 3263 |
% The following table gives the default values for the fonts. The titles of |
| 3264 |
% the fonts give their uses. Backmatterheaderfont is for setting the |
| 3265 |
% titles of back matter sections. Sequence section titles use |
| 3266 |
% poemtitlefont. Backmattertext font is |\small|, backmatterintrofont |
| 3267 |
% is |\normalsize|. |
| 3268 |
% \bigskip |
| 3269 |
% |
| 3270 |
% \begin{tabular}{l l l} |
| 3271 |
% \textbf{Font} & \textbf{Size} & \textbf{Leading} \\ |
| 3272 |
% volumetitlefont & 18 & 23 \\ |
| 3273 |
% volumesubtitlefont & 14 & 18 \\ |
| 3274 |
% poemtitlefont & 14 & 18 \\ |
| 3275 |
% sequencetitlefont & 16 & 20 \\ |
| 3276 |
% subsectiontitlefont & 12 & 14.5 \\ |
| 3277 |
% backmatterheaderfont & 16 & 20 \\ |
| 3278 |
% backmattervolumefont & 12 & 14.5 \\ |
| 3279 |
% backmattervolumesubtitlefont & 11 & 13 \\ |
| 3280 |
% contentsvolumefont & 13 & 20 \\ |
| 3281 |
% contentsvolumesubtitlefont & 12 & 14.5 \\ |
| 3282 |
% contentssequencetitlefont & 10 & 14 \\ |
| 3283 |
% contentspoemtitlefont & 10 & 14 \\ |
| 3284 |
% \end{tabular} |
| 3285 |
% |
| 3286 |
% \bigskip |
| 3287 |
% |
| 3288 |
% The following table gives various skips, sinks, penalties, and indentations. The |
| 3289 |
% titles of these should be self-explanatory. These should be changed |
| 3290 |
% with |\renewcommand| as follows:\\ |
| 3291 |
% |\renewcommand{\volumetitlesink}{\leavevmode\vspace{23.5pt}}| |
| 3292 |
% \bigskip |
| 3293 |
% |
| 3294 |
% \begin{tabular}{l l l} |
| 3295 |
% \textbf{Name} & \textbf{Argument} & \textbf{Comment} \\ |
| 3296 |
% backmattersink & 21.5pt & \relax \\ |
| 3297 |
% backmatterafterheadersink & 11pt& \relax \\ |
| 3298 |
% afterpoemtitleskip & |\smallskip| & \relax \\ |
| 3299 |
% afterpoemskip & |\bigskip| & \relax \\ |
| 3300 |
% aftersequencetitleskip & |\medskip| & \relax \\ |
| 3301 |
% stanzaskip & |\medskip| & Extra skip between stanzas \\ |
| 3302 |
% titleindent & |\titleindentamount| (1pc) & use |\setlength| to |
| 3303 |
% change \\ |
| 3304 |
% parindent & |\titleindentamount| & \relax \\ |
| 3305 |
% volumetitleshift & |\volumetitleshiftamount| (1pc) & use |\setlength| to |
| 3306 |
% change \\ |
| 3307 |
% contentsindentone & 24pt & \relax \\ |
| 3308 |
% contentsindenttwo & 42pt & \relax \\ |
| 3309 |
% contentsindentthree & 60pt & \relax \\ |
| 3310 |
% contentsindentfour & 72pt & \relax \\ |
| 3311 |
% runoverindentvalue & 6em & for runover lines in verse\\ |
| 3312 |
% verseindent & 2em & for formally indented lines\\ |
| 3313 |
% notesclubpoempenalty & -300 & \relax \\ |
| 3314 |
% notessequenceclubpenalty & -1500 & \relax \\ |
| 3315 |
% notesvolumetitlepenalty & -1500 & \relax \\ |
| 3316 |
% epigraphquoteleftmargin & 1.5em & for epigraphs, attributions, etc.\\ |
| 3317 |
% epigraphquoterightmargin & 1.5em & \relax \\ |
| 3318 |
% \end{tabular} |
| 3319 |
% |
| 3320 |
% \subsection{~Customizing page styles} |
| 3321 |
% \textsf{poemscol} sets several default page styles, defined |
| 3322 |
% below. The main page style is ``fancy,'' which is used for |
| 3323 |
%the main body of the poetry, |
| 3324 |
% prose frontmatter (such as introductions), and the endnotes sections. |
| 3325 |
% ``Volumefirststyle'' is for the |
| 3326 |
% first page of a volume of poems. ``Volumetitlestyle'' is for the |
| 3327 |
% title page of a volume of poems. The external file for the table of |
| 3328 |
% contents redefines ``fancy,'' so you should issue |\resetpagestyle| |
| 3329 |
% after issuing |\putpoemcontents|. |\resetpagestyle| resets the page |
| 3330 |
% style to ``main'' (which is the same as the original ``fancy''). |
| 3331 |
% |
| 3332 |
% Because |\putpoemcontents| resets the page style to ``main,'' any page style you defined |
| 3333 |
% in the preamble becomes forgotten if you include a table of contents. There are two |
| 3334 |
% possible solutions to this. The first is to define your page style after you have issued |
| 3335 |
% |\putpoemcontents|. The second is to redefine the fancypage style ``main,'' so that it does |
| 3336 |
% what you want. In either case, do not forget to issue |\pagenumbering{arabic}| |
| 3337 |
% after |\putpoemcontents|, else all of your page numbers will be in roman numerals. |
| 3338 |
% You can find the default |
| 3339 |
% definitions of those ``fancy'' and ``main'' below at \ref{pagestyledefs}, page \pageref{pagestyledefs}. |
| 3340 |
% |
| 3341 |
%\begin{sloppypar} |
| 3342 |
% You can change the text in the left (verso) running head |
| 3343 |
% by issuing |\leftheader{your header}| or |\volumeheader{your header}|. (The commands |
| 3344 |
% are synonyms.) You can change the text in the right (recto) running head by issuing |
| 3345 |
% |\rightheader{your header}|. \end{sloppypar} |
| 3346 |
% |
| 3347 |
% \subsection{~Special page style for long poems} The fancy page style ``longpoem'' |
| 3348 |
% will add information of the form ``firstline--lastline'' to the running header. This |
| 3349 |
% page style otherwise resembles ``main,'' and ``fancy.'' |
| 3350 |
% Issue |\pagestyle{longpoem}| to use this page style. If you use ``longpoem,'' be sure to |
| 3351 |
% call \textsf{etex} and \textsf{emarks} in your preamble. Also, when a poem ends, be sure |
| 3352 |
% to issue |\newpage|, otherwise the running header will list the first line on the page from the |
| 3353 |
% first poem and the last line on the page from the second poem. |
| 3354 |
% |
| 3355 |
% If you use ``longpoem'' and you have a table of contents, you must issue |
| 3356 |
% |\pagestyle{longpoem}| at some point \emph{after} issuing |\putpoemcontents|. |
| 3357 |
% Do not forget to issue |\pagenumbering{arabic}| |
| 3358 |
% after |\putpoemcontents|, else all of your page numbers will be in roman numerals. Also, if you |
| 3359 |
% have back matter, you must issue |\pagestyle{main}| at the end of your poetry section, |
| 3360 |
% before the back matter starts, since otherwise your header will include the last line |
| 3361 |
% number \textsf{poemscol} saw. Issuing |\pagestyle{main}| will restore the normal page |
| 3362 |
% headers for the backmatter |
| 3363 |
% sections. |
| 3364 |
% |
| 3365 |
% \begin{sloppypar} |
| 3366 |
% The header will include the abbreviation l.\ (for a single line) or ll.\ (for a range of lines). |
| 3367 |
% You can change either abbreviation with |\changesinglelineabbrev| or |
| 3368 |
% |\changemultiplelineabbrev|. So, for instance, to get rid of the abbreviations |
| 3369 |
% entirely, issue |\changemultiplelineabbrev{\relax}| and |\changesinglelineabbrev{\relax}|. |
| 3370 |
% \end{sloppypar} |
| 3371 |
% |
| 3372 |
% \begin{sloppypar} |
| 3373 |
% You may need to play with |\leftheader| and |\rightheader| to get the information you |
| 3374 |
% want into the header. You might, for instance, what to use something like |
| 3375 |
% |\leftheader{``Your main title'' \hfil ``Your poem title''}| and |
| 3376 |
% |\rightheader{``Your volume title'' \hfil ``Your poem title''}|. Whatever else you put into |
| 3377 |
% the header, the last thing should be your poem title, since it will be followed by the line |
| 3378 |
% numbers.\end{sloppypar} |
| 3379 |
% |
| 3380 |
% \subsection{~Page geometry and type leading} |
| 3381 |
% |
| 3382 |
% You have to give geometry the values that suit you. I include the |
| 3383 |
% values I used in my own book, just to give you a starting place. |
| 3384 |
% The default values for marginparsep and |
| 3385 |
% marginparwidth are different now (18pt and 18pt respectively). With |
| 3386 |
% that warning, here is a list of the values I used: |
| 3387 |
% |
| 3388 |
% \bigskip |
| 3389 |
% |
| 3390 |
% \begin{tabular}{l l} |
| 3391 |
% textheight&6.75in\\ |
| 3392 |
% marginparsep&18pt\\ |
| 3393 |
% marginparwidth&18pt\\ |
| 3394 |
% headheight& 14pt\\ |
| 3395 |
% paperwidth&6in\\ |
| 3396 |
% paperheight& 9in\\ |
| 3397 |
% inner&4.5pc\\ |
| 3398 |
% outer&4.5pc\\ |
| 3399 |
% footskip&15pt\\ |
| 3400 |
% \end{tabular} |
| 3401 |
% |
| 3402 |
%\bigskip |
| 3403 |
% |
| 3404 |
%% |
| 3405 |
% In my own book I also, strictly to save money, and at the price of |
| 3406 |
% some ugliness, changed the definition of |\normalsize| and |\small|, |
| 3407 |
% so that the former was 10 pt type on 11 pt leading (rather than 12 |
| 3408 |
% pt), and that the latter was 9 pt type on 10 pt leading. You can |
| 3409 |
% reproduce this setting by issuing |\tightleading|, although I would |
| 3410 |
% advise not doing so unless you are under financial constraints. |
| 3411 |
% |
| 3412 |
% \section{Prose Sections with line numbers} \label{prosesections} |
| 3413 |
% \subsection{Setup} |
| 3414 |
%\textsf{poemscol} |
| 3415 |
% uses the \textsf{lineno} package to make marginal line numbers for |
| 3416 |
% prose sections such as the Author's Introduction, Afterword, |
| 3417 |
% Author's Notes, or such prose interludes or prose poems the volume |
| 3418 |
% may include. To control the appearance, placement, and frequency of |
| 3419 |
% marginal line numbers in prose sections, you may wish to consult the |
| 3420 |
% manual to \textsf{lineno}. I have added a minimal user interface to |
| 3421 |
% make \textsf{lineno} cohere with poemscol. You may have to fiddle |
| 3422 |
% with the parameters of both \textsf{poemscol} and \textsf{lineno} to |
| 3423 |
% persuade them to set marginal line numbers that look the same way in |
| 3424 |
% prose and verse contexts. The default values should work as is. |
| 3425 |
% |
| 3426 |
% Line numbers in prose sections are placed using a different |
| 3427 |
% |\length| from that used in verse sections. Essentially, verse |
| 3428 |
% sections, and prose sections which use paragraph and sentence |
| 3429 |
% numbering --- see below, in section \ref{paragraphsentence} --- |
| 3430 |
% place the marginal line numbers using |\marginparsep|. Prose |
| 3431 |
% sections which are numbered by line use |\linenumbersep| instead, |
| 3432 |
% which is a length defined in the \textsf{lineno} package. I have |
| 3433 |
% given values for both lengths which seem to place line numbers on |
| 3434 |
% the left and on the right side in prose sections roughly where they |
| 3435 |
% are placed in verse sections. You can change these values with |
| 3436 |
% |\setcounter{countername}{length}|. |
| 3437 |
% |
| 3438 |
% |\verselinenumberstoleft| and |\verselinenumberstoright| also place |
| 3439 |
% the line numbers to the left or to the right, respectively, in prose |
| 3440 |
% sections. If you wish the numbering to appear on a different side |
| 3441 |
% in prose contexts you can set the side by issuing |\leftlinenumbers| |
| 3442 |
% or |\rightlinenumbers|. These last are commands from the |
| 3443 |
% \textsf{lineno} package. The two forms in which line numbers switch |
| 3444 |
% sides in prose contexts can't at the moment be used, because of a |
| 3445 |
% clash between how \textsf{lineno} handles line numbers that switch |
| 3446 |
% sides and the way I pass the line numbers to notes sections. If you |
| 3447 |
% have set the verse line numbers to switch sides, prose line numbers |
| 3448 |
% will appear on the right side. I hope soon to find a workaround for |
| 3449 |
% this problem. |
| 3450 |
% |
| 3451 |
% By default, the line modulo for prose sections is the same as that for |
| 3452 |
% verse sections; if you have a line number every 5 lines in verse, |
| 3453 |
% you will have the same in prose. You can set the prose line modulo |
| 3454 |
% independently with |\setprosemodulo|. |
| 3455 |
% |
| 3456 |
% \textsf{poemscol} may deal with rather long stretches of prose, but |
| 3457 |
% it is not designed to be used for critical editions of extended |
| 3458 |
% prose texts, as \texttt{EDMAC}, \textsf{reledmac}, or \textsf{ednotes} |
| 3459 |
% are. The method of entering line ranges into notes in prose |
| 3460 |
% contexts is something of a hack, and rather a worse one than the one |
| 3461 |
% employed in verse contexts, since it involves using two labels for |
| 3462 |
% each note, one to capture the line number of the beginning, the |
| 3463 |
% other to capture the line number of the end. Other limitations of |
| 3464 |
% this method may show up with longer prose extracts. |
| 3465 |
% |
| 3466 |
% \DescribeMacro{\prosesectiontitle} Prose sections may be titled with |
| 3467 |
% |\prosesectiontitle| which is essentially just |\poemtitle|, or |
| 3468 |
% |\prosesectiontitlenotitle|, which is essentially just |
| 3469 |
% |\poemtitlenotitle|. (Remember that if you use the latter command, |
| 3470 |
% you must specify a ``dummy'' title to use in the note and contents |
| 3471 |
% sections.) They will be formatted in the notes and contents |
| 3472 |
% sections as poems are. Alternatively, you can use |
| 3473 |
% the commands for defining new kinds of titles, in section |
| 3474 |
% \ref{customizing titles}, page \pageref{customizing titles}, |
| 3475 |
% to make new kinds of titles for prose sections. |
| 3476 |
% |
| 3477 |
%\DescribeMacro{prosesection} |
| 3478 |
% Prose sections should be enclosed in a |prosesection| environment |
| 3479 |
% (between |\begin{prosesection}| and |\end{prosesection}|). Entering |
| 3480 |
% this environment sets the modulo repeat for line numbering to the |
| 3481 |
% same value that prevails in verse contexts, and resets the prose |
| 3482 |
% line number to zero. If for some reason you do not wish to reset |
| 3483 |
% the line number but continue on from where it left off at the end of |
| 3484 |
% the last prose section, use the |prosesectionnoreset| environment |
| 3485 |
% instead. |
| 3486 |
% |
| 3487 |
% \DescribeMacro{\setprosemodulo} |
| 3488 |
% If you wish to set the modulo repeat for line numbering in prose to |
| 3489 |
% some value different for that from verse contexts, issue the new |
| 3490 |
% modulo as the argument to |\setprosemodulo|. |
| 3491 |
% |
| 3492 |
% It is possible, if a prose section is interpolated in the midst of |
| 3493 |
% verse, to number the prose and verse continuously. To move from a |
| 3494 |
% verse passage to a prose passage, just before the |\end{poem}| at |
| 3495 |
% the end of the first verse passage issue |\saveverselinenumber| to |
| 3496 |
% save the number of the verse passage. After you issue |
| 3497 |
% |\begin{prosesection}| issue |
| 3498 |
% |\resetlinenumber[\theverselineumberscratch]| to apply that number |
| 3499 |
% to the prose section. To number continuously while moving from |
| 3500 |
% prose to verse is more tricky. One way might be to mark a label at |
| 3501 |
% the end of the prose passage with |\proselinelabel{prose end label}| |
| 3502 |
% (or some other suitably unique label). This label will record the |
| 3503 |
% line number of the last prose line. Pass that value to |
| 3504 |
% |\restoreverselinenumber| by issuing |
| 3505 |
% |\setcounterfromref{verselinenumberscratch}{prose end label}|. Then |
| 3506 |
% issue |\restoreverselinenumber| just after issuing the |
| 3507 |
% |\begin{poem}| that restarts the verse again. I would recommend |
| 3508 |
% against numbering verse and prose continuously, however, since a |
| 3509 |
% verse line and a prose line are different categories of thing, the |
| 3510 |
% one being an element of prosody, the other being only an element of |
| 3511 |
% typography. |
| 3512 |
% |
| 3513 |
% |
| 3514 |
% \DescribeMacro{\proselinelabel} |
| 3515 |
% |\proselinelabel| is simply |\linelabel| from \textsf{lineno}. I |
| 3516 |
% have provided the new name to make it easy to distinguish from |
| 3517 |
% |\poemlinelabel|. |
| 3518 |
% |
| 3519 |
% |
| 3520 |
% \subsection{Endnotes for prose sections} |
| 3521 |
% \begin{sloppypar} |
| 3522 |
% \DescribeMacro{\prosetextnote} |
| 3523 |
% \DescribeMacro{\prosemendation} |
| 3524 |
% \DescribeMacro{\proseexplanatory} |
| 3525 |
% Special versions of |\textnote|, |\emendation| and |\explanatory| |
| 3526 |
% are available for use in prose sections. |\prosetextnote|, |
| 3527 |
% |\proseemendation|, and |\proseexplanatory| differ from the verse |
| 3528 |
% versions in that they each require an extra argument, a unique label |
| 3529 |
% to be used in locating the line number for use by the notes |
| 3530 |
% commands. If |\maketextnotes|, |\makeemendations|, or |
| 3531 |
% |\makeexplanatorynotes| have been issued, the endnotes will be sent |
| 3532 |
% to the usual sections, where all the notes from that prose section |
| 3533 |
% will be grouped into a paragraph, with the entry headed by the title |
| 3534 |
% given by |\prosesectiontitle|, just as if that were the title of a |
| 3535 |
% poem. |\textnotesatfoot|, |\emendationsatfoot|, and |
| 3536 |
% |\explanationsatfoot| will send the notes from prose contexts to the |
| 3537 |
% usual footnote levels. Notes commands in prose contexts take three |
| 3538 |
% arguments. As in verse sections, in prose sections textnotes, |
| 3539 |
% explanatory notes, and emendations have an optional first argument |
| 3540 |
% for recording line ranges. As in verse sections, you can record |
| 3541 |
% these line ranges either by simply putting in the argument how many |
| 3542 |
% lines the lemma will refer to (a deprecated method retained for |
| 3543 |
% backward compatibility reasons), or the argument of a |
| 3544 |
% |\proselinelabel| command on the last line of the lemma. (The only |
| 3545 |
% difference from the verse version here is that you should make the |
| 3546 |
% label using the |\proselinelabel| command, rather than with the |
| 3547 |
% |\poemlinelabel| command.) The second argument is a label to |
| 3548 |
% identify each note uniquely, which is used to find the line number |
| 3549 |
% at which the note begins. You will need a different label for |
| 3550 |
% every note. The third argument is the text of the note, which |
| 3551 |
% should include both the lemma and the rest of the note, as in the |
| 3552 |
% notes for verse sections. |
| 3553 |
% |\proseemendation| and |
| 3554 |
% |\proseexplanatory| are coded the same way. So, if you wished |
| 3555 |
% to make a textual note on a passage that begins with ``Call me |
| 3556 |
% Ishmael.'' and ends ``a way of driving away the spleen,'' you would |
| 3557 |
% issue at the point where the note is to |
| 3558 |
% occur (at the beginning of the passage): |
| 3559 |
% \begin{verbatim} |
| 3560 |
% \prosetextnote[a way of driving away the spleen] {Call me Ishmael} |
| 3561 |
% {Call me Ishmael \ldots\ a way of driving away the spleen] text of |
| 3562 |
% textual note} \end{verbatim} On the |
| 3563 |
% last line of the passage to which the note refers you would |
| 3564 |
% issue: \\ |\proselinelabel{a way of driving away the spleen}|.\end{sloppypar} |
| 3565 |
% |
| 3566 |
% \DescribeMacro{\prosetsvariant} |
| 3567 |
% \DescribeMacro{\proseaccidental} |
| 3568 |
% \DescribeMacro{\prosetsaccidental} |
| 3569 |
% You can issue |\sources| and |\tsentry| in prose contexts as usual. |
| 3570 |
% For typescript variants and accidental variants you need to issue |
| 3571 |
% |\prosetsvariant|, |\proseaccidental|, and |
| 3572 |
% |\prosetsaccidental|. |\prosetsvariant| is entered just as |
| 3573 |
% |\prosetextnote| is, with an optional argument (for use with |
| 3574 |
% line ranges, as usual), and two mandatory arguments (the first a |
| 3575 |
% label to capture the line number, the second the lemma and comment). |
| 3576 |
% |
| 3577 |
% |\proseaccidental| and |\prosetsaccidental| take only the two |
| 3578 |
% mandatory arguments, since by definition an accidental variant is |
| 3579 |
% confined to one line. |
| 3580 |
% |
| 3581 |
% One caveat: because the line numbers for notes in prose contexts |
| 3582 |
% are generated by a label/ref mechanism, each note will result in a |
| 3583 |
% complaint about an undefined reference the first time the file is run through |
| 3584 |
% \LaTeX. Either run the first pass in quiet mode, or be prepared to |
| 3585 |
% ignore a lot of griping until |
| 3586 |
% \LaTeX\ has generated the .aux file at the end of the first run. |
| 3587 |
% |
| 3588 |
% \section{Paragraph and sentence annotation}\label{paragraphsentence} |
| 3589 |
% \subsection{~Setup} |
| 3590 |
% Annotating a prose section by sentence number, or by paragraph number and |
| 3591 |
% sentence number, has some advantages over annotating it by line |
| 3592 |
% number. The principal advantage is that the annotation and reference |
| 3593 |
% system can remain stable over multiple editions, even if they are set |
| 3594 |
% in different formats. The most familiar of such systems is the |
| 3595 |
% chapter and verse system in the Bible, introduced by Archbishop |
| 3596 |
% Stephen Langton in the thirteenth century (who divided the Vulgate |
| 3597 |
% edition into numbered chapters) and by Robert Estienne in the |
| 3598 |
% sixteenth century (who added the verse numbers). Such a form of |
| 3599 |
% annotation might be especially useful for medieval prosimetra, a form |
| 3600 |
% combining verse and prose. (Hence the commands that follow often |
| 3601 |
% begin with |pm|.) |
| 3602 |
% |
| 3603 |
% \DescribeMacro{pmsection} |
| 3604 |
% You should put prose marked up for sentence and paragraph |
| 3605 |
% annotation in a |pmsection| environment. |
| 3606 |
% You do not need to put prose marked up for sentence and paragraph |
| 3607 |
% annotation in a |prosesection| environment. That environment is |
| 3608 |
% only needed if you are line-numbering prose. You also do not need |
| 3609 |
% to load the \textsf{lineno} package if you are using the sentence |
| 3610 |
% and paragraph system for annotating prose. You might, however, |
| 3611 |
% still wish to set the title with |\prosesectiontitle|. |
| 3612 |
% |
| 3613 |
% \DescribeMacro{\setprosebysentence} |
| 3614 |
% |\setprosebysentence| sets \textsf{poemscol} to number prose by |
| 3615 |
% sentence rather than by line number. This command is mostly a |
| 3616 |
% placeholder now, used only for setting the value of |\marginparsep| |
| 3617 |
% to something better for prose. (|\marginparsep| sets how far the |
| 3618 |
% line numbers are from the text block.) |\verselinenumberstoleft|, |
| 3619 |
% |\verselinenumberstoright|, and |\verselinenumbersswitch| each pick |
| 3620 |
% convenient values for |\marginparsep|. By default these values all |
| 3621 |
% line up on the page, but if you change any of them, you may have to |
| 3622 |
% use reset |\marginparsep| to some value you will have to find by |
| 3623 |
% trial and error, since they each use |\marginparsep| in slightly |
| 3624 |
% different ways. You can change |\marginparsep| either by using |
| 3625 |
% |\setlength{\marginparsep}{length}| or, better, by using |
| 3626 |
% |\renewcommand| to change the setting of |\marginparsep| in |
| 3627 |
% |\verselinenumberstoleft| or whatever else you intend to use. Adjust |
| 3628 |
% |\headoffsetlength| to make the page numbers line up with the line numbers. |
| 3629 |
% |
| 3630 |
% |
| 3631 |
% \DescribeMacro{\pmsentence} Each sentence must begin with |
| 3632 |
% |\pmsentence|. |\pmsentence| increments the sentence counter, |
| 3633 |
% optionally puts the sentence number in the running text, and |
| 3634 |
% optionally puts the sentence number in the margin. |
| 3635 |
% |
| 3636 |
% |\runningsentencenumberstrue| |
| 3637 |
% sets sentence |
| 3638 |
% numbers in the running text. |
| 3639 |
% To set sentence numbers in the margin, issue |
| 3640 |
% |\marginsentencenumberstrue|. You can issue both, either, or neither of |
| 3641 |
% these commands. |
| 3642 |
% |
| 3643 |
% \DescribeMacro{\setpmmodulo} If you are putting sentence numbers in |
| 3644 |
% the margin, you need not number every sentence. Indeed, if there is |
| 3645 |
% more than one sentence on a line, the numbers will overwrite each |
| 3646 |
% other (unless you use the marn.sty package, and substitute |\marn| |
| 3647 |
% for |\pmclrightsidepar|, |\pmclleftsidepar| or |\pmclsidepar| in the |
| 3648 |
% code for |\pmsentence|). You can also avoid overlapping sentence |
| 3649 |
% numbers by using |\pmsentencetwo| and its siblings, defined below. |
| 3650 |
% You can set the modulo for sentence marginal numbers by issuing |
| 3651 |
% |\setpmmodulo|. |
| 3652 |
% |
| 3653 |
% \DescribeMacro{\pmsentencetwo} |
| 3654 |
% \DescribeMacro{\pmsentencethree} |
| 3655 |
% \DescribeMacro{\pmsentencefour} If you know, from a prior run, |
| 3656 |
% that there will be a second or third sentence on some particular |
| 3657 |
% line, marking them with these commmands will ensure that the |
| 3658 |
% marginal sentence numbers do not overwrite each other. These commands |
| 3659 |
% are something of a kludge, but they will do until I figure out how |
| 3660 |
% to do this better.\newpage |
| 3661 |
% |
| 3662 |
% \DescribeMacro{\pmnumberstoright} |
| 3663 |
% \DescribeMacro{\pmnumberstoleft} |
| 3664 |
% \DescribeMacro{\pmnumbersgutter} |
| 3665 |
% \DescribeMacro{\pmnumbersouter} |
| 3666 |
% If you wish to control the |
| 3667 |
% margin in which sentence and paragraph numbers appear, issue |
| 3668 |
% |\pmnumbersright|, |\pmnumbersleft|, |\pmnumbersgutter|, or |
| 3669 |
% |\pmnumbersouter|. By default, these numbers will line up with the |
| 3670 |
% line numbers in verse sections. If you change the value of |
| 3671 |
% |\marginparsep| for prose sections from those used by their verse |
| 3672 |
% equivalents, it is a good idea to issue the verse equivalent command |
| 3673 |
% (|\versenumberstoright| or whatever) again when you move from a |
| 3674 |
% prose to a verse environment. |
| 3675 |
% |
| 3676 |
% \begin{sloppypar} |
| 3677 |
% |\runningsentencenumberformat| sets the format of running sentence |
| 3678 |
% numbers. Currently it is |\textsuperscript| (the numbers are set as superscripts) and |\tiny|. |
| 3679 |
% The format of marginal sentence |
| 3680 |
% numbers is set by |\marginsentencenumberformat|. Currently it is |
| 3681 |
% |\tiny|. Definitions of both commands are found at section \ref{runningsentencenumberformat}, |
| 3682 |
% page \pageref{runningsentencenumberformat}. You can change either with |\renewcommmand|. |
| 3683 |
%\end{sloppypar} |
| 3684 |
% |
| 3685 |
% \DescribeMacro{\pmpara} |
| 3686 |
% \DescribeMacro{\pmsentencebypara} |
| 3687 |
% \DescribeMacro{\pmsparainmartrue} |
| 3688 |
% \DescribeMacro{\pmpararunningtrue} |
| 3689 |
% You can also number paragraphs. Each paragraph must begin with |
| 3690 |
% |\pmpara|. |\pmpara| increments the paragraph counter, optionally |
| 3691 |
% puts the paragraph number in the running text, and optionally puts |
| 3692 |
% the paragraph number in the margin. To reset the sentence counter |
| 3693 |
% at the beginning of each paragraph, issue |\pmsentencebyparatrue| in |
| 3694 |
% your preamble. To set paragraph numbers in the margin, issue |
| 3695 |
% |\pmparainmartrue|. To set paragraph numbers in the running text, |
| 3696 |
% issue |\pmpararunningtrue|. You can issue both, either, or neither of |
| 3697 |
% these last two commands. Which margin these numbers are set in |
| 3698 |
% is controlled by the same commands that control placement of |
| 3699 |
% marginal sentence numbers. |
| 3700 |
% |
| 3701 |
% If you begin a paragraph with |\pmpara| \textsf{poemscol} will |
| 3702 |
% assume that you intend to include the paragraph number in your |
| 3703 |
% notes (in the form \textless \emph{paragraph |
| 3704 |
% number}\textgreater:\textless \emph{sentence number}\textgreater\ for simple |
| 3705 |
% references, or \textless \emph{first paragraph |
| 3706 |
% number}\textgreater:\textless \emph{first sentence number}\textgreater\ -- |
| 3707 |
% \textless \emph{lastparagraph |
| 3708 |
% number}\textgreater:\textless \emph{last sentence number}\textgreater\ |
| 3709 |
% for ranges of sentences) even if you do not reset |
| 3710 |
% the sentence number at the beginning of each paragraph. Normally |
| 3711 |
% you would not issue |\pmpara| if you are not resetting the sentence |
| 3712 |
% number at the beginning of each paragraph, since under those |
| 3713 |
% circumstances you don't really need to keep track of the paragraph |
| 3714 |
% numbers, in which case each note would simply include the sentence |
| 3715 |
% number (just as in verse it would include the line number). In the |
| 3716 |
% unusual event in which you wish to put the paragraph number in the |
| 3717 |
% margin but refer only to sentence numbers in the notes, simply |
| 3718 |
% follow every use of |\pmpara| with |\pmparasfalse|. |
| 3719 |
% |
| 3720 |
% \DescribeMacro{\pmpararunningformat}\DescribeMacro{\pmparmarformat} |
| 3721 |
% The format of running paragraph numbers is set |
| 3722 |
% by |\pmpararunningformat|. Currently it is |
| 3723 |
% |\textbf| and |\small|. |
| 3724 |
% The format of marginal paragraph numbers is set by |
| 3725 |
% |\pmparmarformat|. Currently it is |
| 3726 |
% |\textbf| and |\small|. The definitions of these commands are found at |
| 3727 |
% section \ref{pmparrunningformat}, page \pageref{pmparrunningformat}, Either can |
| 3728 |
% be changed with |\renewcommand|. |
| 3729 |
% |
| 3730 |
% \DescribeMacro{\ifsupressfirstpara} |
| 3731 |
% \DescribeMacro{\ifsuppressfirstsentence} |
| 3732 |
% Some readers find it annoying to have the first sentence or the first paragraph marked. |
| 3733 |
% To suppress the appearance of the first sentence number, whether in the margin or in the |
| 3734 |
% running text, issue |\suppressfirstsentencetrue|. To suppress the appearance of the |
| 3735 |
% first paragraph number, whether in the margin or in the running text, issue |\suppressfirstparatrue|. |
| 3736 |
% These commands will not affect the appearance of entries in the endnote |
| 3737 |
% sections or in the footnotes. |
| 3738 |
% |
| 3739 |
% \subsection{~Cross references by sentence and paragraph} |
| 3740 |
% \DescribeMacro{\sentencelabel} |
| 3741 |
% To make labels that refer to sentences or paragraphs, issue |
| 3742 |
% |\sentencelabel|. The label will be either both the paragraph |
| 3743 |
% number and the sentence number (if you are resetting sentence numbers |
| 3744 |
% by paragraph), or only the sentence number (if you are not resetting |
| 3745 |
% sentence numbers by paragraph). |
| 3746 |
% |
| 3747 |
% \subsection{~End notes by sentence and paragraph} |
| 3748 |
% |
| 3749 |
% \begin{sloppypar} |
| 3750 |
% \DescribeMacro{\pmtextnote} |
| 3751 |
% \DescribeMacro{\pmexplanatory} |
| 3752 |
% \DescribeMacro{\pmemendation} |
| 3753 |
% \DescribeMacro{\pmaccidental} |
| 3754 |
% \DescribeMacro{\pmtsvariant} |
| 3755 |
% \DescribeMacro{\pmtsaccidental} |
| 3756 |
% |\pmtextnote|, |\pmexplanatory|, |\pmemendation|, |\pmaccidental|, |
| 3757 |
% |\pmtsvariant| and |\pmtsaccidental| are special versions of the |
| 3758 |
% usual endnote commands for use with annotations by sentence and |
| 3759 |
% paragraph. If you have not issued |\pmsentencebypara| these |
| 3760 |
% commands will write the sentence number at the head of each note, |
| 3761 |
% where the line number would usually go. If you have issued |
| 3762 |
% |\pmsentencebypara|, these commands will issue both the paragraph |
| 3763 |
% and sentence number, in the format \textless \emph{paragraph |
| 3764 |
% number}\textgreater:\textless \emph{sentence number}\textgreater. You can |
| 3765 |
% refer to ranges of sentences (or paragraphs and sentences) in a way |
| 3766 |
% very similar to how you do so in verse sections. At the end of the |
| 3767 |
% range, issue a |\sentencelabel| command, with a unique label. At |
| 3768 |
% the beginning of the range, issue your |\pmtextnote| command with the |
| 3769 |
% optional argument in square brackets before the main argument, |
| 3770 |
% giving your unique label as the value of that argument, e.g. |
| 3771 |
% |\pmtextnote[some label]{text of lemma] comment}|. At the end of |
| 3772 |
% your range, issue |\sentencelabel{some label}|, using the same |
| 3773 |
% label you put in the square brackets for the |\pmtextnote|. If you have not |
| 3774 |
% issued |\pmsentencebypara|, the range will simply be the range of |
| 3775 |
% sentence numbers. If you have issued |\pmsentencebypara|, the range |
| 3776 |
% will include paragraph and sentence numbers, like this: |
| 3777 |
%\textless \emph{first paragraph |
| 3778 |
% number}\textgreater:\textless \emph{first sentence number}\textgreater\ -- |
| 3779 |
% \textless \emph{lastparagraph |
| 3780 |
% number}\textgreater:\textless \emph{last sentence number}\textgreater, for example: |
| 3781 |
% 4:12--6:13.\end{sloppypar} |
| 3782 |
% |
| 3783 |
% |\sources| needs no special handling if you are annotating by |
| 3784 |
% sentence and paragraph. |
| 3785 |
% |
| 3786 |
% \subsection{~Footnotes by sentence and paragraph} |
| 3787 |
% |\textnoteatfoot| shifts |\pmtextnotes| to the foot, as with |
| 3788 |
% |\prosetextnote|. |\emendationsatfoot| and |\explanationsatfoot| |
| 3789 |
% work the same way. |
| 3790 |
% \subsection{~Bible chapter and verse} |
| 3791 |
% Since |\pmsentence| and |\pmpara| are the moral equivalents of bible |
| 3792 |
% verse and chapter, |\biblechapter| and |\bibleverse| are provided |
| 3793 |
% for convenience. |
| 3794 |
|
| 3795 |
% \section{Parallel text editions} \label{parallelhack} |
| 3796 |
% \subsection{~Setup for parallel texts in verse} |
| 3797 |
% \textsf{poemscol} can make parallel |
| 3798 |
% text editions in which the contrasting versions are set on facing |
| 3799 |
% verso and recto pages. \textsf{poemscol} does not automatically provide the page |
| 3800 |
% breaks for parallel editions, and even if it did, one would still |
| 3801 |
% probably have to specify page breaks every two or three pages to keep |
| 3802 |
% the texts in register anyway, so you will have to use |\newpage| |
| 3803 |
% to mark every page break. If you are willing to set the page breaks |
| 3804 |
% yourself, however, \textsf{poemscol} does provide commands for keeping the line count |
| 3805 |
% correct on successive recto or verso pages, and for keeping track of |
| 3806 |
% whether or not one was in the middle of a stanza when one closed the |
| 3807 |
% previous verso or recto page (as the case may be). And it provides, in |
| 3808 |
% the |\synchrolabel| and |\synchroref| commands, a way of marking which |
| 3809 |
% lines on the recto side correspond to particular lines on the verso |
| 3810 |
% side. |\synchroref| will even tag the marginal line number it makes |
| 3811 |
% with a marker to specify the text to which it refers. |
| 3812 |
% |
| 3813 |
% \begin{sloppypar} |
| 3814 |
% \DescribeMacro{\startparalleltexts} |
| 3815 |
% \DescribeMacro{\finishparalleltexts} |
| 3816 |
% \DescribeEnv{parallelverse} |
| 3817 |
% You must begin a region of parallel text on a \emph{verso} page. |
| 3818 |
% A parallel text region must begin with |
| 3819 |
% |\startparalleltexts| and end with |\finishparalleltexts|. |
| 3820 |
% Setting parallel texts requires one to redefine the poem and stanza |
| 3821 |
% environments, and |\startparalleltexts| redefines those environments. |
| 3822 |
% You can make those changes local to the parallel text region by using |
| 3823 |
% |\begin{parallelverse}| and |\end{parallelverse}| rather than |\startparalleltexts| |
| 3824 |
% and |\finishparalleltexts|. |
| 3825 |
% |\startparalleltexts| and |\finishparalleltexts| can be issued on their own |
| 3826 |
% but I have combined them to make the |parallelverse| environment. \end{sloppypar} |
| 3827 |
% |
| 3828 |
% Although usually with \textsf{poemscol} it is up to you where to put |
| 3829 |
% the marginal line numbers, when you issue |\startparalleltexts| the |
| 3830 |
% positions are fixed as follows: marginal line numbers are in the left |
| 3831 |
% margin, line cross references (marking which lines in the recto text |
| 3832 |
% correspond to which lines in the verso text, which |
| 3833 |
% are made with |\synchroref|) are in the right margin. |
| 3834 |
% |
| 3835 |
%\begin{sloppypar} |
| 3836 |
% \DescribeMacro{\startrectopage} |
| 3837 |
% \DescribeMacro{\finishrectopage} |
| 3838 |
% \DescribeMacro{\startversopage} |
| 3839 |
% \DescribeMacro{\finishversopage} |
| 3840 |
% Verso pages |
| 3841 |
% should begin with |\startversopage| and end with |\finishversopage|. |
| 3842 |
% Recto pages should begin with |\startrectopage| and end with |
| 3843 |
% |\finishrectopage|. You have to declare the page breaks manually, |
| 3844 |
% so be sure you are putting the |\finishversopage| or |\finishrectopage| commands |
| 3845 |
% in places which |
| 3846 |
% will work. |\finishparalleltexts| just makes certain that stanzas, and poems, |
| 3847 |
% that you opened in a region of parallel texts are closed when you leave it.\end{sloppypar} |
| 3848 |
% |
| 3849 |
% \DescribeMacro{\versopoemtitle} |
| 3850 |
% \DescribeMacro{\rectopoemtitle} |
| 3851 |
% \DescribeMacro{\versopoemtitlenocontents} |
| 3852 |
% \DescribeMacro{\rectopoemtitlenocontents} |
| 3853 |
% Use |\versopoemtitle| and |\rectopoemtitle| |
| 3854 |
% rather than |\poemtitle| for the title of the poem (or prose passage) |
| 3855 |
% on the verso or recto pages. |
| 3856 |
% if you are making a parallel text of Wordsworth's 1805 and 1850 |
| 3857 |
% versions of \emph{The Prelude}, you might want to use something |
| 3858 |
% like |\versopoemtitle{The Prelude (1805 Version)}| and |
| 3859 |
% |\rectopoemtitle{The Prelude (1850 Version)}|. |
| 3860 |
% I have also made versions of these commands that do not make |
| 3861 |
% entries in the table of contents, should the need arise for them. |
| 3862 |
% If you wish to make titles for other things, |
| 3863 |
% such as poetic sequences or sequence sections, you can use the techniques |
| 3864 |
% described in section \ref{customizing titles} above, page \pageref{customizing titles}, |
| 3865 |
% except substitute the command |\versoset@p@emtitle| |
| 3866 |
% or |\rectoset@p@emtitle| for |\set@p@emtitle|, using |
| 3867 |
% all the same arguments you would have used with |\set@p@emtitle|. |
| 3868 |
% |
| 3869 |
%\subsection{~Parallel texts and on the fly note types} |
| 3870 |
% If you are making a parallel text edition, you may need to |
| 3871 |
% use |\definenewnotetype| to make the different kinds of endnote |
| 3872 |
% for the parallel texts. For instance, |
| 3873 |
% if you are making a parallel text of Wordsworth's 1805 and 1850 |
| 3874 |
% versions of \emph{The Prelude}, you may use something like |\fiveexplanatory| |
| 3875 |
% and |\fiftyexplanatory| for explanatory notes for the poems on the verso |
| 3876 |
% and recto pages. |
| 3877 |
% |
| 3878 |
% |
| 3879 |
% \DescribeMacro{\keeptitlestraight} |
| 3880 |
% Without special care, \textsf{poemscol} may become |
| 3881 |
% confused about whether it has seen, for example, a |\fiveexplanatory| for |
| 3882 |
% a particular book of \emph{The Prelude} or not, and, if |\settitleinnotes| is set, |
| 3883 |
% may neglect to put the |
| 3884 |
% title of that book of \emph{The Prelude} in the notes |
| 3885 |
% for the first note for that book. To remedy this, |\versopoemtitle| |
| 3886 |
% and |\rectopoemtitle| set up a way of keeping track whether each species |
| 3887 |
% of note has appeared already or not. |
| 3888 |
% While setting parallel texts \textsf{poemscol} checks at the beginning of every |
| 3889 |
% verso or recto page whether the the different species of endnote for the poem on |
| 3890 |
% that page has appeared before. On rare occasions this turns out not to be frequently |
| 3891 |
% enough in cases |
| 3892 |
% where you are defining your own kinds of endnote. |
| 3893 |
% In this case, the following hack, |\keeptitlesstraight|, will check whether the verso or recto |
| 3894 |
% poem has set that species of note each time it is issued. Suppose, for instance, |
| 3895 |
% going back to our Wordsworth example, |
| 3896 |
% that you have defined, using |\definenewnotetype|, the following six |
| 3897 |
% kinds of endnotes: |\fivetextnote| |\fiveemendation|, |\fiveexplanatory|, |
| 3898 |
% |\fiftytextnote|, |\fiftyemendation|, and |\fiftyexplanatory|. You should |
| 3899 |
% define a new command called |\keeptitlesstraight| to keep track of these six |
| 3900 |
% kinds of note. Here is how it might look: |
| 3901 |
% |
| 3902 |
% \medskip |
| 3903 |
% |
| 3904 |
% \noindent|\newcommand{\keeptitlesstraight}{|\\ |
| 3905 |
% |\pretocmd{\fivetextnote}{\versotitleinnotescheck}{\relax}{\relax}|\\ |
| 3906 |
% |\pretocmd{\fiveemendation}{\versotitleinnotescheck}{\relax}{\relax}|\\ |
| 3907 |
% |\pretocmd{\fiveexplanatory}{\versotitleinnotescheck}{\relax}{\relax}|\\ |
| 3908 |
% |\pretocmd{\fiftytextnote}{\rectotitleinnotescheck}{\relax}{\relax}|\\ |
| 3909 |
% |\pretocmd{\fiftyemendation}{\rectotitleinnotescheck}{\relax}{\relax}|\\ |
| 3910 |
% |\pretocmd{\fiftyexplanatory}{\rectotitleinnotescheck}{\relax}{\relax}|\\ |
| 3911 |
% |}| |
| 3912 |
% |
| 3913 |
% \medskip |
| 3914 |
%\begin{sloppypar} |
| 3915 |
% All those fields filled with |\relax| are for reporting the success or failure |
| 3916 |
% |\pretocmd| has had in appending |\versotitleinnotescheck| (or |\rectotitleinnotescheck|) |
| 3917 |
% to the different endnotes commands. You may wish to replace |
| 3918 |
% the |\relax| with something like |\typeout{fiftytextnote modified}| or |
| 3919 |
% |\typeout{fiftytextnote not modified}|. \end{sloppypar} |
| 3920 |
% |
| 3921 |
%If you are using the |\keeptitlestraight| |
| 3922 |
% hack described here, you should add \textsf{etoolbox} |
| 3923 |
% to your package list. |
| 3924 |
% |
| 3925 |
% \DescribeMacro{\resettitleinnotes} |
| 3926 |
% If you are defining new kinds of note, and a section of |
| 3927 |
% non-parallel texts follow a section of parallel texts, you |
| 3928 |
% will need to issue the following hack after the parallel texts close |
| 3929 |
% (again I am using the Wordsworth example):\\ |
| 3930 |
% |\newcommand{\resettitleinnotes}{|\\ |
| 3931 |
% |\nofiveemendationyettrue%|\\ |
| 3932 |
% |\nofiveexplanatoryyettrue%|\\ |
| 3933 |
% |\nofivetextnoteyettrue%|\\ |
| 3934 |
% |\nofiftyemendationyettrue%|\\ |
| 3935 |
% |\nofiftyexplanatoryyettrue%|\\ |
| 3936 |
% |\nofiftytextnoteyettrue%|\\ |
| 3937 |
% |}| |
| 3938 |
% |
| 3939 |
% \subsection{~Parallel texts and generic note types} |
| 3940 |
% \begin{sloppypar} |
| 3941 |
% \DescribeMacro{\rectotexnote} |
| 3942 |
% \DescribeMacro{\rectoemendation} |
| 3943 |
% \DescribeMacro{\rectoexplanatory} |
| 3944 |
% \DescribeMacro{\versotexnote} |
| 3945 |
% \DescribeMacro{\versoemendation} |
| 3946 |
% \DescribeMacro{\versoexplanatory} |
| 3947 |
% In case you find using these hacks a bit burdensome, |
| 3948 |
% I have defined for your convenience six generic kinds of endnote for use in parallel text |
| 3949 |
% editions: |\rectotextnote|, |\rectoeemendation|, |\rectoexplanatory|, |
| 3950 |
% |\versotextnote|, |\versoemendation|, and |\versoexplanatory,| as well as |\rectoprosetexnote|, |
| 3951 |
% |\versoprosetextnote,| |\rectoproseemendation,| |\versoproseemendation|, |
| 3952 |
% |\rectoproseexplanatory|, and |\versoproseexplanatory.| |
| 3953 |
% \end{sloppypar} |
| 3954 |
% |
| 3955 |
% \begin{sloppypar} |
| 3956 |
% I have also defined |
| 3957 |
% |\literalrectotextnote|, |\literalversotextnote|, |\literalrectoemendation|, |\literalversoemendation|, |
| 3958 |
% |\literalrectoexplain|, and |\literalversoexplain| for sending material other than formal |
| 3959 |
% endnotes to these endnote sections. |
| 3960 |
% \end{sloppypar} |
| 3961 |
% |
| 3962 |
% You can use all of these without creating versions of |\keeptitlesstraight| and |
| 3963 |
% |\resettitleinnotes|. |
| 3964 |
% |
| 3965 |
% |
| 3966 |
% \begin{sloppypar} |
| 3967 |
% \DescribeMacro{\makerectotexnotes} |
| 3968 |
% \DescribeMacro{\makerectoemendations} |
| 3969 |
% \DescribeMacro{\makerectoexplanatorynotes} |
| 3970 |
%To use these |
| 3971 |
% kinds of note, issue |\makeversotextnotes|, |\makeversoemendations|, |
| 3972 |
% |\makeversoexplanatorynotes| or their recto equivalents in your preamble. You can mark |
| 3973 |
% up your texts with these notes |
| 3974 |
% just as you would do with |\textnote|, |\emendation| or |\explanatory| (or |\literalversotextnote| |
| 3975 |
% |\literalversoemendation| and |\literalversoexplain|), without any of the special hacks |
| 3976 |
% I have just described. |
| 3977 |
% \end{sloppypar} |
| 3978 |
% |
| 3979 |
% \begin{sloppypar} |
| 3980 |
% \DescribeMacro{\changerectotextnotesname} |
| 3981 |
% \DescribeMacro{\changerectotextnotesheader} |
| 3982 |
% \DescribeMacro{\rectotextnotessinglepar} |
| 3983 |
% \DescribeMacro{\rectotextnotestwocol} |
| 3984 |
% I have given the endnotes sections generated by these notes rather |
| 3985 |
% generic names (|\rectotextnote| and |\versotextnote| for instance, both open endnote sections |
| 3986 |
% with the title TEXTUAL NOTES, with a running header of the form ``Textual Notes to pp.~xx--yy'' |
| 3987 |
% an a contents entry of Textual Notes). You will probably need to change |
| 3988 |
% those to something more descriptive. You can change any of these with |
| 3989 |
% |\changeversotextnotesname{Your Title}|, |\changeversotextnotesheader{Your running header}|, |
| 3990 |
% and |\changeversotextnotescontentsname{Your contents entry}|. |
| 3991 |
% You can change the appearance of these notes |
| 3992 |
% by changing the values of the booleans |\versotextnotessinglepar| and |\versotextnotestwocol|. |
| 3993 |
% Similar sets of commands are available for |\versoemendation| and |\versoexplanatory| |
| 3994 |
% and their recto equivalents. |
| 3995 |
% \end{sloppypar} |
| 3996 |
% |
| 3997 |
% \begin{sloppypar} |
| 3998 |
% \DescribeMacro{\putrectotextnotes} |
| 3999 |
% To include these note sections in your document, issue |\putversotextnotes|, |\putrectotextnotes|, |
| 4000 |
% |\putversoemendations|, |\putrectoemendations|, |\putversoexplanatorynotes|, or |
| 4001 |
% |\putrectoexplanatorynotes| at the point where you wish them to appear. These commands |
| 4002 |
% behave exactly like |\puttextnotes|. |
| 4003 |
% \end{sloppypar} |
| 4004 |
% |
| 4005 |
% \subsection{~Parallel text labels} |
| 4006 |
% \DescribeMacro{\synchrolabel} \DescribeMacro{\synchroref} |
| 4007 |
% \DescribeMacro{\setsynchroflag} You may want to mark cross references |
| 4008 |
% to make it clear to the reader which line of the poem on the recto side |
| 4009 |
% of the spread corresponds to a particular line on the verso side. |
| 4010 |
% To mark these cross references, you |
| 4011 |
% need to make a label on the verso side (using |\syncrolabel|), and a corresponding |
| 4012 |
% reference on the recto side (using |\synchroref|). You may also wish to add a mark to |
| 4013 |
% that reference (using |\setsynchroflag|) to specify to the reader what edition it refers to. So, for |
| 4014 |
% instance, if your verso text is the 1805 version of Wordsworth's |
| 4015 |
% \emph{The Prelude}, and your recto text is the 1850 version, you may |
| 4016 |
% wish to specify |\setsynchroflag{1805: }|, which will preface the |
| 4017 |
% references put out by the |\synchroref| command with~`1805:~'. |
| 4018 |
% Suppose you wished to tie these corresponding passages from the ``Boy of Winander'' |
| 4019 |
% episode in Book 3. To make the label, issue the |
| 4020 |
% |\synchrolabel| command on the verso side (the 1805 side) just after the |
| 4021 |
% |\verseline| or |\end{stanza}| which closes the line you wish to |
| 4022 |
% label: |
| 4023 |
% |
| 4024 |
% \begin{verbatim} |
| 4025 |
%This boy was taken from his mates, and died \verseline |
| 4026 |
%In childhood ere he was full ten years old \verseline |
| 4027 |
% \synchrolabel{full ten years old} |
| 4028 |
% \end{verbatim} |
| 4029 |
% You don't have to quote the whole line in the label, but it should be |
| 4030 |
% long enough to uniquely pick out that line in the poem. (If the line |
| 4031 |
% is repeated in the poem, you will have to exercise your ingenuity in |
| 4032 |
% making up a unique label.) |
| 4033 |
% |
| 4034 |
% Over on the recto side (the 1850 side), you will want to use |\synchroref| in order |
| 4035 |
% to print the marginal cross reference. The |\synchroref| command |
| 4036 |
% should come \emph{before} the |\verseline| that closes the line it is |
| 4037 |
% tied to, as follows: |
| 4038 |
% |
| 4039 |
% \begin{verbatim} |
| 4040 |
%This Boy was taken from his mates, and died\verseline |
| 4041 |
%In childhood, ere he was full twelve years old. |
| 4042 |
% \synchroref{full ten years old}}\verseline |
| 4043 |
% \end{verbatim} |
| 4044 |
% |
| 4045 |
% \subsection{~Parallel prose passages} |
| 4046 |
% \DescribeMacro{parallelprose} |
| 4047 |
% \DescribeMacro{\startparalleltextprose} |
| 4048 |
% \DescribeMacro{\finishparalleltextprose} |
| 4049 |
% \textsf{poemscol} is not designed to manage long parallel texts in prose, |
| 4050 |
% but for shorter texts up to a couple of dozen pages, such as |
| 4051 |
% two versions of an Author's Preface, say, \textsf{poemscol} has the |parallelprose| |
| 4052 |
% environment. (You can also use |\startparalleltextprose| and |\finishparalleltextprose|.) |
| 4053 |
% Like passages of parallel text in verse, parallel prose passages must start |
| 4054 |
% on a verso page. |
| 4055 |
% |
| 4056 |
% \begin{sloppypar} |
| 4057 |
% \DescribeMacro{\startversoprosepage} |
| 4058 |
% \DescribeMacro{\finishversoprosepage} |
| 4059 |
% \DescribeMacro{\startrectoprosepage} |
| 4060 |
% \DescribeMacro{\finishrectoprosepage} |
| 4061 |
% Each verso page must start with |\startversoprosepage| and finish with |
| 4062 |
% |\finishversoprosepage|, and each recto page must start with |\startrectoprosepage| |
| 4063 |
% and finish with |\finishrectoprosepage|. If a page continues a paragraph from the previous |
| 4064 |
% page, say, from a previous recto page, put the beginning of the |
| 4065 |
% text on the second page right after the |\startrectopage| command with |
| 4066 |
% no blank line. (Alternatively, you could just |
| 4067 |
% begin that page with |\noindent|.) |
| 4068 |
% \end{sloppypar} |
| 4069 |
% |
| 4070 |
% \DescribeMacro{\parastart} |
| 4071 |
% \DescribeMacro{\paraend} |
| 4072 |
% You must mark the beginning and end of every paragraph in parallel prose passages |
| 4073 |
% with |\parastart| and |\paraend|. |
| 4074 |
% |
| 4075 |
% You will have to pick the page breaks manually, using |\newpage|, once you find where |
| 4076 |
% \LaTeX\ would naturally break the page. Because how \LaTeX\ justifies text is a little |
| 4077 |
% unpredictable, however, you may find that the line before the page break, which filled |
| 4078 |
% the line before you added the page break, is actually a little shorter, and thus is |
| 4079 |
% no longer justified, once you add the page break. You may well not be able to exactly |
| 4080 |
% fill out the line by trial and error, adding a word or even just a syllable, to the line at a time. |
| 4081 |
% You can kludge around the problem, however, by adding |
| 4082 |
% an |\hfil| between each word of the last line. |
| 4083 |
% |
| 4084 |
% \section{Using \textsf{poemscol} in a multilingual world} |
| 4085 |
% |
| 4086 |
% \begin{sloppypar} |
| 4087 |
% \DescribeMacro{\changecontentsname} |
| 4088 |
% By default, \textsf{poemscol} uses English language titles for such |
| 4089 |
% things as the Table of Contents, the Explanatory Notes, and so on, |
| 4090 |
% and uses English language running headers. As of version 2.5 these |
| 4091 |
% are easily changed. To change the name of the Table of Contents |
| 4092 |
% (the default is CONTENTS) to Inhaltsverzeichnis, issue |
| 4093 |
% |\changecontentsname{Inhaltsverzeichnis}|. To change the running |
| 4094 |
% header on contents pages, issue |
| 4095 |
% |\changecontentsheader{your header}|.\end{sloppypar} |
| 4096 |
% |
| 4097 |
% \begin{sloppypar} |
| 4098 |
% \DescribeMacro{\changenotesname} To change the name for the endnote |
| 4099 |
% section for textual notes (the default is TEXTUAL NOTES), issue |
| 4100 |
% |\changenotesname{your version}|. To change the running header (by |
| 4101 |
% default ``Textual Notes to'') issue |
| 4102 |
% |\changenotesheader{your version}|. |
| 4103 |
% To change the name for |
| 4104 |
% the textual notes in the table of contents issue |
| 4105 |
% |\changetextnotescontentsname{your version}|. |
| 4106 |
% |
| 4107 |
% \DescribeMacro{\changesinglepageabbrev} |
| 4108 |
% \DescribeMacro{\changemultiplepageabbrev} |
| 4109 |
% Running headers refer to single pages with the English |
| 4110 |
% abbreviation ``p.'' and to multiple pages with the English |
| 4111 |
% abbreviation ``pp.'' To change these issue |
| 4112 |
% |\changesinglepageabbrev{new abbrev}| or |
| 4113 |
% |\changemultiplepageabbrev{new abbrev}| respectively. The ultimate |
| 4114 |
% outcome is to translate a header of the form ``Textual Notes to |
| 4115 |
% pp.~xx-yy'' to the form appropriate for your language.\end{sloppypar} |
| 4116 |
% |
| 4117 |
% \begin{sloppypar} |
| 4118 |
% \DescribeMacro{\changeemendationsname} To change the name for the endnote |
| 4119 |
% section for emendations (the default is EMENDATIONS), issue |
| 4120 |
% |\changeemendationsname{your version}|. To change the running header (by |
| 4121 |
% default ``Emendations to'') issue |
| 4122 |
% |\changeemendationsheader{your version}|. To change the name for |
| 4123 |
% the emendations in the table of contents issue |
| 4124 |
% |\changeemendationscontentsname{your version}.|\end{sloppypar} |
| 4125 |
% |
| 4126 |
%\begin{sloppypar} |
| 4127 |
% \DescribeMacro{\changeexplanationsname} To change the name for the endnote |
| 4128 |
% section for explanatory notes (the default is EXPLANATORY NOTES), issue |
| 4129 |
% |\changeexplanationsname{your version}|. To change the running header (by |
| 4130 |
% default ``Explanatory Notes to'') issue |
| 4131 |
% |\changeexplanationsheader{your version}|. |
| 4132 |
% To change the name for |
| 4133 |
% the explanatory notes in the table of contents issue |
| 4134 |
% |\changeexplanationscontentsname{your version}|.\end{sloppypar} |
| 4135 |
% |
| 4136 |
% \begin{sloppypar} \DescribeMacro{\changepoemindexname} To change the name |
| 4137 |
% for the index (the default is ``Index of Titles and First Lines'', issue |
| 4138 |
% |\changepoemindexname{your version}|. To change the running |
| 4139 |
% header (the default is ``Index of Titles and First Lines'') issue |
| 4140 |
% |\changepoemindexheader{your version}|. To change the contents |
| 4141 |
% entry for the index (the default is ``Index of Titles and First Lines'') |
| 4142 |
% issue |
| 4143 |
% |\changepoemindexcontentsname{your version}|.\end{sloppypar} |
| 4144 |
% |
| 4145 |
%\section{A sample driver file} |
| 4146 |
% |
| 4147 |
% If you are compiling a collected poems, you are probably preparing |
| 4148 |
% your volume from many files. You may (or may not) wish to subdivide |
| 4149 |
% your edition by the original volumes. Or you may subdivide by year, |
| 4150 |
% or by the significant phases of the poet's career. One way to keep |
| 4151 |
% in control of the process is to create a driver file, which calls |
| 4152 |
% all the appropriate\ .sty files and sets the variables globally, and |
| 4153 |
% then read in the sections of the edition using |\input|. Here is a |
| 4154 |
% version of the driver file I used for |
| 4155 |
% \emph{The Collected Poems of Robert Penn Warren}: |
| 4156 |
% \begin{verbatim} |
| 4157 |
% \documentclass[10pt,twoside]{article} |
| 4158 |
% \usepackage{fancyhdr,kdgreek,makeidx,times,multicol,geometry,} |
| 4159 |
% \usepackage{keyval,ifthen,mparhack,manyfoot,poemscol} |
| 4160 |
% \begin{document} |
| 4161 |
% \leftheader{The Collected Poems of Robert Penn Warren} |
| 4162 |
% \makeexplanatorynotes |
| 4163 |
% \makeemendations |
| 4164 |
% \maketextnotes |
| 4165 |
% \makepoemcontents |
| 4166 |
% \makeverselinenumbers |
| 4167 |
% \global\indexingontrue |
| 4168 |
% \global\includeaccidentalstrue |
| 4169 |
% \global\includetypescriptstrue |
| 4170 |
% \input maintitle.tex |
| 4171 |
% \input poems1922_1943.tex |
| 4172 |
% \input thirtysix.tex |
| 4173 |
% \input eleven.tex |
| 4174 |
% \input sp43.tex |
| 4175 |
% \input promises1.tex |
| 4176 |
% \input promises2.tex |
| 4177 |
% \input promises3.tex |
| 4178 |
% \input yeo1.tex |
| 4179 |
% \input yeo2.tex |
| 4180 |
% \input yeo3.tex |
| 4181 |
% \input tale1.tex |
| 4182 |
% \input tale2.tex |
| 4183 |
% \input incarnations.tex |
| 4184 |
% \input audubon.tex |
| 4185 |
% \input orelse1.tex |
| 4186 |
% \input orelse2.tex |
| 4187 |
% \input arcturus.tex |
| 4188 |
% \input nowthen.tex |
| 4189 |
% \input beinghere.tex |
| 4190 |
% \input rumor1.tex |
| 4191 |
% \input rumor2.tex |
| 4192 |
% \input cj1.tex |
| 4193 |
% \input cj2.tex |
| 4194 |
% \input altitudes.tex |
| 4195 |
% \input poems1943_1989.tex |
| 4196 |
% \input introduction.tex |
| 4197 |
% \finish |
| 4198 |
% \end{verbatim} |
| 4199 |
% |
| 4200 |
% \section{A sample poem markup} |
| 4201 |
% Here is a poem Robert Penn Warren wrote in his first volume, |
| 4202 |
% \emph{Thirty-Six Poems} (1935). The poem is the first poem of his |
| 4203 |
% sequence ``Kentucky Mountain Farm.'' I include the over-title, to |
| 4204 |
% demonstrate how to mark up such cases. |
| 4205 |
% \begin{verbatim} |
| 4206 |
% \sequencetitle{Kentucky Mountain Farm} |
| 4207 |
% \index{Kentucky Mountain Farm@{\em Kentucky Mountain Farm\/}} |
| 4208 |
% \sources{Text: TSP. Variants: SP43, SP66 (Deletes ``The Cardinal,'' ``The |
| 4209 |
% Jay,'' and ``Watershed''), SP75 (Same sections as SP66), SP85 (Restores |
| 4210 |
% ``Watershed''), {\em Helsinki\/} (includes only ``Rebuke of |
| 4211 |
% the Rocks'' and |
| 4212 |
% ``At the Hour of the Breaking of the Rocks''). |
| 4213 |
% ``The Owl'' (above) was marked as a section of ``Kentucky |
| 4214 |
% Mountain Farm'' when it first appeared in {\em Poetry,\/} but it was never |
| 4215 |
% included in any book version of the entire sequence. The sequence in {\em |
| 4216 |
% Poetry\/} included, in this order, ``The Owl,'' ``The Cardinal,'' and |
| 4217 |
% ``Watershed.'' TSP uses lower case Roman numerals in the section |
| 4218 |
% titles. The typescript drafts in the Beinecke Library do not seem to |
| 4219 |
% be setting copies.} |
| 4220 |
% \sequencefirstsectiontitle{I. Rebuke of the Rocks} |
| 4221 |
% \index{Rebuke of the Rocks@{\em Rebuke of the Rocks\/}} |
| 4222 |
% \sources{Text: TSP. Variants: {\em Nation\/}, 11 Jan.\ 1928, |
| 4223 |
% p.~47, {\em Literary |
| 4224 |
% Digest,\/} 28 Jan.\ 1928, p.~32, {\em Vanderbilt Masquerader,\/} 10 |
| 4225 |
% (Dec.\ 1933), p.~16, SP43, SP66, SP75, SP85, {\em Helsinki\/}, |
| 4226 |
% Broadside: The Press at Colorado College, printed on paper handmade by |
| 4227 |
% Thomas Leech for the American Poetry Society, April~26, 1985. This |
| 4228 |
% poem was not included in SP85 until the second set of galleys, in |
| 4229 |
% which a photocopy of the SP75 text is a stapled insert.} |
| 4230 |
% \begin{poem} |
| 4231 |
% \begin{stanza} |
| 4232 |
% Now on you is the hungry equinox,\verseline |
| 4233 |
% \index{Now on you is the hungry equinox} |
| 4234 |
% O little stubborn people of the hill,\verseline |
| 4235 |
% \accidental{hill,] \sameword--- {\em Nation,\/} {\em Literary Digest\/} |
| 4236 |
% \sameword, {\em Vanderbilt\/} (I include the reading |
| 4237 |
% from {\em Vanderbilt\/} |
| 4238 |
% even though it is the same as in TSP, because |
| 4239 |
% {\em Vanderbilt\/} was published |
| 4240 |
% after the other magazine versions but before TSP.)} |
| 4241 |
% The season of the obscene moon whose pull\verseline |
| 4242 |
% Disturbs the sod, the rabbit, the lank fox,\verseline |
| 4243 |
% Moving the waters, the boar's dull blood,\verseline |
| 4244 |
% And the acrid sap of the ironwood.\end{stanza} |
| 4245 |
% |
| 4246 |
% \begin{stanza} |
| 4247 |
% But breed no tender thing among the rocks.\verseline |
| 4248 |
% Rocks are too old under the mad moon,\verseline |
| 4249 |
% \accidental{old\missingpunct] \sameword, {\em Vanderbilt\/}} |
| 4250 |
% Renouncing passion by the strength that locks\verseline |
| 4251 |
% The eternal agony of fire in stone.\end{stanza} |
| 4252 |
% |
| 4253 |
% \begin{stanza} |
| 4254 |
% Then quit yourselves as stone and cease\verseline |
| 4255 |
% \accidental{stone\missingpunct] \sameword, {\em Vanderbilt\/}} |
| 4256 |
% To break the weary stubble-field for seed;\verseline |
| 4257 |
% Let not the naked cattle bear increase,\verseline |
| 4258 |
% Let barley wither and the bright milkweed.\verseline |
| 4259 |
% \accidental{milkweed.] milk-weed. {\em Vanderbilt\/}} |
| 4260 |
% Instruct the heart, lean men, of a rocky place\verseline |
| 4261 |
% That even the little flesh and fevered bone\verseline |
| 4262 |
% May keep the sweet sterility of stone.\end{stanza} |
| 4263 |
% \end{poem} |
| 4264 |
% \end{verbatim} |
| 4265 |
|
| 4266 |
% \goodbreak |
| 4267 |
% \section{A sample divider page} |
| 4268 |
% \begin{verbatim} |
| 4269 |
% \begin{volumetitlepage} |
| 4270 |
% |
| 4271 |
% \volumetitle{Being Here} |
| 4272 |
% \volumeheader{Being Here} |
| 4273 |
% \volumesubtitle{Poetry 1977--1980} |
| 4274 |
% \volumededication{To Gabriel Thomas Penn\\ |
| 4275 |
% (1836--1920)} |
| 4276 |
% \bigskip |
| 4277 |
% |
| 4278 |
% \volumeepigraph{OLD MAN: You get old and you can't do anybody |
| 4279 |
% any good any more.\\ |
| 4280 |
% BOY: You do me some good, Grandpa. You |
| 4281 |
% tell me things.} |
| 4282 |
% |
| 4283 |
% |
| 4284 |
% \bigskip |
| 4285 |
% |
| 4286 |
% \volumeepigraph{There is in short no absolute time standard.} |
| 4287 |
% \volumeattribution{{\em Van Nostrand's Scientific Encyclopedia,\/}\\ |
| 4288 |
% Fifth Edition, p. 2203} |
| 4289 |
% |
| 4290 |
% \bigskip |
| 4291 |
% |
| 4292 |
% |
| 4293 |
% \volumeepigraph{I thirst to know the power and nature of Time\ldots.} |
| 4294 |
% \volumeattribution{St.\ Augustine: {\em Confessions,\/}\\ |
| 4295 |
% Book {\em XI,\/} Chapter {\em XXIII\/}\\ |
| 4296 |
% Translated by Albert C. Outler} |
| 4297 |
% |
| 4298 |
% |
| 4299 |
% \bigskip |
| 4300 |
% |
| 4301 |
% \volumeepigraph{Time is the dimension in which God |
| 4302 |
% strives to define His own Being.} |
| 4303 |
% |
| 4304 |
% \sources{The typescript material in the Beinecke Library |
| 4305 |
% indicates that this |
| 4306 |
% book went through many drafts, and some rethinking about what to |
| 4307 |
% include and how to order the poems. Until a late stage of |
| 4308 |
% production---very late, since the typescript includes a designed |
| 4309 |
% mock-up of the proposed title page---the title of this volume was {\em |
| 4310 |
% Life is a Fable.\/} Indeed, as late as the time the book was set in |
| 4311 |
% galleys it was called {\em Life is a Fable\/}, although the title was |
| 4312 |
% corrected on the galleys. Like {\em Now and Then\/}, the typescript |
| 4313 |
% was assembled from photocopies of re-typed copies of poems made after |
| 4314 |
% their magazine appearance, with annotations giving the name of the |
| 4315 |
% magazine in which they occurred. Unlike {\em Now and Then\/}, the |
| 4316 |
% typescript seems to have been typed in one piece, and the annotations |
| 4317 |
% added for the convenience of the permissions department at |
| 4318 |
% Random House. The page numbers have been added---presumably |
| 4319 |
% later---in blue pen. The copy is marked up in Warren's hand in black |
| 4320 |
% pencil, and in another hand in red pencil. (Unless marked otherwise, |
| 4321 |
% all of the mark-up described here is in black pencil.) \tsentry{Like most |
| 4322 |
% Warren typescripts BHTS is single-spaced. The dedication to Gabriel |
| 4323 |
% Thomas Penn and the dialogue between the old man and the boy appeared |
| 4324 |
% on a separate page, and the three epigraphs appeared on another |
| 4325 |
% separate page. BHTS gives 1838 as the year of Gabriel |
| 4326 |
% Thomas Penn's |
| 4327 |
% birth (the error is corrected on the galleys). In the quotation from |
| 4328 |
% Augustine, the second word is corrected to ``thirst'' from ``yearn,'' |
| 4329 |
% and the translator's name is added in pencil, not in Warren's |
| 4330 |
% handwriting.} In one of Warren's own |
| 4331 |
% copies at Western Kentucky University, he has corrected the date of |
| 4332 |
% Gabriel Thomas Penn's birth to 1837 (copy 310). Some revisions in this book |
| 4333 |
% may have come very late |
| 4334 |
% indeed. A letter to Erskine of January 28, 1980, refers to changes |
| 4335 |
% made in a bound manuscript that Warren kept after returning the |
| 4336 |
% copy-edited typescripts. There are revisions not only on the galleys, |
| 4337 |
% but also on the page proofs. There are even some corrections on the |
| 4338 |
% ``blues'' for this volume, including some new copy on a card referred |
| 4339 |
% to in a note on the cover of the ``blues'' but now lost. The Secker |
| 4340 |
% and Warburg London edition is, except for the title page, printed from |
| 4341 |
% the American plates. There is a copy of this book, marked up by |
| 4342 |
% Warren with |
| 4343 |
% proposed revisions for Stuart Wright's use on May 25, 1987, in the |
| 4344 |
% Special Collections |
| 4345 |
% Department of the Emory University Library. I quote Warren's |
| 4346 |
% notes by permission. |
| 4347 |
% Warren has also marked up, slightly, a copy of this book now in the |
| 4348 |
% Robert Penn Warren Room of the Library of the Kentucky Museum at |
| 4349 |
% Western Kentucky University. I quote that volume too by permission. |
| 4350 |
% The setting typescript for the section of SP85 drawn from this volume |
| 4351 |
% consisted of taped-in photocopies of passages from BH. Because the |
| 4352 |
% revisions for SP85 are sometimes a vexed question, I have indicated |
| 4353 |
% where the SP85 revisions are made on SP85TS.} |
| 4354 |
% |
| 4355 |
% |
| 4356 |
% \sources{Title Page] SP85 omits the dialogue between the old man and |
| 4357 |
% the young boy. SP85 capitalizes ``time standard'' in the quotation |
| 4358 |
% from Van Nostrand's Scientific Encyclopedia, and does not capitalize |
| 4359 |
% ``Time'' in the quotation from Augustine.} |
| 4360 |
% |
| 4361 |
% |
| 4362 |
% |
| 4363 |
% \end{volumetitlepage} |
| 4364 |
% \end{verbatim} |
| 4365 |
% |
| 4366 |
% |
| 4367 |
% |
| 4368 |
% |
| 4369 |
% \StopEventually{\PrintChanges\PrintIndex} |
| 4370 |
% \section{Implementation}\label{implementation} |
| 4371 |
% \subsection{~Page geometry and crop marks} |
| 4372 |
|
| 4373 |
|
| 4374 |
% \begin{macro}{\tightgeometry} There's no reason why you should use the |
| 4375 |
% page geometry I used in \emph{The Collected Poems of Robert Penn Warren}, |
| 4376 |
% and there are many reasons not to. But I include it just to show what is possible. |
| 4377 |
% If you issue |\tightgeometry| in your |
| 4378 |
% preamble, you will have the geometry I have used. If you issue |
| 4379 |
% |\tightleading| you will |
| 4380 |
% redefine |\normalsize| and |\small| to use tighter leading. |
| 4381 |
% Normal |
| 4382 |
% 10 point \LaTeX\ uses 12 point leading. Strictly to save money, I |
| 4383 |
% redefined |\normalsize| to use 11 point leading. |
| 4384 |
% I use the \textsf{geometry} package, |
| 4385 |
% since it's simpler to figure out. I give my page geometry here |
| 4386 |
% chiefly to remind the reader of some important variables that should |
| 4387 |
% be kept track of, such as marginparsep, which controls the |
| 4388 |
% separation of the marginal line numbers from the verse line, |
| 4389 |
% marginparwidth, which controls how wide the block for the marginal |
| 4390 |
% line numbers will be, headsep, which controls how far the text will |
| 4391 |
% be from the running headers, and footskip, which controls how far |
| 4392 |
% the last verse line will be from the marker which tells the reader |
| 4393 |
% that there is a stanza break at the end of the page (if there is |
| 4394 |
% one). I've also set the odd side margin and the even side margin |
| 4395 |
% for two-sided printing. Finally, I have set the default handling |
| 4396 |
% of page endings to |\raggedbottom|. Verse should always be set with |
| 4397 |
% a ragged bottom margin, otherwise \LaTeX\ will stretch the spaces |
| 4398 |
% between stanzas to make the bottom perfectly flush. When you enter |
| 4399 |
% prose sections, such as the editor's introduction, you should enter |
| 4400 |
% the command |\flushbottom| to make sure that the prose sections have |
| 4401 |
% flush page bottoms. |
| 4402 |
% \begin{macrocode} |
| 4403 |
\newcommand{\tightgeometry}{\geometry{verbose, tmargin= 33pt, |
| 4404 |
textwidth=318.21pt,textheight=550pt, |
| 4405 |
marginparsep=7pt,marginparwidth=10pt, |
| 4406 |
headheight= 15pt, |
| 4407 |
headsep=19pt, |
| 4408 |
footskip=15pt, |
| 4409 |
lmargin=132pt} |
| 4410 |
\setlength{\oddsidemargin}{60pt} |
| 4411 |
\setlength{\evensidemargin}{65.41pt}} |
| 4412 |
\newcommand{\tightleading}{% |
| 4413 |
\makeatletter |
| 4414 |
\renewcommand\normalsize{% |
| 4415 |
\@setfontsize\normalsize\@xpt\@xipt |
| 4416 |
\abovedisplayskip 10\p@ \@plus2\p@ \@minus5\p@ |
| 4417 |
\abovedisplayshortskip \z@ \@plus3\p@ |
| 4418 |
\belowdisplayshortskip 6\p@ \@plus3\p@ \@minus3\p@ |
| 4419 |
\belowdisplayskip \abovedisplayskip |
| 4420 |
\let\@listi\@listI} |
| 4421 |
\makeatother |
| 4422 |
\normalsize |
| 4423 |
\makeatletter |
| 4424 |
\renewcommand\small{% |
| 4425 |
\@setfontsize\small\@ixpt{10}% |
| 4426 |
\abovedisplayskip 8.5\p@ \@plus3\p@ \@minus4\p@ |
| 4427 |
\abovedisplayshortskip \z@ \@plus2\p@ |
| 4428 |
\belowdisplayshortskip 4\p@ \@plus2\p@ \@minus2\p@ |
| 4429 |
\def\@listi{\leftmargin\leftmargini |
| 4430 |
\topsep 4\p@ \@plus2\p@ \@minus2\p@ |
| 4431 |
\parsep 2\p@ \@plus\p@ \@minus\p@ |
| 4432 |
\itemsep \parsep}% |
| 4433 |
\belowdisplayskip \abovedisplayskip |
| 4434 |
} |
| 4435 |
\makeatother} |
| 4436 |
|
| 4437 |
|
| 4438 |
% \end{macrocode} |
| 4439 |
% \end{macro} |
| 4440 |
% |
| 4441 |
|
| 4442 |
% \subsubsection{Internal font size commands} You will probably never need |
| 4443 |
% to use these font commands explicitly. I defined these for internal |
| 4444 |
% use within \textsf{poemscol}, so that a command will always call the |
| 4445 |
% same fonts. \label{internal font size commands} |
| 4446 |
% |
| 4447 |
% As a way of making global changes to repeated features I have |
| 4448 |
% defined various special fonts for special purposes. For instance, |
| 4449 |
% in a Collected Poems in which the poems are arranged by volume, with |
| 4450 |
% divider pages for the beginning of each volume, the first command |
| 4451 |
% sets the font for the volume title on the divider page, using the |
| 4452 |
% default font family, setting it in 18 point type on 23 point |
| 4453 |
% leading. The second command, as the name of the command indicates, |
| 4454 |
% sets the font for the subtitle of the volume to be 14 point type on |
| 4455 |
% 18 point leading. You can change these either by changing the |
| 4456 |
% values in your (renamed) style file, or by using |\renewcommand|. |
| 4457 |
% For instance, you can change the font parameters for the font for |
| 4458 |
% setting poem titles from 14 on 18 to 12 on 14 by issuing |
| 4459 |
% |\renewcommand{\poemtitlefont}{\fontsize{12}{14}\selectfont}| in |
| 4460 |
% your preamble. Notice that there are special fonts for titles in |
| 4461 |
% the back matter and in the table of contents as well. |
| 4462 |
|
| 4463 |
% \begin{macrocode} |
| 4464 |
\newcommand{\volumetitlefont}{\fontsize{18}{23}\selectfont} |
| 4465 |
\newcommand{\volumesubtitlefont}{\fontsize{14}{18}\selectfont} |
| 4466 |
\newcommand{\poemtitlefont}{\fontsize{14}{18}\selectfont} |
| 4467 |
\newcommand{\sequencetitlefont}{\fontsize{16}{20}\selectfont} |
| 4468 |
\newcommand{\subsectiontitlefont}{\fontsize{12}{14.5}\selectfont} |
| 4469 |
\newcommand{\backmatterheaderfont}{\fontsize{16}{20}\selectfont} |
| 4470 |
\newcommand{\volumetitlesink}{\leavevmode\vspace{23.5pt}} |
| 4471 |
\newcommand{\backmattersink}{\leavevmode\vspace{21.5pt}} |
| 4472 |
\newcommand{\backmatterafterheadersink}{\leavevmode\vspace{11pt}} |
| 4473 |
\newcommand{\backmattertextfont}{\small} |
| 4474 |
\newcommand{\backmatterintrofont}{\normalsize} |
| 4475 |
\newcommand{\backmattervolumefont}{\fontsize{12}{14.5}\selectfont} |
| 4476 |
\newcommand{\backmattervolumesubtitlefont}{\fontsize{11}{13}\selectfont} |
| 4477 |
\newcommand{\contentsvolumefont}{\fontsize{14}{20}\selectfont} |
| 4478 |
\newcommand{\contentsvolumesubtitlefont}{\fontsize{12}{14.5}\selectfont} |
| 4479 |
\newcommand{\contentssequencetitlefont}{\fontsize{10}{14}\selectfont} |
| 4480 |
\newcommand{\contentspoemtitlefont}{\fontsize{10}{14}\selectfont} |
| 4481 |
% \end{macrocode} |
| 4482 |
|
| 4483 |
% \subsection{~Miscellaneous dimensions and constants} |
| 4484 |
% \textsf{poemscol} sets relatively large penalties for widows and |
| 4485 |
% clubs, both in the main text, and in the notes sections. There are |
| 4486 |
% also special penalties after volume titles in the notes sections, |
| 4487 |
% since one does not want to leave a volume title in the notes |
| 4488 |
% sections stranded at the bottom of a page. (Setting penalties may |
| 4489 |
% not automatically solve all the problems, however. You can fix an |
| 4490 |
% intractable widow problem in the contents or in the notes sections |
| 4491 |
% by issuing |\literalcontents{\pagebreak}| or |
| 4492 |
% |\literalemend{\pagebreak}| just before you issue the |
| 4493 |
% |\poemtitle| or |\volumetitle| that resulted in the problematic |
| 4494 |
% title line.) \textsf{poemscol} also manipulates penalties for places like |
| 4495 |
% the space between a poem's title and its first line. It defines |
| 4496 |
% special values for the white space before and after poems and for |
| 4497 |
% the amount of a stanza break. |\contentsindentone|, |
| 4498 |
% |\contentsindenttwo|, and so on are amounts to indent different |
| 4499 |
% hierarchical levels, say of poetic sequences and subsequences, in |
| 4500 |
% the table of contents. |
| 4501 |
% \begin{macrocode} |
| 4502 |
\widowpenalty=300 |
| 4503 |
\clubpenalty=300 |
| 4504 |
\newcommand{\notespoemclubpenalty}{\penalty-300} |
| 4505 |
\newcommand{\notessequenceclubpenalty}{\penalty-1500} |
| 4506 |
\newcommand{\notesvolumetitlepenalty}{\penalty-1500} |
| 4507 |
% \end{macrocode} |
| 4508 |
% Since the right margin of verse is ragged anyway, I allowed some |
| 4509 |
% flexibility for slightly longer lines. |
| 4510 |
% \begin{macrocode} |
| 4511 |
\hfuzz=2pt |
| 4512 |
% \end{macrocode} |
| 4513 |
% For explicitly declared indented lines or ranges of lines: |
| 4514 |
% \begin{macrocode} |
| 4515 |
\newlength{\verseindentamount} |
| 4516 |
\setlength{\verseindentamount}{2em} |
| 4517 |
\newcount\l@@pcounter |
| 4518 |
\newcommand{\repeatedindent}[1]{\l@@pcounter=#1% |
| 4519 |
\loop% |
| 4520 |
\ifnum\l@@pcounter>0% |
| 4521 |
\hspace{\verseindentamount}% |
| 4522 |
\advance \l@@pcounter -1 |
| 4523 |
\repeat} |
| 4524 |
\newcommand{\verseindent}[1][]{% |
| 4525 |
\ifthenelse{\equal{#1}{}}{\hspace{\verseindentamount}}{\repeatedindent{#1}}} |
| 4526 |
%\newcommand{\verseindent}{\hspace{\verseindentamount}} %old version |
| 4527 |
\newlength{\indentedstanzaamount} |
| 4528 |
\setlength{\indentedstanzaamount}{\verseindentamount} |
| 4529 |
\newlength{\variablestanzaamount} |
| 4530 |
\setlength{\variablestanzaamount}{\indentedstanzaamount} |
| 4531 |
\newcommand{\adjustst@nzaindent}[1]{\l@@pcounter=#1% |
| 4532 |
\loop% |
| 4533 |
\addtolength{\variablestanzaamount}{\indentedstanzaamount}% |
| 4534 |
\advance \l@@pcounter -1% |
| 4535 |
\ifnum \l@@pcounter>0 |
| 4536 |
\repeat} |
| 4537 |
\newif\ifinindentedverse |
| 4538 |
\newenvironment{indentedverse}[1][]{% |
| 4539 |
\inindentedversetrue% |
| 4540 |
\ifthenelse{\equal{#1}{}}{\relax}{\adjustst@nzaindent{#1}}% |
| 4541 |
\let\\=\@centercr% |
| 4542 |
\list{}{\itemsep\z@ \itemindent -\runoverindentvalue\listparindent \itemindent |
| 4543 |
\rightmargin 0sp\leftmargin 0sp\advance\leftmargin |
| 4544 |
\variablestanzaamount}\item[]} |
| 4545 |
{\endlist\inindentedversefalse\setlength{\variablestanzaamount}{\indentedstanzaamount}} |
| 4546 |
% \end{macrocode} |
| 4547 |
% For multicolumn notes: |
| 4548 |
% \begin{macrocode} |
| 4549 |
\setlength{\columnsep}{15pt} |
| 4550 |
% \end{macrocode} |
| 4551 |
% A hierarchy of indentations for sequence section titles and |
| 4552 |
% subsection titles. |
| 4553 |
% \begin{macrocode} |
| 4554 |
\newlength{\titleindentamount} |
| 4555 |
\setlength{\titleindentamount}{1pc} |
| 4556 |
%\newdimen\titleindentamount \titleindentamount=1pc |
| 4557 |
%\newdimen\titleindenttwoamount \titleindenttwoamount=2pc |
| 4558 |
\newlength{\titleindenttwoamount} |
| 4559 |
\setlength{\titleindenttwoamount}{2pc} |
| 4560 |
\newlength{\titleindentthreeamount} |
| 4561 |
\setlength{\titleindentthreeamount}{3pc} |
| 4562 |
%\newdimen\titleindentthreeamount \titleindentthreeamount=3pc |
| 4563 |
\newcommand{\titleindent}{\hspace{\titleindentamount}} |
| 4564 |
\setlength{\parindent}{1pc} |
| 4565 |
\newlength{\volumetitleindentamount} |
| 4566 |
\setlength{\volumetitleindentamount}{0pt} |
| 4567 |
%\newcommand{\volumetitleindent}{\hspace{\volumetitleindentamount}} |
| 4568 |
\newcommand{\volumetitleindent}{\relax} |
| 4569 |
\newlength{\volumetitlesecondlineindentamount} |
| 4570 |
\setlength{\volumetitlesecondlineindentamount}{0pt} |
| 4571 |
%\newcommand{\volumetitlesecondlineindent}{\hspace{\volumetitlesecondlineindentamount}} |
| 4572 |
\newcommand{\volumetitlesecondlineindent}{\relax} |
| 4573 |
% \titleindentamount=1pc |
| 4574 |
\newlength{\volumesubtitleindentamount} |
| 4575 |
\setlength{\volumesubtitleindentamount}{\titleindentamount} |
| 4576 |
\newcommand{\volumesubtitleindent}{\hspace{\volumesubtitleindentamount}} |
| 4577 |
\newlength{\volumesubtitlesecondlineindentamount} |
| 4578 |
\setlength{\volumesubtitlesecondlineindentamount}{\titleindentamount} |
| 4579 |
\newcommand{\volumesubtitlesecondlineindent}{\hspace{\volumesubtitlesecondlineindentamount}} |
| 4580 |
\newlength{\volumesectiontitleindentamount} |
| 4581 |
\setlength{\volumesectiontitleindentamount}{0pt} |
| 4582 |
% \newcommand{\volumesectiontitleindent}{\hspace{\volumesectiontitleindentamount}} |
| 4583 |
\newcommand{\volumesectiontitleindent}{\relax} |
| 4584 |
\newlength{\volumesectiontitlesecondlineindentamount} |
| 4585 |
\setlength{\volumesectiontitlesecondlineindentamount}{0pt} |
| 4586 |
% \newcommand{\volumesectiontitlesecondlineindent}{\hspace{\volumesectiontitlesecondlineindentamount}} |
| 4587 |
\newcommand{\volumesectiontitlesecondlineindent}{\relax} |
| 4588 |
\newlength{\poemtitleindentamount} |
| 4589 |
\setlength{\poemtitleindentamount}{0pt} |
| 4590 |
% \newcommand{\poemtitleindent}{\hspace{\poemtitleindentamount}} |
| 4591 |
\newcommand{\poemtitleindent}{\relax} |
| 4592 |
\newlength{\poemtitlesecondlineindentamount} |
| 4593 |
\setlength{\poemtitlesecondlineindentamount}{0pt} |
| 4594 |
% \newcommand{\poemtitlesecondlineindent}{\hspace{\poemtitlesecondlineindentamount}} |
| 4595 |
\newcommand{\poemtitlesecondlineindent}{\relax} |
| 4596 |
\newlength{\poemsubtitleindentamount} |
| 4597 |
\setlength{\poemsubtitleindentamount}{\titleindentamount} |
| 4598 |
\newcommand{\poemsubtitleindent}{\hspace{\poemsubtitleindentamount}} |
| 4599 |
\newlength{\poemsectiontitleindentamount} |
| 4600 |
\setlength{\poemsectiontitleindentamount}{\titleindentamount} |
| 4601 |
\newcommand{\poemsectiontitleindent}{\hspace{\poemsectiontitleindentamount}} |
| 4602 |
\newlength{\poemsectiontitlesecondlineindentamount} |
| 4603 |
\setlength{\poemsectiontitlesecondlineindentamount}{\titleindentamount} |
| 4604 |
\newcommand{\poemsectiontitlesecondlineindent}{\hspace{\poemsectiontitlesecondlineindentamount}} |
| 4605 |
\newlength{\poemsubsectiontitleindentamount} |
| 4606 |
\setlength{\poemsubsectiontitleindentamount}{\titleindenttwoamount} |
| 4607 |
\newcommand{\poemsubsectiontitleindent}{\hspace{\poemsectiontitleindentamount}} |
| 4608 |
\newlength{\sequencetitleindentamount} |
| 4609 |
\setlength{\sequencetitleindentamount}{0pt} |
| 4610 |
% \newcommand{\sequencetitleindent}{\hspace{\sequencetitleindentamount}} |
| 4611 |
\newcommand{\sequencetitleindent}{\relax} |
| 4612 |
\newlength{\sequencetitlesecondlineindentamount} |
| 4613 |
\setlength{\sequencetitlesecondlineindentamount}{0pt} |
| 4614 |
% \newcommand{\sequencetitlesecondlineindent}{\hspace{\sequencetitlesecondlineindentamount}} |
| 4615 |
\newcommand{\sequencetitlesecondlineindent}{\hspace{\relax}} |
| 4616 |
\newlength{\sequencesubtitleindentamount} |
| 4617 |
\setlength{\sequencesubtitleindentamount}{\titleindentamount} |
| 4618 |
\newcommand{\sequencesubtitleindent}{\hspace{\sequencesubtitleindentamount}} |
| 4619 |
\newlength{\sequencesubtitlesecondlineindentamount} |
| 4620 |
\setlength{\sequencesubtitlesecondlineindentamount}{\titleindentamount} |
| 4621 |
\newcommand{\sequencesubtitlesecondlineindent}{\hspace{\sequencesubtitlesecondlineindentamount}} |
| 4622 |
\newlength{\sequencesectiontitleindentamount} |
| 4623 |
\setlength{\sequencesectiontitleindentamount}{\titleindentamount} |
| 4624 |
\newcommand{\sequencesectiontitleindent}{\hspace{\sequencesectiontitleindentamount}} |
| 4625 |
\newlength{\sequencesectiontitlesecondlineindentamount} |
| 4626 |
\setlength{\sequencesectiontitlesecondlineindentamount}{\titleindentamount} |
| 4627 |
\newcommand{\sequencesectiontitlesecondlineindent}{\hspace{\sequencesectiontitlesecondlineindentamount}} |
| 4628 |
\newlength{\sequencesectionsubtitleindentamount} |
| 4629 |
\setlength{\sequencesectionsubtitleindentamount}{\titleindenttwoamount} |
| 4630 |
\newcommand{\sequencesectionsubtitleindent}{\hspace{\sequencesectionsubtitleindentamount}} |
| 4631 |
\newlength{\sequencesectionsubtitlesecondlineindentamount} |
| 4632 |
\setlength{\sequencesectionsubtitlesecondlineindentamount}{\titleindenttwoamount} |
| 4633 |
\newcommand{\sequencesectionsubtitlesecondlineindent}{\hspace{\sequencesectionsubtitlesecondlineindentamount}} |
| 4634 |
\newlength{\sequencesubsectiontitleindentamount} |
| 4635 |
\setlength{\sequencesubsectiontitleindentamount}{\titleindenttwoamount} |
| 4636 |
\newcommand{\sequencesubsectiontitleindent}{\hspace{\sequencesubsectiontitleindentamount}} |
| 4637 |
\newlength{\sequencesubsubsectiontitleindentamount} |
| 4638 |
\setlength{\sequencesubsubsectiontitleindentamount}{\titleindentthreeamount} |
| 4639 |
\newcommand{\sequencesubsubsectiontitleindent}{\hspace{\sequencesubsubsectiontitleindentamount}} |
| 4640 |
\newlength{\appendixtitleindentamount} |
| 4641 |
\setlength{\appendixtitleindentamount}{0pt} |
| 4642 |
% \newcommand{\appendixtitleindent}{\hspace{\appendixtitleindentamount}} |
| 4643 |
\newcommand{\appendixtitleindent}{\relax} |
| 4644 |
\newlength{\subappendixtitleindentamount} |
| 4645 |
\setlength{\subappendixtitleindentamount}{0pt} |
| 4646 |
% \newcommand{\subappendixtitleindent}{\hspace{\subappendixtitleindentamount}} |
| 4647 |
\newcommand{\subappendixtitleindent}{\relax} |
| 4648 |
\newlength{\forewordtitleindentamount} |
| 4649 |
\setlength{\forewordtitleindentamount}{0pt} |
| 4650 |
% \newcommand{\forewordtitleindent}{\hspace{\forewordtitleindentamount}} |
| 4651 |
\newcommand{\forewordtitleindent}{\relax} |
| 4652 |
\newlength{\notestitleindentamount} |
| 4653 |
\setlength{\notestitleindentamount}{0pt} |
| 4654 |
% \newcommand{\notestitleindent}{\hspace{\notestitleindentamount}} |
| 4655 |
\newcommand{\notestitleindent}{\relax} |
| 4656 |
|
| 4657 |
% \end{macrocode} |
| 4658 |
% A hierarchy of indentations for the table of contents: \label{contents indentation hierarchy} |
| 4659 |
% \begin{macrocode} |
| 4660 |
\newdimen\volumetitleshiftamount \volumetitleshiftamount=1pc |
| 4661 |
\newcommand{\volumetitleshift}{\hbox{\hspace{\volumetitleshiftamount}}} |
| 4662 |
\newdimen\voladditionalamount \voladditionalamount=2pc |
| 4663 |
\newdimen\contentsindentoneamount \contentsindentoneamount=24pt |
| 4664 |
\newcommand{\contentsindentone}{\hspace{\contentsindentoneamount}} |
| 4665 |
\newdimen\contentsindenttwoamount \contentsindenttwoamount=42pt |
| 4666 |
\newcommand{\contentsindenttwo}{\hspace{\contentsindenttwoamount}} |
| 4667 |
\newdimen\contentsindentthreeamount \contentsindentthreeamount=60pt |
| 4668 |
\newcommand{\contentsindentthree}{\hspace{\contentsindentthreeamount}} |
| 4669 |
\newdimen\contentsindentfouramount \contentsindentfouramount=72pt |
| 4670 |
\newcommand{\contentsindentfour}{\hspace{\contentsindentfouramount}} |
| 4671 |
\newdimen\contentsindentfiveamount \contentsindentfiveamount=80pt |
| 4672 |
\newcommand{\contentsindentfive}{\hspace{\contentsindentfiveamount}} |
| 4673 |
% \end{macrocode} |
| 4674 |
% A hierarchy of indentations for sequence section titles and |
| 4675 |
% subsection titles in the table of contents. |
| 4676 |
% \begin{macrocode} |
| 4677 |
\newlength{\contentsvolumetitleindentamount} |
| 4678 |
\setlength{\contentsvolumetitleindentamount}{0pt} |
| 4679 |
%\newcommand{\contentsvolumetitleindent}{\hspace{\contentsvolumetitleindentamount}} |
| 4680 |
\newcommand{\contentsvolumetitleindent}{\relax} |
| 4681 |
\newlength{\contentsvolumetitlesecondlineindentamount} |
| 4682 |
\setlength{\contentsvolumetitlesecondlineindentamount}{0pt} |
| 4683 |
%\newcommand{\contentsvolumetitlesecondlineindent}{\hspace{\contentsvolumetitlesecondlineindentamount}} |
| 4684 |
\newcommand{\contentsvolumetitlesecondlineindent}{\relax} |
| 4685 |
\newlength{\contentsvolumesubtitleindentamount} |
| 4686 |
\setlength{\contentsvolumesubtitleindentamount}{\titleindentamount} |
| 4687 |
\newcommand{\contentsvolumesubtitleindent}{\hspace{\contentsvolumesubtitleindentamount}} |
| 4688 |
\newlength{\contentsvolumesubtitlesecondlineindentamount} |
| 4689 |
\setlength{\contentsvolumesubtitlesecondlineindentamount}{\titleindentamount} |
| 4690 |
\newcommand{\contentsvolumesubtitlesecondlineindent}{\hspace{\contentsvolumesubtitlesecondlineindentamount}} |
| 4691 |
\newlength{\contentsvolumesectiontitleindentamount} |
| 4692 |
\setlength{\contentsvolumesectiontitleindentamount}{0pt} |
| 4693 |
\newcommand{\contentsvolumesectiontitleindent}{\hspace{\contentsvolumesectiontitleindentamount}} |
| 4694 |
%\newcommand{\contentsvolumesectiontitleindent}{\relax} |
| 4695 |
\newlength{\contentsvolumesectiontitlesecondlineindentamount} |
| 4696 |
\setlength{\contentsvolumesectiontitlesecondlineindentamount}{0pt} |
| 4697 |
\newcommand{\contentsvolumesectiontitlesecondlineindent}{\hspace{\contentsvolumesectiontitlesecondlineindentamount}} |
| 4698 |
\newlength{\contentspoemtitleindentamount} |
| 4699 |
\setlength{\contentspoemtitleindentamount}{\contentsindentoneamount} |
| 4700 |
%\setlength{\contentspoemtitleindentamount}{0pt} |
| 4701 |
\newcommand{\contentspoemtitleindent}{\hspace{\contentspoemtitleindentamount}} |
| 4702 |
%\newcommand{\contentspoemtitleindent}{\relax} |
| 4703 |
\newlength{\contentspoemtitlesecondlineindentamount} |
| 4704 |
\setlength{\contentspoemtitlesecondlineindentamount}{\contentspoemtitleindentamount} |
| 4705 |
\newcommand{\contentspoemtitlesecondlineindent}{\hspace{\contentspoemtitlesecondlineindentamount}} |
| 4706 |
%\newcommand{\contentspoemtitlesecondlineindent}{\relax} |
| 4707 |
\newlength{\contentspoemsubtitleindentamount} |
| 4708 |
\setlength{\contentspoemsubtitleindentamount}{\contentspoemsubtitleindentamount} |
| 4709 |
\newcommand{\contentspoemsubtitleindent}{\hspace{\contentspoemsubtitleindentamount}} |
| 4710 |
\newlength{\contentspoemsectiontitleindentamount} |
| 4711 |
\setlength{\contentspoemsectiontitleindentamount}{\contentsindenttwoamount} |
| 4712 |
\newcommand{\contentspoemsectiontitleindent}{\hspace{\contentspoemsectiontitleindentamount}} |
| 4713 |
\newlength{\contentspoemsectiontitlesecondlineindentamount} |
| 4714 |
\setlength{\contentspoemsectiontitlesecondlineindentamount}{\contentspoemsectiontitleindentamount} |
| 4715 |
\newcommand{\contentspoemsectiontitlesecondlineindent}{\hspace{\contentspoemsectiontitlesecondlineindentamount}} |
| 4716 |
\newlength{\contentspoemsubsectiontitleindentamount} |
| 4717 |
\setlength{\contentspoemsubsectiontitleindentamount}{\contentsindentthreeamount} |
| 4718 |
\newcommand{\contentspoemsubsectiontitleindent}{\hspace{\contentsindentthreeamount}} |
| 4719 |
\newlength{\contentssequencetitleindentamount} |
| 4720 |
\setlength{\contentssequencetitleindentamount}{\contentsindentoneamount} %313 |
| 4721 |
\newcommand{\contentssequencetitleindent}{\hspace{\contentssequencetitleindentamount}} |
| 4722 |
%\newcommand{\contentssequencetitleindent}{\relax} |
| 4723 |
\newlength{\contentssequencetitlesecondlineindentamount} |
| 4724 |
\setlength{\contentssequencetitlesecondlineindentamount}{\contentsindentoneamount} %313 |
| 4725 |
\newcommand{\contentssequencetitlesecondlineindent}{\hspace{\contentssequencetitlesecondlineindentamount}} |
| 4726 |
%\newcommand{\contentssequencetitlesecondlineindent}{\hspace{\relax}} |
| 4727 |
\newlength{\contentssequencesubtitleindentamount} |
| 4728 |
\setlength{\contentssequencesubtitleindentamount}{\contentsindenttwoamount} %313 |
| 4729 |
\newcommand{\contentssequencesubtitleindent}{\hspace{\contentssequencesubtitleindentamount}} |
| 4730 |
\newlength{\contentssequencesubtitlesecondlineindentamount} |
| 4731 |
\setlength{\contentssequencesubtitlesecondlineindentamount}{\contentsindenttwoamount} %313 |
| 4732 |
\newcommand{\contentssequencesubtitlesecondlineindent}{\hspace{\contentssequencesubtitlesecondlineindentamount}} |
| 4733 |
\newlength{\contentssequencesectiontitleindentamount} |
| 4734 |
\setlength{\contentssequencesectiontitleindentamount}{\contentsindenttwoamount} %313 |
| 4735 |
\newcommand{\contentssequencesectiontitleindent}{\hspace{\contentssequencesectiontitleindentamount}} |
| 4736 |
\newlength{\contentssequencesectiontitlesecondlineindentamount} |
| 4737 |
\setlength{\contentssequencesectiontitlesecondlineindentamount}{\contentsindenttwoamount} %313 |
| 4738 |
\newcommand{\contentssequencesectiontitlesecondlineindent}{\hspace{\contentssequencesectiontitlesecondlineindentamount}} |
| 4739 |
\newlength{\contentssequencesectionsubtitleindentamount} |
| 4740 |
\setlength{\contentssequencesectionsubtitleindentamount}{\contentsindentthreeamount} %313 |
| 4741 |
\newcommand{\contentssequencesectionsubtitleindent}{\hspace{\contentssequencesectionsubtitleindentamount}} |
| 4742 |
\newlength{\contentssequencesectionsubtitlesecondlineindentamount} |
| 4743 |
\setlength{\contentssequencesectionsubtitlesecondlineindentamount}{\contentsindentthreeamount}%313 |
| 4744 |
\newcommand{\contentssequencesectionsubtitlesecondlineindent}{\hspace{\contentssequencesectionsubtitlesecondlineindentamount}} |
| 4745 |
\newlength{\contentssequencesubsectiontitleindentamount} |
| 4746 |
\setlength{\contentssequencesubsectiontitleindentamount}{\contentsindentthreeamount} |
| 4747 |
\newcommand{\contentssequencesubsectiontitleindent}{\hspace{\contentssequencesubsectiontitleindentamount}} |
| 4748 |
\newlength{\contentssequencesubsubsectiontitleindentamount} |
| 4749 |
\setlength{\contentssequencesubsubsectiontitleindentamount}{\contentsindentfouramount} |
| 4750 |
\newcommand{\contentssequencesubsubsectiontitleindent}{\hspace{\contentssequencesubsubsectiontitleindentamount}} |
| 4751 |
|
| 4752 |
|
| 4753 |
% \end{macrocode} |
| 4754 |
% White space after poem titles, after poems, and after sequence |
| 4755 |
% titles. \label{skiplist} |
| 4756 |
% \begin{macrocode} |
| 4757 |
\newcommand{\afterpoemtitleskip}{\smallskip} |
| 4758 |
\newcommand{\afterpoemskip}{\bigskip} |
| 4759 |
\newcommand{\aftersequencetitleskip}{\medskip} |
| 4760 |
% \end{macrocode} |
| 4761 |
% A little extra white space between stanzas. |
| 4762 |
% \begin{macrocode} |
| 4763 |
\newcommand{\stanzaskip}{\medskip} |
| 4764 |
% \end{macrocode} |
| 4765 |
% Penalties to encourage page breaks before poem titles, before |
| 4766 |
% multi-line poem titles, and before sequence titles. |
| 4767 |
% \begin{macrocode} |
| 4768 |
\newcommand{\poemtitlepenalty}{\penalty-1000} |
| 4769 |
\newcommand{\multilinetitlepenalty}{\penalty-3000} |
| 4770 |
\newcommand{\sequencetitlepenalty}{\penalty-3000} |
| 4771 |
\newcommand{\multilinesequencepenalty}{\penalty-3500} |
| 4772 |
% \end{macrocode} |
| 4773 |
% \subsection{~Title Schemes} Ways of controlling the placement of titles. |
| 4774 |
% \begin{macrocode} |
| 4775 |
\newlength{\poemtitlewidth} |
| 4776 |
\newif\iftitlescenteredonleftverseblock |
| 4777 |
\newif\iftitlesatleftmarginofcenteredblock |
| 4778 |
\newif\iftitlesatleftversemargin |
| 4779 |
\newif\ifnormaltitleindentation |
| 4780 |
% |
| 4781 |
\newcommand{\normaltitleindentationscheme}{% |
| 4782 |
\normaltitleindentationtrue% |
| 4783 |
\titlesatleftversemarginfalse% |
| 4784 |
\titlescenteredonleftverseblockfalse% |
| 4785 |
\titlesatleftmarginofcenteredblockfalse% |
| 4786 |
\centertitlesonfalse% |
| 4787 |
} |
| 4788 |
\newcommand{\titlesatleftversemarginscheme}{% |
| 4789 |
\normaltitleindentationfalse% |
| 4790 |
\titlesatleftversemargintrue% |
| 4791 |
\titlescenteredonleftverseblockfalse% |
| 4792 |
\titlesatleftmarginofcenteredblockfalse% |
| 4793 |
\centertitlesonfalse% |
| 4794 |
} |
| 4795 |
\newcommand{\titlescenteredonleftverseblockscheme}{% |
| 4796 |
\normaltitleindentationfalse% |
| 4797 |
\titlesatleftversemarginfalse% |
| 4798 |
\titlescenteredonleftverseblocktrue% |
| 4799 |
\titlesatleftmarginofcenteredblockfalse% |
| 4800 |
\centertitlesonfalse% |
| 4801 |
} |
| 4802 |
\newcommand{\titlesatleftmarginofcenteredblockscheme}{% |
| 4803 |
\normaltitleindentationfalse% |
| 4804 |
\titlesatleftversemarginfalse% |
| 4805 |
\titlescenteredonleftverseblockfalse% |
| 4806 |
\titlesatleftmarginofcenteredblocktrue% |
| 4807 |
\centertitlesonfalse% |
| 4808 |
} |
| 4809 |
\newcommand{\centertitlesscheme}{% |
| 4810 |
\normaltitleindentationfalse% |
| 4811 |
\titlesatleftversemarginfalse% |
| 4812 |
\titlescenteredonleftverseblockfalse% |
| 4813 |
\titlesatleftmarginofcenteredblockfalse% |
| 4814 |
\centertitlesontrue% |
| 4815 |
\centerepigraphsontrue% |
| 4816 |
} |
| 4817 |
\newlength{\lefttitleaddition} |
| 4818 |
\setlength{\lefttitleaddition}{0pt} |
| 4819 |
\newcommand{\l@ftc@ntertitleblock}{\rightmargin \z@%% |
| 4820 |
\setlength{\lefttitleaddition}{\versewidth}% |
| 4821 |
\addtolength{\lefttitleaddition}{-\poemtitlewidth}% |
| 4822 |
\addtolength{\lefttitleaddition}{-0.5\lefttitleaddition}% |
| 4823 |
\setlength{\lefttitlemargin}{\lefttitleaddition}% |
| 4824 |
} |
| 4825 |
|
| 4826 |
% \end{macrocode} |
| 4827 |
% \subsection{~Verse} The verse environment here is taken from \LaTeX, |
| 4828 |
% slightly modified to indent run over lines more. The idea is to |
| 4829 |
% distinguish the automatic indentation of run over lines from the |
| 4830 |
% explicitly declared indentation of indented lines. You can change |
| 4831 |
% the amount of indentation of runover lines with |\runoverindent|. |
| 4832 |
% \label{versedefine} |
| 4833 |
% \begin{macrocode} |
| 4834 |
\def\makeatletter{\catcode`\@=11} |
| 4835 |
\def\makeatother{\catcode`\@=12 } |
| 4836 |
\newcommand{\runoverindent}[1]{\global\edef\runoverindentvalue{#1} |
| 4837 |
} |
| 4838 |
\runoverindent{6em} |
| 4839 |
% pmclverse (runover indented more than it is in the normal verse |
| 4840 |
% environment) |
| 4841 |
% \newenvironment{pmclverse}{% |
| 4842 |
% \let\\=\@centercr% |
| 4843 |
% \list{}{\itemsep\z@ \itemindent -\runoverindentvalue\listparindent \itemindent |
| 4844 |
% \rightmargin 1sp\leftmargin 1sp\advance\leftmargin |
| 4845 |
% \runoverindentvalue}\item[]} |
| 4846 |
% {\endlist} |
| 4847 |
\newif\iflinenumberscenteredwithverse |
| 4848 |
\linenumberscenteredwithversetrue |
| 4849 |
% |
| 4850 |
\newlength{\marginparsepmin} |
| 4851 |
\setlength{\marginparsepmin}{2em} |
| 4852 |
% |
| 4853 |
\newlength{\versemarginadjust} |
| 4854 |
\setlength{\versemarginadjust}{0pt} |
| 4855 |
% |
| 4856 |
\newif\iftextcenteringturnedon |
| 4857 |
\textcenteringturnedontrue |
| 4858 |
% |
| 4859 |
\newcommand{\v@riablemarginpar}{\setlength{\marginparsep}{-\leftmargin}% |
| 4860 |
\addtolength{\marginparsep}{\marginparsepmin}} |
| 4861 |
% |
| 4862 |
\newcommand{\c@nterverseblock}[1]{\rightmargin \z@% |
| 4863 |
\setlength{\leftmargin}{\linewidth}% |
| 4864 |
\addtolength{\leftmargin}{-#1}% |
| 4865 |
\addtolength{\leftmargin}{-0.5\leftmargin}% |
| 4866 |
\iflinenumberscenteredwithverse\v@riablemarginpar\fi} |
| 4867 |
\newif\iflastpoemcentered |
| 4868 |
\newenvironment{pmclverse}[1][\linewidth]{% |
| 4869 |
\global\lastpoemcenteredfalse |
| 4870 |
\let\\=\@centercr% |
| 4871 |
\list{}{\itemsep\z@ |
| 4872 |
\itemindent -\runoverindentvalue |
| 4873 |
\listparindent \itemindent |
| 4874 |
\ifdim #1 < \linewidth |
| 4875 |
\iftextcenteringturnedon |
| 4876 |
\c@nterverseblock{#1}% |
| 4877 |
\global\lastpoemcenteredtrue |
| 4878 |
\else |
| 4879 |
\rightmargin \leftmargin |
| 4880 |
\addtolength{\leftmargin}{-\versemarginadjust}\fi |
| 4881 |
\else |
| 4882 |
\rightmargin \leftmargin |
| 4883 |
\addtolength{\leftmargin}{-\versemarginadjust} |
| 4884 |
\fi |
| 4885 |
\advance\leftmargin\runoverindentvalue} |
| 4886 |
\item[]} |
| 4887 |
{\endlist} |
| 4888 |
% next is from 2.88 |
| 4889 |
%\newenvironment{pmclverse}[1][\linewidth]{% |
| 4890 |
%\let\\=\@centercr% |
| 4891 |
%\list{}{\itemsep\z@ |
| 4892 |
%\itemindent -\runoverindentvalue |
| 4893 |
%\listparindent \itemindent |
| 4894 |
% \ifdim #1 < \linewidth |
| 4895 |
% \iftextcenteringturnedon |
| 4896 |
% \c@nterverseblock{#1}% |
| 4897 |
% \else |
| 4898 |
% \rightmargin \leftmargin |
| 4899 |
% \addtolength{\leftmargin}{-\versemarginadjust}\fi |
| 4900 |
% \else |
| 4901 |
% \rightmargin \leftmargin |
| 4902 |
% \addtolength{\leftmargin}{-\versemarginadjust} |
| 4903 |
% \fi |
| 4904 |
%\advance\leftmargin\runoverindentvalue} |
| 4905 |
%\item[]} |
| 4906 |
%{\endlist}% from 2.72 with additions |
| 4907 |
% \newenvironment{pmclverse}[1][\linewidth]{% |
| 4908 |
% \let\\=\@centercr% |
| 4909 |
% \list{}{\itemsep\z@ |
| 4910 |
% \itemindent -\runoverindentvalue |
| 4911 |
% \listparindent \itemindent |
| 4912 |
% \ifdim #1 < \linewidth |
| 4913 |
% \rightmargin \z@ |
| 4914 |
% \setlength{\leftmargin}{\linewidth}% |
| 4915 |
% \addtolength{\leftmargin}{-#1}% |
| 4916 |
% \addtolength{\leftmargin}{-0.5\leftmargin}% |
| 4917 |
% \iflinenumberscenteredwithverse |
| 4918 |
% \setlength{\marginparsep}{-\leftmargin+\marginparsepmin} |
| 4919 |
% \fi |
| 4920 |
% \else |
| 4921 |
% \rightmargin \leftmargin |
| 4922 |
% \addtolength{\leftmargin}{-\versemarginadjust} |
| 4923 |
% \fi |
| 4924 |
% \advance\leftmargin\runoverindentvalue} |
| 4925 |
% \item[]} |
| 4926 |
% {\endlist\setlength{\marginparsep}{0pt}} % from email |
| 4927 |
|
| 4928 |
% \newenvironment{pmclverse}[1][\linewidth]{% |
| 4929 |
% \let\\=\@centercr% |
| 4930 |
% \list{}{\itemsep\z@ |
| 4931 |
% \itemindent -\runoverindentvalue |
| 4932 |
% \listparindent \itemindent |
| 4933 |
% \iftextcenteringturnedon |
| 4934 |
% \ifdim #1 < \linewidth |
| 4935 |
% \rightmargin \z@ |
| 4936 |
% \setlength{\leftmargin}{\linewidth}% |
| 4937 |
% \addtolength{\leftmargin}{-#1}% |
| 4938 |
% \addtolength{\leftmargin}{-0.5\leftmargin}% |
| 4939 |
% \iflinenumberscenteredwithverse\setlength{\marginparsep}{-\leftmargin+\marginparsepmin}\fi |
| 4940 |
% \else |
| 4941 |
% \rightmargin \leftmargin |
| 4942 |
% \addtolength{\leftmargin}{-\versemarginadjust} |
| 4943 |
% \fi % linewidth |
| 4944 |
% \else |
| 4945 |
% \rightmargin \leftmargin |
| 4946 |
% \addtolength{\leftmargin}{-\versemarginadjust} |
| 4947 |
% |
| 4948 |
% \fi% textcentering |
| 4949 |
% \advance\leftmargin\runoverindentvalue} |
| 4950 |
% \item[]} |
| 4951 |
% {\endlist\setlength{\marginparsep}{0pt}}% % draft |
| 4952 |
|
| 4953 |
% \let\\=\@centercr% |
| 4954 |
% \list{}{\itemsep\z@ |
| 4955 |
% \itemindent -\runoverindentvalue |
| 4956 |
% \listparindent \itemindent |
| 4957 |
% \ifdim #1 < \linewidth |
| 4958 |
% \rightmargin \z@ |
| 4959 |
% \setlength{\leftmargin}{\linewidth}% |
| 4960 |
% \addtolength{\leftmargin}{-#1}% |
| 4961 |
% \addtolength{\leftmargin}{-0.5\leftmargin}% |
| 4962 |
% \else |
| 4963 |
% \rightmargin \leftmargin |
| 4964 |
% \addtolength{\leftmargin}{-\versemarginadjust} |
| 4965 |
% \fi |
| 4966 |
% \advance\leftmargin\runoverindentvalue} |
| 4967 |
% \item[]} |
| 4968 |
% {\endlist} % first version from 2.81 |
| 4969 |
% \newenvironment{pmclverse}[1][\linewidth]{% |
| 4970 |
% \let\\=\@centercr% |
| 4971 |
% \list{}{\itemsep\z@ |
| 4972 |
% \itemindent -\runoverindentvalue |
| 4973 |
% \listparindent \itemindent |
| 4974 |
% \ifdim #1 < \linewidth |
| 4975 |
% \rightmargin \z@ |
| 4976 |
% \setlength{\leftmargin}{\linewidth}% |
| 4977 |
% \addtolength{\leftmargin}{-#1}% |
| 4978 |
% \addtolength{\leftmargin}{-0.5\leftmargin}% |
| 4979 |
% \else |
| 4980 |
% \rightmargin \leftmargin |
| 4981 |
% \fi |
| 4982 |
% \advance\leftmargin\runoverindentvalue} |
| 4983 |
% \item[]} |
| 4984 |
% {\endlist}% from 2.72 |
| 4985 |
\newif\ifinquotedverse |
| 4986 |
\newenvironment{quotedverse}{% |
| 4987 |
\inquotedversetrue |
| 4988 |
\let\\=\@centercr% |
| 4989 |
\list{}{\itemsep\z@ \itemindent -\runoverindentvalue\listparindent \itemindent |
| 4990 |
\rightmargin 0sp\leftmargin 0sp\advance\leftmargin |
| 4991 |
\runoverindentvalue}\item[]} |
| 4992 |
{\endlist\inquotedversefalse} |
| 4993 |
% rfoverse (flushes runover to right) (Just a placeholder now.) |
| 4994 |
% \newif\ifrfv |
| 4995 |
% \rfvfalse |
| 4996 |
% \newcommand{\rightflushrunoververse}{\global\rfvtrue} |
| 4997 |
% \newcommand{\indentrunoververse}{\global\rfvfalse} |
| 4998 |
% \newenvironment{rfoverse}{\begin{pmclverse}}{\end{pmclverse}} |
| 4999 |
% % verse environment with a switch |
| 5000 |
% \renewenvironment{verse}{\ifrfv\begin{rfoverse}\else\begin{pmclverse}\fi} |
| 5001 |
% {\ifrfv\end{rfoverse}\else\end{pmclverse}\fi} |
| 5002 |
% \end{macrocode} |
| 5003 |
|
| 5004 |
% \subsection{~Miscellaneous internal counters} |
| 5005 |
% |\verselinenumber| is the line number, obviously. |\printlineindex| |
| 5006 |
% records how many lines have passed since the last marginal line |
| 5007 |
% number was output. |\lineindexrepeat| governs how often the marginal |
| 5008 |
% line numbers appear. |\lemmalines| and |\lemmaend| are for setting |
| 5009 |
% number ranges for multiline lemmas. |
| 5010 |
% \begin{macrocode} |
| 5011 |
\newcounter{verselinenumber} |
| 5012 |
\newcounter{printlineindex} |
| 5013 |
\newcounter{verselinenumberscratch} |
| 5014 |
\newcounter{printlineindexscratch} |
| 5015 |
\newcounter{lineindexrepeat} \setcounter{lineindexrepeat}{9} |
| 5016 |
\newcounter{lemmalines} |
| 5017 |
\setcounter{lemmalines}{0} |
| 5018 |
\newcounter{lemmaend} |
| 5019 |
\setcounter{lemmaend}{0} |
| 5020 |
% \end{macrocode} |
| 5021 |
% This next counter is used to make labels for each poem for the contents and notes sections. |
| 5022 |
% \begin{macrocode} |
| 5023 |
\newcounter{poemnumber} |
| 5024 |
\setcounter{poemnumber}{1} |
| 5025 |
% \end{macrocode} |
| 5026 |
% These next two are used to set the page numbers in the running |
| 5027 |
% headers of the various notes sections, which are of the form |
| 5028 |
% ``Textual notes to pp.~xx--yy.'' |
| 5029 |
% \begin{macrocode} |
| 5030 |
\newcounter{notepageholdertitle} \setcounter{notepageholdertitle}{1} |
| 5031 |
\newcounter{notepageholdernote} \setcounter{notepageholdernote}{1} |
| 5032 |
% \end{macrocode} |
| 5033 |
% \subsection{~Miscellaneous token lists} |
| 5034 |
% Since the explanatory notes section and the emendations section should |
| 5035 |
% only open an entry for poems for which there actually are explanatory notes or |
| 5036 |
% emendations, the current are held in token lists in case they are needed.|\titlesofar| |
| 5037 |
% and |\titleincrement| are used to concatenate multi-line titles. |
| 5038 |
% \begin{macrocode} |
| 5039 |
\newtoks{\fulltitleholder} |
| 5040 |
\newtoks{\titlesofar} |
| 5041 |
\newtoks{\titleincrement} |
| 5042 |
% \end{macrocode} |
| 5043 |
% \subsection{~Miscellaneous booleans} |
| 5044 |
% Most of these have self-explanatory names. |
| 5045 |
% \begin{macrocode} |
| 5046 |
\newif\ifinstanza |
| 5047 |
\newif\ifinpoem |
| 5048 |
\newif\ifpoemcontentson |
| 5049 |
\newif\iftextnoteson |
| 5050 |
\newif\ifverselinenumbers |
| 5051 |
\newif\ifexplanon |
| 5052 |
\newif\ifemendationson |
| 5053 |
\global\verselinenumberstrue |
| 5054 |
\newif\ifindexingon |
| 5055 |
\global\indexingontrue |
| 5056 |
\ifindexingon |
| 5057 |
\makeindex |
| 5058 |
\fi |
| 5059 |
\newif\ifincludeaccidentals |
| 5060 |
\global\includeaccidentalstrue |
| 5061 |
\newif\ifincludetypescripts |
| 5062 |
\global\includetypescriptstrue |
| 5063 |
\newif\ifredundantemendations |
| 5064 |
\global\redundantemendationsfalse |
| 5065 |
\newif\ifnoemendyet |
| 5066 |
\newif\ifnoexplainyet |
| 5067 |
\global\noemendyettrue |
| 5068 |
\global\noexplainyettrue |
| 5069 |
\newif{\ifmiddlecontentsline} |
| 5070 |
\middlecontentslinefalse |
| 5071 |
\newif{\iflastcontentsline} |
| 5072 |
\lastcontentslinefalse |
| 5073 |
\newif{\ifputpagenumberincontents} |
| 5074 |
\putpagenumberincontentstrue |
| 5075 |
\newif{\ifputpagenumberinnotes} |
| 5076 |
\putpagenumberinnotestrue |
| 5077 |
\newif{\ifsinglelinetitle} |
| 5078 |
\singlelinetitletrue |
| 5079 |
\newif{\iftitlefirstline} |
| 5080 |
\titlefirstlinefalse |
| 5081 |
\newif{\iftitlemiddleline} |
| 5082 |
\titlemiddlelinefalse |
| 5083 |
\newif{\iftitlelastline} |
| 5084 |
\titlelastlinefalse |
| 5085 |
\newif{\ifverserightflush} |
| 5086 |
\verserightflushfalse |
| 5087 |
\newif\ifrangelemma |
| 5088 |
\rangelemmafalse |
| 5089 |
\newcommand{\makeverselinenumbers}{\global\verselinenumberstrue} |
| 5090 |
\let\makelinenumbers=\makeverselinenumbers% for compatibility |
| 5091 |
\newif\iftextnotesatend |
| 5092 |
\textnotesatendtrue |
| 5093 |
\newif\ifemendationsatend |
| 5094 |
\emendationsatendtrue |
| 5095 |
\newif\ifexplanatend |
| 5096 |
\explanatendtrue |
| 5097 |
\newif\iftextfootnotespara |
| 5098 |
\textfootnotesparatrue |
| 5099 |
\newif\ifsourcesfootnotespara |
| 5100 |
\sourcesfootnotesparafalse |
| 5101 |
\newif\ifemendationfootnotespara |
| 5102 |
\emendationfootnotesparatrue |
| 5103 |
\newif\ifexplanfootnotespara |
| 5104 |
\explanfootnotesparafalse |
| 5105 |
% \end{macrocode} |
| 5106 |
|
| 5107 |
% \subsection{~Defining page styles} \label{pagestyledefs} These define several special page styles. |
| 5108 |
% To use them you must have the \textsf{fancyhdr} package installed. |
| 5109 |
% First, the default running headers: the right side (|\volumeheader|) |
| 5110 |
% is the title of the volume in a multivolume edition, and the left |
| 5111 |
% (|\leftheader|) is the title of the general collection. |
| 5112 |
% \begin{macro}{\volumeheader} |
| 5113 |
% \begin{macrocode} |
| 5114 |
\newcommand{\volumeheader}[1]{\global\edef\volumeheadervalue{#1} |
| 5115 |
} |
| 5116 |
% \end{macrocode} |
| 5117 |
% \end{macro} |
| 5118 |
% \begin{macro}{\leftheader} |
| 5119 |
% \begin{macrocode} |
| 5120 |
\newcommand{\leftheader}[1]{\global\edef\leftheadervalue{#1} |
| 5121 |
} |
| 5122 |
\leftheader{\relax} |
| 5123 |
\volumeheader{\relax} |
| 5124 |
\newcommand{\rightheader}[1]{\volumeheader{#1}} |
| 5125 |
% \end{macrocode} |
| 5126 |
% \end{macro} |
| 5127 |
% The default page style. Note the use of the mark mechanism to keep |
| 5128 |
% track of cases where the stanza breaks and page breaks overlap. |
| 5129 |
% \begin{macro}{\pagestyle{fancy}} |
| 5130 |
% \begin{macrocode} |
| 5131 |
\newlength{\headoffsetlength} |
| 5132 |
\setlength{\headoffsetlength}{-1sp} |
| 5133 |
%\addtolength{\headoffsetlength}{\parindent} |
| 5134 |
\raggedbottom |
| 5135 |
\pagestyle{fancy} |
| 5136 |
\fancyhead{} |
| 5137 |
\fancyfoot{} |
| 5138 |
\fancyhfoffset[RO,LE]{\headoffsetlength} |
| 5139 |
\fancyhead[RO]{{\small\textrm{\thepage}}} |
| 5140 |
\fancyhead[LE]{{\small\textrm{\thepage}}} |
| 5141 |
\fancyhead[CO]{\hfil{\small{\em \volumeheadervalue}}\hfil} |
| 5142 |
\fancyhead[CE]{\hfil{\small{\em \leftheadervalue}}\hfil} |
| 5143 |
\fancyfoot[CE]{{\small \botmark}\hfil} |
| 5144 |
\fancyfoot[CO]{\hfil{\small \botmark}} |
| 5145 |
\renewcommand{\headrulewidth}{0pt} |
| 5146 |
\renewcommand{\footrulewidth}{0pt} |
| 5147 |
% \end{macrocode} |
| 5148 |
% \end{macro} |
| 5149 |
% \begin{macro}{\pagestyle{main}} |
| 5150 |
% \begin{macrocode} |
| 5151 |
\fancypagestyle{main}{% |
| 5152 |
\fancyhead{} |
| 5153 |
\fancyfoot{} |
| 5154 |
\fancyhfoffset[RO,LE]{\headoffsetlength} |
| 5155 |
\fancyhead[RO]{{\small\textrm{\thepage}}} |
| 5156 |
\fancyhead[LE]{{\small\textrm{\thepage}}} |
| 5157 |
\fancyhead[CO]{\hfil{\small{\em \volumeheadervalue}}\hfil} |
| 5158 |
\fancyhead[CE]{\hfil{\small{\em \leftheadervalue}}\hfil} |
| 5159 |
\fancyfoot[CE]{{\small \botmark}\hfil} |
| 5160 |
\fancyfoot[CO]{\hfil{\small \botmark}} |
| 5161 |
\renewcommand{\headrulewidth}{0pt} |
| 5162 |
\renewcommand{\footrulewidth}{0pt} |
| 5163 |
} |
| 5164 |
% \end{macrocode} |
| 5165 |
% \end{macro} |
| 5166 |
% Style for the first page of every volume in a Collected Poems. You |
| 5167 |
% don't have to call this style explicitly. It is called by the |\volumetitlepage| |
| 5168 |
% environment. But of course if you want to change the style of those |
| 5169 |
% pages, you should do it here. |
| 5170 |
% \begin{macro}{volumefirststyle} |
| 5171 |
% \begin{macrocode} |
| 5172 |
\fancypagestyle{volumefirststyle}{% |
| 5173 |
\fancyhf{} |
| 5174 |
\fancyfoot[C]{\hfil{\small \botmark}\hfil} |
| 5175 |
\renewcommand{\headrulewidth}{0pt} |
| 5176 |
\renewcommand{\footrulewidth}{0pt} |
| 5177 |
} |
| 5178 |
% \end{macrocode} |
| 5179 |
% \end{macro} |
| 5180 |
% Style for plain pages. |
| 5181 |
% \begin{macro}{plain} |
| 5182 |
% \begin{macrocode} |
| 5183 |
\fancypagestyle{plain}{% |
| 5184 |
\fancyhf{} |
| 5185 |
\fancyhead[RO,LE]{{\small\textrm{\thepage}}} |
| 5186 |
\renewcommand{\headrulewidth}{0pt} |
| 5187 |
\renewcommand{\footrulewidth}{0pt} |
| 5188 |
} |
| 5189 |
% \end{macrocode} |
| 5190 |
% \end{macro} |
| 5191 |
% Style for long poems. |
| 5192 |
% \begin{macro}{\myversemarks} |
| 5193 |
% \begin{macrocode} |
| 5194 |
\newtoks{\singlelineabbrev} |
| 5195 |
\singlelineabbrev={l.\ } |
| 5196 |
\newcommand{\changesinglelineabbrev}[1]{\singlelineabbrev={#1}} |
| 5197 |
\newtoks{\multiplelineabbrev} |
| 5198 |
\newcommand{\changemultiplelineabbrev}[1]{\multiplelineabbrev={#1}} |
| 5199 |
\multiplelineabbrev{ll.\ } |
| 5200 |
\newcommand{\myversemarks}{% |
| 5201 |
\ifthenelse{\equal{\thefirstmarks{verselinemark}}{\thebotmarks{verselinemark}}}% |
| 5202 |
{\unskip ~\the\singlelineabbrev~\thefirstmarks{verselinemark}}% if equal |
| 5203 |
{\unskip ~\the\multiplelineabbrev\thefirstmarks{verselinemark}--\thebotmarks{verselinemark}}} % if not equal |
| 5204 |
% \end{macrocode} |
| 5205 |
% \end{macro} |
| 5206 |
% \begin{macro}{longpoem} |
| 5207 |
% \begin{macrocode} |
| 5208 |
\fancypagestyle{longpoem}{% |
| 5209 |
\fancyhead{} |
| 5210 |
\fancyfoot{} |
| 5211 |
\fancyhfoffset[RO,LE]{\headoffsetlength} |
| 5212 |
\fancyhead[RO]{{\small\textrm{\thepage}}} |
| 5213 |
\fancyhead[LE]{{\small\textrm{\thepage}}} |
| 5214 |
\fancyhead[CO]{\hfil{\small{\em \volumeheadervalue ~\myversemarks}}\hfil} |
| 5215 |
\fancyhead[CE]{\hfil{\small{\em \leftheadervalue~\myversemarks}}\hfil} |
| 5216 |
\fancyfoot[CE]{{\small \botmark}\hfil} |
| 5217 |
\fancyfoot[CO]{\hfil{\small \botmark}} |
| 5218 |
\renewcommand{\headrulewidth}{0pt} |
| 5219 |
\renewcommand{\footrulewidth}{0pt} |
| 5220 |
} |
| 5221 |
% \end{macrocode} |
| 5222 |
% \end{macro} |
| 5223 |
% Style for divider pages between volumes |
| 5224 |
% \begin{macro}{volumetitlestyle} |
| 5225 |
% \begin{macrocode} |
| 5226 |
\fancypagestyle{volumetitlestyle}{% |
| 5227 |
\fancyhf{} |
| 5228 |
\renewcommand{\headrulewidth}{0pt} |
| 5229 |
\renewcommand{\footrulewidth}{0pt} |
| 5230 |
} |
| 5231 |
% \end{macrocode} |
| 5232 |
% \end{macro} |
| 5233 |
% \begin{macro}{\resetpagestyle} |
| 5234 |
% |\resetpagestyle| restores the fancy page style of the main sections of the |
| 5235 |
% book. |\putpoemcontents| changes the fancy page style, and |\resetpagestyle|, |
| 5236 |
% which is called by |\putpoemcontents| as it finishes, restores the original |
| 5237 |
% style |
| 5238 |
% \begin{macrocode} |
| 5239 |
\newcommand{\resetpagestyle}{\pagestyle{main} |
| 5240 |
% \fancyhead{} |
| 5241 |
% \fancyfoot{} |
| 5242 |
% \fancyhead[RO,LE]{{\small\textrm{\thepage}}} |
| 5243 |
% \fancyhead[CO]{\hfil{\small{\em \volumeheadervalue}}} |
| 5244 |
% \fancyhead[CE]{{\small{\em \leftheadervalue}\hfil}} |
| 5245 |
% \fancyfoot[CE]{{\small \botmark}\hfil} |
| 5246 |
% \fancyfoot[CO]{\hfil{\small \botmark}} |
| 5247 |
% \renewcommand{\headrulewidth}{0pt} |
| 5248 |
% \renewcommand{\footrulewidth}{0pt} |
| 5249 |
} |
| 5250 |
% \end{macrocode} |
| 5251 |
% \end{macro} |
| 5252 |
% \begin{macro}{\clearemptydoublepage} |
| 5253 |
% This macro is useful for making sure that the verso of a title |
| 5254 |
% page is blank. |
| 5255 |
% \begin{macrocode} |
| 5256 |
\newcommand{\clearemptydoublepage}{\newpage{\pagestyle{empty}\cleardoublepage}} |
| 5257 |
% |
| 5258 |
% \end{macrocode} |
| 5259 |
% \end{macro} |
| 5260 |
% \begin{macro}{\mymarks} |
| 5261 |
% Here the marks mechanism keeps track of pages from which notes |
| 5262 |
% come. Marks are used different in the notes sections and in the body |
| 5263 |
% of the volume. In the body, they are used to keep track of cases |
| 5264 |
% where a stanza break falls on a page break. In the notes sections, |
| 5265 |
% they set the running headers. |
| 5266 |
% \begin{macrocode} |
| 5267 |
\newtoks{\singlepageabbrev} |
| 5268 |
\singlepageabbrev={p.} |
| 5269 |
\newcommand{\changesinglepageabbrev}[1]{\singlepageabbrev={#1}} |
| 5270 |
\newtoks{\multiplepageabbrev} |
| 5271 |
\newcommand{\changemultiplepageabbrev}[1]{\multiplepageabbrev={#1}} |
| 5272 |
\multiplepageabbrev{pp.} |
| 5273 |
\newcommand{\mymarks}{% |
| 5274 |
\ifthenelse{\equal{\firstmark}{\botmark}}% |
| 5275 |
{\unskip ~\the\singlepageabbrev~\firstmark}% if equal |
| 5276 |
{\unskip ~\the\multiplepageabbrev~\firstmark--\botmark}}%if not equal |
| 5277 |
\newcommand{\poemdotfill}{\dotfill} |
| 5278 |
% \end{macrocode} |
| 5279 |
% \end{macro} |
| 5280 |
% \subsection{~Environments: poem, and stanza} Here are definitions |
| 5281 |
% of the poem and stanza environments, and of the |\verseline| and |
| 5282 |
% |\stanzalinestraddle| macros. |
| 5283 |
% \begin{macro}{stanza} \label{stanzadefine} |
| 5284 |
% Page breaks are slightly encouraged in stanza breaks. Notice that |
| 5285 |
% entering a stanza sets the mark to |\relax| and leaving it sets the |
| 5286 |
% mark to * (the default value of |\stanzaatbottom|). If you want to |
| 5287 |
% use some other symbol for this purpose, use |\stanzaatbottom| or |
| 5288 |
% |\nostanzaatbottom| (if you also want to mark cases where there |
| 5289 |
% is \emph{no} stanza break at the bottom of the page) to change it. |
| 5290 |
% \begin{macrocode} |
| 5291 |
\newenvironment{stanza}{\penalty-100\instanzatrue\mark{\nostanzaatbottomvalue\ }} |
| 5292 |
{\nobreak\mark{\stanzaatbottomvalue\ }\nobreak\ifspeciallinelock% |
| 5293 |
\relax\else% |
| 5294 |
\nolinebreak\incrementverselinenumber% |
| 5295 |
\fi% |
| 5296 |
\speciallinelockfalse% |
| 5297 |
\nobreak |
| 5298 |
\instanzafalse |
| 5299 |
|
| 5300 |
\stanzaskip |
| 5301 |
} |
| 5302 |
|
| 5303 |
\newenvironment{marginenvironment}{}{} |
| 5304 |
\newcommand{\stanzalinestraddle} |
| 5305 |
{\begin{stanza}\addtocounter{verselinenumber}{-1}% |
| 5306 |
\addtocounter{printlineindex}{-1}% |
| 5307 |
} |
| 5308 |
% \end{macrocode} |
| 5309 |
% The next two environments are for contents entries and titles. The |
| 5310 |
% idea is to handle overrun titles the way overrun lines are handled |
| 5311 |
% in verse. Contents entries indent the overrun slightly. Titles do |
| 5312 |
% not indent the overrun relative to the first line, but preserve the |
| 5313 |
% indentation of that line. |
| 5314 |
% \begin{macrocode} |
| 5315 |
\newlength{\contentsentryoverrun} |
| 5316 |
\setlength{\contentsentryoverrun}{\contentsindentoneamount} |
| 5317 |
\newenvironment{contentsentryenvironment}{% |
| 5318 |
\language=255%no hyphenation in contents |
| 5319 |
\let\\=\@centercr% |
| 5320 |
\list{}{\topsep\z@% |
| 5321 |
\partopsep\z@% |
| 5322 |
\itemsep\z@ \itemindent -\contentsentryoverrun\listparindent \itemindent |
| 5323 |
\rightmargin 1sp\leftmargin 1sp\advance\leftmargin |
| 5324 |
\contentsentryoverrun}\item[]}{\endlist} |
| 5325 |
\newlength{\titleentryoverrun} |
| 5326 |
\setlength{\titleentryoverrun}{\z@} |
| 5327 |
\newenvironment{titleentryenvironment}{% |
| 5328 |
\language=255%no hyphenation in poem titles |
| 5329 |
\let\\=\@centercr% |
| 5330 |
\list{}{\topsep\z@% |
| 5331 |
\partopsep\z@% |
| 5332 |
\itemsep\z@ \itemindent -\titleentryoverrun% |
| 5333 |
\listparindent \itemindent % |
| 5334 |
\iftitlesatleftmarginofcenteredblock% |
| 5335 |
\left@ligntitleblock% |
| 5336 |
\rightmargin \z@\leftmargin \lefttitlemargin% |
| 5337 |
\else% |
| 5338 |
\iftitlescenteredonleftverseblock |
| 5339 |
\l@ftc@ntertitleblock |
| 5340 |
\rightmargin \z@\leftmargin \lefttitlemargin |
| 5341 |
\else |
| 5342 |
\rightmargin \z@\leftmargin \z@% |
| 5343 |
\fi\fi% |
| 5344 |
\advance\leftmargin \titleentryoverrun}\item[]}{\endlist} |
| 5345 |
% older version: |
| 5346 |
%\newenvironment{titleentryenvironment}{% |
| 5347 |
%\language=255%no hyphenation in poem titles |
| 5348 |
%\let\\=\@centercr% |
| 5349 |
%\list{}{\topsep\z@% |
| 5350 |
%\partopsep\z@% |
| 5351 |
%\itemsep\z@ \itemindent -\titleentryoverrun% |
| 5352 |
%\listparindent \itemindent % |
| 5353 |
%\ifleftaligntitles |
| 5354 |
%\left@ligntitleblock |
| 5355 |
%\rightmargin 1sp\leftmargin \lefttitlemargin% |
| 5356 |
%\else |
| 5357 |
%\rightmargin 1sp\leftmargin 1sp% |
| 5358 |
%\fi |
| 5359 |
%\advance\leftmargin \titleentryoverrun}\item[]}{\endlist} |
| 5360 |
% \end{macrocode} |
| 5361 |
% \end{macro} |
| 5362 |
% The poem environment. The little trick about setting the language |
| 5363 |
% number is designed to suppress automatic hyphenation in the poem |
| 5364 |
% environment. The booleans tell the |\emendation| and |
| 5365 |
% |\explanatory| macros that there have not yet been emendations or |
| 5366 |
% explanatory notes for this poem. The little trick with |\mark| sets |
| 5367 |
% the value of |\mark| to the current value of |\stanzaatbottom| (by |
| 5368 |
% default *) if the current location is in a poem but not in a stanza |
| 5369 |
% (which is to say, in a stanza break). The |\pagestyle| for poetry |
| 5370 |
% sets the value of |\mark| in the footer, which is * if the page break |
| 5371 |
% happens at a stanza break, and |\relax| if the page break happens |
| 5372 |
% anywhere else. \label{poemdef} |
| 5373 |
% \begin{macro}{poem} |
| 5374 |
% \begin{macrocode} |
| 5375 |
\newlength{\versewidth} |
| 5376 |
\setlength{\versewidth}{\linewidth}% default length for \versewidth |
| 5377 |
\newenvironment{poem}[1][\linewidth] |
| 5378 |
{\raggedright% |
| 5379 |
\language=255%no hyphenation in verse |
| 5380 |
\noemendyettrue% |
| 5381 |
\noexplainyettrue% |
| 5382 |
\setcounter{verselinenumber}{0}\setcounter{printlineindex}{0}% |
| 5383 |
\nobreak\begin{pmclverse}[#1]% |
| 5384 |
\inpoemtrue\nobreak\mark{\relax}% |
| 5385 |
}{\end{pmclverse}% |
| 5386 |
\inpoemfalse\mark{\relax}% |
| 5387 |
\goodbreak\afterpoemskip%\bigskip |
| 5388 |
} |
| 5389 |
% \end{macrocode} |
| 5390 |
% \end{macro} |
| 5391 |
% \begin{macro}{rightflushverse} |
| 5392 |
% Sets verse with the runover portions of long lines flushed to the right. Each line |
| 5393 |
% must begin with |\rightversebegin|.This code was suggested to me by Mark Wooding |
| 5394 |
% on comp.text.tex, who describes the code as ``very unpleasant.'' |
| 5395 |
% \begin{macrocode} |
| 5396 |
\newenvironment{rightflushverse}{\let\oldleftskip=\leftskip% |
| 5397 |
\leftskip=1 \leftskip\advance\leftskip by 0pt plus 1fill}% |
| 5398 |
{\let\leftskip=\oldleftskip} |
| 5399 |
% \end{macrocode} |
| 5400 |
% \end{macro} |
| 5401 |
% \subsection{~Environments: main title page, divider pages} |
| 5402 |
% Environments for the main title page, and for the divider pages for |
| 5403 |
% individual volumes in a Collected Poems. |
| 5404 |
% \begin{macro}{volumetitlepage} |
| 5405 |
% \begin{macro}{maintitlepage} |
| 5406 |
% \begin{macro}{booksectionpage} |
| 5407 |
% \begin{macrocode} |
| 5408 |
\newenvironment{volumetitlepage} |
| 5409 |
{\par\clearpage{\pagestyle{volumetitlestyle}\cleardoublepage} |
| 5410 |
\thispagestyle{volumetitlestyle}} |
| 5411 |
{\newpage\thispagestyle{volumetitlestyle} |
| 5412 |
\cleardoublepage\thispagestyle{volumefirststyle}} |
| 5413 |
\newenvironment{maintitlepage} |
| 5414 |
{\par\cleardoublepage\thispagestyle{volumetitlestyle} |
| 5415 |
}{\newpage\thispagestyle{volumetitlestyle}\cleardoublepage} |
| 5416 |
\newenvironment{booksectionpage} |
| 5417 |
{\par\newpage\thispagestyle{volumetitlestyle}}{\newpage} |
| 5418 |
% \end{macrocode} |
| 5419 |
% \end{macro} |
| 5420 |
% \end{macro} |
| 5421 |
% \end{macro} |
| 5422 |
% \subsection{~Marginal line numbers, verse lines, line cross |
| 5423 |
% references, etc.}\label{marginalgeometry} The default is that the |
| 5424 |
% line numbers are on the left side, and that the |\marginparsep| is |
| 5425 |
% 18pt. If you use |\pmclleftsidepar| the placement of the number is |
| 5426 |
% controlled by |\marginparsep| and |\marginparwidth|. You should |
| 5427 |
% experiment with different values until you find a set that suits |
| 5428 |
% you. A rule of thumb for me is that the |\marginparsep| if the |
| 5429 |
% numbers is on the right should be the negative of the value if it is |
| 5430 |
% on the left. First, some lengths and ifs: |
| 5431 |
% \begin{macrocode} |
| 5432 |
\setlength{\marginparsep}{18pt} |
| 5433 |
\setlength{\marginparwidth}{18pt} |
| 5434 |
\newif\ifnumbersswitch \numbersswitchfalse |
| 5435 |
\newif\ifnumbersright \numbersrightfalse |
| 5436 |
% \end{macrocode} |
| 5437 |
% Next, code for |\pmclsidepar|, taken from the memoir class, by |
| 5438 |
% Peter Wilson. Modified by Dan Luecking. |
| 5439 |
% \begin{macro}{\pmclsidepar} |
| 5440 |
% \begin{macrocode} |
| 5441 |
\newcommand{\pmclsidepar}{\@dblarg{\@pmclsidepar}} |
| 5442 |
%\long\def\@pmclsidepar[#1]#2{\@bsphack\leavevmode\vadjust{% |
| 5443 |
\long\def\@pmclsidepar[#1]#2{\@bsphack\strut\vadjust{% added |
| 5444 |
\checkoddpage |
| 5445 |
\ifpmclsideparswitch |
| 5446 |
\ifpmclreversesidepar |
| 5447 |
\ifoddpage |
| 5448 |
\oddpagefalse |
| 5449 |
\else |
| 5450 |
\oddpagetrue |
| 5451 |
\fi |
| 5452 |
\fi |
| 5453 |
\else |
| 5454 |
\oddpagetrue |
| 5455 |
\ifpmclreversesidepar |
| 5456 |
\oddpagefalse |
| 5457 |
\fi |
| 5458 |
\fi |
| 5459 |
\rlap{\kern-\parindent |
| 5460 |
\if@twocolumn |
| 5461 |
\if@firstcolumn % put at left |
| 5462 |
\kern -\marginparsep \kern -\marginparwidth % at left |
| 5463 |
\else % put at right |
| 5464 |
\kern \columnwidth \kern \marginparsep % at right |
| 5465 |
\fi |
| 5466 |
\else |
| 5467 |
\ifoddpage % put at right |
| 5468 |
\kern \textwidth \kern \marginparsep % at right |
| 5469 |
\else % put at left |
| 5470 |
\kern -\marginparsep \kern -\marginparwidth % at left |
| 5471 |
\fi |
| 5472 |
\fi |
| 5473 |
% \vbox to 0pt{% |
| 5474 |
% \kern \pmclsideparvshift% % vertical shift to align top text lines |
| 5475 |
% \begin{minipage}{\marginparwidth}% |
| 5476 |
\setbox0=\vtop to 0pt{% added |
| 5477 |
\begin{minipage}[t]{\marginparwidth}% added |
| 5478 |
\ifoddpage #2\else #1\fi% |
| 5479 |
\end{minipage}% |
| 5480 |
% \vss}}}\@esphack} |
| 5481 |
\vss}% added |
| 5482 |
\vtop to 0pt{\kern\pmclsideparvshift % default should be 0pt |
| 5483 |
\kern-\dp\strutbox \kern-\ht0 \box0 \vss}}}\@esphack}% added |
| 5484 |
|
| 5485 |
|
| 5486 |
% \end{macrocode} |
| 5487 |
% \end{macro} |
| 5488 |
% \begin{macro}{\thepmemc@@page} |
| 5489 |
% The value of the page counter. |
| 5490 |
% \begin{macrocode} |
| 5491 |
\gdef\thepmemc@@page{\the\c@page} |
| 5492 |
|
| 5493 |
% \end{macrocode} |
| 5494 |
% \end{macro} |
| 5495 |
% \begin{macro}{\pmemlabel} |
| 5496 |
% A version of |\label| that uses |\pmemprotected@write|. |
| 5497 |
% \begin{macrocode} |
| 5498 |
\providecommand{\pmemlabel}[1]{\@bsphack |
| 5499 |
\pmemprotected@write\@auxout{}% |
| 5500 |
{\string\newpmemlabel{#1}{\thepmemc@@page}}% |
| 5501 |
\@esphack} |
| 5502 |
% \end{macrocode} |
| 5503 |
% \end{macro} |
| 5504 |
% \begin{macro}{\pmemprotected@write} |
| 5505 |
% |\pmemprotected@write| is a modified version of the kernel's |
| 5506 |
% |\protected@write|. |
| 5507 |
% |
| 5508 |
% \begin{macrocode} |
| 5509 |
\long\def\pmemprotected@write#1#2#3{% |
| 5510 |
\begingroup |
| 5511 |
\let\thepmemc@@page\relax |
| 5512 |
#2% |
| 5513 |
\let\protect\@unexpandable@protect |
| 5514 |
\edef\reserved@a{\write#1{#3}}% |
| 5515 |
\reserved@a |
| 5516 |
\endgroup |
| 5517 |
\if@nobreak\ifvmode\nobreak\fi\fi} |
| 5518 |
|
| 5519 |
% \end{macrocode} |
| 5520 |
% \end{macro} |
| 5521 |
% \begin{macro}{\newpmemlabel} |
| 5522 |
% \begin{macro}{\pmemlabelref} |
| 5523 |
% We have to be able to cope with a particular label |
| 5524 |
% not (yet) being in the the aux file when we come to check |
| 5525 |
% the page number. |
| 5526 |
% \begin{macrocode} |
| 5527 |
\providecommand{\newpmemlabel}[2]{{\global\@namedef{m@#1}{#2}}} |
| 5528 |
\providecommand{\pmemlabelref}[1]{% |
| 5529 |
\expandafter\ifx\csname m@#1\endcsname\relax |
| 5530 |
0% |
| 5531 |
\else |
| 5532 |
\csname m@#1\endcsname |
| 5533 |
\fi} |
| 5534 |
|
| 5535 |
% \end{macrocode} |
| 5536 |
% \end{macro} |
| 5537 |
% \end{macro} |
| 5538 |
% \begin{macro}{\@memcnta} |
| 5539 |
% We need a scratch count register. |
| 5540 |
% \begin{macrocode} |
| 5541 |
\newcount\@memcnta |
| 5542 |
% \end{macrocode} |
| 5543 |
% \end{macro} |
| 5544 |
% \begin{macro}{\checkoddpage} |
| 5545 |
% This is the user level command to check for odd/even page. It does |
| 5546 |
% a robust check for |\strictpagecheck| otherwise the simple minded |
| 5547 |
% check. It sets |\ifoddpage| to TRUE if the page is odd, otherwise |
| 5548 |
% it sets it to FALSE. |
| 5549 |
% |
| 5550 |
% This is now fixed so that it should work for non-arabic page numbering. |
| 5551 |
% It uses a new label/pageref variant based on the page counter value, not |
| 5552 |
% its printed representation. This also gets rid of worrying about hyperref!! |
| 5553 |
% The problem was discovered by Bastiaan Niels Veelo |
| 5554 |
% |
| 5555 |
% \begin{macrocode} |
| 5556 |
\DeclareRobustCommand{\checkoddpage}{% |
| 5557 |
\oddpagefalse% |
| 5558 |
\ifstrictpagecheck% |
| 5559 |
\stepcounter{cp@cntr}\pmemlabel{\cplabel\thecp@cntr}% |
| 5560 |
\@memcnta=\pmemlabelref{\cplabel\thecp@cntr}\relax |
| 5561 |
\ifodd\@memcnta\oddpagetrue\fi |
| 5562 |
\else |
| 5563 |
\ifodd\c@page\oddpagetrue\fi |
| 5564 |
\fi} |
| 5565 |
|
| 5566 |
% \end{macrocode} |
| 5567 |
% \end{macro} |
| 5568 |
% \begin{macro}{\ifpmclreversesidepar} |
| 5569 |
% \begin{macro}{\ifpmclsideparswitch} |
| 5570 |
% Analogues of |\marginpar| controls. |
| 5571 |
% \begin{macrocode} |
| 5572 |
\newif\ifpmclreversesidepar |
| 5573 |
% \pmclreversesideparfalse |
| 5574 |
\pmclreversesidepartrue |
| 5575 |
\newif\ifpmclsideparswitch |
| 5576 |
\pmclsideparswitchfalse |
| 5577 |
\if@twoside \pmclsideparswitchtrue \fi |
| 5578 |
|
| 5579 |
% \end{macrocode} |
| 5580 |
% \end{macro} |
| 5581 |
% \end{macro} |
| 5582 |
% \begin{macro}{\ifoddpage} |
| 5583 |
% \begin{macro}{\ifstrictpagecheck} |
| 5584 |
% \begin{macro}{\c@cp@cntr} |
| 5585 |
% \begin{macro}{\cplabel} |
| 5586 |
% The boolean |\ifoddpage| is TRUE if the checked page is odd. The |
| 5587 |
% boolean |\ifstrictpagecheck| is for turning on (TRUE) and off (FALSE) |
| 5588 |
% the strictest method of page checking. The counter |cp@cntr| is used |
| 5589 |
% to make unique labels, which start with |\cplabel|. |
| 5590 |
% \begin{macrocode} |
| 5591 |
\newif\ifoddpage |
| 5592 |
\newif\ifstrictpagecheck |
| 5593 |
\strictpagecheckfalse |
| 5594 |
\newcounter{cp@cntr} |
| 5595 |
\newcommand{\cplabel}{^_} |
| 5596 |
% \end{macrocode} |
| 5597 |
% \end{macro} |
| 5598 |
% \end{macro} |
| 5599 |
% \end{macro} |
| 5600 |
% \end{macro} |
| 5601 |
% Two-column and one-column printing is again realized via a switch |
| 5602 |
% which is defined in the kernel. The default is single column printing. |
| 5603 |
% |
| 5604 |
% |
| 5605 |
% \begin{macro}{\pmclsideparvshift} |
| 5606 |
% Vertical shift for sidepar to align with text line |
| 5607 |
% \begin{macrocode} |
| 5608 |
\newlength{\pmclsideparvshift} |
| 5609 |
% \setlength{\pmclsideparvshift}{-2.08ex}% seems to work for all font sizes |
| 5610 |
%\setlength{\pmclsideparvshift}{-2.58ex} |
| 5611 |
\setlength{\pmclsideparvshift}{0ex} |
| 5612 |
% \end{macrocode} |
| 5613 |
% \end{macro} |
| 5614 |
% My code resumes here |
| 5615 |
% \begin{macro}{\verselinenumberstoleft} |
| 5616 |
% \begin{macro}{\verselinenumberstoright} |
| 5617 |
% \begin{macrocode} |
| 5618 |
\newcommand{\verselinenumberstoleft}{% |
| 5619 |
% \setlength{\marginparsep}{18pt}% |
| 5620 |
% \setlength{\marginparwidth}{10pt}% |
| 5621 |
\numbersswitchfalse\numbersrightfalse} |
| 5622 |
\newcommand{\verselinenumberstoright}{% |
| 5623 |
% \setlength{\marginparsep}{18pt}% |
| 5624 |
% \setlength{\marginparwidth}{10pt}% |
| 5625 |
\numbersswitchfalse\numbersrighttrue} |
| 5626 |
% \end{macrocode} |
| 5627 |
% \end{macro} |
| 5628 |
% \end{macro} |
| 5629 |
% \begin{macro}{\verselinenumbersswitch} |
| 5630 |
% \begin{macro}{\verselinenumbersgutter} |
| 5631 |
% \begin{macro}{\verselinenumbersouter} |
| 5632 |
% \begin{macrocode} |
| 5633 |
\newcommand{\verselinenumbersswitch}{% |
| 5634 |
\strictpagechecktrue% |
| 5635 |
% \setlength{\marginparsep}{18pt}% |
| 5636 |
% \setlength{\marginparwidth}{10pt}% |
| 5637 |
\numbersswitchtrue\numbersrightfalse\pmclsideparswitchtrue} |
| 5638 |
\newif\ifnumbersgutter \numbersgutterfalse% |
| 5639 |
\newcommand{\verselinenumbersgutter}{\verselinenumbersswitch% |
| 5640 |
\pmclreversesideparfalse% |
| 5641 |
\numbersguttertrue% |
| 5642 |
} |
| 5643 |
\newcommand{\verselinenumbersouter}{\verselinenumbersswitch% |
| 5644 |
\pmclreversesidepartrue% |
| 5645 |
\numbersgutterfalse} |
| 5646 |
% \end{macrocode} |
| 5647 |
% \end{macro} |
| 5648 |
% \end{macro} |
| 5649 |
% \end{macro} |
| 5650 |
% \begin{macro}{\putverselinenumber} |
| 5651 |
% \begin{macrocode} |
| 5652 |
\newcommand{\putverselinenumber}{\nolinebreak\begin{marginenvironment}% |
| 5653 |
\nolinebreak% |
| 5654 |
% \ifnumbersswitch\marginpar{\hfil\textrm{\scriptsize\theverselinenumber}}% |
| 5655 |
% \else% |
| 5656 |
% \ifnumbersright\marginpar{\hfil\textrm{\scriptsize\theverselinenumber}}% |
| 5657 |
% \else% |
| 5658 |
% \marginpar{\textrm{\scriptsize\theverselinenumber}\hfil}% |
| 5659 |
% \fi% |
| 5660 |
% \fi |
| 5661 |
\ifnumbersswitch\pmclsidepar{\hfil\textrm{\scriptsize\theverselinenumber}}% |
| 5662 |
\else% |
| 5663 |
\ifnumbersright\pmclrightsidepar{\hfil\textrm{\scriptsize\theverselinenumber}}% |
| 5664 |
\else% |
| 5665 |
\pmclleftsidepar |
| 5666 |
{\textrm{\scriptsize\theverselinenumber}\hfil}% |
| 5667 |
\fi% |
| 5668 |
\fi% |
| 5669 |
% \marn{\hfil\textrm{\theverselinenumber}} |
| 5670 |
% \marginpar{\hfil\textrm{\scriptsize\theverselinenumber}} |
| 5671 |
% \linenumberside{\textrm{\scriptsize\theverselinenumber}\hfil} |
| 5672 |
% \pmclrightsidepar{\textrm{\scriptsize\theverselinenumber}} |
| 5673 |
\nolinebreak% |
| 5674 |
\end{marginenvironment}% |
| 5675 |
\nolinebreak% |
| 5676 |
} |
| 5677 |
% \end{macrocode} |
| 5678 |
% \end{macro} |
| 5679 |
% \begin{macro}{\verseline} |
| 5680 |
% \begin{macrocode} |
| 5681 |
\newif\ifspeciallinelock |
| 5682 |
\speciallinelockfalse |
| 5683 |
\newcommand{\verseline}{\ifspeciallinelock% |
| 5684 |
\relax\else% |
| 5685 |
\nolinebreak\incrementverselinenumber% |
| 5686 |
\fi% |
| 5687 |
\speciallinelockfalse% |
| 5688 |
\nolinebreak\\% |
| 5689 |
} |
| 5690 |
% \newif\iflongpoemon |
| 5691 |
% \longpoemonfalse |
| 5692 |
\newcommand{\incrementverselinenumber}{% |
| 5693 |
\nolinebreak\addtocounter{verselinenumber}{1}% |
| 5694 |
%\iflongpoemon\marksthe{verselinemark}{\theverselinenumber}\fi% |
| 5695 |
%\makeatletter |
| 5696 |
\@ifundefined{marksthe}{\relax}{\marksthe{verselinemark}{\theverselinenumber}}% |
| 5697 |
%\makeatother |
| 5698 |
\addtocounter{printlineindex}{1}% |
| 5699 |
\ifnum\theprintlineindex>\thelineindexrepeat% |
| 5700 |
\ifverselinenumbers\nobreak% |
| 5701 |
\putverselinenumber\nobreak% |
| 5702 |
\fi\nobreak% |
| 5703 |
\setcounter{printlineindex}{0}% |
| 5704 |
\fi% |
| 5705 |
} |
| 5706 |
\newcommand{\setverselinemodulo}[1]{% |
| 5707 |
\setcounter{lineindexrepeat}{#1}% |
| 5708 |
\addtocounter{lineindexrepeat}{-1}% |
| 5709 |
} |
| 5710 |
% \end{macrocode} |
| 5711 |
% \end{macro} |
| 5712 |
% \begin{macro}{\linebend} |
| 5713 |
% A linebend is a a normal linebreak from \LaTeX, with no incrementing |
| 5714 |
% of the line number counter, but the indentation makes the line look |
| 5715 |
% like a run over line. If you change the value of the run over in the |
| 5716 |
% definition of the |\verse| environment, be sure to change it here |
| 5717 |
% too. |\linebend| should be used for tweaking how \textsf{poemscol} |
| 5718 |
% runs over long lines. |
| 5719 |
% |
| 5720 |
% \begin{macrocode} |
| 5721 |
\newcommand{\linebend}{\\ |
| 5722 |
\hspace{\runoverindentvalue}% |
| 5723 |
} |
| 5724 |
% \end{macrocode} |
| 5725 |
% \end{macro} |
| 5726 |
% |\saveverselinenumber| and |\restoreverselinenumber| are useful for setting |
| 5727 |
% prose interjections in the midst of poems. |
| 5728 |
% \begin{macro}{\saveverselinenumber} |
| 5729 |
% \begin{macro}{\restoreverselinenumber} |
| 5730 |
% \begin{macrocode} |
| 5731 |
\newcommand{\saveverselinenumber}{\setcounter{verselinenumberscratch}% |
| 5732 |
{\value{verselinenumber}}% |
| 5733 |
\setcounter{printlineindexscratch}{\value{printlineindex}}} |
| 5734 |
\newcommand{\restoreverselinenumber}{\setcounter{verselinenumber}% |
| 5735 |
{\value{verselinenumberscratch}}% |
| 5736 |
\setcounter{printlineindex}{\value{printlineindexscratch}}} |
| 5737 |
% \end{macrocode} |
| 5738 |
% \end{macro} |
| 5739 |
% \end{macro} |
| 5740 |
% \begin{macro}{\rightversebegin} |
| 5741 |
% By default, \textsf{poemscol} indents the runover portion of long lines by the |
| 5742 |
% amount |\runoverindent| (by default 6 em). It is possible to set verse so that |
| 5743 |
% the runover portion is flushed to the right margin. To do this, you should |
| 5744 |
% enclose the |\poem| environment in the |\rightflushverse| environment. And you |
| 5745 |
% must mark the beginning of each verse line with |\rightversebegin| |
| 5746 |
% \begin{macrocode} |
| 5747 |
\newcommand{\rightversebegin} |
| 5748 |
{\leavevmode\nobreak\hskip0pt plus -1fill\ignorespaces} |
| 5749 |
% \end{macrocode} |
| 5750 |
% \end{macro} |
| 5751 |
% \begin{macro}{\hour} |
| 5752 |
% |\hour| is useful for typesetting the AM and the PM in the time. |
| 5753 |
% \begin{macrocode} |
| 5754 |
\newcommand{\hour}[1]{{{\textsc{#1}}\ $\!\!\!$} |
| 5755 |
} |
| 5756 |
% \end{macrocode} |
| 5757 |
% \end{macro} |
| 5758 |
% \begin{macro}{\brokenline} |
| 5759 |
% \begin{macro}{\versephantom} |
| 5760 |
% |\brokenline| and |\versephantom{}| are a pair, useful for setting |
| 5761 |
% cases where there is a line break in the midst of a single metrical |
| 5762 |
% line. |\tweakbrokenline| ensures that the line number will mark |
| 5763 |
% the first partial line if the line numbers are on the left, the |
| 5764 |
% last partial line if the line numbers are on the right. If you |
| 5765 |
% have issued |\tweakbrokenline| in your preamble, the setting of |
| 5766 |
% runover lines may not be consistent with the setting of broken |
| 5767 |
% lines, because the line number will be set on the level of the end |
| 5768 |
% of the line. This is not a problem if the line numbers are set on |
| 5769 |
% the right, but it may look odd if the numbers are set on the left. |
| 5770 |
% |\startverseline| will ensure that the line number marks the |
| 5771 |
% beginning of any line it begins. If you put |\startverseline| at |
| 5772 |
% the beginning of the runover lines, it will ensure that the line |
| 5773 |
% number marks the beginning, not the end, of the line. If you wish |
| 5774 |
% |\startverseline| to align the number with the beginning of |
| 5775 |
% runover lines when the line number is on the left, and with the |
| 5776 |
% end of runover lines when the line number is on the right, issue |
| 5777 |
% |\tweakstartverseline| in your preamble. |
| 5778 |
% \begin{macrocode} |
| 5779 |
\newcommand{\brokenline}{\\} |
| 5780 |
\newcommand{\versephantom}[1]{\leavevmode\phantom{#1}} |
| 5781 |
% \end{macrocode} |
| 5782 |
% \end{macro} |
| 5783 |
% \end{macro} |
| 5784 |
% \begin{macro}{\tweakbrokenline} |
| 5785 |
% Causes |\brokenline| to set the line number level with the |
| 5786 |
% beginning of the line if the number is on the left, level with the |
| 5787 |
% end of the line if the number is on the right. Issue it in the |
| 5788 |
% preamble. |
| 5789 |
% \begin{macrocode} |
| 5790 |
\newcommand{\tweakbrokenline}{% |
| 5791 |
\renewcommand{\brokenline}{\ifnumbersswitch\relax% |
| 5792 |
\ifnumbersgutter% shift on odd pages for gutter numbers |
| 5793 |
\ifodd\c@page \relax \else \speciallinelocktrue\incrementverselinenumber\fi |
| 5794 |
\else % shift on even pages for outer numbers |
| 5795 |
\ifodd\c@page \speciallinelocktrue\incrementverselinenumber \fi |
| 5796 |
\fi |
| 5797 |
\else \ifnumbersright \relax% |
| 5798 |
\else \speciallinelocktrue\incrementverselinenumber% |
| 5799 |
\fi% |
| 5800 |
\fi% |
| 5801 |
\\} |
| 5802 |
} |
| 5803 |
% \end{macrocode} |
| 5804 |
% \end{macro} |
| 5805 |
% \begin{macro}{\brokenlineatbeginning} |
| 5806 |
% Issue |\brokenlineatbeginning| if you want broken line to set the |
| 5807 |
% line number level with the beginning of the line, regardless of |
| 5808 |
% whether the line number is at the right or at the left |
| 5809 |
% \begin{macrocode} |
| 5810 |
\newcommand{\brokenlineatbeginning}{% |
| 5811 |
\renewcommand{\brokenline}{% |
| 5812 |
\speciallinelocktrue\incrementverselinenumber% |
| 5813 |
\\ |
| 5814 |
} |
| 5815 |
} |
| 5816 |
% \end{macrocode} |
| 5817 |
% \end{macro} |
| 5818 |
% \begin{macro}{\startverseline} |
| 5819 |
% Put |\startverseline| at the beginning of every line where you wish |
| 5820 |
% to ensure that the line number is level with the beginning of the |
| 5821 |
% line. This is particularly useful for overrun lines when |
| 5822 |
% |\tweakbrokenline| or |\brokenlineatbeginning| is in effect. |
| 5823 |
% \begin{macrocode} |
| 5824 |
\newcommand{\startverseline}{% |
| 5825 |
\speciallinelocktrue% |
| 5826 |
\leavevmode% |
| 5827 |
%\kern-3pt |
| 5828 |
\incrementverselinenumber% |
| 5829 |
} |
| 5830 |
% \end{macrocode} |
| 5831 |
% \end{macro} |
| 5832 |
% \begin{macro}{\tweakstartverseline} |
| 5833 |
% You may want |\startverseline| to align the line number with the |
| 5834 |
% beginning of the line if the line number is on the left, and with |
| 5835 |
% the end of the line if the line number is on the right. To do this, |
| 5836 |
% issue |\tweakstartline| in your preamble. |
| 5837 |
% \begin{macrocode} |
| 5838 |
\newcommand{\tweakstartverseline}{% |
| 5839 |
\renewcommand{\startverseline}{% |
| 5840 |
\leavevmode% |
| 5841 |
\ifnumbersswitch% |
| 5842 |
% gutter case: shift on odd pages to top of runover line |
| 5843 |
\ifnumbersgutter% |
| 5844 |
\ifodd\c@page \relax \else \speciallinelocktrue\incrementverselinenumber\fi |
| 5845 |
% outer case: shift on even pages to top of runover line |
| 5846 |
\else |
| 5847 |
\ifodd\c@page \speciallinelocktrue\incrementverselinenumber \fi |
| 5848 |
\fi% end of ifnumbersgutter |
| 5849 |
\else \ifnumbersright \relax% numbers don't switch. Are they to the right? |
| 5850 |
\else \speciallinelocktrue\incrementverselinenumber% or to the left? |
| 5851 |
\fi% end of ifnumbersright |
| 5852 |
\fi% end of ifnumbersswitch |
| 5853 |
}% end of renewcommand |
| 5854 |
}% end of tweakverseline |
| 5855 |
% \end{macrocode} |
| 5856 |
% \end{macro} |
| 5857 |
% \begin{macro}{\poemlinelabel} |
| 5858 |
% |\poemlinelabel| is a hacked version of |\label| for crossreferences by |
| 5859 |
% line. |
| 5860 |
% \begin{macrocode} |
| 5861 |
\def\poemlinelabel#1{\@bsphack |
| 5862 |
\protected@write\@auxout{}% |
| 5863 |
{\string\newlabel{#1}{{\theverselinenumber}{\thepage}}}% |
| 5864 |
\@esphack |
| 5865 |
} |
| 5866 |
% \end{macrocode} |
| 5867 |
% \end{macro} |
| 5868 |
% \subsection{~Setup for contents, textual notes, emendations, and explanatory notes} |
| 5869 |
% First, the table of contents: |
| 5870 |
% \begin{macro}{\makepoemcontents} |
| 5871 |
% An external file is created with the extension .ctn, and the |
| 5872 |
% filename of your driver file. The |
| 5873 |
% channel to that file is called |\poemcontents|. The rest of the |
| 5874 |
% command is the page style for the contents section. You will notice |
| 5875 |
% the running head Contents, and the title of the Contents section. I am |
| 5876 |
% assuming that the table of contents starts on page 5, but it may be |
| 5877 |
% different in different books. |
| 5878 |
% If you want to change that page |
| 5879 |
% number (say, to page 3) without messing with this file, issue |
| 5880 |
% |\literalcontents{\setcounter{page}{3}}| just after you issue |
| 5881 |
% |\makepoemcontents| Alternatively, you can issue |\makepoemcontents{}| with its |
| 5882 |
% optional argument, putting the page number in the argument. |
| 5883 |
% \begin{macrocode} |
| 5884 |
\newtoks{\pmclcontentsname} |
| 5885 |
\pmclcontentsname={CONTENTS} |
| 5886 |
\newtoks{\pmclcontentsheader} |
| 5887 |
\pmclcontentsheader={Contents} |
| 5888 |
\newcommand{\changecontentsname}[1]{% |
| 5889 |
\pmclcontentsname={#1}} |
| 5890 |
\newcommand{\changecontentsheader}[1]{% |
| 5891 |
\pmclcontentsheader={#1}} |
| 5892 |
\newcommand{\makepoemcontents}[1][5]{\global\poemcontentsontrue |
| 5893 |
\newwrite\poemcontents |
| 5894 |
\immediate\openout\poemcontents=\jobname.ctn |
| 5895 |
\literalcontents{\flushbottom\normalfont |
| 5896 |
{\par\clearpage{\pagestyle{volumetitlestyle}\cleardoublepage} |
| 5897 |
\pagestyle{fancy}\thispagestyle{volumetitlestyle}} |
| 5898 |
\pagenumbering{roman} |
| 5899 |
\setcounter{page}{#1} |
| 5900 |
\fancyhead[RO,LE]{{\small\textrm{\thepage}}} |
| 5901 |
\fancyhead[CO]{{\small{\em \the\pmclcontentsheader}}} |
| 5902 |
\fancyhead[CE]{{\small{\em \the\pmclcontentsheader}}} |
| 5903 |
\fancyfoot{} |
| 5904 |
\backmattersink |
| 5905 |
\begin{center}{\normalfont \backmatterheaderfont |
| 5906 |
\the\pmclcontentsname}\end{center} |
| 5907 |
\lefthyphenmin=2\backmatterafterheadersink\tolerance=500\language=0} |
| 5908 |
\literalcontents{ \relax}} |
| 5909 |
% \end{macrocode} |
| 5910 |
% \end{macro} |
| 5911 |
|
| 5912 |
% Next, the textual collations: |
| 5913 |
% \begin{macro}{\maketextnotes} Like the |\makecontents| macro, |
| 5914 |
% |\maketextnotes| opens an external file using |\jobname|, this time with the extension .ent. It |
| 5915 |
% makes sure that line numbering is on (since it makes no sense to make |
| 5916 |
% notes without numbering the lines, particularly since the |
| 5917 |
% |\textnote{}| macro uses the line number). And it makes sure that the |
| 5918 |
% notes section is set with a flush bottom line, rather than with the |
| 5919 |
% ragged bottom line used for the verse sections. Also, it sets a |
| 5920 |
% label for sending the page number of the textual notes to the table of |
| 5921 |
% contents. |
| 5922 |
% |
| 5923 |
% First, a few commands for use by all of the endnotes |
| 5924 |
% sections. |\setendnotessectiontitledefaults| sets the title of the endnotes section |
| 5925 |
% at the top of the first page of that species of note, and takes six arguments, |
| 5926 |
% which are, in order, (1) the title of the endnote section, (2) |
| 5927 |
% commands to be issued before setting the |
| 5928 |
% title (minimally, a penalty, such as |\poemtitlepenalty|), (3) the |
| 5929 |
% font size in which the title is to be set in the text (such as |
| 5930 |
% |\poemtitlefont| or |\large|), (4) any indentation of the title |
| 5931 |
% (|\relax| to put the title where |\poemtitle| puts it, or |\titleindent| to put it where |
| 5932 |
% |\sequencesectiontitle| puts it), (5) commands to be issued after the |
| 5933 |
% title is set (such as |\afterpoemtitleskip|) and (6) the label to |
| 5934 |
% be used for this section, to be used to set the page number in the |
| 5935 |
% table of contents. |
| 5936 |
% |
| 5937 |
% |\setendnotessectiontitle| is a simpler version of |\setendnotessectiontitledefaults| |
| 5938 |
% with all the defaults filled in, leaving only two arguments, the |
| 5939 |
% title of the section, and the label for use by the table of |
| 5940 |
% contents. |
| 5941 |
% |
| 5942 |
% |\contentsendnotesdefaults| sets the defaults for the table of |
| 5943 |
% contents entries for endnotes sections. It takes four arguments |
| 5944 |
% which are, in order, (1) the title of the endnote section, (2) the |
| 5945 |
% indentation of the title in the table of contents (such as |
| 5946 |
% |\contentsindentone|), (3), the font size in which the title |
| 5947 |
% should be set (such as |\contentspoemtitlefont|) and (4) the amount |
| 5948 |
% overrun lines in the table of contents should be indented (such as |
| 5949 |
% |\contentsindenttwoamount|). |
| 5950 |
% |
| 5951 |
% |\contentsendnotesindent| sets the default indent for table of |
| 5952 |
% contents entries for endnotes sections, and |\contentsendnotesfont| |
| 5953 |
% sets the default font for the. |
| 5954 |
% |
| 5955 |
% |\contentsendnotestitle| is a simpler command for sending |
| 5956 |
% information about endnote sections to the table of contents, taking |
| 5957 |
% only two arguments, the title and the label used for page reference |
| 5958 |
% purposes. |
| 5959 |
% \begin{macrocode} |
| 5960 |
% Generic command for titles of endnote sections |
| 5961 |
\newcommand{\setendnotessectiontitledefaults}[6]{% |
| 5962 |
#2% |
| 5963 |
#3 \begin{titleentryenvironment}% |
| 5964 |
{\ifcentertitleson\begin{center}#1\end{center}\else #4 #1\fi}% |
| 5965 |
\end{titleentryenvironment}% |
| 5966 |
#5% |
| 5967 |
\label{#6} |
| 5968 |
} |
| 5969 |
% Simpler version with only two parameters, the title and the label |
| 5970 |
% for page references |
| 5971 |
\newcommand{\setendnotessectiontitle}[2]{% |
| 5972 |
\setendnotessectiontitledefaults{#1}{\poemtitlepenalty\backmattersink}{\backmatterheaderfont} |
| 5973 |
{\notestitleindent}{\lefthyphenmin=2\backmatterafterheadersink}{#2}} |
| 5974 |
% Generic command for sending info about endnotes sections to table |
| 5975 |
% of contents |
| 5976 |
\newcommand{\contentsendnotesdefaults}[4]{\ifpoemcontentson |
| 5977 |
\immediate\write\poemcontents{\string\begin\string{contentsentryenvironment\string}}% |
| 5978 |
\literalcontents{#2{#3#1}}% |
| 5979 |
\ifputpagenumberincontents |
| 5980 |
\immediate\write\poemcontents{\string\contentsleaders}% |
| 5981 |
\immediate\write\poemcontents{\string\pageref |
| 5982 |
\string{#4\string}}% |
| 5983 |
\else |
| 5984 |
\literalcontents{\relax}% |
| 5985 |
\fi |
| 5986 |
\immediate\write\poemcontents{\string\end\string{contentsentryenvironment\string}}% |
| 5987 |
\immediate\write\poemcontents{\string\par}% |
| 5988 |
\fi |
| 5989 |
} |
| 5990 |
% default styles for contents entries for endnotes sections |
| 5991 |
\newcommand{\contentsendnotesindent}{\contentsindentone} |
| 5992 |
\newcommand{\contentsendnotesfont}{\contentspoemtitlefont} |
| 5993 |
% simpler command to set up contents entry with only two parameters, |
| 5994 |
% the title and the label for page references |
| 5995 |
\newcommand{\contentsendnotestitle}[2]{% |
| 5996 |
\contentsendnotesdefaults{#1}{\contentsendnotesindent}{\contentsendnotesfont}{#2}% |
| 5997 |
} |
| 5998 |
% command for paragraph breaks within notes |
| 5999 |
\newlength{\noteindentation} |
| 6000 |
\setlength{\noteindentation}{1em} |
| 6001 |
\newcommand{\noteparbreak}{\\ |
| 6002 |
\hspace*{\noteindentation}} |
| 6003 |
% tokens to use to change the names of the sections |
| 6004 |
\newtoks{\pmclnotesname} |
| 6005 |
\pmclnotesname={TEXTUAL NOTES} |
| 6006 |
\newcommand{\changenotesname}[1]{\pmclnotesname={#1}} |
| 6007 |
\newtoks{\notesheadername} |
| 6008 |
\notesheadername={Textual Notes to} |
| 6009 |
\newcommand{\changenotesheader}[1]{\notesheadername={#1}} |
| 6010 |
\newtoks{\textnotescontentsname} |
| 6011 |
\textnotescontentsname={Textual Notes} |
| 6012 |
\newcommand{\changetextnotescontentsname}[1]{\textnotescontentsname={#1}} |
| 6013 |
% A boolean to change to two column notes. |
| 6014 |
\newif\iftextnotestwocol |
| 6015 |
\textnotestwocolfalse |
| 6016 |
% Setup for textual notes |
| 6017 |
\newcommand{\maketextnotes}{\global\textnotesontrue |
| 6018 |
\global\verselinenumberstrue |
| 6019 |
\newwrite\textnotes |
| 6020 |
\immediate\openout\textnotes=\jobname.ent |
| 6021 |
\literaltextnote{\flushbottom{\par\clearpage |
| 6022 |
{\pagestyle{volumetitlestyle}\cleardoublepage} |
| 6023 |
\thispagestyle{volumetitlestyle}} |
| 6024 |
\fancyhead{} |
| 6025 |
\fancyfoot{} |
| 6026 |
\fancyhead[RO,LE]{{\small\textrm{\thepage}}} |
| 6027 |
\fancyhead[CO]{{\small{\em \the\notesheadername~\mymarks}}} |
| 6028 |
\fancyhead[CE]{{\small{\em \the\notesheadername~\mymarks}}} |
| 6029 |
\fancyfoot[C]{} |
| 6030 |
\mark{3} |
| 6031 |
\setendnotessectiontitle{\the\pmclnotesname}{textualnotes} |
| 6032 |
\tolerance=500\language=0 |
| 6033 |
\normalfont \backmattertextfont |
| 6034 |
\iftextnotestwocol |
| 6035 |
\begin{multicols}{2} |
| 6036 |
\fi |
| 6037 |
\setlength{\parindent}{-10pt} |
| 6038 |
} |
| 6039 |
} |
| 6040 |
|
| 6041 |
% \end{macrocode} |
| 6042 |
% \end{macro} |
| 6043 |
|
| 6044 |
% \begin{macro}{\makeemendations} |
| 6045 |
% Next, the emendations section: |
| 6046 |
% \begin{macrocode} |
| 6047 |
% tokens for changing the names of these notes |
| 6048 |
\newtoks{\emendationsname} |
| 6049 |
\emendationsname={EMENDATIONS} |
| 6050 |
\newcommand{\changeemendationsname}[1]{\emendationsname={#1}} |
| 6051 |
\newtoks{\emendationsheadername} |
| 6052 |
\emendationsheadername={Emendations to} |
| 6053 |
\newcommand{\changeemendationsheader}[1]{\emendationsheadername={#1}} |
| 6054 |
\newtoks{\emendationscontentsname} |
| 6055 |
\emendationscontentsname={Emendations} |
| 6056 |
\newcommand{\changeemendationscontentsname}[1]{% |
| 6057 |
\emendationscontentsname={#1}} |
| 6058 |
% two column notes |
| 6059 |
\newif\ifemendationstwocol |
| 6060 |
\emendationstwocolfalse |
| 6061 |
% Emendations section setup |
| 6062 |
\newcommand{\makeemendations}{\global\emendationsontrue |
| 6063 |
\newwrite\emendations |
| 6064 |
\global\verselinenumberstrue |
| 6065 |
\immediate\openout\emendations=\jobname.emd |
| 6066 |
\literalemend{\flushbottom{\par\clearpage |
| 6067 |
{\pagestyle{volumetitlestyle}\cleardoublepage} |
| 6068 |
\thispagestyle{volumetitlestyle}} |
| 6069 |
\fancyhead{} |
| 6070 |
\fancyhead[RO,LE]{{\small\textrm{\thepage}}} |
| 6071 |
\fancyhead[CO]{{\small{\em \the\emendationsheadername~\mymarks}}} |
| 6072 |
\fancyhead[CE]{{\small{\em \the\emendationsheadername~\mymarks}}} |
| 6073 |
\fancyfoot{} |
| 6074 |
\mark{3} |
| 6075 |
\setendnotessectiontitle{\the\emendationsname}{emendationnotes} |
| 6076 |
\tolerance=500\language=0 |
| 6077 |
\normalfont \backmattertextfont |
| 6078 |
\ifemendationstwocol |
| 6079 |
\begin{multicols}{2} |
| 6080 |
\fi |
| 6081 |
\setlength{\parindent}{-10pt} |
| 6082 |
} |
| 6083 |
} |
| 6084 |
% \end{macrocode} |
| 6085 |
% \end{macro} |
| 6086 |
|
| 6087 |
% \begin{macro}{\makeexplanatorynotes} |
| 6088 |
% And the explanatory notes: |
| 6089 |
% \begin{macrocode} |
| 6090 |
% Tokens to change names of these notes |
| 6091 |
\newtoks{\explanationsname} |
| 6092 |
\explanationsname={EXPLANATORY NOTES} |
| 6093 |
\newcommand{\changeexplanationsname}[1]{\explanationsname={#1}} |
| 6094 |
\newtoks{\explanationsheadername} |
| 6095 |
\explanationsheadername={Explanatory Notes to} |
| 6096 |
\newcommand{\changeexplanationsheader}[1]{\explanationsheadername={#1}} |
| 6097 |
\newtoks{\explanationscontentsname} |
| 6098 |
\explanationscontentsname={Explanatory Notes} |
| 6099 |
\newcommand{\changeexplanationscontentsname}[1]{% |
| 6100 |
\explanationscontentsname={#1}} |
| 6101 |
% Two column notes |
| 6102 |
\newif\ifexplanationstwocol |
| 6103 |
\explanationstwocolfalse |
| 6104 |
% Explanatory notes setup |
| 6105 |
\newcommand{\makeexplanatorynotes}{\global\explanontrue |
| 6106 |
\global\verselinenumberstrue |
| 6107 |
\newwrite\explanations |
| 6108 |
\immediate\openout\explanations=\jobname.enx |
| 6109 |
\literalexplain{\flushbottom{\par\clearpage |
| 6110 |
{\pagestyle{volumetitlestyle}\cleardoublepage} |
| 6111 |
\thispagestyle{volumetitlestyle}} |
| 6112 |
\fancyhead[RO,LE]{{\small\textrm{\thepage}}} |
| 6113 |
\fancyhead[CO]{{\small{\em \the\explanationsheadername~\mymarks}}} |
| 6114 |
\fancyhead[CE]{{\small{\em \the\explanationsheadername~\mymarks}}} |
| 6115 |
\fancyfoot{} |
| 6116 |
\mark{3} |
| 6117 |
\setendnotessectiontitle{\the\explanationsname}{explanatorynotes} |
| 6118 |
\tolerance=500\language=0 |
| 6119 |
\normalfont \backmattertextfont |
| 6120 |
\ifexplanationstwocol |
| 6121 |
\begin{multicols}{2} |
| 6122 |
\fi |
| 6123 |
\setlength{\parindent}{-10pt} |
| 6124 |
} |
| 6125 |
} |
| 6126 |
|
| 6127 |
% \end{macrocode} |
| 6128 |
% \end{macro} |
| 6129 |
% |
| 6130 |
% Auxiliary commands for note and title sections |
| 6131 |
% \begin{macrocode} |
| 6132 |
% |
| 6133 |
\newcommand{\@pagemarktotextnotes}[1]{% |
| 6134 |
\immediate\write\textnotes{\string\setcounterfrompageref\string{notepageholdertitle\string}% |
| 6135 |
\string{#1\string}\string\unskip}% |
| 6136 |
\immediate\write\textnotes{\string\mark% |
| 6137 |
\string{\string\thenotepageholdertitle\string}}% |
| 6138 |
} |
| 6139 |
\newcommand{\@poempagetotextnotes}[1]{% |
| 6140 |
\immediate\write\textnotes{\string\par\string\argpageref\string{#1\string}\string\unskip}% |
| 6141 |
\@pagemarktotextnotes{#1}} |
| 6142 |
\newcommand{\@poemtitletotextnotes}[1]{% |
| 6143 |
\ifputpagenumberinnotes% |
| 6144 |
\literaltextnote{\textbf{#1}}% |
| 6145 |
\else% |
| 6146 |
\literaltextnote{\par}\literaltextnote{\textbf{#1}}% |
| 6147 |
\fi} |
| 6148 |
% \end{macrocode} |
| 6149 |
% |
| 6150 |
% \subsection{~Appendices, Forewords, Contents Entries} |
| 6151 |
% \begin{macro}{\makeappendix} |
| 6152 |
% \begin{macrocode} |
| 6153 |
\newif\ifappendixincontents |
| 6154 |
\appendixincontentstrue |
| 6155 |
\newif\ifforewordincontents |
| 6156 |
\forewordincontentstrue |
| 6157 |
% |
| 6158 |
\newcommand{\appendixdividerpage}[1]{\flushbottom{\par\clearpage |
| 6159 |
{\pagestyle{volumetitlestyle}\cleardoublepage} |
| 6160 |
\thispagestyle{volumetitlestyle}} |
| 6161 |
\fancyhead{} |
| 6162 |
\fancyfoot{} |
| 6163 |
\fancyhead[RO,LE]{\small\textrm{\thepage}} |
| 6164 |
\fancyhead[CO]{\small{\em #1}} |
| 6165 |
\fancyhead[CE]{#1} |
| 6166 |
\fancyfoot[C]{}} |
| 6167 |
% |
| 6168 |
\newcommand{\appendixtitle}[1]{ |
| 6169 |
\setendnotessectiontitledefaults{#1}{\poemtitlepenalty\backmattersink}{\backmatterheaderfont} |
| 6170 |
{\appendixtitleindent}{\lefthyphenmin=2\backmatterafterheadersink}{appdx#1} |
| 6171 |
\tolerance=500\language=0 |
| 6172 |
\normalfont \backmattertextfont |
| 6173 |
\setlength{\parindent}{\noteindentation} |
| 6174 |
\ifappendixincontents\contentsendnotestitle{#1}{appdx#1}\fi |
| 6175 |
} |
| 6176 |
% |
| 6177 |
\newcommand{\makeappendix}[1]{% |
| 6178 |
\appendixdividerpage{#1} |
| 6179 |
\appendixtitle{#1} |
| 6180 |
} |
| 6181 |
% |
| 6182 |
\newcommand{\contentsendnotessubtitle}[2]{ |
| 6183 |
\contentsendnotesdefaults{#1}{\contentsindenttwo}{\contentsendnotesfont}{#2} |
| 6184 |
} |
| 6185 |
% |
| 6186 |
\newcommand{\subappendixtitle}[1]{% |
| 6187 |
\setendnotessectiontitledefaults{#1}{\poemtitlepenalty\backmattersink}{\backmatterheaderfont} |
| 6188 |
{\subappendixtitleindent}{\lefthyphenmin=2\backmatterafterheadersink}{appdx#1} |
| 6189 |
\tolerance=500\language=0 |
| 6190 |
\normalfont \backmattertextfont |
| 6191 |
\setlength{\parindent}{\noteindentation} |
| 6192 |
\ifappendixincontents\contentsendnotessubtitle{#1}{appdx#1}\fi |
| 6193 |
} |
| 6194 |
% |
| 6195 |
\newcommand{\makesubappendix}[1]{% |
| 6196 |
\appendixdividerpage{#1} |
| 6197 |
\subappendixtitle{#1} |
| 6198 |
} |
| 6199 |
\newcommand{\foreworddividerpage}[1]{\flushbottom{\par\clearpage |
| 6200 |
{\pagestyle{volumetitlestyle}\cleardoublepage} |
| 6201 |
\thispagestyle{volumetitlestyle}} |
| 6202 |
\fancyhead{} |
| 6203 |
\fancyfoot{} |
| 6204 |
\fancyhead[RO,LE]{\small\textrm{\thepage}} |
| 6205 |
\fancyhead[CO]{\small{\em #1}} |
| 6206 |
\fancyhead[CE]{#1} |
| 6207 |
\fancyfoot[C]{}} |
| 6208 |
% |
| 6209 |
\newcommand{\forewordtitle}[1]{ |
| 6210 |
\setendnotessectiontitledefaults{#1}{\poemtitlepenalty\backmattersink}{\backmatterheaderfont} |
| 6211 |
{\forewordtitleindent}{\lefthyphenmin=2\backmatterafterheadersink}{foreword#1} |
| 6212 |
\tolerance=500\language=0 |
| 6213 |
\normalfont \backmattertextfont |
| 6214 |
\setlength{\parindent}{\noteindentation} |
| 6215 |
\ifforewordincontents\contentsendnotestitle{#1}{foreword#1}\fi |
| 6216 |
} |
| 6217 |
% |
| 6218 |
\newcommand{\makeforeword}[1]{% |
| 6219 |
\foreworddividerpage{#1} |
| 6220 |
\forewordtitle{#1} |
| 6221 |
} |
| 6222 |
|
| 6223 |
% \end{macrocode} |
| 6224 |
% \end{macro} |
| 6225 |
% \begin{macro}{\pmclcontentsentry} |
| 6226 |
% \begin{macrocode} |
| 6227 |
\newcommand{\pmclcontentsentrydefaults}[4]{ |
| 6228 |
\ifpoemcontentson |
| 6229 |
\immediate\write\poemcontents{\string\begin\string{contentsentryenvironment\string}}% |
| 6230 |
\literalcontents{#2{#3#1}}% |
| 6231 |
\ifputpagenumberincontents |
| 6232 |
\immediate\write\poemcontents{\string\contentsleaders}% |
| 6233 |
\literalcontents{#4} |
| 6234 |
\else |
| 6235 |
\literalcontents{\relax}% |
| 6236 |
\fi |
| 6237 |
\immediate\write\poemcontents{\string\end\string{contentsentryenvironment\string}}% |
| 6238 |
\immediate\write\poemcontents{\string\par}% |
| 6239 |
\fi |
| 6240 |
} |
| 6241 |
% |
| 6242 |
\newcommand{\pmclcontentsentry}[3]{% |
| 6243 |
\pmclcontentsentrydefaults{#1}{#2}{\contentsendnotesfont}{#3}% |
| 6244 |
} |
| 6245 |
% \end{macrocode} |
| 6246 |
% \end{macro} |
| 6247 |
% \subsection{~Book, volume, and volume section titles} |
| 6248 |
% \begin{macro}{\wholebooktitle} |
| 6249 |
% \begin{macro}{\booksection} |
| 6250 |
% \begin{macrocode} |
| 6251 |
\newcommand{\wholebooktitle}[1]{{\Huge\begin{center} |
| 6252 |
\hbox{#1}\end{center}} |
| 6253 |
} |
| 6254 |
\newcommand{\booksection}[1]{\volumesection{#1}} |
| 6255 |
% \end{macrocode} |
| 6256 |
% \end{macro} |
| 6257 |
% \end{macro} |
| 6258 |
% \begin{macro}{\volumetitle{}} |
| 6259 |
% \begin{macrocode} |
| 6260 |
\newcommand{\volumetitle}[1]{% |
| 6261 |
\set@p@emtitle{#1}{\volumetitlesink\par}{\volumetitlefont} |
| 6262 |
{\volumetitleindent}{\nobreak\par\nobreak}{\z@} |
| 6263 |
\putpagenumberincontentsfalse |
| 6264 |
\putpagenumberinnotesfalse |
| 6265 |
\literalcontents{\par\goodbreak\bigskip} |
| 6266 |
\c@ntentsinfo{#1}{\contentsvolumetitleindent}{\contentsvolumefont} |
| 6267 |
{\contentsvolumetitleindentamount} |
| 6268 |
\literalcontents{\par\goodbreak\medskip} |
| 6269 |
\literaltextnote{\notesvolumetitlepenalty\bigskip\goodbreak\par} |
| 6270 |
\t@xtnotesinfo{\backmattervolumefont #1 \backmattertextfont\nobreak} |
| 6271 |
\putpagenumberincontentstrue |
| 6272 |
\putpagenumberinnotestrue} |
| 6273 |
% \end{macrocode} |
| 6274 |
% \end{macro} |
| 6275 |
% \begin{macro}{\volumetitlefirstline} |
| 6276 |
% \begin{macro}{\volumetitlelastline} |
| 6277 |
% \begin{macro}{\volumesubtitle} |
| 6278 |
% \begin{macro}{\volumesectiontitle} |
| 6279 |
% \begin{macrocode} |
| 6280 |
\newcommand{\volumetitlefirstline}[1]{\firstlinesettings% |
| 6281 |
\set@p@emtitle{#1}{\volumetitlesink\par} |
| 6282 |
{\volumetitlefont} |
| 6283 |
{\volumetitleindent}{\nobreak\par\nobreak}{\z@} |
| 6284 |
\putpagenumberincontentsfalse |
| 6285 |
\putpagenumberinnotesfalse |
| 6286 |
\literalcontents{\par\goodbreak\bigskip} |
| 6287 |
\c@ntentsinfo{#1}{\contentsvolumetitleindent}{\contentsvolumefont} |
| 6288 |
{\contentsvolumetitleindentamount} |
| 6289 |
\literalcontents{\medskip\par\nobreak} |
| 6290 |
% \literaltextnote{\notesvolumetitlepenalty\bigskip\par} |
| 6291 |
\t@xtnotesinfo{\backmattervolumefont #1 \backmattertextfont\nobreak} |
| 6292 |
\putpagenumberincontentstrue |
| 6293 |
\putpagenumberinnotestrue} |
| 6294 |
\newcommand{\volumetitlemiddleline}[1]{\middlelinesettings% |
| 6295 |
\set@p@emtitle{#1}{\relax} |
| 6296 |
{\volumetitlefont} |
| 6297 |
{\volumetitlesecondlineindent}{\nobreak\par\nobreak}{\z@} |
| 6298 |
\putpagenumberincontentsfalse |
| 6299 |
\putpagenumberinnotesfalse |
| 6300 |
\c@ntentsinfo{#1}{\contentsvolumetitleindent}{\contentsvolumefont} |
| 6301 |
{\contentsvolumetitleindentamount} |
| 6302 |
\literalcontents{\medskip\par\nobreak} |
| 6303 |
\t@xtnotesinfo{\backmattervolumefont #1 \backmattertextfont\nobreak} |
| 6304 |
\putpagenumberincontentstrue |
| 6305 |
\putpagenumberinnotestrue} |
| 6306 |
\newcommand{\volumetitlelastline}[1]{\lastlinesettings% |
| 6307 |
\set@p@emtitle{#1}{\relax} |
| 6308 |
{\volumetitlefont} |
| 6309 |
{\volumetitlesecondlineindent}{\nobreak\par\nobreak}{\z@} |
| 6310 |
\putpagenumberincontentsfalse |
| 6311 |
\putpagenumberinnotesfalse |
| 6312 |
\c@ntentsinfo{#1}{\contentsvolumetitleindent}{\contentsvolumefont} |
| 6313 |
{\contentsvolumetitleindentamount} |
| 6314 |
\literalcontents{\medskip\par\nobreak} |
| 6315 |
\t@xtnotesinfo{\backmattervolumefont #1 \backmattertextfont\nobreak} |
| 6316 |
\putpagenumberincontentstrue |
| 6317 |
\putpagenumberinnotestrue} |
| 6318 |
\newcommand{\volumesubtitle}[1]{{\volumesubtitlefont |
| 6319 |
\volumetitleshift \volumesubtitleindent #1 \par} |
| 6320 |
\ifpoemcontentson |
| 6321 |
\literalcontents{{\contentsvolumesubtitlefont\contentsvolumesubtitleindent |
| 6322 |
#1\par\medskip\nobreak}} |
| 6323 |
\fi |
| 6324 |
\iftextnoteson\iftextnotesatend |
| 6325 |
\immediate\write\textnotes{\string\backmattervolumesubtitlefont\ #1} |
| 6326 |
\immediate\write\textnotes{\string\par \string\backmattertextfont} |
| 6327 |
\immediate\write\textnotes{\string\nobreak} |
| 6328 |
\fi\fi |
| 6329 |
} |
| 6330 |
\newcommand{\volumesubtitlefirstline}[1]{{\firstlinesettings\volumesubtitlefont |
| 6331 |
\volumetitleshift \volumesubtitlesecondlineindent #1 \par} |
| 6332 |
\ifpoemcontentson |
| 6333 |
\literalcontents{{\contentsvolumesubtitlefont\contentsvolumesubtitleindent |
| 6334 |
#1\par\nobreak}} |
| 6335 |
\fi |
| 6336 |
\iftextnoteson\iftextnotesatend |
| 6337 |
\immediate\write\textnotes{\string\backmattervolumesubtitlefont\ #1} |
| 6338 |
\immediate\write\textnotes{\string\par \string\backmattertextfont} |
| 6339 |
\immediate\write\textnotes{\string\nobreak} |
| 6340 |
\fi\fi |
| 6341 |
} |
| 6342 |
\newcommand{\volumesubtitlemiddleline}[1]{{\middlelinesettings\volumesubtitlefont |
| 6343 |
%\volumetitleshift |
| 6344 |
\volumesubtitlesecondlineindent #1 \par} |
| 6345 |
\ifpoemcontentson |
| 6346 |
\literalcontents{{\contentsvolumesubtitlefont\contentsvolumesubtitleindent |
| 6347 |
#1\par\nobreak}} |
| 6348 |
\fi |
| 6349 |
\iftextnoteson\iftextnotesatend |
| 6350 |
\immediate\write\textnotes{\string\backmattervolumesubtitlefont\ #1} |
| 6351 |
\immediate\write\textnotes{\string\par \string\backmattertextfont} |
| 6352 |
\immediate\write\textnotes{\string\nobreak} |
| 6353 |
\fi\fi |
| 6354 |
} |
| 6355 |
\newcommand{\volumesubtitlelastline}[1]{{\lastlinesettings\volumesubtitlefont |
| 6356 |
%\volumetitleshift |
| 6357 |
\volumesubtitlesecondlineindent #1 \par} |
| 6358 |
\ifpoemcontentson |
| 6359 |
\literalcontents{{\contentsvolumesubtitlefont\contentsvolumesubtitleindent |
| 6360 |
#1\par\medskip\nobreak}} |
| 6361 |
\fi |
| 6362 |
\iftextnoteson\iftextnotesatend |
| 6363 |
\immediate\write\textnotes{\string\backmattervolumesubtitlefont\ #1} |
| 6364 |
\immediate\write\textnotes{\string\par \string\backmattertextfont} |
| 6365 |
\immediate\write\textnotes{\string\nobreak} |
| 6366 |
\fi\fi |
| 6367 |
} |
| 6368 |
\newcommand{\volumesectiontitle}[1]{\clearpage\thispagestyle{volumefirststyle} |
| 6369 |
\ifcentertitleson\begin{center} {\volumesubtitlefont\textbf{#1}} |
| 6370 |
\end{center} |
| 6371 |
\else \volumesectiontitleindent {\volumesubtitlefont\textbf{#1}} |
| 6372 |
\fi\bigskip\bigskip |
| 6373 |
\ifpoemcontentson |
| 6374 |
\literalcontents{\goodbreak{\ifcentertitleson\contentsvolumesubtitlefont #1\par\nobreak\else |
| 6375 |
\contentsvolumesectiontitleindent #1 \par\nobreak\fi}} |
| 6376 |
\fi |
| 6377 |
\iftextnoteson\iftextnotesatend |
| 6378 |
\immediate\write\textnotes{\string\notesvolumetitlepenalty} |
| 6379 |
\immediate\write\textnotes{\string\par \string\begin{bf}} |
| 6380 |
\immediate\write\textnotes{#1 \string\end{bf}} |
| 6381 |
\immediate\write\textnotes{\string\par} |
| 6382 |
\immediate\write\textnotes{\string\nobreak} |
| 6383 |
\fi\fi |
| 6384 |
} |
| 6385 |
\newcommand{\volumesectiontitlefirstline}[1]{\firstlinesettings\clearpage\thispagestyle{volumefirststyle} |
| 6386 |
\ifcentertitleson\begin{center} {\volumesubtitlefont\textbf{#1}} |
| 6387 |
\end{center} |
| 6388 |
\else \volumesectiontitleindent {\volumesubtitlefont\textbf{#1}\par} |
| 6389 |
\fi% \bigskip\bigskip |
| 6390 |
\ifpoemcontentson |
| 6391 |
\literalcontents{\goodbreak{\ifcentertitleson\contentsvolumesubtitlefont #1\par\nobreak\else |
| 6392 |
\contentsvolumesectiontitleindent #1 \par\nobreak\fi}} |
| 6393 |
\fi |
| 6394 |
\iftextnoteson\iftextnotesatend |
| 6395 |
\immediate\write\textnotes{\string\notesvolumetitlepenalty} |
| 6396 |
\immediate\write\textnotes{\string\par \string\begin{bf}} |
| 6397 |
\immediate\write\textnotes{#1 \string\end{bf}} |
| 6398 |
\immediate\write\textnotes{\string\par} |
| 6399 |
\immediate\write\textnotes{\string\nobreak} |
| 6400 |
\fi\fi |
| 6401 |
} |
| 6402 |
\newcommand{\volumesectiontitlemiddleline}[1]{\middlelinesettings |
| 6403 |
%\clearpage\thispagestyle{volumefirststyle} |
| 6404 |
\ifcentertitleson\begin{center} {\volumesubtitlefont\textbf{#1}} |
| 6405 |
\end{center} |
| 6406 |
\else \volumesectiontitleindent {\volumesubtitlefont\textbf{#1}\par} |
| 6407 |
\fi% \bigskip\bigskip |
| 6408 |
\ifpoemcontentson |
| 6409 |
\literalcontents{\goodbreak{\ifcentertitleson\contentsvolumesubtitlefont #1\par\nobreak\else |
| 6410 |
\contentsvolumesectiontitleindent #1 \par\nobreak\fi}} |
| 6411 |
\fi |
| 6412 |
\iftextnoteson\iftextnotesatend |
| 6413 |
\immediate\write\textnotes{\string\notesvolumetitlepenalty} |
| 6414 |
\immediate\write\textnotes{\string\par \string\begin{bf}} |
| 6415 |
\immediate\write\textnotes{#1 \string\end{bf}} |
| 6416 |
\immediate\write\textnotes{\string\par} |
| 6417 |
\immediate\write\textnotes{\string\nobreak} |
| 6418 |
\fi\fi |
| 6419 |
} |
| 6420 |
\newcommand{\volumesectiontitlelastline}[1]{\lastlinesettings |
| 6421 |
%\clearpage\thispagestyle{volumefirststyle} |
| 6422 |
\ifcentertitleson\begin{center} {\volumesubtitlefont\textbf{#1}} |
| 6423 |
\end{center} |
| 6424 |
\else \volumesectiontitleindent {\volumesubtitlefont\textbf{#1}} |
| 6425 |
\fi\bigskip\bigskip |
| 6426 |
\ifpoemcontentson |
| 6427 |
\literalcontents{\goodbreak{\ifcentertitleson\contentsvolumesubtitlefont #1\par\nobreak\else |
| 6428 |
\contentsvolumesectiontitleindent #1 \par\nobreak\fi}} |
| 6429 |
\fi |
| 6430 |
\iftextnoteson\iftextnotesatend |
| 6431 |
\immediate\write\textnotes{\string\notesvolumetitlepenalty} |
| 6432 |
\immediate\write\textnotes{\string\par \string\begin{bf}} |
| 6433 |
\immediate\write\textnotes{#1 \string\end{bf}} |
| 6434 |
\immediate\write\textnotes{\string\par} |
| 6435 |
\immediate\write\textnotes{\string\nobreak} |
| 6436 |
\fi\fi |
| 6437 |
} |
| 6438 |
% \end{macrocode} |
| 6439 |
% \end{macro} |
| 6440 |
% \end{macro} |
| 6441 |
% \end{macro} |
| 6442 |
% \end{macro} |
| 6443 |
|
| 6444 |
% \subsection{~Commands for setting titles of poems and sequences} |
| 6445 |
% First, commands for sending labels to the table of contents and to |
| 6446 |
% the notes sections. Since these are internal commands, not intended |
| 6447 |
% to be issued in the body of the text, they might have been marked out |
| 6448 |
% with ``at'' signs to prevent accidental redefinition. But since they |
| 6449 |
% are repeatedly written out to the external files, it seemed more |
| 6450 |
% economical to run the risk of redefinition than to write out |
| 6451 |
% |\makeatletter| and |\makeatother| with every note. |
| 6452 |
% \begin{macrocode} |
| 6453 |
\newcommand{\makepoemlabel}[1]{\label{#1}} |
| 6454 |
\newcommand{\argpageref}[1]{\pageref{#1}} |
| 6455 |
% \end{macrocode} |
| 6456 |
% \subsubsection{Poem Titles} |
| 6457 |
% \begin{macro}{\poemtitle}\label{poemtitlecode} |
| 6458 |
% All of the other commands in this section are variations on this |
| 6459 |
% one, changing the penalties, the skips, the indentations, and the |
| 6460 |
% fonts. The command breaks into three sections. First, the title |
| 6461 |
% is set in the text. |\poemtitlepenalty| tests whether there is |
| 6462 |
% room for the title and the first couple of lines. |\poemtitlefont| |
| 6463 |
% globally sets the fonts for all poem titles. You can put the |
| 6464 |
% argument in an |\hbox{}| to make sure that the poem title is not |
| 6465 |
% broken across two lines, and the |\label| records the page for the |
| 6466 |
% contents and notes sections. |\afterpoemtitleskip| is the amount |
| 6467 |
% of white space after a poem title. |\fulltitleholder| and |
| 6468 |
% |\@compoundlabelscratch| record the title for concatenation later. |
| 6469 |
% All of these commands can manage titles with control sequences in |
| 6470 |
% them, such as for italics or international characters. In an |
| 6471 |
% earlier version there were special commands for such titles, using |
| 6472 |
% two arguments (one with the control sequence, one without it). |
| 6473 |
% Those commands are no longer necessary, but have been retained for |
| 6474 |
% backward compatibility with earlier versions. |
| 6475 |
% |
| 6476 |
% Second, the poem is entered in the external file for the table of |
| 6477 |
% contents. |\contentsindentone| sets it in one level in the hierarchy |
| 6478 |
% of indentations, and |\contentspoemtitlefont| is the type size used |
| 6479 |
% for poems in the table of contents. The |\pageref{}| holds the page |
| 6480 |
% number of the poem. |
| 6481 |
% |
| 6482 |
% Third, a new paragraph is opened in the textual notes for textual |
| 6483 |
% collations. |\@poempagetotextnotes{}| sends the page number to the |
| 6484 |
% textual notes. |\@poemtitletotextnotes{}| sends the title. |
| 6485 |
% \begin{macrocode} |
| 6486 |
|
| 6487 |
\newcommand{\m@kep@emlabel}{\ifsinglelinetitle% |
| 6488 |
\addtocounter{poemnumber}{1}% |
| 6489 |
\makepoemlabel{poem\thepoemnumber}% |
| 6490 |
\else\iftitlefirstline% |
| 6491 |
\addtocounter{poemnumber}{1}% |
| 6492 |
\makepoemlabel{poem\thepoemnumber}% |
| 6493 |
\else \relax |
| 6494 |
\fi |
| 6495 |
\fi |
| 6496 |
} |
| 6497 |
|
| 6498 |
\newcommand{\m@ken@teholder}[1]{% |
| 6499 |
\ifsinglelinetitle |
| 6500 |
\fulltitleholder={#1}% |
| 6501 |
\global\edef\@compoundlabelscratch{poem\thepoemnumber}% |
| 6502 |
\else\iftitlefirstline |
| 6503 |
\fulltitleholder={#1}% |
| 6504 |
\global\edef\@compoundlabelscratch{poem\thepoemnumber}% |
| 6505 |
\else\iftitlemiddleline |
| 6506 |
\titlesofar=\fulltitleholder |
| 6507 |
\titleincrement={~#1}% |
| 6508 |
\global\edef\titleconcat{\the\titlesofar \the\titleincrement}% |
| 6509 |
\fulltitleholder=\expandafter{\titleconcat}% |
| 6510 |
\global\edef\@compoundlabelscratch{poem\thepoemnumber}% |
| 6511 |
\else |
| 6512 |
\titlesofar=\fulltitleholder |
| 6513 |
\titleincrement={~#1}% |
| 6514 |
\global\edef\titleconcat{\the\titlesofar \the\titleincrement}% |
| 6515 |
\fulltitleholder=\expandafter{\titleconcat}% |
| 6516 |
\global\edef\@compoundlabelscratch{poem\thepoemnumber}% |
| 6517 |
\fi |
| 6518 |
\fi |
| 6519 |
\fi |
| 6520 |
} |
| 6521 |
\newif\ifcentertitleson |
| 6522 |
\newcommand{\centertitles}{\centertitlesontrue\centerepigraphsontrue} |
| 6523 |
\makeatletter |
| 6524 |
\newcommand{\set@p@emtitle}[6]{\iftitlesatleftversemargin% |
| 6525 |
{\begin{pmclverse}\addtolength{\leftmargin}{-\leftmargini}{#2 #3 #4 #1 #5} \end{pmclverse}}% |
| 6526 |
\else% |
| 6527 |
\setlength{\titleentryoverrun}{#6}% |
| 6528 |
{#2}% |
| 6529 |
{#3 \begin{titleentryenvironment}% |
| 6530 |
{{\ifnormaltitleindentation #4 #1% |
| 6531 |
\else \ifcentertitleson \begin{center} #1 \end{center} \else #1\fi\fi}}% |
| 6532 |
\end{titleentryenvironment}}% |
| 6533 |
{#5}% |
| 6534 |
\m@kep@emlabel |
| 6535 |
\m@ken@teholder{#1}% |
| 6536 |
\setlength{\titleentryoverrun}{\z@}\fi} |
| 6537 |
%\newcommand{\set@p@emtitle}[6]{\setlength{\titleentryoverrun}{#6}% |
| 6538 |
%{#2}% |
| 6539 |
%{#3 \begin{titleentryenvironment}% |
| 6540 |
%{\ifcentertitleson\begin{center}#1\end{center}\else #4 #1\fi}% |
| 6541 |
%\end{titleentryenvironment}}% |
| 6542 |
%{#5}% |
| 6543 |
%\m@kep@emlabel |
| 6544 |
%\m@ken@teholder{#1}% |
| 6545 |
%\setlength{\titleentryoverrun}{\z@}} |
| 6546 |
% |
| 6547 |
%%% special version for subtitles |
| 6548 |
\newcommand{\set@p@emsubtitle}[6]{\iftitlesatleftversemargin% |
| 6549 |
{\begin{pmclverse}\addtolength{\leftmargin}{-\leftmargini}{#2 #3 #4 #1 #5} \end{pmclverse}}% |
| 6550 |
\else% |
| 6551 |
\setlength{\titleentryoverrun}{#6}% |
| 6552 |
{#2}% |
| 6553 |
{#3 \begin{titleentryenvironment}% |
| 6554 |
{{\ifnormaltitleindentation #4 #1% |
| 6555 |
\else \ifcentertitleson \begin{center} #1 \end{center} \else #1\fi\fi}}% |
| 6556 |
\end{titleentryenvironment}}% |
| 6557 |
{#5}% |
| 6558 |
%\m@kep@emlabel |
| 6559 |
%\m@ken@teholder{#1}% |
| 6560 |
\setlength{\titleentryoverrun}{\z@}\fi} |
| 6561 |
\newcommand{\setcontentsleaders}[1]{% |
| 6562 |
\def\contentsleaders{#1\nobreak% |
| 6563 |
}} |
| 6564 |
\setcontentsleaders{~/~} |
| 6565 |
\newcommand{\c@ntentsinfo}[4]{\ifpoemcontentson |
| 6566 |
\immediate\write\poemcontents{\string\setlength\string\contentsentryoverrun\string{#4\string}}% |
| 6567 |
\immediate\write\poemcontents{\string\begin\string{contentsentryenvironment\string}}% |
| 6568 |
\literalcontents{#2{#3#1}}% |
| 6569 |
\ifputpagenumberincontents |
| 6570 |
\immediate\write\poemcontents{\string\contentsleaders}% |
| 6571 |
\immediate\write\poemcontents{\string\pageref |
| 6572 |
\string{poem\thepoemnumber\string}}% |
| 6573 |
\else |
| 6574 |
\literalcontents{\relax}% |
| 6575 |
\fi |
| 6576 |
\immediate\write\poemcontents{\string\end\string{contentsentryenvironment\string}}% |
| 6577 |
\immediate\write\poemcontents{\string\par}% |
| 6578 |
\immediate\write\poemcontents{\string\setlength\string\contentsentryoverrun |
| 6579 |
\string{\string\contentsindentoneamount\string}}% |
| 6580 |
\fi |
| 6581 |
} |
| 6582 |
\newif\ifputtitleinnotes |
| 6583 |
\puttitleinnotestrue |
| 6584 |
\newcommand{\t@xtnotesinfo}[1]{\iftextnoteson |
| 6585 |
\iftextnotesatend |
| 6586 |
\immediate\write\textnotes{\string\notespoemclubpenalty}% |
| 6587 |
\ifputpagenumberinnotes |
| 6588 |
\@poempagetotextnotes{poem\thepoemnumber}% |
| 6589 |
\fi |
| 6590 |
\ifputtitleinnotes |
| 6591 |
\@poemtitletotextnotes{#1}% |
| 6592 |
\fi |
| 6593 |
% \else |
| 6594 |
% \relax |
| 6595 |
\fi\fi |
| 6596 |
} |
| 6597 |
\newlength{\lefttitlemargin} |
| 6598 |
\newcommand{\leftaligntitlespace}{\hspace{\lefttitlemargin}} |
| 6599 |
\newif\ifleftaligntitles % title flush with left margin of centered poem |
| 6600 |
\leftaligntitlesfalse % default value |
| 6601 |
\newcommand{\left@ligntitleblock}{\rightmargin \z@%% |
| 6602 |
\setlength{\lefttitlemargin}{\linewidth}% |
| 6603 |
\addtolength{\lefttitlemargin}{-\versewidth}% |
| 6604 |
\addtolength{\lefttitlemargin}{-0.5\lefttitlemargin} |
| 6605 |
} |
| 6606 |
% |
| 6607 |
\newcommand{\poemtitle}[1]{% |
| 6608 |
\set@p@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}% |
| 6609 |
{\poemtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\z@}% |
| 6610 |
\c@ntentsinfo{#1}{\contentspoemtitleindent}{\contentspoemtitlefont}% |
| 6611 |
{\contentspoemtitleindentamount}% |
| 6612 |
\t@xtnotesinfo{#1}% |
| 6613 |
} |
| 6614 |
\newcommand{\poemtitlenocontents}[1]{% |
| 6615 |
\set@p@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}% |
| 6616 |
{\poemtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\z@}% |
| 6617 |
\t@xtnotesinfo{#1}% |
| 6618 |
} |
| 6619 |
\newcommand{\poemtitlebaretitle}[1]{% |
| 6620 |
\set@p@emsubtitle{#1}{\poemtitlepenalty}{\poemtitlefont}% |
| 6621 |
{\poemtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\z@}% |
| 6622 |
} |
| 6623 |
\newcommand{\poemtitleonlycontents}[1]{% |
| 6624 |
\c@ntentsinfo{#1}{\contentspoemtitleindent}{\contentspoemtitlefont}% |
| 6625 |
{\contentspoemtitleindentamount}% |
| 6626 |
} |
| 6627 |
\newcommand{\poemtitleonlynotes}[1]{% |
| 6628 |
\m@kep@emlabel |
| 6629 |
\m@ken@teholder{#1}% |
| 6630 |
\t@xtnotesinfo{#1}% |
| 6631 |
} |
| 6632 |
\newcommand{\poemtitlenonotes}[1]{% |
| 6633 |
\set@p@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}% |
| 6634 |
{\poemtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\z@}% |
| 6635 |
\c@ntentsinfo{#1}{\contentspoemtitleindent}{\contentspoemtitlefont}% |
| 6636 |
{\contentspoemtitleindentamount}% |
| 6637 |
} |
| 6638 |
% \end{macrocode} |
| 6639 |
% \end{macro} |
| 6640 |
% \begin{macro}{\poemtitleitalic} Poems with italic titles or other |
| 6641 |
% formatting (such as |\hour{}|) take two arguments. The second |
| 6642 |
% argument is discarded. This command is to maintain backward compatibility |
| 6643 |
% with earlier versions. |
| 6644 |
% \begin{macrocode} |
| 6645 |
\newcommand{\poemtitleitalic}[2]{% |
| 6646 |
\poemtitle{#1}} |
| 6647 |
% \end{macrocode} |
| 6648 |
% \end{macro} |
| 6649 |
% For poem subtitles, see the entry on |\sequencesectionsubtitle{}|. |
| 6650 |
% |
| 6651 |
% \begin{macro}{\poemtitlefirstline} |
| 6652 |
% \begin{macro}{\poemtitlemiddleline} |
| 6653 |
% \begin{macro}{\poemtitlelastline} |
| 6654 |
% Next, macros for setting multiline poem titles. Notice the special larger |
| 6655 |
% penalty for page breaks in the middle of multiple line title. |
| 6656 |
% \begin{macrocode} |
| 6657 |
\newcommand{\firstlinesettings}{\singlelinetitlefalse |
| 6658 |
\titlefirstlinetrue |
| 6659 |
\putpagenumberincontentsfalse |
| 6660 |
\putpagenumberinnotestrue} |
| 6661 |
|
| 6662 |
\newcommand{\middlelinesettings}{\singlelinetitlefalse |
| 6663 |
\titlemiddlelinetrue |
| 6664 |
\putpagenumberincontentsfalse |
| 6665 |
\putpagenumberinnotesfalse} |
| 6666 |
|
| 6667 |
\newcommand{\lastlinesettings}{\singlelinetitlefalse |
| 6668 |
\titlelastlinetrue |
| 6669 |
\putpagenumberincontentstrue |
| 6670 |
\putpagenumberinnotesfalse} |
| 6671 |
|
| 6672 |
\newcommand{\restoresinglelinesettings}{\putpagenumberinnotestrue |
| 6673 |
\putpagenumberincontentstrue |
| 6674 |
\titlefirstlinefalse |
| 6675 |
\titlemiddlelinefalse |
| 6676 |
\titlelastlinefalse |
| 6677 |
\singlelinetitletrue} |
| 6678 |
|
| 6679 |
|
| 6680 |
\newcommand{\poemtitlefirstline}[1]{ |
| 6681 |
\firstlinesettings |
| 6682 |
\set@p@emtitle{#1}{\multilinetitlepenalty}{\poemtitlefont}% |
| 6683 |
{\poemtitleindent}{\nobreak\par\nobreak}{\z@}% |
| 6684 |
\c@ntentsinfo{#1}{\contentspoemtitleindent}{\contentspoemtitlefont}% |
| 6685 |
{\contentspoemtitleindentamount}% |
| 6686 |
\t@xtnotesinfo{#1}% |
| 6687 |
\restoresinglelinesettings |
| 6688 |
} |
| 6689 |
% \end{macrocode} |
| 6690 |
|
| 6691 |
% Notice the use of token registers and |\edef| here to concatenate the first and second |
| 6692 |
% lines. |
| 6693 |
% \begin{macrocode} |
| 6694 |
\newcommand{\poemtitlemiddleline}[1]{% |
| 6695 |
\middlelinesettings |
| 6696 |
\set@p@emtitle{#1}{\par\nobreak}{\poemtitlefont}% |
| 6697 |
{\poemtitlesecondlineindent}{\nobreak\par\nobreak}{\z@}% |
| 6698 |
\c@ntentsinfo{#1}{\contentspoemtitlesecondlineindent}{\contentspoemtitlefont}% |
| 6699 |
{\contentspoemtitlesecondlineindentamount}% |
| 6700 |
\t@xtnotesinfo{#1}% |
| 6701 |
\restoresinglelinesettings |
| 6702 |
} |
| 6703 |
\newcommand{\poemtitlelastline}[1]{% |
| 6704 |
\lastlinesettings |
| 6705 |
\set@p@emtitle{#1}{\par\nobreak}{\poemtitlefont}% |
| 6706 |
{\poemtitlesecondlineindent}{\nobreak\par\afterpoemtitleskip\nobreak}{\z@}% |
| 6707 |
\c@ntentsinfo{#1}{\contentspoemtitlesecondlineindent}{\contentspoemtitlefont}% |
| 6708 |
{\contentspoemtitlesecondlineindentamount}% |
| 6709 |
\t@xtnotesinfo{#1}% |
| 6710 |
\restoresinglelinesettings |
| 6711 |
} |
| 6712 |
% \end{macrocode} |
| 6713 |
% \end{macro} |
| 6714 |
% \end{macro} |
| 6715 |
% \end{macro} |
| 6716 |
% Titles for sections of poems, and multi-line titles of sections |
| 6717 |
% of poems |
| 6718 |
% \begin{macro}{\poemsectiontitle} |
| 6719 |
% \begin{macro}{\poemsectiontitlefirstline} |
| 6720 |
% \begin{macro}{\poemsectiontitlemiddleline} |
| 6721 |
% \begin{macro}{\poemsectiontitlelastline} |
| 6722 |
% \begin{macrocode} |
| 6723 |
\newcommand{\poemsectiontitle}[1]{% |
| 6724 |
\set@p@emtitle{#1}{\poemtitlepenalty}{\subsectiontitlefont}% |
| 6725 |
{\poemsectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}% |
| 6726 |
{\titleindentamount}% |
| 6727 |
\c@ntentsinfo{#1}{\contentspoemsectiontitleindent}{\contentspoemtitlefont}% |
| 6728 |
{\contentspoemsectiontitleindentamount}% |
| 6729 |
\t@xtnotesinfo{#1}% |
| 6730 |
} |
| 6731 |
\newcommand{\poemsectiontitlefirstline}[1]{% |
| 6732 |
\firstlinesettings |
| 6733 |
\set@p@emtitle{#1}{\multilinetitlepenalty}{\subsectiontitlefont}% |
| 6734 |
{\poemsectiontitleindent}{\nobreak\par\nobreak}{\poemsectiontitleindentamount}% |
| 6735 |
\c@ntentsinfo{#1}{\contentspoemsectiontitleindent}{\contentspoemtitlefont}% |
| 6736 |
{\contentspoemsectiontitleindentamount}% |
| 6737 |
\t@xtnotesinfo{#1}% |
| 6738 |
\restoresinglelinesettings |
| 6739 |
} |
| 6740 |
\newcommand{\poemsectiontitlemiddleline}[1]{% |
| 6741 |
\middlelinesettings |
| 6742 |
\set@p@emtitle{#1}{\relax}{\subsectiontitlefont}% |
| 6743 |
{\poemsectiontitlesecondlineindent}{\nobreak\par\nobreak}{\poemsectiontitlesecondlineindentamount}% |
| 6744 |
\c@ntentsinfo{#1}{\contentspoemsectiontitlesecondlineindent}{\contentspoemtitlefont}% |
| 6745 |
{\contentspoemsectiontitlesecondlineindentamount}% |
| 6746 |
\t@xtnotesinfo{#1}% |
| 6747 |
\restoresinglelinesettings |
| 6748 |
} |
| 6749 |
\newcommand{\poemsectiontitlelastline}[1]{% |
| 6750 |
\lastlinesettings |
| 6751 |
\set@p@emtitle{#1}{\par\nobreak}{\subsectiontitlefont}% |
| 6752 |
{\poemsectiontitlesecondlineindent}{\nobreak\par\afterpoemtitleskip\nobreak}% |
| 6753 |
{\poemsectiontitlesecondlineindentamount}% |
| 6754 |
\c@ntentsinfo{#1}{\contentspoemsectiontitlesecondlineindent}{\contentspoemtitlefont}% |
| 6755 |
{\contentspoemsectiontitlesecondlineindentamount}% |
| 6756 |
\t@xtnotesinfo{#1}% |
| 6757 |
\restoresinglelinesettings |
| 6758 |
} |
| 6759 |
% \end{macrocode} |
| 6760 |
% \end{macro} |
| 6761 |
% \end{macro} |
| 6762 |
% \end{macro} |
| 6763 |
% \end{macro} |
| 6764 |
% \begin{macro}{\poemsectiontitlenocontents} |
| 6765 |
% \begin{macro}{\poemsectionbaretitle} |
| 6766 |
% \begin{macro}{\poemsubsectiontitle} |
| 6767 |
% \begin{macro}{\poemtitlenotitle} |
| 6768 |
% \begin{macro}{\poemtitlenotitleitalic} |
| 6769 |
% \begin{macrocode} |
| 6770 |
\newcommand{\poemsectiontitlenocontents}[1]{% |
| 6771 |
\sequencesubsectiontitlenocontents{#1}}% |
| 6772 |
\newcommand{\poemfirstsectiontitle}[1]{% |
| 6773 |
\set@p@emtitle{#1}{\par\nobreak}{\subsectiontitlefont}% |
| 6774 |
{\poemsectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}% |
| 6775 |
{\poemsectiontitleindentamount}% |
| 6776 |
\c@ntentsinfo{#1}{\contentspoemsectiontitleindent}{\contentspoemtitlefont}% |
| 6777 |
{\contentspoemsectiontitleindentamount}% |
| 6778 |
\t@xtnotesinfo{#1}% |
| 6779 |
} |
| 6780 |
\newcommand{\poemfirstsectiontitlebaretitle}[1]{% |
| 6781 |
\set@p@emtitle{#1}{\par\nobreak}{\subsectiontitlefont}% |
| 6782 |
{\poemsectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}% |
| 6783 |
{\poemsectiontitleindentamount}} |
| 6784 |
\newcommand{\poemsectiontitlebaretitle}[1]{% |
| 6785 |
\set@p@emtitle{#1}{\poemtitlepenalty}{\subsectiontitlefont}% |
| 6786 |
{\titleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}% |
| 6787 |
{\titleindentamount}% |
| 6788 |
} |
| 6789 |
\newcommand{\poemsubsectiontitle}[1]{% |
| 6790 |
\set@p@emtitle{#1}{\poemtitlepenalty}{\subsectiontitlefont}% |
| 6791 |
{\poemsubsectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}% |
| 6792 |
{\poemsubsectiontitleindentamount}% |
| 6793 |
\c@ntentsinfo{#1}{\contentspoemsubsectiontitleindent}{\contentspoemtitlefont}% |
| 6794 |
{\contentspoemsubsectiontitleindentamount}% |
| 6795 |
\t@xtnotesinfo{#1}% |
| 6796 |
} |
| 6797 |
\newcommand{\poemtitlenotitle}[1]{% |
| 6798 |
\m@kep@emlabel |
| 6799 |
\m@ken@teholder{#1}% |
| 6800 |
\c@ntentsinfo{#1}{\contentspoemtitleindent}{\contentspoemtitlefont}% |
| 6801 |
{\contentsindenttwoamount}% |
| 6802 |
\t@xtnotesinfo{#1}% |
| 6803 |
} |
| 6804 |
\newcommand{\poemtitlenotitleitalic}[2]{% |
| 6805 |
\poemtitlenotitle{1}} |
| 6806 |
% \end{macrocode} |
| 6807 |
% \end{macro} |
| 6808 |
% \end{macro} |
| 6809 |
% \end{macro} |
| 6810 |
% \end{macro} |
| 6811 |
% \end{macro} |
| 6812 |
% |
| 6813 |
% \subsubsection{Poetic Sequences: Setting the Main Title} |
| 6814 |
% \begin{macro}{\sequencetitle} |
| 6815 |
% Variants here for multiple line titles and titles with font |
| 6816 |
% commands. Also some all-purpose kludges to work around other problems. |
| 6817 |
% \begin{macrocode} |
| 6818 |
\newcommand{\sequencetitle}[1]{ |
| 6819 |
\set@p@emtitle{#1}{\sequencetitlepenalty}{\sequencetitlefont} |
| 6820 |
{\sequencetitleindent}{\nobreak\par\nobreak\aftersequencetitleskip\nobreak}{\z@} |
| 6821 |
\putpagenumberincontentsfalse |
| 6822 |
\c@ntentsinfo{#1}{\contentssequencetitleindent}{\contentssequencetitlefont} |
| 6823 |
{\contentssequencetitleindentamount} |
| 6824 |
\putpagenumberincontentstrue |
| 6825 |
\t@xtnotesinfo{#1} |
| 6826 |
} |
| 6827 |
% \end{macrocode} |
| 6828 |
% \end{macro} |
| 6829 |
|
| 6830 |
% \begin{macro}{\sequencetitlefirstline} |
| 6831 |
% \begin{macro}{\sequencetitlemiddleline} |
| 6832 |
% \begin{macro}{\sequencetitlelastline} |
| 6833 |
% To set the title of a poetic sequence if it requires several lines |
| 6834 |
% to do so. |
| 6835 |
% \begin{macrocode} |
| 6836 |
\newcommand{\sequencetitlefirstline}[1]{ |
| 6837 |
\firstlinesettings |
| 6838 |
\set@p@emtitle{#1}{\multilinesequencepenalty}{\sequencetitlefont} |
| 6839 |
{\sequencetitleindent}{\nobreak\par\nobreak}{\z@} |
| 6840 |
\c@ntentsinfo{#1}{\contentssequencetitleindent}{\contentssequencetitlefont} |
| 6841 |
{\contentssequencetitleindentamount} |
| 6842 |
\t@xtnotesinfo{#1} |
| 6843 |
\restoresinglelinesettings |
| 6844 |
} |
| 6845 |
\newcommand{\sequencetitlemiddleline}[1]{ |
| 6846 |
\middlelinesettings |
| 6847 |
\set@p@emtitle{#1}{\par\nobreak}{\sequencetitlefont} |
| 6848 |
{\sequencetitleindent}{\nobreak\par\nobreak}{\z@} |
| 6849 |
\c@ntentsinfo{#1}{\contentssequencetitlesecondlineindent}{\contentssequencetitlefont} |
| 6850 |
{\contentssequencetitlesecondlineindentamount} |
| 6851 |
\t@xtnotesinfo{#1} |
| 6852 |
\restoresinglelinesettings |
| 6853 |
} |
| 6854 |
\newcommand{\sequencetitlelastline}[1]{ |
| 6855 |
\lastlinesettings |
| 6856 |
\set@p@emtitle{#1}{\par\nobreak}{\sequencetitlefont} |
| 6857 |
{\sequencetitleindent}{\nobreak\par\aftersequencetitleskip\nobreak}{\z@} |
| 6858 |
\c@ntentsinfo{#1}{\contentssequencetitlesecondlineindent}{\contentssequencetitlefont} |
| 6859 |
{\contentssequencetitlesecondlineindent} |
| 6860 |
\t@xtnotesinfo{#1} |
| 6861 |
\restoresinglelinesettings |
| 6862 |
} |
| 6863 |
\newcommand{\sequencesubtitle}[1]{ |
| 6864 |
\set@p@emsubtitle{#1}{\par\nobreak}{\sequencetitlefont} |
| 6865 |
{\sequencesubtitleindent}{\nobreak\par\aftersequencetitleskip\nobreak}{\z@} |
| 6866 |
\c@ntentsinfo{#1}{\contentssequencesubtitleindent}{\contentssequencetitlefont} |
| 6867 |
{\contentssequencesubtitleindentamount} |
| 6868 |
%\t@xtnotesinfo{#1} |
| 6869 |
} |
| 6870 |
\newcommand{\sequencesubtitlefirstline}[1]{\firstlinesettings |
| 6871 |
\set@p@emsubtitle{#1}{\par\nobreak}{\sequencetitlefont} |
| 6872 |
{\sequencesubtitleindent}{\nobreak\par\aftersequencetitleskip\nobreak}{\z@} |
| 6873 |
\c@ntentsinfo{#1}{\contentsindenttwo}{\contentssequencetitlefont} |
| 6874 |
{\contentsindentthreeamount} |
| 6875 |
%\t@xtnotesinfo{#1} |
| 6876 |
\restoresinglelinesettings |
| 6877 |
} |
| 6878 |
\newcommand{\sequencesubtitlemiddleline}[1]{\middlelinesettings |
| 6879 |
\set@p@emsubtitle{#1}{\par\nobreak}{\sequencetitlefont} |
| 6880 |
{\sequencesubtitlesecondlineindent}{\nobreak\par\aftersequencetitleskip\nobreak}{\z@} |
| 6881 |
\c@ntentsinfo{#1}{\contentssequencesubtitlesecondlineindent}{\contentssequencetitlefont} |
| 6882 |
{\contentssequencesubtitlesecondlineindentamount} |
| 6883 |
%\t@xtnotesinfo{#1} |
| 6884 |
\restoresinglelinesettings |
| 6885 |
} |
| 6886 |
\newcommand{\sequencesubtitlelastline}[1]{\lastlinesettings |
| 6887 |
\set@p@emsubtitle{#1}{\par\nobreak}{\sequencetitlefont} |
| 6888 |
{\sequencesubtitlesecondlineindent}{\nobreak\par\aftersequencetitleskip\nobreak}{\z@} |
| 6889 |
\c@ntentsinfo{#1}{\contentssequencesubtitlesecondlineindent}{\contentssequencetitlefont} |
| 6890 |
{\contentssequencesubtitlesecondlineindentamount} |
| 6891 |
%\t@xtnotesinfo{#1} |
| 6892 |
\restoresinglelinesettings |
| 6893 |
} |
| 6894 |
% \end{macrocode} |
| 6895 |
% \end{macro} |
| 6896 |
% \end{macro} |
| 6897 |
% \end{macro} |
| 6898 |
% \subsubsection{Sections of poetic sequences} |
| 6899 |
% \begin{macro}{\sequencesectiontitle} |
| 6900 |
% First, the easy case: a simple section of a poetic sequence. |
| 6901 |
% \begin{macrocode} |
| 6902 |
\newcommand{\sequencesectiontitle}[1]{ |
| 6903 |
\set@p@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont} |
| 6904 |
{\sequencesectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak} |
| 6905 |
{\sequencesectiontitleindentamount} |
| 6906 |
\c@ntentsinfo{#1}{\contentssequencesectiontitleindent}{\contentspoemtitlefont} |
| 6907 |
{\contentssequencesectiontitleindentamount} |
| 6908 |
\t@xtnotesinfo{#1} |
| 6909 |
} |
| 6910 |
% \end{macrocode} |
| 6911 |
% \end{macro} |
| 6912 |
|
| 6913 |
% \begin{macro}{\sequencefirstsectiontitle} |
| 6914 |
% The first poem in a sequence is a special case. |
| 6915 |
% \begin{macrocode} |
| 6916 |
\newcommand{\sequencefirstsectiontitle}[1]{ |
| 6917 |
\set@p@emtitle{#1}{\par\nobreak\afterpoemtitleskip}{\poemtitlefont} |
| 6918 |
{\sequencesectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak} |
| 6919 |
{\sequencesectiontitleindentamount} |
| 6920 |
\c@ntentsinfo{#1}{\contentssequencesectiontitleindent}{\contentspoemtitlefont} |
| 6921 |
{\contentssequencesectiontitleindentamount} |
| 6922 |
\t@xtnotesinfo{#1} |
| 6923 |
} |
| 6924 |
% \end{macrocode} |
| 6925 |
% \end{macro} |
| 6926 |
% \begin{macro}{\sequencesectiontitlenonotes} |
| 6927 |
% If you don't have any notes on a sequence section, it seems a shame |
| 6928 |
% to open an entry in the textual notes for that section: |
| 6929 |
% \begin{macrocode} |
| 6930 |
\newcommand{\sequencetitlenonotes}[1]{ |
| 6931 |
\set@p@emtitle{#1}{\par\nobreak}{\sequencetitlefont} |
| 6932 |
{\sequencetitleindent}{\nobreak\par\aftersequencetitleskip\nobreak}{\sequencetitleindentamount} |
| 6933 |
\c@ntentsinfo{#1}{\contentssequencetitleindent}{\contentssequencetitlefont} |
| 6934 |
{\contentssequencetitleindentamount} |
| 6935 |
%\t@xtnotesinfo{#1} |
| 6936 |
} |
| 6937 |
\newcommand{\sequencesectiontitlenonotes}[1]{ |
| 6938 |
\set@p@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont} |
| 6939 |
{\sequencesectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak} |
| 6940 |
{\sequencesectiontitleindentamount} |
| 6941 |
\c@ntentsinfo{#1}{\contentssequencesectiontitleindent}{\contentspoemtitlefont} |
| 6942 |
{\contentssequencesectiontitleindentamount} |
| 6943 |
%\t@xtnotesinfo{#1} |
| 6944 |
} |
| 6945 |
% \end{macrocode} |
| 6946 |
% \end{macro} |
| 6947 |
% For multiple line titles of sequence sections |
| 6948 |
% \begin{macrocode} |
| 6949 |
\newcommand{\sequencesectiontitlefirstline}[1]{ |
| 6950 |
\firstlinesettings |
| 6951 |
\set@p@emtitle{#1}{\multilinetitlepenalty}{\poemtitlefont} |
| 6952 |
{\sequencesectiontitleindent}{\nobreak\par\nobreak}{\sequencesectiontitleindentamount} |
| 6953 |
\c@ntentsinfo{#1}{\contentssequencesectiontitleindent}{\contentspoemtitlefont} |
| 6954 |
{\contentssequencesectiontitleindentamount} |
| 6955 |
\t@xtnotesinfo{#1} |
| 6956 |
\restoresinglelinesettings |
| 6957 |
} |
| 6958 |
\newcommand{\sequencesectiontitlemiddleline}[1]{ |
| 6959 |
\middlelinesettings |
| 6960 |
\set@p@emtitle{#1}{\par\nobreak}{\poemtitlefont} |
| 6961 |
{\sequencesectiontitleindent}{\nobreak\par\nobreak}{\sequencesectiontitleindentamount} |
| 6962 |
\c@ntentsinfo{#1}{\contentssequencesectiontitlesecondlineindent}{\contentspoemtitlefont} |
| 6963 |
{\contentssequencesectiontitlesecondlineindentamount} |
| 6964 |
\t@xtnotesinfo{#1} |
| 6965 |
\restoresinglelinesettings |
| 6966 |
} |
| 6967 |
\newcommand{\sequencesectiontitlelastline}[1]{ |
| 6968 |
\lastlinesettings |
| 6969 |
\set@p@emtitle{#1}{\par\nobreak}{\poemtitlefont} |
| 6970 |
{\sequencesectiontitleindent}{\nobreak\par\afterpoemtitleskip\nobreak}{\sequencesectiontitleindentamount} |
| 6971 |
\c@ntentsinfo{#1}{\contentssequencesectiontitlesecondlineindent}{\contentspoemtitlefont} |
| 6972 |
{\contentssequencesectiontitlesecondlineindentamount} |
| 6973 |
\t@xtnotesinfo{#1} |
| 6974 |
\restoresinglelinesettings |
| 6975 |
} |
| 6976 |
% \end{macrocode} |
| 6977 |
% The following macros are |
| 6978 |
% to kludge around situations where the section title is just a number. This |
| 6979 |
% macro has two arguments. Originally, the first was the title of the section. |
| 6980 |
% The second is the title of the sequence as a whole. I've retained |
| 6981 |
% the second argument for backward compatibility with earlier versions, but |
| 6982 |
% you can set it to anything, since it's discarded now. |
| 6983 |
% \begin{macrocode} |
| 6984 |
\newcommand{\sequencefirstsectiontitlenocontents}[2]{ |
| 6985 |
\set@p@emtitle{#1}{\par\nobreak\afterpoemtitleskip}{\poemtitlefont} |
| 6986 |
{\sequencesectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak} |
| 6987 |
{\sequencesectiontitleindentamount} |
| 6988 |
%\c@ntentsinfo{#1}{\contentsindenttwo}{\contentspoemtitlefont} |
| 6989 |
\t@xtnotesinfo{#1} |
| 6990 |
} |
| 6991 |
\newcommand{\sequencesectiontitlenocontents}[2]{ |
| 6992 |
\set@p@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont} |
| 6993 |
{\sequencesectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak} |
| 6994 |
{\sequencesectiontitleindentamount} |
| 6995 |
%\c@ntentsinfo{#1}{\contentsindenttwo}{\contentspoemtitlefont} |
| 6996 |
\t@xtnotesinfo{#1} |
| 6997 |
} |
| 6998 |
% \end{macrocode} |
| 6999 |
% If the first section of a sequence is a multiple line title, the |
| 7000 |
% following macros can handle the special problems that situation poses. |
| 7001 |
% \begin{macrocode} |
| 7002 |
\newcommand{\sequencefirstsectiontitlefirstline}[1]{ |
| 7003 |
\firstlinesettings |
| 7004 |
\set@p@emtitle{#1}{\par\nobreak\afterpoemtitleskip}{\poemtitlefont} |
| 7005 |
{\sequencesectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak} |
| 7006 |
{\sequencesectiontitleindentamount} |
| 7007 |
\c@ntentsinfo{#1}{\contentssequencesectiontitleindent}{\contentspoemtitlefont} |
| 7008 |
{\contentssequencesectiontitleindentamount} |
| 7009 |
\t@xtnotesinfo{#1} |
| 7010 |
\restoresinglelinesettings |
| 7011 |
} |
| 7012 |
\newcommand{\sequencefirstsectiontitlemiddleline}[1]{ |
| 7013 |
\sequencesectiontitlemiddleline{#1}} |
| 7014 |
|
| 7015 |
\newcommand{\sequencefirstsectiontitlelastline}[1] |
| 7016 |
{\sequencesectiontitlelastline{#1}} |
| 7017 |
|
| 7018 |
\newcommand{\sequencefirstsectiontitlenonotes}[1]{ |
| 7019 |
\set@p@emtitle{#1}{\par\nobreak\afterpoemtitleskip}{\poemtitlefont} |
| 7020 |
{\sequencesectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak} |
| 7021 |
{\sequencesectiontitleindentamount} |
| 7022 |
\c@ntentsinfo{#1}{\contentssequencesectiontitleindent}{\contentspoemtitlefont} |
| 7023 |
{\contentssequencesectiontitleindentamount} |
| 7024 |
%\t@xtnotesinfo{#1} |
| 7025 |
} |
| 7026 |
% \end{macrocode} |
| 7027 |
|
| 7028 |
% \begin{macro}{\sequencesectionsubtitle} |
| 7029 |
% \begin{macro}{\poemsubtitle} |
| 7030 |
% \begin{macrocode} |
| 7031 |
% \newcommand{\sequencesectionsubtitle}[1]{{\subsectiontitlefont \hbox{\titleindent #1}} |
| 7032 |
% \nobreak\par\nobreak\afterpoemtitleskip\nobreak |
| 7033 |
% } |
| 7034 |
\newcommand{\sequencesectionsubtitle}[1]{\set@p@emsubtitle{#1}{\par\nobreak\afterpoemtitleskip} |
| 7035 |
{\subsectiontitlefont}{\sequencesectionsubtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\sequencesectionsubtitleindentamount} |
| 7036 |
} |
| 7037 |
\newcommand{\sequencesectionsubtitlefirstline}[1]{\firstlinesettings |
| 7038 |
\set@p@emsubtitle{#1}{\par\nobreak\afterpoemtitleskip} |
| 7039 |
{\subsectiontitlefont}{\sequencesectionsubtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\sequencesectionsubtitleindentamount} |
| 7040 |
\restoresinglelinesettings |
| 7041 |
} |
| 7042 |
\newcommand{\sequencesectionsubtitlemiddleline}[1]{\middlelinesettings |
| 7043 |
\set@p@emsubtitle{#1}{\par\nobreak\afterpoemtitleskip} |
| 7044 |
{\subsectiontitlefont}{\sequencesectionsubtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\sequencesectionsubtitleindentamount} |
| 7045 |
\restoresinglelinesettings |
| 7046 |
} |
| 7047 |
\newcommand{\sequencesectionsubtitlelastline}[1]{\lastlinesettings |
| 7048 |
\set@p@emsubtitle{#1}{\par\nobreak\afterpoemtitleskip} |
| 7049 |
{\subsectiontitlefont}{\sequencesectionsubtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\sequencesectionsubtitleindentamount} |
| 7050 |
\restoresinglelinesettings |
| 7051 |
} |
| 7052 |
\newcommand{\poemsubtitle}[1]{\set@p@emsubtitle{#1}{\par\nobreak\afterpoemtitleskip} |
| 7053 |
{\subsectiontitlefont}{\poemsubtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\titleindentamount} |
| 7054 |
} |
| 7055 |
% \end{macrocode} |
| 7056 |
% \end{macro} |
| 7057 |
% \end{macro} |
| 7058 |
% Another (former) kludge for special situations: |
| 7059 |
% \begin{macrocode} |
| 7060 |
\newcommand{\sequencesectiontitleitalicnonotes}[2] |
| 7061 |
{\sequencesectiontitlenonotes{#1} |
| 7062 |
} |
| 7063 |
% \end{macrocode} |
| 7064 |
% Italic titles used to require two arguments. These commands |
| 7065 |
% are retained only for backward compatibility. |
| 7066 |
% |
| 7067 |
% \begin{macro}{\sequencesectiontitleitalic} |
| 7068 |
% \begin{macrocode} |
| 7069 |
\newcommand{\sequencesectiontitleitalic}[2]{ |
| 7070 |
\sequencesectiontitle{#1}} |
| 7071 |
\newcommand{\sequencesectiontitlefirstlineitalic}[2] |
| 7072 |
{\sequencesectiontitlefirstline{#1}} |
| 7073 |
\newcommand{\sequencesectiontitlebaretitle}[1]{ |
| 7074 |
\set@p@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont} |
| 7075 |
{\titleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\titleindentamount} |
| 7076 |
} |
| 7077 |
% \end{macrocode} |
| 7078 |
% \end{macro} |
| 7079 |
|
| 7080 |
|
| 7081 |
|
| 7082 |
% \subsubsection{Subsections of sequences} |
| 7083 |
% \begin{macro}{\sequencesubsectiontitle} |
| 7084 |
|
| 7085 |
% Continuing several levels down: macros for setting subsections and |
| 7086 |
% subsubsections of sequences. |
| 7087 |
% \begin{macrocode} |
| 7088 |
\newcommand{\sequencesubsectiontitle}[1]{ |
| 7089 |
\set@p@emtitle{#1}{\poemtitlepenalty}{\subsectiontitlefont} |
| 7090 |
{\sequencesubsectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak} |
| 7091 |
{\sequencesubsectiontitleindentamount} |
| 7092 |
\c@ntentsinfo{#1}{\contentssequencesubsectiontitleindent}{\contentspoemtitlefont} |
| 7093 |
{\contentssequencesubsectiontitleindentamount} |
| 7094 |
\t@xtnotesinfo{#1} |
| 7095 |
} |
| 7096 |
\newcommand{\sequencesubsectiontitlenocontents}[1]{ |
| 7097 |
\set@p@emtitle{#1}{\poemtitlepenalty}{\subsectiontitlefont} |
| 7098 |
{\sequencesubsectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak} |
| 7099 |
{\sequencesubsectiontitleindentamount} |
| 7100 |
%\c@ntentsinfo{#1}{\contentsindentthree}{\contentspoemtitlefont}{\contentsindentfouramount} |
| 7101 |
\t@xtnotesinfo{#1} |
| 7102 |
} |
| 7103 |
\newcommand{\sequencefirstsubsectiontitle}[1] |
| 7104 |
{\set@p@emtitle{#1}{\par\nobreak}{\subsectiontitlefont} |
| 7105 |
{\sequencesubsectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak} |
| 7106 |
{\sequencesubsectiontitleindentamount} |
| 7107 |
\c@ntentsinfo{#1}{\contentssequencesubsectiontitleindent}{\contentspoemtitlefont} |
| 7108 |
{\contentssequencesubsectiontitleindentamount} |
| 7109 |
\t@xtnotesinfo{#1} |
| 7110 |
} |
| 7111 |
\newcommand{\sequencefirstsubsectiontitlenocontents}[1] |
| 7112 |
{\set@p@emtitle{#1}{\par\nobreak}{\subsectiontitlefont} |
| 7113 |
{\sequencesubsectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak} |
| 7114 |
{\sequencesubsectiontitleindentamount} |
| 7115 |
%\c@ntentsinfo{#1}{\contentsindentthree}{\contentspoemtitlefont} |
| 7116 |
%{\contentsindentfouramount} |
| 7117 |
\t@xtnotesinfo{#1} |
| 7118 |
} |
| 7119 |
\newcommand{\sequencesubsectiontitlefirstline}[1]{ |
| 7120 |
\firstlinesettings |
| 7121 |
\set@p@emtitle{#1}{\multilinetitlepenalty}{\subsectiontitlefont} |
| 7122 |
{\sequencesubsectiontitleindent}{\nobreak\par\nobreak}{\sequencesubsectiontitleindentamount} |
| 7123 |
\c@ntentsinfo{#1}{\contentssequencesubsectiontitleindent}{\contentspoemtitlefont} |
| 7124 |
{\contentssequencesubsectiontitleindentamount} |
| 7125 |
\t@xtnotesinfo{#1} |
| 7126 |
\restoresinglelinesettings |
| 7127 |
} |
| 7128 |
\newcommand{\sequencesubsectiontitlemiddleline}[1]{ |
| 7129 |
\middlelinesettings |
| 7130 |
\set@p@emtitle{#1}{\nobreak}{\subsectiontitlefont} |
| 7131 |
{\sequencesubsectiontitlesecondlineindent}{\nobreak\par\nobreak}{\sequencesubsectiontitlesecondlineindentamount} |
| 7132 |
\c@ntentsinfo{#1}{\contentssequencesubsectiontitlesecondlineindent}{\contentspoemtitlefont} |
| 7133 |
{\contentssequencesubsectiontitlesecondlineindentamount} |
| 7134 |
\t@xtnotesinfo{#1} |
| 7135 |
\restoresinglelinesettings |
| 7136 |
} |
| 7137 |
\newcommand{\sequencesubsectiontitlelastline}[1]{ |
| 7138 |
\lastlinesettings |
| 7139 |
\set@p@emtitle{#1}{\nobreak}{\subsectiontitlefont} |
| 7140 |
{\sequencesubsectiontitleindent}{\nobreak\par\afterpoemtitleskip\nobreak} |
| 7141 |
{\sequencesubsectiontitleindentamount} |
| 7142 |
\c@ntentsinfo{#1}{\contentssequencesubsectiontitlesecondlineindent}{\contentspoemtitlefont} |
| 7143 |
{\contentssequencesubsectiontitlesecondlineindentamount} |
| 7144 |
\t@xtnotesinfo{#1} |
| 7145 |
\restoresinglelinesettings |
| 7146 |
} |
| 7147 |
\newcommand{\sequencesubsubsectiontitle}[1]{ |
| 7148 |
\set@p@emtitle{#1}{\poemtitlepenalty}{\subsectiontitlefont} |
| 7149 |
{\sequencesubsubsectiontitleindent} |
| 7150 |
{\nobreak\par\nobreak\afterpoemtitleskip\nobreak} |
| 7151 |
{\sequencesubsubsectiontitleindentamount} |
| 7152 |
%\c@ntentsinfo{#1}{\contentssequencesubsubsectiontitleindent}{\contentspoemtitlefont} |
| 7153 |
%{\contentssequencesubsectiontitleindentmount} % 313 |
| 7154 |
\t@xtnotesinfo{#1} |
| 7155 |
} |
| 7156 |
\newcommand{\sequencesubsubsectiontitlenocontents}[1]{ |
| 7157 |
\set@p@emtitle{#1}{\poemtitlepenalty}{\subsectiontitlefont} |
| 7158 |
{\sequencesubsubsectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak} |
| 7159 |
{\sequencesubsubsectiontitleindentamount} |
| 7160 |
%\c@ntentsinfo{#1}{\contentsindentfour}{\contentspoemtitlefont} |
| 7161 |
%{\contentsindentfiveamount} |
| 7162 |
\t@xtnotesinfo{#1} |
| 7163 |
} |
| 7164 |
\newcommand{\sequencefirstsubsubsectiontitlenocontents}[1]{ |
| 7165 |
\set@p@emtitle{#1}{\nobreak\par\nobreak}{\subsectiontitlefont} |
| 7166 |
{\sequencesubsubsectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak} |
| 7167 |
{\sequencesubsubsectiontitleindentamount} |
| 7168 |
%\c@ntentsinfo{#1}{\contentsindentfour}{\contentspoemtitlefont}{\contentsindentfiveamount} |
| 7169 |
\t@xtnotesinfo{#1} |
| 7170 |
} |
| 7171 |
|
| 7172 |
|
| 7173 |
\newcommand{\sequencefirstsubsectiontitlefirstline}[1]{ |
| 7174 |
\firstlinesettings |
| 7175 |
\set@p@emtitle{#1}{\par\nobreak}{\subsectiontitlefont} |
| 7176 |
{\sequencesubsectiontitleindent}{\nobreak\par\nobreak}{\sequencesubsectiontitleindentamount} |
| 7177 |
\c@ntentsinfo{#1}{\contentssequencesubsectiontitleindent}{\contentspoemtitlefont} |
| 7178 |
{\contentssequencesubsectiontitleindent} |
| 7179 |
\t@xtnotesinfo{#1} |
| 7180 |
\restoresinglelinesettings |
| 7181 |
} |
| 7182 |
\newcommand{\sequencefirstsubsectiontitlemiddleline}[1]{ |
| 7183 |
\sequencesubsectiontitlemiddleline{#1}} |
| 7184 |
\newcommand{\sequencefirstsubsectiontitlelastline}[1]{ |
| 7185 |
\sequencesubsectiontitlelastline{#1}} |
| 7186 |
% \end{macrocode} |
| 7187 |
% \end{macro} |
| 7188 |
|
| 7189 |
% Interjections in sequences, as in Robert Penn Warren's \emph{Or Else}. |
| 7190 |
% \begin{macrocode} |
| 7191 |
\newcommand{\interjectiontitlefirstline}[1]{ |
| 7192 |
\sequencefirstsubsectiontitlefirstline{#1}} |
| 7193 |
\newcommand{\interjectiontitlelastline}[1]{ |
| 7194 |
\sequencefirstsubsectiontitlelastline{#1} |
| 7195 |
} |
| 7196 |
\newcommand{\interjectiontitlemiddleline}[1]{ |
| 7197 |
\sequencefirstsubsectionmiddleline{#1} |
| 7198 |
} |
| 7199 |
% \subsubsection{Titles and Notes with marginal marks} |
| 7200 |
% \end{macrocode} |
| 7201 |
% \begin{macro}{\setmargpoemtitle} |
| 7202 |
% Titles with a marginal reference to the notes giving the page in |
| 7203 |
% the notes where a comment on the poem appears, as in Altenberg's |
| 7204 |
% Heredia edition.\label{JHpoemtitle} |\setmargpoemtitle| takes as |
| 7205 |
% its second argument anything you want to add to the line while the |
| 7206 |
% title is being processed. |\JHpoemtitle| is just |
| 7207 |
% |\setmargpoemtitle| with the second argument passed to |\JHlabel|, |
| 7208 |
% which actually makes the marginal mark. |
| 7209 |
% \begin{macrocode} |
| 7210 |
\newlength{\JHtextwidth} |
| 7211 |
\setlength{\JHtextwidth}{\textwidth} |
| 7212 |
\newlength{\JHmarginparsep} |
| 7213 |
\setlength{\JHmarginparsep}{0pt} |
| 7214 |
\newlength{\JHmarginparvshift} |
| 7215 |
\setlength{\JHmarginparvshift}{0pt} |
| 7216 |
\newlength{\JHmarginparwidth} |
| 7217 |
\setlength{\JHmarginparwidth}{\marginparwidth} |
| 7218 |
\newlength{\JHmarginparsepmin} |
| 7219 |
\setlength{\JHmarginparsepmin}{\marginparsepmin} |
| 7220 |
\newlength{\JHtitlemarginparsep}% |
| 7221 |
\setlength{\JHtitlemarginparsep}{\JHmarginparsep}% |
| 7222 |
\newif{\ifJHmarkstoleft} |
| 7223 |
\JHmarkstolefttrue |
| 7224 |
\newif{\ifJHmarkstoright} |
| 7225 |
\JHmarkstorightfalse |
| 7226 |
\newif{\ifJHmarkstoouter} |
| 7227 |
\JHmarkstoouterfalse |
| 7228 |
\newif{\ifJHmarkstogutter} |
| 7229 |
\JHmarkstogutterfalse |
| 7230 |
\newif{\ifJHmarginparswitch} |
| 7231 |
\JHmarginparswitchfalse |
| 7232 |
\newif{\ifJHreversemarginpar} |
| 7233 |
\JHreversemarginparfalse |
| 7234 |
\newcommand{\JHmarksleft}{% |
| 7235 |
\JHmarkstolefttrue% |
| 7236 |
\JHmarkstorightfalse% |
| 7237 |
\JHmarkstoouterfalse% |
| 7238 |
\JHmarkstogutterfalse% |
| 7239 |
\JHmarginparswitchfalse% |
| 7240 |
\JHreversemarginparfalse% |
| 7241 |
\reversemarginpar |
| 7242 |
} |
| 7243 |
\newcommand{\JHmarksright}{% |
| 7244 |
\JHmarkstoleftfalse% |
| 7245 |
\JHmarkstorighttrue% |
| 7246 |
\JHmarkstoouterfalse% |
| 7247 |
\JHmarkstogutterfalse% |
| 7248 |
\JHmarginparswitchfalse% |
| 7249 |
\JHreversemarginparfalse% |
| 7250 |
\normalmarginpar |
| 7251 |
} |
| 7252 |
% JHmarksright is the default |
| 7253 |
\JHmarksright |
| 7254 |
\newcommand{\JHmarksouter}{% |
| 7255 |
\JHmarkstoleftfalse% |
| 7256 |
\JHmarkstorightfalse% |
| 7257 |
\JHmarkstooutertrue% |
| 7258 |
\JHmarkstogutterfalse% |
| 7259 |
\JHmarginparswitchtrue% |
| 7260 |
\JHreversemarginparfalse% |
| 7261 |
\@mparswitchtrue |
| 7262 |
} |
| 7263 |
\newcommand{\JHmarksgutter}{% |
| 7264 |
\JHmarkstoleftfalse% |
| 7265 |
\JHmarkstorightfalse% |
| 7266 |
\JHmarkstoouterfalse% |
| 7267 |
\JHmarkstoguttertrue% |
| 7268 |
\JHmarginparswitchtrue% |
| 7269 |
\JHreversemarginpartrue% |
| 7270 |
\@mparswitchtrue |
| 7271 |
\reversemarginpar |
| 7272 |
} |
| 7273 |
% jhrightmarginpar command for notes % right side |
| 7274 |
\newcommand{\JHrightmarginpar}[1]{% |
| 7275 |
\pmclbsphack\strut\vadjust{% |
| 7276 |
\rlap{\kern-\parindent% |
| 7277 |
\kern\JHtextwidth\kern\JHmarginparsep% at right |
| 7278 |
\setbox0=\vtop to 0pt{% added |
| 7279 |
\begin{minipage}[t]{\JHmarginparwidth}% added |
| 7280 |
#1% |
| 7281 |
\end{minipage}% |
| 7282 |
\vss}% |
| 7283 |
\vtop to 0pt{\kern\JHmarginparvshift% default should be 0pt |
| 7284 |
\kern-\dp\strutbox \kern-\ht0 \box0 \vss}}}\pmclesphack}% |
| 7285 |
% jhleftmarginpar command for notes % left side |
| 7286 |
\newcommand{\JHleftmarginpar}[1]{% |
| 7287 |
\pmclbsphack\strut\vadjust{% changed |
| 7288 |
\rlap{\kern-\parindent% |
| 7289 |
\kern -\JHmarginparsep \kern -\JHmarginparwidth% at left |
| 7290 |
\setbox0=\vtop to 0pt{ |
| 7291 |
\begin{minipage}[t]{\JHmarginparwidth}% added |
| 7292 |
#1% |
| 7293 |
\end{minipage}% |
| 7294 |
\vss}% changed |
| 7295 |
\vtop to 0pt{\kern\JHmarginparvshift % default should be 0pt |
| 7296 |
\kern-\dp\strutbox \kern-\ht0 \box0 \vss}}}\pmclesphack}% changed |
| 7297 |
% |
| 7298 |
%\newcommand{\JHoutermarginpar}{% |
| 7299 |
%%\marginpar{\scriptsize {\the\margrefmarker~p.~\pageref{margref\themargrefnumber}}} |
| 7300 |
%\checkoddpage% |
| 7301 |
%\ifoddpage% |
| 7302 |
%\JHrightmarginpar{\scriptsize {\the\margrefmarker~p.~\pageref{margref\themargrefnumber}}}% |
| 7303 |
%\else% below is for even pages |
| 7304 |
%\JHleftmarginpar{\scriptsize {\the\margrefmarker~p.~\pageref{margref\themargrefnumber}}}% |
| 7305 |
%\fi% |
| 7306 |
%} |
| 7307 |
\newcommand{\JHoutermarginpar}{% |
| 7308 |
%\marginpar{\scriptsize {\the\margrefmarker~p.~\pageref{margref\themargrefnumber}}} |
| 7309 |
\strictpagechecktrue% |
| 7310 |
\checkoddpage% |
| 7311 |
\ifoddpage% |
| 7312 |
\JHswitchmarginpar{\scriptsize {\the\margrefmarker~p.~\pageref{margref\themargrefnumber}}}% |
| 7313 |
\else% below is for even pages |
| 7314 |
\JHswitchmarginpar{\scriptsize {\the\margrefmarker~p.~\pageref{margref\themargrefnumber}}}% |
| 7315 |
\fi% |
| 7316 |
} |
| 7317 |
% |
| 7318 |
%\newcommand{\JHguttermarginpar}{% |
| 7319 |
%%\marginpar{\scriptsize {\the\margrefmarker~p.~\pageref{margref\themargrefnumber}}} |
| 7320 |
%\checkoddpage% |
| 7321 |
%\ifoddpage% |
| 7322 |
% \JHleftmarginpar{\scriptsize {\the\margrefmarker~p.~\pageref{margref\themargrefnumber}}}% |
| 7323 |
%\else% below is for even pages |
| 7324 |
% \JHrightmarginpar{\scriptsize {\the\margrefmarker~p.~\pageref{margref\themargrefnumber}}}% |
| 7325 |
%\fi% |
| 7326 |
%} |
| 7327 |
% |
| 7328 |
\newcommand{\JHguttermarginpar}{% |
| 7329 |
\strictpagechecktrue |
| 7330 |
\checkoddpage% |
| 7331 |
\ifoddpage% |
| 7332 |
\JHswitchmarginpar{\scriptsize {\the\margrefmarker~p.~\pageref{margref\themargrefnumber}}}% |
| 7333 |
\else% below is for even pages |
| 7334 |
\JHswitchmarginpar{\scriptsize {\the\margrefmarker~p.~\pageref{margref\themargrefnumber}}}% |
| 7335 |
\fi% |
| 7336 |
} |
| 7337 |
% |
| 7338 |
% jhswitchmarginpar command for notes in gutter and outer |
| 7339 |
% |
| 7340 |
\newcommand{\JHswitchmarginpar}{\@dblarg{\@JHswitchmarginpar}} |
| 7341 |
%\long\def\@pmclsidepar[#1]#2{\@bsphack\leavevmode\vadjust{% |
| 7342 |
\long\def\@JHswitchmarginpar[#1]#2{\@bsphack\strut\vadjust{% added |
| 7343 |
\checkoddpage |
| 7344 |
\ifJHmarginparswitch |
| 7345 |
\ifJHreversemarginpar |
| 7346 |
\ifoddpage |
| 7347 |
\oddpagefalse |
| 7348 |
\else |
| 7349 |
\oddpagetrue |
| 7350 |
\fi |
| 7351 |
\fi |
| 7352 |
\else |
| 7353 |
\oddpagetrue |
| 7354 |
\ifJHreversemarginpar |
| 7355 |
\oddpagefalse |
| 7356 |
\fi |
| 7357 |
\fi |
| 7358 |
\rlap{\kern-\parindent |
| 7359 |
\if@twocolumn |
| 7360 |
\if@firstcolumn % put at left |
| 7361 |
\kern -\JHmarginparsep \kern -\JHmarginparwidth % at left |
| 7362 |
\else % put at right |
| 7363 |
\kern \columnwidth \kern \JHmarginparsep % at right |
| 7364 |
\fi |
| 7365 |
\else |
| 7366 |
\ifoddpage % put at right |
| 7367 |
\kern \textwidth \kern \JHmarginparsep % at right |
| 7368 |
\else % put at left |
| 7369 |
\kern -\JHmarginparsep \kern -\JHmarginparwidth % at left |
| 7370 |
\fi |
| 7371 |
\fi |
| 7372 |
% \vbox to 0pt{% |
| 7373 |
% \kern \JHmarginparvshift% % vertical shift to align top text lines |
| 7374 |
% \begin{minipage}{\JHmarginparwidth}% |
| 7375 |
\setbox0=\vtop to 0pt{% added |
| 7376 |
\begin{minipage}[t]{\JHmarginparwidth}% added |
| 7377 |
\ifoddpage #2\else #1\fi% |
| 7378 |
\end{minipage}% |
| 7379 |
% \vss}}}\@esphack} |
| 7380 |
\vss}% added |
| 7381 |
\vtop to 0pt{\kern\JHmarginparvshift % default should be 0pt |
| 7382 |
\kern-\dp\strutbox \kern-\ht0 \box0 \vss}}}\@esphack}% added |
| 7383 |
% |
| 7384 |
% commands for placing the marginal marks for titles |
| 7385 |
% right side |
| 7386 |
\newcommand{\JHrighttitlemarginpar}[1]{% |
| 7387 |
\pmclbsphack\strut\vadjust{% |
| 7388 |
\rlap{\kern-\parindent% |
| 7389 |
\kern\textwidth\kern\JHtitlemarginparsep% at right |
| 7390 |
\ifcentertitleson% |
| 7391 |
\kern-.5\JHtextwidth\kern\marginparsepmin% |
| 7392 |
\fi% |
| 7393 |
\setbox0=\vtop to 0pt{% added |
| 7394 |
\begin{minipage}[t]{\JHmarginparwidth}% added |
| 7395 |
#1% |
| 7396 |
\end{minipage}% |
| 7397 |
\vss}% |
| 7398 |
\vtop to 0pt{\kern\JHmarginparvshift% default should be 0pt |
| 7399 |
\kern-\dp\strutbox \kern-\ht0 \box0 \vss}}}\pmclesphack}% |
| 7400 |
% |
| 7401 |
% commands for placing the marginal marks for titles |
| 7402 |
% left side |
| 7403 |
\newcommand{\JHlefttitlemarginpar}[1]{% |
| 7404 |
\pmclbsphack\strut\vadjust{% changed |
| 7405 |
\rlap{\kern-\parindent% |
| 7406 |
\kern -\JHtitlemarginparsep \kern -\JHmarginparwidth% at left |
| 7407 |
\ifcentertitleson% |
| 7408 |
\kern-.5\JHtextwidth\kern\marginparsepmin% |
| 7409 |
\fi% |
| 7410 |
\setbox0=\vtop to 0pt{% |
| 7411 |
\begin{minipage}[t]{\JHmarginparwidth}% added |
| 7412 |
#1% |
| 7413 |
\end{minipage}% |
| 7414 |
\vss}% changed |
| 7415 |
\vtop to 0pt{\kern\JHmarginparvshift % default should be 0pt |
| 7416 |
\kern-\dp\strutbox \kern-\ht0 \box0 \vss}}}\pmclesphack}% changed |
| 7417 |
% |
| 7418 |
% command for JHtitlemarks in title in outer margin or in gutter |
| 7419 |
\newcommand{\JHswitchtitlemarginpar}{\@dblarg{\@JHswitchtitlemarginpar}} |
| 7420 |
%\long\def\@pmclsidepar[#1]#2{\@bsphack\leavevmode\vadjust{% |
| 7421 |
\long\def\@JHswitchtitlemarginpar[#1]#2{\@bsphack\strut\vadjust{% added |
| 7422 |
\checkoddpage% |
| 7423 |
\ifJHmarginparswitch% |
| 7424 |
\ifJHreversemarginpar% |
| 7425 |
\ifoddpage% |
| 7426 |
\oddpagefalse% |
| 7427 |
\else% |
| 7428 |
\oddpagetrue% |
| 7429 |
\fi% |
| 7430 |
\fi% |
| 7431 |
\else% |
| 7432 |
\oddpagetrue% |
| 7433 |
\ifJHreversemarginpar% |
| 7434 |
\oddpagefalse% |
| 7435 |
\fi% |
| 7436 |
\fi% |
| 7437 |
\rlap{\kern-\parindent% |
| 7438 |
\if@twocolumn% |
| 7439 |
\if@firstcolumn % put at left |
| 7440 |
\kern -\JHtitlemarginparsep \kern -\marginparwidth % at left |
| 7441 |
\kern-.5\JHtextwidth\kern\marginparsepmin% |
| 7442 |
\else % put at right |
| 7443 |
\kern \columnwidth \kern \JHtitlemarginparsep % at right |
| 7444 |
\fi% |
| 7445 |
\else% |
| 7446 |
\ifoddpage % put at right |
| 7447 |
\kern \textwidth \kern \JHtitlemarginparsep % at right |
| 7448 |
\ifcentertitleson% |
| 7449 |
\kern-.5\JHtextwidth\kern\marginparsepmin% |
| 7450 |
\fi% |
| 7451 |
\else % put at left |
| 7452 |
\kern -\JHtitlemarginparsep \kern -\marginparwidth % at left |
| 7453 |
\ifcentertitleson% |
| 7454 |
\kern-.5\JHtextwidth\kern\marginparsepmin% |
| 7455 |
\fi% |
| 7456 |
\fi% |
| 7457 |
\fi% |
| 7458 |
% \vbox to 0pt{% |
| 7459 |
% \kern \pmclsideparvshift% % vertical shift to align top text lines |
| 7460 |
% \begin{minipage}{\marginparwidth}% |
| 7461 |
\setbox0=\vtop to 0pt{% added |
| 7462 |
\begin{minipage}[t]{\marginparwidth}% added |
| 7463 |
\ifoddpage #2\else #1\fi% |
| 7464 |
\end{minipage}% |
| 7465 |
% \vss}}}\@esphack} |
| 7466 |
\vss}% added |
| 7467 |
\vtop to 0pt{\kern\JHmarginparvshift % default should be 0pt |
| 7468 |
\kern-\dp\strutbox \kern-\ht0 \box0 \vss}}}\@esphack}% added |
| 7469 |
% |
| 7470 |
\newcommand{\set@margp@emtitle}[7]{\setlength{\titleentryoverrun}{#6}% |
| 7471 |
{#2}% |
| 7472 |
{#3 \begin{titleentryenvironment}% |
| 7473 |
{\ifcentertitleson\begin{center}#4 #1 #7\end{center}\else #4 #1 |
| 7474 |
#7\fi}\end{titleentryenvironment}}% |
| 7475 |
{#5}% |
| 7476 |
\m@kep@emlabel% |
| 7477 |
\m@ken@teholder{#1}% |
| 7478 |
\setlength{\titleentryoverrun}{\z@}} |
| 7479 |
%% subtitle version |
| 7480 |
\newcommand{\set@margp@emsubtitle}[7]{\setlength{\titleentryoverrun}{#6}% |
| 7481 |
{#2}% |
| 7482 |
{#3 \begin{titleentryenvironment}% |
| 7483 |
{\ifcentertitleson\begin{center}#4 #1 #7\end{center}\else #4 #1 |
| 7484 |
#7\fi}\end{titleentryenvironment}}% |
| 7485 |
{#5}% |
| 7486 |
%\m@kep@emlabel% |
| 7487 |
%\m@ken@teholder{#1}% |
| 7488 |
\setlength{\titleentryoverrun}{\z@}} |
| 7489 |
% user version |
| 7490 |
\newcommand{\setmargpoemtitle}[2]{% |
| 7491 |
\set@margp@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}% |
| 7492 |
{\sequencetitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\z@}{#2}% |
| 7493 |
\c@ntentsinfo{#1}{\contentsindentone}{\contentspoemtitlefont}% |
| 7494 |
{\contentsindenttwoamount}% |
| 7495 |
\t@xtnotesinfo{#1}% |
| 7496 |
\sources{\label{#2}}% |
| 7497 |
} |
| 7498 |
%\newcommand{\set@margp@emtitle}[7]{\setlength{\titleentryoverrun}{#6}% |
| 7499 |
%{#2}% |
| 7500 |
%{#3 \begin{titleentryenvironment}% |
| 7501 |
%{#4 #1 #7}\end{titleentryenvironment}}% |
| 7502 |
%{#5}% |
| 7503 |
%\m@kep@emlabel% |
| 7504 |
%\m@ken@teholder{#1}% |
| 7505 |
%\setlength{\titleentryoverrun}{\z@}} |
| 7506 |
% \end{macrocode} |
| 7507 |
% \end{macro} |
| 7508 |
% \begin{macro}{\JHpoemtitle} Macros to set marginal line |
| 7509 |
% references. |
| 7510 |
% \begin{macrocode} |
| 7511 |
% \newcommand{\JHpoemtitle}[2]{% |
| 7512 |
% \setmargpoemtitle{#1}{\JHlabel{#2}}% |
| 7513 |
% } |
| 7514 |
\@mparswitchfalse % so the title marker won't switch sides on alternate pages |
| 7515 |
\newcommand{\JHpoemtitle}[2]{% |
| 7516 |
\set@margp@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}% |
| 7517 |
{\sequencetitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\z@}% |
| 7518 |
{\JHlabel{#2}}% |
| 7519 |
\c@ntentsinfo{#1}{\contentssequencetitleindent}{\contentspoemtitlefont}% |
| 7520 |
{\contentssequencetitleindentamount}% |
| 7521 |
\t@xtnotesinfo{#1}% |
| 7522 |
\sources{\label{#2}}% |
| 7523 |
} |
| 7524 |
\newcommand{\JHprosesectiontitle}[2]{% |
| 7525 |
\set@margp@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}% |
| 7526 |
{\sequencetitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\z@}% |
| 7527 |
{\JHlabel{#2}}% |
| 7528 |
\c@ntentsinfo{#1}{\contentssequencetitleindent}{\contentspoemtitlefont}% |
| 7529 |
{\contentssequencetitleindentamount}% |
| 7530 |
\t@xtnotesinfo{#1}% |
| 7531 |
\sources{\label{#2}}% |
| 7532 |
} |
| 7533 |
%\newcommand{\JHlabel}[1]{% |
| 7534 |
%\marginpar{{\scriptsize{\the\titlemargrefmarker~p.~\pageref{#1}}}}} |
| 7535 |
\newcommand{\JHlabel}[1]{% |
| 7536 |
\ifJHmarkstoright\JHrighttitlemarginpar |
| 7537 |
{{\scriptsize{\the\margrefmarker~p.~\pageref{#1}}}} |
| 7538 |
\fi |
| 7539 |
\ifJHmarkstoleft |
| 7540 |
\JHlefttitlemarginpar{{\scriptsize{\the\margrefmarker~p.~\pageref{#1}}}} |
| 7541 |
\fi |
| 7542 |
\ifJHmarkstoouter |
| 7543 |
\JHswitchtitlemarginpar{{\scriptsize{\the\margrefmarker~p.~\pageref{#1}}}} |
| 7544 |
\fi |
| 7545 |
\ifJHmarkstogutter |
| 7546 |
\JHswitchtitlemarginpar{{\scriptsize{\the\margrefmarker~p.~\pageref{#1}}}} |
| 7547 |
\fi |
| 7548 |
} |
| 7549 |
|
| 7550 |
% \end{macrocode} |
| 7551 |
% \end{macro} |
| 7552 |
% \begin{macro}{\JHsequencetitle} Macros to set marginal page |
| 7553 |
% references for sequences, sequence sections, poem sections, poem |
| 7554 |
% subtitles, dedications, and epigraphs. |
| 7555 |
% \begin{macrocode} |
| 7556 |
\newcommand{\JHsequencetitle}[2]{% |
| 7557 |
\set@margp@emtitle{#1}{\sequencetitlepenalty}{\sequencetitlefont}% |
| 7558 |
{\sequencetitleindent}{\nobreak\par\nobreak\aftersequencetitleskip\nobreak}{\z@}% |
| 7559 |
{\JHlabel{#2}}% |
| 7560 |
\putpagenumberincontentsfalse% |
| 7561 |
\c@ntentsinfo{#1}{\contentsindentone}{\contentssequencetitlefont}% |
| 7562 |
{\contentsindenttwoamount}% |
| 7563 |
\putpagenumberincontentstrue% |
| 7564 |
\t@xtnotesinfo{#1}% |
| 7565 |
\sources{\label{#2}}% |
| 7566 |
} |
| 7567 |
\newcommand{\JHsequencesectiontitle}[2]{% |
| 7568 |
\set@margp@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}% |
| 7569 |
{\sequencesectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}% |
| 7570 |
{\sequencesectiontitleindentamount}{\JHlabel{#2}}% |
| 7571 |
\c@ntentsinfo{#1}{\contentssequencesectiontitleindent}{\contentspoemtitlefont}% |
| 7572 |
{\contentsindentthreeamount}% |
| 7573 |
\t@xtnotesinfo{#1}% |
| 7574 |
\sources{\label{#2}}% |
| 7575 |
} |
| 7576 |
\newcommand{\JHsequencefirstsectiontitle}[2]{% |
| 7577 |
\set@margp@emtitle{#1}{\par\nobreak\afterpoemtitleskip}{\poemtitlefont}% |
| 7578 |
{\sequencesectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}% |
| 7579 |
{\titleindentamount}{\JHlabel{#2}}% |
| 7580 |
\c@ntentsinfo{#1}{\contentssequencesectiontitleindent}{\contentspoemtitlefont}% |
| 7581 |
{\contentssequencesectiontitleindentamount}% |
| 7582 |
\t@xtnotesinfo{#1}% |
| 7583 |
\sources{\label{#2}}% |
| 7584 |
} |
| 7585 |
\newcommand{\JHpoemsectiontitle}[2]{% |
| 7586 |
\set@margp@emtitle{#1}{\poemtitlepenalty}{\subsectiontitlefont}% |
| 7587 |
{\poemsectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}% |
| 7588 |
{\poemsectiontitleindentamount}{\JHlabel{#2}}% |
| 7589 |
\c@ntentsinfo{#1}{\contentspoemsectiontitleindent}{\contentspoemtitlefont}% |
| 7590 |
{\contentspoemsectiontitleindentamount}% |
| 7591 |
\t@xtnotesinfo{#1}% |
| 7592 |
\sources{\label{#2}}% |
| 7593 |
} |
| 7594 |
\newcommand{\JHpoemfirstsectiontitle}[2]{% |
| 7595 |
\set@margp@emtitle{#1}{\par\nobreak}{\subsectiontitlefont}% |
| 7596 |
{\poemsectiontitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}% |
| 7597 |
{\\poemsectiontitleindentamount}{\JHlabel{#2}}% |
| 7598 |
\c@ntentsinfo{#1}{\contentsi\poemsectiontitleindent}{\contentspoemtitlefont}% |
| 7599 |
{\contents\poemsectiontitleindentamount}% |
| 7600 |
\t@xtnotesinfo{#1}% |
| 7601 |
\sources{\label{#2}}% |
| 7602 |
} |
| 7603 |
\newcommand{\JHsequencesectionsubtitle}[2]{% |
| 7604 |
\set@margp@emsubtitle{#1}{\par\nobreak}{\subsectiontitlefont}% |
| 7605 |
{\titleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}% |
| 7606 |
{\titleindentamount}{\JHlabel{#2}}% |
| 7607 |
\sources{\label{#2}}% |
| 7608 |
} |
| 7609 |
\newcommand{\JHpoemsubtitle}[2]{\JHsequencesectionsubtitle{#1}{#2} |
| 7610 |
} |
| 7611 |
\newcommand{\JHdedication}[2]{\nopagebreak\afterpoemtitleskip\testforcenterepigraph% |
| 7612 |
\begin{epigraphquote}% |
| 7613 |
\emph{#1}\JHlabel{#2}\end{epigraphquote}% |
| 7614 |
\sources{\label{#2}}\afterpoemtitleskip\nopagebreak} |
| 7615 |
\newcommand{\JHepigraph}[2]{\nopagebreak\afterpoemtitleskip\testforcenterepigraph% |
| 7616 |
\begin{epigraphquote}% |
| 7617 |
\emph{#1}\JHlabel{#2}\end{epigraphquote}% |
| 7618 |
\sources{\label{#2}}\afterpoemtitleskip\nopagebreak} |
| 7619 |
% \end{macrocode} |
| 7620 |
% \end{macro} |
| 7621 |
% \begin{macro}{\backmattersectiontitle} Macros to set the titles of back matter sections |
| 7622 |
% such as textual notes. |
| 7623 |
% |
| 7624 |
% \begin{macrocode} |
| 7625 |
\newcommand{\backmattersectiontitle}[1]{% |
| 7626 |
\set@p@emtitle{#1}{\poemtitlepenalty}{\volumetitlefont}% |
| 7627 |
{\relax}{\backmattersink}{\z@}% |
| 7628 |
\c@ntentsinfo{#1}{contentsindentone}{\contentspoemtitlefont}% |
| 7629 |
{\contentsindenttwoamount}% |
| 7630 |
\t@xtnotesinfo{#1} |
| 7631 |
} |
| 7632 |
% \end{macrocode} |
| 7633 |
% \end{macro} |
| 7634 |
% \begin{macro}{\margreftextnote} Macros to set marginal page |
| 7635 |
% references showing where in the apparatus a comment upon the |
| 7636 |
% marked line is to be found. |\margrefspecial{}| is for occasions |
| 7637 |
% when you might need to set the label by hand. For instance, suppose |
| 7638 |
% you have several textnotes on a line, and the note you wish to draw |
| 7639 |
% attention to is on a different page from the other notes. |
| 7640 |
% |\margreftextnote| under those circumstances will point only to the |
| 7641 |
% first note. Use |\margrefspecial| to point to the other note, |
| 7642 |
% giving |\margrefspecial| a unique argument, and opening that note |
| 7643 |
% with a \label{} command using the same argument. |
| 7644 |
% |
| 7645 |
% \begin{macrocode} |
| 7646 |
\newcounter{margrefnumber} |
| 7647 |
\setcounter{margrefnumber}{1} |
| 7648 |
\newtoks{\margrefmarker} |
| 7649 |
\margrefmarker={\dag} |
| 7650 |
\newcommand{\setmargrefmarker}[1]{\margrefmarker={#1}} |
| 7651 |
\providecommand{\settitlemargrefmarker}[1]{\titlemargrefmarker={#1}} |
| 7652 |
\newtoks{\titlemargrefmarker} |
| 7653 |
\titlemargrefmarker={\dag} |
| 7654 |
\newcommand{\makemargreflabel}{\string\label\string{margref\themargrefnumber\string}} |
| 7655 |
\newif{\ifmargrefstomargin} |
| 7656 |
\margrefstomargintrue |
| 7657 |
\newcommand{\setmargref}{\nolinebreak\begin{marginenvironment}% |
| 7658 |
\nolinebreak% |
| 7659 |
\ifJHmarkstoright% |
| 7660 |
\JHrightmarginpar{\scriptsize {\the\margrefmarker~p.~\pageref{margref\themargrefnumber}}}% |
| 7661 |
\fi% |
| 7662 |
\ifJHmarkstoleft% |
| 7663 |
\JHleftmarginpar{\scriptsize {\the\margrefmarker~p.~\pageref{margref\themargrefnumber}}}% |
| 7664 |
\fi% |
| 7665 |
\ifJHmarkstoouter% |
| 7666 |
\JHoutermarginpar% |
| 7667 |
\fi% |
| 7668 |
\ifJHmarkstogutter% |
| 7669 |
\JHguttermarginpar% |
| 7670 |
\fi% |
| 7671 |
\end{marginenvironment}% |
| 7672 |
\nolinebreak% |
| 7673 |
} |
| 7674 |
|
| 7675 |
%\newcommand{\setmargref} |
| 7676 |
%{\marginpar{\ifmargrefstomargin\hspace*{.5\leftmargin}\fi% |
| 7677 |
%\scriptsize {\the\margrefmarker~p.~\pageref{margref\themargrefnumber}}} |
| 7678 |
%} |
| 7679 |
% \newcommand{\setmargref} |
| 7680 |
% {\marginpar{\scriptsize {\the\margrefmarker~p.~\pageref{margref\themargrefnumber}}} |
| 7681 |
% } |
| 7682 |
\newcommand{\margreftextnote}{% |
| 7683 |
\iftextnoteson\addtocounter{margrefnumber}{1}% |
| 7684 |
\immediate\write\textnotes{\makemargreflabel}% |
| 7685 |
\setmargref\else\relax\fi% |
| 7686 |
} |
| 7687 |
\newcommand{\margrefexplanatory}{% |
| 7688 |
\ifexplanon\addtocounter{margrefnumber}{1}% |
| 7689 |
\immediate\write\explanations{\makemargreflabel}% |
| 7690 |
\setmargref\else\relax\fi% |
| 7691 |
} |
| 7692 |
\newcommand{\margrefemendation}{% |
| 7693 |
\ifemendationson\addtocounter{margrefnumber}{1}% |
| 7694 |
\immediate\write\emendations{\makemargreflabel}% |
| 7695 |
\setmargref\else\relax\fi% |
| 7696 |
} |
| 7697 |
\newcommand{\margrefspecial}[1]{% |
| 7698 |
\marginpar{\scriptsize {\the\margrefmarker~p.~\pageref{#1}}} |
| 7699 |
} |
| 7700 |
% \end{macrocode} |
| 7701 |
% \end{macro} |
| 7702 |
% To change other title making commands to produce titles which add |
| 7703 |
% something while processing the title, you should: 1. add one to |
| 7704 |
% the number of arguments it uses 2. replace the use of |
| 7705 |
% |\set@p@emtitle| with |\set@margp@emtitle| 3. add |{#2}| or |
| 7706 |
% |\JHlabel{#2}| or whatever as the |
| 7707 |
% last (seventh) argument to |\set@margp@emtitle|. So, to change |
| 7708 |
% |\sequencetitle{}| to |\JHsequencetitle{}{}| start with: |
| 7709 |
% \begin{verbatim} |
| 7710 |
% \newcommand{\sequencetitle}[1]{ |
| 7711 |
% \set@p@emtitle{#1}{\sequencetitlepenalty}{\sequencetitlefont} |
| 7712 |
% {\sequencetitleindent}{\nobreak\par\nobreak\aftersequencetitleskip\nobreak}{\z@} |
| 7713 |
% \putpagenumberincontentsfalse |
| 7714 |
% \c@ntentsinfo{#1}{\contentsindentone}{\contentssequencetitlefont} |
| 7715 |
% {\contentsindenttwoamount} |
| 7716 |
% \putpagenumberincontentstrue |
| 7717 |
% \t@xtnotesinfo{#1} |
| 7718 |
% } |
| 7719 |
% \end{verbatim} |
| 7720 |
% and change it to |
| 7721 |
% \begin{verbatim} |
| 7722 |
% \catcode`\@=11 |
| 7723 |
% \newcommand{\JHsequencetitle}[2]{ |
| 7724 |
% \set@margp@emtitle{#1}{\sequencetitlepenalty}{\sequencetitlefont} |
| 7725 |
% {\relax}{\nobreak\par\nobreak\aftersequencetitleskip\nobreak}{\z@} |
| 7726 |
% {\JHlabel{#2}}\putpagenumberincontentsfalse |
| 7727 |
% \c@ntentsinfo{#1}{\contentsindentone}{\contentssequencetitlefont} |
| 7728 |
% {\contentsindenttwoamount} |
| 7729 |
% \putpagenumberincontentstrue |
| 7730 |
% \t@xtnotesinfo{#1} |
| 7731 |
% } |
| 7732 |
% \catcode`\@=12 |
| 7733 |
% \end{verbatim} |
| 7734 |
% \subsection{~Titles with footnotes} |
| 7735 |
% \label{footnotetitles} |
| 7736 |
% \begin{macro}{\footnotepoemtitle} |
| 7737 |
% \begin{macrocode} |
| 7738 |
\newif\iftitlefootnotesatpoemend% |
| 7739 |
\titlefootnotesatpoemendfalse% |
| 7740 |
\newif\iftitlefootnotesplain% |
| 7741 |
\titlefootnotesplaintrue% |
| 7742 |
\newif\iftitlefootnoteslayered% |
| 7743 |
\titlefootnoteslayeredfalse% |
| 7744 |
% |
| 7745 |
\newcommand{\maketitlefootnoteslayered}{% |
| 7746 |
\DeclareNewFootnote[plain]{H}% |
| 7747 |
\titlefootnoteslayeredtrue% |
| 7748 |
\titlefootnotesplainfalse% |
| 7749 |
\titlefootnotesatpoemendfalse% |
| 7750 |
} |
| 7751 |
% |
| 7752 |
\newcommand{\maketitlefootnotesatpoemend}{ |
| 7753 |
\titlefootnoteslayeredfalse% |
| 7754 |
\titlefootnotesplainfalse% |
| 7755 |
\titlefootnotesatpoemendtrue% |
| 7756 |
} |
| 7757 |
% |
| 7758 |
\newcommand{\maketitlefootnotesplain}{ |
| 7759 |
\titlefootnoteslayeredfalse% |
| 7760 |
\titlefootnotesplaintrue% |
| 7761 |
\titlefootnotesatpoemendfalse% |
| 7762 |
} |
| 7763 |
% |
| 7764 |
\newcommand{\placetitlefootnote}[1]{\iftitlefootnoteslayered% |
| 7765 |
\footnoteH{#1}% |
| 7766 |
\fi% |
| 7767 |
\iftitlefootnotesatpoemend% |
| 7768 |
\footnotemark% |
| 7769 |
\immediate\write\poemendnotes{\string\makeatletter}% |
| 7770 |
\immediate\write\poemendnotes{\string\footnotemark\string[\the\c@footnote \string]}% |
| 7771 |
\immediate\write\poemendnotes{\string\makeatother}% |
| 7772 |
\literalpoemendnote{#1}% |
| 7773 |
\fi% |
| 7774 |
\iftitlefootnotesplain% |
| 7775 |
\footnote{#1}% |
| 7776 |
\fi% |
| 7777 |
} |
| 7778 |
% |
| 7779 |
\newcommand{\footnotepoemtitle}[2]{% |
| 7780 |
\set@p@emtitle{#1\placetitlefootnote{#2}}{\poemtitlepenalty}{\poemtitlefont}% |
| 7781 |
{\poemtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\z@}% |
| 7782 |
\c@ntentsinfo{#1}{\contentspoemtitleindent}{\contentspoemtitlefont}% |
| 7783 |
{\contentspoemtitleindentamount}% |
| 7784 |
\t@xtnotesinfo{#1}% |
| 7785 |
} |
| 7786 |
% |
| 7787 |
% \end{macrocode} |
| 7788 |
% \end{macro} |
| 7789 |
% \begin{macro}{\footnotepoemtitlefirstline} |
| 7790 |
% \begin{macrocode} |
| 7791 |
\newcommand{\footnotepoemtitlefirstline}[2]{% |
| 7792 |
\firstlinesettings% |
| 7793 |
\set@p@emtitle{#1\placetitlefootnote{#2}}{\multilinetitlepenalty}{\poemtitlefont}% |
| 7794 |
{\poemtitleindent}{\nobreak\par\nobreak}{\z@}% |
| 7795 |
\c@ntentsinfo{#1}{\contentspoemtitleindent}{\contentspoemtitlefont}% |
| 7796 |
{\contentspoemtitleindentamount}% |
| 7797 |
\t@xtnotesinfo{#1}% |
| 7798 |
\restoresinglelinesettings% |
| 7799 |
} |
| 7800 |
% |
| 7801 |
\newcommand{\footnotepoemtitlemiddleline}[2]{% |
| 7802 |
\middlelinesettings% |
| 7803 |
\set@p@emtitle{#1\placetitlefootnote{#2}}{\par\nobreak}{\poemtitlefont}% |
| 7804 |
{\poemtitlesecondlineindent}{\nobreak\par\nobreak}{\z@}% |
| 7805 |
\c@ntentsinfo{#1}{\contentspoemtitlesecondlineindent}{\contentspoemtitlefont}% |
| 7806 |
{\contentspoemtitlesecondlineindentamount}% |
| 7807 |
\t@xtnotesinfo{#1}% |
| 7808 |
\restoresinglelinesettings% |
| 7809 |
} |
| 7810 |
% |
| 7811 |
\newcommand{\footnotepoemtitlelastline}[2]{% |
| 7812 |
\lastlinesettings% |
| 7813 |
\set@p@emtitle{#1\placetitlefootnote{#2}}{\par\nobreak}{\poemtitlefont}% |
| 7814 |
{\poemtitlesecondlineindent}{\nobreak\par\afterpoemtitleskip\nobreak}{\z@}% |
| 7815 |
\c@ntentsinfo{#1}{\contentspoemtitlesecondlineindent}{\contentspoemtitlefont}% |
| 7816 |
{\contentspoemtitlesecondlineindentamount}% |
| 7817 |
\t@xtnotesinfo{#1}% |
| 7818 |
\restoresinglelinesettings% |
| 7819 |
} |
| 7820 |
% \end{macrocode} |
| 7821 |
% \end{macro} |
| 7822 |
% \begin{macro}{\footnotesplitpoemtitle} |
| 7823 |
% \begin{macrocode} |
| 7824 |
\newcommand{\footnotesplitpoemtitle}[3]{% |
| 7825 |
\set@p@emtitle{#1\placetitlefootnote{#2} #3}{\poemtitlepenalty}{\poemtitlefont}% |
| 7826 |
{\poemtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\z@}% |
| 7827 |
\c@ntentsinfo{#1 #3}{\contentspoemtitleindent}{\contentspoemtitlefont}% |
| 7828 |
{\contentspoemtitleindentamount}% |
| 7829 |
\t@xtnotesinfo{#1 #3}% |
| 7830 |
} |
| 7831 |
% \end{macrocode} |
| 7832 |
% \end{macro} |
| 7833 |
% \subsection{~Epigraphs, headnotes, attributions, dedications} |
| 7834 |
% Notice that epigraphs to volumes are handled differently from |
| 7835 |
% epigraphs to poems. Notice also the ``short'' commands, which |
| 7836 |
% are placed on the page according to the same booleans |
| 7837 |
% that control how titles are placed. |
| 7838 |
% \begin{macro}{\epigraph} |
| 7839 |
% \begin{macro}{\headnote} |
| 7840 |
% \begin{macro}{\attribution} |
| 7841 |
% \begin{macro}{\poemdedication} |
| 7842 |
% \begin{macro}{\volumededication} |
| 7843 |
% \begin{macro}{\volumeepigraph} |
| 7844 |
% \begin{macro}{\volumeattribution} |
| 7845 |
% \begin{macrocode} |
| 7846 |
\newif\ifcenterepigraphson |
| 7847 |
\centerepigraphsonfalse |
| 7848 |
\newlength{\centerepigraphindentation} |
| 7849 |
\setlength{\centerepigraphindentation}{6em} |
| 7850 |
\newlength{\normalepigraphindentation} |
| 7851 |
\setlength{\normalepigraphindentation}{1.5em} |
| 7852 |
\newcommand{\centerepigraphquote}{% |
| 7853 |
\setlength{\epigraphquoteleftmargin}{\centerepigraphindentation} |
| 7854 |
\setlength{\epigraphquoterightmargin}{\centerepigraphindentation} |
| 7855 |
} |
| 7856 |
\newcommand{\normalepigraphquote}{% |
| 7857 |
\setlength{\epigraphquoteleftmargin}{\normalepigraphindentation} |
| 7858 |
\setlength{\epigraphquoterightmargin}{\normalepigraphindentation} |
| 7859 |
} |
| 7860 |
\newcommand{\testforcenterepigraph}{\ifcenterepigraphson% |
| 7861 |
\centerepigraphquote |
| 7862 |
\else |
| 7863 |
\normalepigraphquote |
| 7864 |
\fi} |
| 7865 |
\newcommand{\epigraph}[1]{\nopagebreak\afterpoemtitleskip\testforcenterepigraph% |
| 7866 |
\begin{epigraphquote}% |
| 7867 |
\emph{#1}\end{epigraphquote}\afterpoemtitleskip\nopagebreak} |
| 7868 |
\newcommand{\headnote}[1]{\epigraph{#1}} |
| 7869 |
\newcommand{\attribution}[1]{\nopagebreak\afterpoemtitleskip\testforcenterepigraph% |
| 7870 |
\begin{epigraphquote}% |
| 7871 |
{\small\emph{#1}}\end{epigraphquote}\afterpoemtitleskip\nopagebreak} |
| 7872 |
\newcommand{\poemdedication}[1]{\nopagebreak\afterpoemtitleskip\testforcenterepigraph% |
| 7873 |
\begin{epigraphquote}% |
| 7874 |
\emph{#1}\end{epigraphquote}\afterpoemtitleskip\nopagebreak} |
| 7875 |
\providecommand{\dedication}[1]{\poemdedication{#1}} |
| 7876 |
\newcommand{\volumededication}[1]{\par\bigskip\begin{volumetitlepagequote} |
| 7877 |
\emph{#1}\end{volumetitlepagequote}} |
| 7878 |
\newcommand{\volumeepigraph}[1]{\par\bigskip\begin{volumetitlepagequote} |
| 7879 |
\emph{#1}\end{volumetitlepagequote}} |
| 7880 |
\newcommand{\volumeattribution}[1]{\par\smallskip\begin{volumetitlepagequote} |
| 7881 |
{\small \emph{#1}}\end{volumetitlepagequote}} |
| 7882 |
\newenvironment{epigraphenvironment}{\nopagebreak\afterpoemtitleskip\testforcenterepigraph% |
| 7883 |
\begin{epigraphquote}\em}{\end{epigraphquote}\afterpoemtitleskip\nopagebreak} |
| 7884 |
\newcommand{\set@short@pigraph}[1]{\iftitlesatleftversemargin% |
| 7885 |
{\begin{pmclverse}\addtolength{\leftmargin}{-\leftmargini}{\nobreak \emph{#1} \afterpoemtitleskip} \end{pmclverse}}% |
| 7886 |
\else%\iftitlesatleftversemargin |
| 7887 |
{\nobreak}% |
| 7888 |
\begin{titleentryenvironment}% |
| 7889 |
\ifnormaltitleindentation |
| 7890 |
\hspace{\normalepigraphindentation}\emph{#1}% |
| 7891 |
\else % for the \ifnormaltitleindentation |
| 7892 |
\ifcenterepigraphson |
| 7893 |
\begin{center} \emph{#1}\end{center} |
| 7894 |
\else \emph{#1}\fi % for ifcenterepigraphson |
| 7895 |
\fi %\ifnormaltitleindentation |
| 7896 |
\end{titleentryenvironment} |
| 7897 |
{\afterpoemtitleskip}% |
| 7898 |
\fi}% for the \iftitlesatleftversemargin |
| 7899 |
\newcommand{\shortpoemepigraph}[1]{\nopagebreak\afterpoemtitleskip% |
| 7900 |
\set@short@pigraph{#1} |
| 7901 |
} |
| 7902 |
\newcommand{\shortpoemdedication}[1]{\nopagebreak\afterpoemtitleskip% |
| 7903 |
\set@short@pigraph{#1} |
| 7904 |
} |
| 7905 |
\newcommand{\shortpoemattribution}[1]{\nopagebreak\afterpoemtitleskip% |
| 7906 |
\set@short@pigraph{{\small #1}} |
| 7907 |
} |
| 7908 |
\newcommand{\JHshortepigraph}[2]{\nopagebreak\afterpoemtitleskip% |
| 7909 |
\set@short@pigraph{#1}\marginpar{{\scriptsize{\the\margrefmarker~p.~\pageref{#2}}}} |
| 7910 |
\sources{\label{#2}} |
| 7911 |
} |
| 7912 |
\newcommand{\JHshortdedication}[2]{\JHshortepigraph{#1}{#2}} |
| 7913 |
|
| 7914 |
|
| 7915 |
\newlength{\dateindent}% |
| 7916 |
\setlength{\dateindent}{\leftmargin}% |
| 7917 |
\newcommand{\variabledateindent}{% |
| 7918 |
\setlength{\dateindent}{\linewidth}% |
| 7919 |
\addtolength{\dateindent}{-\versewidth}% |
| 7920 |
\addtolength{\dateindent}{-.5\dateindent}} |
| 7921 |
%\newcommand{\poemdate}[1]{\bigskip\begin{raggedleft}\hspace{\dateindent}#1\end{raggedleft}\bigskip}% |
| 7922 |
\newcommand{\poemdate}[1]{\iflastpoemcentered\variabledateindent% |
| 7923 |
\else\setlength{\dateindent}{\leftmargin}% |
| 7924 |
\fi% |
| 7925 |
\bigskip\begin{raggedleft}\hspace{\dateindent}#1\end{raggedleft}\bigskip}% |
| 7926 |
% |
| 7927 |
\newlength{\poemattributionindent}% |
| 7928 |
\setlength{\poemattributionindent}{\leftmargin}% |
| 7929 |
\newcommand{\variablepoemattributionindent}{% |
| 7930 |
\setlength{\poemattributionindent}{\linewidth}% |
| 7931 |
\addtolength{\poemattributionindent}{-\versewidth}% |
| 7932 |
\addtolength{\poemattributionindent}{-.5\poemattributionindent}}% |
| 7933 |
\newcommand{\poemattribution}[1]{\iflastpoemcentered\variablepoemattributionindent% |
| 7934 |
\else\setlength{\poemattributionindent}{\leftmargin}% |
| 7935 |
\fi% |
| 7936 |
\bigskip\begin{raggedleft}\hspace{\poemattributionindent}#1\end{raggedleft}\bigskip}% |
| 7937 |
% \end{macrocode} |
| 7938 |
% \end{macro} |
| 7939 |
% \end{macro} |
| 7940 |
% \end{macro} |
| 7941 |
% \end{macro} |
| 7942 |
% \end{macro} |
| 7943 |
% \end{macro} |
| 7944 |
% \end{macro} |
| 7945 |
% \subsection{~Tools used for making note sections} \label{notetools} The main tool is |
| 7946 |
% a dirty trick borrowed from John Lavagnino's package for endnotes, |
| 7947 |
% \textsf{endnotes}, which allows for writing out literal characters to an |
| 7948 |
% external file. The trick involves redefining the space character as |
| 7949 |
% the newline character and treating the text of the note as the body of |
| 7950 |
% a macro that |\meaning| specifies. The result is that the text is |
| 7951 |
% written to the external file in a long ribbon one word wide. |
| 7952 |
% \begin{macrocode} |
| 7953 |
\def\strip#1>{} |
| 7954 |
\newcommand{\literaltextnote}[1]{\iftextnotesatend |
| 7955 |
\begingroup |
| 7956 |
\def\next{#1}% |
| 7957 |
\newlinechar='40 |
| 7958 |
\immediate\write\textnotes{\expandafter\strip\meaning\next}% |
| 7959 |
\endgroup\fi |
| 7960 |
} |
| 7961 |
\newcommand{\literalemend}[1]{\ifemendationsatend |
| 7962 |
\begingroup |
| 7963 |
\def\next{#1}% |
| 7964 |
\newlinechar='40 |
| 7965 |
\immediate\write\emendations{\expandafter\strip\meaning\next}% |
| 7966 |
\endgroup\fi |
| 7967 |
} |
| 7968 |
\newcommand{\literalexplain}[1]{\ifexplanatend |
| 7969 |
\begingroup |
| 7970 |
\def\next{#1}% |
| 7971 |
\newlinechar='40 |
| 7972 |
\immediate\write\explanations{\expandafter\strip\meaning\next}% |
| 7973 |
\endgroup\fi |
| 7974 |
} |
| 7975 |
\newcommand{\literalcontents}[1]{\ifpoemcontentson |
| 7976 |
\begingroup |
| 7977 |
\def\next{#1}% |
| 7978 |
\newlinechar='40 |
| 7979 |
\immediate\write\poemcontents{\expandafter\strip\meaning\next}% |
| 7980 |
\endgroup\fi |
| 7981 |
} |
| 7982 |
\newcommand{\literaltextnoteshort}[1]{ |
| 7983 |
\iftextnotesatend |
| 7984 |
\begingroup |
| 7985 |
\def\next{#1}% |
| 7986 |
\immediate\write\textnotes{\expandafter\strip\meaning\next}% |
| 7987 |
\endgroup\fi} |
| 7988 |
\newcommand{\literalemendshort}[1]{\ifemendationsatend |
| 7989 |
\begingroup |
| 7990 |
\def\next{#1}% |
| 7991 |
\immediate\write\emendations{\expandafter\strip\meaning\next}% |
| 7992 |
\endgroup\fi} |
| 7993 |
\newcommand{\literalexplainshort}[1]{\ifexplanatend |
| 7994 |
\begingroup |
| 7995 |
\def\next{#1}% |
| 7996 |
\immediate\write\explanations{\expandafter\strip\meaning\next}% |
| 7997 |
\endgroup\fi} |
| 7998 |
\newcommand{\literalcontentsshort}[1]{\ifpoemcontentson |
| 7999 |
\begingroup |
| 8000 |
\immediate\write\poemcontents{\expandafter\strip\meaning\next}% |
| 8001 |
\endgroup\fi} |
| 8002 |
\newcommand{\sameword}{$\sim$} |
| 8003 |
\newcommand{\missingpunct}{${}_{\wedge}$} |
| 8004 |
% \end{macrocode} |
| 8005 |
% \begin{macro}{\pmccheckifinteger} |
| 8006 |
% |\pmccheckifinteger{|\meta{num}|}| checks if \meta{num} is an integer. |
| 8007 |
% If it is, then |\ifinteger| is set TRUE, otherwise it is set FALSE. |
| 8008 |
% (Code taken from memoir class, and based on Donald Arseneau's |
| 8009 |
% |\Lpack{cite}| package). |
| 8010 |
% \begin{macrocode} |
| 8011 |
\newcommand{\pmccheckifinteger}[1]{% |
| 8012 |
\protected@edef\@vsa{#1}% |
| 8013 |
\ifcat _\ifnum9<1\pmcgobm{#1} _\else A\fi |
| 8014 |
\integertrue% |
| 8015 |
\else |
| 8016 |
\integerfalse% |
| 8017 |
\fi% |
| 8018 |
} |
| 8019 |
\newif\ifinteger |
| 8020 |
% \begin{macro}{\pmcgobm} |
| 8021 |
% |\pmcgobm{|\meta{num}|}| is defined as \meta{num}. It could be defined as: \\ |
| 8022 |
% |\newcommand{\pmcgobm}[1]{\ifx-#1\expandafter\gobm\else#1\fi}| \\ |
| 8023 |
% which would remove a leading minus sign (hyphen) from its argument |
| 8024 |
% (|gobm| = gobble minus sign). |
| 8025 |
% (Code from memoir class and a posting to comp.text.tex by Donald Arseneau on 1997/07/21). |
| 8026 |
% \begin{macrocode} |
| 8027 |
\newcommand{\pmcgobm}[1]{#1} |
| 8028 |
% \end{macrocode} |
| 8029 |
% \end{macro} |
| 8030 |
% \subsection{~Commands to make notes and send info to contents} |
| 8031 |
% \begin{macro}{\setlemmarange} |
| 8032 |
% |\setlemmarange| calculates the range of line numbers for multi-line |
| 8033 |
% lemmas. |
| 8034 |
% \begin{macrocode} |
| 8035 |
% \newcommand{\setlemmarange}[1]{ |
| 8036 |
% \setcounter{lemmalines}{#1} |
| 8037 |
% \ifthenelse{\equal{\value{lemmalines}}{0}}{\rangelemmafalse}{\rangelemmatrue} |
| 8038 |
% \setcounter{lemmaend}{\theverselinenumber} |
| 8039 |
% \addtocounter{lemmaend}{\thelemmalines} |
| 8040 |
% } |
| 8041 |
\newcommand{\setlemmarange}[1]{% |
| 8042 |
\pmccheckifinteger{#1}% |
| 8043 |
\ifinteger |
| 8044 |
\setcounter{lemmalines}{#1}% |
| 8045 |
\ifthenelse{\equal{\value{lemmalines}}{0}}{\rangelemmafalse}{\rangelemmatrue}% |
| 8046 |
\setcounter{lemmaend}{\theverselinenumber}% |
| 8047 |
\addtocounter{lemmaend}{\thelemmalines}% |
| 8048 |
\else |
| 8049 |
\setcounterfromref{lemmaend}{#1}\rangelemmatrue |
| 8050 |
\fi |
| 8051 |
\makeatother} |
| 8052 |
% \end{macrocode} |
| 8053 |
% \end{macro} |
| 8054 |
% \begin{macro}{\citerange} |
| 8055 |
% |\citerange| sets the range of line numbers for multi-line lemmas |
| 8056 |
% \begin{macrocode} |
| 8057 |
\newcommand{\citerange}{% |
| 8058 |
\ifrangelemma |
| 8059 |
\theverselinenumber --\thelemmaend |
| 8060 |
\else |
| 8061 |
\theverselinenumber |
| 8062 |
\fi} |
| 8063 |
% \end{macrocode} |
| 8064 |
% \end{macro} |
| 8065 |
% \begin{macro}{\resetlemmacounters} |
| 8066 |
% |\resetlemmacounters| resets the counts for multiline lemmas. |
| 8067 |
% \begin{macrocode} |
| 8068 |
\newcommand{\resetlemmacounters}{\rangelemmafalse |
| 8069 |
\setcounter{lemmalines}{0}% |
| 8070 |
\setcounter{lemmaend}{0}% |
| 8071 |
} |
| 8072 |
% \end{macrocode} |
| 8073 |
% \end{macro} |
| 8074 |
% \begin{macro}{\checknoteheaders} |
| 8075 |
% |\checknoteheaders| Checks and corrects the values in the running |
| 8076 |
% headers of notes sections. The running headers are of the form |
| 8077 |
% ``Notes to pages xx--yy.'' Every title and every note checks |
| 8078 |
% whether the values in the running header should be changed. This |
| 8079 |
% command essentially gives a list of strings to be written on the |
| 8080 |
% external file for the note section. When these strings are read |
| 8081 |
% back in when the file is set, they make a little program that |
| 8082 |
% recalculates the values in the headers during the processing of |
| 8083 |
% every note. Also typesets the line number or line number range in |
| 8084 |
% notes sections. |
| 8085 |
% \begin{macrocode} |
| 8086 |
\newcommand{\checknoteheaders}{\string\setcounter\string{notepageholdernote\string}% |
| 8087 |
\string{\thepage\string}\string\ifhmode\string\unskip\string\fi% |
| 8088 |
\string\ifthenelse\string{\string\value\string{notepageholdernote\string}>% |
| 8089 |
\string\value\string{notepageholdertitle\string}\string}% |
| 8090 |
\string{\string\mark\string{\string\thenotepageholdernote\string}\string}% |
| 8091 |
\string{\string\mark\string{\string\thenotepageholdertitle\string}\string}\string\unskip |
| 8092 |
\string\unskip\string\relax\ \citerange :\string~\string\nolinebreak}% |
| 8093 |
|
| 8094 |
% \end{macrocode} |
| 8095 |
% \end{macro} |
| 8096 |
% \begin{macro}{\textnote} |
| 8097 |
% The |
| 8098 |
% basic |\textnote{}| command, on which everything else is based, has |
| 8099 |
% several parts. First, it writes out a little program |
| 8100 |
% on the external endnotes file which, when it is read back in when |
| 8101 |
% the endnotes are typeset, sets a variable with the value of |
| 8102 |
% the page of the line the note is commenting upon and checks to see |
| 8103 |
% whether that value is equal to or greater than that of previous notes |
| 8104 |
% on that page of notes. Depending upon the outcome of that test, it |
| 8105 |
% sets the value of |\mark| with the correct numbers to print the proper |
| 8106 |
% running header of the form ``Textual Notes to pp.xx--yy.'' Second, it |
| 8107 |
% sends the line number of the line it is a comment upon and the text of |
| 8108 |
% the note to the notes section. The optional first argument is the |
| 8109 |
% number of lines covered by a multiline lemma. If there is no |
| 8110 |
% optional first argument specified, the default is 0. The second |
| 8111 |
% argument is the text of the note, which includes the rest of the |
| 8112 |
% lemma, other than the line number. It is up to you to suitably |
| 8113 |
% abbreviate long lemmas. |
| 8114 |
% |
| 8115 |
% |
| 8116 |
% |
| 8117 |
% \begin{macrocode} |
| 8118 |
\newif\iftextnotessinglepar |
| 8119 |
\newcommand{\textnote}[2][0]{% |
| 8120 |
\iftextnoteson |
| 8121 |
\setlemmarange{#1}% |
| 8122 |
\immediate\write\textnotes{\checknoteheaders}% |
| 8123 |
\literaltextnote{#2}% |
| 8124 |
\iftextnotessinglepar% |
| 8125 |
\literaltextnote{\par}% |
| 8126 |
\fi% |
| 8127 |
\fi |
| 8128 |
\resetlemmacounters |
| 8129 |
} |
| 8130 |
% \end{macrocode} |
| 8131 |
% \end{macro} |
| 8132 |
% \begin{macro}{\accidental} |
| 8133 |
% Accidentals: As it is, the command just tests to see whether |
| 8134 |
% accidentals are being included or not, and sets the accidental as a |
| 8135 |
% textnote if accidentals are being included. It would not be hard to |
| 8136 |
% divert accidentals to another external file in order to compile a |
| 8137 |
% separate list of accidentals. Accidentals, by their nature, cannot have multiline |
| 8138 |
% lemmas. |
| 8139 |
% \begin{macrocode} |
| 8140 |
\newcommand{\accidental}[1]{% |
| 8141 |
\iftextnoteson% |
| 8142 |
\ifincludeaccidentals% |
| 8143 |
\iftextnotesatend\immediate\write\textnotes{\string\nobreak}\fi% |
| 8144 |
\textnote{#1}% |
| 8145 |
\iftextnotesatend\immediate\write\textnotes{\string\nobreak}\fi% |
| 8146 |
\iftextnotessinglepar% |
| 8147 |
\literaltextnote{\par}% |
| 8148 |
\fi% |
| 8149 |
\fi\fi |
| 8150 |
} |
| 8151 |
% \end{macrocode} |
| 8152 |
% \end{macro} |
| 8153 |
% \begin{macro}{\tsvariant} |
| 8154 |
% \begin{macro}{\tsaccidental} |
| 8155 |
% Typescript variants. Treated like accidentals. If they are being |
| 8156 |
% collected, they are sent to the textual notes. Again, it would not be |
| 8157 |
% hard to collect them separately. Typescript variants can have |
| 8158 |
% multiline lemmas. |
| 8159 |
% \begin{macrocode} |
| 8160 |
\newcommand{\tsvariant}[2][0]{% |
| 8161 |
\iftextnoteson |
| 8162 |
\ifincludetypescripts% |
| 8163 |
\iftextnotesatend\immediate\write\textnotes{\string\nobreak}\fi% |
| 8164 |
\textnote[#1]{#2}% |
| 8165 |
\iftextnotesatend\immediate\write\textnotes{\string\nobreak}\fi% |
| 8166 |
\fi\fi |
| 8167 |
} |
| 8168 |
\newcommand{\tsaccidental}[1]{\iftextnoteson\ifincludetypescripts\accidental{#1}\fi\fi} |
| 8169 |
% \end{macrocode} |
| 8170 |
% \end{macro} |
| 8171 |
% \end{macro} |
| 8172 |
% \begin{macro}{\tsentry} |
| 8173 |
% Typescript entries. Allows one to to selectively include or exclude |
| 8174 |
% typescript entries from lists of variants. If an entry begins with |
| 8175 |
% a comma (as it commonly will, since it will typically be a member |
| 8176 |
% of a list of entries, you need not put |\unskip| before the comma, |
| 8177 |
% since \textsf{poemscol} will do it for you. Thanks to Donald |
| 8178 |
% Arseneau for suggesting how to do this. |
| 8179 |
% \begin{macrocode} |
| 8180 |
\newcommand{\tsentry}[1]{\iftextnoteson\ifincludetypescripts{\@ifnextchar,{\unskip}{% |
| 8181 |
Ê\@ifnextchar;{\unskip}{}% |
| 8182 |
}#1}\fi\fi\unskip} |
| 8183 |
% \end{macrocode} |
| 8184 |
% \end{macro} |
| 8185 |
% \begin{macro}{\sources} |
| 8186 |
% |\sources{}| is essentially a |\textnote{}| with no line number |
| 8187 |
% and no page checking. Useful for typesetting the sources of the text |
| 8188 |
% (hence the name) and for sending literal characters to the endnotes |
| 8189 |
% file for other purposes. |
| 8190 |
% \begin{macrocode} |
| 8191 |
\newcommand{\sources}[1]{% |
| 8192 |
\iftextnoteson |
| 8193 |
\begingroup |
| 8194 |
\newlinechar='40 |
| 8195 |
\def\next{#1}% |
| 8196 |
\immediate\write\textnotes{\expandafter\strip\meaning\next}% |
| 8197 |
\endgroup |
| 8198 |
\iftextnotessinglepar% |
| 8199 |
\literaltextnote{\par}% |
| 8200 |
\fi% |
| 8201 |
\fi |
| 8202 |
} |
| 8203 |
% \end{macrocode} |
| 8204 |
% \end{macro} |
| 8205 |
% |
| 8206 |
% \subsection{~Emendations and explanatory notes} |
| 8207 |
% The difference between these kinds of notes and ordinary |
| 8208 |
% |\textnotes{}| is that they must first test to see whether there have |
| 8209 |
% been any emendations or explanatory notes for the poem in question. |
| 8210 |
% If there have not been prior notes, then a new paragraph must be |
| 8211 |
% opened and the page number and title of the poem set in the note |
| 8212 |
% section. |
| 8213 |
% \begin{macro}{\titletoothernotes} |
| 8214 |
% |\titletoothernotes| sends the page and title information to the |
| 8215 |
% Emendations or Explanatory Notes sections. It is called only for |
| 8216 |
% the first emendation or explanatory note for a poem. It is designed |
| 8217 |
% so that if the user wishes to define another category of notes in |
| 8218 |
% which might not apply to all of the poems to be set --- not all |
| 8219 |
% poems, for instance, have emendations --- this command can be used |
| 8220 |
% for those notes as well. |
| 8221 |
% \begin{macrocode} |
| 8222 |
\newcommand{\titletoothernotes}{\string\par |
| 8223 |
\ifputpagenumberinnotes% |
| 8224 |
\string\argpageref\string{\@compoundlabelscratch\string}% |
| 8225 |
\string\setcounterfrompageref\string{notepageholdertitle\string}% |
| 8226 |
\string{\@compoundlabelscratch\string}% |
| 8227 |
\fi% |
| 8228 |
\string\textbf\string{\ \the\fulltitleholder\string}}% |
| 8229 |
% \end{macrocode} |
| 8230 |
% \end{macro} |
| 8231 |
% \begin{macro}{\emendation} |
| 8232 |
% \begin{macrocode} |
| 8233 |
\newif\ifemendationssinglepar |
| 8234 |
\newcommand{\emendation}[2][0]{ |
| 8235 |
\ifemendationson |
| 8236 |
\setlemmarange{#1}% |
| 8237 |
\ifredundantemendations |
| 8238 |
\iftextnoteson |
| 8239 |
\ifrangelemma |
| 8240 |
\textnote[#1]{#2}% |
| 8241 |
\else |
| 8242 |
\textnote{#2}% |
| 8243 |
\fi % ifrangelemma} |
| 8244 |
\iftextnotessinglepar% |
| 8245 |
\literaltextnote{\par}% |
| 8246 |
\fi% iftextnotesinglepar |
| 8247 |
\fi %iftextnoteson |
| 8248 |
\fi % ifredundantemendations |
| 8249 |
\ifnoemendyet % firstemendation |
| 8250 |
\firstemendation |
| 8251 |
\fi %noemendyet |
| 8252 |
\global\noemendyetfalse |
| 8253 |
\immediate\write\emendations{\checknoteheaders}% |
| 8254 |
\literalemend{#2}% |
| 8255 |
\ifemendationssinglepar% |
| 8256 |
\literalemend{\par}% |
| 8257 |
\fi% ifemendationssinglepar |
| 8258 |
\fi % ifemendationson |
| 8259 |
\resetlemmacounters |
| 8260 |
} |
| 8261 |
% \end{macrocode} |
| 8262 |
% \end{macro} |
| 8263 |
% This next is an internal command, |
| 8264 |
% called by |\emendation|. There's no need to use it explicitly. |
| 8265 |
% \begin{macrocode} |
| 8266 |
\newcommand{\firstemendation}{\ifemendationsatend |
| 8267 |
\immediate\write\emendations{\titletoothernotes}\fi |
| 8268 |
} |
| 8269 |
% \end{macrocode} |
| 8270 |
% \begin{macro}{\explanatory} |
| 8271 |
% Again, |\firstexplanatory| is internal, called by |\explanatory|. |
| 8272 |
% \begin{macrocode} |
| 8273 |
\newif\ifexplanationssinglepar |
| 8274 |
\newcommand{\explanatory}[2][0]{% |
| 8275 |
\ifexplanon |
| 8276 |
\setlemmarange{#1}% |
| 8277 |
\ifnoexplainyet % first explanation |
| 8278 |
\firstexplanatory |
| 8279 |
\fi %noexplainyet |
| 8280 |
\global\noexplainyetfalse |
| 8281 |
\immediate\write\explanations{\checknoteheaders}% |
| 8282 |
\literalexplain{#2}% |
| 8283 |
\ifexplanationssinglepar% |
| 8284 |
\literalexplain{\par}% |
| 8285 |
\fi% |
| 8286 |
\fi % ifexplanon |
| 8287 |
\resetlemmacounters |
| 8288 |
} |
| 8289 |
|
| 8290 |
\newcommand{\firstexplanatory}{\ifexplanatend |
| 8291 |
\immediate\write\explanations{\titletoothernotes}\fi |
| 8292 |
} |
| 8293 |
|
| 8294 |
% \end{macrocode} |
| 8295 |
% \end{macro} |
| 8296 |
% |
| 8297 |
% \subsection{~Making new notes sections} |
| 8298 |
% |
| 8299 |
% \begin{macro}{\definenewnotetype} This monster macro has nine |
| 8300 |
% sections, and does all of the things required to set up a new end |
| 8301 |
% notes section. If you decide to mark a new kind of note in your |
| 8302 |
% text with, say |\mynote|, but decide at the last moment against |
| 8303 |
% including those notes in your edition, simply don't issue |\putmynotes| at |
| 8304 |
% the point it might have appeared, and neither the notes section nor |
| 8305 |
% the contents entry for it will be included. |
| 8306 |
% |
| 8307 |
% \begin{macrocode} |
| 8308 |
\makeatletter |
| 8309 |
\long\def\appendtomacro#1#2{% |
| 8310 |
\begingroup |
| 8311 |
\toks@\expandafter{#1#2}% |
| 8312 |
\xdef#1{\the\toks@}% |
| 8313 |
\endgroup} |
| 8314 |
\makeatother |
| 8315 |
\newcommand{\definenewnotetype}[5]{% |
| 8316 |
% 1. make an if for this kind of note and set it to true by default; |
| 8317 |
% make an if for the first instance of the command per poem and set it |
| 8318 |
% to false; make an if for setting the notes in single note |
| 8319 |
% paragraphs and set it to false; make an if for setting |
| 8320 |
% these notes in two column mode and set it to false |
| 8321 |
% |
| 8322 |
% Thanks to Igor Pechtchanski and Ulrich Schwarz. |
| 8323 |
\expandafter\newif\csname if#1son\endcsname |
| 8324 |
\global\csname #1sontrue\endcsname |
| 8325 |
\expandafter\newif\csname ifno#1yet\endcsname |
| 8326 |
\csname no#1yettrue\endcsname |
| 8327 |
\expandafter\newif\csname if#1ssinglepar\endcsname |
| 8328 |
\csname #1singleparfalse\endcsname |
| 8329 |
\expandafter\newif\csname if#1stwocol\endcsname |
| 8330 |
\csname #1stwocolfalse\endcsname |
| 8331 |
% 2. open a new output stream |
| 8332 |
\expandafter\newwrite\csname #1s\endcsname |
| 8333 |
% 3. open a file to associate with the stream |
| 8334 |
\immediate\expandafter\openout\csname #1s\endcsname=\expandafter\jobname .#2 |
| 8335 |
% 4. set up a literalwrite command |
| 8336 |
\expandafter\newcommand\csname literal#1\endcsname[1]{ |
| 8337 |
\begingroup |
| 8338 |
\def\next{##1}% |
| 8339 |
\newlinechar='40 |
| 8340 |
\immediate\write\expandafter\csname #1s\endcsname{\expandafter\strip\meaning\next}% |
| 8341 |
\endgroup} |
| 8342 |
% 5. send heading information to output file |
| 8343 |
% first, use literaltext to send commands without parameters |
| 8344 |
\csname literal#1\endcsname{\flushbottom{\par\clearpage |
| 8345 |
{\pagestyle{volumetitlestyle}\cleardoublepage} |
| 8346 |
\thispagestyle{volumetitlestyle}} |
| 8347 |
\fancyhead{} |
| 8348 |
\fancyfoot{} |
| 8349 |
\fancyhead[RO,LE]{{\small\textrm{\thepage}}}} |
| 8350 |
% then immediate write to send the parameter for the marks in the |
| 8351 |
% headers |
| 8352 |
\immediate\write\csname #1s\endcsname{\string\fancyhead[CO]\string{\string{\string\small |
| 8353 |
\string{\string\em\ #3\string~\string\mymarks\string}\string}\string}} |
| 8354 |
\immediate\write\csname #1s\endcsname{\string\fancyhead[CE]\string{\string{\string\small |
| 8355 |
\string{\string\em\ #3\string~\string\mymarks\string}\string}\string}} |
| 8356 |
% then literal to finish the headers |
| 8357 |
\csname literal#1\endcsname{\fancyfoot[C]{} |
| 8358 |
\mark{3} |
| 8359 |
\backmattersink} |
| 8360 |
% then immediate write to send the title of the section to print at |
| 8361 |
% the top of the page |
| 8362 |
\immediate\write\csname #1s\endcsname{ |
| 8363 |
\string\setendnotessectiontitle\string{#4\string}\string{#1notes\string}} |
| 8364 |
% literal write to turn hyphenation on, set the font for the note |
| 8365 |
% section, and turn on two column mode (if the boolean is set) |
| 8366 |
\csname literal#1\endcsname{\lefthyphenmin=2\backmatterafterheadersink |
| 8367 |
\tolerance=500\language=0 |
| 8368 |
\normalfont \backmattertextfont} |
| 8369 |
\immediate\write\csname #1s\endcsname{\string\if#1stwocol} |
| 8370 |
\csname |
| 8371 |
literal#1\endcsname{\begin{multicols}{2}\fi\setlength{\parindent}{-10pt}}% |
| 8372 |
% \csname literal#1\endcsname{\setlength}{\parindent}{2}}% problem here |
| 8373 |
% 6. set up a command to write the page and title of the poem for the first |
| 8374 |
% instance of this kind of note in a poem |
| 8375 |
\expandafter\newcommand\csname first#1\endcsname{% |
| 8376 |
\immediate\write\expandafter\csname #1s\endcsname{\titletoothernotes}% |
| 8377 |
\immediate\write\csname #1s\endcsname{\string\if#1ssinglepar}% |
| 8378 |
\immediate\write\csname #1s\endcsname{\string\par}% |
| 8379 |
\immediate\write\csname #1s\endcsname{\string\fi}% |
| 8380 |
} |
| 8381 |
% 7. set up a command to write a note, complete with line numbers |
| 8382 |
\expandafter\newcommand\csname #1\endcsname[2][0]{% |
| 8383 |
\setlemmarange{##1}% |
| 8384 |
\csname ifno#1yet\endcsname% |
| 8385 |
\csname first#1\endcsname% |
| 8386 |
\fi% |
| 8387 |
\global\csname no#1yetfalse\endcsname% |
| 8388 |
\immediate\write\expandafter\csname |
| 8389 |
#1s\endcsname{\string\nobreak\string\nobreak\checknoteheaders}% |
| 8390 |
\csname literal#1\endcsname{##2}% |
| 8391 |
\csname if#1ssinglepar\endcsname% |
| 8392 |
\csname literal#1\endcsname{\par}% |
| 8393 |
\fi% |
| 8394 |
\resetlemmacounters% |
| 8395 |
} |
| 8396 |
% prose version |
| 8397 |
\expandafter\newcommand\csname prose#1\endcsname[3][0]{% |
| 8398 |
\unskip\proselinelabel{##2}% |
| 8399 |
\setproselemmarange{##2}{##1}% |
| 8400 |
\csname ifno#1yet\endcsname% |
| 8401 |
\csname first#1\endcsname% |
| 8402 |
\fi% |
| 8403 |
\global\csname no#1yetfalse\endcsname% |
| 8404 |
\immediate\write\expandafter\csname #1s\endcsname{\checkprosenoteheaders}% |
| 8405 |
\csname literal#1\endcsname{##3}% |
| 8406 |
\csname if#1ssinglepar\endcsname% |
| 8407 |
\csname literal#1\endcsname{\par}% |
| 8408 |
\unskip% |
| 8409 |
\fi% |
| 8410 |
\resetlemmacounters\unskip% |
| 8411 |
} |
| 8412 |
% pm version |
| 8413 |
\expandafter\newcommand\csname pm#1\endcsname[2][0]{% |
| 8414 |
\setpmlemmarange{##1}% |
| 8415 |
\csname ifno#1yet\endcsname% |
| 8416 |
\csname first#1\endcsname% |
| 8417 |
\fi% |
| 8418 |
\global\csname no#1yetfalse\endcsname% |
| 8419 |
\immediate\write\expandafter\csname #1s\endcsname{\pmchecknoteheaders\string~}% |
| 8420 |
\immediate\write\expandafter\csname #1s\endcsname{\pmciterange}% |
| 8421 |
\csname literal#1\endcsname{##2}% |
| 8422 |
\csname if#1ssinglepar\endcsname% |
| 8423 |
\csname literal#1\endcsname{\par}% |
| 8424 |
\fi% |
| 8425 |
\pmresetlemmacounters\unskip% |
| 8426 |
} |
| 8427 |
% 8. modify the end of the poem environment to reset the first |
| 8428 |
% command per poem boolean (so that the page and title will be set in |
| 8429 |
% the notes section when the first note is called for a poem) |
| 8430 |
% thanks to Heiko Oberdiek |
| 8431 |
\makeatletter |
| 8432 |
\appendtomacro{\endpoem}{\global\expandafter\csname no#1yettrue\endcsname} |
| 8433 |
\makeatother |
| 8434 |
\makeatletter |
| 8435 |
\appendtomacro{\endprosesection}{\global\expandafter\csname no#1yettrue\endcsname} |
| 8436 |
\makeatother |
| 8437 |
\makeatletter |
| 8438 |
\appendtomacro{\endpmsection}{\global\expandafter\csname no#1yettrue\endcsname} |
| 8439 |
\makeatother |
| 8440 |
|
| 8441 |
% 9. command for closing the output file |
| 8442 |
% command for reading in and printing the output file |
| 8443 |
\expandafter\newcommand\csname put#1s\endcsname{ |
| 8444 |
\newpage\hyphenationforsmall |
| 8445 |
\csname if#1stwocol\endcsname% |
| 8446 |
\csname literal#1\endcsname{\end{multicols}}% |
| 8447 |
\fi %\iftwocol |
| 8448 |
\immediate\expandafter\closeout\csname #1s\endcsname |
| 8449 |
\expandafter\input \jobname.#2 |
| 8450 |
\ifpoemcontentson |
| 8451 |
\contentsendnotestitle{#5}{#1notes} |
| 8452 |
\fi |
| 8453 |
} |
| 8454 |
% 10. command for making a marginal mark at a line, giving the page |
| 8455 |
% number in the apparatus where a note is to be found |
| 8456 |
\expandafter\newcommand\csname margref#1\endcsname{% |
| 8457 |
\addtocounter{margrefnumber}{1} |
| 8458 |
\immediate\write\expandafter\csname #1s\endcsname{\makemargreflabel}% |
| 8459 |
\setmargref |
| 8460 |
} |
| 8461 |
} |
| 8462 |
% \end{macrocode} |
| 8463 |
% \end{macro} |
| 8464 |
% \subsection{~Prose sections}\textsf{poemscol} calls on |
| 8465 |
% \textsf{lineno} to do all the heavy lifting for making line numbers |
| 8466 |
% in prose sections and for making endnotes of various kinds for prose |
| 8467 |
% sections. First, set up a counter for the line number and for the |
| 8468 |
% modulo line number for prose sections, and set it to equal that used |
| 8469 |
% in verse sections. Then set the font for marginal line numbers to |
| 8470 |
% the size used in marginal line numbers in verse sections. |
| 8471 |
% \begin{macrocode} |
| 8472 |
\newcounter{proselinenumber} |
| 8473 |
\setcounter{proselinenumber}{1} |
| 8474 |
\newcounter{prosemodulo} |
| 8475 |
\setcounter{prosemodulo}{\value{lineindexrepeat}} |
| 8476 |
\addtocounter{prosemodulo}{1} |
| 8477 |
\newcommand{\setprosemodulo}[1]{\modulolinenumbers[#1]} |
| 8478 |
% \end{macrocode} |
| 8479 |
% Then commands for setting titles of prose sections. These are just |
| 8480 |
% versions of |\poemtitle|. Fancier versions will follow if there is |
| 8481 |
% need. |
| 8482 |
% \begin{macrocode} |
| 8483 |
\newcommand{\prosesectiontitle}[1]{\poemtitle{#1}} |
| 8484 |
\newcommand{\prosesectiontitlenotitle}[1]{\poemtitlenotitle{#1}} |
| 8485 |
% \end{macrocode} |
| 8486 |
% Next, environments for prose sections. The environment resets (or |
| 8487 |
% doesn't, in the second case) the marginal line number. The |
| 8488 |
% default modulo line number is that prevailing in verse sections, |
| 8489 |
% but you can change it at will. |
| 8490 |
% \begin{macrocode} |
| 8491 |
\setcounter{prosemodulo}{\value{lineindexrepeat}}% |
| 8492 |
\addtocounter{prosemodulo}{1}% |
| 8493 |
\ifx\modulolinenumbers\undefined% |
| 8494 |
\relax\else |
| 8495 |
\modulolinenumbers[\value{prosemodulo}]% if lineno is called |
| 8496 |
\fi |
| 8497 |
\newif\ifinprosesection |
| 8498 |
\newenvironment{prosesection} |
| 8499 |
{\inprosesectiontrue\resetlinenumber\begin{linenumbers}% |
| 8500 |
\renewcommand{\linenumberfont}{\scriptsize}% |
| 8501 |
\ifnumbersright\rightlinenumbers*\setlength{\linenumbersep}{-\marginparsep}% |
| 8502 |
%\else\ifnumbersswitch\switchlinenumbers\setlength{\linenumbersep}{\marginparsep}% |
| 8503 |
\else\ifnumbersswitch\rightlinenumbers*\setlength{\linenumbersep}{-\marginparsep}% |
| 8504 |
\else\leftlinenumbers*\setlength{\linenumbersep}{\marginparsep}% |
| 8505 |
\addtolength{\linenumbersep}{5pt}% seems about right |
| 8506 |
\fi\fi |
| 8507 |
\noemendyettrue% |
| 8508 |
\noexplainyettrue% |
| 8509 |
} |
| 8510 |
{\end{linenumbers}\inprosesectionfalse} |
| 8511 |
\newenvironment{prosesectionnoreset} |
| 8512 |
{\begin{linenumbers}% |
| 8513 |
\renewcommand{\linenumberfont}{\scriptsize} |
| 8514 |
\ifnumbersright\rightlinenumbers*\setlength{\linenumbersep}{-\marginparsep}% |
| 8515 |
%\else\ifnumbersswitch\switchlinenumbers\setlength{\linenumbersep}{\marginparsep}% |
| 8516 |
\else\ifnumbersswitch\rightlinenumbers*\setlength{\linenumbersep}{-\marginparsep}% |
| 8517 |
\else\leftlinenumbers*\setlength{\linenumbersep}{\marginparsep}% |
| 8518 |
\addtolength{\linenumbersep}{5pt}% seems about right |
| 8519 |
\fi\fi |
| 8520 |
% \noemendyettrue% |
| 8521 |
% \noexplainyettrue% |
| 8522 |
}{\end{linenumbers}} |
| 8523 |
% \end{macrocode} |
| 8524 |
% |
| 8525 |
% Set up commands for notes sections. |
| 8526 |
% \begin{macro}{\setproselemmastart} |
| 8527 |
% Finds the line number at the beginning of a lemma. Thanks to Robin |
| 8528 |
% Fairbairns and Heiko Oberdiek for |\ifrefundefined|. |
| 8529 |
% Fairbairns version |
| 8530 |
% \begin{macrocode} |
| 8531 |
% \newcommand*\ifrefundefined[1] {% |
| 8532 |
% Ê Ê\expandafter\ifx\csname r@#1\endcsname\relax |
| 8533 |
% } |
| 8534 |
% Oberdiek version |
| 8535 |
\makeatletter |
| 8536 |
\newcommand*{\ifrefundefined}[1]{% |
| 8537 |
\expandafter\ifx\csname r@#1\endcsname\relax |
| 8538 |
\expandafter\@firstoftwo |
| 8539 |
\else |
| 8540 |
\expandafter\@secondoftwo |
| 8541 |
\fi |
| 8542 |
} |
| 8543 |
\newcommand*{\@extract@ref}[2]{% |
| 8544 |
\expandafter\expandafter\expandafter#1\csname |
| 8545 |
r@#2\endcsname{}{}\@nil |
| 8546 |
} |
| 8547 |
|
| 8548 |
\newcommand*{\@extractref}{% |
| 8549 |
\@extract@ref\@car |
| 8550 |
} |
| 8551 |
|
| 8552 |
\newcommand*{\@extractpageref}{% |
| 8553 |
\@extract@ref\@secondcar |
| 8554 |
} |
| 8555 |
|
| 8556 |
\long\def\@secondcar#1#2#3\@nil{#2} |
| 8557 |
|
| 8558 |
\newcommand*{\setcounterfromref}[2]{% |
| 8559 |
\ifrefundefined{#2}{% |
| 8560 |
\protect\G@refundefinedtrue |
| 8561 |
\@latex@warning{Reference `#2' on page \thepage \space |
| 8562 |
undefined}% |
| 8563 |
\setcounter{#1}{0}% |
| 8564 |
}{% |
| 8565 |
\setcounter{#1}{\@extractref{#2}}% |
| 8566 |
}% |
| 8567 |
} |
| 8568 |
\newcommand*{\setcounterfrompageref}[2]{% |
| 8569 |
\ifrefundefined{#2}{% |
| 8570 |
\protect\G@refundefinedtrue |
| 8571 |
\@latex@warning{Reference `#2' on page \thepage \space |
| 8572 |
undefined}% |
| 8573 |
\setcounter{#1}{0}% |
| 8574 |
}{% |
| 8575 |
\setcounter{#1}{\@extractpageref{#2}}% |
| 8576 |
}% |
| 8577 |
} |
| 8578 |
% |
| 8579 |
\makeatother |
| 8580 |
\newcommand{\setproselemmastart}[1]{% |
| 8581 |
\unskip |
| 8582 |
\setcounterfromref{proselinenumber}{#1}} |
| 8583 |
% \end{macrocode} |
| 8584 |
% \end{macro} |
| 8585 |
% \begin{macro}{\setproselemmarange} |
| 8586 |
% Finds the end of a multi-line lemma. |
| 8587 |
% \begin{macrocode} |
| 8588 |
% \newcommand{\setproselemmarange}[2]{% |
| 8589 |
% \setproselemmastart{#1}% |
| 8590 |
% \setcounter{lemmalines}{#2}% |
| 8591 |
% \ifthenelse{\equal{\value{lemmalines}}{0}}{\rangelemmafalse}{\rangelemmatrue}% |
| 8592 |
% \setcounter{lemmaend}{\theproselinenumber}% |
| 8593 |
% \addtocounter{lemmaend}{\thelemmalines}\unskip% |
| 8594 |
% } |
| 8595 |
\newcommand{\setproselemmarange}[2]{% |
| 8596 |
\setproselemmastart{#1}% |
| 8597 |
\pmccheckifinteger{#2}% |
| 8598 |
\ifinteger |
| 8599 |
\setcounter{lemmalines}{#2}% |
| 8600 |
\ifthenelse{\equal{\value{lemmalines}}{0}}{\rangelemmafalse}{\rangelemmatrue}% |
| 8601 |
\setcounter{lemmaend}{\theproselinenumber}% |
| 8602 |
\addtocounter{lemmaend}{\thelemmalines}\unskip% |
| 8603 |
\else |
| 8604 |
% \ref{#2} |
| 8605 |
\setcounterfromref{lemmaend}{#2}\rangelemmatrue |
| 8606 |
\fi\unskip |
| 8607 |
} |
| 8608 |
% \end{macrocode} |
| 8609 |
% \end{macro} |
| 8610 |
% \begin{macro}{\proseciterange} |
| 8611 |
% Sets the range note for in a multi-line lemma. |
| 8612 |
% \begin{macrocode} |
| 8613 |
\newcommand{\proseciterange}{% |
| 8614 |
\ifrangelemma% |
| 8615 |
\theproselinenumber --\thelemmaend% |
| 8616 |
\else% |
| 8617 |
\theproselinenumber% |
| 8618 |
\fi} |
| 8619 |
% \end{macrocode} |
| 8620 |
% \end{macro} |
| 8621 |
% \begin{macro}{\checkprosenoteheaders} |
| 8622 |
% Updates running header for note sections. Typesets line number in |
| 8623 |
% notes. |
| 8624 |
% \begin{macrocode} |
| 8625 |
\newcommand{\checkprosenoteheaders}{\string\setcounter\string{notepageholdernote\string}% |
| 8626 |
\string{\thepage\string}\string\ifhmode\string\unskip\string\fi |
| 8627 |
\string\ifthenelse\string{\string\value\string{notepageholdernote\string}> |
| 8628 |
\string\value\string{notepageholdertitle\string}\string}% |
| 8629 |
\string{\string\mark\string{\string\thenotepageholdernote\string}\string}% |
| 8630 |
\string{\string\mark\string{\string\thenotepageholdertitle\string}\string}\string\unskip |
| 8631 |
\string\unskip\string\relax\ \proseciterange :\string~\string\nolinebreak}% |
| 8632 |
% \end{macrocode} |
| 8633 |
% \end{macro} |
| 8634 |
% \begin{macro}{\prosetextnote} |
| 8635 |
% \begin{macrocode} |
| 8636 |
\newcommand{\proselinelabel}[1]{\ifhmode\unskip\fi\linelabel{#1}} |
| 8637 |
\newcommand{\prosetextnote}[3][0]{% |
| 8638 |
\iftextnoteson% |
| 8639 |
\unskip\proselinelabel{#2}% |
| 8640 |
\setproselemmarange{#2}{#1}% |
| 8641 |
\immediate\write\textnotes{\checkprosenoteheaders}% |
| 8642 |
\literaltextnote{#3}% |
| 8643 |
\iftextnotessinglepar% |
| 8644 |
\literaltextnote{\par}% |
| 8645 |
\fi% |
| 8646 |
\resetlemmacounters% |
| 8647 |
\fi\unskip% |
| 8648 |
} |
| 8649 |
% \end{macrocode} |
| 8650 |
% \end{macro} |
| 8651 |
% \begin{macro}{\proseemendation} |
| 8652 |
% Notice that it calls |\firstemendation| as usual. |
| 8653 |
% \begin{macrocode} |
| 8654 |
\newcommand{\proseemendation}[3][0]{% |
| 8655 |
\ifemendationson% |
| 8656 |
\unskip\proselinelabel{#2}% |
| 8657 |
\setproselemmarange{#2}{#1}% |
| 8658 |
\ifredundantemendations |
| 8659 |
\iftextnoteson |
| 8660 |
\ifrangelemma |
| 8661 |
\prosetextnote[#1]{#2}{#3}% |
| 8662 |
\else |
| 8663 |
\prosetextnote{#2}{#3}% |
| 8664 |
\fi % ifrangelemma} |
| 8665 |
\fi %iftextnoteson |
| 8666 |
\iftextnotessinglepar% |
| 8667 |
\literaltextnote{\par}% |
| 8668 |
\fi% iftextnotessinglepar |
| 8669 |
\fi % ifredundantemendations |
| 8670 |
\ifnoemendyet % firstemendation |
| 8671 |
\firstemendation |
| 8672 |
\fi%noemendyet |
| 8673 |
\global\noemendyetfalse |
| 8674 |
\immediate\write\emendations{\checkprosenoteheaders}% |
| 8675 |
\literalemend{#3}% |
| 8676 |
\ifemendationssinglepar% |
| 8677 |
\literalemend{\par}% |
| 8678 |
\fi% ifemendationssinglep |
| 8679 |
\resetlemmacounters% |
| 8680 |
\fi\unskip% |
| 8681 |
} |
| 8682 |
% \end{macrocode} |
| 8683 |
% \end{macro} |
| 8684 |
% \begin{macro}{\proseexplanatory} |
| 8685 |
% \begin{macrocode} |
| 8686 |
\newcommand{\proseexplanatory}[3][0]{% |
| 8687 |
\ifexplanon% |
| 8688 |
\unskip\proselinelabel{#2}% |
| 8689 |
\setproselemmarange{#2}{#1}% |
| 8690 |
\ifnoexplainyet% firstexplanation |
| 8691 |
\firstexplanatory% |
| 8692 |
\fi%noexplainyet |
| 8693 |
\global\noexplainyetfalse% |
| 8694 |
\immediate\write\explanations{\checkprosenoteheaders}% |
| 8695 |
\literalexplain{#3}% |
| 8696 |
\ifexplanationssinglepar% |
| 8697 |
\literalexplain{\par}% |
| 8698 |
\fi% ifexplanationssinglepar |
| 8699 |
\resetlemmacounters% |
| 8700 |
\fi\unskip% |
| 8701 |
} |
| 8702 |
% \end{macrocode} |
| 8703 |
% \end{macro} |
| 8704 |
% \begin{macro}{\proseaccidental} |
| 8705 |
% \begin{macrocode} |
| 8706 |
\newcommand{\proseaccidental}[2]{ |
| 8707 |
\iftextnoteson |
| 8708 |
\ifincludeaccidentals |
| 8709 |
\immediate\write\textnotes{\string\nobreak}% |
| 8710 |
\prosetextnote{#1}{#2}% |
| 8711 |
\immediate\write\textnotes{\string\nobreak}% |
| 8712 |
\iftextnotessinglepar% |
| 8713 |
\literaltextnote{\par}% |
| 8714 |
\fi% |
| 8715 |
\fi\fi |
| 8716 |
} |
| 8717 |
\newcommand{\prosetsvariant}[3][0]{\iftextnoteson |
| 8718 |
\ifincludetypescripts |
| 8719 |
\immediate\write |
| 8720 |
\textnotes{\string\nobreak}% |
| 8721 |
\prosetextnote[#1]{#2}{#3}% |
| 8722 |
\immediate\write\textnotes{\string\nobreak}% |
| 8723 |
\iftextnotessinglepar% |
| 8724 |
\literaltextnote{\par}% |
| 8725 |
\fi% |
| 8726 |
\fi\fi |
| 8727 |
} |
| 8728 |
\newcommand{\prosetsaccidental}[2]{\iftextnoteson |
| 8729 |
\ifincludetypescripts\proseaccidental{#1}{#2}\fi\fi} |
| 8730 |
% \end{macrocode} |
| 8731 |
% \end{macro} |
| 8732 |
% \subsection{~Annotation by Sentence and Paragraph Number} |
| 8733 |
% Marking sentences. First, some |\if|s, token lists, and counters. |
| 8734 |
% \begin{macrocode} |
| 8735 |
\newif{\ifprosebysentence} |
| 8736 |
\newif{\ifrunningsentencenumbers}\runningsentencenumberstrue |
| 8737 |
\newif{\ifmarginsentencenumbers}\marginsentencenumberstrue |
| 8738 |
\newif{\ifsuppressfirstpara}\suppressfirstparafalse |
| 8739 |
\newif{\ifsuppressfirstsentence}\suppressfirstsentencefalse |
| 8740 |
|
| 8741 |
\newtoks{\pmnoteheader} |
| 8742 |
|
| 8743 |
\newcounter{pmsentencenumber}\setcounter{pmsentencenumber}{0} |
| 8744 |
\newcounter{pmmodulo}\setcounter{pmmodulo}{3} |
| 8745 |
\newcounter{pmindexcount}\setcounter{pmindexcount}{0} |
| 8746 |
% \end{macrocode} |
| 8747 |
% A starter. Mostly a placeholder. For changes to a whole section. |
| 8748 |
% \begin{macrocode} |
| 8749 |
\newcommand{\setprosebysentence}{\prosebysentencetrue% |
| 8750 |
} |
| 8751 |
\newenvironment{pmsection}{ |
| 8752 |
\noemendyettrue% |
| 8753 |
\noexplainyettrue% |
| 8754 |
}{} |
| 8755 |
% \end{macrocode} |
| 8756 |
% Formatting for sentence numbers in the running text and in the |
| 8757 |
% margin. \label{runningsentencenumberformat} |
| 8758 |
% \begin{macrocode} |
| 8759 |
\newcommand{\runningsentencenumberformat}[1]{\nobreak% |
| 8760 |
\ifsuppressfirstsentence% |
| 8761 |
\ifthenelse{\thepmsentencenumber=1}{\relax}{% |
| 8762 |
\unskip\textsuperscript{\scriptsize{#1}}}% |
| 8763 |
\unskip\nobreak% |
| 8764 |
\else% |
| 8765 |
\textsuperscript{\scriptsize{#1}}%\fi |
| 8766 |
\unskip\nobreak} |
| 8767 |
\newcommand{\marginsentencenumberformat}[1]{\scriptsize{#1}} |
| 8768 |
\newcommand{\setpmmodulo}[1]{\setcounter{pmmodulo}{#1}% |
| 8769 |
\addtocounter{pmmodulo}{-1}% |
| 8770 |
} |
| 8771 |
\newcommand{\pmnumberstoleft}{%\catcode`\@=11% |
| 8772 |
\numbersswitchfalse\numbersrightfalse% |
| 8773 |
\setlength{\marginparsep}{18pt}% |
| 8774 |
} |
| 8775 |
\newcommand{\pmnumberstoright}{%\catcode`\@=11% |
| 8776 |
\numbersswitchfalse\numbersrighttrue% |
| 8777 |
\setlength{\marginparsep}{-18pt} |
| 8778 |
% \setlength{\marginparsep}{18pt} |
| 8779 |
} |
| 8780 |
\newcommand{\pmnumbersswitch}{\strictpagechecktrue\numbersswitchtrue\numbersrightfalse% |
| 8781 |
\setlength{\marginparsep}{18pt}% |
| 8782 |
} |
| 8783 |
\newcommand{\pmnumbersgutter}{%\catcode`\@=11% |
| 8784 |
\pmnumbersswitch% |
| 8785 |
\pmclreversesideparfalse\numbersguttertrue% |
| 8786 |
\setlength{\marginparsep}{18pt}% |
| 8787 |
} |
| 8788 |
\newcommand{\pmnumbersouter}{%\catcode`\@=11% |
| 8789 |
\pmnumbersswitch% |
| 8790 |
\pmclreversesidepartrue\numbersgutterfalse% |
| 8791 |
\setlength{\marginparsep}{18pt}% |
| 8792 |
} |
| 8793 |
% \end{macrocode} |
| 8794 |
% Macros for actually writing the numbers in the margin. |
| 8795 |
% \begin{macrocode} |
| 8796 |
\newcommand{\putpmsentencenumber}{% |
| 8797 |
\ifsuppressfirstsentence% |
| 8798 |
\ifthenelse{\thepmsentencenumber=1}{\relax}{\putpmmarginnumber{\thepmsentencenumber}% |
| 8799 |
{\marginsentencenumberformat}}% |
| 8800 |
\else% |
| 8801 |
\putpmmarginnumber{\thepmsentencenumber}% |
| 8802 |
{\marginsentencenumberformat}% |
| 8803 |
\fi} |
| 8804 |
\newcommand{\putpmmarginnumber}[2]{% |
| 8805 |
\nolinebreak\begin{marginenvironment}% |
| 8806 |
\nolinebreak% |
| 8807 |
\ifnumbersswitch%\marginpar{\hfil #2{#1}} |
| 8808 |
\pmclsidepar{\hfil #2{#1}}% |
| 8809 |
\else% |
| 8810 |
\ifnumbersright%\marginpar{\hfil #2{#1}} |
| 8811 |
\pmclrightsidepar{\hfil #2{#1}}% |
| 8812 |
\else% \marginpar{#2{#1}\hfil} |
| 8813 |
\pmclleftsidepar |
| 8814 |
{#2{#1}\hfil}% |
| 8815 |
\fi% |
| 8816 |
\fi% |
| 8817 |
\nolinebreak% |
| 8818 |
\end{marginenvironment}\nolinebreak% |
| 8819 |
} |
| 8820 |
% \end{macrocode} |
| 8821 |
% \begin{macro}{\pmsentence} |
| 8822 |
% Put this before every sentence. (This is the opposite of the |
| 8823 |
% convention in verse sections, where |\verseline| is at the end of |
| 8824 |
% each line. |
| 8825 |
% \begin{macrocode} |
| 8826 |
\newcommand{\pmsentence}{% |
| 8827 |
% increment sentence number at beginning of sentence |
| 8828 |
\addtocounter{pmsentencenumber}{1}% |
| 8829 |
\ifrunningsentencenumbers% add running number |
| 8830 |
\runningsentencenumberformat{\thepmsentencenumber}% |
| 8831 |
\fi% |
| 8832 |
\ifmarginsentencenumbers% add marginal number |
| 8833 |
\addtocounter{pmindexcount}{1}% |
| 8834 |
\leavevmode% |
| 8835 |
\ifthenelse{\value{pmindexcount}>\value{pmmodulo}}% |
| 8836 |
{\putpmsentencenumber\nobreak% |
| 8837 |
\setcounter{pmindexcount}{0}% |
| 8838 |
}{\relax}% |
| 8839 |
\fi% |
| 8840 |
% create header for notes if any are to occur |
| 8841 |
\ifpmparas% |
| 8842 |
\global\edef\noteheaderconcat{\thepmparagraph:\thepmsentencenumber}% |
| 8843 |
\pmnoteheader=\expandafter{\noteheaderconcat}% |
| 8844 |
\else% |
| 8845 |
%\global\edef\noteheaderconcat{\thepmsentencenumber:}% |
| 8846 |
\global\edef\noteheaderconcat{\thepmsentencenumber} |
| 8847 |
\pmnoteheader=\expandafter{\noteheaderconcat}% |
| 8848 |
\fi% |
| 8849 |
} |
| 8850 |
% \end{macrocode} |
| 8851 |
% \end{macro} |
| 8852 |
% \begin{macro}{\pmsentencetwo} |
| 8853 |
% Kludge for the second sentence in a line. |
| 8854 |
% \begin{macrocode} |
| 8855 |
\newcommand{\pmsentencetwo}{% |
| 8856 |
% increment sentence number at beginning of sentence |
| 8857 |
\addtocounter{pmsentencenumber}{1}% |
| 8858 |
\ifrunningsentencenumbers% add running number |
| 8859 |
\runningsentencenumberformat{\thepmsentencenumber}% |
| 8860 |
\fi% |
| 8861 |
\ifmarginsentencenumbers% add marginal number |
| 8862 |
\addtocounter{pmindexcount}{1}% |
| 8863 |
\leavevmode% |
| 8864 |
\ifthenelse{\value{pmindexcount}>\value{pmmodulo}}% |
| 8865 |
{ \putpmsentencenumbertwo\nobreak% |
| 8866 |
\setcounter{pmindexcount}{0}% |
| 8867 |
}{\relax}% |
| 8868 |
% \ifnum\thepmindexcount>\thepmmodulo% |
| 8869 |
% \putpmsentencenumbertwo\nobreak% |
| 8870 |
% \setcounter{pmindexcount}{0}% |
| 8871 |
% \fi% |
| 8872 |
\fi% |
| 8873 |
% create header for notes if any are to occur |
| 8874 |
\ifpmparas% |
| 8875 |
\global\edef\noteheaderconcat{\thepmparagraph:\thepmsentencenumber}% |
| 8876 |
\pmnoteheader=\expandafter{\noteheaderconcat}% |
| 8877 |
\else% |
| 8878 |
\global\edef\noteheaderconcat{\thepmsentencenumber}% |
| 8879 |
\pmnoteheader=\expandafter{\noteheaderconcat}% |
| 8880 |
\fi% |
| 8881 |
} |
| 8882 |
|
| 8883 |
\newcommand{\putpmsentencenumbertwo}{% |
| 8884 |
\putpmmarginnumber{\rlap{\phantom{1},~\thepmsentencenumber}}% |
| 8885 |
{\marginsentencenumberformat}} |
| 8886 |
% \end{macrocode} |
| 8887 |
% \end{macro} |
| 8888 |
% \begin{macro}{\pmsentencethree} |
| 8889 |
% Kludge for the third sentence in a line. |
| 8890 |
% \begin{macrocode} |
| 8891 |
\newcommand{\pmsentencethree}{% |
| 8892 |
% increment sentence number at beginning of sentence |
| 8893 |
\addtocounter{pmsentencenumber}{1}% |
| 8894 |
\ifrunningsentencenumbers% add running number |
| 8895 |
\runningsentencenumberformat{\thepmsentencenumber}% |
| 8896 |
\fi% |
| 8897 |
\ifmarginsentencenumbers% add marginal number |
| 8898 |
\addtocounter{pmindexcount}{1}% |
| 8899 |
\leavevmode% |
| 8900 |
\ifthenelse{\value{pmindexcount}>\value{pmmodulo}}% |
| 8901 |
{ \putpmsentencenumberthree\nobreak% |
| 8902 |
\setcounter{pmindexcount}{0}% |
| 8903 |
}{\relax}% |
| 8904 |
% \ifnum\thepmindexcount>\thepmmodulo% |
| 8905 |
% \putpmsentencenumberthree\nobreak% |
| 8906 |
% \setcounter{pmindexcount}{0}% |
| 8907 |
% \fi% |
| 8908 |
\fi% |
| 8909 |
% create header for notes if any are to occur |
| 8910 |
\ifpmparas% |
| 8911 |
\global\edef\noteheaderconcat{\thepmparagraph:\thepmsentencenumber}% |
| 8912 |
\pmnoteheader=\expandafter{\noteheaderconcat}% |
| 8913 |
\else% |
| 8914 |
\global\edef\noteheaderconcat{\thepmsentencenumber}% |
| 8915 |
\pmnoteheader=\expandafter{\noteheaderconcat}% |
| 8916 |
\fi% |
| 8917 |
} |
| 8918 |
|
| 8919 |
\newcommand{\putpmsentencenumberthree}{% |
| 8920 |
\putpmmarginnumber{\rlap{\phantom{1,~2},~\thepmsentencenumber}}% |
| 8921 |
{\marginsentencenumberformat}} |
| 8922 |
% \end{macrocode} |
| 8923 |
% \end{macro} |
| 8924 |
% \begin{macro}{\pmsentencefour} |
| 8925 |
% \begin{macrocode} |
| 8926 |
\newcommand{\pmsentencefour}{% |
| 8927 |
% increment sentence number at beginning of sentence |
| 8928 |
\addtocounter{pmsentencenumber}{1}% |
| 8929 |
\ifrunningsentencenumbers% add running number |
| 8930 |
\runningsentencenumberformat{\thepmsentencenumber}% |
| 8931 |
\fi% |
| 8932 |
\ifmarginsentencenumbers% add marginal number |
| 8933 |
\addtocounter{pmindexcount}{1}% |
| 8934 |
\leavevmode% |
| 8935 |
\ifthenelse{\value{pmindexcount}>\value{pmmodulo}}% |
| 8936 |
{ \putpmsentencenumberfour\nobreak% |
| 8937 |
\setcounter{pmindexcount}{0}% |
| 8938 |
}{\relax}% |
| 8939 |
\fi% |
| 8940 |
% create header for notes if any are to occur |
| 8941 |
\ifpmparas% |
| 8942 |
\global\edef\noteheaderconcat{\thepmparagraph:\thepmsentencenumber}% |
| 8943 |
\pmnoteheader=\expandafter{\noteheaderconcat}% |
| 8944 |
\else% |
| 8945 |
\global\edef\noteheaderconcat{\thepmsentencenumber}% |
| 8946 |
\pmnoteheader=\expandafter{\noteheaderconcat}% |
| 8947 |
\fi% |
| 8948 |
} |
| 8949 |
|
| 8950 |
\newcommand{\putpmsentencenumberfour}{% |
| 8951 |
\putpmmarginnumber{\rlap{\phantom{1,~2,~3},~\thepmsentencenumber}}% |
| 8952 |
{\marginsentencenumberformat}} |
| 8953 |
|
| 8954 |
% \end{macrocode} |
| 8955 |
% \end{macro} |
| 8956 |
% Macros for numbering paragraphs |
| 8957 |
% \begin{macrocode} |
| 8958 |
\newcounter{pmparagraph} |
| 8959 |
\setcounter{pmparagraph}{0} |
| 8960 |
\newif{\ifpmparas}\pmparasfalse |
| 8961 |
\newif{\ifpmparainmar}\pmparainmartrue |
| 8962 |
\newif{\ifpmpararunning}\pmpararunningfalse |
| 8963 |
\newif{\ifpmsentencebypara}% reset sentence counter every paragraph |
| 8964 |
\pmsentencebyparatrue |
| 8965 |
% \end{macrocode} |
| 8966 |
% Formatting marginal and running paragraph numbers, printing them. \label{pmparrunningformat} |
| 8967 |
% \begin{macrocode} |
| 8968 |
\newcommand{\pmparmarformat}[1]{\textbf{{\small #1}}} |
| 8969 |
\newcommand{\pmpararunningformat}[1]{% |
| 8970 |
\ifsuppressfirstpara% |
| 8971 |
\ifthenelse{\thepmparagraph=1}{\relax}{\textbf{\small #1}~}% |
| 8972 |
\else% |
| 8973 |
\textbf{\small #1}~% |
| 8974 |
\fi} |
| 8975 |
\newcommand{\putpmmarparanumber}{% |
| 8976 |
\ifsuppressfirstpara% |
| 8977 |
\ifthenelse{\thepmparagraph=1}{\relax}{\putpmmarginnumber{\llap{\thepmparagraph~~}} |
| 8978 |
{\pmparmarformat}}% |
| 8979 |
\else% |
| 8980 |
\putpmmarginnumber{\llap{\thepmparagraph~~}}{\pmparmarformat}% |
| 8981 |
\fi} |
| 8982 |
|
| 8983 |
% \end{macrocode} |
| 8984 |
% \begin{macro}{\pmpara} |
| 8985 |
% Mark the beginning of each paragraph with |\pmpara| |
| 8986 |
% \begin{macrocode} |
| 8987 |
\newcommand{\pmpara}{\leavevmode% |
| 8988 |
\pmparastrue\addtocounter{pmparagraph}{1}% |
| 8989 |
\ifpmparainmar% put in marginal paragraph number |
| 8990 |
\putpmmarparanumber |
| 8991 |
\fi |
| 8992 |
\ifpmpararunning% put in running number |
| 8993 |
\pmpararunningformat{\thepmparagraph}% |
| 8994 |
\fi |
| 8995 |
\ifpmsentencebypara% reset sentence counter |
| 8996 |
\setcounter{pmsentencenumber}{0}% |
| 8997 |
\setcounter{pmindexcount}{0}% |
| 8998 |
\fi} |
| 8999 |
% \end{macrocode} |
| 9000 |
% \end{macro} |
| 9001 |
% \begin{macro}{\sentencelabel} |
| 9002 |
% Makes a label either by sentence number or by paragraph and |
| 9003 |
% sentence number, for use by |\ref| and by the various notes commands. |
| 9004 |
% \begin{macrocode} |
| 9005 |
\makeatletter |
| 9006 |
\def\sentencelabel#1{\@bsphack% |
| 9007 |
\ifpmparas% |
| 9008 |
\protected@write\@auxout{}% |
| 9009 |
{\string\newlabel{#1}{{\thepmparagraph :\thepmsentencenumber}{\thepage}}}% |
| 9010 |
\else% |
| 9011 |
\protected@write\@auxout{}% |
| 9012 |
{\string\newlabel{#1}{{\thepmsentencenumber}{\thepage}}}% |
| 9013 |
\fi% |
| 9014 |
\@esphack% |
| 9015 |
} |
| 9016 |
\makeatother |
| 9017 |
% \end{macrocode} |
| 9018 |
% \end{macro} |
| 9019 |
% Macros to set up endnote commands for paragraph and sentence |
| 9020 |
% annotation. |
| 9021 |
% \begin{macrocode} |
| 9022 |
\newtoks{\pmrangeend} % for notes that refer to ranges |
| 9023 |
% setting the range for the lemma: |
| 9024 |
\newcommand{\setpmlemmarange}[1]{% |
| 9025 |
\pmccheckifinteger{#1}% |
| 9026 |
\ifinteger% |
| 9027 |
\setcounter{lemmalines}{#1}% |
| 9028 |
\ifthenelse{\equal{\value{lemmalines}}{0}}{\rangelemmafalse}{\rangelemmatrue}% |
| 9029 |
\setcounter{lemmaend}{\thepmsentencenumber}% |
| 9030 |
\addtocounter{lemmaend}{\thelemmalines}% |
| 9031 |
\pmrangeend={\thelemmaend}% |
| 9032 |
\else% |
| 9033 |
\pmrangeend={\ref{#1}}\rangelemmatrue% |
| 9034 |
\fi% |
| 9035 |
} |
| 9036 |
% Setting the string to include ranges in notes: |
| 9037 |
\newcommand{\pmciterange}{% |
| 9038 |
\ifrangelemma{\the\pmnoteheader --\the\pmrangeend:}% |
| 9039 |
\else% |
| 9040 |
\the\pmnoteheader:% |
| 9041 |
\fi} |
| 9042 |
% For running headers |
| 9043 |
\newcommand{\pmchecknoteheaders}{\string\setcounter\string{notepageholdernote\string}% |
| 9044 |
\string{\thepage\string}\string\ifhmode\string\unskip\string\fi |
| 9045 |
\string\ifthenelse\string{\string\value\string{notepageholdernote\string}> |
| 9046 |
\string\value\string{notepageholdertitle\string}\string}% |
| 9047 |
\string{\string\mark\string{\string\thenotepageholdernote\string}\string}% |
| 9048 |
\string{\string\mark\string{\string\thenotepageholdertitle\string}\string}\string\unskip} |
| 9049 |
% to reset lemma counters at end of note |
| 9050 |
\newcommand{\pmresetlemmacounters}{\rangelemmafalse% |
| 9051 |
\setcounter{lemmalines}{0}% |
| 9052 |
\setcounter{lemmaend}{0}% |
| 9053 |
\pmrangeend={\relax}% |
| 9054 |
} |
| 9055 |
% \end{macrocode} |
| 9056 |
% \begin{macro}{\pmtextnote} |
| 9057 |
% \begin{macrocode} |
| 9058 |
\newcommand{\pmtextnote}[2][0]{% |
| 9059 |
\iftextnoteson% |
| 9060 |
\setpmlemmarange{#1}% |
| 9061 |
\immediate\write\textnotes{\pmchecknoteheaders\string~}% |
| 9062 |
\immediate\write\textnotes{\pmciterange}% |
| 9063 |
\literaltextnote{#2}% |
| 9064 |
\iftextnotessinglepar% |
| 9065 |
\literaltextnote{\par}% |
| 9066 |
\fi% |
| 9067 |
\fi% |
| 9068 |
\pmresetlemmacounters% |
| 9069 |
\unskip} |
| 9070 |
% \end{macrocode} |
| 9071 |
% \end{macro} |
| 9072 |
% \begin{macro}{\pmexplanatory} |
| 9073 |
% \begin{macrocode} |
| 9074 |
\newcommand{\pmexplanatory}[2][0]{% |
| 9075 |
\ifexplanon% |
| 9076 |
\setpmlemmarange{#1}% |
| 9077 |
\ifnoexplainyet % first explanation |
| 9078 |
\firstexplanatory% |
| 9079 |
\fi %noexplainyet |
| 9080 |
\global\noexplainyetfalse% |
| 9081 |
\immediate\write\explanations{\pmchecknoteheaders\string~}% |
| 9082 |
\immediate\write\explanations{\pmciterange}% |
| 9083 |
\literalexplain{#2}% |
| 9084 |
\ifexplanationssinglepar% |
| 9085 |
\literalexplain{\par}% |
| 9086 |
\fi %ifexplanationssinglepar |
| 9087 |
\fi % ifexplanon |
| 9088 |
\pmresetlemmacounters% |
| 9089 |
\unskip% |
| 9090 |
} |
| 9091 |
% \end{macrocode} |
| 9092 |
% \end{macro} |
| 9093 |
% \begin{macro}{\pmemendation} |
| 9094 |
% \begin{macrocode} |
| 9095 |
\newcommand{\pmemendation}[2][0]{% |
| 9096 |
\ifemendationson% |
| 9097 |
\setpmlemmarange{#1}% |
| 9098 |
\ifredundantemendations% |
| 9099 |
\iftextnoteson% |
| 9100 |
\ifrangelemma% |
| 9101 |
\pmtextnote[#1]{#2}% |
| 9102 |
\else% |
| 9103 |
\pmtextnote{#2}% |
| 9104 |
\fi % ifrangelemma} |
| 9105 |
\fi %iftextnoteson |
| 9106 |
\fi % ifredundantemendations |
| 9107 |
\ifnoemendyet % firstemendation |
| 9108 |
\firstemendation% |
| 9109 |
\fi %noemendyet |
| 9110 |
\global\noemendyetfalse% |
| 9111 |
\immediate\write\emendations{\pmchecknoteheaders\string~}% |
| 9112 |
\immediate\write\emendations{\pmciterange}% |
| 9113 |
\literalemend{#2}% |
| 9114 |
\ifemendationssinglepar% |
| 9115 |
\literalemend{\par}% |
| 9116 |
\fi% ifemendationssinglepar |
| 9117 |
\fi % ifemendationson |
| 9118 |
\pmresetlemmacounters% |
| 9119 |
} |
| 9120 |
% \end{macrocode} |
| 9121 |
% \end{macro} |
| 9122 |
% \begin{macro}{\pmaccidental} |
| 9123 |
% \begin{macrocode} |
| 9124 |
\newcommand{\pmaccidental}[1]{% |
| 9125 |
\iftextnoteson% |
| 9126 |
\ifincludeaccidentals% |
| 9127 |
\immediate\write\textnotes{\string\nobreak}% |
| 9128 |
\pmtextnote{#1}% |
| 9129 |
\immediate\write\textnotes{\string\nobreak}% |
| 9130 |
\iftextnotessinglepar% |
| 9131 |
\literaltextnote{\par}% |
| 9132 |
\fi% |
| 9133 |
\fi\fi% |
| 9134 |
} |
| 9135 |
% \end{macrocode} |
| 9136 |
% \end{macro} |
| 9137 |
% \begin{macro}{\pmtsvariant} |
| 9138 |
% \begin{macrocode} |
| 9139 |
\newcommand{\pmtsvariant}[2][0]{\iftextnoteson% |
| 9140 |
\ifincludetypescripts% |
| 9141 |
\immediate\write\textnotes{\string\nobreak}% |
| 9142 |
\pmtextnote[#1]{#2}% |
| 9143 |
\immediate\write\textnotes{\string\nobreak}% |
| 9144 |
\iftextnotessinglepar% |
| 9145 |
\literaltextnote{\par}% |
| 9146 |
\fi% |
| 9147 |
\fi\fi% |
| 9148 |
} |
| 9149 |
\newcommand{\pmtsaccidental}[1]{\iftextnoteson\ifincludetypescripts\pmaccidental{#1}\fi\fi} |
| 9150 |
% \end{macrocode} |
| 9151 |
% \end{macro} |
| 9152 |
%\subsection{~Using Footnotes} |\texnotesatfoot| has to redefine |
| 9153 |
% |\sources| and a few others as well. |
| 9154 |
% \begin{macro}{\textnotesatfoot} |
| 9155 |
% \begin{macrocode} |
| 9156 |
\newcommand{\textnotesatfoot}{% first redefine textnotes |
| 9157 |
\global\textnotesontrue% |
| 9158 |
\global\textnotesatendfalse% |
| 9159 |
\ifsourcesfootnotespara% |
| 9160 |
\DeclareNewFootnote[para]{A}% |
| 9161 |
\else% |
| 9162 |
\DeclareNewFootnote[plain]{A}% |
| 9163 |
\fi% |
| 9164 |
\iftextfootnotespara% |
| 9165 |
\DeclareNewFootnote[para]{B}% |
| 9166 |
\else% |
| 9167 |
\DeclareNewFootnote[plain]{B}% |
| 9168 |
\fi% |
| 9169 |
\renewcommand{\textnote}[2][0]{\setlemmarange{##1}% |
| 9170 |
\FootnotetextB{\relax}{\citerange:~##2}% |
| 9171 |
\resetlemmacounters}% |
| 9172 |
% then redefine sources |
| 9173 |
\renewcommand{\sources}[1]{\FootnotetextA{\relax}{##1}}% |
| 9174 |
% then prose textnote |
| 9175 |
\renewcommand{\prosetextnote}[3][0]{% |
| 9176 |
\unskip\proselinelabel{##2}% |
| 9177 |
\setproselemmarange{##2}{##1}% |
| 9178 |
\FootnotetextB{\relax}{\proseciterange:~##3}\resetlemmacounters}% |
| 9179 |
% then pmtextnote |
| 9180 |
\renewcommand{\pmtextnote}[2][0]{\setpmlemmarange{##1}% |
| 9181 |
\FootnotetextB{\relax}{\pmciterange~##2}\pmresetlemmacounters} |
| 9182 |
} |
| 9183 |
% \end{macrocode} |
| 9184 |
% \end{macro} |
| 9185 |
% \begin{macro}{\emendationsatfoot} |
| 9186 |
% \begin{macrocode} |
| 9187 |
\newcommand{\emendationsatfoot}{% |
| 9188 |
\global\emendationsontrue% |
| 9189 |
\global\emendationsatendfalse% |
| 9190 |
\ifemendationfootnotespara% |
| 9191 |
\DeclareNewFootnote[para]{C}% |
| 9192 |
\else% |
| 9193 |
\DeclareNewFootnote[plain]{C}% |
| 9194 |
\fi% |
| 9195 |
\renewcommand{\emendation}[2][0]{\setlemmarange{##1}% |
| 9196 |
\FootnotetextC{\relax}{\citerange:~##2}% |
| 9197 |
\resetlemmacounters}% |
| 9198 |
\renewcommand{\proseemendation}[3][0]{\unskip\proselinelabel{##2}% |
| 9199 |
\setproselemmarange{##2}{##1}% |
| 9200 |
\FootnotetextC{\relax}{\proseciterange:~##3}\resetlemmacounters}% |
| 9201 |
\renewcommand{\pmemendation}[2][0]{\setpmlemmarange{##1}% |
| 9202 |
\FootnotetextC{\relax}{\pmciterange~##2}\pmresetlemmacounters} |
| 9203 |
} |
| 9204 |
% \end{macrocode} |
| 9205 |
% \end{macro} |
| 9206 |
% \begin{macro}{\explanationsatfoot} |
| 9207 |
% \begin{macrocode} |
| 9208 |
\newcommand{\explanationsatfoot}{% |
| 9209 |
\global\explanontrue% |
| 9210 |
\global\explanatendfalse% |
| 9211 |
\ifexplanfootnotespara% |
| 9212 |
\DeclareNewFootnote[para]{D}% |
| 9213 |
\else% |
| 9214 |
\DeclareNewFootnote[plain]{D}% |
| 9215 |
\fi% |
| 9216 |
\renewcommand{\explanatory}[2][0]{\setlemmarange{##1}% |
| 9217 |
\FootnotetextD{\relax}{\citerange:~##2}% |
| 9218 |
\resetlemmacounters}% |
| 9219 |
\renewcommand{\proseexplanatory}[3][0]{\unskip\proselinelabel{##2}% |
| 9220 |
\setproselemmarange{##2}{##1}% |
| 9221 |
\FootnotetextD{\relax}{\proseciterange:~##3}} |
| 9222 |
\renewcommand{\pmexplanatory}[2][0]{\setpmlemmarange{##1}% |
| 9223 |
\FootnotetextD{\relax}{\pmciterange~##2}\pmresetlemmacounters}% |
| 9224 |
} |
| 9225 |
% \end{macrocode} |
| 9226 |
% \end{macro} |
| 9227 |
% \begin{macro}{\bibleverse} |
| 9228 |
% \begin{macrocode} |
| 9229 |
\newcommand{\bibleverse}{\pmsentence} |
| 9230 |
\newcommand{\biblechapter}{\pmpara} |
| 9231 |
% \end{macrocode} |
| 9232 |
% \end{macro} |
| 9233 |
% |
| 9234 |
% \subsection{~Notes at the foot of individual poems} |
| 9235 |
% |
| 9236 |
% \begin{macro}{\poemendnote} |
| 9237 |
% \begin{macrocode} |
| 9238 |
\newif\ifpoemendnoteson |
| 9239 |
\poemendnotesontrue |
| 9240 |
\newif\ifpoemendnotessinglepar |
| 9241 |
\poemendnotessinglepartrue |
| 9242 |
\newcommand{\makepoemendnotes}{ |
| 9243 |
\global\verselinenumberstrue |
| 9244 |
\newwrite\poemendnotes |
| 9245 |
\immediate\openout\poemendnotes=\jobname.pnd |
| 9246 |
\literalpoemendnote{\bigskip} |
| 9247 |
} |
| 9248 |
\newcommand{\poemendnote}[2][0]{% |
| 9249 |
\ifpoemendnoteson |
| 9250 |
\setlemmarange{#1}% |
| 9251 |
\immediate\write\poemendnotes{\checknoteheaders} |
| 9252 |
\literalpoemendnote{#2}% |
| 9253 |
\ifpoemendnotessinglepar% |
| 9254 |
\literalpoemendnote{\par}% |
| 9255 |
\fi% |
| 9256 |
\fi |
| 9257 |
\resetlemmacounters |
| 9258 |
} |
| 9259 |
\newcommand{\literalpoemendnote}[1]{% |
| 9260 |
\begingroup |
| 9261 |
\def\next{#1}% |
| 9262 |
\newlinechar='40 |
| 9263 |
\immediate\write\poemendnotes{\expandafter\strip\meaning\next}% |
| 9264 |
\endgroup |
| 9265 |
} |
| 9266 |
\newcommand{\putpoemendnotes}{ |
| 9267 |
\ifpoemendnoteson |
| 9268 |
\immediate\closeout\poemendnotes |
| 9269 |
\input \jobname.pnd |
| 9270 |
\else |
| 9271 |
\relax |
| 9272 |
\fi} |
| 9273 |
% \begin{macro}{\poemendemendationnote} |
| 9274 |
% \begin{macrocode} |
| 9275 |
\newif\ifpoemendemendationnoteson |
| 9276 |
\poemendemendationnotesontrue |
| 9277 |
\newif\ifpoemendemendationnotessinglepar |
| 9278 |
\poemendemendationnotessinglepartrue |
| 9279 |
\newcommand{\makepoemendemendationnotes}{ |
| 9280 |
\global\verselinenumberstrue |
| 9281 |
\newwrite\poemendemendationnotes |
| 9282 |
\immediate\openout\poemendemendationnotes=\jobname.pmd |
| 9283 |
\literalpoemendemendationnote{\bigskip} |
| 9284 |
} |
| 9285 |
\newcommand{\poemendemendationnote}[2][0]{% |
| 9286 |
\ifpoemendemendationnoteson |
| 9287 |
\setlemmarange{#1}% |
| 9288 |
\immediate\write\poemendemendationnotes{\checknoteheaders} |
| 9289 |
\literalpoemendemendationnote{#2}% |
| 9290 |
\ifpoemendemendationnotessinglepar% |
| 9291 |
\literalpoemendemendationnote{\par}% |
| 9292 |
\fi% |
| 9293 |
\fi |
| 9294 |
\resetlemmacounters |
| 9295 |
} |
| 9296 |
\newcommand{\literalpoemendemendationnote}[1]{% |
| 9297 |
\begingroup |
| 9298 |
\def\next{#1}% |
| 9299 |
\newlinechar='40 |
| 9300 |
\immediate\write\poemendemendationnotes{\expandafter\strip\meaning\next}% |
| 9301 |
\endgroup |
| 9302 |
} |
| 9303 |
\newcommand{\putpoemendemendationnotes}{ |
| 9304 |
\ifpoemendemendationnoteson |
| 9305 |
\immediate\closeout\poemendemendationnotes |
| 9306 |
\input \jobname.pmd |
| 9307 |
\else |
| 9308 |
\relax |
| 9309 |
\fi} |
| 9310 |
% \end{macrocode} |
| 9311 |
% \end{macro} |
| 9312 |
% \begin{macro}{\poemendexplanatorynote} |
| 9313 |
% \begin{macrocode} |
| 9314 |
\newif\ifpoemendexplanatorynoteson |
| 9315 |
\poemendexplanatorynotesontrue |
| 9316 |
\newif\ifpoemendexplanatorynotessinglepar |
| 9317 |
\poemendexplanatorynotessinglepartrue |
| 9318 |
\newcommand{\makepoemendexplanatorynotes}{ |
| 9319 |
\global\verselinenumberstrue |
| 9320 |
\newwrite\poemendexplanatorynotes |
| 9321 |
\immediate\openout\poemendexplanatorynotes=\jobname.pxd |
| 9322 |
\literalpoemendexplanatorynote{\bigskip} |
| 9323 |
} |
| 9324 |
\newcommand{\poemendexplanatorynote}[2][0]{% |
| 9325 |
\ifpoemendexplanatorynoteson |
| 9326 |
\setlemmarange{#1}% |
| 9327 |
\immediate\write\poemendexplanatorynotes{\checknoteheaders} |
| 9328 |
\literalpoemendexplanatorynote{#2}% |
| 9329 |
\ifpoemendexplanatorynotessinglepar% |
| 9330 |
\literalpoemendexplanatorynote{\par}% |
| 9331 |
\fi% |
| 9332 |
\fi |
| 9333 |
\resetlemmacounters |
| 9334 |
} |
| 9335 |
\newcommand{\literalpoemendexplanatorynote}[1]{% |
| 9336 |
\begingroup |
| 9337 |
\def\next{#1}% |
| 9338 |
\newlinechar='40 |
| 9339 |
\immediate\write\poemendexplanatorynotes{\expandafter\strip\meaning\next}% |
| 9340 |
\endgroup |
| 9341 |
} |
| 9342 |
\newcommand{\putpoemendexplanatorynotes}{ |
| 9343 |
\ifpoemendexplanatorynoteson |
| 9344 |
\immediate\closeout\poemendexplanatorynotes |
| 9345 |
\input \jobname.pxd |
| 9346 |
\else |
| 9347 |
\relax |
| 9348 |
\fi} |
| 9349 |
% \end{macrocode} |
| 9350 |
% \end{macro} |
| 9351 |
% \begin{macro}{\poemendtextnote} |
| 9352 |
% \begin{macrocode} |
| 9353 |
\newif\ifpoemendtextnoteson |
| 9354 |
\poemendtextnotesontrue |
| 9355 |
\newif\ifpoemendtextnotessinglepar |
| 9356 |
\poemendtextnotessinglepartrue |
| 9357 |
\newcommand{\makepoemendtextnotes}{ |
| 9358 |
\global\verselinenumberstrue |
| 9359 |
\newwrite\poemendtextnotes |
| 9360 |
\immediate\openout\poemendtextnotes=\jobname.pmd |
| 9361 |
\literalpoemendtextnote{\bigskip} |
| 9362 |
} |
| 9363 |
\newcommand{\poemendtextnote}[2][0]{% |
| 9364 |
\ifpoemendtextnoteson |
| 9365 |
\setlemmarange{#1}% |
| 9366 |
\immediate\write\poemendtextnotes{\checknoteheaders} |
| 9367 |
\literalpoemendtextnote{#2}% |
| 9368 |
\ifpoemendtextnotessinglepar% |
| 9369 |
\literalpoemendtextnote{\par}% |
| 9370 |
\fi% |
| 9371 |
\fi |
| 9372 |
\resetlemmacounters |
| 9373 |
} |
| 9374 |
\newcommand{\literalpoemendtextnote}[1]{% |
| 9375 |
\begingroup |
| 9376 |
\def\next{#1}% |
| 9377 |
\newlinechar='40 |
| 9378 |
\immediate\write\poemendtextnotes{\expandafter\strip\meaning\next}% |
| 9379 |
\endgroup |
| 9380 |
} |
| 9381 |
\newcommand{\putpoemendtextnotes}{ |
| 9382 |
\ifpoemendtextnoteson |
| 9383 |
\immediate\closeout\poemendtextnotes |
| 9384 |
\input \jobname.pmd |
| 9385 |
\else |
| 9386 |
\relax |
| 9387 |
\fi} |
| 9388 |
% \end{macrocode} |
| 9389 |
% \end{macro} |
| 9390 |
% \subsection{~Embarrassing kludges} Because the dirty trick |
| 9391 |
% mentioned above writes out textnotes as a ribbon one word wide, |
| 9392 |
% quoted poetry in the notes sections will leave a blank line at the |
| 9393 |
% end, which will be interpreted as a paragraph break when the file is |
| 9394 |
% read back in by \LaTeX. These kludges correct that problem. |
| 9395 |
% \begin{macrocode} |
| 9396 |
\newcommand{\quotedversecorrectiontextnote}[1][0pt] |
| 9397 |
{\iftextnoteson% |
| 9398 |
\immediate\write\textnotes{\string\noindent\string\kern-#1}% |
| 9399 |
\fi} |
| 9400 |
\newcommand{\quotedversecorrectionemendation}[1][0pt] |
| 9401 |
{\ifemendationson% |
| 9402 |
\immediate\write\emendations{\string\noindent\string\kern-#1}% |
| 9403 |
\fi} |
| 9404 |
\newcommand{\quotedversecorrectionexplanatory}[1][0pt] |
| 9405 |
{\ifexplanon% |
| 9406 |
\immediate\write\explanations{\string\noindent\string\kern-#1}% |
| 9407 |
\fi} |
| 9408 |
% \end{macrocode} |
| 9409 |
% \subsection{~Marking stanza breaks on page turns} Use the macro |
| 9410 |
% below to change the symbol used to mark cases in which there is or is |
| 9411 |
% not a stanza break at a page turn. |
| 9412 |
% \begin{macrocode} |
| 9413 |
\newcommand{\stanzaatbottom}[1]{\global\edef\stanzaatbottomvalue{#1}} |
| 9414 |
\stanzaatbottom{*} |
| 9415 |
\newcommand{\nostanzaatbottom}[1]{\global\edef\nostanzaatbottomvalue{#1}} |
| 9416 |
\nostanzaatbottom{\relax} |
| 9417 |
% \end{macrocode} |
| 9418 |
% \subsection{~Parallel Texts} |
| 9419 |
% First, three utility macros from the memoir class: |
| 9420 |
% \begin{macro}{\cleartorecto} |
| 9421 |
% A repeat of |\cleardoublepage|; clears to a recto (odd-numbered) page. |
| 9422 |
% \begin{macrocode} |
| 9423 |
\def\cleartorecto{\clearpage\if@twoside \ifodd\c@page\else |
| 9424 |
\hbox{}\thispagestyle{empty}% |
| 9425 |
\newpage\if@twocolumn\hbox{}\newpage\fi\fi\fi} |
| 9426 |
% \end{macrocode} |
| 9427 |
% \end{macro} |
| 9428 |
% |
| 9429 |
% \begin{macro}{\cleartoverso} |
| 9430 |
% Clears to a verso (even-numbered) page. |
| 9431 |
% \begin{macrocode} |
| 9432 |
\def\cleartoverso{\clearpage\if@twoside |
| 9433 |
\ifodd\c@page\hbox{}\thispagestyle{empty}% |
| 9434 |
\newpage\if@twocolumn\hbox{}\newpage\fi\fi\fi} |
| 9435 |
% \end{macrocode} |
| 9436 |
% \end{macro} |
| 9437 |
% |
| 9438 |
% |
| 9439 |
% \begin{macro}{\ifenv} |
| 9440 |
% Macro for testing whether one is in a particular environment. |
| 9441 |
% \begin{macrocode} |
| 9442 |
\makeatletter |
| 9443 |
\def\ifenv#1{% |
| 9444 |
\def\reserved@a{#1}% |
| 9445 |
\ifx\reserved@a\@currenvir |
| 9446 |
\expandafter\@firstoftwo |
| 9447 |
\else |
| 9448 |
\expandafter\@secondoftwo |
| 9449 |
\fi |
| 9450 |
} |
| 9451 |
\makeatother |
| 9452 |
% \end{macrocode} |
| 9453 |
% \end{macro} |
| 9454 |
% Macros for forcing the marginal line numbers to the left side or |
| 9455 |
% the right side. These marginal line numbers, unlike those made with |
| 9456 |
% |\marginpar|, do not float. This code is modeled after code from |
| 9457 |
% the memoir class, by Peter Wilson. |
| 9458 |
% |
| 9459 |
% \begin{macro}{\pmclleftsidepar} |
| 9460 |
% As in the memoir class, these sidepars do not float. |
| 9461 |
% \begin{macrocode} |
| 9462 |
\newdimen\pmclsavsk |
| 9463 |
\newcount\pmclsavsf |
| 9464 |
\def\pmclbsphack{% |
| 9465 |
\relax |
| 9466 |
\ifhmode |
| 9467 |
\pmclsavsk\lastskip |
| 9468 |
\pmclsavsf\spacefactor |
| 9469 |
\fi} |
| 9470 |
\def\pmclesphack{% |
| 9471 |
\relax |
| 9472 |
\ifhmode |
| 9473 |
\spacefactor\pmclsavsf |
| 9474 |
\ifdim\pmclsavsk>0pt |
| 9475 |
\ignorespaces |
| 9476 |
\fi |
| 9477 |
\fi} |
| 9478 |
% \newcommand{\pmclleftsidepar}[1]{% |
| 9479 |
% \pmclbsphack\leavevmode\vadjust{% |
| 9480 |
% \rlap{\kern-\parindent% |
| 9481 |
% \kern -\marginparsep \kern -\marginparwidth % at left |
| 9482 |
% \vbox to 0pt{% |
| 9483 |
% \kern \pmclsideparvshift% % vertical shift to align top text lines |
| 9484 |
% \begin{minipage}{\marginparwidth}% |
| 9485 |
% #1% |
| 9486 |
% \end{minipage}% |
| 9487 |
% \vss}}}\pmclesphack% |
| 9488 |
% } % version 2.44 |
| 9489 |
\newcommand{\pmclleftsidepar}[1]{% |
| 9490 |
\pmclbsphack\strut\vadjust{% changed |
| 9491 |
\rlap{\kern-\parindent% |
| 9492 |
\kern -\marginparsep \kern -\marginparwidth% at left |
| 9493 |
% \vbox to 0pt{% |
| 9494 |
% \kern \pmclsideparvshift% % vertical shift to align top text lines |
| 9495 |
% \begin{minipage}{\marginparwidth}% |
| 9496 |
\setbox0=\vtop to 0pt{% added |
| 9497 |
\begin{minipage}[t]{\marginparwidth}% added |
| 9498 |
#1% |
| 9499 |
\end{minipage}% |
| 9500 |
% \vss}}}\pmclesphack% |
| 9501 |
\vss}% changed |
| 9502 |
\vtop to 0pt{\kern\pmclsideparvshift % default should be 0pt |
| 9503 |
\kern-\dp\strutbox \kern-\ht0 \box0 \vss}}}\pmclesphack}% changed |
| 9504 |
|
| 9505 |
\newcommand{\pmclrightsidepar}[1]{% |
| 9506 |
% \pmclbsphack\leavevmode\vadjust{% |
| 9507 |
\pmclbsphack\strut\vadjust{% |
| 9508 |
\rlap{\kern-\parindent% |
| 9509 |
% \kern \textwidth \kern -\marginparsep % at right |
| 9510 |
\kern\textwidth\kern\marginparsep% at right |
| 9511 |
% \vbox to 0pt{% |
| 9512 |
% \kern \pmclsideparvshift% % vertical shift to align top text lines |
| 9513 |
% \begin{minipage}{\marginparwidth}% |
| 9514 |
\setbox0=\vtop to 0pt{% added |
| 9515 |
\begin{minipage}[t]{\marginparwidth}% added |
| 9516 |
#1% |
| 9517 |
\end{minipage}% |
| 9518 |
% \vss}}}\pmclesphack% |
| 9519 |
\vss}% changed |
| 9520 |
\vtop to 0pt{\kern\pmclsideparvshift% default should be 0pt |
| 9521 |
\kern-\dp\strutbox \kern-\ht0 \box0 \vss}}}\pmclesphack}% changed |
| 9522 |
|
| 9523 |
% \end{macrocode} |
| 9524 |
% \end{macro} |
| 9525 |
|
| 9526 |
% Booleans for parallel texts |
| 9527 |
% \begin{macrocode} |
| 9528 |
\newif\ifparalleltexts |
| 9529 |
\paralleltextsfalse |
| 9530 |
\newif\ifrecto |
| 9531 |
\rectofalse |
| 9532 |
\newif\ifverso |
| 9533 |
\versofalse |
| 9534 |
% \end{macrocode} |
| 9535 |
% Booleans are needed to describe situations in which poems and stanzas |
| 9536 |
% are left open at the page break. |\finishrectopage| and |
| 9537 |
% |\finishversopage| will close poems and stanzas (so as not to |
| 9538 |
% generate errors because of environments left open), although as far |
| 9539 |
% as the poem is concerned the stanza or poem may still be open. (I |
| 9540 |
% will say that the stanza or poem in such a case is ``artificially |
| 9541 |
% closed.'') There are two of them for each case of artificial closure. |
| 9542 |
% The first boolean (for each stanza or poem artificially closed) |
| 9543 |
% must reflect whether the stanza or poem has been (artificially) |
| 9544 |
% closed, to reopen on the next page of the same kind (recto or verso). |
| 9545 |
% If a poem or stanza has been (artificially) closed, the |\mark| will |
| 9546 |
% not be changed (so that it will still reflect whether the reader |
| 9547 |
% should understand there to be a stanza break at the bottom of the |
| 9548 |
% page or not). The second boolean for each case of artificial closure |
| 9549 |
% reflects whether the |\mark| has been changed or not. |
| 9550 |
% \begin{macrocode} |
| 9551 |
\newif\ifrectopoempending |
| 9552 |
\rectopoempendingfalse |
| 9553 |
\newif\ifversopoempending |
| 9554 |
\versopoempendingfalse |
| 9555 |
\newif\ifrectostanzapending |
| 9556 |
\rectostanzapendingfalse |
| 9557 |
\newif\ifversostanzapending |
| 9558 |
\versostanzapendingfalse |
| 9559 |
\newif\ifrectostanzastillopen |
| 9560 |
\rectostanzastillopenfalse |
| 9561 |
\newif\ifversostanzastillopen |
| 9562 |
\versostanzastillopenfalse |
| 9563 |
\newif\ifrectopoemstillopen |
| 9564 |
\rectopoemstillopenfalse |
| 9565 |
\newif\ifversopoemstillopen |
| 9566 |
\versopoemstillopenfalse |
| 9567 |
% the same for prose sections |
| 9568 |
\newif\ifrectoprosesectionpending |
| 9569 |
\rectoprosesectionpendingfalse |
| 9570 |
\newif\ifversoprosesectionpending |
| 9571 |
\versoprosesectionpendingfalse |
| 9572 |
\newif\ifrectoprosesectionstillopen |
| 9573 |
\rectoprosesectionstillopenfalse |
| 9574 |
\newif\ifversoprosesectionstillopen |
| 9575 |
\versoprosesectionstillopenfalse |
| 9576 |
% the same for quoted verse |
| 9577 |
\newif\ifrectoquotedversepending |
| 9578 |
\rectoquotedversependingfalse |
| 9579 |
\newif\ifversoquotedversepending |
| 9580 |
\versoquotedversependingfalse |
| 9581 |
\newif\ifrectoquotedversestillopen |
| 9582 |
\rectoquotedversestillopenfalse |
| 9583 |
\newif\ifversoquotedversestillopen |
| 9584 |
\versoquotedversestillopenfalse |
| 9585 |
% \end{macrocode} |
| 9586 |
% A further set of booleans is required for emendations and |
| 9587 |
% explanatory notes. Again the idea is that if a poem is artificially |
| 9588 |
% closed, but has already had its first emendation or explanatory note |
| 9589 |
% written to the external notes files, \textsf{poemscol} will remember that |
| 9590 |
% the next emendation or explanatory note it sees is not the first one |
| 9591 |
% for that poem and thus won't set the heading information for that |
| 9592 |
% poem in the notes section all over again. |
| 9593 |
% \begin{macrocode} |
| 9594 |
\newif\ifrectoemendationspending |
| 9595 |
\rectoemendationspendingfalse |
| 9596 |
\newif\ifversoemendationspending |
| 9597 |
\versoemendationspendingfalse |
| 9598 |
\newif\ifrectoexplanationspending |
| 9599 |
\rectoexplanationspendingfalse |
| 9600 |
\newif\ifversoexplanationspending |
| 9601 |
\versoexplanationspendingfalse |
| 9602 |
% \end{macrocode} |
| 9603 |
% Counters for parallel texts: New counters are needed, not only for the recto and verso lines, but |
| 9604 |
% also for the scratch value which determines whether or not it is time to |
| 9605 |
% output a marginal line number. These are saved at the end of every |
| 9606 |
% page, and restored at the beginning of every page of the same kind. |
| 9607 |
% \begin{macrocode} |
| 9608 |
\newcounter{rectolinecounter} |
| 9609 |
\setcounter{rectolinecounter}{1} |
| 9610 |
\newcounter{rectoindexscratch} |
| 9611 |
\setcounter{rectoindexscratch}{1} |
| 9612 |
\newcounter{versolinecounter} |
| 9613 |
\setcounter{versolinecounter}{1} |
| 9614 |
\newcounter{versoindexscratch} |
| 9615 |
\setcounter{versoindexscratch}{1} |
| 9616 |
% \end{macrocode} |
| 9617 |
% \begin{macro}{\startparalleltexts} |
| 9618 |
% Clears to a verso (even-numbered) page, fixes where to put line |
| 9619 |
% numbers, modifies poem and stanza environments, changes where |
| 9620 |
% marginal line numbers are set, sets the booleans. \label{startparalleltexts} |
| 9621 |
% \begin{macrocode} |
| 9622 |
\newcommand{\startparalleltexts}{% |
| 9623 |
\leavevmode |
| 9624 |
\cleartoverso |
| 9625 |
\paralleltextstrue |
| 9626 |
\renewenvironment{poem}{\raggedright |
| 9627 |
\language=255%no hyphenation in verse |
| 9628 |
\noemendyettrue |
| 9629 |
\noexplainyettrue |
| 9630 |
\setcounter{verselinenumber}{0}\setcounter{printlineindex}{0} |
| 9631 |
\nobreak\begin{pmclverse} |
| 9632 |
\inpoemtrue\nobreak\mark{\relax}} |
| 9633 |
% must end poem if parallel text. Don't worry, |
| 9634 |
% begin recto page and begin verso page will |
| 9635 |
% reopen the poem and reset the line counter to the right value |
| 9636 |
% if it was finish recto page or finish verso page |
| 9637 |
% that closed the poem rather than your own declaration. |
| 9638 |
{\ifversopoemstillopen |
| 9639 |
\end{pmclverse} |
| 9640 |
\inpoemfalse\mark{\relax} |
| 9641 |
\else |
| 9642 |
\ifrectopoemstillopen |
| 9643 |
\end{pmclverse} |
| 9644 |
\inpoemfalse\mark{\relax} |
| 9645 |
\else |
| 9646 |
\end{pmclverse} |
| 9647 |
\inpoemfalse\mark{\relax} |
| 9648 |
\goodbreak\afterpoemskip%\bigskip |
| 9649 |
\fi\fi } |
| 9650 |
\renewenvironment{stanza}{\penalty-100\instanzatrue\mark{\nostanzaatbottomvalue\ }} |
| 9651 |
% must end stanza if parallel text. Don't worry, |
| 9652 |
% begin recto page and begin verso page will |
| 9653 |
% reopen the stanza and reset the line counter to the right value |
| 9654 |
% if it was finish recto page or finish verso page |
| 9655 |
% that closed the stanza rather than your own declaration. |
| 9656 |
{\ifversostanzastillopen |
| 9657 |
\relax |
| 9658 |
\else |
| 9659 |
\ifrectostanzastillopen |
| 9660 |
\relax |
| 9661 |
\else |
| 9662 |
\nobreak\mark{\stanzaatbottomvalue\ }\nobreak |
| 9663 |
\ifspeciallinelock% |
| 9664 |
\relax\else% |
| 9665 |
\nolinebreak\incrementverselinenumber% |
| 9666 |
\fi% |
| 9667 |
\speciallinelockfalse% |
| 9668 |
\nobreak |
| 9669 |
\instanzafalse |
| 9670 |
|
| 9671 |
\stanzaskip |
| 9672 |
\fi\fi |
| 9673 |
} |
| 9674 |
\renewcommand{\putverselinenumber}{\nolinebreak\begin{marginenvironment}% |
| 9675 |
\nolinebreak |
| 9676 |
% \marn{\hfil\textrm{\theverselinenumber}} |
| 9677 |
% \marginpar{\hfil\textrm{\scriptsize\theverselinenumber}} |
| 9678 |
\pmclleftsidepar{\textrm{\scriptsize\theverselinenumber}}% |
| 9679 |
\nolinebreak |
| 9680 |
\end{marginenvironment}% |
| 9681 |
\nolinebreak |
| 9682 |
} |
| 9683 |
} |
| 9684 |
\newenvironment{parallelverse}{\startparalleltexts} |
| 9685 |
{\finishparalleltexts} |
| 9686 |
\newtoks{\versotitleholder} |
| 9687 |
\newtoks{\rectotitleholder} |
| 9688 |
\newcommand{\makeversotitleholder}[1]{% |
| 9689 |
\versotitleholder={#1}% |
| 9690 |
} |
| 9691 |
\newcommand{\makerectotitleholder}[1]{% |
| 9692 |
\rectotitleholder={#1}% |
| 9693 |
} |
| 9694 |
% \end{macrocode} |
| 9695 |
% \end{macro} |
| 9696 |
% \begin{macro}{\versopoemtitle} |
| 9697 |
% \begin{macrocode} |
| 9698 |
\makeatletter |
| 9699 |
\newcommand{\versopoemtitle}[1]{% |
| 9700 |
\versoset@p@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}% |
| 9701 |
{\poemtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\z@}% |
| 9702 |
\c@ntentsinfo{#1}{\contentsindentone}{\contentspoemtitlefont}% |
| 9703 |
{\contentsindenttwoamount}% |
| 9704 |
} |
| 9705 |
\newcommand{\versoset@p@emtitle}[6]{\pmclversoresetsettitleinnotes% |
| 9706 |
\setlength{\titleentryoverrun}{#6}% |
| 9707 |
{#2}% |
| 9708 |
{#3 \begin{titleentryenvironment}% |
| 9709 |
{\ifcentertitleson\begin{center}#1\end{center}\else #4 #1\fi}% |
| 9710 |
\end{titleentryenvironment}}% |
| 9711 |
{#5}% |
| 9712 |
\m@kep@emlabel |
| 9713 |
\versom@ken@teholder{#1}% |
| 9714 |
\setlength{\titleentryoverrun}{\z@}} |
| 9715 |
\newcommand{\versom@ken@teholder}[1]{% |
| 9716 |
\ifsinglelinetitle |
| 9717 |
\versotitleholder={#1}% |
| 9718 |
\global\edef\@compoundlabelscratch{poem\thepoemnumber}% |
| 9719 |
\else\iftitlefirstline |
| 9720 |
\versotitleholder={#1}% |
| 9721 |
\global\edef\@compoundlabelscratch{poem\thepoemnumber}% |
| 9722 |
\else\iftitlemiddleline |
| 9723 |
\titlesofar=\versotitleholder |
| 9724 |
\titleincrement={~#1}% |
| 9725 |
\global\edef\titleconcat{\the\titlesofar \the\titleincrement}% |
| 9726 |
\versotitleholder=\expandafter{\titleconcat}% |
| 9727 |
\global\edef\@compoundlabelscratch{poem\thepoemnumber}% |
| 9728 |
\else |
| 9729 |
\titlesofar=\versotitleholder |
| 9730 |
\titleincrement={~#1}% |
| 9731 |
\global\edef\titleconcat{\the\titlesofar \the\titleincrement}% |
| 9732 |
\versotitleholder=\expandafter{\titleconcat}% |
| 9733 |
\global\edef\@compoundlabelscratch{poem\thepoemnumber}% |
| 9734 |
\fi |
| 9735 |
\fi |
| 9736 |
\fi |
| 9737 |
} |
| 9738 |
\newcommand{\versotitletoothernotes}{\string\par |
| 9739 |
\ifputpagenumberinnotes% |
| 9740 |
\string\argpageref\string{\@compoundlabelscratch\string}% |
| 9741 |
\string\setcounterfrompageref\string{notepageholdertitle\string}% |
| 9742 |
\string{\@compoundlabelscratch\string}% |
| 9743 |
\fi% |
| 9744 |
\string\textbf\string{\ \the\versotitleholder\string} |
| 9745 |
}% |
| 9746 |
\newcommand{\versopoemtitlenocontents}[1]{% |
| 9747 |
\versoset@p@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}% |
| 9748 |
{\poemtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\z@}% |
| 9749 |
} |
| 9750 |
\newcommand{\versotitleinnotescheck}{\ifparalleltexts\let\titletoothernotes=\versotitletoothernotes\fi} |
| 9751 |
\makeatother |
| 9752 |
% \end{macrocode} |
| 9753 |
% \end{macro} |
| 9754 |
% \begin{macro}{\rectopoemtitle} |
| 9755 |
% \begin{macrocode} |
| 9756 |
\makeatletter |
| 9757 |
\newcommand{\rectopoemtitle}[1]{% |
| 9758 |
\rectoset@p@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}% |
| 9759 |
{\poemtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\z@}% |
| 9760 |
\c@ntentsinfo{#1}{\contentsindentone}{\contentspoemtitlefont}% |
| 9761 |
{\contentsindenttwoamount}% |
| 9762 |
} |
| 9763 |
\newcommand{\rectoset@p@emtitle}[6]{\pmclrectoresetsettitleinnotes |
| 9764 |
\setlength{\titleentryoverrun}{#6}% |
| 9765 |
{#2}% |
| 9766 |
{#3 \begin{titleentryenvironment}% |
| 9767 |
{\ifcentertitleson\begin{center}#1\end{center}\else #4 #1\fi}% |
| 9768 |
\end{titleentryenvironment}}% |
| 9769 |
{#5}% |
| 9770 |
\m@kep@emlabel |
| 9771 |
\rectom@ken@teholder{#1}% |
| 9772 |
\setlength{\titleentryoverrun}{\z@}} |
| 9773 |
\newcommand{\rectom@ken@teholder}[1]{% |
| 9774 |
\ifsinglelinetitle |
| 9775 |
\rectotitleholder={#1}% |
| 9776 |
\global\edef\@compoundlabelscratch{poem\thepoemnumber}% |
| 9777 |
\else\iftitlefirstline |
| 9778 |
\rectotitleholder={#1}% |
| 9779 |
\global\edef\@compoundlabelscratch{poem\thepoemnumber}% |
| 9780 |
\else\iftitlemiddleline |
| 9781 |
\titlesofar=\rectotitleholder |
| 9782 |
\titleincrement={~#1}% |
| 9783 |
\global\edef\titleconcat{\the\titlesofar \the\titleincrement}% |
| 9784 |
\rectotitleholder=\expandafter{\titleconcat}% |
| 9785 |
\global\edef\@compoundlabelscratch{poem\thepoemnumber}% |
| 9786 |
\else |
| 9787 |
\titlesofar=\rectotitleholder |
| 9788 |
\titleincrement={~#1}% |
| 9789 |
\global\edef\titleconcat{\the\titlesofar \the\titleincrement}% |
| 9790 |
\rectotitleholder=\expandafter{\titleconcat}% |
| 9791 |
\global\edef\@compoundlabelscratch{poem\thepoemnumber}% |
| 9792 |
\fi |
| 9793 |
\fi |
| 9794 |
\fi |
| 9795 |
} |
| 9796 |
\newcommand{\rectotitletoothernotes}{\string\par |
| 9797 |
\ifputpagenumberinnotes% |
| 9798 |
\string\argpageref\string{\@compoundlabelscratch\string}% |
| 9799 |
\string\setcounterfrompageref\string{notepageholdertitle\string}% |
| 9800 |
\string{\@compoundlabelscratch\string}% |
| 9801 |
\fi% |
| 9802 |
\string\textbf\string{\ \the\rectotitleholder\string} |
| 9803 |
}% |
| 9804 |
\newcommand{\rectopoemtitlenocontents}[1]{% |
| 9805 |
\rectoset@p@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}% |
| 9806 |
{\poemtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\z@}% |
| 9807 |
%\c@ntentsinfo{#1}{\contentsindentone}{\contentspoemtitlefont}% |
| 9808 |
%{\contentsindenttwoamount}% |
| 9809 |
%\t@xtnotesinfo{#1}% |
| 9810 |
} |
| 9811 |
\newcommand{\rectotitleinnotescheck}{\ifparalleltexts\let\titletoothernotes=\rectotitletoothernotes\fi} |
| 9812 |
\makeatother |
| 9813 |
% \end{macrocode} |
| 9814 |
% \end{macro} |
| 9815 |
% \begin{macro}{\saveversoline} |
| 9816 |
% Macros for saving and restoring line numbers: |
| 9817 |
% \begin{macrocode} |
| 9818 |
\newcommand{\saveversoline}{\setcounter{versolinecounter}% |
| 9819 |
{\value{verselinenumber}}% |
| 9820 |
\setcounter{versoindexscratch}{\value{printlineindex}}} |
| 9821 |
% \end{macrocode} |
| 9822 |
% \end{macro} |
| 9823 |
% \begin{macro}{\restoreversoline} |
| 9824 |
% \begin{macrocode} |
| 9825 |
\newcommand{\restoreversoline}{\setcounter{verselinenumber}% |
| 9826 |
{\value{versolinecounter}}% |
| 9827 |
\setcounter{printlineindex}{\value{versoindexscratch}}} |
| 9828 |
% \end{macrocode} |
| 9829 |
% \end{macro} |
| 9830 |
% \begin{macro}{\saverectoline} |
| 9831 |
% \begin{macrocode} |
| 9832 |
\newcommand{\saverectoline}{\setcounter{rectolinecounter}% |
| 9833 |
{\value{verselinenumber}}% |
| 9834 |
\setcounter{rectoindexscratch}{\value{printlineindex}}} |
| 9835 |
% \end{macrocode} |
| 9836 |
% \end{macro} |
| 9837 |
% \begin{macro}{\restorerectoline} |
| 9838 |
% \begin{macrocode} |
| 9839 |
\newcommand{\restorerectoline}{\setcounter{verselinenumber}% |
| 9840 |
{\value{rectolinecounter}}% |
| 9841 |
\setcounter{printlineindex}{\value{rectoindexscratch}}} |
| 9842 |
% \end{macrocode} |
| 9843 |
% \end{macro} |
| 9844 |
% Macros for line cross references: |
| 9845 |
% |
| 9846 |
% You will probably want to use line cross references to show which |
| 9847 |
% lines on the recto page correspond to which lines on the verso page. |
| 9848 |
% When you do this, you will set, in the margin of a line on the recto |
| 9849 |
% page, the line number of the corresponding line on the verso side, in |
| 9850 |
% square brackets. You may mark that line number with a distinctive |
| 9851 |
% identifier. |\synchroflag| is a token register to hold that |
| 9852 |
% identifier, and |\setsynchroflag| is a command to put the identifier |
| 9853 |
% in the register. For instance, if you are setting the 1805 version of |
| 9854 |
% Wordsworth's \emph{The Prelude} on the verso, and the 1850 version on |
| 9855 |
% the recto, you might wish to set the ``synchroflag'' to ``1805'' so |
| 9856 |
% that the line cross reference will look something like ``[1805: |
| 9857 |
% 147]''. |
| 9858 |
% \begin{macro}{\setsynchroflag} |
| 9859 |
% \begin{macrocode} |
| 9860 |
\newtoks{\synchroflag} |
| 9861 |
\newcommand{\setsynchroflag}[1]{\synchroflag={#1}} |
| 9862 |
\setsynchroflag{\relax} |
| 9863 |
% \end{macrocode} |
| 9864 |
% \end{macro} |
| 9865 |
% Here are commands for defining and calling ``synchrolabels'', line |
| 9866 |
% cross references that tie verso and recto pages: |
| 9867 |
% \begin{macro}{\synchrolabel} |
| 9868 |
% \begin{macrocode} |
| 9869 |
\newcommand{\synchrolabel}[1]{\poemlinelabel{#1}} |
| 9870 |
\newcommand{\hfilll}{\hskip 0pt plus 1 filll} |
| 9871 |
\newcommand{\synchroref}[1]{% |
| 9872 |
\pmclrightsidepar{{\textrm{\scriptsize[\the\synchroflag\ref{#1}]}}}% |
| 9873 |
% \hfill\rlap{{\textrm{\scriptsize[\the\synchroflag\ref{#1}]}}} |
| 9874 |
% \ifnum\theprintlineindex=\thelineindexrepeat |
| 9875 |
% \hspace{-7pt} |
| 9876 |
% \fi |
| 9877 |
} |
| 9878 |
% \end{macrocode} |
| 9879 |
% \end{macro} |
| 9880 |
% Finally, the |\startversopage|, |\finishversopage|, |\startrectopage| |
| 9881 |
% |\finishrectopage| and |\finishparalleltexts| macros: |
| 9882 |
% \begin{macro}{\startversopage} |
| 9883 |
% \begin{macrocode} |
| 9884 |
\newcommand{\startversopage}{ |
| 9885 |
\ifrectostanzastillopen |
| 9886 |
\end{stanza} |
| 9887 |
\rectostanzastillopenfalse |
| 9888 |
\end{poem} |
| 9889 |
\rectopoemstillopenfalse |
| 9890 |
\fi |
| 9891 |
\ifrectopoemstillopen % from previous page |
| 9892 |
\end{poem} |
| 9893 |
\rectopoemstillopenfalse |
| 9894 |
\fi |
| 9895 |
\ifversopoempending % from previous verso |
| 9896 |
\begin{poem} |
| 9897 |
\global\versopoempendingfalse |
| 9898 |
\fi |
| 9899 |
\ifversostanzapending % from previous verso |
| 9900 |
\begin{stanza} |
| 9901 |
\global\versostanzapendingfalse |
| 9902 |
\fi |
| 9903 |
\ifversoemendationspending |
| 9904 |
\noemendyetfalse |
| 9905 |
\global\versoemendationspendingfalse |
| 9906 |
\fi |
| 9907 |
\ifversoexplanationspending |
| 9908 |
\noexplainyetfalse |
| 9909 |
\global\versoexplanationspendingfalse |
| 9910 |
\fi |
| 9911 |
\rectofalse\versotrue\restoreversoline |
| 9912 |
\let\titletoothernotes=\versotitletoothernotes} |
| 9913 |
% \end{macrocode} |
| 9914 |
% \end{macro} |
| 9915 |
% \begin{macro}{\finishversopage} |
| 9916 |
% \begin{macrocode} |
| 9917 |
\newcommand{\finishversopage}{ |
| 9918 |
\saveversoline\versofalse\ |
| 9919 |
\ifinpoem |
| 9920 |
\global\versopoempendingtrue |
| 9921 |
\versopoemstillopentrue |
| 9922 |
\fi |
| 9923 |
\ifinstanza |
| 9924 |
\global\versostanzapendingtrue |
| 9925 |
\versostanzastillopentrue |
| 9926 |
\global\versopoempendingtrue |
| 9927 |
\versopoemstillopentrue |
| 9928 |
\fi |
| 9929 |
\ifnoemendyet |
| 9930 |
\relax |
| 9931 |
\else |
| 9932 |
\global\versoemendationspendingtrue |
| 9933 |
\noemendyetfalse |
| 9934 |
\fi |
| 9935 |
\ifnoexplainyet |
| 9936 |
\relax |
| 9937 |
\else |
| 9938 |
\global\versoexplanationspendingtrue |
| 9939 |
\noexplainyetfalse |
| 9940 |
\fi |
| 9941 |
% \clearpage % keep in comment until footnotes problems are worked out |
| 9942 |
} |
| 9943 |
% \end{macrocode} |
| 9944 |
% \end{macro} |
| 9945 |
% \begin{macro}{\startrectopage} |
| 9946 |
% \begin{macrocode} |
| 9947 |
\newcommand{\startrectopage}{ |
| 9948 |
\ifversostanzastillopen |
| 9949 |
\end{stanza} |
| 9950 |
\versostanzastillopenfalse |
| 9951 |
\end{poem} |
| 9952 |
\versopoemstillopenfalse |
| 9953 |
\fi |
| 9954 |
\ifversopoemstillopen |
| 9955 |
\end{poem} |
| 9956 |
\versopoemstillopenfalse |
| 9957 |
\fi |
| 9958 |
\ifrectopoempending |
| 9959 |
\begin{poem} |
| 9960 |
\global\rectopoempendingfalse |
| 9961 |
\fi |
| 9962 |
\ifrectostanzapending |
| 9963 |
\begin{stanza} |
| 9964 |
\global\rectostanzapendingfalse |
| 9965 |
\fi |
| 9966 |
\ifrectoemendationspending |
| 9967 |
\noemendyetfalse |
| 9968 |
\global\rectoemendationspendingfalse |
| 9969 |
\fi |
| 9970 |
\ifrectoexplanationspending |
| 9971 |
\noexplainyetfalse |
| 9972 |
\global\rectoexplanationspendingfalse |
| 9973 |
\fi |
| 9974 |
\versofalse\rectotrue\restorerectoline |
| 9975 |
\let\titletoothernotes=\rectotitletoothernotes} |
| 9976 |
% \end{macrocode} |
| 9977 |
% \end{macro} |
| 9978 |
% \begin{macro}{\finishrectopage} |
| 9979 |
% \begin{macrocode} |
| 9980 |
\newcommand{\finishrectopage}{\saverectoline\rectofalse |
| 9981 |
\ifinpoem |
| 9982 |
\global\rectopoempendingtrue |
| 9983 |
\rectopoemstillopentrue |
| 9984 |
\fi |
| 9985 |
\ifinstanza |
| 9986 |
\global\rectostanzapendingtrue |
| 9987 |
\rectostanzastillopentrue |
| 9988 |
\global\rectopoempendingtrue |
| 9989 |
\rectopoemstillopentrue |
| 9990 |
\fi |
| 9991 |
\ifnoemendyet |
| 9992 |
\relax |
| 9993 |
\else |
| 9994 |
\global\rectoemendationspendingtrue |
| 9995 |
\noemendyetfalse |
| 9996 |
\fi |
| 9997 |
\ifnoexplainyet |
| 9998 |
\relax |
| 9999 |
\else |
| 10000 |
\global\versoexplanationspendingtrue |
| 10001 |
\noexplainyetfalse |
| 10002 |
\fi |
| 10003 |
% \clearpage % until footnote problem is solved |
| 10004 |
} |
| 10005 |
% \end{macrocode} |
| 10006 |
% \end{macro} |
| 10007 |
% \begin{macro}{\finishparalleltexts} |
| 10008 |
% \begin{macrocode} |
| 10009 |
\newcommand{\finishparalleltexts}{ |
| 10010 |
\ifinstanza |
| 10011 |
\end{stanza} |
| 10012 |
\fi |
| 10013 |
\ifinpoem |
| 10014 |
\end{poem} |
| 10015 |
\fi |
| 10016 |
\ifinprosesection |
| 10017 |
\end{prosesection} |
| 10018 |
\fi |
| 10019 |
\ifinquotedverse |
| 10020 |
\end{quotedverse} |
| 10021 |
\fi |
| 10022 |
\rectofalse\versofalse\paralleltextsfalse |
| 10023 |
\makeatletter\pmclresetsettitleinnotes\makeatother |
| 10024 |
} |
| 10025 |
% \end{macrocode} |
| 10026 |
% \end{macro} |
| 10027 |
% \begin{macro}{\makeversotextnotes} |
| 10028 |
% Next, the versotextnotes section: |
| 10029 |
% \begin{macrocode} |
| 10030 |
% tokens for changing the names of these notes |
| 10031 |
\newtoks{\versotextnotesname} |
| 10032 |
\versotextnotesname={TEXTUAL NOTES} |
| 10033 |
\newcommand{\changeversotextnotesname}[1]{\versotextnotesname={#1}} |
| 10034 |
\newtoks{\versotextnotesheadername} |
| 10035 |
\versotextnotesheadername={Textual Notes to} |
| 10036 |
\newcommand{\changeversotextnotesheader}[1]{\versotextnotesheadername={#1}} |
| 10037 |
\newtoks{\versotextnotescontentsname} |
| 10038 |
\versotextnotescontentsname={Textual Notes} |
| 10039 |
\newcommand{\changeversotextnotescontentsname}[1]{% |
| 10040 |
\versotextnotescontentsname={#1}} |
| 10041 |
% two column notes |
| 10042 |
\newif\ifversotextnotestwocol |
| 10043 |
\versotextnotestwocolfalse |
| 10044 |
% versotextnotes section setup |
| 10045 |
\newcommand{\makeversotextnotes}{\global\textnotesontrue |
| 10046 |
\newwrite\versotextnotes |
| 10047 |
\global\verselinenumberstrue |
| 10048 |
\immediate\openout\versotextnotes=\jobname.vtn |
| 10049 |
\literalversotextnote{\flushbottom{\par\clearpage |
| 10050 |
{\pagestyle{volumetitlestyle}\cleardoublepage} |
| 10051 |
\thispagestyle{volumetitlestyle}} |
| 10052 |
\fancyhead{} |
| 10053 |
\fancyhead[RO,LE]{{\small\textrm{\thepage}}} |
| 10054 |
\fancyhead[CO]{{\small{\em \the\versotextnotesheadername~\mymarks}}} |
| 10055 |
\fancyhead[CE]{{\small{\em \the\versotextnotesheadername~\mymarks}}} |
| 10056 |
\fancyfoot{} |
| 10057 |
\mark{3} |
| 10058 |
\setendnotessectiontitle{\the\versotextnotesname}{versotextnotes} |
| 10059 |
\tolerance=500\language=0 |
| 10060 |
\normalfont \backmattertextfont |
| 10061 |
\ifversotextnotestwocol |
| 10062 |
\begin{multicols}{2} |
| 10063 |
\fi |
| 10064 |
\setlength{\parindent}{-10pt} |
| 10065 |
} |
| 10066 |
} |
| 10067 |
% \end{macrocode} |
| 10068 |
% \end{macro} |
| 10069 |
% \begin{macro}{\versotextnote} |
| 10070 |
% \begin{macrocode} |
| 10071 |
\newif\ifversotextnotessinglepar |
| 10072 |
\newif\ifnoversotextnoteyet |
| 10073 |
\newcommand{\literalversotextnote}[1]{\begingroup |
| 10074 |
\def\next{#1}% |
| 10075 |
\newlinechar='40 |
| 10076 |
\immediate\write\versotextnotes{\expandafter\strip\meaning\next}% |
| 10077 |
\endgroup |
| 10078 |
} |
| 10079 |
\newcommand{\firstversotextnote}{\immediate\write\versotextnotes{\versotitletoothernotes} |
| 10080 |
\ifversotextnotessinglepar% |
| 10081 |
\literalversotextnote{\par}% |
| 10082 |
\fi% ifversotextnotessinglepa |
| 10083 |
} |
| 10084 |
\newcommand{\versotextnote}[2][0]{\versotitleinnotescheck |
| 10085 |
\setlemmarange{#1}% |
| 10086 |
\ifnoversotextnoteyet % firstversotextnote |
| 10087 |
\firstversotextnote |
| 10088 |
\fi %noversotextnoteyet |
| 10089 |
\global\noversotextnoteyetfalse |
| 10090 |
\immediate\write\versotextnotes{\checknoteheaders}% |
| 10091 |
\literalversotextnote{#2}% |
| 10092 |
\ifversotextnotessinglepar% |
| 10093 |
\literalversotextnote{\par}% |
| 10094 |
\fi% ifversotextnotessinglepar |
| 10095 |
\resetlemmacounters |
| 10096 |
} |
| 10097 |
% \end{macrocode} |
| 10098 |
% \end{macro} |
| 10099 |
% \begin{macro}{\makerectotextnotes} |
| 10100 |
% Next, the rectotextnotes section: |
| 10101 |
% \begin{macrocode} |
| 10102 |
% tokens for changing the names of these notes |
| 10103 |
\newtoks{\rectotextnotesname} |
| 10104 |
\rectotextnotesname={TEXTUAL NOTES} |
| 10105 |
\newcommand{\changerectotextnotesname}[1]{\rectotextnotesname={#1}} |
| 10106 |
\newtoks{\rectotextnotesheadername} |
| 10107 |
\rectotextnotesheadername={Textual Notes to} |
| 10108 |
\newcommand{\changerectotextnotesheader}[1]{\rectotextnotesheadername={#1}} |
| 10109 |
\newtoks{\rectotextnotescontentsname} |
| 10110 |
\rectotextnotescontentsname={Textual Notes} |
| 10111 |
\newcommand{\changerectotextnotescontentsname}[1]{% |
| 10112 |
\rectotextnotescontentsname={#1}} |
| 10113 |
% two column notes |
| 10114 |
\newif\ifrectotextnotestwocol |
| 10115 |
\rectotextnotestwocolfalse |
| 10116 |
% rectotextnotes section setup |
| 10117 |
\newcommand{\makerectotextnotes}{\global\textnotesontrue |
| 10118 |
\newwrite\rectotextnotes |
| 10119 |
\global\verselinenumberstrue |
| 10120 |
\immediate\openout\rectotextnotes=\jobname.rtn |
| 10121 |
\literalrectotextnote{\flushbottom{\par\clearpage |
| 10122 |
{\pagestyle{volumetitlestyle}\cleardoublepage} |
| 10123 |
\thispagestyle{volumetitlestyle}} |
| 10124 |
\fancyhead{} |
| 10125 |
\fancyhead[RO,LE]{{\small\textrm{\thepage}}} |
| 10126 |
\fancyhead[CO]{{\small{\em \the\rectotextnotesheadername~\mymarks}}} |
| 10127 |
\fancyhead[CE]{{\small{\em \the\rectotextnotesheadername~\mymarks}}} |
| 10128 |
\fancyfoot{} |
| 10129 |
\mark{3} |
| 10130 |
\setendnotessectiontitle{\the\rectotextnotesname}{rectotextnotes} |
| 10131 |
\tolerance=500\language=0 |
| 10132 |
\normalfont \backmattertextfont |
| 10133 |
\ifrectotextnotestwocol |
| 10134 |
\begin{multicols}{2} |
| 10135 |
\fi |
| 10136 |
\setlength{\parindent}{-10pt} |
| 10137 |
} |
| 10138 |
} |
| 10139 |
% \end{macrocode} |
| 10140 |
% \end{macro} |
| 10141 |
% \begin{macro}{\rectotextnote} |
| 10142 |
% \begin{macrocode} |
| 10143 |
\newif\ifrectotextnotessinglepar |
| 10144 |
\newif\ifnorectotextnoteyet |
| 10145 |
\newcommand{\literalrectotextnote}[1]{\begingroup |
| 10146 |
\def\next{#1}% |
| 10147 |
\newlinechar='40 |
| 10148 |
\immediate\write\rectotextnotes{\expandafter\strip\meaning\next}% |
| 10149 |
\endgroup |
| 10150 |
} |
| 10151 |
\newcommand{\firstrectotextnote}{\immediate\write\rectotextnotes{\rectotitletoothernotes} |
| 10152 |
\ifrectotextnotessinglepar% |
| 10153 |
\literalrectotextnote{\par}% |
| 10154 |
\fi% ifrectotextnotessinglepar |
| 10155 |
} |
| 10156 |
\newcommand{\rectotextnote}[2][0]{\rectotitleinnotescheck |
| 10157 |
\setlemmarange{#1}% |
| 10158 |
\ifnorectotextnoteyet % firstrectotextnote |
| 10159 |
\firstrectotextnote |
| 10160 |
\fi %norectotextnoteyet |
| 10161 |
\global\norectotextnoteyetfalse |
| 10162 |
\immediate\write\rectotextnotes{\checknoteheaders}% |
| 10163 |
\literalrectotextnote{#2}% |
| 10164 |
\ifrectotextnotessinglepar% |
| 10165 |
\literalrectotextnote{\par}% |
| 10166 |
\fi% ifrectotextnotessinglepar |
| 10167 |
\resetlemmacounters |
| 10168 |
} |
| 10169 |
% \end{macrocode} |
| 10170 |
% \end{macro} |
| 10171 |
% \begin{macro}{\makeversoemendations} |
| 10172 |
% Next, the versoemendations section: |
| 10173 |
% \begin{macrocode} |
| 10174 |
% tokens for changing the names of these notes |
| 10175 |
\newtoks{\versoemendationsname} |
| 10176 |
\versoemendationsname={EMENDATIONS} |
| 10177 |
\newcommand{\changeversoemendationsname}[1]{\versoemendationsname={#1}} |
| 10178 |
\newtoks{\versoemendationsheadername} |
| 10179 |
\versoemendationsheadername={Emendations to} |
| 10180 |
\newcommand{\changeversoemendationsheader}[1]{\versoemendationsheadername={#1}} |
| 10181 |
\newtoks{\versoemendationscontentsname} |
| 10182 |
\versoemendationscontentsname={Emendations} |
| 10183 |
\newcommand{\changeversoemendationscontentsname}[1]{% |
| 10184 |
\versoemendationscontentsname={#1}} |
| 10185 |
% two column notes |
| 10186 |
\newif\ifversoemendationstwocol |
| 10187 |
\versoemendationstwocolfalse |
| 10188 |
% versoemendations section setup |
| 10189 |
\newcommand{\makeversoemendations}{\global\emendationsontrue |
| 10190 |
\newwrite\versoemendations |
| 10191 |
\global\verselinenumberstrue |
| 10192 |
\immediate\openout\versoemendations=\jobname.vem |
| 10193 |
\literalversoemendation{\flushbottom{\par\clearpage |
| 10194 |
{\pagestyle{volumetitlestyle}\cleardoublepage} |
| 10195 |
\thispagestyle{volumetitlestyle}} |
| 10196 |
\fancyhead{} |
| 10197 |
\fancyhead[RO,LE]{{\small\textrm{\thepage}}} |
| 10198 |
\fancyhead[CO]{{\small{\em \the\versoemendationsheadername~\mymarks}}} |
| 10199 |
\fancyhead[CE]{{\small{\em \the\versoemendationsheadername~\mymarks}}} |
| 10200 |
\fancyfoot{} |
| 10201 |
\mark{3} |
| 10202 |
\setendnotessectiontitle{\the\versoemendationsname}{versoemendations} |
| 10203 |
\tolerance=500\language=0 |
| 10204 |
\normalfont \backmattertextfont |
| 10205 |
\ifversoemendationstwocol |
| 10206 |
\begin{multicols}{2} |
| 10207 |
\fi |
| 10208 |
\setlength{\parindent}{-10pt} |
| 10209 |
} |
| 10210 |
} |
| 10211 |
% \end{macrocode} |
| 10212 |
% \end{macro} |
| 10213 |
% \begin{macro}{\versoemendation} |
| 10214 |
% \begin{macrocode} |
| 10215 |
\newif\ifversoemendationssinglepar |
| 10216 |
\newif\ifnoversoemendationyet |
| 10217 |
\newcommand{\literalversoemendation}[1]{\begingroup |
| 10218 |
\def\next{#1}% |
| 10219 |
\newlinechar='40 |
| 10220 |
\immediate\write\versoemendations{\expandafter\strip\meaning\next}% |
| 10221 |
\endgroup |
| 10222 |
} |
| 10223 |
\newcommand{\firstversoemendation}{\immediate\write\versoemendations{\versotitletoothernotes} |
| 10224 |
\ifversoemendationssinglepar% |
| 10225 |
\literalversoemendation{\par}% |
| 10226 |
\fi% ifversoemendationssinglepar |
| 10227 |
} |
| 10228 |
\newcommand{\versoemendation}[2][0]{\versotitleinnotescheck% |
| 10229 |
\setlemmarange{#1}% |
| 10230 |
\ifnoversoemendationyet % firstversoemendation |
| 10231 |
\firstversoemendation |
| 10232 |
\fi %noversoemendationyet |
| 10233 |
\global\noversoemendationyetfalse |
| 10234 |
\immediate\write\versoemendations{\checknoteheaders}% |
| 10235 |
\literalversoemendation{#2}% |
| 10236 |
\ifversoemendationssinglepar% |
| 10237 |
\literalversoemendation{\par}% |
| 10238 |
\fi% ifversoemendationssinglepar |
| 10239 |
\resetlemmacounters |
| 10240 |
} |
| 10241 |
% \end{macrocode} |
| 10242 |
% \end{macro} |
| 10243 |
% \begin{macro}{\makerectoemendations} |
| 10244 |
% Next, the rectoemendations section: |
| 10245 |
% \begin{macrocode} |
| 10246 |
% tokens for changing the names of these notes |
| 10247 |
\newtoks{\rectoemendationsname} |
| 10248 |
\rectoemendationsname={EMENDATIONS} |
| 10249 |
\newcommand{\changerectoemendationsname}[1]{\rectoemendationsname={#1}} |
| 10250 |
\newtoks{\rectoemendationsheadername} |
| 10251 |
\rectoemendationsheadername={Emendations to} |
| 10252 |
\newcommand{\changerectoemendationsheader}[1]{\rectoemendationsheadername={#1}} |
| 10253 |
\newtoks{\rectoemendationscontentsname} |
| 10254 |
\rectoemendationscontentsname={Emendations} |
| 10255 |
\newcommand{\changerectoemendationscontentsname}[1]{% |
| 10256 |
\rectoemendationscontentsname={#1}} |
| 10257 |
% two column notes |
| 10258 |
\newif\ifrectoemendationstwocol |
| 10259 |
\rectoemendationstwocolfalse |
| 10260 |
% rectoemendations section setup |
| 10261 |
\newcommand{\makerectoemendations}{\global\emendationsontrue |
| 10262 |
\newwrite\rectoemendations |
| 10263 |
\global\verselinenumberstrue |
| 10264 |
\immediate\openout\rectoemendations=\jobname.rem |
| 10265 |
\literalrectoemendation{\flushbottom{\par\clearpage |
| 10266 |
{\pagestyle{volumetitlestyle}\cleardoublepage} |
| 10267 |
\thispagestyle{volumetitlestyle}} |
| 10268 |
\fancyhead{} |
| 10269 |
\fancyhead[RO,LE]{{\small\textrm{\thepage}}} |
| 10270 |
\fancyhead[CO]{{\small{\em \the\rectoemendationsheadername~\mymarks}}} |
| 10271 |
\fancyhead[CE]{{\small{\em \the\rectoemendationsheadername~\mymarks}}} |
| 10272 |
\fancyfoot{} |
| 10273 |
\mark{3} |
| 10274 |
\setendnotessectiontitle{\the\rectoemendationsname}{rectoemendations} |
| 10275 |
\tolerance=500\language=0 |
| 10276 |
\normalfont \backmattertextfont |
| 10277 |
\ifrectoemendationstwocol |
| 10278 |
\begin{multicols}{2} |
| 10279 |
\fi |
| 10280 |
\setlength{\parindent}{-10pt} |
| 10281 |
} |
| 10282 |
} |
| 10283 |
% \end{macrocode} |
| 10284 |
% \end{macro} |
| 10285 |
% \begin{macro}{\rectoemendation} |
| 10286 |
% \begin{macrocode} |
| 10287 |
\newif\ifrectoemendationssinglepar |
| 10288 |
\newif\ifnorectoemendationyet |
| 10289 |
\newcommand{\literalrectoemendation}[1]{\begingroup |
| 10290 |
\def\next{#1}% |
| 10291 |
\newlinechar='40 |
| 10292 |
\immediate\write\rectoemendations{\expandafter\strip\meaning\next}% |
| 10293 |
\endgroup |
| 10294 |
} |
| 10295 |
\newcommand{\firstrectoemendation}{\immediate\write\rectoemendations{\rectotitletoothernotes} |
| 10296 |
\ifrectoemendationssinglepar% |
| 10297 |
\literalrectoemendation{\par}% |
| 10298 |
\fi% ifrectoemendationssinglepar |
| 10299 |
} |
| 10300 |
\newcommand{\rectoemendation}[2][0]{\rectotitleinnotescheck |
| 10301 |
\setlemmarange{#1}% |
| 10302 |
\ifnorectoemendationyet % firstrectoemendation |
| 10303 |
\firstrectoemendation |
| 10304 |
\fi %norectoemendationyet |
| 10305 |
\global\norectoemendationyetfalse |
| 10306 |
\immediate\write\rectoemendations{\checknoteheaders}% |
| 10307 |
\literalrectoemendation{#2}% |
| 10308 |
\ifrectoemendationssinglepar% |
| 10309 |
\literalrectoemendation{\par}% |
| 10310 |
\fi% ifrectoemendationssinglepar |
| 10311 |
\resetlemmacounters |
| 10312 |
} |
| 10313 |
% \end{macrocode} |
| 10314 |
% \end{macro} |
| 10315 |
% \begin{macro}{\makeversoexplanatorynotes} |
| 10316 |
% And the verso explanatory notes: |
| 10317 |
% \begin{macrocode} |
| 10318 |
% Tokens to change names of these notes |
| 10319 |
\newtoks{\versoexplanationsname} |
| 10320 |
\versoexplanationsname={EXPLANATORY NOTES} |
| 10321 |
\newcommand{\changeversoexplanationsname}[1]{\versoexplanationsname={#1}} |
| 10322 |
\newtoks{\versoexplanationsheadername} |
| 10323 |
\versoexplanationsheadername={Explanatory Notes to} |
| 10324 |
\newcommand{\changeversoexplanationsheader}[1]{\versoexplanationsheadername={#1}} |
| 10325 |
\newtoks{\versoexplanationscontentsname} |
| 10326 |
\versoexplanationscontentsname={Explanatory Notes} |
| 10327 |
\newcommand{\changeversoexplanationscontentsname}[1]{% |
| 10328 |
\versoexplanationscontentsname={#1}} |
| 10329 |
% Two column notes |
| 10330 |
\newif\ifversoexplanationstwocol |
| 10331 |
\versoexplanationstwocolfalse |
| 10332 |
% versoexplanatory notes setup |
| 10333 |
\newcommand{\makeversoexplanatorynotes}{\global\explanontrue |
| 10334 |
\global\verselinenumberstrue |
| 10335 |
\newwrite\versoexplanations |
| 10336 |
\immediate\openout\versoexplanations=\jobname.vex |
| 10337 |
\literalversoexplain{\flushbottom{\par\clearpage |
| 10338 |
{\pagestyle{volumetitlestyle}\cleardoublepage} |
| 10339 |
\thispagestyle{volumetitlestyle}} |
| 10340 |
\fancyhead[RO,LE]{{\small\textrm{\thepage}}} |
| 10341 |
\fancyhead[CO]{{\small{\em \the\versoexplanationsheadername~\mymarks}}} |
| 10342 |
\fancyhead[CE]{{\small{\em \the\versoexplanationsheadername~\mymarks}}} |
| 10343 |
\fancyfoot{} |
| 10344 |
\mark{3} |
| 10345 |
\setendnotessectiontitle{\the\versoexplanationsname}{versoexplanatorynotes} |
| 10346 |
\tolerance=500\language=0 |
| 10347 |
\normalfont \backmattertextfont |
| 10348 |
\ifversoexplanationstwocol |
| 10349 |
\begin{multicols}{2} |
| 10350 |
\fi |
| 10351 |
\setlength{\parindent}{-10pt} |
| 10352 |
} |
| 10353 |
} |
| 10354 |
% \begin{macro}{\versoexplanatory} |
| 10355 |
% Again, |\firstversoexplanatory| is internal, called by |\versoexplanatory|. |
| 10356 |
% \begin{macrocode} |
| 10357 |
\newcommand{\literalversoexplain}[1]{ |
| 10358 |
\begingroup |
| 10359 |
\def\next{#1}% |
| 10360 |
\newlinechar='40 |
| 10361 |
\immediate\write\versoexplanations{\expandafter\strip\meaning\next}% |
| 10362 |
\endgroup |
| 10363 |
} |
| 10364 |
\newif\ifversoexplanationssinglepar |
| 10365 |
\newcommand{\firstversoexplanatory}{\immediate\write\versoexplanations{\versotitletoothernotes} |
| 10366 |
\ifversoexplanationssinglepar% |
| 10367 |
\literalversoexplain{\par}% |
| 10368 |
\fi} |
| 10369 |
\newif\ifnoversoexplainyet |
| 10370 |
\newcommand{\versoexplanatory}[2][0]{\versotitleinnotescheck% |
| 10371 |
\ifexplanon |
| 10372 |
\setlemmarange{#1}% |
| 10373 |
\ifnoversoexplainyet % first versoexplanation |
| 10374 |
\firstversoexplanatory |
| 10375 |
\fi %noversoexplainyet |
| 10376 |
\global\noversoexplainyetfalse |
| 10377 |
\immediate\write\versoexplanations{\checknoteheaders}% |
| 10378 |
\literalversoexplain{#2}% |
| 10379 |
\ifversoexplanationssinglepar% |
| 10380 |
\literalversoexplain{\par}% |
| 10381 |
\fi% |
| 10382 |
\fi % ifexplanon |
| 10383 |
\resetlemmacounters |
| 10384 |
} |
| 10385 |
% \end{macrocode} |
| 10386 |
% \end{macro} |
| 10387 |
% \begin{macro}{\makerectoexplanatorynotes} |
| 10388 |
% And the recto explanatory notes: |
| 10389 |
% \begin{macrocode} |
| 10390 |
% Tokens to change names of these notes |
| 10391 |
\newtoks{\rectoexplanationsname} |
| 10392 |
\rectoexplanationsname={EXPLANATORY NOTES} |
| 10393 |
\newcommand{\changerectoexplanationsname}[1]{\rectoexplanationsname={#1}} |
| 10394 |
\newtoks{\rectoexplanationsheadername} |
| 10395 |
\rectoexplanationsheadername={Explanatory Notes to} |
| 10396 |
\newcommand{\changerectoexplanationsheader}[1]{\rectoexplanationsheadername={#1}} |
| 10397 |
\newtoks{\rectoexplanationscontentsname} |
| 10398 |
\rectoexplanationscontentsname={Explanatory Notes} |
| 10399 |
\newcommand{\changerectoexplanationscontentsname}[1]{% |
| 10400 |
\rectoexplanationscontentsname={#1}} |
| 10401 |
% Two column notes |
| 10402 |
\newif\ifrectoexplanationstwocol |
| 10403 |
\rectoexplanationstwocolfalse |
| 10404 |
% rectoexplanatory notes setup |
| 10405 |
\newcommand{\makerectoexplanatorynotes}{\global\explanontrue |
| 10406 |
\global\verselinenumberstrue |
| 10407 |
\newwrite\rectoexplanations |
| 10408 |
\immediate\openout\rectoexplanations=\jobname.rex |
| 10409 |
\literalrectoexplain{\flushbottom{\par\clearpage |
| 10410 |
{\pagestyle{volumetitlestyle}\cleardoublepage} |
| 10411 |
\thispagestyle{volumetitlestyle}} |
| 10412 |
\fancyhead[RO,LE]{{\small\textrm{\thepage}}} |
| 10413 |
\fancyhead[CO]{{\small{\em \the\rectoexplanationsheadername~\mymarks}}} |
| 10414 |
\fancyhead[CE]{{\small{\em \the\rectoexplanationsheadername~\mymarks}}} |
| 10415 |
\fancyfoot{} |
| 10416 |
\mark{3} |
| 10417 |
\setendnotessectiontitle{\the\rectoexplanationsname}{rectoexplanatorynotes} |
| 10418 |
\tolerance=500\language=0 |
| 10419 |
\normalfont \backmattertextfont |
| 10420 |
\ifrectoexplanationstwocol |
| 10421 |
\begin{multicols}{2} |
| 10422 |
\fi |
| 10423 |
\setlength{\parindent}{-10pt} |
| 10424 |
} |
| 10425 |
} |
| 10426 |
% \begin{macro}{\rectoexplanatory} |
| 10427 |
% Again, |\firstrectoexplanatory| is internal, called by |\rectoexplanatory|. |
| 10428 |
% \begin{macrocode} |
| 10429 |
\newcommand{\literalrectoexplain}[1]{ |
| 10430 |
\begingroup |
| 10431 |
\def\next{#1}% |
| 10432 |
\newlinechar='40 |
| 10433 |
\immediate\write\rectoexplanations{\expandafter\strip\meaning\next}% |
| 10434 |
\endgroup |
| 10435 |
} |
| 10436 |
\newif\ifrectoexplanationssinglepar |
| 10437 |
\newcommand{\firstrectoexplanatory}{\immediate\write\rectoexplanations{\rectotitletoothernotes} |
| 10438 |
\ifrectoexplanationssinglepar% |
| 10439 |
\literalrectoexplain{\par}% |
| 10440 |
\fi% |
| 10441 |
} |
| 10442 |
\newif\ifnorectoexplainyet |
| 10443 |
\newcommand{\rectoexplanatory}[2][0]{\rectotitleinnotescheck% |
| 10444 |
\ifexplanon |
| 10445 |
\setlemmarange{#1}% |
| 10446 |
\ifnorectoexplainyet % first rectoexplanation |
| 10447 |
\firstrectoexplanatory |
| 10448 |
\fi %norectoexplainyet |
| 10449 |
\global\norectoexplainyetfalse |
| 10450 |
\immediate\write\rectoexplanations{\checknoteheaders}% |
| 10451 |
\literalrectoexplain{#2}% |
| 10452 |
\ifrectoexplanationssinglepar% |
| 10453 |
\literalrectoexplain{\par}% |
| 10454 |
\fi% |
| 10455 |
\fi % ifexplanon |
| 10456 |
\resetlemmacounters |
| 10457 |
} |
| 10458 |
% \end{macrocode} |
| 10459 |
% \end{macro} |
| 10460 |
% \begin{macro}{\versoprosetextnote} |
| 10461 |
% \begin{macrocode} |
| 10462 |
\newcommand{\versoprosetextnote}[3][0]{% |
| 10463 |
\iftextnoteson% |
| 10464 |
\versotitleinnotescheck |
| 10465 |
\unskip\proselinelabel{#2}% |
| 10466 |
\setproselemmarange{#2}{#1}% |
| 10467 |
\ifnoversotextnoteyet % firstversotextnote |
| 10468 |
\firstversotextnote |
| 10469 |
\fi %noversotextnoteyet |
| 10470 |
\global\noversotextnoteyetfalse |
| 10471 |
\immediate\write\versotextnotes{\checkprosenoteheaders}% |
| 10472 |
\literalversotextnote{#3}% |
| 10473 |
\ifversotextnotessinglepar% |
| 10474 |
\literalversotextnote{\par}% |
| 10475 |
\fi% |
| 10476 |
\resetlemmacounters% |
| 10477 |
\fi\unskip% |
| 10478 |
} |
| 10479 |
% \end{macrocode} |
| 10480 |
% \end{macro} |
| 10481 |
% \begin{macro}{\versoproseemendation} |
| 10482 |
% Notice that it calls |\firstemendation| as usual. |
| 10483 |
% \begin{macrocode} |
| 10484 |
\newcommand{\versoproseemendation}[3][0]{% |
| 10485 |
\ifemendationson% |
| 10486 |
\versotitleinnotescheck |
| 10487 |
\unskip\proselinelabel{#2}% |
| 10488 |
\setproselemmarange{#2}{#1}% |
| 10489 |
\ifredundantemendations |
| 10490 |
\iftextnoteson |
| 10491 |
\ifrangelemma |
| 10492 |
\versoprosetextnote[#1]{#2}{#3}% |
| 10493 |
\else |
| 10494 |
\versoprosetextnote{#2}{#3}% |
| 10495 |
\fi % ifrangelemma} |
| 10496 |
\fi %iftextnoteson |
| 10497 |
\ifversotextnotessinglepar% |
| 10498 |
\literalversotextnote{\par}% |
| 10499 |
\fi% iftextnotessinglepar |
| 10500 |
\fi % ifredundantemendations |
| 10501 |
\ifnoversoemendationyet % firstemendation |
| 10502 |
\firstversoemendation |
| 10503 |
\fi%noemendyet |
| 10504 |
\global\noversoemendationyetfalse |
| 10505 |
\immediate\write\versoemendations{\checkprosenoteheaders}% |
| 10506 |
\literalversoemendation{#3}% |
| 10507 |
\ifversoemendationssinglepar% |
| 10508 |
\literalversoemendation{\par}% |
| 10509 |
\fi% ifemendationssinglep |
| 10510 |
\resetlemmacounters% |
| 10511 |
\fi\unskip% |
| 10512 |
} |
| 10513 |
% \end{macrocode} |
| 10514 |
% \end{macro} |
| 10515 |
% \begin{macro}{\versoproseexplanatory} |
| 10516 |
% \begin{macrocode} |
| 10517 |
\newcommand{\versoproseexplanatory}[3][0]{% |
| 10518 |
\ifexplanon% |
| 10519 |
\versotitleinnotescheck |
| 10520 |
\unskip\proselinelabel{#2}% |
| 10521 |
\setproselemmarange{#2}{#1}% |
| 10522 |
\ifnoversoexplainyet% firstexplanation |
| 10523 |
\firstversoexplanatory% |
| 10524 |
\fi%noexplainyet |
| 10525 |
\global\noversoexplainyetfalse% |
| 10526 |
\immediate\write\versoexplanations{\checkprosenoteheaders}% |
| 10527 |
\literalversoexplain{#3}% |
| 10528 |
\ifversoexplanationssinglepar% |
| 10529 |
\literalversoexplain{\par}% |
| 10530 |
\fi% ifexplanationssinglepar |
| 10531 |
\resetlemmacounters% |
| 10532 |
\fi\unskip% |
| 10533 |
} |
| 10534 |
% \end{macrocode} |
| 10535 |
% \end{macro} |
| 10536 |
% \begin{macro}{\rectoprosetextnote} |
| 10537 |
% \begin{macrocode} |
| 10538 |
\newcommand{\rectoprosetextnote}[3][0]{% |
| 10539 |
\iftextnoteson% |
| 10540 |
\rectotitleinnotescheck |
| 10541 |
\unskip\proselinelabel{#2}% |
| 10542 |
\setproselemmarange{#2}{#1}% |
| 10543 |
\ifnorectotextnoteyet % firstrectotextnote |
| 10544 |
\firstrectotextnote |
| 10545 |
\fi %norectotextnoteyet |
| 10546 |
\global\norectotextnoteyetfalse |
| 10547 |
\immediate\write\rectotextnotes{\checkprosenoteheaders}% |
| 10548 |
\literalrectotextnote{#3}% |
| 10549 |
\ifrectotextnotessinglepar% |
| 10550 |
\literalrectotextnote{\par}% |
| 10551 |
\fi% |
| 10552 |
\resetlemmacounters% |
| 10553 |
\fi\unskip% |
| 10554 |
} |
| 10555 |
% \end{macrocode} |
| 10556 |
% \end{macro} |
| 10557 |
% \begin{macro}{\rectoproseemendation} |
| 10558 |
% Notice that it calls |\firstemendation| as usual. |
| 10559 |
% \begin{macrocode} |
| 10560 |
\newcommand{\rectoproseemendation}[3][0]{% |
| 10561 |
\ifemendationson% |
| 10562 |
\rectotitleinnotescheck |
| 10563 |
\unskip\proselinelabel{#2}% |
| 10564 |
\setproselemmarange{#2}{#1}% |
| 10565 |
\ifredundantemendations |
| 10566 |
\iftextnoteson |
| 10567 |
\ifrangelemma |
| 10568 |
\rectoprosetextnote[#1]{#2}{#3}% |
| 10569 |
\else |
| 10570 |
\rectoprosetextnote{#2}{#3}% |
| 10571 |
\fi % ifrangelemma} |
| 10572 |
\fi %iftextnoteson |
| 10573 |
\ifrectotextnotessinglepar% |
| 10574 |
\literalrectotextnote{\par}% |
| 10575 |
\fi% iftextnotessinglepar |
| 10576 |
\fi % ifredundantemendations |
| 10577 |
\ifnorectoemendationyet % firstemendation |
| 10578 |
\firstrectoemendation |
| 10579 |
\fi%noemendyet |
| 10580 |
\global\norectoemendationyetfalse |
| 10581 |
\immediate\write\rectoemendations{\checkprosenoteheaders}% |
| 10582 |
\literalrectoemendation{#3}% |
| 10583 |
\ifrectoemendationssinglepar% |
| 10584 |
\literalrectoemendation{\par}% |
| 10585 |
\fi% ifemendationssinglep |
| 10586 |
\resetlemmacounters% |
| 10587 |
\fi\unskip% |
| 10588 |
} |
| 10589 |
% \end{macrocode} |
| 10590 |
% \end{macro} |
| 10591 |
% \begin{macro}{\rectoproseexplanatory} |
| 10592 |
% \begin{macrocode} |
| 10593 |
\newcommand{\rectoproseexplanatory}[3][0]{% |
| 10594 |
\ifexplanon% |
| 10595 |
\rectotitleinnotescheck |
| 10596 |
\unskip\proselinelabel{#2}% |
| 10597 |
\setproselemmarange{#2}{#1}% |
| 10598 |
\ifnorectoexplainyet% firstexplanation |
| 10599 |
\firstrectoexplanatory% |
| 10600 |
\fi%noexplainyet |
| 10601 |
\global\norectoexplainyetfalse% |
| 10602 |
\immediate\write\rectoexplanations{\checkprosenoteheaders}% |
| 10603 |
\literalrectoexplain{#3}% |
| 10604 |
\ifrectoexplanationssinglepar% |
| 10605 |
\literalrectoexplain{\par}% |
| 10606 |
\fi% ifexplanationssinglepar |
| 10607 |
\resetlemmacounters% |
| 10608 |
\fi\unskip% |
| 10609 |
} |
| 10610 |
% \end{macrocode} |
| 10611 |
% \end{macro} |
| 10612 |
% \begin{macro}{\pmclresetsettitleinnotes} |
| 10613 |
% \begin{macrocode} |
| 10614 |
\newcommand{\pmclresetsettitleinnotes}{% |
| 10615 |
\noversoemendationyettrue% |
| 10616 |
\noversoexplainyettrue% |
| 10617 |
\noversotextnoteyettrue% |
| 10618 |
\norectoemendationyettrue% |
| 10619 |
\norectoexplainyettrue% |
| 10620 |
\norectotextnoteyettrue% |
| 10621 |
} |
| 10622 |
% \end{macrocode} |
| 10623 |
% \end{macro} |
| 10624 |
% \begin{macro}{\pmclversoresetsettitleinnotes} |
| 10625 |
% \begin{macrocode} |
| 10626 |
\newcommand{\pmclversoresetsettitleinnotes}{% |
| 10627 |
\noversoemendationyettrue% |
| 10628 |
\noversoexplainyettrue% |
| 10629 |
\noversotextnoteyettrue% |
| 10630 |
} |
| 10631 |
% \end{macrocode} |
| 10632 |
% \end{macro} |
| 10633 |
% \begin{macro}{\pmclrectoresetsettitleinnotes} |
| 10634 |
% \begin{macrocode} |
| 10635 |
\newcommand{\pmclrectoresetsettitleinnotes}{% |
| 10636 |
\norectoemendationyettrue% |
| 10637 |
\norectoexplainyettrue% |
| 10638 |
\norectotextnoteyettrue% |
| 10639 |
} |
| 10640 |
% \end{macrocode} |
| 10641 |
% \end{macro} |
| 10642 |
% \begin{macro}{\literalexplain} |
| 10643 |
% \begin{macrocode} |
| 10644 |
\let\literalexplanatory=\literalexplain |
| 10645 |
\let\literalversoexplanatory=\literalversoexplain |
| 10646 |
\let\literalrectoexplanatory=\literalrectoexplain |
| 10647 |
% \end{macrocode} |
| 10648 |
% \end{macro} |
| 10649 |
% \begin{macro}{\putversotextnotes} Does the same for textual notes. |
| 10650 |
% |
| 10651 |
% \begin{macrocode} |
| 10652 |
\newcommand{\putversotextnotes}{ |
| 10653 |
\iftextnoteson |
| 10654 |
\ifversotextnotestwocol |
| 10655 |
\literalversotextnote{\end{multicols}} |
| 10656 |
\fi %\iftextnotetwocol |
| 10657 |
\newpage |
| 10658 |
\hyphenationforsmall |
| 10659 |
\immediate\closeout\versotextnotes |
| 10660 |
\input \jobname.vtn |
| 10661 |
\contentsendnotestitle{\the\versotextnotescontentsname}{versotextnotes} |
| 10662 |
\else |
| 10663 |
\relax |
| 10664 |
\fi} |
| 10665 |
% \end{macrocode} |
| 10666 |
% \end{macro} |
| 10667 |
% \begin{macro}{\putrectotextnotes} Does the same for recto textual notes. |
| 10668 |
% |
| 10669 |
% \begin{macrocode} |
| 10670 |
\newcommand{\putrectotextnotes}{ |
| 10671 |
\iftextnoteson |
| 10672 |
\ifrectotextnotestwocol |
| 10673 |
\literalrectotextnote{\end{multicols}} |
| 10674 |
\fi %\iftextnotetwocol |
| 10675 |
\newpage |
| 10676 |
\hyphenationforsmall |
| 10677 |
\immediate\closeout\rectotextnotes |
| 10678 |
\input \jobname.rtn |
| 10679 |
\contentsendnotestitle{\the\rectotextnotescontentsname}{rectotextnotes} |
| 10680 |
\else |
| 10681 |
\relax |
| 10682 |
\fi} |
| 10683 |
% \end{macrocode} |
| 10684 |
% \end{macro} |
| 10685 |
% \begin{macro}{\putversoemendations} This macro closes external file |
| 10686 |
% for verso emendations, |
| 10687 |
% reads it in, and puts an entry for the emendations into the table of contents |
| 10688 |
% file. The macro tests to see whether there is an .aux file from a previous run |
| 10689 |
% before doing this, and complains in the .log file if the .aux file does not |
| 10690 |
% exist. |
| 10691 |
% |
| 10692 |
% \begin{macrocode} |
| 10693 |
\newcommand{\putversoemendations}{ |
| 10694 |
\ifemendationson |
| 10695 |
\ifversoemendationstwocol |
| 10696 |
\literalversoemendation{\end{multicols}} |
| 10697 |
\fi %\iftextnotetwocol |
| 10698 |
\newpage |
| 10699 |
\hyphenationforsmall |
| 10700 |
\immediate\closeout\versoemendations |
| 10701 |
\input \jobname.vem |
| 10702 |
\contentsendnotestitle{\the\versoemendationscontentsname}{versoemendations} |
| 10703 |
\else |
| 10704 |
\relax |
| 10705 |
\fi} |
| 10706 |
% \end{macrocode} |
| 10707 |
% \end{macro} |
| 10708 |
% \begin{macro}{\putrectoemendations} This macro closes external file |
| 10709 |
% for recto emendations, |
| 10710 |
% reads it in, and puts an entry for the emendations into the table of contents |
| 10711 |
% file. The macro tests to see whether there is an .aux file from a previous run |
| 10712 |
% before doing this, and complains in the .log file if the .aux file does not |
| 10713 |
% exist. |
| 10714 |
% |
| 10715 |
% \begin{macrocode} |
| 10716 |
\newcommand{\putrectoemendations}{ |
| 10717 |
\ifemendationson |
| 10718 |
\ifrectoemendationstwocol |
| 10719 |
\literalrectoemendation{\end{multicols}} |
| 10720 |
\fi %\iftextnotetwocol |
| 10721 |
\newpage |
| 10722 |
\hyphenationforsmall |
| 10723 |
\immediate\closeout\rectoemendations |
| 10724 |
\input \jobname.rem |
| 10725 |
\contentsendnotestitle{\the\rectoemendationscontentsname}{rectoemendations} |
| 10726 |
\else |
| 10727 |
\relax |
| 10728 |
\fi} |
| 10729 |
% \end{macrocode} |
| 10730 |
% \end{macro} |
| 10731 |
% \begin{macro}{\putversoexplanatorynotes} Does the same for verso explanatory notes. |
| 10732 |
% \begin{macrocode} |
| 10733 |
\newcommand{\putversoexplanatorynotes}{ |
| 10734 |
\ifexplanon |
| 10735 |
\ifversoexplanationstwocol |
| 10736 |
\literalversoexplain{\end{multicols}} |
| 10737 |
\fi %\iftextnotetwocol |
| 10738 |
\newpage |
| 10739 |
\hyphenationforsmall |
| 10740 |
\immediate\closeout\versoexplanations |
| 10741 |
\input \jobname.vex |
| 10742 |
\ifpoemcontentson |
| 10743 |
\ifexplanon |
| 10744 |
\contentsendnotestitle{\the\versoexplanationscontentsname}{versoexplanatorynotes} |
| 10745 |
\fi |
| 10746 |
\fi |
| 10747 |
\else |
| 10748 |
\relax |
| 10749 |
\fi}% \end{macrocode} |
| 10750 |
% \end{macro} |
| 10751 |
% \begin{macro}{\putrectoexplanatorynotes} Does the same for recto explanatory notes. |
| 10752 |
% \begin{macrocode} |
| 10753 |
\newcommand{\putrectoexplanatorynotes}{ |
| 10754 |
\ifexplanon |
| 10755 |
\ifrectoexplanationstwocol |
| 10756 |
\literalrectoexplain{\end{multicols}} |
| 10757 |
\fi %\iftextnotetwocol |
| 10758 |
\newpage |
| 10759 |
\hyphenationforsmall |
| 10760 |
\immediate\closeout\rectoexplanations |
| 10761 |
\input \jobname.rex |
| 10762 |
\ifpoemcontentson |
| 10763 |
\ifexplanon |
| 10764 |
\contentsendnotestitle{\the\rectoexplanationscontentsname}{rectoexplanatorynotes} |
| 10765 |
\fi |
| 10766 |
\fi |
| 10767 |
\else |
| 10768 |
\relax |
| 10769 |
\fi} |
| 10770 |
% \end{macrocode} |
| 10771 |
% \end{macro} |
| 10772 |
% \subsection{~Parallel Texts in Prose} |
| 10773 |
% First, some booleans. |
| 10774 |
% \begin{macro}{\ifversopassagestillopen} |
| 10775 |
% \begin{macrocode} |
| 10776 |
\newif\ifversopassagestillopen |
| 10777 |
\versopassagestillopenfalse |
| 10778 |
\newif\ifrectopassagestillopen |
| 10779 |
\rectopassagestillopenfalse |
| 10780 |
% \end{macrocode} |
| 10781 |
% \end{macro} |
| 10782 |
% When the last recto page ended, was the last paragraph finished? |
| 10783 |
% True means the next recto should continue the paragraph from the last recto |
| 10784 |
% \begin{macro}{\ifinpara} |
| 10785 |
% \begin{macrocode} |
| 10786 |
\newif\ifinpara |
| 10787 |
\inparafalse |
| 10788 |
\newif\ifrectoparapending |
| 10789 |
\rectoparapendingfalse |
| 10790 |
\newif\ifrectoparaopen |
| 10791 |
\rectoparaopenfalse |
| 10792 |
\newif\ifversoparapending |
| 10793 |
\versoparapendingfalse |
| 10794 |
\newif\ifversoparaopen |
| 10795 |
\versoparaopenfalse |
| 10796 |
% \end{macrocode} |
| 10797 |
% \end{macro} |
| 10798 |
% Counters: prosepage versoproselinecounter, etc., and commands to set them. |
| 10799 |
% \begin{macro}{\makeprosepagelabel} |
| 10800 |
% \begin{macrocode} |
| 10801 |
\newcounter{prosepage} |
| 10802 |
\setcounter{prosepage}{1} |
| 10803 |
\newcommand{\makeprosepagelabel}{\proselinelabel{prosepageno\theprosepage}} |
| 10804 |
\newcounter{versoproselinecounter} |
| 10805 |
\newcommand{\saveversoproseline}{% |
| 10806 |
\refstepcounter{prosepage}% |
| 10807 |
\makeprosepagelabel |
| 10808 |
\setcounterfromref{versoproselinecounter}{prosepageno\theprosepage} |
| 10809 |
} |
| 10810 |
\newcommand{\restoreversoproseline}{\setcounter{linenumber}{\value{versoproselinecounter}}}% |
| 10811 |
\newcounter{rectoproselinecounter} |
| 10812 |
\newcommand{\saverectoproseline}{% |
| 10813 |
\refstepcounter{prosepage}% |
| 10814 |
\makeprosepagelabel |
| 10815 |
\setcounterfromref{rectoproselinecounter}{prosepageno\theprosepage} |
| 10816 |
} |
| 10817 |
\newcommand{\restorerectoproseline}{\setcounter{linenumber}% |
| 10818 |
{\value{rectoproselinecounter}}}% |
| 10819 |
% \end{macrocode} |
| 10820 |
% \end{macro} |
| 10821 |
% The |\parastart| and |\paraend| macros, to mark the beginning and end |
| 10822 |
% of paragraphs |
| 10823 |
% \begin{macro}{\parastart} |
| 10824 |
% \begin{macrocode} |
| 10825 |
\newcommand{\parastart}{\inparatrue} |
| 10826 |
% \end{macrocode} |
| 10827 |
% \end{macro} |
| 10828 |
% \begin{macro}{\paraend} |
| 10829 |
% \begin{macrocode} |
| 10830 |
\newcommand{\paraend}{\inparafalse} |
| 10831 |
% \end{macrocode} |
| 10832 |
% \end{macro} |
| 10833 |
% |\startparalleltextsprose| and |\finishparalleltextsprose| |
| 10834 |
% \begin{macro}{\startparalleltextsprose} |
| 10835 |
% \begin{macrocode} |
| 10836 |
\newcommand{\startparalleltextsprose}{% |
| 10837 |
\leavevmode |
| 10838 |
\cleartoverso |
| 10839 |
\paralleltextstrue |
| 10840 |
\inparafalse |
| 10841 |
} |
| 10842 |
% \end{macrocode} |
| 10843 |
% \end{macro} |
| 10844 |
% \begin{macro}{\finishparalleltextsprose} |
| 10845 |
% \begin{macrocode} |
| 10846 |
\newcommand{\finishparalleltextsprose}{% |
| 10847 |
\paralleltextsfalse} |
| 10848 |
% \end{macrocode} |
| 10849 |
% \end{macro} |
| 10850 |
% \begin{macro}{parallelprose} |
| 10851 |
% \begin{macrocode} |
| 10852 |
\newenvironment{parallelprose}{\startparalleltextprose} {\finishparalleltextsprose} |
| 10853 |
% \end{macrocode} |
| 10854 |
% \end{macro} |
| 10855 |
% |\startversoprosepage| |
| 10856 |
% \begin{macro}{\startversoprosepage} |
| 10857 |
% \begin{macrocode} |
| 10858 |
\newcommand{\startversoprosepage}{% |
| 10859 |
\let\titletoothernotes=\versotitletoothernotes |
| 10860 |
\restoreversoproseline% |
| 10861 |
\ifversoparapending{\inparatrue}\else{\inparafalse}\fi% |
| 10862 |
\ifinpara{\noindent}\else{\relax}\fi% |
| 10863 |
} |
| 10864 |
% \end{macrocode} |
| 10865 |
% \end{macro} |
| 10866 |
% |\finishversoprosepage| |
| 10867 |
% \begin{macro}{\finishversoprosepage} |
| 10868 |
% \begin{macrocode} |
| 10869 |
\newcommand{\finishversoprosepage}{% |
| 10870 |
\ifinpara{\versoparapendingtrue}\else{\versoparapendingfalse}\fi% |
| 10871 |
\saveversoproseline% |
| 10872 |
} |
| 10873 |
% \end{macrocode} |
| 10874 |
% \end{macro} |
| 10875 |
% |\startrectoprosepage| |
| 10876 |
% \begin{macro}{\startrectoprosepage} |
| 10877 |
% \begin{macrocode} |
| 10878 |
\newcommand{\startrectoprosepage}{% |
| 10879 |
\let\titletoothernotes=\rectotitletoothernotes |
| 10880 |
\restorerectoproseline% |
| 10881 |
\ifrectoparapending{\inparatrue}\else{\inparafalse}\fi% |
| 10882 |
\ifinpara{\noindent}\else{\relax}\fi% |
| 10883 |
} |
| 10884 |
% \end{macrocode} |
| 10885 |
% \end{macro} |
| 10886 |
% \begin{macro}{\finishrectoprosepage} |
| 10887 |
% \begin{macrocode} |
| 10888 |
\newcommand{\finishrectoprosepage}{% |
| 10889 |
\ifinpara{\rectoparapendingtrue}\else{\rectoparapendingfalse}\fi% |
| 10890 |
\saverectoproseline |
| 10891 |
} |
| 10892 |
% \end{macrocode} |
| 10893 |
% \end{macro} |
| 10894 |
% \subsection{~Finishing up} |
| 10895 |
% \begin{macro}{\finish} |
| 10896 |
% The |\finish| macro reads in the notes, |
| 10897 |
% the index (previously created from your .aux file by MakeIndex), and |
| 10898 |
% the contents sections and sets them. The notes sections send page |
| 10899 |
% information to the contents file as they are set. Then the page |
| 10900 |
% information for the index is sent to the contents file. Finally the |
| 10901 |
% contents file is closed and read in. If you have an editor's |
| 10902 |
% introduction or a list of abbreviations, copy this macro, uncomment out the commented out lines, |
| 10903 |
% and issue it all as a |\renewcommand| for |\finish|. Be sure to |
| 10904 |
% have the command |\label{editorsintroduction}| on the first page of |
| 10905 |
% your introduction. |
| 10906 |
|
| 10907 |
% It usually takes three |
| 10908 |
% passes to get the table of contents and the index files correct. |
| 10909 |
% |
| 10910 |
% The consequence of doing using |\finish| is that the table of |
| 10911 |
% contents comes last. There are ways around this that are described |
| 10912 |
% earlier. The notes sections are all typeset in the |\small| size. |
| 10913 |
% |
| 10914 |
% \begin{macrocode} |
| 10915 |
\newcommand{\finish}{ |
| 10916 |
\small\bf \hyphenchar\font=45 |
| 10917 |
\small\it \hyphenchar\font=45 |
| 10918 |
\small\rm \hyphenchar\font=45 |
| 10919 |
|
| 10920 |
\ifemendationson |
| 10921 |
\newpage |
| 10922 |
\immediate\closeout\emendations |
| 10923 |
\input \jobname.emd |
| 10924 |
\fi |
| 10925 |
\iftextnoteson |
| 10926 |
\newpage |
| 10927 |
\immediate\closeout\textnotes |
| 10928 |
\input \jobname.ent |
| 10929 |
\newpage |
| 10930 |
\fi |
| 10931 |
\ifexplanon |
| 10932 |
\immediate\closeout\explanations |
| 10933 |
\input \jobname.enx |
| 10934 |
\newpage |
| 10935 |
\fi |
| 10936 |
\ifindexingon |
| 10937 |
\printindex |
| 10938 |
\fi |
| 10939 |
\ifpoemcontentson |
| 10940 |
% \immediate\write\poemcontents{\string\vspace{10pt}\string\par} |
| 10941 |
% \immediate\write |
| 10942 |
% \poemcontents{\string\contentspoemtitlefont\ Introduction to the Notes} |
| 10943 |
% \immediate\write |
| 10944 |
% \poemcontents{\string~ / \string~\ \string\pageref{editorsintroduction} \string\par} |
| 10945 |
% \immediate\write\poemcontents{\string\par \string\smallskip} |
| 10946 |
% \immediate\write\poemcontents{\string\contentspoemtitlefont\ Abbreviations} |
| 10947 |
% \immediate\write |
| 10948 |
% \poemcontents{\string~ / \string~\ \string\pageref{abbreviations} \string\par} |
| 10949 |
% \immediate\write\poemcontents{\string\par \string\smallskip} |
| 10950 |
\ifemendationson |
| 10951 |
\immediate\write\poemcontents{\string\contentspoemtitlefont\ |
| 10952 |
\the\emendationscontentsname} |
| 10953 |
\immediate\write |
| 10954 |
\poemcontents{\string~ / \string~\ \string\pageref{emendationnotes} \string\par} |
| 10955 |
\immediate\write\poemcontents{\string\par \string\smallskip} |
| 10956 |
\fi |
| 10957 |
\iftextnoteson |
| 10958 |
\immediate\write\poemcontents{\string\contentspoemtitlefont\ |
| 10959 |
\the\textnotescontentsname} |
| 10960 |
\immediate\write |
| 10961 |
\poemcontents{\string~ / \string~\ \string\pageref{textualnotes} \string\par} |
| 10962 |
\immediate\write\poemcontents{\string\par \string\smallskip} |
| 10963 |
\fi |
| 10964 |
\ifexplanon |
| 10965 |
\immediate\write |
| 10966 |
\poemcontents{\string\contentspoemtitlefont\ \the\explanationscontentsname} |
| 10967 |
\immediate\write |
| 10968 |
\poemcontents{\string~ / \string~\ \string\pageref{explanatorynotes}} |
| 10969 |
\fi |
| 10970 |
\ifindexingon |
| 10971 |
\immediate\write\poemcontents{\string\par \string\smallskip} |
| 10972 |
\immediate\write |
| 10973 |
\poemcontents{\string\contentspoemtitlefont\ \the\poemindexcontentsname} |
| 10974 |
\immediate\write |
| 10975 |
\poemcontents{\string~ / \string~\ \string\pageref{indexpage}\string\par} |
| 10976 |
\fi |
| 10977 |
\immediate\closeout\poemcontents |
| 10978 |
\input \jobname.ctn |
| 10979 |
\fi |
| 10980 |
\clearpage |
| 10981 |
\thispagestyle{volumetitlestyle} |
| 10982 |
\vspace{106pt} |
| 10983 |
\begin{center} |
| 10984 |
{\poemtitlefont Note} |
| 10985 |
\end{center} |
| 10986 |
|
| 10987 |
\noindent The symbol \stanzaatbottomvalue\ is used to indicate |
| 10988 |
a space between sections of a poem |
| 10989 |
wherever such spaces are lost in pagination. |
| 10990 |
\cleardoublepage |
| 10991 |
} |
| 10992 |
% \end{macrocode} |
| 10993 |
% \end{macro} |
| 10994 |
% \begin{macro}{\testforauxonfirstrun} Put this in the preamble. It suppresses |
| 10995 |
% |\finish|, |\puttextnotes|, |\putemendations|, and |\putexplanatory| unless |
| 10996 |
% there is an .aux file from a previous run, this avoiding some error messages. |
| 10997 |
% |
| 10998 |
% \begin{macrocode} |
| 10999 |
\newcommand{\testforauxonfirstrun}{\IfFileExists{\jobname.aux}{\relax} |
| 11000 |
{\let\finish=\relax |
| 11001 |
\let\puttextnotes=\relax |
| 11002 |
\let\putexplanatory=\relax |
| 11003 |
\let\putemendations=\relax |
| 11004 |
\typeout{Run again to read in endnotes files}}} |
| 11005 |
% \end{macrocode} |
| 11006 |
% \end{macro} |
| 11007 |
% \begin{macro}{\putpoemcontents} |
| 11008 |
% You may wish to do the tasks done by |\finish| separately. This will give you |
| 11009 |
% more flexibility. |\putpoemcontents| inserts the table of contents file from a |
| 11010 |
% prior run. Be sure to issue it \emph{before} you issue |\makepoemcontents.| |
| 11011 |
|
| 11012 |
% \begin{macrocode} |
| 11013 |
\newcommand{\putpoemcontents}{ |
| 11014 |
\IfFileExists{\jobname.ctn}{\input \jobname.ctn |
| 11015 |
\clearpage \resetpagestyle\normalsize} |
| 11016 |
{\typeout{Run again to input contents file here}} |
| 11017 |
} |
| 11018 |
% \end{macrocode} |
| 11019 |
% \end{macro} |
| 11020 |
% \begin{macro}{\hyphenationforsmall} This command restores hyphenation for the |
| 11021 |
% backmatter sections of the book. Hyphenation is turned off in the main body of |
| 11022 |
% the book, because verse should not be hyphenated. This macro turns hyphenation |
| 11023 |
% on, but only for small roman, italic, and bold fonts. Backmatter sections are |
| 11024 |
% all set in |\small|. |\putemendations|, |\puttextnotes|, and |
| 11025 |
% |\putexplanatory| all call |\hyphenationforsmall|. |
| 11026 |
% |
| 11027 |
% \begin{macrocode} |
| 11028 |
\newcommand{\hyphenationforsmall}{\small\bf \hyphenchar\font=45 |
| 11029 |
\small\it \hyphenchar\font=45 |
| 11030 |
\small\rm \hyphenchar\font=45 |
| 11031 |
} |
| 11032 |
% \end{macrocode} |
| 11033 |
% \end{macro} |
| 11034 |
% \begin{macro}{\putemendations} This macro closes external file for emendations, |
| 11035 |
% reads it in, and puts an entry for the emendations into the table of contents |
| 11036 |
% file. The macro tests to see whether there is an .aux file from a previous run |
| 11037 |
% before doing this, and complains in the .log file if the .aux file does not |
| 11038 |
% exist. |
| 11039 |
% |
| 11040 |
% \begin{macrocode} |
| 11041 |
\newcommand{\putemendations}{ |
| 11042 |
\ifemendationson |
| 11043 |
\ifemendationstwocol |
| 11044 |
\literalemend{\end{multicols}} |
| 11045 |
\fi %\iftextnotetwocol |
| 11046 |
\newpage |
| 11047 |
\hyphenationforsmall |
| 11048 |
\immediate\closeout\emendations |
| 11049 |
\input \jobname.emd |
| 11050 |
\contentsendnotestitle{\the\emendationscontentsname}{emendationnotes} |
| 11051 |
\else |
| 11052 |
\relax |
| 11053 |
\fi} |
| 11054 |
% \end{macrocode} |
| 11055 |
% \end{macro} |
| 11056 |
% \begin{macro}{\putexplanatory} Does the same for explanatory notes. |
| 11057 |
% |
| 11058 |
% \begin{macrocode} |
| 11059 |
\newcommand{\putexplanatory}{ |
| 11060 |
\ifexplanon |
| 11061 |
\ifexplanationstwocol |
| 11062 |
\literalexplain{\end{multicols}} |
| 11063 |
\fi %\iftextnotetwocol |
| 11064 |
\newpage |
| 11065 |
\hyphenationforsmall |
| 11066 |
\immediate\closeout\explanations |
| 11067 |
\input \jobname.enx |
| 11068 |
\ifpoemcontentson |
| 11069 |
\ifexplanon |
| 11070 |
\contentsendnotestitle{\the\explanationscontentsname}{explanatorynotes} |
| 11071 |
\fi |
| 11072 |
\fi |
| 11073 |
\else |
| 11074 |
\relax |
| 11075 |
\fi} |
| 11076 |
% \end{macrocode} |
| 11077 |
% \end{macro} |
| 11078 |
% \begin{macro}{\puttextnotes} Does the same for textual notes. |
| 11079 |
% |
| 11080 |
% \begin{macrocode} |
| 11081 |
\newcommand{\puttextnotes}{ |
| 11082 |
\iftextnoteson |
| 11083 |
\iftextnotestwocol |
| 11084 |
\literaltextnote{\end{multicols}} |
| 11085 |
\fi %\iftextnotetwocol |
| 11086 |
\newpage |
| 11087 |
\hyphenationforsmall |
| 11088 |
\immediate\closeout\textnotes |
| 11089 |
\input \jobname.ent |
| 11090 |
\contentsendnotestitle{\the\textnotescontentsname}{textualnotes} |
| 11091 |
\else |
| 11092 |
\relax |
| 11093 |
\fi} |
| 11094 |
% \end{macrocode} |
| 11095 |
% \end{macro} |
| 11096 |
% \begin{macro}{\putpoemindex} Reads in the index of titles and first lines |
| 11097 |
% and adds an entry for the index |
| 11098 |
% into the table of contents. |
| 11099 |
% |
| 11100 |
% \begin{macrocode} |
| 11101 |
\newtoks{\poemindexname} |
| 11102 |
\poemindexname={Index of Titles and First Lines} |
| 11103 |
\newcommand{\changepoemindexname}[1]{\poemindexname={#1}} |
| 11104 |
\newtoks{\poemindexheadername} |
| 11105 |
\poemindexheadername={Index of Titles and First Lines} |
| 11106 |
\newcommand{\changepoemindexheader}[1]{\poemindexheadername={#1}} |
| 11107 |
\newtoks{\poemindexcontentsname} |
| 11108 |
\poemindexcontentsname={Index of Titles and First Lines} |
| 11109 |
\newcommand{\changepoemindexcontentsname}[1]{\poemindexcontentsname={#1}} |
| 11110 |
\newcommand{\putpoemindex}{\ifindexingon |
| 11111 |
\printindex |
| 11112 |
\fi |
| 11113 |
\ifpoemcontentson\ifindexingon |
| 11114 |
\immediate\write\poemcontents{\string\par \string\smallskip} |
| 11115 |
\immediate\write |
| 11116 |
\poemcontents{\string\contentspoemtitlefont\ \the\poemindexcontentsname} |
| 11117 |
\immediate\write |
| 11118 |
\poemcontents{\string~\string\contentsleaders \string~\ \string\pageref{indexpage}\string\par} |
| 11119 |
\fi\fi} |
| 11120 |
\newcommand{\putmultiplepoemindex}[4]{% |
| 11121 |
\ifindexingon |
| 11122 |
\poemindexname={#2} |
| 11123 |
\poemindexheadername={#3} |
| 11124 |
\poemindexcontentsname={#4} |
| 11125 |
\poemindexlabelname={#4} |
| 11126 |
\printindex[#1][#2] |
| 11127 |
\fi |
| 11128 |
\ifpoemcontentson\ifindexingon |
| 11129 |
\immediate\write\poemcontents{\string\par \string\smallskip} |
| 11130 |
\immediate\write |
| 11131 |
\poemcontents{\string\contentspoemtitlefont\ \the\poemindexcontentsname} |
| 11132 |
\immediate\write |
| 11133 |
\poemcontents{\string~ \string\contentsleaders \string~\ |
| 11134 |
\string\pageref{\the\poemindexlabelname}\string\par} |
| 11135 |
\fi\fi |
| 11136 |
} |
| 11137 |
\newcommand{\noteaboutstanzamarkpage}{\begin{volumetitlepage} |
| 11138 |
%\thispagestyle{volumetitlestyle} |
| 11139 |
\vspace{106pt} |
| 11140 |
\begin{center} |
| 11141 |
{\poemtitlefont Note} |
| 11142 |
\end{center} |
| 11143 |
|
| 11144 |
\noindent The symbol \stanzaatbottomvalue\ is used to indicate |
| 11145 |
a space between sections of a poem |
| 11146 |
wherever such spaces are lost in pagination. |
| 11147 |
\end{volumetitlepage}} |
| 11148 |
% \end{macrocode} |
| 11149 |
% \end{macro} |
| 11150 |
% \subsection{~Visual formatting} The ideal in \LaTeX\ is to separate |
| 11151 |
% content markup and formatting as completely as possible. In the text |
| 11152 |
% itself you simply mark the logical units (a poem, a title, a stanza, |
| 11153 |
% a textual note), and a header program like this interprets the |
| 11154 |
% meaning of those terms typographically. However, one still winds up |
| 11155 |
% having to do some visual formatting. Sometimes you have to enlarge or |
| 11156 |
% shrink a page by one line in order to avoid an intractable widow or |
| 11157 |
% club line, and when one does so one must be careful to do the same to |
| 11158 |
% the other member of the two-page spread of which that page is a part. |
| 11159 |
% These commands enable one to wiggle pagelength enough to handle these |
| 11160 |
% problems. |
| 11161 |
% \begin{macrocode} |
| 11162 |
\newcommand{\longpage}{\enlargethispage{\baselineskip}} |
| 11163 |
\newcommand{\shortpage}{\enlargethispage{-\baselineskip}} |
| 11164 |
% \end{macrocode} |
| 11165 |
% |
| 11166 |
|
| 11167 |
% \subsection{~Special environments: cjquotation and theindex} |
| 11168 |
% An environment for special prose quotations within verse |
| 11169 |
% as in ``Chief Joseph of the Nez Perce'' |
| 11170 |
% |
| 11171 |
% \goodbreak |
| 11172 |
% |
| 11173 |
% \begin{macro}{cjquotation} |
| 11174 |
% \begin{macrocode} |
| 11175 |
\newenvironment{cjquotation} |
| 11176 |
{\tolerance=2000% |
| 11177 |
\vspace{-\bigskipamount} |
| 11178 |
\restoreverselinenumber |
| 11179 |
\language=255 |
| 11180 |
\noindent\relax |
| 11181 |
\list{}{\listparindent 0em% |
| 11182 |
\itemindent 0em% |
| 11183 |
\rightmargin 2em% |
| 11184 |
\leftmargin 2em% |
| 11185 |
\topsep 0em% |
| 11186 |
\parskip 0em% |
| 11187 |
\itemindent \listparindent |
| 11188 |
\rightmargin \leftmargin |
| 11189 |
\parsep \z@ \@plus\p@}% |
| 11190 |
\item[] |
| 11191 |
} |
| 11192 |
{\endlist} |
| 11193 |
% \end{macrocode} |
| 11194 |
% \end{macro} |
| 11195 |
% \begin{macro}{theindex} |
| 11196 |
% And the environment for the index: |
| 11197 |
% \begin{macrocode} |
| 11198 |
\newtoks{\poemindexlabelname} |
| 11199 |
\poemindexlabelname={indexpage} |
| 11200 |
\newcommand{\changepoemindexlabelname}[1]{\poemindexlabelname={#1}} |
| 11201 |
\renewenvironment{theindex} |
| 11202 |
{{\par\clearpage{\pagestyle{volumetitlestyle}\cleardoublepage} |
| 11203 |
\thispagestyle{volumetitlestyle}} |
| 11204 |
\makeatletter |
| 11205 |
\def\pmclidxitem{\par\hangindent 1em} |
| 11206 |
\fancyhead[RO,LE]{{\small\textrm{\thepage}}} |
| 11207 |
\fancyhead[CO]{{\small{\em \the\poemindexheadername}}} |
| 11208 |
\fancyhead[CE]{{\small{\em \the\poemindexheadername}}} |
| 11209 |
\fancyfoot{} |
| 11210 |
\label{\the\poemindexlabelname} |
| 11211 |
\lefthyphenmin=2\tolerance=500\language=0 |
| 11212 |
\normalfont \backmattertextfont |
| 11213 |
\raggedright |
| 11214 |
\begin{multicols} |
| 11215 |
{2}[\backmattersink\begin{center}{\normalfont |
| 11216 |
\backmatterheaderfont \the\poemindexname}\end{center} |
| 11217 |
\backmatterafterheadersink]% |
| 11218 |
\let\item\pmclidxitem} |
| 11219 |
{\end{multicols}\clearpage} |
| 11220 |
\makeatother |
| 11221 |
% \end{macrocode} |
| 11222 |
% \end{macro} |
| 11223 |
% Finally, some other miscellaneous environments. |
| 11224 |
% \begin{macrocode} |
| 11225 |
\newlength{\epigraphquoteleftmargin} |
| 11226 |
\newlength{\epigraphquoterightmargin} |
| 11227 |
\setlength{\epigraphquoteleftmargin}{1.5em} |
| 11228 |
\setlength{\epigraphquoterightmargin}{1.5em} |
| 11229 |
\newif\ifleftalignepigraphs |
| 11230 |
\leftalignepigraphsfalse |
| 11231 |
\makeatletter |
| 11232 |
\newenvironment{epigraphquote}{\list{}{% |
| 11233 |
\ifleftalignepigraphs\left@ligntitleblock% |
| 11234 |
\rightmargin 1sp\leftmargin \lefttitlemargin% |
| 11235 |
\else |
| 11236 |
\rightmargin\epigraphquoterightmargin% |
| 11237 |
\leftmargin\epigraphquoteleftmargin% |
| 11238 |
\fi |
| 11239 |
\topsep 0pt% |
| 11240 |
\partopsep 0pt% |
| 11241 |
\listparindent 0pt% |
| 11242 |
}% |
| 11243 |
\item\relax} |
| 11244 |
{\endlist}\makeatother |
| 11245 |
\newenvironment{volumetitlepagequote}{\list{}{\rightmargin \voladditionalamount% |
| 11246 |
\leftmargin \voladditionalamount% |
| 11247 |
\topsep 0pt% |
| 11248 |
\partopsep 0pt% |
| 11249 |
\listparindent 0pt |
| 11250 |
}% |
| 11251 |
\item\relax} |
| 11252 |
{\endlist} |
| 11253 |
% \end{macrocode} |
| 11254 |
% \clearpage |
| 11255 |
% \Finale |
| 11256 |
\endinput |
| 11257 |
--------------060108090809060900030409-- |