aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--ekdosis.dtx152
1 files 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
174 url = {http://www.teibyexample.org} 174 url = {http://www.teibyexample.org}
175} 175}
176 176
177@Software{fnpos,
178 title = {The Fnpos package},
179 titleaddon = {Control the position of footnotes on the page},
180 author = {Nakashima, Hiroshi},
181 url = {http://www.ctan.org/pkg/fnpos},
182 date = {2018-09-03},
183 version = {1.0}
184}
185
177@Software{lineno, 186@Software{lineno,
178 title = {The Lineno package}, 187 title = {The Lineno package},
179 titleaddon = {Line numbers on paragraphs}, 188 titleaddon = {Line numbers on paragraphs},
@@ -183,6 +192,15 @@ along with this program. If not, see
183 version = {4.41} 192 version = {4.41}
184} 193}
185 194
195@Software{paracol,
196 title = {The Paracol package},
197 titleaddon = {Multiple columns with texts “in parallel”},
198 author = {Nakashima, Hiroshi},
199 url = {http://www.ctan.org/pkg/paracol},
200 date = {2018-12-31},
201 version = {1.35}
202}
203
186@Software{polyglossia, 204@Software{polyglossia,
187 title = {The Polyglossia package}, 205 title = {The Polyglossia package},
188 titleaddon = {An alternative to babel for XeLaTeX and LuaLaTeX}, 206 titleaddon = {An alternative to babel for XeLaTeX and LuaLaTeX},
@@ -1369,7 +1387,7 @@ along with this program. If not, see
1369% \SigLine{cl}\\ 1387% \SigLine{cl}\\
1370% \end{xltabular} 1388% \end{xltabular}
1371% 1389%
1372% \subsection{Editing a Single Text With No Translation} 1390% \subsection{Editing a Single Text}
1373% \label{sec:single-text-editing} 1391% \label{sec:single-text-editing}
1374% \DescribeEnv{ekdosis} 1392% \DescribeEnv{ekdosis}
1375% Running paragraphs of one single text to be edited should be 1393% Running paragraphs of one single text to be edited should be
@@ -1739,7 +1757,7 @@ yesterday.
1739% \subsubsection{Implicit Grouping} 1757% \subsubsection{Implicit Grouping}
1740% \label{sec:implicit-grouping} 1758% \label{sec:implicit-grouping}
1741% Because apparatus entries may nest recursively, the \cs{app} command 1759% Because apparatus entries may nest recursively, the \cs{app} command
1742% may be used to group similar readings. 1760% can be used to group similar readings.
1743% 1761%
1744% \danger However, for nesting to work, the |alt| optional argument 1762% \danger However, for nesting to work, the |alt| optional argument
1745% must be used in every \cs{lem} and \cs{rdg} command involved in the 1763% 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}{;}+
2697%</example> 2715%</example>
2698% \fi 2716% \fi
2699% 2717%
2700% \section{Laying Out the Apparatus Criticus } 2718% \subsection{Laying Out Parallel Texts}
2719% \label{sec:laying-out-parallel}
2720% As \pkg{ekdosis} uses the \pkg{paracol} package for the layout of
2721% parallel texts, most of the commands provided by this package
2722% apply. In this respect, quite useful are the commands described in
2723% sections 7.3 and 7.4 on pp.~15--19 of the documentation of this
2724% package.\footcite{paracol}
2725%
2726% \danger It must be noted that all these commands are to be inserted
2727% \emph{before} the \env{alignment} environments on which they are
2728% supposed to operate.
2729%
2730% \subsubsection{Columns and Gutters}
2731% \label{sec:columns-gutters}
2732%
2733% \paragraph{Column Ratio on Single Pages}
2734% \DescribeMacro{\columnratio}
2735% \cs{columnratio}\marg{r\textsubscript{1}, r\textsubscript{2}, \dots\
2736% , r\textsubscript{n}}, where \emph{r\textsubscript{1}} refers to the
2737% leftmost column, can be used to set the ratio of the columns in
2738% relation to each other. Depending on the total number of columns on
2739% which one wishes to operate, a comma-separated list of decimal
2740% numbers is expected. As an example, \cs{columnratio}|{0.6}| will
2741% instruct \pkg{ekdosis} to have the first column spread over 60~\% of
2742% the total width of the text block, minus the total width of
2743% intercolumnar gutters.
2744%
2745% \paragraph{Column Ratio on Facing Pages}
2746% \cs{columnratio} accepts an optional argument which can be used as
2747% described above to set the ratio of columns to be printed on
2748% right-hand pages, like so: \cs{columnratio}\marg{r\textsubscript{1},
2749% r\textsubscript{2}, \dots\ ,
2750% r\textsubscript{n}}\oarg{r\textsubscript{1}, r\textsubscript{2},
2751% \dots\ , r\textsubscript{n}}.
2752%
2753% \paragraph{Column Width on Single Pages}
2754% \DescribeMacro{\setcolumnwidth}
2755% \cs{setcolumnwidth}\marg{w\textsubscript{1}, w\textsubscript{2},
2756% \dots\ , w\textsubscript{n}} operates the same way as
2757% \cs{columnratio} described above, except that dimensions are
2758% expected instead of ratios. As an example,
2759% \cs{setcolumnwidth}|{1in}| will have the width of the first column
2760% set to \unit[1]{in}.
2761%
2762% \paragraph{Gutter Width}
2763% Each value accepted by \cs{setcolumnwidth} can be expressed as a
2764% pair as in
2765% \cs{setcolumnwidth}\marg{w\textsubscript{1}/g\textsubscript{1},
2766% w\textsubscript{2}/g\textsubscript{2}, \dots\ ,
2767% w\textsubscript{n}/g\textsubscript{n}} where the character |/| acts
2768% as a separator, in which case \emph{g\textsubscript{x}} is used to
2769% set the width of the gutter that follows the
2770% \emph{x}\textsuperscript{th} column. As an example,
2771% \cs{setcolumnwidth}|{1in/0.25in}| will print a
2772% \unit[1]{in} first column, followed by a \unit[0.25]{in} gutter.
2773%
2774% \paragraph{Automatically Computed Values}
2775% Widths of columns and widths of gutters can be replaced with
2776% \cs{fill} and \cs{columnsep} respectively. As an example,
2777% \cs{setcolumnwidth}|{\fill/0.25|\allowbreak|in}| will only operate
2778% on the width that follows the first column, all remaining values
2779% being computed automatically.
2780%
2781% \paragraph{Column and Gutter Width on Facing Pages}
2782% Just like \cs{columnratio}, \cs{setcolumnwidth} accepts an optional
2783% argument which can be used to set the width of columns and gutters
2784% to be printed on right-hand pages, like so:
2785% \cs{setcolumnwidth}\marg{w\textsubscript{1}, w\textsubscript{2},
2786% \dots\ , w\textsubscript{n}}\oarg{w\textsubscript{1},
2787% w\textsubscript{2}, \dots\ , w\textsubscript{n}} for columns only,
2788% and \cs{setcolumnwidth}\marg{w\textsubscript{1}/g\textsubscript{1},
2789% w\textsubscript{2}/g\textsubscript{2}, \dots\ ,
2790% w\textsubscript{n}/g\textsubscript{n}}%
2791% \oarg{w\textsubscript{1}/g\textsubscript{1},
2792% w\textsubscript{2}/g\textsubscript{2}, \dots\ ,
2793% w\textsubscript{n}/g\textsubscript{n}} for columns and gutters.
2794%
2795% \paragraph{Vertical Rules}
2796% Vertical rules between columns can be drawn by setting the length of
2797% the \LaTeX\ \cs{columnseprule} register to a non-zero value, like
2798% so:---
2799%
2800% \iffalse
2801%<*example>
2802% \fi
2803\begin{minted}[linenos=false]{latex}
2804\setlength{\columnseprule}{0.4pt}
2805\end{minted}
2806% \iffalse
2807%</example>
2808% \fi
2809%
2810% \subsubsection{Marginal Notes}
2811% \label{sec:marginal-notes}
2812% By default, marginal notes that refer to the first column are
2813% printed in the left margin, while notes that refer to subsequent
2814% columns are printed in the right margin.
2815%
2816% \DescribeMacro{\marginparthreshold} \cs{marginparthreshold}\marg{n},
2817% where \emph{n} is an integer, can be used to change the default
2818% settings. This command instructs \pkg{ekdosis} that columns of text,
2819% up to the \emph{n}\textsuperscript{th} column included, shall have
2820% their marginal notes printed to the left. As a result, to take an
2821% example, \cs{marginparthreshold}|{0}| will have all marginal notes
2822% printed in the right margin. \cs{marginparthreshold} also accepts an
2823% optional argument, namely
2824% \cs{marginparthreshold}\allowbreak\marg{n}\oarg{n'}, that can be
2825% used to set the threshold for columns printed in right-hand pages.
2826%
2827% \subsubsection{Regular Footnotes}
2828% \label{sec:regular-footnotes}
2829% \DescribeMacro{\footnotelayout} By default, regular footnotes are
2830% printed at the bottom of the column on which they are
2831% called. \cs{footnotelayout}\marg{key-letter} can be used to change
2832% this setting. This command accepts as mandatory argument a
2833% key-letter which can be either |c|, |p| or |m|. |c| means
2834% \emph{column-wise} footnotes, which is the default value. |p| means
2835% \emph{page-wise}: footnotes from all columns are gathered in a
2836% single spanning block at the bottom of the page. Finally, |m| stands
2837% for \emph{merge}, which means that all footnotes that are called on
2838% a given page, including notes that are called outside the
2839% \env{alignment} environment, are printed in a single spanning block
2840% at the bottom of the page.
2841%
2842% \danger Regular footnotes are printed above the block of critical
2843% notes. Places can be interchanged by just loading the \pkg{fnpos}
2844% package in the preamble.\footcite{fnpos}
2845%
2846% \section{Laying Out the Apparatus Criticus}
2701% \label{sec:apparatus-layout} 2847% \label{sec:apparatus-layout}
2702% 2848%
2703% \subsection{General Hooks} 2849% \subsection{General Hooks}