diff options
Diffstat (limited to 'ekdosis.dtx')
-rw-r--r-- | ekdosis.dtx | 959 |
1 files changed, 776 insertions, 183 deletions
diff --git a/ekdosis.dtx b/ekdosis.dtx index 337be6b..3713787 100644 --- a/ekdosis.dtx +++ b/ekdosis.dtx | |||
@@ -79,19 +79,20 @@ along with this program. If not, see | |||
79 | %<*driver> | 79 | %<*driver> |
80 | \begin{filecontents}[overwrite]{\jobname.bib} | 80 | \begin{filecontents}[overwrite]{\jobname.bib} |
81 | @Article{Alessi2020, | 81 | @Article{Alessi2020, |
82 | author = {Alessi, Robert}, | ||
82 | title = {ekdosis: Using Lua\LaTeX{} for Producing \texttt{TEI | 83 | title = {ekdosis: Using Lua\LaTeX{} for Producing \texttt{TEI |
83 | xml} Compliant Critical Editions and Highlighting | 84 | xml} Compliant Critical Editions and Highlighting |
84 | Parallel Writings}, | 85 | Parallel Writings}, |
85 | author = {Alessi, Robert}, | ||
86 | journaltitle = {Journal of Data Mining and Digital Humanities}, | 86 | journaltitle = {Journal of Data Mining and Digital Humanities}, |
87 | year = 2020, | ||
88 | pubstate = {submitted}, | ||
87 | issuetitle = {Collecting, Preserving, and Disseminating Endangered | 89 | issuetitle = {Collecting, Preserving, and Disseminating Endangered |
88 | Cultural Heritage for New Understandings through | 90 | Cultural Heritage for New Understandings through |
89 | Multilingual Approaches}, | 91 | Multilingual Approaches}, |
90 | date = 2020, | 92 | eprinttype = {hal}, |
91 | pubstate = {submitted}, | 93 | eprint = {hal-02779803} |
92 | eprint = {hal-02779803}, | ||
93 | eprinttype = {hal} | ||
94 | } | 94 | } |
95 | |||
95 | @Online{DLL-TC, | 96 | @Online{DLL-TC, |
96 | author = {{Digital Latin Library}}, | 97 | author = {{Digital Latin Library}}, |
97 | title = {Textual Criticism}, | 98 | title = {Textual Criticism}, |
@@ -111,8 +112,21 @@ along with this program. If not, see | |||
111 | organization = {Society for Classical Studies} | 112 | organization = {Society for Classical Studies} |
112 | } | 113 | } |
113 | \end{filecontents} | 114 | \end{filecontents} |
114 | \begin{filecontents}[overwrite]{ekdosis-cfg.tex} | 115 | \begin{filecontents}[overwrite]{\jobname-cfg.tex} |
115 | 116 | \footnotelayout{m} | |
117 | \DeclareApparatus{default}[ | ||
118 | delim=\hskip0.75em, | ||
119 | ehook=.] | ||
120 | \DeclareWitness{M}{M}{\emph{Marcianus Gr.} 269}[ | ||
121 | settlement=Venice, | ||
122 | institution=Marciana Library, | ||
123 | msName=\emph{Marcianus Gr.}, | ||
124 | idno=269, | ||
125 | origDate=s. X] | ||
126 | \DeclareHand{M1}{M}{M\textsuperscript{1}}[Emendatio scribae ipsius] | ||
127 | \DeclareHand{M2}{M}{M\textsuperscript{2}}[Manus posterior] | ||
128 | \DeclareWitness{pjA}{A}{Manuscript A Call No 123} | ||
129 | \DeclareWitness{pjB}{B}{Manuscript B Call No 456} | ||
116 | \end{filecontents} | 130 | \end{filecontents} |
117 | \documentclass{ltxdoc} | 131 | \documentclass{ltxdoc} |
118 | \usepackage[letterpaper,margin=25mm,left=50mm,nohead]{geometry} | 132 | \usepackage[letterpaper,margin=25mm,left=50mm,nohead]{geometry} |
@@ -140,11 +154,12 @@ along with this program. If not, see | |||
140 | \def\sg#1{\textancientgreek{#1}} | 154 | \def\sg#1{\textancientgreek{#1}} |
141 | \usepackage[Old Standard]{mathfont} | 155 | \usepackage[Old Standard]{mathfont} |
142 | \usepackage{arabluatex} | 156 | \usepackage{arabluatex} |
143 | \usepackage{ekdosis} | 157 | \usepackage[teiexport=tidy]{ekdosis} |
144 | \footnotelayout{m} | ||
145 | \input{ekdosis-cfg} | 158 | \input{ekdosis-cfg} |
159 | \usepackage{xltabular} | ||
146 | \usepackage[prevent-all]{widows-and-orphans} | 160 | \usepackage[prevent-all]{widows-and-orphans} |
147 | \usepackage[shortcuts,nospacearound]{extdash} | 161 | \usepackage[shortcuts,nospacearound]{extdash} |
162 | \usepackage[american]{isodate} | ||
148 | \usepackage{csquotes} | 163 | \usepackage{csquotes} |
149 | \usepackage{enumitem} | 164 | \usepackage{enumitem} |
150 | \setlist{nosep} | 165 | \setlist{nosep} |
@@ -170,10 +185,16 @@ along with this program. If not, see | |||
170 | pdftype={Text} | 185 | pdftype={Text} |
171 | } | 186 | } |
172 | \usepackage{uri} | 187 | \usepackage{uri} |
173 | \usepackage[nospace,american]{varioref} | ||
174 | \labelformat{section}{sect.~#1} | 188 | \labelformat{section}{sect.~#1} |
189 | \labelformat{subsection}{sect.~#1} | ||
190 | \labelformat{subsubsection}{sect.~#1} | ||
191 | \labelformat{figure}{fig.~#1} | ||
192 | \usepackage[nospace,american]{varioref} | ||
175 | \usepackage[style=ext-verbose-inote]{biblatex} | 193 | \usepackage[style=ext-verbose-inote]{biblatex} |
176 | \usepackage[symbolpackage=tikz]{biblatex-ext-oa} | 194 | \usepackage[symbolpackage=tikz]{biblatex-ext-oa} |
195 | \DeclareDelimFormat[bib,biblist]{nametitledelim}{\addcomma\space} | ||
196 | \DeclareDelimFormat[bib,biblist]{innametitledelim}{\addcomma\space} | ||
197 | \renewcommand*\newunitpunct{\addcomma\space} | ||
177 | \newcommand*{\halurl}[1]{http://hal.archives-ouvertes.fr/#1} | 198 | \newcommand*{\halurl}[1]{http://hal.archives-ouvertes.fr/#1} |
178 | \DeclareFieldFormat{eprint:hal}{% | 199 | \DeclareFieldFormat{eprint:hal}{% |
179 | \ifhyperref | 200 | \ifhyperref |
@@ -236,21 +257,51 @@ along with this program. If not, see | |||
236 | \usepackage{multicol} | 257 | \usepackage{multicol} |
237 | \usepackage{tocloft} | 258 | \usepackage{tocloft} |
238 | \newlistof{listing}{lol}{List of listings} | 259 | \newlistof{listing}{lol}{List of listings} |
260 | \renewcommand\cfttocprehook{\begin{multicols}{2}} | ||
261 | \renewcommand\cfttocposthook{\end{multicols}} | ||
262 | \renewcommand\cfttoctitlefont{\Large\bfseries} | ||
239 | \renewcommand\cftlolprehook{\begin{multicols}{2}} | 263 | \renewcommand\cftlolprehook{\begin{multicols}{2}} |
240 | \renewcommand\cftlolposthook{\end{multicols}} | 264 | \renewcommand\cftlolposthook{\end{multicols}} |
241 | \renewcommand\cftloltitlefont{\Large\bfseries} | 265 | \renewcommand\cftloltitlefont{\Large\bfseries} |
242 | \usepackage{relsize} | 266 | \usepackage{relsize} |
243 | \usepackage{units} | 267 | \usepackage{units} |
268 | \usepackage{fbox} | ||
244 | \usepackage{tikz} | 269 | \usepackage{tikz} |
270 | \usetikzlibrary{tikzmark} | ||
271 | \NewDocumentCommand{\pointto}{m}{% | ||
272 | \tikz[remember picture] \draw[>->,color=blue,overlay] (1em,0.5ex) to | ||
273 | ([shift={(0.5em,0pt)}]pic cs:#1);% | ||
274 | \tikz[remember picture] \draw[color=gray, overlay] | ||
275 | ([shift={(0.5em,0.5ex)}]pic cs:#1) circle [radius=8pt];} | ||
276 | \NewDocumentCommand{\pointtor}{m}{% | ||
277 | \tikz[remember picture] \draw[>->,color=blue,overlay] (1em,0.5ex) to | ||
278 | [bend left] ([shift={(0.5em,0pt)}]pic cs:#1);% | ||
279 | \tikz[remember picture] \draw[color=gray, overlay] | ||
280 | ([shift={(0.5em,0.5ex)}]pic cs:#1) circle [radius=8pt];} | ||
281 | \NewDocumentCommand{\pointtol}{m}{% | ||
282 | \tikz[remember picture] \draw[>->,color=blue,overlay] (1em,0.5ex) to | ||
283 | [bend right] ([shift={(0.5em,0pt)}]pic cs:#1);% | ||
284 | \tikz[remember picture] \draw[color=gray, overlay] | ||
285 | ([shift={(0.5em,0.5ex)}]pic cs:#1) circle [radius=8pt];} | ||
286 | \NewDocumentCommand{\pointtoel}{m}{% | ||
287 | \tikz[remember picture] \draw[>->,color=blue,overlay] (1em,0.5ex) to | ||
288 | [bend right] ([shift={(0em,0pt)}]pic cs:#1);% | ||
289 | \tikz[remember picture] \draw[color=gray, overlay] | ||
290 | ([shift={(-0.5em,0.5ex)}]pic cs:#1) ellipse [x radius=45pt, y | ||
291 | radius=6pt];} | ||
245 | \usepackage[breakable, skins, xparse]{tcolorbox} | 292 | \usepackage[breakable, skins, xparse]{tcolorbox} |
293 | \tcbset{colback=white, boxrule=.15mm, colframe=cinnamon, | ||
294 | breakable} | ||
246 | \usepackage[newfloat]{minted} | 295 | \usepackage[newfloat]{minted} |
296 | \labelformat{listing}{listing~#1} | ||
247 | \setminted{bgcolor=ekdcolor,linenos, fontsize=\small} | 297 | \setminted{bgcolor=ekdcolor,linenos, fontsize=\small} |
248 | \newminted[ekdlua]{lua}{bgcolor={}, linenos, fontsize=\relsize{-0.5}, | 298 | \newminted[ekdlua]{lua}{bgcolor={}, linenos, fontsize=\relsize{-0.5}, |
249 | xleftmargin=12pt, breaklines, numberblanklines=false, numbersep=3pt, | 299 | xleftmargin=12pt, breaklines, numberblanklines=false, numbersep=3pt, |
250 | firstnumber=last} | 300 | firstnumber=last} |
251 | \renewcommand{\theFancyVerbLine}{\rmfamily\smaller\arabic{FancyVerbLine}} | 301 | \renewcommand{\theFancyVerbLine}{\rmfamily\smaller\arabic{FancyVerbLine}} |
252 | \usepackage[contents]{colordoc} | 302 | \usepackage[contents]{colordoc} |
253 | \newcommand{\package}[1]{\textsf{#1}\index{#1=#1 (package)}} | 303 | \newcommand{\pkg}[1]{\textsf{#1}\index{#1=#1 (package)}} |
304 | \newcommand{\env}[1]{\texttt{#1}} | ||
254 | \backgroundcolor{c}{ekdcolor} | 305 | \backgroundcolor{c}{ekdcolor} |
255 | \usepackage{caption} | 306 | \usepackage{caption} |
256 | \captionsetup[listing]{position=above,skip=-1ex} | 307 | \captionsetup[listing]{position=above,skip=-1ex} |
@@ -262,30 +313,30 @@ along with this program. If not, see | |||
262 | \captionof{#1}{#2}% | 313 | \captionof{#1}{#2}% |
263 | #3% | 314 | #3% |
264 | \egroup} | 315 | \egroup} |
265 | \usepackage{etoc} | 316 | % \usepackage{etoc} |
266 | \etocsettocdepth{paragraph} | 317 | % \etocsettocdepth{paragraph} |
267 | \newcommand{\ekdtableofcontents}{% | 318 | % \newcommand{\ekdtableofcontents}{% |
268 | \begingroup | 319 | % \begingroup |
269 | \etocsetstyle{section}{}{} | 320 | % \etocsetstyle{section}{}{} |
270 | {\etocsavedsectiontocline{% | 321 | % {\etocsavedsectiontocline{% |
271 | \numberline{\etocnumber}\etocname}{\etocpage}}{} | 322 | % \numberline{\etocnumber}\etocname}{\etocpage}}{} |
272 | \etocsetstyle{subsection}{}{} | 323 | % \etocsetstyle{subsection}{}{} |
273 | {\etocsavedsubsectiontocline{% | 324 | % {\etocsavedsubsectiontocline{% |
274 | \numberline{\etocnumber}\etocname}{\etocpage}}{}% | 325 | % \numberline{\etocnumber}\etocname}{\etocpage}}{}% |
275 | \etocsetstyle{subsubsection}{}{} | 326 | % \etocsetstyle{subsubsection}{}{} |
276 | {\etocsavedsubsubsectiontocline{% | 327 | % {\etocsavedsubsubsectiontocline{% |
277 | \numberline{\etocnumber}\etocname}{\etocpage}}{}% | 328 | % \numberline{\etocnumber}\etocname}{\etocpage}}{}% |
278 | \etocsetstyle{paragraph}{}{\leftskip2cm\rightskip 2.2em \parfillskip | 329 | % \etocsetstyle{paragraph}{}{\leftskip2cm\rightskip 2.2em \parfillskip |
279 | 0pt plus 1fil\relax \nobreak} | 330 | % 0pt plus 1fil\relax \nobreak} |
280 | {\noindent\etocname{} \etocpage{} }{\par}% | 331 | % {\noindent\etocname{} \etocpage{} }{\par}% |
281 | \etocmulticolstyle[2]{\section*{Contents}} | 332 | % \etocmulticolstyle[2]{\section*{Contents}} |
282 | \pdfbookmark[1]{Contents}{toc} | 333 | % \pdfbookmark[1]{Contents}{toc} |
283 | \tableofcontents | 334 | % \tableofcontents |
284 | \endgroup} | 335 | % \endgroup} |
285 | \EnableCrossrefs | 336 | \EnableCrossrefs |
286 | \CodelineIndex | 337 | \CodelineIndex |
287 | \RecordChanges | 338 | \RecordChanges |
288 | % \OnlyDescription | 339 | %\OnlyDescription |
289 | \begin{document} | 340 | \begin{document} |
290 | \DocInput{\jobname.dtx} | 341 | \DocInput{\jobname.dtx} |
291 | \PrintChanges | 342 | \PrintChanges |
@@ -328,19 +379,19 @@ along with this program. If not, see | |||
328 | % \metapick[print]{titletext} | 379 | % \metapick[print]{titletext} |
329 | % \end{tcolorbox} | 380 | % \end{tcolorbox} |
330 | % | 381 | % |
331 | % \ekdtableofcontents | 382 | % \tableofcontents |
332 | % \listoflistings | 383 | % \listoflistings |
333 | % | 384 | % |
334 | %\changes{v1.00}{2020/07/01}{First public release} | 385 | %\changes{v1.00}{2020/07/01}{First public release} |
335 | % | 386 | % |
336 | % \begin{abstract} | 387 | % \begin{abstract} |
337 | % \package{ekdosis} is a Lua\LaTeX{} package designed for | 388 | % \pkg{ekdosis} is a Lua\LaTeX{} package designed for |
338 | % multilingual critical editions. It can be used to typeset texts | 389 | % multilingual critical editions. It can be used to typeset texts |
339 | % and different layers of critical notes in any direction accepted | 390 | % and different layers of critical notes in any direction accepted |
340 | % by Lua\TeX. Texts can be arranged in running paragraphs or on | 391 | % by Lua\TeX. Texts can be arranged in running paragraphs or on |
341 | % facing pages, in any number of columns which in turn can be | 392 | % facing pages, in any number of columns which in turn can be |
342 | % synchronized or not. In addition to printed texts, | 393 | % synchronized or not. In addition to printed texts, |
343 | % \package{ekdosis} can convert \texttt{.tex} source files so as to | 394 | % \pkg{ekdosis} can convert \texttt{.tex} source files so as to |
344 | % produce \texttt{TEI xml} compliant critical | 395 | % produce \texttt{TEI xml} compliant critical |
345 | % editions. Database-driven encoding under \LaTeX{} then allows | 396 | % editions. Database-driven encoding under \LaTeX{} then allows |
346 | % extraction of texts entered segment by segment according to | 397 | % extraction of texts entered segment by segment according to |
@@ -349,18 +400,18 @@ along with this program. If not, see | |||
349 | % terms of the GNU General Public License (GPL) version 3. | 400 | % terms of the GNU General Public License (GPL) version 3. |
350 | % \end{abstract} | 401 | % \end{abstract} |
351 | % | 402 | % |
352 | % \section*{License and disclaimer} | 403 | % \section*{License and Disclaimer} |
353 | % \addcontentsline{toc}{section}{License and disclamer} | 404 | % \addcontentsline{toc}{section}{License and disclamer} |
354 | % \subsection*{License applicable to this document} | 405 | % \subsection*{License Applicable to this Document} |
355 | % \pdfbookmark[2]{Licence applicable to this document}{copyright-doc} | 406 | % \pdfbookmark[2]{Licence applicable to this document}{copyright-doc} |
356 | % \leavevmode\marginpar{\hfill\texttt{fdl1.3}} | 407 | % \leavevmode\marginpar{\hfill\texttt{fdl1.3}} |
357 | % \metapick[print]{rightstext} (See below \vref{sec:fdl}.) | 408 | % \metapick[print]{rightstext} (See below \vref{sec:fdl}.) |
358 | % | 409 | % |
359 | % \subsection*{License applicable to the software} | 410 | % \subsection*{License Applicable to the Software} |
360 | % \pdfbookmark[2]{Licence applicable to the software}{copyright-soft} | 411 | % \pdfbookmark[2]{Licence applicable to the software}{copyright-soft} |
361 | % \label{sec:license-software} | 412 | % \label{sec:license-software} |
362 | % | 413 | % |
363 | % \package{ekdosis} --- \metapick[print]{subtitle} | 414 | % \pkg{ekdosis} --- \metapick[print]{subtitle} |
364 | % \metapick[print]{copyrightstatement} | 415 | % \metapick[print]{copyrightstatement} |
365 | % | 416 | % |
366 | % Please send error reports and suggestions for improvements to Robert | 417 | % Please send error reports and suggestions for improvements to Robert |
@@ -386,9 +437,10 @@ along with this program. If not, see | |||
386 | % | 437 | % |
387 | % You should have received a copy of the GNU General Public License | 438 | % You should have received a copy of the GNU General Public License |
388 | % along with this program. If not, see | 439 | % along with this program. If not, see |
389 | % \href{http://www.gnu.org/licenses}{\texttt{<http://www.gnu.org/licenses/>}}. | 440 | % \href{http://www.gnu.org/licenses}% |
441 | % {\texttt{<http://www.gnu.org/licenses/>}}. | ||
390 | % | 442 | % |
391 | % This release of \package{ekdosis} consists of the following | 443 | % This release of \pkg{ekdosis} consists of the following |
392 | % source files: | 444 | % source files: |
393 | % \begin{itemize} | 445 | % \begin{itemize} |
394 | % \item |ekdosis.ins| | 446 | % \item |ekdosis.ins| |
@@ -399,54 +451,55 @@ along with this program. If not, see | |||
399 | % \section{Introduction} | 451 | % \section{Introduction} |
400 | % \label{sec:introduction} | 452 | % \label{sec:introduction} |
401 | % \begin{comment} | 453 | % \begin{comment} |
402 | % \begin{keyfigure}{c={Grid Typesetting (which never came into | 454 | % \begin{keyfigure}{l={fig:grid-typesetting},c={Grid Typesetting |
403 | % existence)}, t={Each square in the grid has a side length of | 455 | % (which never came into existence)}, t={Each square in the grid |
404 | % \unit[10]{pt}. Therefore, the distance between the last line of | 456 | % has a side length of \unit[10]{pt}. Therefore, the distance |
405 | % the text and the first line of the apparatus is here | 457 | % between the last line of the text and the first line of the |
406 | % approximately \unit[25]{pt}.}} | 458 | % apparatus is here approximately \unit[25]{pt}.}} |
407 | % \centering | 459 | % \centering |
408 | % \begin{tikzpicture} | 460 | % \begin{tikzpicture} |
409 | % \draw[gainsboro,thin] (0.5,0.5) grid [step=10pt] (10,5); % | 461 | % \draw[gainsboro,thin] (0.5,0.5) grid [step=10pt] (10,5); % |
410 | % \path node [align=justify, text width=8cm] at (5.5,3) {% | 462 | % \path node [align=justify, text width=8cm] at (5.5,3) {% |
411 | % I saw my friend Peter at the station yesterday. I saw my | 463 | % I saw my friend Peter at the station yesterday. We were both |
412 | % friend Peter at the station yesterday. I saw my friend Peter | 464 | % in a great mood. \enquote{How nice to find you here!} he |
413 | % at the station yesterday. I saw my friend Peter at the station | 465 | % said. I chuckled to myself, recalling the last time we |
414 | % yesterday.\par | 466 | % met.\par |
415 | % \rule{3cm}{0.01cm}\par\footnotesize% | 467 | % \rule{3cm}{0.01cm}\par\footnotesize% |
416 | % \textbf{1}~Peter A: John B\ \ \textbf{2}~Peter A: John B \ \ | 468 | % \textbf{1}~saw A] met B\hskip1em Peter A] John B \hskip1em |
417 | % \textbf{3}~Peter A: John B\ \ \textbf{4}~Peter A: John B}; | 469 | % \textbf{2}~great A] good B\hskip1em \textbf{2--3}~How |
418 | % \node at (0,3) {\scriptsize $\approx$ \unit[25]{pt}}; \draw | 470 | % nice... said A] \emph{om.} B\hskip1em \textbf{4} \emph{post} |
419 | % [->] (0,2.875) -- (0,2.025); | 471 | % met \emph{add.} there B.}; \node at (0,3) {\scriptsize |
472 | % $\approx$ \unit[25]{pt}}; \draw [->] (0,2.875) -- (0,2.025); | ||
420 | % \end{tikzpicture} | 473 | % \end{tikzpicture} |
421 | % \end{keyfigure} | 474 | % \end{keyfigure} |
422 | % \end{comment} | 475 | % \end{comment} |
423 | % | 476 | % |
424 | % | ||
425 | % The reader will find here, by way of introduction, a summarized | 477 | % The reader will find here, by way of introduction, a summarized |
426 | % version of the first part of an article that the author submitted | 478 | % version of the first part of an article that the author submitted |
427 | % some weeks ago to the | 479 | % some weeks ago to the \mkbibemph{\citefield{Alessi2020}{journaltitle}} as |
428 | % \mkbibemph{\citefield{Alessi2020}{journaltitle}} as a contribution | 480 | % a contribution to a Digital Humanities workshop held at Stanford |
429 | % to a Digital Humanities workshop held at Stanford University (April | 481 | % University (\printdate{2019-04-15}).\footcite{Alessi2020} |
430 | % 15, 2019).\footcite{Alessi2020} | 482 | % |
431 | % | 483 | % The name of this package, \pkg{ekdosis}, derives from a Greek |
432 | % The name of this package, ekdosis, derives from a Greek action | 484 | % action noun\---\sg{ἔκδοσις}\---the meaning of which is: |
433 | % noun\---\sg{ἔκδοσις}\---the meaning of which is: \enquote{publishing | 485 | % \enquote{publishing a book}, and also in concrete sense: \enquote{a |
434 | % a book}, and also in concrete sense: \enquote{a publication, | 486 | % publication, treatise}. For us moderns, this term refers to a long |
435 | % treatise}. For us moderns, this term refers to a long tradition of | 487 | % tradition of scholarly work consisting in establishing from |
436 | % scholarly work consisting in establishing from manuscript evidence | 488 | % manuscript evidence the texts of Greek and Latin classics that were |
437 | % the texts of Greek and Latin classics that were handled down through | 489 | % handled down through the Middle Ages to the time of the first |
438 | % the Middle Ages to the time of the first printed editions. Of | 490 | % printed editions. Of course, this definition is extendible to other |
439 | % course, this definition is extendible to other languages as | 491 | % languages as well. The basic premise is that critical editions |
440 | % well. The basic premise is that critical editions exhibit | 492 | % exhibit reconstructed texts from manuscript evidence either under |
441 | % reconstructed texts from manuscript evidence either under the title | 493 | % the title of the edited text (direct tradition) or from explicit |
442 | % of the edited text (direct tradition) or from explicit citations or | 494 | % citations or parallel passages or translations in other languages |
443 | % parallel passages or translations in other languages (indirect | 495 | % (indirect tradition). |
444 | % tradition). Whether in print or digital, critical editions come | 496 | % |
445 | % with an apparatus criticus in which is mentioned all the evidence | 497 | % Whether in print or digital, critical editions come with an |
446 | % that was used to build the edited text. Arguably, it is precisely on | 498 | % apparatus criticus in which is mentioned all the evidence that was |
447 | % this common point that the two kind of editions part ways for | 499 | % used to build the edited text. Arguably, it is precisely on this |
448 | % reading a traditional, well written apparatus criticus is only meant | 500 | % common point that the two kind of editions part ways for reading a |
449 | % for experienced readers. Getting oneself familiarized with its many | 501 | % traditional, well written apparatus criticus is only meant for |
502 | % experienced readers. Getting oneself familiarized with its many | ||
450 | % conventional rules is not unrelated to learning a language, equipped | 503 | % conventional rules is not unrelated to learning a language, equipped |
451 | % with technical terms, grammar rules and style embellishments, which | 504 | % with technical terms, grammar rules and style embellishments, which |
452 | % came into existence out of over three centuries of scholarly | 505 | % came into existence out of over three centuries of scholarly |
@@ -455,7 +508,7 @@ along with this program. If not, see | |||
455 | % conventional symbols, it is quite inaccessible to a computer unless | 508 | % conventional symbols, it is quite inaccessible to a computer unless |
456 | % every item of information has been encoded in the rather dumb format | 509 | % every item of information has been encoded in the rather dumb format |
457 | % that is suited to machines. | 510 | % that is suited to machines. |
458 | % | 511 | % |
459 | % On the other hand, editions in print have their own limitations. For | 512 | % On the other hand, editions in print have their own limitations. For |
460 | % example, every detail that editors of classical texts decide to | 513 | % example, every detail that editors of classical texts decide to |
461 | % discard to save space, regardless to its relevance to the purpose of | 514 | % discard to save space, regardless to its relevance to the purpose of |
@@ -464,74 +517,590 @@ along with this program. If not, see | |||
464 | % indirect tradition are only available as references in the | 517 | % indirect tradition are only available as references in the |
465 | % \emph{apparatus testium} and cannot be referred to the original | 518 | % \emph{apparatus testium} and cannot be referred to the original |
466 | % text. As a result, the reader is refrained from bestowing attention | 519 | % text. As a result, the reader is refrained from bestowing attention |
467 | % upon major parallel passages to understand better difficult | 520 | % upon major parallel passages to understand better difficult passages. |
468 | % passages. | 521 | % |
469 | % | ||
470 | % To conclude on these issues, print publications and digital editions | 522 | % To conclude on these issues, print publications and digital editions |
471 | % are often contrasted as they belonged to two different | 523 | % are often contrasted as they belonged to two different |
472 | % worlds.\footnote{For a good illustration of this point, see | 524 | % worlds.\footnote{For a good illustration of this point, see |
473 | % \cite{DLL-TC}.} It is commonly said that the content of editions in | 525 | % \cite[\mkbibquote{Content, not Display}]{DLL-TC}.} It is commonly |
474 | % print is the result of the binding of the book itself as an object, | 526 | % said that the content of editions in print is the result of the |
475 | % whereas digital editions, in which format and presentation are by | 527 | % binding of the book itself as an object, whereas digital editions, |
476 | % definition separated from content, are free from limitations coming | 528 | % in which format and presentation are by definition separated from |
477 | % from such bindings. To sum up from the foregoing considerations, | 529 | % content, are free from limitations coming from such bindings. To sum |
478 | % this statement is likely to be qualified: as already seen above, the | 530 | % up from the foregoing considerations, this statement is likely to be |
479 | % apparatus criticus must be looked at as a brilliant production of | 531 | % qualified: as already seen above, the apparatus criticus must be |
480 | % mind refined by centuries of scholarly tradition\--and surely | 532 | % looked at as a brilliant production of mind refined by centuries of |
481 | % tradition must go on\---arguably not as compact paragraphs that | 533 | % scholarly tradition\---and surely tradition must go on\---arguably |
482 | % require special and painful training to be \enquote*{decoded}. On | 534 | % not as compact paragraphs that require special and painful training |
483 | % the other hand, what editions in print do not provide are what | 535 | % to be \enquote*{decoded}. On the other hand, what editions in print |
484 | % \citeauthor{Mastronarde.Tarrant2017} have called \enquote{actionable | 536 | % do not provide are what \citename{Mastronarde.Tarrant2017}{author} |
485 | % texts for use in digital | 537 | % have called \enquote{actionable texts for use in digital |
486 | % research},\footcite{Mastronarde.Tarrant2017} namely database-driven | 538 | % research},\footcite{Mastronarde.Tarrant2017} namely database-driven |
487 | % texts allowing the reader to select annotations and display or | 539 | % texts allowing the reader to select annotations and display or |
488 | % arrange translations, parallel passages or borrowings in a variety | 540 | % arrange translations, parallel passages or borrowings in a variety |
489 | % of ways. | 541 | % of ways. |
490 | % | 542 | % |
491 | % \package{ekdosis} can be seen as an attempt at combining the two | 543 | % \pkg{ekdosis} can be seen as an attempt at combining the two |
492 | % approaches. | 544 | % approaches. |
493 | % | 545 | % |
494 | % \subsection{Features} | 546 | % \subsection{Features} |
495 | % \label{sec:features} | 547 | % \label{sec:features} |
496 | % A list of the main features of \package{ekdosis} folows:--- | 548 | % A list of the main features of \pkg{ekdosis} follows:--- |
497 | % \begin{enumerate} | 549 | % \begin{enumerate} |
498 | % \item \emph{Multilingual critical editions}: \package{ekdosis} can | 550 | % \item \emph{Multilingual critical editions\/}: \pkg{ekdosis} can |
499 | % be used to typeset any number of texts in any direction accepted by | 551 | % be used to typeset any number of texts in any direction accepted |
500 | % \LuaTeX. Running paragraphs of text can be arranged in any number of | 552 | % by \hologo{LuaTeX}. Running paragraphs of text can be arranged in |
501 | % columns, either on single or facing pages, which in turn can be | 553 | % any number of columns, either on single or facing pages, which in |
502 | % synchronized or not. \package{ekdosis} is also suitable for complex | 554 | % turn can be synchronized or not. \pkg{ekdosis} is also |
503 | % layouts, such as Arabic poetry or images where three-way alignment | 555 | % suitable for complex layouts as in the case of Arabic poetry or |
504 | % is required, diagrams, \emph{\&c}. | 556 | % images where three-way alignment is required, or diagrams, |
557 | % \emph{\&c}. | ||
558 | % \item \emph{Apparatus criticus\/}: Edited texts can receive multiple | ||
559 | % layers of apparatus, e.g.\ apparatus criticus (to record variant | ||
560 | % readings), apparatus fontium (to collect references to texts quoted | ||
561 | % or cited in the edited text), apparatus testium (to collect | ||
562 | % testimonia or parallel passages), or any kind of short notes to be | ||
563 | % printed on the same page as the edited text, \emph{\&c}. | ||
564 | % \item \texttt{TEI xml} output: \pkg{ekdosis} can be instructed | ||
565 | % to output both PDF and \texttt{TEI xml} files at the same time. | ||
566 | % \item \emph{Database-driven encoding} under \LaTeX{} of texts | ||
567 | % entered segment by segment allows for alignment of parallel texts | ||
568 | % from multilingual corpora. | ||
505 | % \end{enumerate} | 569 | % \end{enumerate} |
506 | % | 570 | % |
507 | % \captof{The Peter and John example} | 571 | % Before going into detail, the following simple example will give the |
572 | % reader a general idea of the method of encoding with | ||
573 | % \pkg{ekdosis} authoritative texts composed of lemmata, in a way | ||
574 | % that is very close to \texttt{TEI xml} encoding:--- | ||
575 | % | ||
576 | % \captof{The \enquote{Peter/John} basic example}[\label{lst:pj1}] | ||
577 | % \iffalse | ||
578 | %<*example> | ||
579 | % \fi | ||
580 | \begin{minted}{latex} | ||
581 | \begin{ekdosis} | ||
582 | I | ||
583 | \app{ | ||
584 | \lem{saw} | ||
585 | \rdg{met} | ||
586 | } | ||
587 | my friend \app{\lem{Peter}\rdg{John}} at the station yesterday. | ||
588 | \end{ekdosis} | ||
589 | \end{minted} | ||
590 | % \iffalse | ||
591 | %</example> | ||
592 | % \fi | ||
593 | % | ||
594 | % \needspace{4\baselineskip}PDF output:--- | ||
595 | % \medskip | ||
596 | % \begin{alignment}[tcols=1,texts=specimen,apparatus=specimen] | ||
597 | % \begin{specimen} | ||
598 | % I | ||
599 | % \app{ | ||
600 | % \lem{saw} | ||
601 | % \rdg{met} | ||
602 | % } | ||
603 | % my friend | ||
604 | % \app{ | ||
605 | % \lem{Peter} | ||
606 | % \rdg{John} | ||
607 | % } | ||
608 | % at the station yesterday. | ||
609 | % \end{specimen} | ||
610 | % \end{alignment} | ||
611 | % | ||
612 | % \texttt{TEI xml} output:--- | ||
613 | % \iffalse | ||
614 | %<*example> | ||
615 | % \fi | ||
616 | \begin{minted}[linenos=false]{xml} | ||
617 | <p>I | ||
618 | <app> | ||
619 | <lem>saw</lem> | ||
620 | <rdg>met</rdg> | ||
621 | </app>my friend | ||
622 | <app> | ||
623 | <lem>Peter</lem> | ||
624 | <rdg>John</rdg> | ||
625 | </app>at the station yesterday.</p> | ||
626 | \end{minted} | ||
627 | % \iffalse | ||
628 | %</example> | ||
629 | % \fi | ||
630 | % | ||
631 | % As can be seen from \vref{lst:pj1}, the edition text is inserted in | ||
632 | % the \env{ekdosis} environment (l.~1 to 13). Then two | ||
633 | % \cs{app}\marg{apparatus entry} commands (ll.~3 and 7) contain the | ||
634 | % lemma (\cs{lem}\marg{lemma}), namely the reading that is accepted by | ||
635 | % the editor, and at least one variant reading | ||
636 | % (\cs{rdg}\marg{reading}, ll.~5 and 7). As the listing shows, the | ||
637 | % editor is free to lay out the code in a legible manner to the eye: | ||
638 | % the first lemma above spans several lines whereas the second one is | ||
639 | % written in sequence without spaces. | ||
640 | % | ||
641 | % In the PDF ouput, the edition text is printed in the upper part of | ||
642 | % the page, above the line, and naturally shows the accepted | ||
643 | % readings. The margins are used for numeration. In the apparatus | ||
644 | % criticus, below the line, reference to the text is made by | ||
645 | % specifying the number of the line and if several items refer to the | ||
646 | % same line, numbers are not repeated. Instead, items are separated | ||
647 | % from one another by a broad horizontal space. Finally, a square | ||
648 | % bracket is used inside items to distinguish the lemma from the | ||
649 | % variant readings. | ||
650 | % | ||
651 | % Furthermore, as said above, if a \texttt{TEI xml} output is | ||
652 | % required, \pkg{ekdosis} compiles an additional |.xml| file an | ||
653 | % excerpt of which is provided above. | ||
654 | % | ||
655 | % \section{The Basics of \pkg{ekdosis}} | ||
656 | % \label{sec:ekdosis-basics} | ||
657 | % | ||
658 | %\subsection{Loading the Package\---General Options} | ||
659 | %\label{sec:load-general-options} | ||
660 | % | ||
661 | % \pkg{ekdosis} is loaded in the preamble like so:--- | ||
662 | % \iffalse | ||
663 | %<*example> | ||
664 | % \fi | ||
665 | \begin{minted}[linenos=false]{latex} | ||
666 | \usepackage{ekdosis} | ||
667 | \end{minted} | ||
668 | % \iffalse | ||
669 | %</example> | ||
670 | % \fi | ||
671 | % | ||
672 | % \pkg{ekdosis} may be loaded with four optional \enquote*{named | ||
673 | % arguments} either of which is set using the syntax | ||
674 | % \meta{key}$=$\meta{value}. The description of the optional arguments | ||
675 | % follows. | ||
676 | % | ||
677 | % \danger The reader is invited to refer to the relevant sections of | ||
678 | % this documentation for more information on how to use them. | ||
679 | % | ||
680 | % \DescribeOption{layout}\label{ref:layout-opt} | ||
681 | % |layout|$=$\verb+float|footins+\hfill\tcboxverb{Default: float}\\ | ||
682 | % By default, layers of critical notes are inserted as a floating | ||
683 | % environment to be printed at the bottom of pages. |layout=footins| | ||
684 | % can be set to insert critical notes in the default footnote block | ||
685 | % which can be considered to be a special kind of float that is | ||
686 | % printed at the bottom of pages. In this case, the apparatus criticus | ||
687 | % will be inserted between regular numbered footnotes, but will carry | ||
688 | % no footnote mark of its own. | ||
689 | % | ||
690 | % \DescribeOption{divs}\label{ref:divs-opt} | ||
691 | % |divs|$=$\verb+ekdosis|latex+\hfill\tcboxverb{Default: ekdosis}\\ | ||
692 | % In many occasions, \LaTeX{} standard textual divisions do not meet | ||
693 | % the specific requirements of classical and literary texts, the | ||
694 | % divisions of which may depend on many different received | ||
695 | % traditions. \pkg{ekdosis} provides a flexible mechanism in which | ||
696 | % format and presentation have been carefully separated. It is | ||
697 | % designed to build un-numbered \texttt{TEI} divisions allowed to nest | ||
698 | % recursively. However, if |divs| be set to |latex|, \LaTeX{} standard | ||
699 | % textual divisions can be used and will be translated into | ||
700 | % \texttt{TEI} numbered |<div>| elements. | ||
701 | % | ||
702 | % \danger It must be noted that the two styles are mutually exclusive. | ||
703 | % \vskip\baselineskip | ||
704 | % | ||
705 | % \DescribeOption{parnotes}\label{ref:parnotes-opt} | ||
706 | % |parnotes|$=$\verb+true|false|roman+% | ||
707 | % \hfill\tcboxverb{Default: not set}\\ | ||
708 | % This named argument does not need a value as it defaults to |true| | ||
709 | % if it is used. Apparatus criticus typeset by \pkg{ekdosis} may | ||
710 | % contain notes and footnotes. The latter can be laid out as | ||
711 | % paragraphed notes below the block of critical notes by means of the | ||
712 | % \pkg{parnotes} package. Additionally, |parnotes=roman| prints these | ||
713 | % footnotes numbered with Roman numerals. | ||
714 | % | ||
715 | % \DescribeOption{teiexport}\label{ref:teiexport-option} | ||
716 | % |teiexport|$=$\verb+true|false|tidy+% | ||
717 | % \hfill\tcboxverb{Default: not set}\\ | ||
718 | % This named argument does not need a value as it defaults to |true| | ||
719 | % if it is used. If |teiexport| be set to |true|, \pkg{ekdosis} is | ||
720 | % instructed to output both PDF and \texttt{TEI xml} files at the same | ||
721 | % time. By default, the \texttt{TEI} file will receive the same | ||
722 | % basename as the |.tex| source file, suffixed with |-tei.xml|. The | ||
723 | % raw |.xml| file that is produced by \pkg{ekdosis} can be further | ||
724 | % processed by the \textsf{tidy} console application.\footnote{See | ||
725 | % \url{http://www.html-tidy.org}.} To make this happen, \textsf{tidy} | ||
726 | % must be installed and the |.tex| source file must be compiled with | ||
727 | % the |--shell-escape| facility so that spawning programs from | ||
728 | % \LaTeX{} be allowed.\footnote{See | ||
729 | % \url{https://texfaq.org/FAQ-spawnprog} for more information on how | ||
730 | % to do this.} | ||
731 | % | ||
732 | % As an example, the following line loads \pkg{ekdosis} and instructs | ||
733 | % it to output a \texttt{TEI xml} file (in addition of the PDF one) | ||
734 | % and to use \pkg{parnotes} to format with Roman numerals the footnotes | ||
735 | % that are inserted in the apparatus criticus:--- | ||
736 | % \iffalse | ||
737 | %<*example> | ||
738 | % \fi | ||
739 | \begin{minted}[linenos=false]{latex} | ||
740 | \usepackage[teiexport, parnotes=roman]{ekdosis} | ||
741 | \end{minted} | ||
742 | % \iffalse | ||
743 | %</example> | ||
744 | % \fi | ||
745 | % | ||
746 | % \subsection{Witnesses, Hands, Shorthands \& Scholars } | ||
747 | % \label{sec:declarations} | ||
748 | % Any reference that is to be used in the apparatus criticus must be | ||
749 | % \enquote{declared} in the preamble beforehand, namely: manuscript | ||
750 | % sigla (either for single manuscripts or manuscript families, primary | ||
751 | % or later hands, \emph{\&c.}) or abbreviated last names of scholars. | ||
752 | % To that effect, \pkg{ekdosis} provides the following preamble-only | ||
753 | % commands:--- | ||
754 | % \begin{comment} | ||
755 | % \begin{xltabular}[c]{0.4\linewidth}{lXr} | ||
756 | % \caption*{\textbf{Conspectus Siglorum}}\\ | ||
757 | % \SigLine{M}\\ | ||
758 | % \end{xltabular} | ||
759 | % \end{comment} | ||
760 | % | ||
761 | % \paragraph{Witnesses} | ||
762 | % \DescribeMacro{\DeclareWitness} \cs{DeclareWitness}\marg{unique | ||
763 | % id}\marg{rendition}\marg{description}\oarg{options}\\ | ||
764 | % This command requires three mandatory arguments enclosed between | ||
765 | % curly braces used to specify consecutively: | ||
766 | % \begin{enumerate} | ||
767 | % \item The unique identifier of the witness to be used both in the | ||
768 | % |.tex| source file and as an |xml:id| in the \texttt{TEI xml} | ||
769 | % output if any. | ||
770 | % \item The rendition to be used in the printed apparatus criticus, | ||
771 | % which also will be found within the |<sourceDesc>| element of the | ||
772 | % \texttt{TEI} header where the description of the witness occurs, | ||
773 | % within a |<abbr type="siglum">| element. | ||
774 | % \item A basic description of the manuscript to be found in a typical | ||
775 | % printed Conspectus Siglorum, namely: the name of the manuscript | ||
776 | % followed by its call number. | ||
777 | % \end{enumerate} | ||
778 | % Finally, the optional argument of \cs{DeclareWitness} accepts a | ||
779 | % comma-separated list of the following \enquote{name=value} arguments | ||
780 | % that are used to collect items of information to be found within | ||
781 | % the |<msIdentifer>| element in the \texttt{TEI} | ||
782 | % header:---\footnote{See | ||
783 | % \url{https://tei-c.org/release/doc/tei-p5-doc/en/html/MS.html\#msid} | ||
784 | % for detailed information on these elements.}\\ | ||
785 | % \DescribeOption{settlement} |settlement|$=$\meta{name}: The name of | ||
786 | % a city or administrative unit.\\ | ||
787 | % \DescribeOption{institution} |institution|$=$\meta{name}: The name | ||
788 | % of an institution such as a university or library.\\ | ||
789 | % \DescribeOption{repository} |repository|$=$\meta{name}: The name of | ||
790 | % the repository within which the witness is stored.\\ | ||
791 | % \DescribeOption{collection} |collection|$=$\meta{name}: The name of | ||
792 | % a collection of manuscripts.\\ | ||
793 | % \DescribeOption{idno} |idno|$=$\meta{call \#}: Any form of call | ||
794 | % number.\\ | ||
795 | % \DescribeOption{msName} |msName|$=$\meta{name}: The name commonly | ||
796 | % used for the witness.\\ | ||
797 | % \DescribeOption{origDate} |origDate|$=$\meta{date}: Any form of date | ||
798 | % used to identify the date of origin for the witness. | ||
799 | % | ||
800 | % To take here one example, a witness such as the \emph{Marcianus | ||
801 | % Graecus}~269, referred to as manuscript \enquote*{M} in the | ||
802 | % editions, which contains sixty treatises from Hippocrates, could be | ||
803 | % declared as follows:--- \iffalse | ||
804 | %<*example> | ||
805 | % \fi | ||
806 | \begin{minted}[linenos=false]{latex} | ||
807 | \DeclareWitness{M}{M}{\emph{Marcianus Gr.} 269}[ | ||
808 | settlement=Venice, | ||
809 | institution=Marciana Library, | ||
810 | msName=\emph{Marcianus Gr.}, | ||
811 | idno=269, | ||
812 | origDate=s. X] | ||
813 | \end{minted} | ||
814 | % \iffalse | ||
815 | %</example> | ||
816 | % \fi | ||
817 | % | ||
818 | % \paragraph{Hands} | ||
819 | % \DescribeMacro{\DeclareHand} \cs{DeclareHand}\marg{unique | ||
820 | % id}\marg{base ms.}\marg{rendition}\oarg{note}\\ | ||
821 | % This command requires three mandatory arguments enclosed between | ||
822 | % curly braces and one optional argument between square brackets used | ||
823 | % to specify consecutively:--- | ||
824 | % \begin{enumerate} | ||
825 | % \item The unique identifier of the hand to be used both in the | ||
826 | % |.tex| source file and as an |xml:id| in the \texttt{TEI xml} output | ||
827 | % if any. | ||
828 | % \item The unique idendifier of the witness the hand is related | ||
829 | % to. Of course, this witness must have been previously declared. | ||
830 | % \item The rendition to be used in the printed apparatus criticus, | ||
831 | % which also will be found within the |<handNote>| element of the | ||
832 | % \texttt{TEI} header where the description of the hand occurs, within | ||
833 | % a |<abbr type="siglum">| element. | ||
834 | % \item Some further information about the hand. | ||
835 | % \end{enumerate} | ||
836 | % | ||
837 | % To continue the preceding example, here is how additions and | ||
838 | % corrections found in the \emph{Marcianus Gr.}~269 could be declared | ||
839 | % after this witness has been declared itself:--- | ||
840 | % \iffalse | ||
841 | %<*example> | ||
842 | % \fi | ||
843 | \begin{minted}[linenos=false]{latex} | ||
844 | \DeclareHand{M1}{M}{M\textsuperscript{1}}[Emendatio scribae ipsius] | ||
845 | \DeclareHand{M2}{M}{M\textsuperscript{2}}[Manus posterior] | ||
846 | \end{minted} | ||
847 | % \iffalse | ||
848 | %</example> | ||
849 | % \fi | ||
850 | % | ||
851 | % As can be seen, values such as |M|, |M1| and |M2| in the |.tex| | ||
852 | % source file will be printed as \getsiglum{M}, \getsiglum{M1} and | ||
853 | % \getsiglum{M2} respectively. Not only the code gains legibility, but | ||
854 | % also flexibility for simply changing any declared rendition will | ||
855 | % update corresponding sigla thoughout the entire edition. | ||
856 | % | ||
857 | % As a final example, here is how \pkg{ekdosis} would encode | ||
858 | % information as declared above for the \emph{Marcianus Gr.}~269 | ||
859 | % should a \texttt{TEI} output be required:--- | ||
860 | % \iffalse | ||
861 | %<*example> | ||
862 | % \fi | ||
863 | \begin{minted}[linenos=false]{xml} | ||
864 | <sourceDesc> | ||
865 | <listWit> | ||
866 | <witness xml:id="M"> | ||
867 | <abbr type="siglum">M</abbr> | ||
868 | <emph>Marcianus Gr.</emph>269 | ||
869 | <msDesc> | ||
870 | <msIdentifier> | ||
871 | <settlement>Venice</settlement> | ||
872 | <institution>Marciana Library</institution> | ||
873 | <idno>269</idno> | ||
874 | <msName> | ||
875 | <emph>Marcianus Gr.</emph> | ||
876 | </msName> | ||
877 | </msIdentifier> | ||
878 | <physDesc> | ||
879 | <handDesc hands="2"> | ||
880 | <handNote xml:id="M1"> | ||
881 | <abbr type="siglum">M | ||
882 | <hi rend="sup">1</hi></abbr> | ||
883 | <p>Emendatio scribae ipius</p> | ||
884 | </handNote> | ||
885 | <handNote xml:id="M2"> | ||
886 | <abbr type="siglum">M | ||
887 | <hi rend="sup">2</hi></abbr> | ||
888 | <p>Manus posterior</p> | ||
889 | </handNote> | ||
890 | </handDesc> | ||
891 | </physDesc> | ||
892 | <history> | ||
893 | <origin> | ||
894 | <origDate>s. X</origDate> | ||
895 | </origin> | ||
896 | </history> | ||
897 | </msDesc></witness> | ||
898 | </listWit> | ||
899 | </sourceDesc> | ||
900 | \end{minted} | ||
901 | % \iffalse | ||
902 | %</example> | ||
903 | % \fi | ||
904 | % | ||
905 | % \paragraph{Shorthands} | ||
906 | % \DescribeMacro{\DeclareShorthand} \cs{DeclareShorthand}\marg{unique | ||
907 | % id}\marg{rendition}\marg{csv list of witnesses}\\ | ||
908 | % This command provides a convenient way to declare \emph{families} of | ||
909 | % witnesses. It takes three mandatory arguments used to specify | ||
910 | % consecutively:--- | ||
911 | % \begin{enumerate} | ||
912 | % \item The unique identifier of the family to be used in the |.tex| | ||
913 | % source file. | ||
914 | % \item The rendition to be used in the printed apparatus criticus. | ||
915 | % \item A comma-separated list of previously declared witnesses. | ||
916 | % \end{enumerate} | ||
917 | % | ||
918 | % As an example, the manuscripts of Caesar's \emph{Gallic War} are | ||
919 | % divided into two families: α, which includes mss.\ A, M, B, R, S, L | ||
920 | % and N, and β, which includes mss.\ T, f, U and l. Therefore, | ||
921 | % provided that all theses witnesses have been already declared, here | ||
922 | % is how the two families α and β could be declared:--- | ||
923 | % \iffalse | ||
924 | %<*example> | ||
925 | % \fi | ||
926 | \begin{minted}[linenos=false]{latex} | ||
927 | \DeclareShorthand{a}{α}{A,M,B,R,S,L,N} | ||
928 | \DeclareShorthand{b}{β}{T,f,U,l} | ||
929 | \end{minted} | ||
930 | % \iffalse | ||
931 | %</example> | ||
932 | % \fi | ||
933 | % | ||
934 | % Then, symbols |a| and |b| can be used in the |.tex| source file in | ||
935 | % place of manuscripts that belong to either family. | ||
936 | % | ||
937 | % \paragraph{Scholars} | ||
938 | % \DescribeMacro{\DeclareScholar} \cs{DeclareScholar}\marg{unique | ||
939 | % label}\marg{rendition}\\ | ||
940 | % The \emph{Conspectus Siglorum} that is placed ahead of the edition | ||
941 | % text is traditionally divided into two parts: a)~\emph{Codices}, | ||
942 | % which provides the list of sigla used in the apparatus, | ||
943 | % b)~\emph{Editiones uel Studia}, which provides references to | ||
944 | % scholars whose published or unpublished works contain conjectures | ||
945 | % used in the apparatus criticus. \cs{DeclareScholar} takes two | ||
946 | % mandatory arguments used to specify consecutively:--- | ||
947 | % \begin{enumerate} | ||
948 | % \item A unique label used in the |.tex| source file to refer to the | ||
949 | % work where the conjecture is found. | ||
950 | % \item The rendition to be used in the printed apparatus criticus. | ||
951 | % \end{enumerate} | ||
952 | % | ||
953 | % As \pkg{ekdosis} can include and use \texttt{TEI xml} compliant | ||
954 | % lists of references, it is avisable to use Bib\hologo{(La)TeX} | ||
955 | % labels in the first argument of \cs{DeclareScholar}. Likewise, | ||
956 | % shorthands fields from the bibliographical database can be recalled | ||
957 | % from within the second argument of \cs{DeclareScholar}:--- | ||
958 | % \iffalse | ||
959 | %<*example> | ||
960 | % \fi | ||
961 | \begin{minted}[linenos=false]{latex} | ||
962 | \DeclareScholar{Wil}{Wilamowitz} | ||
963 | % or for example: | ||
964 | \DeclareScholar{Wil}{\citename{Wil}{shorteditor}} | ||
965 | \end{minted} | ||
966 | % \iffalse | ||
967 | %</example> | ||
968 | % \fi | ||
969 | % \label{sec:declarations-end} | ||
970 | % | ||
971 | % \subsection{Editing a Single Text With No Translation} | ||
972 | % \label{sec:single-text-editing} | ||
973 | % \DescribeEnv{ekdosis} | ||
974 | % Running paragraphs of one single text to be edited should be | ||
975 | % inserted in the \env{ekdosis} environment, like so:---\footnote{See | ||
976 | % above \vref{lst:pj1}.} | ||
508 | % \iffalse | 977 | % \iffalse |
509 | %<*example> | 978 | %<*example> |
510 | % \fi | 979 | % \fi |
511 | \begin{minted}[linenos=false]{latex} | 980 | \begin{minted}[linenos=false]{latex} |
512 | \begin{ekdosis} | 981 | \begin{ekdosis} |
513 | I saw my friend | 982 | Edition text goes here. |
983 | \end{ekdosis} | ||
984 | \end{minted} | ||
985 | % \iffalse | ||
986 | %</example> | ||
987 | % \fi | ||
988 | % | ||
989 | % \paragraph{Apparatus Entries} | ||
990 | % \DescribeMacro{\app} \cs{app}|[type=|\meta{type}|]|\marg{apparatus | ||
991 | % entries}\\ | ||
992 | % This command takes one mandatory argument and accepts one optional | ||
993 | % argument. Once references to be used as witnesses in the apparatus | ||
994 | % criticus have been declared in the preamble as described in | ||
995 | % \ref{sec:declarations} | ||
996 | % \vpagerefrange{sec:declarations}{sec:declarations-end}, the \cs{app} | ||
997 | % command is used for inserting entries in the apparatus criticus, | ||
998 | % either, lemmas, readings or notes, like so:--- | ||
999 | % \iffalse | ||
1000 | %<*example> | ||
1001 | % \fi | ||
1002 | \begin{minted}[linenos=false]{latex} | ||
1003 | I saw my friend \app{\lem{Peter}\rdg{John}} yesterday. | ||
1004 | or: | ||
1005 | I saw my friend | ||
514 | \app{ | 1006 | \app{ |
515 | \lem{Peter} | 1007 | \lem{Peter} |
516 | \rdg{John} | 1008 | \rdg{John} |
517 | } | 1009 | } |
518 | at the station yesterday. | 1010 | yesterday. |
519 | \end{ekdosis} | ||
520 | \end{minted} | 1011 | \end{minted} |
521 | % \iffalse | 1012 | % \iffalse |
522 | %</example> | 1013 | %</example> |
523 | % \fi | 1014 | % \fi |
524 | % \begin{alignment}[flush,tcols=1,texts=specimen,apparatus=specimen] | 1015 | % \cs{app} accepts one further optional argument:---\\ |
1016 | % \DescribeOption{type} |type|$=$\meta{type}\hfill% | ||
1017 | % \tcboxverb{Default: default}\\ | ||
1018 | % By default, \pkg{ekdosis} sets one layer of notes\--- the |default| | ||
1019 | % layer\---in the apparatus criticus. This layer is fit to receive | ||
1020 | % notes related to variant readings from witnesses and sources used by | ||
1021 | % the editor to establish the edition text. Additional layers can be | ||
1022 | % defined to receive other kinds of notes, such as references to texts | ||
1023 | % quoted or cited in the text of the edition (\emph{apparatus | ||
1024 | % fontium}), references to testimonia, or quotations of the edited | ||
1025 | % text by other authors (\emph{apparatus testium}), explanatory notes, | ||
1026 | % and so forth.\footnote{See below, \vpageref{ref:type-app}.} Once | ||
1027 | % additional layers have been defined and assigned to new | ||
1028 | % \enquote*{types}, such as \enquote*{testium} and the like, these | ||
1029 | % types can be used as values appended to the |type| \enquote*{named | ||
1030 | % option}. | ||
1031 | % | ||
1032 | % \paragraph{Readings} As can be seen in the example above, there are | ||
1033 | % two kinds of individual readings: the \emph{lemma}, which contains | ||
1034 | % the base text accepted by the editor, and the \emph{reading}, which | ||
1035 | % contains deviant readings rejected by the editor. | ||
1036 | % | ||
1037 | % \paragraph{Lemmas} \DescribeMacro{\lem} | ||
1038 | % \cs{lem}\oarg{options}\marg{lemma text} | ||
1039 | % | ||
1040 | % \begin{comment} | ||
1041 | % \captof{The \enquote{Peter/John} full example} | ||
1042 | % \iffalse | ||
1043 | %<*example> | ||
1044 | % \fi | ||
1045 | \begin{minted}{latex} | ||
1046 | \begin{ekdosis} | ||
1047 | I | ||
1048 | \app{ | ||
1049 | \lem[wit=A]{saw} | ||
1050 | \rdg[wit=B]{met}} | ||
1051 | my friend | ||
1052 | \app{ | ||
1053 | \lem{Peter} | ||
1054 | \rdg{John} | ||
1055 | } | ||
1056 | at the station yesterday. We were both in a | ||
1057 | \app{ | ||
1058 | \lem[wit=A]{great} | ||
1059 | \rdg[wit=B]{good}} | ||
1060 | mood. | ||
1061 | \app{ | ||
1062 | \lem[wit=A, alt={How nice... said}]{\enquote{How nice to find | ||
1063 | you here!} he said.} | ||
1064 | \rdg[wit=B, alt=\emph{om.}]{}} | ||
1065 | I chuckled to myself, recalling the last time we | ||
1066 | \app{ | ||
1067 | \lem[wit=A,nolem]{met} | ||
1068 | \rdg[wit=B, alt={\emph{post} met \emph{add.} there}]{met | ||
1069 | there}}. | ||
1070 | \end{ekdosis} | ||
1071 | \end{minted} | ||
1072 | % \iffalse | ||
1073 | %</example> | ||
1074 | % \fi | ||
1075 | % | ||
1076 | % \begin{alignment}[tcols=1,texts=specimen,apparatus=specimen] | ||
525 | % \begin{specimen} | 1077 | % \begin{specimen} |
526 | % I saw my friend | 1078 | % I \app{\lem[wit=pjA]{saw}\rdg[wit=pjB]{met}} my friend |
527 | % \app{ | 1079 | % \app{ |
528 | % \lem{Peter} | 1080 | % \lem{Peter} |
529 | % \rdg{John} | 1081 | % \rdg{John} |
530 | % } | 1082 | % } |
531 | % at the station yesterday. | 1083 | % at the station yesterday. We were both in a |
1084 | % \app{ | ||
1085 | % \lem[wit=pjA]{great} | ||
1086 | % \rdg[wit=pjB]{good}} | ||
1087 | % mood. | ||
1088 | % \app{ | ||
1089 | % \lem[wit=pjA, alt={\textooquote How nice... said}]{\enquote{How | ||
1090 | % nice to find you here!} he said.} | ||
1091 | % \rdg[wit=pjB, alt=\emph{om.}]{}} | ||
1092 | % I chuckled to myself, recalling the last time we | ||
1093 | % \app{ | ||
1094 | % \lem[wit=pjA,nolem]{met} | ||
1095 | % \rdg[wit=pjB, alt={\emph{post} met \emph{add.} there}]{met | ||
1096 | % there}}. | ||
532 | % \end{specimen} | 1097 | % \end{specimen} |
533 | % \end{alignment} | 1098 | % \end{alignment} |
534 | % | 1099 | % \end{comment} |
1100 | % | ||
1101 | % \section{To be continued...} | ||
1102 | % \label{ref:type-app} | ||
1103 | % | ||
535 | % \section{GNU Free Documentation License} | 1104 | % \section{GNU Free Documentation License} |
536 | % \label{sec:fdl} | 1105 | % \label{sec:fdl} |
537 | % \textbf{Version 1.3, 3 November 2008} | 1106 | % \textbf{Version 1.3, 3 November 2008} |
@@ -552,7 +1121,7 @@ along with this program. If not, see | |||
552 | % of this license document, but changing it is not allowed. | 1121 | % of this license document, but changing it is not allowed. |
553 | % \end{center} | 1122 | % \end{center} |
554 | % | 1123 | % |
555 | % \needspace{\baselineskip} | 1124 | % \needspace{3\baselineskip} |
556 | % \begin{center} | 1125 | % \begin{center} |
557 | % {\bf\large Preamble} | 1126 | % {\bf\large Preamble} |
558 | % \end{center} | 1127 | % \end{center} |
@@ -579,7 +1148,7 @@ along with this program. If not, see | |||
579 | % this License principally for works whose purpose is instruction or | 1148 | % this License principally for works whose purpose is instruction or |
580 | % reference. | 1149 | % reference. |
581 | % | 1150 | % |
582 | % \needspace{\baselineskip} | 1151 | % \needspace{3\baselineskip} |
583 | % \begin{center} | 1152 | % \begin{center} |
584 | % {\large\bf 1. APPLICABILITY AND DEFINITIONS\par} | 1153 | % {\large\bf 1. APPLICABILITY AND DEFINITIONS\par} |
585 | % \end{center} | 1154 | % \end{center} |
@@ -678,7 +1247,7 @@ along with this program. If not, see | |||
678 | % implication that these Warranty Disclaimers may have is void and has | 1247 | % implication that these Warranty Disclaimers may have is void and has |
679 | % no effect on the meaning of this License. | 1248 | % no effect on the meaning of this License. |
680 | % | 1249 | % |
681 | % \needspace{\baselineskip} | 1250 | % \needspace{3\baselineskip} |
682 | % \begin{center} | 1251 | % \begin{center} |
683 | % {\large\bf 2. VERBATIM COPYING\par} | 1252 | % {\large\bf 2. VERBATIM COPYING\par} |
684 | % \end{center} | 1253 | % \end{center} |
@@ -697,7 +1266,7 @@ along with this program. If not, see | |||
697 | % You may also lend copies, under the same conditions stated above, | 1266 | % You may also lend copies, under the same conditions stated above, |
698 | % and you may publicly display copies. | 1267 | % and you may publicly display copies. |
699 | % | 1268 | % |
700 | % \needspace{\baselineskip} | 1269 | % \needspace{3\baselineskip} |
701 | % \begin{center} | 1270 | % \begin{center} |
702 | % {\large\bf 3. COPYING IN QUANTITY\par} | 1271 | % {\large\bf 3. COPYING IN QUANTITY\par} |
703 | % \end{center} | 1272 | % \end{center} |
@@ -738,7 +1307,7 @@ along with this program. If not, see | |||
738 | % to give them a chance to provide you with an updated version of the | 1307 | % to give them a chance to provide you with an updated version of the |
739 | % Document. | 1308 | % Document. |
740 | % | 1309 | % |
741 | % \needspace{\baselineskip} | 1310 | % \needspace{3\baselineskip} |
742 | % \begin{center} | 1311 | % \begin{center} |
743 | % {\large\bf 4. MODIFICATIONS\par} | 1312 | % {\large\bf 4. MODIFICATIONS\par} |
744 | % \end{center} | 1313 | % \end{center} |
@@ -759,66 +1328,67 @@ along with this program. If not, see | |||
759 | % previous version if the original publisher of that version gives | 1328 | % previous version if the original publisher of that version gives |
760 | % permission. | 1329 | % permission. |
761 | % | 1330 | % |
762 | % \item[B.] List on the Title Page, as authors, one or more persons | 1331 | % \item[B.] List on the Title Page, as authors, one or more persons |
763 | % or entities responsible for authorship of the modifications in the | 1332 | % or entities responsible for authorship of the modifications in |
764 | % Modified Version, together with at least five of the principal | 1333 | % the Modified Version, together with at least five of the |
765 | % authors of the Document (all of its principal authors, if it has | 1334 | % principal authors of the Document (all of its principal authors, |
766 | % fewer than five), unless they release you from this requirement. | 1335 | % if it has fewer than five), unless they release you from this |
1336 | % requirement. | ||
767 | % | 1337 | % |
768 | % \item[C.] State on the Title page the name of the publisher of the | 1338 | % \item[C.] State on the Title page the name of the publisher of the |
769 | % Modified Version, as the publisher. | 1339 | % Modified Version, as the publisher. |
770 | % | 1340 | % |
771 | % \item[D.] Preserve all the copyright notices of the Document. | 1341 | % \item[D.] Preserve all the copyright notices of the Document. |
772 | % | 1342 | % |
773 | % \item[E.] Add an appropriate copyright notice for your | 1343 | % \item[E.] Add an appropriate copyright notice for your |
774 | % modifications adjacent to the other copyright notices. | 1344 | % modifications adjacent to the other copyright notices. |
775 | % | 1345 | % |
776 | % \item[F.] Include, immediately after the copyright notices, a | 1346 | % \item[F.] Include, immediately after the copyright notices, a |
777 | % license notice giving the public permission to use the Modified | 1347 | % license notice giving the public permission to use the Modified |
778 | % Version under the terms of this License, in the form shown in the | 1348 | % Version under the terms of this License, in the form shown in the |
779 | % Addendum below. | 1349 | % Addendum below. |
780 | % | 1350 | % |
781 | % \item[G.] Preserve in that license notice the full lists of | 1351 | % \item[G.] Preserve in that license notice the full lists of |
782 | % Invariant Sections and required Cover Texts given in the | 1352 | % Invariant Sections and required Cover Texts given in the |
783 | % Document's license notice. | 1353 | % Document's license notice. |
784 | % | 1354 | % |
785 | % \item[H.] Include an unaltered copy of this License. | 1355 | % \item[H.] Include an unaltered copy of this License. |
786 | % | 1356 | % |
787 | % \item[I.] Preserve the section Entitled \enquote{History}, Preserve | 1357 | % \item[I.] Preserve the section Entitled \enquote{History}, |
788 | % its Title, and add to it an item stating at least the title, year, | 1358 | % Preserve its Title, and add to it an item stating at least the |
789 | % new authors, and publisher of the Modified Version as given on the | 1359 | % title, year, new authors, and publisher of the Modified Version |
790 | % Title Page. If there is no section Entitled \enquote{History} in | 1360 | % as given on the Title Page. If there is no section Entitled |
791 | % the Document, create one stating the title, year, authors, and | 1361 | % \enquote{History} in the Document, create one stating the title, |
792 | % publisher of the Document as given on its Title Page, then add an | 1362 | % year, authors, and publisher of the Document as given on its |
793 | % item describing the Modified Version as stated in the previous | 1363 | % Title Page, then add an item describing the Modified Version as |
794 | % sentence. | 1364 | % stated in the previous sentence. |
795 | % | 1365 | % |
796 | % \item[J.] Preserve the network location, if any, given in the | 1366 | % \item[J.] Preserve the network location, if any, given in the |
797 | % Document for public access to a Transparent copy of the Document, | 1367 | % Document for public access to a Transparent copy of the Document, |
798 | % and likewise the network locations given in the Document for | 1368 | % and likewise the network locations given in the Document for |
799 | % previous versions it was based on. These may be placed in the | 1369 | % previous versions it was based on. These may be placed in the |
800 | % \enquote{History} section. You may omit a network location for a | 1370 | % \enquote{History} section. You may omit a network location for a |
801 | % work that was published at least four years before the Document | 1371 | % work that was published at least four years before the Document |
802 | % itself, or if the original publisher of the version it refers to | 1372 | % itself, or if the original publisher of the version it refers to |
803 | % gives permission. | 1373 | % gives permission. |
804 | % | 1374 | % |
805 | % \item[K.] For any section Entitled \enquote{Acknowledgements} or | 1375 | % \item[K.] For any section Entitled \enquote{Acknowledgements} or |
806 | % \enquote{Dedications}, Preserve the Title of the section, and | 1376 | % \enquote{Dedications}, Preserve the Title of the section, and |
807 | % preserve in the section all the substance and tone of each of the | 1377 | % preserve in the section all the substance and tone of each of the |
808 | % contributor acknowledgements and/or dedications given therein. | 1378 | % contributor acknowledgements and/or dedications given therein. |
809 | % | 1379 | % |
810 | % \item[L.] Preserve all the Invariant Sections of the Document, | 1380 | % \item[L.] Preserve all the Invariant Sections of the Document, |
811 | % unaltered in their text and in their titles. Section numbers or | 1381 | % unaltered in their text and in their titles. Section numbers or |
812 | % the equivalent are not considered part of the section titles. | 1382 | % the equivalent are not considered part of the section titles. |
813 | % | 1383 | % |
814 | % \item[M.] Delete any section Entitled \enquote{Endorsements}. Such | 1384 | % \item[M.] Delete any section Entitled \enquote{Endorsements}. |
815 | % a section may not be included in the Modified Version. | 1385 | % Such a section may not be included in the Modified Version. |
816 | % | 1386 | % |
817 | % \item[N.] Do not retitle any existing section to be Entitled | 1387 | % \item[N.] Do not retitle any existing section to be Entitled |
818 | % \enquote{Endorsements} or to conflict in title with any Invariant | 1388 | % \enquote{Endorsements} or to conflict in title with any Invariant |
819 | % Section. | 1389 | % Section. |
820 | % | 1390 | % |
821 | % \item[O.] Preserve any Warranty Disclaimers. | 1391 | % \item[O.] Preserve any Warranty Disclaimers. |
822 | % \end{itemize} | 1392 | % \end{itemize} |
823 | % | 1393 | % |
824 | % If the Modified Version includes new front-matter sections or | 1394 | % If the Modified Version includes new front-matter sections or |
@@ -850,7 +1420,7 @@ along with this program. If not, see | |||
850 | % License give permission to use their names for publicity for or to | 1420 | % License give permission to use their names for publicity for or to |
851 | % assert or imply endorsement of any Modified Version. | 1421 | % assert or imply endorsement of any Modified Version. |
852 | % | 1422 | % |
853 | % \needspace{\baselineskip} | 1423 | % \needspace{3\baselineskip} |
854 | % \begin{center} | 1424 | % \begin{center} |
855 | % {\large\bf 5. COMBINING DOCUMENTS\par} | 1425 | % {\large\bf 5. COMBINING DOCUMENTS\par} |
856 | % \end{center} | 1426 | % \end{center} |
@@ -879,7 +1449,7 @@ along with this program. If not, see | |||
879 | % \enquote{Dedications}. You must delete all sections Entitled | 1449 | % \enquote{Dedications}. You must delete all sections Entitled |
880 | % \enquote{Endorsements}. | 1450 | % \enquote{Endorsements}. |
881 | % | 1451 | % |
882 | % \needspace{\baselineskip} | 1452 | % \needspace{3\baselineskip} |
883 | % \begin{center} | 1453 | % \begin{center} |
884 | % {\large\bf 6. COLLECTIONS OF DOCUMENTS\par} | 1454 | % {\large\bf 6. COLLECTIONS OF DOCUMENTS\par} |
885 | % \end{center} | 1455 | % \end{center} |
@@ -897,9 +1467,9 @@ along with this program. If not, see | |||
897 | % License in all other respects regarding verbatim copying of that | 1467 | % License in all other respects regarding verbatim copying of that |
898 | % document. | 1468 | % document. |
899 | % | 1469 | % |
900 | % \needspace{\baselineskip} | 1470 | % \needspace{3\baselineskip} |
901 | % \begin{center} | 1471 | % \begin{center} |
902 | % {\large\bf 7. AGGREGATION WITH INDEPENDENT WORKS\par} | 1472 | % {\large\bf 7. AGGREGATION WITH INDEPENDENT WORKS\par} |
903 | % \end{center} | 1473 | % \end{center} |
904 | % | 1474 | % |
905 | % A compilation of the Document or its derivatives with other separate | 1475 | % A compilation of the Document or its derivatives with other separate |
@@ -919,7 +1489,7 @@ along with this program. If not, see | |||
919 | % form. Otherwise they must appear on printed covers that bracket the | 1489 | % form. Otherwise they must appear on printed covers that bracket the |
920 | % whole aggregate. | 1490 | % whole aggregate. |
921 | % | 1491 | % |
922 | % \needspace{\baselineskip} | 1492 | % \needspace{3\baselineskip} |
923 | % \begin{center} | 1493 | % \begin{center} |
924 | % {\large\bf 8. TRANSLATION\par} | 1494 | % {\large\bf 8. TRANSLATION\par} |
925 | % \end{center} | 1495 | % \end{center} |
@@ -943,7 +1513,7 @@ along with this program. If not, see | |||
943 | % (section~4) to Preserve its Title (section~1) will typically require | 1513 | % (section~4) to Preserve its Title (section~1) will typically require |
944 | % changing the actual title. | 1514 | % changing the actual title. |
945 | % | 1515 | % |
946 | % \needspace{\baselineskip} | 1516 | % \needspace{3\baselineskip} |
947 | % \begin{center} | 1517 | % \begin{center} |
948 | % {\large\bf 9. TERMINATION\par} | 1518 | % {\large\bf 9. TERMINATION\par} |
949 | % \end{center} | 1519 | % \end{center} |
@@ -973,7 +1543,7 @@ along with this program. If not, see | |||
973 | % permanently reinstated, receipt of a copy of some or all of the same | 1543 | % permanently reinstated, receipt of a copy of some or all of the same |
974 | % material does not give you any rights to use it. | 1544 | % material does not give you any rights to use it. |
975 | % | 1545 | % |
976 | % \needspace{\baselineskip} | 1546 | % \needspace{3\baselineskip} |
977 | % \begin{center} | 1547 | % \begin{center} |
978 | % {\large\bf 10. FUTURE REVISIONS OF THIS LICENSE\par} | 1548 | % {\large\bf 10. FUTURE REVISIONS OF THIS LICENSE\par} |
979 | % \end{center} | 1549 | % \end{center} |
@@ -997,7 +1567,7 @@ along with this program. If not, see | |||
997 | % proxy's public statement of acceptance of a version permanently | 1567 | % proxy's public statement of acceptance of a version permanently |
998 | % authorizes you to choose that version for the Document. | 1568 | % authorizes you to choose that version for the Document. |
999 | % | 1569 | % |
1000 | % \needspace{\baselineskip} | 1570 | % \needspace{3\baselineskip} |
1001 | % \begin{center} | 1571 | % \begin{center} |
1002 | % {\large\bf 11. RELICENSING\par} | 1572 | % {\large\bf 11. RELICENSING\par} |
1003 | % \end{center} | 1573 | % \end{center} |
@@ -1030,7 +1600,7 @@ along with this program. If not, see | |||
1030 | % site under CC-BY-SA on the same site at any time before August 1, | 1600 | % site under CC-BY-SA on the same site at any time before August 1, |
1031 | % 2009, provided the MMC is eligible for relicensing. | 1601 | % 2009, provided the MMC is eligible for relicensing. |
1032 | % | 1602 | % |
1033 | % \needspace{\baselineskip} | 1603 | % \needspace{3\baselineskip} |
1034 | % \begin{center} | 1604 | % \begin{center} |
1035 | % {\large\bf ADDENDUM: How to use this License for your documents\par} | 1605 | % {\large\bf ADDENDUM: How to use this License for your documents\par} |
1036 | % \end{center} | 1606 | % \end{center} |
@@ -1067,26 +1637,31 @@ along with this program. If not, see | |||
1067 | % | 1637 | % |
1068 | % If your document contains nontrivial examples of program code, we | 1638 | % If your document contains nontrivial examples of program code, we |
1069 | % recommend releasing these examples in parallel under your choice of | 1639 | % recommend releasing these examples in parallel under your choice of |
1070 | % free software license, such as the GNU General Public License, to | 1640 | % free software license, such as the GNU General Public License, |
1071 | % permit their use in free software. | 1641 | % to permit their use in free software. |
1642 | % | ||
1643 | % \printbibliography[heading=bibintoc] | ||
1072 | % | 1644 | % |
1645 | % \StopEventually{} | ||
1646 | % | ||
1073 | % \section{Implementation} | 1647 | % \section{Implementation} |
1074 | % | 1648 | % |
1075 | % \iffalse | 1649 | % \iffalse |
1076 | %<*package> | 1650 | %<*package> |
1077 | % \fi | 1651 | % \fi |
1078 | % | 1652 | % |
1079 | % \package{ekdosis} relies on Lua functions and tables. Read the | 1653 | % \pkg{ekdosis} relies on Lua functions and tables. Read the |
1080 | % |.lua| files that accompany \package{ekdosis} for more information. | 1654 | % |.lua| files that accompany \pkg{ekdosis} for more |
1655 | % information. | ||
1081 | % \begin{macrocode} | 1656 | % \begin{macrocode} |
1082 | \RequirePackage{iftex} | 1657 | \RequirePackage{iftex} |
1083 | % \end{macrocode} | 1658 | % \end{macrocode} |
1084 | % \package{ekdosis} requires {\LuaLaTeX} of course. Issue an error | 1659 | % \pkg{ekdosis} requires {\LuaLaTeX} of course. Issue an error |
1085 | % if the document is processed with another engine. | 1660 | % if the document is processed with another engine. |
1086 | % \begin{macrocode} | 1661 | % \begin{macrocode} |
1087 | \RequireLuaTeX | 1662 | \RequireLuaTeX |
1088 | % \end{macrocode} | 1663 | % \end{macrocode} |
1089 | % Packages that are required by \package{ekdosis}: | 1664 | % Packages that are required by \pkg{ekdosis}: |
1090 | % \begin{macrocode} | 1665 | % \begin{macrocode} |
1091 | \RequirePackage{xkeyval} | 1666 | \RequirePackage{xkeyval} |
1092 | \newif\if@pkg@float | 1667 | \newif\if@pkg@float |
@@ -1183,7 +1758,9 @@ along with this program. If not, see | |||
1183 | % \begin{macrocode} | 1758 | % \begin{macrocode} |
1184 | \ekvdefinekeys{ekd@witness}{ | 1759 | \ekvdefinekeys{ekd@witness}{ |
1185 | store settlement = \settlement@value, | 1760 | store settlement = \settlement@value, |
1761 | store institution = \institution@value, | ||
1186 | store repository = \repository@value, | 1762 | store repository = \repository@value, |
1763 | store collection = \collection@value, | ||
1187 | store idno = \idno@value, | 1764 | store idno = \idno@value, |
1188 | store msName = \msName@value, | 1765 | store msName = \msName@value, |
1189 | store origDate = \origDate@value | 1766 | store origDate = \origDate@value |
@@ -1196,7 +1773,9 @@ along with this program. If not, see | |||
1196 | \luastringN{#2}, | 1773 | \luastringN{#2}, |
1197 | \luastringN{#3}, | 1774 | \luastringN{#3}, |
1198 | \luastringO{\settlement@value}, | 1775 | \luastringO{\settlement@value}, |
1776 | \luastringO{\institution@value}, | ||
1199 | \luastringO{\repository@value}, | 1777 | \luastringO{\repository@value}, |
1778 | \luastringO{\collection@value}, | ||
1200 | \luastringO{\idno@value}, | 1779 | \luastringO{\idno@value}, |
1201 | \luastringO{\msName@value}, | 1780 | \luastringO{\msName@value}, |
1202 | \luastringO{\origDate@value})} | 1781 | \luastringO{\origDate@value})} |
@@ -2128,7 +2707,9 @@ function ekdosis.newwitness(id, | |||
2128 | siglum, | 2707 | siglum, |
2129 | description, | 2708 | description, |
2130 | Settlement, | 2709 | Settlement, |
2710 | Institution, | ||
2131 | Repository, | 2711 | Repository, |
2712 | Collection, | ||
2132 | Idno, | 2713 | Idno, |
2133 | MsName, | 2714 | MsName, |
2134 | OrigDate) | 2715 | OrigDate) |
@@ -2149,7 +2730,9 @@ function ekdosis.newwitness(id, | |||
2149 | detailsDesc = description, | 2730 | detailsDesc = description, |
2150 | msIdentifier = { | 2731 | msIdentifier = { |
2151 | settlement = Settlement, | 2732 | settlement = Settlement, |
2733 | institution = Institution, | ||
2152 | repository = Repository, | 2734 | repository = Repository, |
2735 | collection = Collection, | ||
2153 | idno = Idno, | 2736 | idno = Idno, |
2154 | msName = MsName} | 2737 | msName = MsName} |
2155 | }) | 2738 | }) |
@@ -2267,6 +2850,8 @@ local cmdtotags = { | |||
2267 | {a="LRfootnote", b="note", c=" place=\"bottom\""}, | 2850 | {a="LRfootnote", b="note", c=" place=\"bottom\""}, |
2268 | {a="RLfootnote", b="note", c=" place=\"bottom\""}, | 2851 | {a="RLfootnote", b="note", c=" place=\"bottom\""}, |
2269 | {a="footnote", b="note", c=" place=\"bottom\""}, | 2852 | {a="footnote", b="note", c=" place=\"bottom\""}, |
2853 | {a="enquote *", b="quote", c=""}, | ||
2854 | {a="enquote", b="quote", c=""}, | ||
2270 | {a="txtrans", b="s", c=" xml:lang=\"ar-Latn\" type=\"transliterated\""}, | 2855 | {a="txtrans", b="s", c=" xml:lang=\"ar-Latn\" type=\"transliterated\""}, |
2271 | {a="textbf", b="hi", c=" rend=\"bold\""}, | 2856 | {a="textbf", b="hi", c=" rend=\"bold\""}, |
2272 | {a="textit", b="hi", c=" rend=\"italic\""}, | 2857 | {a="textit", b="hi", c=" rend=\"italic\""}, |
@@ -2951,7 +3536,9 @@ function ekdosis.openteistream() | |||
2951 | f:write(textotei(listWit[i].detailsDesc), "\n") | 3536 | f:write(textotei(listWit[i].detailsDesc), "\n") |
2952 | f:write("<msDesc>", "\n") | 3537 | f:write("<msDesc>", "\n") |
2953 | if listWit[i].msIdentifier.settlement == "" | 3538 | if listWit[i].msIdentifier.settlement == "" |
3539 | and listWit[i].msIdentifier.institution == "" | ||
2954 | and listWit[i].msIdentifier.repository == "" | 3540 | and listWit[i].msIdentifier.repository == "" |
3541 | and listWit[i].msIdentifier.collection == "" | ||
2955 | and listWit[i].msIdentifier.idno == "" | 3542 | and listWit[i].msIdentifier.idno == "" |
2956 | and listWit[i].msIdentifier.msName == "" | 3543 | and listWit[i].msIdentifier.msName == "" |
2957 | then | 3544 | then |
@@ -2961,9 +3548,15 @@ function ekdosis.openteistream() | |||
2961 | if listWit[i].msIdentifier.settlement ~= "" then | 3548 | if listWit[i].msIdentifier.settlement ~= "" then |
2962 | f:write("<settlement>", textotei(listWit[i].msIdentifier.settlement), "</settlement>", "\n") | 3549 | f:write("<settlement>", textotei(listWit[i].msIdentifier.settlement), "</settlement>", "\n") |
2963 | else end | 3550 | else end |
3551 | if listWit[i].msIdentifier.institution ~= "" then | ||
3552 | f:write("<institution>", textotei(listWit[i].msIdentifier.institution), "</institution>", "\n") | ||
3553 | else end | ||
2964 | if listWit[i].msIdentifier.repository ~= "" then | 3554 | if listWit[i].msIdentifier.repository ~= "" then |
2965 | f:write("<repository>", textotei(listWit[i].msIdentifier.repository), "</repository>", "\n") | 3555 | f:write("<repository>", textotei(listWit[i].msIdentifier.repository), "</repository>", "\n") |
2966 | else end | 3556 | else end |
3557 | if listWit[i].msIdentifier.collection ~= "" then | ||
3558 | f:write("<collection>", textotei(listWit[i].msIdentifier.collection), "</collection>", "\n") | ||
3559 | else end | ||
2967 | if listWit[i].msIdentifier.idno ~= "" then | 3560 | if listWit[i].msIdentifier.idno ~= "" then |
2968 | f:write("<idno>", textotei(listWit[i].msIdentifier.idno), "</idno>", "\n") | 3561 | f:write("<idno>", textotei(listWit[i].msIdentifier.idno), "</idno>", "\n") |
2969 | else end | 3562 | else end |
@@ -3709,4 +4302,4 @@ end | |||
3709 | % \iffalse | 4302 | % \iffalse |
3710 | %</examples> | 4303 | %</examples> |
3711 | % \fi | 4304 | % \fi |
3712 | \endinput \ No newline at end of file | 4305 | \endinput |