From 9f094069a9990b07fb61076bd1d6498dba08dd7e Mon Sep 17 00:00:00 2001 From: Robert Alessi Date: Thu, 5 May 2022 17:15:42 +0200 Subject: more detailed documentation about \setpairedpage --- ekdosis.dtx | 40 +++++++++++++++++++++++----------------- 1 file changed, 23 insertions(+), 17 deletions(-) diff --git a/ekdosis.dtx b/ekdosis.dtx index f9c3584..77bc273 100644 --- a/ekdosis.dtx +++ b/ekdosis.dtx @@ -61,7 +61,7 @@ along with this program. If not, see %\NeedsTeXFormat{LaTeX2e}[1999/12/01] %\ProvidesPackage{ekdosis} %<*package> - [2022/05/01 v1.5-dev Typesetting TEI xml-compliant critical editions] + [2022/05/04 v1.5-dev Typesetting TEI xml-compliant critical editions] % %<*driver> \begin{filecontents}[noheader,overwrite]{bibdata.xml} @@ -5983,21 +5983,23 @@ subtype="arabtex">'inna 'abI kAna mina % \DescribeMacro{\setpairedpage} \cs{setpairedpage} is provided to set % mirrored paired facing pages. This command takes no argument and is % meant to be issued in commands used to set headers and footers on -% both sides, \emph{before} \cs{thepage} is called, like so:--- +% both sides, \emph{before any call} of the commands \cs{thepage} or +% \cs{ekdmark}, like so:--- % % \iffalse %<*example> % \fi -\begin{minted}[linenos=false,highlightlines={4,9}]{latex} +\begin{minted}[linenos,highlightlines={4,8-10}, escapeinside=++]{latex} % Preamble: \usepackage{titleps} \newpagestyle{edition}{ - \sethead[\setpairedpage\ekdprintmark{HEL}{\thepage}] + \sethead[\setpairedpage\ekdprintmark{HEL}{\thepage}]+\label{ln:ekdpp:i}+ [\ekdprintmark{HEC}{Hippocratis}] [] {} - {\ekdprintmark{HOC}{Epidemiarum liber II, \ekdmark}} - {\setpairedpage\ekdprintmark{HOR}{\thepage}} + {\setpairedpage\ekdprintmark{HOC}{Epidemiarum liber II,\+\label{ln:ekdpp:ii}+ + \ekdmark}} + {\ekdprintmark{HOR}{\thepage}}\+\label{ln:ekdpp:iii}+ } % Apply the page style: \pagestyle{edition} @@ -6007,10 +6009,14 @@ subtype="arabtex">'inna 'abI kAna mina % \fi % % \begin{remarks} -% \item As can be seen, \cs{setpairedpage} must be issued +% \item As can be seen from ll.~\lnref{ln:ekdpp:i} and +% \lnref{ln:ekdpp:ii}, \cs{setpairedpage} must be issued % \emph{before} \cs{ekdprintmark} so that it can be processed on % pages where headers and footers are removed by \cs{ekdnohfmarks} % described below. +% \item Additionally, ll.~\lnref{ln:ekdpp:ii}--\lnref{ln:ekdpp:iii} +% show that \cs{setpairedpage} precedes both \cs{ekdprintmark} and +% \cs{thepage}. % \item If there be no \cs{thepage} in headers or footers, % \cs{setpairedpage} must still be issued once on each side. % \end{remarks} @@ -8220,7 +8226,7 @@ Sample text with a \textcolor{red}{word} in red. % \end{macrocode} % \paragraph{\textsf{ekdosis} Symbol} % \begin{macro}{\eKd} -% \changes{v1.5}{2022/05/01}{Prints \textsf{ekdosis} indentifying +% \changes{v1.5}{2022/05/04}{Prints \textsf{ekdosis} indentifying % symbol} As of v1.5, \pkg{ekdosis} has its own identifying % symbol. It is produced by \cs{eKd} and best printed with the Old % Standard Greek font. @@ -8481,7 +8487,7 @@ Sample text with a \textcolor{red}{word} in red. % \begin{macro}{\teidirectE} % \changes{v1.3}{2021/08/18}{direct insertion of elements in the % \texttt{TEI xml} file} -% \changes{v1.5}{2022/05/01}{direct insertion of empty elements in the +% \changes{v1.5}{2022/05/04}{direct insertion of empty elements in the % \texttt{TEI xml} file} % \cs{teidirect}\oarg{xml attributes}\marg{xml element}\marg{code} % does nothing in \LaTeX. It is only used to insert elements in the @@ -8496,7 +8502,7 @@ Sample text with a \textcolor{red}{word} in red. % \end{macro} % \end{macro} % \begin{macro}{\getTEIxmlid} -% \changes{v1.5}{2022/05/01}{returns \texttt{TEI xml:ids} from a +% \changes{v1.5}{2022/05/04}{returns \texttt{TEI xml:ids} from a % csv-list of ids} This command returns from a csv-list of unique % identifiers declared in commands such as \cs{DeclareWitness} and the % like a space-separated list of their corresponding |xml:id|s, each @@ -10072,7 +10078,7 @@ Sample text with a \textcolor{red}{word} in red. % \end{macro} % \paragraph{Lacunae} % \begin{macro}{\ilabel} -% \changes{v1.5}{2022/05/01}{recalls and sets the ending label of +% \changes{v1.5}{2022/05/04}{recalls and sets the ending label of % lemmas used to mark lacunae in witnesses} When \cs{lem} has been % used with the optional argument |ilabel=