diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/poemscol/poemscol.dtx')
-rw-r--r-- | Master/texmf-dist/source/latex/poemscol/poemscol.dtx | 292 |
1 files changed, 176 insertions, 116 deletions
diff --git a/Master/texmf-dist/source/latex/poemscol/poemscol.dtx b/Master/texmf-dist/source/latex/poemscol/poemscol.dtx index bc64abcd693..5794a2d575d 100644 --- a/Master/texmf-dist/source/latex/poemscol/poemscol.dtx +++ b/Master/texmf-dist/source/latex/poemscol/poemscol.dtx @@ -23,7 +23,7 @@ % \iffalse %<package>\NeedsTeXFormat{LaTeX2e}[1997/12/01] %<package>\ProvidesPackage{poemscol} -%<package> [2019/09/27 v3.14 poemscol file] +%<package> [2019/10/29 v3.141 poemscol file] % %<*driver> \documentclass{ltxdoc} @@ -38,7 +38,7 @@ %</driver> % \fi % -% \CheckSum{9920} +% \CheckSum{9964} % % \CharacterTable % {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 @@ -258,6 +258,11 @@ % \changes{v3.12}{2019/09/05}{Bug fix. Fix command clash with titlesec Manual revision} % \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} % \changes{v3.14}{2019/09/27}{Bug fix: ifpagenumberinnotesfalse, Manual revision} +% \changes{v3.141}{2019/10/27}{Manual revisions. Fixed spacing of sentence and +% paragraph numbers in +% sections numbered by paragraph and sentence. You can suppress the appearance of the +% first sentence number, whether in the margin or in the running text. You can suppress +% the appearance of the first paragraph number, whether in the margin or in the running text.} % \DoNotIndex{\newcommand,\newenvironment,\def,\edef,\else,\renewcommand,\makeatletter,\makeatother} % \DoNotIndex{\abovedisplayskip,\belowdisplayskip,\abovedisplayshortskip,\belowdisplayshortskip} % \DoNotIndex{\newcommand, \section, \subsection, \subsubsection, @@ -290,15 +295,15 @@ % \textsc, \unskip} % \setcounter{IndexColumns}{2} % \MakeShortVerb{|} -% \def\fileversion{3.14} -% \def\filedate{27 September 2019} -% \def\docdate{27 September 2019} +% \def\fileversion{3.141} +% \def\filedate{29 October 2019} +% \def\docdate{29 October 2019} % \title{Typesetting Poetry Collections with % \textsf{poemscol}\thanks{This document corresponds to % \textsf{poemscol}~\fileversion, dated \filedate.}} % \author{John Burt % \\ \texttt{burt@brandeis.edu}} -% \date{27 September 2019} +% \date{29 October 2019} % \maketitle % \begin{abstract} \textsf{poemscol} provides commands for \LaTeX\ for % setting collections of poetry. It is especially suited for setting @@ -348,7 +353,7 @@ % break at the bottom of a page which the reader might not notice. % Doing this by hand is not only tedious and easy to get wrong, but % also a process you will have to start over again if anything about -% your volume changes, if you add a poem, say, or even decide to break +% your volume changes --- if you add a poem, say, or even decide to break % a title across two lines. \textsf{poemscol} takes care of this % process, so that the editor need never worry about it, automatically % marking cases where the page break coincides with a stanza break @@ -391,7 +396,7 @@ % numbering will also be stable across multiple editions, and, like line numbers in verse, % provides a common system of reference. % -% \textsf{poemscol} also provides +% \textsf{poemscol} provides % the ability to make cross references to verse line numbers, to line numbers in prose sections, % or to paragraph and sentence numbers in sections with ``paragraph and sentence'' annotation. % @@ -458,7 +463,7 @@ % Encoding Initiative, transforming your texts from \LaTeX\ to XML % would largely (although not entirely) be a matter of performing a % series of global search-and-replaces, and could conceivably be done -% with a perl script. +% with XSLT or with perl. % % This is a long manual, but there is no need to study it all before beginning. % In the first place, it includes all the commented-on source code for the @@ -1183,9 +1188,8 @@ % automatically anyway). |\verseindent| indents the line a bit less % than the run over portion of long ``bent'' lines are indented, so % that the two cases can be visually distinguished. By default, the -% length of |\verseindent| is 2 em. To change it, say to 3 em, issue -% |\renewcommand{\verseindent}{\hspace{3em}}|. -% Alternatively, you can change the length |\verseindentamount| by +% length of |\verseindent| is 2 em. To change it, say to 3 em, you should change +% the length |\verseindentamount| by % issuing |\setlength{\verseindentamount}{3em}|.\end{sloppypar}\goodbreak % % You can create a hierarchy of indentations by issuing |\verseindent| @@ -1861,7 +1865,9 @@ % poem's title in the notes, issue |\puttitleinnotesfalse|. \textsf{poemscol} assumes % that the notes to a poem will begin with either the poem's title, or its page number, or both, % so although you can set either boolean to ``false,'' don't set both of them to ``false." -% \textsf{poemscol} will let you do this, but the results will be strange. +% \textsf{poemscol} will let you do this, but the results will be strange. Also, |\putitleinnotesfalse| +% applies only the textnotes. Emendations, explanatory notes, and any note types you create +% with |\definenewnotetype| will include the title of the poem. % % \goodbreak % \DescribeMacro{\contentsendnotesindent} @@ -2314,6 +2320,7 @@ % By default, each poem end note is given its own paragraph. To concatenate % them into one big paragraph, issue |\poemendemendationnotessingleparfalse|. % +% \begin{sloppypar} % \DescribeMacro{\poemendexplanatorynote} % \DescribeMacro{\makepoemendexplanatorynotes} % \DescribeMacro{\putpoemendexplanatorynotes} @@ -2322,7 +2329,7 @@ % after |\begin{poem}|. Issue |\poemendexplanatorynote| where you wish to make a note, % using the same conventions you use for |\textnote|. Where you want to output % the notes, issue |\putpoemendexplanatorynotes|. These notes can have multi-line lemmas, -% just like textual notes. +% just like textual notes.\end{sloppypar} % % By default, each poem end note is given its own paragraph. To concatenate % them into one big paragraph, issue |\poemendexplanatorynotessingleparfalse|. @@ -2449,33 +2456,68 @@ % \DescribeMacro{\attribution} \DescribeMacro{\poemdedication} % |\epigraph|, |\headnote|, |\attribution|, and |\poemdedication| set % their arguments as epigraphs, headnotes, attributions, or -% dedications for poems or poetic sequences. \goodbreak +% dedications for poems or poetic sequences. +% There are in addition the special commands |\JHepigraph| and |\JHdedication|, which place +% a mark in the margin +% showing where in the notes comments on that epigraph or dedication may be found. +% +% \DescribeMacro{\volumeepigraph} If you have dedications, epigraphs, or attributions on +% the divider pages of editions that combine several volumes of +% poetry, use |\volumededication|, |\volumeepigraph|, and +% |\volumeattribution|. % +% \DescribeMacro{\centertitles} +% If |\centertitles| or |\centeritlescheme| is in effect, epigraphs, headnotes, dedications, +% and attributions will all be centered on the page. (|\volumeepigraph|, |\volumededication|, +% and |\volumeattribution|, however, are unaffected by |\centertitles|.) % If your epigraph or headnote is a prose passage of more than one line, or % of more than one paragraph, or a verse -% passage of more than one stanza, the |\epigraph| command will work -% properly, which is to say it will draw the margins in towards the center, +% passage of more than line, or even more than one stanza, the |\epigraph| command will work +% properly if |\centertitles| is in effect, which is to say it will draw the margins in towards the center, % rather than centering the epigraph line by line. % +% Issuing |\centertitles| moves the margins in on both sides by the length +% |\centerepigraphindentation| (the default is 6em). The margins for +% uncentered epigraphs and the like are controlled by the length |\normalepigraphindentation| +% (the default is 1.5em). Both values can be adjusted by using |\setlength|. +% +% After issuing |\centertitles| you can move epigraphs and similar things back to the margin +% by issuing |\centerepigraphsonfalse|. After issuing |\centertitles| you can put titles at the margin +% while leaving epigraphs alone by issuing |\centertitlesonfalse|. +% % If you use the standard \LaTeX\ |verse| % environment within an epigraph, you may wish to add a |\smallskip| between % stanzas. (To my eye that environment does not leave enough white space between -% stanzas.) Alternatively, you can use the special |pmclverse| environment -% within the |epigraphenvironment| environment. You can even use -% the |poem| environment within the |epigraphenvironment| environment, but if +% stanzas.) Alternatively, you can use the special |pmclverse| environment. +% You can even use +% the |poem| environment, but if +% you do this, you should so mark line breaks with |\\| and stanza breaks +% with a blank line, as in the standard |verse| environment. If % you mark up the epigraph with things like |\verseline| and |\end{stanza}| you may wind -% up with marginal line numbers, so mark line breaks with |\\| and stanza breaks -% with a blank line, as in the standard |verse| environment.) +% up with marginal line numbers in your epigraph. % -% Because |\centerepigraphs| merely -% draws in the margins on both sides, short passages may not appear -% centered very well, unless you fool around with |\versewidth| to -% find a satisfactory value. |\shortpoemepigraph| and similar commands, described -% below, are better for single line epigraphs. +% \begin{sloppypar}You +% may also wish to align epigraphs, dedications, attributions, or +% headnotes with the left margin of the verse block (even if you +% center the titles). To do this, issue |\leftalignepigraphstrue| to +% set the boolean |\ifleftalignepigraphs|. Remember that for |\leftalignepigraphstrue| to +% work, you will need to use the |\settowidth| command. Issue +% |\settowidth{\versewidth}{Text to be used for centering.}| just +% before you issue the |\poemtitle| command. +% |\leftalignepigraphstrue| will also align attributions, +% dedications, and other pre-texts of poems. \end{sloppypar} % % \DescribeMacro{\shortpoemepigraph} -% \DescribeMacro{shortpoemdedication} -% \DescribeMacro{shortpoemattribution} \begin{sloppypar} The commands +% \DescribeMacro{\shortpoemdedication} +% \DescribeMacro{\shortpoemattribution} +% Because |\centerepigraphs| merely +% draws in the margins on both sides rather than centering each line +% line by line, short epigraphs may not appear +% well centered. |\shortpoemepigraph| |\shortpoemdedication| and +% |\shortpoemattribution|, are better for single line epigraphs, +% since they will center their arguments line by line. +% +% \begin{sloppypar} The commands % |\shortpoemepigraph| |\shortpoemdedication| and % |\shortpoemattribution| will all place their texts in % accordance with the title placement scheme you select in your @@ -2486,58 +2528,18 @@ % margin. % |\titlescenteredonleftverseblockscheme| will center them over the % longest line of a left-flushed verse block. -% |\centertitlesscheme| will center them. % |\titlesatleftmarginofcenteredblockscheme| will place them at the -% left margin of a centered verse block. A short epigraph set using the -% normal |\epigraph| command may not appear centered, because |\epigraph| does not -% center the text line by line, but centers the paragraph block by drawing in the margins. -% If your epigraph is short, perhaps a single line, only |\shortpoemepigraph| will give -% it a centered appearance on the page if the |\centertitles| scheme is being used or -% if the boolean |\centerepigraphson| is in effect. I have also included +% left margin of a centered verse block. +% |\centertitlesscheme| will center them over a centered verse block. +% You can center epigraphs and similar things on the page over an uncentered verse block +% by issuing the boolean |\centerepigraphson|. +% +% \DescribeMacro{\JHshortepigraph} +% I have also defined % |\JHshortepigraph| and |\JHshortdedication|, which set marginal % marks pointing to where notes on the epigraph or dedication in the textual notes section may be -% found, in the manner of |\JHpoemtitle|.\end{sloppypar} -% -% \DescribeMacro{\centertitles} -% Issuing |\centertitles| moves the margins in on both sides by the length -% |\centerepigraphindentation| (the default is 6em). The margins for -% uncentered epigraphs and the like are controlled by the length |\normalepigraphindentation| -% (the default is 1.5em). Both values can be adjusted by using |\setlength|. -% -% After issuing |\centertitles| you can move epigraphs and similar things back to the margin -% by issuing |\centerepigraphsonfalse|. After issuing |\centertitles| you can put titles at the margin -% while leaving epigraphs alone by issuing |\centertitlesonfalse|. -% -% If you have dedications, epigraphs, or attributions on -% the divider pages of editions that combine several volumes of -% poetry, use |\volumededication|, |\volumeepigraph|, and -% |\volumeattribution|. These commands are unaffected by |\centertitles|. -% -% \begin{sloppypar} -% \DescribeMacro{\titlesatleftmarginofcenteredblock} -% -% Rather than centering the title over -% a centered block of verse, one might prefer to align the title with -% the left margin of the verse block. To do this, issue -% |\titlesatleftmarginofcenteredblocktrue| to set the boolean |\iftitlesatleftmarginofcenteredblock|. -% This command has been made obsolete by the introduction of ``title indentation schemes,'' but -% it still works so long as you issue it after you have set the title indentation scheme. -% -% You -% may also wish to align epigraphs, dedications, attributions, or -% headnotes with the left margin of the verse block (even if you -% center the titles). To do this, issue |\leftalignepigraphstrue| to -% set the boolean |\ifleftalignepigraphs|. This will align |\epigraph| and its congeners, -% but not the newer commands |\shortpoemepigraph| and its congeners, -% who obey the prevailing title indentation scheme. Remember that for |\leftalignepigraphstrue| to -% work, you will need to use the |\settowidth| command. Issue -% |\settowidth{\versewidth}{Text to be used for centering.}| just -% before you issue the |\poemtitle| command. -% |\leftalignepigraphstrue| will also align attributions, -% dedications, and other pre-texts of poems. (It will not affect the -% dedications and attributions on volume title pages, which are set -% using the |\volumededication|, |\volumeepigraph|, and -% |\volumeattribution| commands.)\end{sloppypar} +% found, in the manner of |\JHpoemtitle|. +% These commands too obey the title placement scheme that may be in effect. \end{sloppypar} % % \subsection{~Appending publication date} % \DescribeMacro{\poemdate} You can append the date of the poem @@ -2559,7 +2561,8 @@ % flush with the indented runover portion of the line rather than with the beginning % of the line. This should not in practice % be a problem, because you should use |\longpage| or several |\shortpage| commands -% to move the widow date line anyway. (For |\longpage| and |\shortpage| see section \ref{longpage}, +% to move the widowed date line anyway. +% (For |\longpage| and |\shortpage| see section \ref{longpage}, % page \pageref{longpage}.) % % \subsection{~Pausing line numbering} @@ -2649,7 +2652,7 @@ % |\sequencesectiontitle| sets the titles of the sections of the % sequence, and |\sequencesubsectiontitle| sets the titles of % subsections of the sequence (there is even a command for the title -% of sub-subsections, |\sequencesubsbusectiontitle|). +% of sub-subsections, |\sequencesubsubsectiontitle|). % |\sequencefirstsectiontitle| gives a little more % vertical space between the main title and the first section title % than |\sequencesectiontitle| gives between adjacent sections later @@ -2686,8 +2689,8 @@ % \item |\poemtitlenotitle| % \item |\poemtitlenocontents| % \item |\poemtitlebaretitle| -% \item |\poemonlycontents| -% \item |\poemonlynotes| +% \item |\poemtitleonlycontents| +% \item |\poemtitleonlynotes| % \end{itemize} % \item Poems in Sections % \begin{itemize} @@ -2856,6 +2859,7 @@ % no longer needs to treat italics in titles in a different way, it can % be anything you want, since the second argument is discarded.) % +% \begin{sloppypar} % \DescribeMacro{\poemtitlenotitleitalic} % |\poemtitlenotitleitalic|, with its doubly paradoxical name, % is for poems without formal titles but with italicized words in their @@ -2864,7 +2868,7 @@ % purposes), and the second is the % first line without the italics (for crossreference purposes). This command % is obsolete now that italics in titles no longer require special -% handing, but is retained for backwards compatibility. +% handing, but is retained for backwards compatibility.\end{sloppypar} % % \subsection{~Problem titles} % \DescribeMacro{\poemtitlebaretitle} @@ -3024,7 +3028,7 @@ % by changing the definition of the indentation command. (e.g. % |\renewcommand{\poemtitleindent}{\hspace{3em}}.)| For many of these % indentations you can also simply change the applicable length (e.g. -% |\setlength{\\sequencesubtitleindentmount}{\titleindenttwoamount}|. ) +% |\setlength{\sequencesubtitleindentmount}{\titleindenttwoamount}|. ) % % The ``amount'' part in the command % is important. |\poemtitleindentamount| is a length. On the other @@ -3035,7 +3039,7 @@ % indentations. In the table ``Extra Lines'' refers to the indentation for the second and third lines % (and so on) of multi-line titles. If you wish to change the % indentation of any of the titles whose default length is listed as -% 0 in the table below, you must use the |\renewcommand| method. (I +% 0 in the table, you must use the |\renewcommand| method. (I % found that setting the length of one of the indentations to 0pt % added a few points of white space I could not figure out how to get % rid of, so by default those commands are defined not by using a @@ -3107,6 +3111,7 @@ %Sequence Section & |\contentssequencesectiontitleindentamount| & |\contentsindenttwoamount| \\ %Extra Lines & |\contentssequencesectiontitlesecondlineindentamount| & |\contentsindenttwoamount| \\ %Sequence Subsection & |\contentssequencesubsectiontitleindentamount| & |\contentsindentthreeamount| \\ +% Sequnce Subsubsection & Does not appear in Contents & \\ %Appendix or Foreword & |\contentsappendixtitleindentamount| & |0pt| \\ %Notes Sections & |\contentsnotestitleindentamount| & |0pt| % @@ -3227,11 +3232,11 @@ % You can find the default % definitions of those ``fancy'' and ``main'' below at \ref{pagestyledefs}, page \pageref{pagestyledefs}. % -% +%\begin{sloppypar} % You can change the text in the left (verso) running head % by issuing |\leftheader{your header}| or |\volumeheader{your header}|. (The commands % are synonyms.) You can change the text in the right (recto) running head by issuing -% |\rightheader{your header}|. +% |\rightheader{your header}|. \end{sloppypar} % % \subsection{~Special page style for long poems} The fancy page style ``longpoem'' % will add information of the form ``firstline--lastline'' to the running header. This @@ -3251,17 +3256,20 @@ % headers for the backmatter % sections. % +% \begin{sloppypar} % The header will include the abbreviation l.\ (for a single line) or ll.\ (for a range of lines). % You can change either abbreviation with |\changesinglelineabbrev| or % |\changemultiplelineabbrev|. So, for instance, to get rid of the abbreviations % entirely, issue |\changemultiplelineabbrev{\relax}| and |\changesinglelineabbrev{\relax}|. +% \end{sloppypar} % +% \begin{sloppypar} % You may need to play with |\leftheader| and |\rightheader| to get the information you % want into the header. You might, for instance, what to use something like % |\leftheader{``Your main title'' \hfil ``Your poem title''}| and % |\rightheader{``Your volume title'' \hfil ``Your poem title''}|. Whatever else you put into % the header, the last thing should be your poem title, since it will be followed by the line -% numbers. +% numbers.\end{sloppypar} % % \subsection{~Page geometry and type leading} % @@ -3404,6 +3412,7 @@ % % % \subsection{Endnotes for prose sections} +% \begin{sloppypar} % \DescribeMacro{\prosetextnote} % \DescribeMacro{\prosemendation} % \DescribeMacro{\proseexplanatory} @@ -3435,8 +3444,8 @@ % every note. The third argument is the text of the note, which % should include both the lemma and the rest of the note, as in the % notes for verse sections. -% |\proseemendation[]| and -% |\proseexplanatory[]| are coded the same way. So, if you wished +% |\proseemendation| and +% |\proseexplanatory| are coded the same way. So, if you wished % to make a textual note on a passage that begins with ``Call me % Ishmael.'' and ends ``a way of driving away the spleen,'' you would % issue at the point where the note is to @@ -3446,16 +3455,16 @@ % {Call me Ishmael \ldots\ a way of driving away the spleen] text of % textual note} \end{verbatim} On the % last line of the passage to which the note refers you would -% issue: \\ |\proselinelabel{a way of driving away the spleen}|. +% issue: \\ |\proselinelabel{a way of driving away the spleen}|.\end{sloppypar} % % \DescribeMacro{\prosetsvariant} % \DescribeMacro{\proseaccidental} % \DescribeMacro{\prosetsaccidental} % You can issue |\sources| and |\tsentry| in prose contexts as usual. % For typescript variants and accidental variants you need to issue -% |\prosetsvariant[]|, |\proseaccidental|, and +% |\prosetsvariant|, |\proseaccidental|, and % |\prosetsaccidental|. |\prosetsvariant| is entered just as -% |\prosetextnote[]| is, with an optional argument (for use with +% |\prosetextnote| is, with an optional argument (for use with % line ranges, as usual), and two mandatory arguments (the first a % label to capture the line number, the second the lemma and comment). % @@ -3542,7 +3551,7 @@ % line, marking them with these commmands will ensure that the % marginal sentence numbers do not overwrite each other. These commands % are something of a kludge, but they will do until I figure out how -% to do this better. +% to do this better.\newpage % % \DescribeMacro{\pmnumberstoright} % \DescribeMacro{\pmnumberstoleft} @@ -3558,13 +3567,14 @@ % (|\versenumberstoright| or whatever) again when you move from a % prose to a verse environment. % -% +% \begin{sloppypar} % |\runningsentencenumberformat| sets the format of running sentence % numbers. Currently it is |\textsuperscript| (the numbers are set as superscripts) and |\tiny|. % The format of marginal sentence % numbers is set by |\marginsentencenumberformat|. Currently it is % |\tiny|. Definitions of both commands are found at section \ref{runningsentencenumberformat}, % page \pageref{runningsentencenumberformat}. You can change either with |\renewcommmand|. +%\end{sloppypar} % % \DescribeMacro{\pmpara} % \DescribeMacro{\pmsentencebypara} @@ -3610,6 +3620,15 @@ % |\textbf| and |\small|. The definitions of these commands are found at % section \ref{pmparrunningformat}, page \pageref{pmparrunningformat}, Either can % be changed with |\renewcommand|. +% +% \DescribeMacro{\ifsupressfirstpara} +% \DescribeMacro{\ifsuppressfirstsentence} +% Some readers find it annoying to have the first sentence or the first paragraph marked. +% To suppress the appearance of the first sentence number, whether in the margin or in the +% running text, issue |\suppressfirstsentencetrue|. To suppress the appearance of the +% first paragraph number, whether in the margin or in the running text, issue |\suppressfirstparatrue|. +% These commands will not affect the appearance of entries in the endnote +% sections or in the footnotes. % % \subsection{~Cross references by sentence and paragraph} % \DescribeMacro{\sentencelabel} @@ -3663,7 +3682,7 @@ % |\prosetextnote|. |\emendationsatfoot| and |\explanationsatfoot| % work the same way. % \subsection{~Bible chapter and verse} -% Since |\pmsentence| and |\pmpar| are the moral equivalents of bible +% Since |\pmsentence| and |\pmpara| are the moral equivalents of bible % verse and chapter, |\biblechapter| and |\bibleverse| are provided % for convenience. @@ -3685,6 +3704,7 @@ % side. |\synchroref| will even tag the marginal line number it makes % with a marker to specify the text to which it refers. % +% \begin{sloppypar} % \DescribeMacro{\startparalleltexts} % \DescribeMacro{\finishparalleltexts} % \DescribeEnv{parallelverse} @@ -3697,7 +3717,7 @@ % |\begin{parallelverse}| and |\end{parallelverse}| rather than |\startparalleltexts| % and |\finishparalleltexts|. % |\startparalleltexts| and |\finishparalleltexts| can be issued on their own -% but I have combined them to make the |parallelverse| environment. +% but I have combined them to make the |parallelverse| environment. \end{sloppypar} % % Although usually with \textsf{poemscol} it is up to you where to put % the marginal line numbers, when you issue |\startparalleltexts| the @@ -3706,7 +3726,7 @@ % correspond to which lines in the verso text, which % are made with |\synchroref|) are in the right margin. % -% +%\begin{sloppypar} % \DescribeMacro{\startrectopage} % \DescribeMacro{\finishrectopage} % \DescribeMacro{\startversopage} @@ -3717,8 +3737,8 @@ % |\finishrectopage|. You have to declare the page breaks manually, % so be sure you are putting the |\finishversopage| or |\finishrectopage| commands % in places which -% will work. |\finishparalleltexts| just makes certain that stanzas, and poems -% that you opened in a region of parallel texts are closed when you leave it. +% will work. |\finishparalleltexts| just makes certain that stanzas, and poems, +% that you opened in a region of parallel texts are closed when you leave it.\end{sloppypar} % % \DescribeMacro{\versopoemtitle} % \DescribeMacro{\rectopoemtitle} @@ -3776,21 +3796,21 @@ % \medskip % % \noindent|\newcommand{\keeptitlesstraight}{|\\ -% |\pretocmd{\fivetextnote}{\versotitleinnotescheck}{\relax}{\relax}| -% |\pretocmd{\fiveemendation}{\versotitleinnotescheck}{\relax}{\relax}| -% |\pretocmd{\fiveexplanatory}{\versotitleinnotescheck}{\relax}{\relax}| -% |\pretocmd{\fiftytextnote}{\rectotitleinnotescheck}{\relax}{\relax}| -% |\pretocmd{\fiftyemendation}{\rectotitleinnotescheck}{\relax}{\relax}| -% |\pretocmd{\fiftyexplanatory}{\rectotitleinnotescheck}{\relax}{\relax}| +% |\pretocmd{\fivetextnote}{\versotitleinnotescheck}{\relax}{\relax}|\\ +% |\pretocmd{\fiveemendation}{\versotitleinnotescheck}{\relax}{\relax}|\\ +% |\pretocmd{\fiveexplanatory}{\versotitleinnotescheck}{\relax}{\relax}|\\ +% |\pretocmd{\fiftytextnote}{\rectotitleinnotescheck}{\relax}{\relax}|\\ +% |\pretocmd{\fiftyemendation}{\rectotitleinnotescheck}{\relax}{\relax}|\\ +% |\pretocmd{\fiftyexplanatory}{\rectotitleinnotescheck}{\relax}{\relax}|\\ % |}| % % \medskip -% +%\begin{sloppypar} % All those fields filled with |\relax| are for reporting the success or failure % |\pretocmd| has had in appending |\versotitleinnotescheck| (or |\rectotitleinnotescheck|) % to the different endnotes commands. You may wish to replace % the |\relax| with something like |\typeout{fiftytextnote modified}| or -% |\typeout{fiftytextnote not modified}|. +% |\typeout{fiftytextnote not modified}|. \end{sloppypar} % %If you are using the |\keeptitlestraight| % hack described here, you should add \textsf{etoolbox} @@ -3811,6 +3831,7 @@ % |}| % % \subsection{~Parallel texts and generic note types} +% \begin{sloppypar} % \DescribeMacro{\rectotexnote} % \DescribeMacro{\rectoemendation} % \DescribeMacro{\rectoexplanatory} @@ -3822,13 +3843,21 @@ % editions: |\rectotextnote|, |\rectoeemendation|, |\rectoexplanatory|, % |\versotextnote|, |\versoemendation|, and |\versoexplanatory,| as well as |\rectoprosetexnote|, % |\versoprosetextnote,| |\rectoproseemendation,| |\versoproseemendation|, -% |\rectoproseexplanatory|, and |\versoproseexplanatory.| (I have also defined +% |\rectoproseexplanatory|, and |\versoproseexplanatory.| +% \end{sloppypar} +% +% \begin{sloppypar} +% I have also defined % |\literalrectotextnote|, |\literalversotextnote|, |\literalrectoemendation|, |\literalversoemendation|, % |\literalrectoexplain|, and |\literalversoexplain| for sending material other than formal % endnotes to these endnote sections. -% You can use all of these without issuing the moral equivalent of |\keeptitlesstraight| and +% \end{sloppypar} +% +% You can use all of these without creating versions of |\keeptitlesstraight| and % |\resettitleinnotes|. % +% +% \begin{sloppypar} % \DescribeMacro{\makerectotexnotes} % \DescribeMacro{\makerectoemendations} % \DescribeMacro{\makerectoexplanatorynotes} @@ -3839,7 +3868,9 @@ % just as you would do with |\textnote|, |\emendation| or |\explanatory| (or |\literalversotextnote| % |\literalversoemendation| and |\literalversoexplain|), without any of the special hacks % I have just described. +% \end{sloppypar} % +% \begin{sloppypar} % \DescribeMacro{\changerectotextnotesname} % \DescribeMacro{\changerectotextnotesheader} % \DescribeMacro{\rectotextnotessinglepar} @@ -3855,12 +3886,15 @@ % by changing the values of the booleans |\versotextnotessinglepar| and |\versotextnotestwocol|. % Similar sets of commands are available for |\versoemendation| and |\versoexplanatory| % and their recto equivalents. +% \end{sloppypar} % +% \begin{sloppypar} % \DescribeMacro{\putrectotextnotes} % To include these note sections in your document, issue |\putversotextnotes|, |\putrectotextnotes|, % |\putversoemendations|, |\putrectoemendations|, |\putversoexplanatorynotes|, or % |\putrectoexplanatorynotes| at the point where you wish them to appear. These commands % behave exactly like |\puttextnotes|. +% \end{sloppypar} % % \subsection{~Parallel text labels} % \DescribeMacro{\synchrolabel} \DescribeMacro{\synchroref} @@ -3913,6 +3947,7 @@ % Like passages of parallel text in verse, parallel prose passages must start % on a verso page. % +% \begin{sloppypar} % \DescribeMacro{\startversoprosepage} % \DescribeMacro{\finishversoprosepage} % \DescribeMacro{\startrectoprosepage} @@ -3924,6 +3959,7 @@ % text on the second page right after the |\startrectopage| command with % no blank line. (Alternatively, you could just % begin that page with |\noindent|.) +% \end{sloppypar} % % \DescribeMacro{\parastart} % \DescribeMacro{\paraend} @@ -8184,6 +8220,8 @@ r@#2\endcsname{}{}\@nil \newif{\ifprosebysentence} \newif{\ifrunningsentencenumbers}\runningsentencenumberstrue \newif{\ifmarginsentencenumbers}\marginsentencenumberstrue +\newif{\ifsuppressfirstpara}\suppressfirstparafalse +\newif{\ifsuppressfirstsentence}\suppressfirstsentencefalse \newtoks{\pmnoteheader} @@ -8204,7 +8242,13 @@ r@#2\endcsname{}{}\@nil % margin. \label{runningsentencenumberformat} % \begin{macrocode} \newcommand{\runningsentencenumberformat}[1]{\nobreak% -\textsuperscript{\scriptsize{#1}}\unskip\nobreak} +\ifsuppressfirstsentence% +\ifthenelse{\thepmsentencenumber=1}{\relax}{% +\unskip\textsuperscript{\scriptsize{#1}}}% +\unskip\nobreak% +\else% +\textsuperscript{\scriptsize{#1}}%\fi +\unskip\nobreak} \newcommand{\marginsentencenumberformat}[1]{\scriptsize{#1}} \newcommand{\setpmmodulo}[1]{\setcounter{pmmodulo}{#1}% \addtocounter{pmmodulo}{-1}% @@ -8235,8 +8279,13 @@ r@#2\endcsname{}{}\@nil % Macros for actually writing the numbers in the margin. % \begin{macrocode} \newcommand{\putpmsentencenumber}{% +\ifsuppressfirstsentence% +\ifthenelse{\thepmsentencenumber=1}{\relax}{\putpmmarginnumber{\thepmsentencenumber}% +{\marginsentencenumberformat}}% +\else% \putpmmarginnumber{\thepmsentencenumber}% -{\marginsentencenumberformat}} +{\marginsentencenumberformat}% +\fi} \newcommand{\putpmmarginnumber}[2]{% \nolinebreak\begin{marginenvironment}% \nolinebreak% @@ -8269,8 +8318,8 @@ r@#2\endcsname{}{}\@nil \addtocounter{pmindexcount}{1}% \leavevmode% \ifthenelse{\value{pmindexcount}>\value{pmmodulo}}% -{ \putpmsentencenumber\nobreak% - \setcounter{pmindexcount}{0}% +{\putpmsentencenumber\nobreak% +\setcounter{pmindexcount}{0}% }{\relax}% \fi% % create header for notes if any are to occur @@ -8402,9 +8451,20 @@ r@#2\endcsname{}{}\@nil % Formatting marginal and running paragraph numbers, printing them. \label{pmparrunningformat} % \begin{macrocode} \newcommand{\pmparmarformat}[1]{\textbf{{\small #1}}} -\newcommand{\pmpararunningformat}[1]{\textbf{\small #1}} +\newcommand{\pmpararunningformat}[1]{% +\ifsuppressfirstpara% +\ifthenelse{\thepmparagraph=1}{\relax}{\textbf{\small #1}~}% +\else% +\textbf{\small #1}~% +\fi} \newcommand{\putpmmarparanumber}{% -\putpmmarginnumber{\llap{\thepmparagraph~~}}{\pmparmarformat}} +\ifsuppressfirstpara% +\ifthenelse{\thepmparagraph=1}{\relax}{\putpmmarginnumber{\llap{\thepmparagraph~~}} +{\pmparmarformat}}% +\else% +\putpmmarginnumber{\llap{\thepmparagraph~~}}{\pmparmarformat}% +\fi} + % \end{macrocode} % \begin{macro}{\pmpara} % Mark the beginning of each paragraph with |\pmpara| |