From 4b0f677aea00124171602de9498d50ac10d71eb3 Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Fri, 20 Sep 2019 03:00:40 +0000 Subject: CTAN sync 201909200300 --- macros/latex/contrib/poemscol/poemscol.dtx | 140 +++++++++++++++++++---------- macros/latex/contrib/poemscol/poemscol.pdf | Bin 708776 -> 711468 bytes 2 files changed, 91 insertions(+), 49 deletions(-) (limited to 'macros/latex/contrib/poemscol') diff --git a/macros/latex/contrib/poemscol/poemscol.dtx b/macros/latex/contrib/poemscol/poemscol.dtx index c0bde4dce2..a5ccbb380e 100644 --- a/macros/latex/contrib/poemscol/poemscol.dtx +++ b/macros/latex/contrib/poemscol/poemscol.dtx @@ -23,7 +23,7 @@ % \iffalse %\NeedsTeXFormat{LaTeX2e}[1997/12/01] %\ProvidesPackage{poemscol} -% [2019/09/09 v3.12 poemscol file] +% [2019/09/15 v3.13 poemscol file] % %<*driver> \documentclass{ltxdoc} @@ -38,7 +38,7 @@ % % \fi % -% \CheckSum{9868} +% \CheckSum{9913} % % \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 @@ -240,7 +240,7 @@ % \changes{v2.98}{2018/01/11}{Corrections to manual.} % \changes{v2.99}{2019/08/02}{Hierarchy of indented stanzas} % \changes{v3}{2019/08/03}{With centered verse you can align the title, epigraphs, -% attibutions, and so on with the left margin of the verse block.} +% attributions, and so on with the left margin of the verse block.} % \changes{v3.01}{2019/08/04}{Corrections to manual} % \changes{v3.04}{2019/08/18}{Appendix sections. New contents entries.} % \changes{v3.08}{2019/09/03}{Indentations of species of titles in text can be independenttly changed without changing the @@ -256,6 +256,7 @@ % commands are controlled by the same booleans that control placement % of titles.} % \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} % \DoNotIndex{\newcommand,\newenvironment,\def,\edef,\else,\renewcommand,\makeatletter,\makeatother} % \DoNotIndex{\abovedisplayskip,\belowdisplayskip,\abovedisplayshortskip,\belowdisplayshortskip} % \DoNotIndex{\newcommand, \section, \subsection, \subsubsection, @@ -288,15 +289,15 @@ % \textsc, \unskip} % \setcounter{IndexColumns}{2} % \MakeShortVerb{|} -% \def\fileversion{3.12} -% \def\filedate{9 September 2019} -% \def\docdate{9 September 2019} +% \def\fileversion{3.13} +% \def\filedate{15 September 2019} +% \def\docdate{15 September 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{9 September 2019} +% \date{15 September 2019} % \maketitle % \begin{abstract} \textsf{poemscol} provides commands for \LaTeX\ for % setting collections of poetry. It is especially suited for setting @@ -728,12 +729,19 @@ % % \item Titles centered over a centered verse block. I call this % |\ifcentertitleson|. The corresponding command is -% |\centertitlesscheme| I have retained the command |\centertitles| -% from earlier versions of \textsf{poemscol} for compatibility. %\end{itemize}\end{sloppypar} -% +% |\centertitlesscheme|. I have retained the command |\centertitles| +% from earlier versions of \textsf{poemscol} for compatibility. This +% scheme can also be used to center the titles (and epigraphs, headnotes +% and other top matter) over a non-centered verseblock too, if you +% don't use the optional argument to |\begin{poem}| describe in the next +% section, or if you turn off centering of the verse block by issuing the +% boolean |\textcenteringturnedonfalse|. +%\end{itemize}\end{sloppypar} +% +% \subsubsection{Using title placement schemes: verse width and title width} % \begin{sloppypar} % |\centertitlesscheme|, |\titlescenteredonleftverseblockscheme|, and \\ -% |titlesatleftmarginofcenteredblockscheme| require additional information +% |\titlesatleftmarginofcenteredblockscheme| require additional information % about each poem. Here are some details about the uses of these schemes.\end{sloppypar} % % \DescribeMacro{\centertitlesscheme} For each poem you wish to center you will have @@ -793,7 +801,7 @@ %\begin{sloppypar} %Rather than centering the title over % a centered block of verse, one might prefer to align the title with -% the left margin of the centered verse block. That is the use of this scheme The length |\versewidth| +% the left margin of the centered verse block. The length |\versewidth| % is used both to center the verse block and to place the title at the verse block's left margin. % You will need to use |\settowidth| to set the length of |\versewidth| before % issuing |\poemtitle| or the other title-making commands (such as |\sequencesectiontitle|). @@ -2439,21 +2447,31 @@ % their arguments as epigraphs, headnotes, attributions, or % dedications for poems or poetic sequences. \goodbreak % -% If your epigraph or headnote is a prose passage of more than one paragraph, or a verse +% 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. If you use the standard \LaTeX\ |verse| +% properly, which is to say it will draw the margins in towards the center, +% rather than centering the epigraph line by line. +% +% 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 +% within the |epigraphenvironment| environment. You can even use % the |poem| environment within the |epigraphenvironment| environment, but if % you mark up the epigraph with things like |\verseline| and |\end{stanza}| you may wind -% up with marginal line numbers.) Because |\centerepigraphs| merely +% up with marginal line numbers, so mark line breaks with |\\| and stanza breaks +% with a blank line, as in the standard |verse| environment.) +% +% 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. +% find a satisfactory value. |\shortpoemepigraph| and similar commands, described +% below, are better for single line epigraphs. % -% \DescribeMacro{\shortpoemepigraph} The commands +% \DescribeMacro{\shortpoemepigraph} +% \DescribeMacro{shortpoemdedication} +% \DescribeMacro{shortpoemattribution} \begin{sloppypar} The commands % |\shortpoemepigraph| |\shortpoemdedication| and % |\shortpoemattribution| will all place their texts in % accordance with the title placement scheme you select in your @@ -2474,7 +2492,7 @@ % if the boolean |\centerepigraphson| is in effect. I have also included % |\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|. +% found, in the manner of |\JHpoemtitle|.\end{sloppypar} % % \DescribeMacro{\centertitles} % Issuing |\centertitles| moves the margins in on both sides by the length @@ -4559,36 +4577,36 @@ \setlength{\contentspoemsubsectiontitleindentamount}{\contentsindentthreeamount} \newcommand{\contentspoemsubsectiontitleindent}{\hspace{\contentsindentthreeamount}} \newlength{\contentssequencetitleindentamount} -\setlength{\contentssequencetitleindentamount}{0pt} +\setlength{\contentssequencetitleindentamount}{\contentsindentoneamount} %313 \newcommand{\contentssequencetitleindent}{\hspace{\contentssequencetitleindentamount}} %\newcommand{\contentssequencetitleindent}{\relax} \newlength{\contentssequencetitlesecondlineindentamount} -\setlength{\contentssequencetitlesecondlineindentamount}{0pt} +\setlength{\contentssequencetitlesecondlineindentamount}{\contentsindentoneamount} %313 \newcommand{\contentssequencetitlesecondlineindent}{\hspace{\contentssequencetitlesecondlineindentamount}} %\newcommand{\contentssequencetitlesecondlineindent}{\hspace{\relax}} \newlength{\contentssequencesubtitleindentamount} -\setlength{\contentssequencesubtitleindentamount}{\contentsindentoneamount} +\setlength{\contentssequencesubtitleindentamount}{\contentsindenttwoamount} %313 \newcommand{\contentssequencesubtitleindent}{\hspace{\contentssequencesubtitleindentamount}} \newlength{\contentssequencesubtitlesecondlineindentamount} -\setlength{\contentssequencesubtitlesecondlineindentamount}{\contentsindentoneamount} +\setlength{\contentssequencesubtitlesecondlineindentamount}{\contentsindenttwoamount} %313 \newcommand{\contentssequencesubtitlesecondlineindent}{\hspace{\contentssequencesubtitlesecondlineindentamount}} \newlength{\contentssequencesectiontitleindentamount} -\setlength{\contentssequencesectiontitleindentamount}{\contentsindentoneamount} +\setlength{\contentssequencesectiontitleindentamount}{\contentsindenttwoamount} %313 \newcommand{\contentssequencesectiontitleindent}{\hspace{\contentssequencesectiontitleindentamount}} \newlength{\contentssequencesectiontitlesecondlineindentamount} -\setlength{\contentssequencesectiontitlesecondlineindentamount}{\contentsindentoneamount} +\setlength{\contentssequencesectiontitlesecondlineindentamount}{\contentsindenttwoamount} %313 \newcommand{\contentssequencesectiontitlesecondlineindent}{\hspace{\contentssequencesectiontitlesecondlineindentamount}} \newlength{\contentssequencesectionsubtitleindentamount} -\setlength{\contentssequencesectionsubtitleindentamount}{\contentsindenttwoamount} +\setlength{\contentssequencesectionsubtitleindentamount}{\contentsindentthreeamount} %313 \newcommand{\contentssequencesectionsubtitleindent}{\hspace{\contentssequencesectionsubtitleindentamount}} \newlength{\contentssequencesectionsubtitlesecondlineindentamount} -\setlength{\contentssequencesectionsubtitlesecondlineindentamount}{\contentsindenttwoamount} +\setlength{\contentssequencesectionsubtitlesecondlineindentamount}{\contentsindentthreeamount}%313 \newcommand{\contentssequencesectionsubtitlesecondlineindent}{\hspace{\contentssequencesectionsubtitlesecondlineindentamount}} \newlength{\contentssequencesubsectiontitleindentamount} -\setlength{\contentssequencesubsectiontitleindentamount}{\contentsindentoneamount} +\setlength{\contentssequencesubsectiontitleindentamount}{\contentsindentthreeamount} \newcommand{\contentssequencesubsectiontitleindent}{\hspace{\contentssequencesubsectiontitleindentamount}} \newlength{\contentssequencesubsubsectiontitleindentamount} -\setlength{\contentssequencesubsubsectiontitleindentamount}{\contentsindentthreeamount} +\setlength{\contentssequencesubsubsectiontitleindentamount}{\contentsindentfouramount} \newcommand{\contentssequencesubsubsectiontitleindent}{\hspace{\contentssequencesubsubsectiontitleindentamount}} @@ -6381,6 +6399,20 @@ %\m@ken@teholder{#1}% %\setlength{\titleentryoverrun}{\z@}} % +%%% special version for subtitles +\newcommand{\set@p@emsubtitle}[6]{\iftitlesatleftversemargin% +{\begin{pmclverse}\addtolength{\leftmargin}{-\leftmargini}{#2 #3 #4 #1 #5} \end{pmclverse}}% +\else% +\setlength{\titleentryoverrun}{#6}% +{#2}% +{#3 \begin{titleentryenvironment}% +{{\ifnormaltitleindentation #4 #1% +\else \ifcentertitleson \begin{center} #1 \end{center} \else #1\fi\fi}}% +\end{titleentryenvironment}}% +{#5}% +%\m@kep@emlabel +%\m@ken@teholder{#1}% +\setlength{\titleentryoverrun}{\z@}\fi} \newcommand{\setcontentsleaders}[1]{% \def\contentsleaders{#1\nobreak% }} @@ -6440,7 +6472,7 @@ \t@xtnotesinfo{#1}% } \newcommand{\poemtitlebaretitle}[1]{% -\set@p@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}% +\set@p@emsubtitle{#1}{\poemtitlepenalty}{\poemtitlefont}% {\poemtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\z@}% } \newcommand{\poemtitleonlycontents}[1]{% @@ -6684,34 +6716,34 @@ \restoresinglelinesettings } \newcommand{\sequencesubtitle}[1]{ -\set@p@emtitle{#1}{\par\nobreak}{\sequencetitlefont} +\set@p@emsubtitle{#1}{\par\nobreak}{\sequencetitlefont} {\sequencesubtitleindent}{\nobreak\par\aftersequencetitleskip\nobreak}{\z@} \c@ntentsinfo{#1}{\contentssequencesubtitleindent}{\contentssequencetitlefont} {\contentssequencesubtitleindentamount} -\t@xtnotesinfo{#1} +%\t@xtnotesinfo{#1} } \newcommand{\sequencesubtitlefirstline}[1]{\firstlinesettings -\set@p@emtitle{#1}{\par\nobreak}{\sequencetitlefont} +\set@p@emsubtitle{#1}{\par\nobreak}{\sequencetitlefont} {\sequencesubtitleindent}{\nobreak\par\aftersequencetitleskip\nobreak}{\z@} \c@ntentsinfo{#1}{\contentsindenttwo}{\contentssequencetitlefont} {\contentsindentthreeamount} -\t@xtnotesinfo{#1} +%\t@xtnotesinfo{#1} \restoresinglelinesettings } \newcommand{\sequencesubtitlemiddleline}[1]{\middlelinesettings -\set@p@emtitle{#1}{\par\nobreak}{\sequencetitlefont} +\set@p@emsubtitle{#1}{\par\nobreak}{\sequencetitlefont} {\sequencesubtitlesecondlineindent}{\nobreak\par\aftersequencetitleskip\nobreak}{\z@} \c@ntentsinfo{#1}{\contentssequencesubtitlesecondlineindent}{\contentssequencetitlefont} {\contentssequencesubtitlesecondlineindentamount} -\t@xtnotesinfo{#1} +%\t@xtnotesinfo{#1} \restoresinglelinesettings } \newcommand{\sequencesubtitlelastline}[1]{\lastlinesettings -\set@p@emtitle{#1}{\par\nobreak}{\sequencetitlefont} +\set@p@emsubtitle{#1}{\par\nobreak}{\sequencetitlefont} {\sequencesubtitlesecondlineindent}{\nobreak\par\aftersequencetitleskip\nobreak}{\z@} \c@ntentsinfo{#1}{\contentssequencesubtitlesecondlineindent}{\contentssequencetitlefont} {\contentssequencesubtitlesecondlineindentamount} -\t@xtnotesinfo{#1} +%\t@xtnotesinfo{#1} \restoresinglelinesettings } % \end{macrocode} @@ -6774,7 +6806,7 @@ \set@p@emtitle{#1}{\multilinetitlepenalty}{\poemtitlefont} {\sequencesectiontitleindent}{\nobreak\par\nobreak}{\sequencesectiontitleindentamount} \c@ntentsinfo{#1}{\contentssequencesectiontitleindent}{\contentspoemtitlefont} -{\contentssequencesectiontitleindent} +{\contentssequencesectiontitleindentamount} \t@xtnotesinfo{#1} \restoresinglelinesettings } @@ -6854,25 +6886,25 @@ % \newcommand{\sequencesectionsubtitle}[1]{{\subsectiontitlefont \hbox{\titleindent #1}} % \nobreak\par\nobreak\afterpoemtitleskip\nobreak % } -\newcommand{\sequencesectionsubtitle}[1]{\set@p@emtitle{#1}{\par\nobreak\afterpoemtitleskip} +\newcommand{\sequencesectionsubtitle}[1]{\set@p@emsubtitle{#1}{\par\nobreak\afterpoemtitleskip} {\subsectiontitlefont}{\sequencesectionsubtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\sequencesectionsubtitleindentamount} } \newcommand{\sequencesectionsubtitlefirstline}[1]{\firstlinesettings -\set@p@emtitle{#1}{\par\nobreak\afterpoemtitleskip} +\set@p@emsubtitle{#1}{\par\nobreak\afterpoemtitleskip} {\subsectiontitlefont}{\sequencesectionsubtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\sequencesectionsubtitleindentamount} \restoresinglelinesettings } \newcommand{\sequencesectionsubtitlemiddleline}[1]{\middlelinesettings -\set@p@emtitle{#1}{\par\nobreak\afterpoemtitleskip} +\set@p@emsubtitle{#1}{\par\nobreak\afterpoemtitleskip} {\subsectiontitlefont}{\sequencesectionsubtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\sequencesectionsubtitleindentamount} \restoresinglelinesettings } \newcommand{\sequencesectionsubtitlelastline}[1]{\lastlinesettings -\set@p@emtitle{#1}{\par\nobreak\afterpoemtitleskip} +\set@p@emsubtitle{#1}{\par\nobreak\afterpoemtitleskip} {\subsectiontitlefont}{\sequencesectionsubtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\sequencesectionsubtitleindentamount} \restoresinglelinesettings } -\newcommand{\poemsubtitle}[1]{\set@p@emtitle{#1}{\par\nobreak\afterpoemtitleskip} +\newcommand{\poemsubtitle}[1]{\set@p@emsubtitle{#1}{\par\nobreak\afterpoemtitleskip} {\subsectiontitlefont}{\poemsubtitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\titleindentamount} } % \end{macrocode} @@ -6969,11 +7001,11 @@ } \newcommand{\sequencesubsubsectiontitle}[1]{ \set@p@emtitle{#1}{\poemtitlepenalty}{\subsectiontitlefont} -{\sequencesubsubsectiontitleindent} +{\sequencesubsubsectiontitleindent} {\nobreak\par\nobreak\afterpoemtitleskip\nobreak} {\sequencesubsubsectiontitleindentamount} -\c@ntentsinfo{#1}{\contentssequencesubsubsectiontitleindent}{\contentspoemtitlefont} -{\contentssequencesubsubsectiontitleindentmount} +%\c@ntentsinfo{#1}{\contentssequencesubsubsectiontitleindent}{\contentspoemtitlefont} +%{\contentssequencesubsectiontitleindentmount} % 313 \t@xtnotesinfo{#1} } \newcommand{\sequencesubsubsectiontitlenocontents}[1]{ @@ -7038,7 +7070,17 @@ \m@kep@emlabel% \m@ken@teholder{#1}% \setlength{\titleentryoverrun}{\z@}} - +%% subtitle version +\newcommand{\set@margp@emsubtitle}[7]{\setlength{\titleentryoverrun}{#6}% +{#2}% +{#3 \begin{titleentryenvironment}% +{\ifcentertitleson\begin{center}#4 #1 #7\end{center}\else #4 #1 +#7\fi}\end{titleentryenvironment}}% +{#5}% +%\m@kep@emlabel% +%\m@ken@teholder{#1}% +\setlength{\titleentryoverrun}{\z@}} +% user version \newcommand{\setmargpoemtitle}[2]{% \set@margp@emtitle{#1}{\poemtitlepenalty}{\poemtitlefont}% {\sequencetitleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}{\z@}{#2}% @@ -7137,7 +7179,7 @@ \sources{\label{#2}}% } \newcommand{\JHsequencesectionsubtitle}[2]{% -\set@margp@emtitle{#1}{\par\nobreak}{\subsectiontitlefont}% +\set@margp@emsubtitle{#1}{\par\nobreak}{\subsectiontitlefont}% {\titleindent}{\nobreak\par\nobreak\afterpoemtitleskip\nobreak}% {\titleindentamount}{\JHlabel{#2}}% \sources{\label{#2}}% diff --git a/macros/latex/contrib/poemscol/poemscol.pdf b/macros/latex/contrib/poemscol/poemscol.pdf index 4b9df36cbd..9a353d345c 100644 Binary files a/macros/latex/contrib/poemscol/poemscol.pdf and b/macros/latex/contrib/poemscol/poemscol.pdf differ -- cgit v1.2.3