aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRobert Alessi <alessi@robertalessi.net>2020-08-28 19:48:01 +0200
committerRobert Alessi <alessi@robertalessi.net>2020-08-28 19:48:01 +0200
commit0bb0349f8bfaceac713f00dc42c9dc7c5f17aa4d (patch)
tree54af9fef52839f8ec599030dfd3c8097349d365e
parentf56c61b70af2ad5bcdb3dca418d6a3ad6cd47d3a (diff)
downloadekdosis-0bb0349f8bfaceac713f00dc42c9dc7c5f17aa4d.tar.gz
requiring xparse is no longer necessary.
Diffstat
-rw-r--r--Makefile1
-rw-r--r--README.md2
-rw-r--r--about.html2
-rw-r--r--ekdosis.dtx797
4 files changed, 400 insertions, 402 deletions
diff --git a/Makefile b/Makefile
index 64ab76a..cd52273 100644
--- a/Makefile
+++ b/Makefile
@@ -35,6 +35,7 @@ $(NAME).pdf: testsamples $(NAME).dtx
35 if [ -f $(NAME).idx ]; then makeindex -q -s gind.ist -o $(NAME).ind $(NAME).idx; fi 35 if [ -f $(NAME).idx ]; then makeindex -q -s gind.ist -o $(NAME).ind $(NAME).idx; fi
36 $(CMP) --shell-escape --recorder --interaction=nonstopmode $(NAME).dtx > /dev/null 36 $(CMP) --shell-escape --recorder --interaction=nonstopmode $(NAME).dtx > /dev/null
37 $(CMP) --shell-escape --recorder --interaction=nonstopmode $(NAME).dtx > /dev/null 37 $(CMP) --shell-escape --recorder --interaction=nonstopmode $(NAME).dtx > /dev/null
38 $(CMP) --shell-escape --recorder --interaction=nonstopmode $(NAME).dtx > /dev/null
38 39
39samples: clean sty 40samples: clean sty
40 $(MAKE) --directory=$(SAMPLES) 41 $(MAKE) --directory=$(SAMPLES)
diff --git a/README.md b/README.md
index 8b54b9d..34cce3f 100644
--- a/README.md
+++ b/README.md
@@ -81,7 +81,7 @@ Installation
81 `ekdosis.lua` files. 81 `ekdosis.lua` files.
82 82
832. To finish the installation you have to move the `ekdosis.sty` and 832. To finish the installation you have to move the `ekdosis.sty` and
84 `ekdosis.lua` files into a directory where LaTeX can find it. See 84 `ekdosis.lua` files into a directory where LaTeX can find them. See
85 the FAQ on `texfaq.org` at <https://texfaq.org/FAQ-inst-wlcf> for 85 the FAQ on `texfaq.org` at <https://texfaq.org/FAQ-inst-wlcf> for
86 more on this. 86 more on this.
87 87
diff --git a/about.html b/about.html
index 3100f83..a246b48 100644
--- a/about.html
+++ b/about.html
@@ -42,7 +42,7 @@
42<h1 id="installation">Installation</h1> 42<h1 id="installation">Installation</h1>
43<ol style="list-style-type: decimal"> 43<ol style="list-style-type: decimal">
44<li><p>Run <code>'latex ekdosis.ins'</code> to produce the <code>ekdosis.sty</code> and <code>ekdosis.lua</code> files.</p></li> 44<li><p>Run <code>'latex ekdosis.ins'</code> to produce the <code>ekdosis.sty</code> and <code>ekdosis.lua</code> files.</p></li>
45<li><p>To finish the installation you have to move the <code>ekdosis.sty</code> and <code>ekdosis.lua</code> files into a directory where LaTeX can find it. See the FAQ on <code>texfaq.org</code> at <a href="https://texfaq.org/FAQ-inst-wlcf" class="uri">https://texfaq.org/FAQ-inst-wlcf</a> for more on this.</p></li> 45<li><p>To finish the installation you have to move the <code>ekdosis.sty</code> and <code>ekdosis.lua</code> files into a directory where LaTeX can find them. See the FAQ on <code>texfaq.org</code> at <a href="https://texfaq.org/FAQ-inst-wlcf" class="uri">https://texfaq.org/FAQ-inst-wlcf</a> for more on this.</p></li>
46</ol> 46</ol>
47<h1 id="development-git-repository">Development, Git Repository</h1> 47<h1 id="development-git-repository">Development, Git Repository</h1>
48<h2 id="browse-the-code">Browse the Code</h2> 48<h2 id="browse-the-code">Browse the Code</h2>
diff --git a/ekdosis.dtx b/ekdosis.dtx
index 5a7282e..4319887 100644
--- a/ekdosis.dtx
+++ b/ekdosis.dtx
@@ -1712,6 +1712,398 @@ yesterday.
1712%</example> 1712%</example>
1713% \fi 1713% \fi
1714% 1714%
1715% \section{Emendations and Conjectures}
1716% \label{sec:emendations-conjectures}
1717% From a technical standpoint, \enquote{conjectures} are readings that
1718% are not supported by manuscript evidence, but are instead proposed
1719% by scholars to be taken into consideration for establishing the
1720% edition text. A conjecture is called an \enquote{emendation} if it
1721% is adopted in place of what is provided by or missing from the text
1722% provided by the manuscripts. Emendations and conjectures are
1723% therefore readings and as such expected to be found within |<lem>|
1724% or |<rdg>| elements. However, as both come from editions or
1725% scholars, not from manuscripts, they are naturally associated with
1726% |source| or |resp| attributes as described above
1727% \vpagerefrange{ref:lem-source}{ref:lem-resp},\footnote{See also
1728% \vpagerefrange{ref:declare-source}{ref:declare-scholar}.} and can be
1729% distinguished from one another by the |type| attribute, eg.\ either
1730% |emendation| or |conjecture|.
1731%
1732% As an example, the representation of witnesses, editors and
1733% shorthands of Hippocrates' \emph{Epidemics}, Book~2 could be
1734% summarized as follows:---
1735%
1736% \iffalse
1737%<*example>
1738% \fi
1739\begin{minted}{latex}
1740% Witnesses:
1741\DeclareWitness{V}{V}{\emph{Vaticanus Gr.} 276}
1742\DeclareWitness{I}{I}{\emph{Parisinus Gr.} 2140}
1743\DeclareHand{Iac}{I}{I\textsuperscript{ac}}[Lectio ante correctionem]
1744\DeclareHand{Ipc}{I}{I\textsuperscript{pc}}[Lectio post correctionem]
1745\DeclareWitness{R}{R}{\emph{Vaticanus Gr.} 277}
1746\DeclareWitness{H}{H}{\emph{Parisinus Gr.} 2142}
1747% Sources (the first arguments below must refer to biblatex labels and
1748% an xml bibliographical database must be supplied):
1749\DeclareSource{Lit}{Littré}
1750\DeclareSource{Erm}{Ermerins}
1751\DeclareSource{Sm}{Smith}
1752% Persons:
1753\DeclareScholar{ego}{ego}[
1754 forename=Robert,
1755 surname=Alessi]
1756% Useful shorthands:
1757\DeclareShorthand{codd}{codd.}{V,I,R,H}
1758\DeclareShorthand{edd}{edd.}{Lit,Erm,Sm}
1759\DeclareShorthand{egoscr}{\emph{scripsi}}{ego}
1760\end{minted}
1761% \iffalse
1762%</example>
1763% \fi
1764%
1765% As can be seen from lines~18--20, three useful shorthands have been
1766% defined: |codd| prints \enquote{codd.} for Latin pl.\ \emph{codices}
1767% viz.\ \enquote{all manuscripts} and refers to the three \texttt{xml}
1768% identifiers |V|, |I|, |R| and |H| declared at ll.~2--3 and 6--7;
1769% |edd| prints \enquote{edd.} for Latin pl.\ \emph{editores} viz.\
1770% \enquote{all editors} and refers to the three \texttt{xml}
1771% identifiers |Lit|, |Erm| and |Sm| declared at
1772% ll.~10--12;\footnote{For detailed information on how to use
1773% \cs{DeclareSource} and insert references to cited works, the reader
1774% is invited to refer to \vref{sec:references-cited-works}.} finally,
1775% |egoscr| (l.~20) is used to print the technical Latin term
1776% \enquote{\emph{scripsi}}, \enquote{I wrote}, to denote a personal
1777% conjecture. Then, the |.tex| source file can be structured as
1778% follows:---
1779%
1780% \iffalse
1781%<*example>
1782% \fi
1783\begin{minted}{latex}
1784\begin{ekdosis}
1785 καὶ ἐγίνετο μᾶλλον \app{
1786 \lem[wit={V, Ipc,R,H}]{νότῳ}
1787 \rdg[wit=Iac]{νότου}
1788 \rdg[source=Erm, type=conjecture]{ἐν νώτῳ}}· [...] % conjecture
1789
1790 εἰ
1791 \app{
1792 \lem[resp=egoscr, type=emendation]{μὲν} % emendation
1793 \rdg[wit=codd, source=edd]{μὴ}
1794 } εἴη διὰ ταῦτα [...]
1795\end{ekdosis}
1796\end{minted}
1797% \iffalse
1798%</example>
1799% \fi
1800%
1801% \begin{remarks}
1802% \item Line~5 introduces a \emph{conjecture} which has been annotated
1803% with |type=conjecture| to facilitate its identification. Other
1804% optional arguments could have been used, such as
1805% |prewit=|\texttt{coni.} or |prewit=|\texttt{falso coni.}, to print
1806% explanatory words in the apparatus criticus before the abridged
1807% name of the scholar.
1808% \item Conversely, line~9 introduces an \emph{emendation} for which
1809% the shorthand |egoscr| has been used to print the exact term
1810% \emph{scripsi} in the apparatus criticus while keeping |ego| as an
1811% |xml:id| for the \texttt{TEI xml} ouput file. Other strategies
1812% could have been used. For example, one could have defined a
1813% specific shorthand to print nothing in place of |ego| and leave
1814% the insertion of technical terms to the |post| optional argument
1815% of \cs{lem}, like so:---
1816% \iffalse
1817%<*example>
1818% \fi
1819\begin{minted}[linenos=false]{latex}
1820% Preamble:
1821% (\unskip is for removing the space left by the empty 2nd argument
1822% below.)
1823\DeclareShorthand{egomute}{\unskip}{ego}
1824
1825% Document:
1826 \app{
1827 \lem[resp=egomute, post=\emph{scripsi}, type=emendation]{μὲν}
1828 \rdg[wit=codd, source=edd]{μὴ}
1829 } εἴη διὰ ταῦτα [...]
1830\end{minted}
1831% \iffalse
1832%</example>
1833% \fi
1834% \end{remarks}
1835%
1836% PDF output:---
1837% \medskip
1838%
1839% \needspace{7\baselineskip}
1840% \resetlinenumber
1841% \begin{alignment}[flush,tcols=1,texts=specimen,apparatus=specimen]
1842% \begin{specimen}
1843% \begin{ancientgreek}
1844% καὶ ἐγίνετο μᾶλλον \app{
1845% \lem[wit={hV, hIpc,hR,hH}]{νότῳ}
1846% \rdg[wit=hIac]{νότου}
1847% \rdg[source=Erm, type=conjecture]{ἐν νώτῳ}}· [...]
1848%
1849% εἰ \app{
1850% \lem[resp=hegoscr, type=emendation]{μὲν}
1851% \rdg[wit=hcodd, source=hedd]{μὴ}
1852% } εἴη διὰ ταῦτα [...]
1853% \end{ancientgreek}
1854% \end{specimen}
1855% \end{alignment}
1856%
1857% \texttt{TEI xml} output:---
1858%
1859% \iffalse
1860%<*example>
1861% \fi
1862\begin{minted}[linenos=false]{xml}
1863<p xml:lang="grc">καὶ ἐγίνετο μᾶλλον
1864<app>
1865 <lem wit="#V #Ipc #R #H">νότῳ</lem>
1866 <rdg wit="#Iac">νότου</rdg>
1867 <rdg source="#Erm" type="conjecture">ἐν νώτῳ</rdg>
1868</app>· [...]</p>
1869<p>εἰ
1870<app>
1871 <lem resp="#ego" type="emendation">μὲν</lem>
1872 <rdg wit="#V #I #R #H" source="#Lit #Erm #Sm">
1873 μὴ</rdg>
1874</app>εἴη διὰ ταῦτα [...]</p>
1875\end{minted}
1876% \iffalse
1877%</example>
1878% \fi
1879%
1880% \subsection{Editorial Addition and Deletion}
1881% \label{sec:editorial-add-del}
1882% \pkg{ekdosis} provides a set of commands to indicate that text has
1883% been supplied or removed by conjecture. As regards critical
1884% symbols conventionally used for representing emendations, lacunae,
1885% omissions, gaps, editorial deletions or additions and the like,
1886% \pkg{ekdosis} follows the standards as described by
1887% \textcite[80--82]{West1973}:---
1888% \begin{description}[font=\ttfamily]
1889% \item[<>] text added by conjecture or from a parallel source.
1890% \item[***] lacuna in the whole textual tradition.
1891% \item[<***>] conjectured lacuna.
1892% \item[\{\}] editorial deletion.
1893% \item[\dag\dag] text juged by the editor to be corrupt. Note that if
1894% only one word is suspect, only one crux is needed.
1895% \end{description}
1896%
1897% \DescribeMacro{\SetCritSymbols}\newfeature[v1.1]
1898% \cs{SetCritSymbols}\marg{csv list of options} can be used to change
1899% the critical symbols described above. This command accepts the
1900% following list of |key-value|
1901% optional arguments:---\\
1902% \DescribeOption{suppbegin}|suppbegin|$=$\meta{symbol}
1903% \hfill\tcboxverb{Default: <}\\
1904% The opening symbol used to mark the text that is supplied.\\
1905% \DescribeOption{suppend}|suppend|$=$\meta{symbol}
1906% \hfill\tcboxverb{Default: >}\\
1907% The closing symbol used to mark the text that is supplied.\\
1908% \DescribeOption{delbegin}|delbegin|$=$\meta{symbol}
1909% \hfill\tcboxverb|Default: {|\\
1910% The opening symbol used to mark the text that is deleted.\\
1911% \DescribeOption{delend}|delend|$=$\meta{symbol}
1912% \hfill\tcboxverb|Default: }|\\
1913% The closing symbol used to mark the text that is deleted.\\
1914% \DescribeOption{sicbegin}|sicbegin|$=$\meta{symbol}
1915% \hfill\tcboxverb{Default: †}\\
1916% The opening symbol used to mark the text that is deemed to be
1917% suspect.\\
1918% \DescribeOption{sicend}|sicend|$=$\meta{symbol}
1919% \hfill\tcboxverb{Default: †}\\
1920% The closing symbol used to mark the text that is deemed to be
1921% suspect.\\
1922% \DescribeOption{gapmark}|gapmark|$=$\meta{symbols}
1923% \hfill\tcboxverb{Default: ***}\\
1924% The symbols used to mark lacunae.\\
1925%
1926% As an example, what follows sets |[]| for deletions and |...| for
1927% lacunae:---
1928%
1929% \iffalse
1930%<*example>
1931% \fi
1932\begin{minted}[linenos=false]{latex}
1933\SetCritSymbols{
1934 delbegin = [,
1935 delend = ],
1936 gapmark = \dots
1937}
1938\end{minted}
1939% \iffalse
1940%</example>
1941% \fi
1942%
1943% \danger If modified, brackets can be adapted to languages that are
1944% written from right to left. To that effect, \pkg{ekdosis} provides a
1945% boolean expression |al@rlmode| which is evaluated as |true| if the
1946% writing direction is set from right to left and as |false|
1947% otherwise. As the \pkg{etoolbox} package is loaded by \pkg{ekdosis},
1948% \cs{ifboolean}|{al@rlmode}|\marg{rtl symbol}\marg{ltr symbol} can be
1949% used to perform the test.
1950%
1951% \paragraph{Editorial Addition}
1952% \DescribeMacro{\supplied}\newfeature[v1.1]\cs{supplied}\marg{text}
1953% is used to mark \meta{text} that is by definition missing from the
1954% tradition as supplied by the editor or some other scholar. This
1955% command is normally expected in \cs{lem}|{}| or \cs{rdg}|{}|.
1956%
1957% \paragraph{Editorial Deletion}
1958% \DescribeMacro{\surplus}\newfeature[v1.1] \cs{surplus}\marg{text}
1959% is used to mark \meta{text} that is deemed to be inauthentic, but
1960% nevertheless retained between braces in the edition text as it is
1961% transmitted by all witnesses. This command is normally expected in
1962% \cs{lem}|{}| or \cs{rdg}|{}|.
1963%
1964% \paragraph{Crux}
1965% \DescribeMacro{\sic}\newfeature[v1.1] \cs{sic}\marg{text} takes as
1966% mandatory argument the text deemed by the editor to be readable but
1967% not understandable. \cs{sic} inserts \meta{text} between cruces
1968% while \cs{sic*} prints only one crux before \meta{text}.
1969%
1970% \paragraph{Lacuna}
1971% \DescribeMacro{\gap}\newfeature[v1.1] \cs{gap}\marg{csv list of
1972% options} indicates that some amount of text has fallen away from the
1973% entire tradition. It takes as mandatory argument a comma-separated
1974% list of options that can be used to further specify the reason for
1975% omission, the unit of measurement, the quantity or the extent, as
1976% follows:---\\
1977% \DescribeOption{reason}|reason|$=$\meta{reason}\\
1978% |reason| gives the reason for omission.\\
1979% \DescribeOption{unit} |unit|$=$\meta{unit}\\
1980% |unit| provides some regularized measurement, such as |character|,
1981% |word|, |line| and the like.
1982% \DescribeOption{quantity} |quantity|$=$\meta{n}\\
1983% |quantity| specifies the number of the given unit that comprise the
1984% measurement.\\
1985% \DescribeOption{extent} |extent|$=$\meta{description}\\
1986% |extent| describes the size, including quantity and unit in a single
1987% string of words.
1988%
1989% \paragraph{Conjectured Lacuna}
1990% Assumably, the conjectured lacuna should be enclosed by
1991% \cs{supplied} and as such contained by \cs{lem} with
1992% |type=emendation| to indicate that the lacuna has been accepted by
1993% the editor.
1994%
1995% Examples follow:---
1996%
1997% \iffalse
1998%<*example>
1999% \fi
2000\begin{minted}{latex}
2001% Preamble:
2002\DeclareShorthand{egomute}{\unskip}{ego}
2003
2004% Document:
2005\begin{ekdosis}
2006 σχεδὸν \app{
2007 \lem[resp=egomute, nosep, post={post σχεδὸν quattuor uerba
2008 excidisse uid.}, type=emendation]{\supplied{\gap{reason=lost,
2009 unit=word, quantity=4}}}
2010 } οὗτοι
2011
2012 subsidiis magnis \sic*{epicuri} constabilitas
2013
2014 declinare quis est qui \sic{possit cernere sese}.
2015
2016 \app{
2017 \lem[resp=egomute, type=emendation, nosep, post={ante
2018 ὑπογίν.}]{\surplus{καὶ}}
2019 \note{deleui e Gal.P}
2020 } ὑπογίνονται
2021
2022 Πάντων δὲ \app{
2023 \lem[resp=egomute, type=emendation, post={addidi (\arb{^gamI`a
2024 'l-.hummayAti} Gal.)}]{\supplied{τῶν πυρετῶν}}
2025 \rdg[nordg, source=Gal]{\arb{^gamI`a 'l-.hummayAti}}
2026 \rdg[wit=codd, source=edd, alt=om.]{}
2027 },
2028\end{ekdosis}
2029\end{minted}
2030% \iffalse
2031%</example>
2032% \fi
2033%
2034% PDF output:---
2035% \medskip
2036% \needspace{7\baselineskip}
2037% \resetlinenumber
2038% \begin{alignment}[flush,tcols=1,texts=specimen,apparatus=specimen]
2039% \begin{specimen}
2040% σχεδὸν \app{
2041% \lem[resp=egomute, nosep, post={post σχεδὸν quattuor uerba
2042% excidisse uid.}, type=emendation]{\supplied{\gap{reason=lost,
2043% unit=word, quantity=4}}}
2044% } οὗτοι
2045%
2046% subsidiis magnis \sic*{epicuri} constabilitas
2047%
2048% declinare quis est qui \sic{possit cernere sese}.
2049%
2050% \app{
2051% \lem[resp=egomute, type=emendation, nosep, post={ante
2052% ὑπογίν.}]{\surplus{καὶ}}
2053% \note{deleui e Gal.P}
2054% } ὑπογίνονται
2055%
2056%
2057% Πάντων δὲ \app{
2058% \lem[resp=egomute, type=emendation, post={addidi (\arb{^gamI`a
2059% 'l-.hummayAti} Gal.)}]{\supplied{τῶν πυρετῶν}}
2060% \rdg[nordg, source=Gal]{\arb{^gamI`a 'l-.hummayAti}}
2061% \rdg[wit=hcodd, source=hedd, alt=om.]{}
2062% },
2063% \end{specimen}
2064% \end{alignment}
2065%
2066% \texttt{TEI xml} ouput:---
2067%
2068% \iffalse
2069%<*example>
2070% \fi
2071\begin{minted}[linenos=false]{xml}
2072<p>σχεδὸν
2073<app>
2074 <lem resp="#ego" type="emendation">
2075 <supplied>
2076 <gap reason="lost" unit="word" quantity="4" />
2077 </supplied>
2078 </lem>
2079</app>οὗτοι</p>
2080<p>subsidiis magnis
2081<sic>epicuri</sic> constabilitas</p>
2082<p>declinare quis est qui
2083<sic>possit cernere sese</sic>.</p>
2084<p>
2085<app>
2086 <lem resp="#ego" type="emendation">
2087 <surplus>καὶ</surplus>
2088 </lem>
2089 <note>deleui e Gal.P</note>
2090</app>ὑπογίνονται</p>
2091<p>Πάντων δὲ
2092<app>
2093 <lem resp="#ego" type="emendation">
2094 <supplied>τῶν πυρετῶν</supplied>
2095 </lem>
2096 <rdg source="#Gal">
2097 <foreign xml:lang="ar-Latn" type="transliterated"
2098 subtype="arabtex">^gamI`a 'l-.hummayAti</foreign>
2099 </rdg>
2100 <rdg wit="#V #I #R #H" source="#Lit #Erm #Sm" />
2101</app>,</p>
2102\end{minted}
2103% \iffalse
2104%</example>
2105% \fi
2106%
1715% \section{Alignment of Parallel Texts} 2107% \section{Alignment of Parallel Texts}
1716% \label{sec:alignment-basic} 2108% \label{sec:alignment-basic}
1717% As already said above,\footnote{See point 2109% As already said above,\footnote{See point
@@ -2103,12 +2495,11 @@ texts=latin[xml:lang="la"]+\textcolor{red}{;}+
2103% \label{sec:alignment-hooks} 2495% \label{sec:alignment-hooks}
2104% \DescribeMacro{\AtBeginEnvironment} Once environments corresponding 2496% \DescribeMacro{\AtBeginEnvironment} Once environments corresponding
2105% to texts to be aligned have been defined, it is advisable to use the 2497% to texts to be aligned have been defined, it is advisable to use the
2106% \cs{AtBeginEnvironment}\marg{environment}\marg{code} command that is 2498% \cs{AtBeginEnvironment}\marg{environment}\marg{code} command to
2107% provided by the \pkg{etoolbox} package\footnote{This package is 2499% further adjust languages, hyphenation rules, and/or fonts to be
2108% loaded by \pkg{ekdosis}.} to further adjust languages, hyphenation 2500% applied in each environment. To return to the example provided
2109% rules, and/or fonts to be applied in each environment. To return to 2501% above, once \cs{SetAlignment} has been used, the languages can be
2110% the example provided above, once \cs{SetAlignment} has been 2502% set as follows:---
2111% used, the languages can be set as follows:---
2112% 2503%
2113% \iffalse 2504% \iffalse
2114%<*example> 2505%<*example>
@@ -2122,398 +2513,6 @@ texts=latin[xml:lang="la"]+\textcolor{red}{;}+
2122%</example> 2513%</example>
2123% \fi 2514% \fi
2124% 2515%
2125% \section{Emendations and Conjectures}
2126% \label{sec:emendations-conjectures}
2127% From a technical standpoint, \enquote{conjectures} are readings that
2128% are not supported by manuscript evidence, but are instead proposed
2129% by scholars to be taken into consideration for establishing the
2130% edition text. A conjecture is called an \enquote{emendation} if it
2131% is adopted in place of what is provided by or missing from the text
2132% provided by the manuscripts. Emendations and conjectures are
2133% therefore readings and as such expected to be found within |<lem>|
2134% or |<rdg>| elements. However, as both come from editions or
2135% scholars, not from manuscripts, they are naturally associated with
2136% |source| or |resp| attributes as described above
2137% \vpagerefrange{ref:lem-source}{ref:lem-resp},\footnote{See also
2138% \vpagerefrange{ref:declare-source}{ref:declare-scholar}.} and can be
2139% distinguished from one another by the |type| attribute, eg.\ either
2140% |emendation| or |conjecture|.
2141%
2142% As an example, the representation of witnesses, editors and
2143% shorthands of Hippocrates' \emph{Epidemics}, Book~2 could be
2144% summarized as follows:---
2145%
2146% \iffalse
2147%<*example>
2148% \fi
2149\begin{minted}{latex}
2150% Witnesses:
2151\DeclareWitness{V}{V}{\emph{Vaticanus Gr.} 276}
2152\DeclareWitness{I}{I}{\emph{Parisinus Gr.} 2140}
2153\DeclareHand{Iac}{I}{I\textsuperscript{ac}}[Lectio ante correctionem]
2154\DeclareHand{Ipc}{I}{I\textsuperscript{pc}}[Lectio post correctionem]
2155\DeclareWitness{R}{R}{\emph{Vaticanus Gr.} 277}
2156\DeclareWitness{H}{H}{\emph{Parisinus Gr.} 2142}
2157% Sources (the first arguments below must refer to biblatex labels and
2158% an xml bibliographical database must be supplied):
2159\DeclareSource{Lit}{Littré}
2160\DeclareSource{Erm}{Ermerins}
2161\DeclareSource{Sm}{Smith}
2162% Persons:
2163\DeclareScholar{ego}{ego}[
2164 forename=Robert,
2165 surname=Alessi]
2166% Useful shorthands:
2167\DeclareShorthand{codd}{codd.}{V,I,R,H}
2168\DeclareShorthand{edd}{edd.}{Lit,Erm,Sm}
2169\DeclareShorthand{egoscr}{\emph{scripsi}}{ego}
2170\end{minted}
2171% \iffalse
2172%</example>
2173% \fi
2174%
2175% As can be seen from lines~18--20, three useful shorthands have been
2176% defined: |codd| prints \enquote{codd.} for Latin pl.\ \emph{codices}
2177% viz.\ \enquote{all manuscripts} and refers to the three \texttt{xml}
2178% identifiers |V|, |I|, |R| and |H| declared at ll.~2--3 and 6--7;
2179% |edd| prints \enquote{edd.} for Latin pl.\ \emph{editores} viz.\
2180% \enquote{all editors} and refers to the three \texttt{xml}
2181% identifiers |Lit|, |Erm| and |Sm| declared at
2182% ll.~10--12;\footnote{For detailed information on how to use
2183% \cs{DeclareSource} and insert references to cited works, the reader
2184% is invited to refer to \vref{sec:references-cited-works}.} finally,
2185% |egoscr| (l.~20) is used to print the technical Latin term
2186% \enquote{\emph{scripsi}}, \enquote{I wrote}, to denote a personal
2187% conjecture. Then, the |.tex| source file can be structured as
2188% follows:---
2189%
2190% \iffalse
2191%<*example>
2192% \fi
2193\begin{minted}{latex}
2194\begin{ekdosis}
2195 καὶ ἐγίνετο μᾶλλον \app{
2196 \lem[wit={V, Ipc,R,H}]{νότῳ}
2197 \rdg[wit=Iac]{νότου}
2198 \rdg[source=Erm, type=conjecture]{ἐν νώτῳ}}· [...] % conjecture
2199
2200 εἰ
2201 \app{
2202 \lem[resp=egoscr, type=emendation]{μὲν} % emendation
2203 \rdg[wit=codd, source=edd]{μὴ}
2204 } εἴη διὰ ταῦτα [...]
2205\end{ekdosis}
2206\end{minted}
2207% \iffalse
2208%</example>
2209% \fi
2210%
2211% \begin{remarks}
2212% \item Line~5 introduces a \emph{conjecture} which has been annotated
2213% with |type=conjecture| to facilitate its identification. Other
2214% optional arguments could have been used, such as
2215% |prewit=|\texttt{coni.} or |prewit=|\texttt{falso coni.}, to print
2216% explanatory words in the apparatus criticus before the abridged
2217% name of the scholar.
2218% \item Conversely, line~9 introduces an \emph{emendation} for which
2219% the shorthand |egoscr| has been used to print the exact term
2220% \emph{scripsi} in the apparatus criticus while keeping |ego| as an
2221% |xml:id| for the \texttt{TEI xml} ouput file. Other strategies
2222% could have been used. For example, one could have defined a
2223% specific shorthand to print nothing in place of |ego| and leave
2224% the insertion of technical terms to the |post| optional argument
2225% of \cs{lem}, like so:---
2226% \iffalse
2227%<*example>
2228% \fi
2229\begin{minted}[linenos=false]{latex}
2230% Preamble:
2231% (\unskip is for removing the space left by the empty 2nd argument
2232% below.)
2233\DeclareShorthand{egomute}{\unskip}{ego}
2234
2235% Document:
2236 \app{
2237 \lem[resp=egomute, post=\emph{scripsi}, type=emendation]{μὲν}
2238 \rdg[wit=codd, source=edd]{μὴ}
2239 } εἴη διὰ ταῦτα [...]
2240\end{minted}
2241% \iffalse
2242%</example>
2243% \fi
2244% \end{remarks}
2245%
2246% PDF output:---
2247% \medskip
2248%
2249% \needspace{7\baselineskip}
2250% \resetlinenumber
2251% \begin{alignment}[flush,tcols=1,texts=specimen,apparatus=specimen]
2252% \begin{specimen}
2253% \begin{ancientgreek}
2254% καὶ ἐγίνετο μᾶλλον \app{
2255% \lem[wit={hV, hIpc,hR,hH}]{νότῳ}
2256% \rdg[wit=hIac]{νότου}
2257% \rdg[source=Erm, type=conjecture]{ἐν νώτῳ}}· [...]
2258%
2259% εἰ \app{
2260% \lem[resp=hegoscr, type=emendation]{μὲν}
2261% \rdg[wit=hcodd, source=hedd]{μὴ}
2262% } εἴη διὰ ταῦτα [...]
2263% \end{ancientgreek}
2264% \end{specimen}
2265% \end{alignment}
2266%
2267% \texttt{TEI xml} output:---
2268%
2269% \iffalse
2270%<*example>
2271% \fi
2272\begin{minted}[linenos=false]{xml}
2273<p xml:lang="grc">καὶ ἐγίνετο μᾶλλον
2274<app>
2275 <lem wit="#V #Ipc #R #H">νότῳ</lem>
2276 <rdg wit="#Iac">νότου</rdg>
2277 <rdg source="#Erm" type="conjecture">ἐν νώτῳ</rdg>
2278</app>· [...]</p>
2279<p>εἰ
2280<app>
2281 <lem resp="#ego" type="emendation">μὲν</lem>
2282 <rdg wit="#V #I #R #H" source="#Lit #Erm #Sm">
2283 μὴ</rdg>
2284</app>εἴη διὰ ταῦτα [...]</p>
2285\end{minted}
2286% \iffalse
2287%</example>
2288% \fi
2289%
2290% \subsection{Editorial Addition and Deletion}
2291% \label{sec:editorial-add-del}
2292% \pkg{ekdosis} provides a set of commands to indicate that text has
2293% been supplied or removed by conjecture. As regards critical
2294% symbols conventionally used for representing emendations, lacunae,
2295% omissions, gaps, editorial deletions or additions and the like,
2296% \pkg{ekdosis} follows the standards as described by
2297% \textcite[80--82]{West1973}:---
2298% \begin{description}[font=\ttfamily]
2299% \item[<>] text added by conjecture or from a parallel source.
2300% \item[***] lacuna in the whole textual tradition.
2301% \item[<***>] conjectured lacuna.
2302% \item[\{\}] editorial deletion.
2303% \item[\dag\dag] text juged by the editor to be corrupt. Note that if
2304% only one word is suspect, only one crux is needed.
2305% \end{description}
2306%
2307% \DescribeMacro{\SetCritSymbols}\newfeature[v1.1]
2308% \cs{SetCritSymbols}\marg{csv list of options} can be used to change
2309% the critical symbols described above. This command accepts the
2310% following list of |key-value|
2311% optional arguments:---\\
2312% \DescribeOption{suppbegin}|suppbegin|$=$\meta{symbol}
2313% \hfill\tcboxverb{Default: <}\\
2314% The opening symbol used to mark the text that is supplied.\\
2315% \DescribeOption{suppend}|suppend|$=$\meta{symbol}
2316% \hfill\tcboxverb{Default: >}\\
2317% The closing symbol used to mark the text that is supplied.\\
2318% \DescribeOption{delbegin}|delbegin|$=$\meta{symbol}
2319% \hfill\tcboxverb|Default: {|\\
2320% The opening symbol used to mark the text that is deleted.\\
2321% \DescribeOption{delend}|delend|$=$\meta{symbol}
2322% \hfill\tcboxverb|Default: }|\\
2323% The closing symbol used to mark the text that is deleted.\\
2324% \DescribeOption{sicbegin}|sicbegin|$=$\meta{symbol}
2325% \hfill\tcboxverb{Default: †}\\
2326% The opening symbol used to mark the text that is deemed to be
2327% suspect.\\
2328% \DescribeOption{sicend}|sicend|$=$\meta{symbol}
2329% \hfill\tcboxverb{Default: †}\\
2330% The closing symbol used to mark the text that is deemed to be
2331% suspect.\\
2332% \DescribeOption{gapmark}|gapmark|$=$\meta{symbols}
2333% \hfill\tcboxverb{Default: ***}\\
2334% The symbols used to mark lacunae.\\
2335%
2336% As an example, what follows sets |[]| for deletions and |...| for
2337% lacunae:---
2338%
2339% \iffalse
2340%<*example>
2341% \fi
2342\begin{minted}[linenos=false]{latex}
2343\SetCritSymbols{
2344 delbegin = [,
2345 delend = ],
2346 gapmark = \dots
2347}
2348\end{minted}
2349% \iffalse
2350%</example>
2351% \fi
2352%
2353% \danger If modified, brackets can be adapted to languages that are
2354% written from right to left. To that effect, \pkg{ekdosis} provides a
2355% boolean expression |al@rlmode| which is evaluated as |true| if the
2356% writing direction is set from right to left and as |false|
2357% otherwise. As the \pkg{etoolbox} package is loaded by \pkg{ekdosis},
2358% \cs{ifboolean}|{al@rlmode}|\marg{rtl symbol}\marg{ltr symbol} can be
2359% used to perform the test.
2360%
2361% \paragraph{Editorial Addition}
2362% \DescribeMacro{\supplied}\newfeature[v1.1]\cs{supplied}\marg{text}
2363% is used to mark \meta{text} that is by definition missing from the
2364% tradition as supplied by the editor or some other scholar. This
2365% command is normally expected in \cs{lem}|{}| or \cs{rdg}|{}|.
2366%
2367% \paragraph{Editorial Deletion}
2368% \DescribeMacro{\surplus}\newfeature[v1.1] \cs{surplus}\marg{text}
2369% is used to mark \meta{text} that is deemed to be inauthentic, but
2370% nevertheless retained between braces in the edition text as it is
2371% transmitted by all witnesses. This command is normally expected in
2372% \cs{lem}|{}| or \cs{rdg}|{}|.
2373%
2374% \paragraph{Crux}
2375% \DescribeMacro{\sic}\newfeature[v1.1] \cs{sic}\marg{text} takes as
2376% mandatory argument the text deemed by the editor to be readable but
2377% not understandable. \cs{sic} inserts \meta{text} between cruces
2378% while \cs{sic*} prints only one crux before \meta{text}.
2379%
2380% \paragraph{Lacuna}
2381% \DescribeMacro{\gap}\newfeature[v1.1] \cs{gap}\marg{csv list of
2382% options} indicates that some amount of text has fallen away from the
2383% entire tradition. It takes as mandatory argument a comma-separated
2384% list of options that can be used to further specify the reason for
2385% omission, the unit of measurement, the quantity or the extent, as
2386% follows:---\\
2387% \DescribeOption{reason}|reason|$=$\meta{reason}\\
2388% |reason| gives the reason for omission.\\
2389% \DescribeOption{unit} |unit|$=$\meta{unit}\\
2390% |unit| provides some regularized measurement, such as |character|,
2391% |word|, |line| and the like.
2392% \DescribeOption{quantity} |quantity|$=$\meta{n}\\
2393% |quantity| specifies the number of the given unit that comprise the
2394% measurement.\\
2395% \DescribeOption{extent} |extent|$=$\meta{description}\\
2396% |extent| describes the size, including quantity and unit in a single
2397% string of words.
2398%
2399% \paragraph{Conjectured Lacuna}
2400% Assumably, the conjectured lacuna should be enclosed by
2401% \cs{supplied} and as such contained by \cs{lem} with
2402% |type=emendation| to indicate that the lacuna has been accepted by
2403% the editor.
2404%
2405% Examples follow:---
2406%
2407% \iffalse
2408%<*example>
2409% \fi
2410\begin{minted}{latex}
2411% Preamble:
2412\DeclareShorthand{egomute}{\unskip}{ego}
2413
2414% Document:
2415\begin{ekdosis}
2416 σχεδὸν \app{
2417 \lem[resp=egomute, nosep, post={post σχεδὸν quattuor uerba
2418 excidisse uid.}, type=emendation]{\supplied{\gap{reason=lost,
2419 unit=word, quantity=4}}}
2420 } οὗτοι
2421
2422 subsidiis magnis \sic*{epicuri} constabilitas
2423
2424 declinare quis est qui \sic{possit cernere sese}.
2425
2426 \app{
2427 \lem[resp=egomute, type=emendation, nosep, post={ante
2428 ὑπογίν.}]{\surplus{καὶ}}
2429 \note{deleui e Gal.P}
2430 } ὑπογίνονται
2431
2432 Πάντων δὲ \app{
2433 \lem[resp=egomute, type=emendation, post={addidi (\arb{^gamI`a
2434 'l-.hummayAti} Gal.)}]{\supplied{τῶν πυρετῶν}}
2435 \rdg[nordg, source=Gal]{\arb{^gamI`a 'l-.hummayAti}}
2436 \rdg[wit=codd, source=edd, alt=om.]{}
2437 },
2438\end{ekdosis}
2439\end{minted}
2440% \iffalse
2441%</example>
2442% \fi
2443%
2444% PDF output:---
2445% \medskip
2446% \needspace{7\baselineskip}
2447% \resetlinenumber
2448% \begin{alignment}[flush,tcols=1,texts=specimen,apparatus=specimen]
2449% \begin{specimen}
2450% σχεδὸν \app{
2451% \lem[resp=egomute, nosep, post={post σχεδὸν quattuor uerba
2452% excidisse uid.}, type=emendation]{\supplied{\gap{reason=lost,
2453% unit=word, quantity=4}}}
2454% } οὗτοι
2455%
2456% subsidiis magnis \sic*{epicuri} constabilitas
2457%
2458% declinare quis est qui \sic{possit cernere sese}.
2459%
2460% \app{
2461% \lem[resp=egomute, type=emendation, nosep, post={ante
2462% ὑπογίν.}]{\surplus{καὶ}}
2463% \note{deleui e Gal.P}
2464% } ὑπογίνονται
2465%
2466%
2467% Πάντων δὲ \app{
2468% \lem[resp=egomute, type=emendation, post={addidi (\arb{^gamI`a
2469% 'l-.hummayAti} Gal.)}]{\supplied{τῶν πυρετῶν}}
2470% \rdg[nordg, source=Gal]{\arb{^gamI`a 'l-.hummayAti}}
2471% \rdg[wit=hcodd, source=hedd, alt=om.]{}
2472% },
2473% \end{specimen}
2474% \end{alignment}
2475%
2476% \texttt{TEI xml} ouput:---
2477%
2478% \iffalse
2479%<*example>
2480% \fi
2481\begin{minted}[linenos=false]{xml}
2482<p>σχεδὸν
2483<app>
2484 <lem resp="#ego" type="emendation">
2485 <supplied>
2486 <gap reason="lost" unit="word" quantity="4" />
2487 </supplied>
2488 </lem>
2489</app>οὗτοι</p>
2490<p>subsidiis magnis
2491<sic>epicuri</sic> constabilitas</p>
2492<p>declinare quis est qui
2493<sic>possit cernere sese</sic>.</p>
2494<p>
2495<app>
2496 <lem resp="#ego" type="emendation">
2497 <surplus>καὶ</surplus>
2498 </lem>
2499 <note>deleui e Gal.P</note>
2500</app>ὑπογίνονται</p>
2501<p>Πάντων δὲ
2502<app>
2503 <lem resp="#ego" type="emendation">
2504 <supplied>τῶν πυρετῶν</supplied>
2505 </lem>
2506 <rdg source="#Gal">
2507 <foreign xml:lang="ar-Latn" type="transliterated"
2508 subtype="arabtex">^gamI`a 'l-.hummayAti</foreign>
2509 </rdg>
2510 <rdg wit="#V #I #R #H" source="#Lit #Erm #Sm" />
2511</app>,</p>
2512\end{minted}
2513% \iffalse
2514%</example>
2515% \fi
2516%
2517% \section{Laying Out the Apparatus Criticus } 2516% \section{Laying Out the Apparatus Criticus }
2518% \label{sec:apparatus-layout} 2517% \label{sec:apparatus-layout}
2519% 2518%
@@ -5555,7 +5554,6 @@ Sample text with a \textcolor{red}{word} in red.
5555% \RequirePackage{expkv-def} % already loaded above 5554% \RequirePackage{expkv-def} % already loaded above
5556\RequirePackage{luacode} 5555\RequirePackage{luacode}
5557\RequirePackage{paracol} 5556\RequirePackage{paracol}
5558\RequirePackage{xparse}
5559\RequirePackage{etoolbox} 5557\RequirePackage{etoolbox}
5560\RequirePackage{lineno} 5558\RequirePackage{lineno}
5561\RequirePackage{keyfloat} 5559\RequirePackage{keyfloat}
@@ -5563,7 +5561,6 @@ Sample text with a \textcolor{red}{word} in red.
5563\RequirePackage{zref-user} 5561\RequirePackage{zref-user}
5564\RequirePackage{zref-abspage} 5562\RequirePackage{zref-abspage}
5565\RequirePackage{ltxcmds} 5563\RequirePackage{ltxcmds}
5566\RequirePackage{atbegshi}
5567\RequirePackage{ifoddpage} 5564\RequirePackage{ifoddpage}
5568\if@pkg@parnotes 5565\if@pkg@parnotes
5569 \RequirePackage{parnotes} 5566 \RequirePackage{parnotes}
generated by cgit v1.2.3 (git 2.25.1) at 2024-05-05 00:57:51 +0000