From ca682f3afaa1f262a31f952f6f1757e2dda7f9db Mon Sep 17 00:00:00 2001 From: Robert Alessi Date: Fri, 9 Oct 2020 12:03:37 +0200 Subject: new section about laying out parallel texts --- ekdosis.dtx | 152 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 149 insertions(+), 3 deletions(-) diff --git a/ekdosis.dtx b/ekdosis.dtx index 07fc12e..cbe911f 100644 --- a/ekdosis.dtx +++ b/ekdosis.dtx @@ -174,6 +174,15 @@ along with this program. If not, see url = {http://www.teibyexample.org} } +@Software{fnpos, + title = {The Fnpos package}, + titleaddon = {Control the position of footnotes on the page}, + author = {Nakashima, Hiroshi}, + url = {http://www.ctan.org/pkg/fnpos}, + date = {2018-09-03}, + version = {1.0} +} + @Software{lineno, title = {The Lineno package}, titleaddon = {Line numbers on paragraphs}, @@ -183,6 +192,15 @@ along with this program. If not, see version = {4.41} } +@Software{paracol, + title = {The Paracol package}, + titleaddon = {Multiple columns with texts “in parallel”}, + author = {Nakashima, Hiroshi}, + url = {http://www.ctan.org/pkg/paracol}, + date = {2018-12-31}, + version = {1.35} +} + @Software{polyglossia, title = {The Polyglossia package}, titleaddon = {An alternative to babel for XeLaTeX and LuaLaTeX}, @@ -1369,7 +1387,7 @@ along with this program. If not, see % \SigLine{cl}\\ % \end{xltabular} % -% \subsection{Editing a Single Text With No Translation} +% \subsection{Editing a Single Text} % \label{sec:single-text-editing} % \DescribeEnv{ekdosis} % Running paragraphs of one single text to be edited should be @@ -1739,7 +1757,7 @@ yesterday. % \subsubsection{Implicit Grouping} % \label{sec:implicit-grouping} % Because apparatus entries may nest recursively, the \cs{app} command -% may be used to group similar readings. +% can be used to group similar readings. % % \danger However, for nesting to work, the |alt| optional argument % must be used in every \cs{lem} and \cs{rdg} command involved in the @@ -2697,7 +2715,135 @@ texts=latin[xml:lang="la"]+\textcolor{red}{;}+ % % \fi % -% \section{Laying Out the Apparatus Criticus } +% \subsection{Laying Out Parallel Texts} +% \label{sec:laying-out-parallel} +% As \pkg{ekdosis} uses the \pkg{paracol} package for the layout of +% parallel texts, most of the commands provided by this package +% apply. In this respect, quite useful are the commands described in +% sections 7.3 and 7.4 on pp.~15--19 of the documentation of this +% package.\footcite{paracol} +% +% \danger It must be noted that all these commands are to be inserted +% \emph{before} the \env{alignment} environments on which they are +% supposed to operate. +% +% \subsubsection{Columns and Gutters} +% \label{sec:columns-gutters} +% +% \paragraph{Column Ratio on Single Pages} +% \DescribeMacro{\columnratio} +% \cs{columnratio}\marg{r\textsubscript{1}, r\textsubscript{2}, \dots\ +% , r\textsubscript{n}}, where \emph{r\textsubscript{1}} refers to the +% leftmost column, can be used to set the ratio of the columns in +% relation to each other. Depending on the total number of columns on +% which one wishes to operate, a comma-separated list of decimal +% numbers is expected. As an example, \cs{columnratio}|{0.6}| will +% instruct \pkg{ekdosis} to have the first column spread over 60~\% of +% the total width of the text block, minus the total width of +% intercolumnar gutters. +% +% \paragraph{Column Ratio on Facing Pages} +% \cs{columnratio} accepts an optional argument which can be used as +% described above to set the ratio of columns to be printed on +% right-hand pages, like so: \cs{columnratio}\marg{r\textsubscript{1}, +% r\textsubscript{2}, \dots\ , +% r\textsubscript{n}}\oarg{r\textsubscript{1}, r\textsubscript{2}, +% \dots\ , r\textsubscript{n}}. +% +% \paragraph{Column Width on Single Pages} +% \DescribeMacro{\setcolumnwidth} +% \cs{setcolumnwidth}\marg{w\textsubscript{1}, w\textsubscript{2}, +% \dots\ , w\textsubscript{n}} operates the same way as +% \cs{columnratio} described above, except that dimensions are +% expected instead of ratios. As an example, +% \cs{setcolumnwidth}|{1in}| will have the width of the first column +% set to \unit[1]{in}. +% +% \paragraph{Gutter Width} +% Each value accepted by \cs{setcolumnwidth} can be expressed as a +% pair as in +% \cs{setcolumnwidth}\marg{w\textsubscript{1}/g\textsubscript{1}, +% w\textsubscript{2}/g\textsubscript{2}, \dots\ , +% w\textsubscript{n}/g\textsubscript{n}} where the character |/| acts +% as a separator, in which case \emph{g\textsubscript{x}} is used to +% set the width of the gutter that follows the +% \emph{x}\textsuperscript{th} column. As an example, +% \cs{setcolumnwidth}|{1in/0.25in}| will print a +% \unit[1]{in} first column, followed by a \unit[0.25]{in} gutter. +% +% \paragraph{Automatically Computed Values} +% Widths of columns and widths of gutters can be replaced with +% \cs{fill} and \cs{columnsep} respectively. As an example, +% \cs{setcolumnwidth}|{\fill/0.25|\allowbreak|in}| will only operate +% on the width that follows the first column, all remaining values +% being computed automatically. +% +% \paragraph{Column and Gutter Width on Facing Pages} +% Just like \cs{columnratio}, \cs{setcolumnwidth} accepts an optional +% argument which can be used to set the width of columns and gutters +% to be printed on right-hand pages, like so: +% \cs{setcolumnwidth}\marg{w\textsubscript{1}, w\textsubscript{2}, +% \dots\ , w\textsubscript{n}}\oarg{w\textsubscript{1}, +% w\textsubscript{2}, \dots\ , w\textsubscript{n}} for columns only, +% and \cs{setcolumnwidth}\marg{w\textsubscript{1}/g\textsubscript{1}, +% w\textsubscript{2}/g\textsubscript{2}, \dots\ , +% w\textsubscript{n}/g\textsubscript{n}}% +% \oarg{w\textsubscript{1}/g\textsubscript{1}, +% w\textsubscript{2}/g\textsubscript{2}, \dots\ , +% w\textsubscript{n}/g\textsubscript{n}} for columns and gutters. +% +% \paragraph{Vertical Rules} +% Vertical rules between columns can be drawn by setting the length of +% the \LaTeX\ \cs{columnseprule} register to a non-zero value, like +% so:--- +% +% \iffalse +%<*example> +% \fi +\begin{minted}[linenos=false]{latex} +\setlength{\columnseprule}{0.4pt} +\end{minted} +% \iffalse +% +% \fi +% +% \subsubsection{Marginal Notes} +% \label{sec:marginal-notes} +% By default, marginal notes that refer to the first column are +% printed in the left margin, while notes that refer to subsequent +% columns are printed in the right margin. +% +% \DescribeMacro{\marginparthreshold} \cs{marginparthreshold}\marg{n}, +% where \emph{n} is an integer, can be used to change the default +% settings. This command instructs \pkg{ekdosis} that columns of text, +% up to the \emph{n}\textsuperscript{th} column included, shall have +% their marginal notes printed to the left. As a result, to take an +% example, \cs{marginparthreshold}|{0}| will have all marginal notes +% printed in the right margin. \cs{marginparthreshold} also accepts an +% optional argument, namely +% \cs{marginparthreshold}\allowbreak\marg{n}\oarg{n'}, that can be +% used to set the threshold for columns printed in right-hand pages. +% +% \subsubsection{Regular Footnotes} +% \label{sec:regular-footnotes} +% \DescribeMacro{\footnotelayout} By default, regular footnotes are +% printed at the bottom of the column on which they are +% called. \cs{footnotelayout}\marg{key-letter} can be used to change +% this setting. This command accepts as mandatory argument a +% key-letter which can be either |c|, |p| or |m|. |c| means +% \emph{column-wise} footnotes, which is the default value. |p| means +% \emph{page-wise}: footnotes from all columns are gathered in a +% single spanning block at the bottom of the page. Finally, |m| stands +% for \emph{merge}, which means that all footnotes that are called on +% a given page, including notes that are called outside the +% \env{alignment} environment, are printed in a single spanning block +% at the bottom of the page. +% +% \danger Regular footnotes are printed above the block of critical +% notes. Places can be interchanged by just loading the \pkg{fnpos} +% package in the preamble.\footcite{fnpos} +% +% \section{Laying Out the Apparatus Criticus} % \label{sec:apparatus-layout} % % \subsection{General Hooks} -- cgit v1.2.3