diff options
Diffstat (limited to 'ekdosis.dtx')
-rw-r--r-- | ekdosis.dtx | 797 |
1 files changed, 397 insertions, 400 deletions
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} |