% \iffalse meta-comment % % eledmac.dtx % Author: Peter Wilson (Herries Press) herries dot press at earthlink dot net % Maintainer:Maïeul Rouquette maieul at maieul dot net % Copyright 2003 -- 2005 Peter R. Wilson / 2011-.. Maïeul Rouquette % % This work may be distributed and/or modified under the % conditions of the LaTeX Project Public License, either % version 1.3 of this license or (at your option) any % later version. % The latest version of the license is in % http://www.latex-project.org/lppl.txt % and version 1.3 or later is part of all distributions of % LaTeX version 2003/06/01 or later. % % This work has the LPPL maintenance status "maintained". % % This work consists of the files listed in the README file. % % %<*driver> \documentclass[twoside]{ltxdoc} \usepackage{url} \usepackage[draft=false, plainpages=false, pdfpagelabels, bookmarksnumbered, % hyperindex=true hyperindex=false ]{hyperref} \usepackage{fontspec} \usepackage[english]{babel} \usepackage{graphicx,eledmac,metalogo} % Index and Changelog in one column \makeatletter \renewenvironment{theglossary}{% \@restonecoltrue\if@twocolumn\@restonecolfalse\fi \columnseprule \z@ \columnsep 35\p@ \glossary@prologue% \GlossaryParms \let\item\@idxitem \ignorespaces} {\if@restonecol\onecolumn\else\clearpage\fi} \def\theindex{\@restonecoltrue\if@twocolumn\@restonecolfalse\fi \columnseprule \z@ \columnsep 35\p@ \index@prologue% \IndexParms \let\item\@idxitem \ignorespaces} \def\endtheindex{\if@restonecol\onecolumn\else\clearpage\fi} \@mparswitchfalse \makeatother \EnableCrossrefs \RecordChanges \CodelineIndex %%\OnlyDescription \renewcommand{\MakeUppercase}[1]{#1} \pagestyle{headings} \setcounter{StandardModuleDepth}{1} \begin{document} \raggedbottom \DocInput{eledmac.dtx} \end{document} % % % \fi % % \newcommand{\reff}[1]{\ref{#1} p.~\pageref{#1}} % \CheckSum{11990} % % \makeatletter % \newcommand*{\DescribeIt}{\leavevmode\@bsphack\begingroup\MakePrivateLetters % \Describe@It} % \newcommand*{\Describe@It}[1]{\endgroup % \marginpar{\raggedleft\PrintDescribeEnv{#1}}% % \SpecialItIndex{#1}\@esphack\ignorespaces} % \newcommand*{\SpecialItIndex}[1]{\@bsphack % \index{#1\actualchar{\protect\ttfamily#1}\encapchar usage}\@esphack} % % \DoNotIndex{\@,\@@par,\@beginparpenalty,\@empty} % \DoNotIndex{\@flushglue,\@input} % \DoNotIndex{\@makefnmark,\@makeother,\@maketitle} % \DoNotIndex{\@namedef,\@ne,\@spaces,\@tempa} % \DoNotIndex{\@tempb,\@tempswafalse,\@tempswatrue} % \DoNotIndex{\@thanks,\@thefnmark,\@topnum} % \DoNotIndex{\@@,\@elt,\@forloop,\@fortmp,\@gtempa,\@totalleftmargin} % \DoNotIndex{\",\/,\@ifundefined,\@nil,\@verbatim,\@vobeyspaces} % \DoNotIndex{\|,\~,\ ,\active,\advance,\aftergroup,\begingroup,\bgroup} % \DoNotIndex{\mathcal,\csname,\def,\documentstyle,\dospecials,\edef} % \DoNotIndex{\egroup} % \DoNotIndex{\else,\endcsname,\endgroup,\endinput,\endtrivlist} % \DoNotIndex{\expandafter,\fi,\fnsymbol,\futurelet,\gdef,\global} % \DoNotIndex{\hbox,\hss,\if,\if@inlabel,\if@tempswa,\if@twocolumn} % \DoNotIndex{\ifcase} % \DoNotIndex{\ifcat,\iffalse,\ifx,\ignorespaces,\index,\input,\item} % \DoNotIndex{\jobname,\kern,\leavevmode,\leftskip,\let,\llap,\lower} % \DoNotIndex{\m@ne,\next,\newpage,\nobreak,\noexpand,\nonfrenchspacing} % \DoNotIndex{\obeylines,\or,\protect,\raggedleft,\rightskip,\rm,\sc} % \DoNotIndex{\setbox,\setcounter,\small,\space,\string,\strut} % \DoNotIndex{\strutbox} % \DoNotIndex{\thefootnote,\thispagestyle,\topmargin,\trivlist,\tt} % \DoNotIndex{\twocolumn,\typeout,\vss,\vtop,\xdef,\z@} % \DoNotIndex{\,,\@bsphack,\@esphack,\@noligs,\@vobeyspaces,\@xverbatim} % \DoNotIndex{\`,\catcode,\end,\escapechar,\frenchspacing,\glossary} % \DoNotIndex{\hangindent,\hfil,\hfill,\hskip,\hspace,\ht,\it,\langle} % \DoNotIndex{\leaders,\long,\makelabel,\marginpar,\markboth,\mathcode} % \DoNotIndex{\mathsurround,\mbox,\newcount,\newdimen,\newskip} % \DoNotIndex{\nopagebreak} % \DoNotIndex{\parfillskip,\parindent,\parskip,\penalty,\raise,\rangle} % \DoNotIndex{\section,\setlength,\TeX,\topsep,\underline,\unskip,\verb} % \DoNotIndex{\vskip,\vspace,\widetilde,\\,\%,\@date,\@defpar} % \DoNotIndex{\[,\{,\},\]} % \DoNotIndex{\count@,\ifnum,\loop,\today,\uppercase,\uccode} % \DoNotIndex{\baselineskip,\begin,\tw@} % \DoNotIndex{\a,\b,\c,\d,\e,\f,\g,\h,\i,\j,\k,\l,\m,\n,\o,\p,\q} % \DoNotIndex{\r,\s,\t,\u,\v,\w,\x,\y,\z,\A,\B,\C,\D,\E,\F,\G,\H} % \DoNotIndex{\I,\J,\K,\L,\M,\N,\O,\P,\Q,\R,\S,\T,\U,\V,\W,\X,\Y,\Z} % \DoNotIndex{\1,\2,\3,\4,\5,\6,\7,\8,\9,\0} % \DoNotIndex{\!,\#,\$,\&,\',\(,\),\+,\.,\:,\;,\<,\=,\>,\?,\_} % \DoNotIndex{\discretionary,\immediate,\makeatletter,\makeatother} % \DoNotIndex{\meaning,\newenvironment,\par,\relax,\renewenvironment} % \DoNotIndex{\repeat,\scriptsize,\selectfont,\the,\undefined} % \DoNotIndex{\arabic,\do,\makeindex,\null,\number,\show,\write,\@ehc} % \DoNotIndex{\@author,\@ehc,\@ifstar,\@sanitize,\@title,\everypar} % \DoNotIndex{\if@minipage,\if@restonecol,\ifeof,\ifmmode} % \DoNotIndex{\lccode,\newtoks,\onecolumn,\openin,\p@,\SelfDocumenting} % \DoNotIndex{\settowidth,\@resetonecoltrue,\@resetonecolfalse,\bf} % \DoNotIndex{\clearpage,\closein,\lowercase,\@inlabelfalse} % \DoNotIndex{\selectfont,\mathcode,\newmathalphabet,\rmdefault} % \DoNotIndex{\bfdefault} % \DoNotIndex{\newcommand,\renewcommand,\providecommand} % \DoNotIndex{\ ,\to,\hsize,\multiply,\textit} % % \newcommand{\dtxfilename}{\texttt{eledmac.dtx}} % \GetFileInfo{eledmac.sty} % ^^A To put the changes in the right order : see http://tex.stackexchange.com/a/74113/7712 %\makeatletter % \let\org@changes@\changes@ % \def\my@changes v#1.#2.#3\@nil{% % \org@changes@{v#1.\six@digits{#2}.#3=v#1.#2.#3}% % }% % \newcommand*{\six@digits}[1]{% % \ifnum#1<100000 0\fi % \ifnum#1<10000 0\fi % \ifnum#1<1000 0\fi % \ifnum#1<100 0\fi % \two@digits{#1}% % }% % \renewcommand*{\changes@}[1]{% % \my@changes#1.\@nil % }% %\makeatother % \newcommand{\Lpack}[1]{\textsf{#1}} % \newcommand{\Lclass}[1]{\textsf{#1}} % \newcommand{\file}[1]{\texttt{#1}} % \newcommand{\Eledpar}{\Lpack{eledpar}} % \newcommand{\eledmac}{eledmac} % \newcommand{\Eledmac}{\Lpack{\eledmac}} % \newcommand{\edmac}{\texttt{EDMAC}} % \newcommand{\tabmac}{\texttt{TABMAC}} % \newcommand{\edstanza}{\texttt{EDSTANZA}} % \newcommand{\texbook}{\textit{TeXbook}} % \newcommand{\thetexbook}{\textit{The TeXbook}} % % \changes{v0.1.0}{2003/03/25}{First public release} % \changes{v0.2.0}{2003/08/16}{Added tabmac code, and extended indexing} % \changes{v0.2.1}{2003/09/13}{Bug fixes and match with mempatch v1.8} % \changes{v0.2.2}{2003/11/09}{Improved paragraph footnotes} % \changes{v0.2.2}{2003/11/09}{New Dekker example} % \changes{v0.3.0}{2004/02/14}{Includes edstanza and more} % \changes{v0.3.1}{2004/02/18}{Not released. Added remarks about the parallel package} % \changes{v0.4.0}{2004/02/29}{Added minipage, etc., support} % \changes{v0.4.1}{2004/03/28}{Not released. Minor editorial improvements and code tweaks} % \changes{v0.5.0}{2004/04/04}{Added sidenotes, familiar footnotes in numbered text} % \changes{v0.5.1}{2004/04/10}{Fixed right line numbers killed in v0.5} % \changes{v0.6.0}{2004/11/16}{Fixed long paragraphs looping} % \changes{v0.6.0}{2004/11/16}{Prepared for eledpar package} % \changes{v0.6.0}{2004/12/10}{Fixed minor typos} % \changes{v0.7.0}{2005/02/18}{Tidying up for eledpar and ledarab packages} % \changes{v0.7.0}{2005/02/18}{Replaced all \cs{interAfootnotelinepenalty}, etc., % by just \cs{interfootnotelinepenalty}} % \changes{v0.7.0}{2005/03/02}{eledmac having been available for 2 years, % deleted the commented out original edmac texts} % \changes{v0.7.0}{2011/06/17}{Ma\"ieul Rouquette new maintainer} % \changes{v0.8.0}{2011/17/06}{Bug on endnotes fixed: in a // text, all endnotes will print and be placed at the ends of columns (!)} % \changes{v0.8.1}{2011/07/14}{Bug on \cs{edtext} ; \cs{critex} ; \cs{lemma} fixed: we can now us non-switching commands} % \changes{v0.9.0}{2011/08/03}{No more ledpatch. All patches are now in the main file.} % \changes{v0.9.1}{2011/08/08}{Fix some bugs linked to integrating ledpatch on the main file.} % \changes{v0.10.0}{2011/08/22}{Corrections to \cs{section} and other titles in numbered sections} % \changes{v0.11.0}{2011/09/16}{Makes it possible to add a symbol on each verse's hanging, as in French typography. Redefines the command \cs{hangingsymbol} to define the character.} % \changes{v0.12.0}{2011/10/01}{Possibility to number the pstart with the commands \cs{numberpstarttrue}.} % \changes{v0.12.0}{2011/10/01}{For compatibility with eledpar, possibility to use \cs{autopar} on the right side.} % \changes{v0.12.1}{2011/10/02}{The numbering of \cs{pstarts} restarts on each \cs{beginnumbering}.} % \changes{v0.12.1}{2011/10/02}{Don't number \cs{pstarts} of stanza.} % \changes{v0.13.0}{2011/11/08}{New stanzaindentsrepetition counter: to repeat stanza indents every \emph{n} verses.} % \changes{v0.13.1}{2011/11/18}{\cs{thepstartL} and \cs{thepstartR} use now \cs{bfseries} and not \cs{bf}, which is deprecated and makes conflicts with memoir class.} % \changes{v0.14.0}{2012/04/04}{Tweaked \cs{edlabel} to get correct line number if the command is first element of a paragraph.} % \changes{v1.0.0}{2012/09/15}{Some compatibility break with eledmac. Change of name: eledmac.} % \changes{v1.1.0}{2012/09/25}{New package option: parapparatus.} % \changes{v1.4.0}{2012/11/16}{Compatibility with LuaTeX of RTL notes.} % \changes{v1.4.2}{2012/12/12}{Debug with some special classes.} % \changes{v1.4.3}{2012/12/18}{Spurious space after familiar footnotes.} % \changes{v1.4.4}{2013/02/18}{Label inside familiar footnotes.} % \changes{v1.4.5}{2013/03/02}{Bug with komasscript + eledpar + chapter.} % \changes{v1.4.6}{2013/04/15}{Bug with memoir class introduced by 1.4.5.} % \changes{v1.4.8}{2013/07/02}{Corrects a bug with parallel texts introduced by 1.1.} % \changes{v1.6.1}{2013/10/27}{Corrects a false hanging verse when a verse is exactly the length of a line.} % \changes{v1.4.0}{2012/11/16}{Compatibility with LuaTeX of RTL notes.} % \changes{v1.8.0}{2013/12/13}{Compatibility with parledgroup option of eledpar package.} % \changes{v1.8.2}{2014/01/31}{Debug compatibility problem with hebrew option of babel package.} % \changes{v1.8.3}{2014/02/03}{Fixes spurious spaces added by v1.7.0.} % \changes{v1.10.0}{2014/02/27}{Add \cs{pstartref} and \cs{xpstartref} to refer to a pstart number (extension of \cs{edlabel}).} % \changes{v1.10.1}{2014/02/28}{Compatibility with \textsf{cleveref}.} % \changes{v1.10.2}{2014/03/17}{Compatibility of stanza with v1.8a of babel-greek.} % \changes{v1.10.3}{2014/04/07}{Debug of cross-referencing.} % \changes{v1.10.4}{2014/04/09}{Debug of critical notes in edtabular environnment.} % \changes{v1.10.5}{2014/04/14}{Debug of \cs{xxref}.} % \changes{v1.10.5}{2014/04/14}{Debug of \cs{pausenumbering}.} % \changes{v1.10.6}{2014/05/01}{Debug of interaction between \cs{autopar} and\cs{pausenumbering}.} % \changes{v1.11.1}{2014/05/29}{Correct a bug when a critical note starts with plus or minus.} % \changes{v1.12.0}{2014/08/05}{Compatibility with \Lpack{musixtex}.} % \changes{v1.12.0}{2014/08/05}{Debug eledmac sectioning command after using \cs{resumenumbering}.} % \changes{v1.12.3}{2014/08/15}{Underline lemma in \cs{eledxxx} when using draft mode.} % \changes{v1.12.3}{2014/08/15}{Correct bug with side and familiar notes in tabular environments.} % \changes{v1.12.3}{2014/08/15}{Debug left and right notes (bugs added by 1.12.0)} % \changes{v1.12.3}{2014/08/15}{Debug \cs{eledxxx} with some paper size} % \changes{v1.12.4}{2014/08/25}{Debug spurious page breaks before \cs{chapter} (bug added in 1.12.0)} % \changes{v1.13.1}{2014/09/25}{Debug quotation environment inside of a \cs{pstart} preceded by a sectioning command.} % \changes{v1.13.1}{2014/09/25}{Coming back of page and line breaking penalties's management, deleted by error in v0.17.} % \changes{v1.13.2}{2014/09/30}{Fix bug with normal footnotes, added by v1.13.0.} % \changes{v1.13.3}{2014/10/04}{Fix extra spaces with paragraphed footnotes, added by v1.13.0.} % \changes{v1.13.4}{2014/10/20}{Fix bug with index when memoir class is used without hyperref} % \changes{v1.15.0}{2015/01/12}{Fix bug with footnotes layout when using some options of the geometry package (bug add by v1.13.0).} % \changes{v1.16.0}{2015/01/23}{Compatibility of standard footnotes with some biblatex styles.} % \changes{v1.16.0}{2015/01/23}{New \cs{stanzaindent} command.} % \changes{v1.18.0}{2015/02/23}{Compatibility with \LuaLaTeX\ RTL languages.} % \changes{v1.19.0}{2015/03/06}{\cs{maxhXnotes} and \cs{maxhnotesX} work now for both two-columns and three-columns setting.} % \changes{v1.19.0}{2015/03/06}{Compatibility with \Lpack{eledpar} v.1.13.0.} % \changes{v1.19.1}{2015/03/12}{Call \cs{correct@footinsX@box} and \cs{correct@Xfootins@box} directly in \cs{print@notesX@forpages} and \cs{print@Xnotes@forpages}, that is in \Lpack{eledpar}.} % \changes{v1.20.0}{2015/03/22}{Correct \cs{inplaceofnumber} hook.} % \changes{v1.20.0}{2015/03/22}{Add series option.} % \changes{v1.20.0}{2015/03/22}{Fix issues with RTL text in notes when using \LuaLaTeX.} % \changes{v1.20.0}{2015/03/22}{The \cs{newif}s are not followed by boolean values set to false, because it is the \TeX\ default setting.} % \changes{v1.20.0}{2015/03/22}{Explicit error message when calling \cs{Xfootnote} outside of \cs{edtext}.} % \changes{v1.20.0}{2015/03/22}{Fix bug with line number typesetting direction when using \cs{eledsection} and similar commands for RTL texts with \LuaLaTeX.} % \changes{v1.21.0}{2015/04/13}{\cs{AtEveryPstart} and \cs{AtEveryPend} are now compatible with \cs{autopar}} % \changes{v1.21.0}{2015/04/13}{Fix bug with space between columns with notes in two columns (bug added in v1.13.0).} % \changes{v1.21.0}{2015/04/13}{Add nocritical, noend, nofamiliar and noledgroup options.} % \changes{v1.21.0}{2015/04/13}{Fix bug with \cs{maxhnotesX} when using \cs{foottwocolX} or \cs{footthreecolX}.} % \changes{v1.21.0}{2015/04/13}{Add \cs{twolinesbutnotmore} and \cs{twolinesonlyinsamepage}.} % \changes{v1.21.0}{2015/04/13}{Fix bug when a \cs{Xfootnote} follows a \cs{Xendnote} in the second argument of \cs{edtext} (bug added in eledmac 1.0.0 !).} % \changes{v1.21.0}{2015/04/13}{Add noeledsec package option} % \changes{v1.21.0}{2015/04/13}{parapparatus option works now with familiar footnotes.} % \changes{v1.21.0}{2015/04/13}{Add \cs{beforenotesX} and \cs{beforeXnotes} features for notes set in two and three column.} % \changes{v1.21.0}{2015/04/13}{Debug \cs{beforenotesX} \cs{maxhnotesX} \cs{notesXwidthliketwocolumns} and \cs{afterruleX} with footnotes set in two and three columns.} % \changes{v1.21.0}{2015/04/13}{\cs{afterXrule} and \cs{afterruleX} features no longer create problems of overflowing at the bottom of the page.} % \changes{v1.21.0}{2015/04/13}{\cs{preXnotes} and \cs{prenotesX} features no longer create problems of overflowing at the bottom of the page.} % \changes{v1.21.0}{2015/04/13}{Fix spurious space after first page number in \cs{doendnotes}. oldprintnpnumspace option allows to come back to previous setting} % \changes{v1.21.0}{2015/04/13}{\cs{chapter} inside optional argument of \cs{pstart} works when typesetting parallel pages} % \changes{v1.22.0}{2015/04/25}{When using hyperref package, internal links in index or with \cs{edlineref} are now targeted to the top and not longer to the bottom of the lines they refer to.} % \changes{v1.22.0}{2015/04/25}{Provides support for xindy.} % \changes{v1.22.0}{2015/04/25}{Adds hyperlink for references to notes in indices.} % \changes{v1.22.0}{2015/04/25}{Fix conflict between noend package option and edtabularx environments} % \changes{v1.22.1}{2015/04/29}{Fix bug (added on v1.22.0) with \cs{inplaceofnumber} hook.} % \changes{v1.23.0}{2015/05/18}{Compatibility between nofamiliar/nocriticals option and minipage/ledgroup.} % \changes{v1.23.0}{2015/05/18}{Fix error of \cs{iftrue} not closed.} % \changes{v1.23.0}{2015/05/18}{Allow use of \cs{sameword} with inputenc managing of UTF-8.} % \changes{v1.23.0}{2015/05/18}{Error message when using \cs{beginnumbering}…\cs{endnumbering} without \cs{pstart}.} % \changes{v1.23.0}{2015/05/18}{New tools to ensure the line-list file uses the right version of commands when upgrading the eledmac version.} % \changes{v1.23.0}{2015/05/18}{Fix bug with \cs{skipnumbering} called immediately after a \cs{pstart}.} % \changes{v1.23.0}{2015/05/18}{Fix spurious space with \cs{skipnumbering} (bug added on v1.21.0).} % \changes{v1.23.1}{2015/05/20}{Fix bug with \cs{lemma} command in the right side.} % \changes{v1.23.2}{2015/05/29}{Compatibility with \LaTeX's release 2015.} % \changes{v1.24.0}{2015/06/02}{We can reinitialize \cs{AtEveryPstart} and \cs{AtEveryPend} providing to it an empty argument.} % \changes{v1.24.1}{2015/06/21}{\cs{lemma} is disabled when using `nocritical` option.} % \changes{v1.24.2}{2015/06/26}{Fix incompatibility between `nofamiliar` option and `memoir` package.} % \changes{v1.24.3}{2015/07/07}{Restore marginal numbers and notes with sectioning command (bug introduced in v1.21.0)} % \changes{v1.24.4}{2015/07/14}{Fix spurious space with \cs{edindex} when using xindy+hyperref option.} % \changes{v1.24.5}{2015/07/16}{Fix bug of indent, when a added in 1.1.0, when a \cs{beginnumbering} immediately follow a sectioning command.} % \hyphenation{man-u-script man-u-scripts} % % % ^^A PW added following as the definitions are at some unknown elsewhere % \newcommand{\egstart}{} % \newcommand{\egmid}{} % \newcommand{\egend}{} % % \renewcommand{\egstart}{% % \par % \begingroup % \centering % \begin{minipage}{0.45\textwidth}} % \renewcommand{\egmid}{% % \end{minipage}\hfill\begin{minipage}{0.45\textwidth}} % \renewcommand{\egend}{% % \end{minipage}\par\endgroup} % % \title{\Lpack{\eledmac} \\ % Typeset scholarly editions with \LaTeX\thanks{This file (\dtxfilename) % has version number \fileversion, last revised \filedate.}} % % \author{% % Ma\"ieul Rouquette\thanks{\texttt{maieul at maieul dot net}} \\ % {\small based on the original \Lpack{ledmac} by} \\ % Peter Wilson \\ % Herries Press \\ % {\small which was based on the original \edmac, \tabmac{} and \edstanza{} by} \\ % John Lavagnino, Dominik Wujastyk, Herbert Breger and Wayne Sullivan. % } % % \date{} % % \iffalse This is a METACOMMENT % This METACOMMENT is part of the original EDMAC % Everything up to the next `\ fi' (without a blank) will % be ignored. This is necessary because `%' may no longer % be a comment mark when this file is read in. % % The original EDMAC was written by: % \author{John Lavagnino\thanks{% % Department of English and American Literature, % Brandeis University, % 415 South Street, % Waltham, MA 02254--9110, USA. % Internet: {\tt lav@binah.cc.brandeis.edu}, % Bitnet: {\tt lav@brandeis}.} % \and Dominik Wujastyk\thanks{% % Wellcome Institute for the History of Medicine, % 183 Euston Road, % London NW1 2BE, UK. % Internet: {\tt D.Wujastyk@ucl.ac.uk}, % Bitnet: {\tt dow@harvunxw}.}} % \date{} % % % Macro file `EDMAC' for use with Plain TeX. % Copyright (C) 1990, 1991, 1992, 1993, 1994 John Lavagnino and Dominik % Wujastyk, all rights reserved. % % Copying of this file is authorized only if either % (1) you make absolutely no changes to your copy, including name, or % (2) if you do make changes, you name it something other than % edmac.tex or edmac.doc % This restriction helps to ensure that the macro development is orderly. % % \fi % % \maketitle % % % \begin{abstract} % \edmac, a set of \PlainTeX\ macros, was made at the beginning of 90's % for typesetting critical editions in the traditional % way, i.e., similar to the Oxford Classical Texts, Teubner, Arden % Shakespeare and other series. A separate set of \PlainTeX\ macros, % \tabmac, provides for tabular material. Another set of \PlainTeX\ % macros, \edstanza, assists in typesetting verse. % % The \Eledmac{} package makes the % \edmac, \tabmac{} and \edstanza{} facilities available to authors % who would prefer % to use \LaTeX. The principal functions provided by the package % are marginal line numbering and multiple series of % foot- and endnotes keyed to line numbers. % % In addition to the \edmac, \tabmac{} and \edstanza{} functions the package % also provides for index entries keyed to both page and line numbers. % Multiple series of the familiar numbered footnotes are also available. % % Other \LaTeX\ packages for critical editions include EDNOTES, and % \Lpack{poemscol} for poetical works. % % \Lpack{eledmac} provides many tools and options. Normally, they are all documented in this file. % Also provided is a help folder, ``\href{examples/.}{examples}''. The folder contains additional examples (although not for all cases). % Example starting by ``1-'' are for basic uses, those starting by ``2-'' are for advanced uses. % % To report bugs or request a new feature, please go to ledmac GitHub page and click on ``New Issue'': \url{https://github.com/maieul/ledmac/issues/}. You must create an account on github.com to access my page (maieul/ledmac). GitHub accounts are free for open-source users. You can post messages in English or in French (preferred). % % You can subscribe to the eledmac mail list in:\\ \url{http://geekographie.maieul.net/146} % \end{abstract} % % \renewcommand{\numberline}[1]{#1~} % \tableofcontents % % % % \section{Introduction} % % The \edmac{} macros \cite{EDMACTUG} for typesetting critical editions of texts % have been available for use with TeX since 90's. Since \edmac{} % was introduced there has been a small but constant demand for a % version of \edmac{} that could be used with LaTeX. The \Lpack{eledmac} % package is an attempt to satisfy that request. % % % \Eledmac{} would not have been possible without the amazing work by % John Lavagnino\index{Lavagnino, John} % and Dominik Wujastyk\index{Wujastyk, Dominik}, % the original authors of \edmac. % I, Peter Wilson, am very grateful for their encouragement and permission to use % \edmac{} as a base. % The majority of both the code and this manual are by these two. % The tabular material is based on the % \tabmac{} code~\cite{TABMAC}, by permission of its author, % Herbert Breger\index{Breger, Herbert}. % The verse-related code is by courtesy of Wayne Sullivan, the author % of \edstanza~\cite{EDSTANZA}, who has kindly supplied more than % his original macros. % % Since 2011's Maïeul Rouquette begun to maintain and extend \eledmac{}. As plain \TeX{} is used by little people, and \LaTeX{} by more people \Eledmac{} and original \edmac{} are more and more distant. % % % % % \subsection{Overview} % % % The \Eledmac{} package, together with LaTeX, provides several % important facilities for formatting critical editions of texts in % a traditional manner. Major features include: % \begin{itemize}\addtolength{\itemsep}{-1ex} % \item automatic stepped line numbering, by page or by section; % \item sub-lineation within the main series of line numbers; % \item variant readings automatically keyed to line numbers; % \item caters for both prose and verse; % \item multiple series of the footnotes and endnotes; % \item block or columnar formatting of the footnotes; % \item simple tabular material may be line numbered; % \item indexing keyed to page and line numbers. % \end{itemize} % % % \Eledmac{} allows the scholar engaged in preparing a critical % edition to focus attention wholly on the task of creating the % critical text and evaluating the variant readings, text-critical % notes and testimonia. \LaTeX{} and \Eledmac{} will take care of % the formatting and visual correlation of all the disparate types % of information. % % % % % % The original \edmac{} can be used as a `stand alone' processor % or as part of a process. One example is its use as the formatting % engine or `back end' for the output of an automatic manuscript % collation program. \texttt{COLLATE}, written by % Peter\index{Robinson, Peter} Robinson, % runs on the Apple Macintosh, can collate simultaneously up to a % hundred manuscripts of any length, and provides facilities for % the scholar to tailor the collation interactively. For further % details of this and other related work, visit the \edmac{} home page % at \url{http://www.homepages.ucl.ac.uk/~ucgadkw/edmac/index.html}. % % Apart from \Eledmac{} there are some other \LaTeX\ packages for % critical edition typesetting. As Peter Wilson is not an author, or even a % prospective one, of any critical % edition work he could not provide any opinions on what authors in this % area might feel comfortable with or how well any of the packages % meet their needs. % % \texttt{EDNOTES}~\cite{EDNOTES}, by Uwe L\"{u}ck\index{L\"uck, Uwe} and % Christian Tapp\index{Tapp, Christian}, is another % \LaTeX\ package being developed for critical editions. Unlike \Eledmac{} % which is based on \edmac, \texttt{EDNOTES} takes a different (internal) % approach and provides a different set of features. For example it % provides additional facilities for overlapping lemmas and for % handling tables. For more information there is a web site at % \url{http://ednotes.sty.de.vu} or % email to \url{ednotes.sty@web.de}. % % The \Lpack{poemscol} package~\cite{POEMSCOLTUG} by John Burt\index{Burt, John} % is designed for typesetting % critical editions of collections of poems. I do not know how, or whether, % \Lpack{poemscol} and \Eledmac{} will work together. % % Critical authors may find it useful % to look at \edmac, \texttt{EDNOTES}, \Eledmac, and \Lpack{poemscol} to % see which best meets their needs. % % At the time of writing Peter Wilson knows of two web sites, apart from the \edmac{} % home page, that have information on \Eledmac, and other programs. % \begin{itemize} % \item Jer\'{o}nimo Leal\index{Leal, Jeronimo@Leal, Jer\'{o}nimo} % pointed me to \url{http://www.guit.sssup.it/latex/critical.html}. This % also mentions another package for critical editions called % \Lpack{MauroTeX} (\url{http://www.maurolico.unipi.it/mtex/mtex.htm}). % These sites are both in Italian. % \item Dirk-Jan Dekker\index{Dekker, Dirk-Jan} maintains % \url{http://www.djdekker.net/ledmac} % which is a FAQ for typesetting critical editions and \Eledmac. % \end{itemize} % % % This manual contains a general description of how to use the \LaTeX\ version of \edmac, namely \Eledmac % (in sections~\ref{howto} through~\ref{sec:lastuser}); % the complete source code for the package, % with extensive documentation (in sections~\ref{overview} and following) % ; and an Index to the % source code. We do not suggest that you need to % read the source code for this package in order to use it; we % provide this code primarily for reference, and many of our % comments on it repeat material that is also found in % the earlier sections. But no documentation, however % thorough, can cover every question that comes up, and many can be % answered quickly by consultation of the code. On a first reading, % we suggest that you should read only the general documentation in % sections~\ref{howto}, unless you are particularly interested in the innards of \Eledmac. % % \subsection{History} % % \subsubsection{EDMAC} % % The original version of \edmac{} was \texttt{TEXTED.TEX}, written % by John Lavagnino\index{Lavagnino, John} % in late 1987 and early 1988 for formatting % critical editions of English plays. % % John passed these macros on to Dominik Wujastyk\index{Wujastyk, Dominik} % who, in % September--October 1988, added the footnote paragraphing mechanism, % margin swapping and other changes to suit his own purposes, making the % style more like that traditionally used for classical texts in Latin and % Greek (e.g., the Oxford Classical Texts series). He also wrote some % extra documentation and sent the files out to several people. This % version of the macros was the first to be called \edmac. % % The present version was developed in the summer of 1990, with the % intent of adding necessary features, streamlining and documenting % the code, and further generalizing it to make it easily adaptable % to the needs of editors in different disciplines. John did most % of the general reworking and documentation, with the financial % assistance of the Division of the Humanities and Social Sciences, % California Institute of Technology. Dominik adapted the code to % the conventions of Frank Mittelbach's\index{Mittelbach, Frank} % \verb"doc" option, and added some documentation, multiple-column % footnotes, cross-references, and crop marks.\footnote{This version of % the macros was used to format the Sanskrit text in volume I of {\em % Metarules of P\=a\d ninian Grammar\/} by Dominik Wujastyk (Groningen: % Forsten, 1993).} A description by John and Dominik of this version of % \edmac{} was published as `An overview of \edmac: a \PlainTeX\ % format for critical editions', \emph{TUGboat} \textit{11} (1990), % pp.\,623--643. % % From 1991 through 1994, the macros continued % to evolve, and were tested at a % number of sites. We are very grateful to all the members of the % (now defunct) % \verb"edmac@mailbase.ac.uk" discussion group who helped us with % smoothing out bugs and infelicities in the macros. % Ron Whitney\index{Whitney, Ron} and our anonymous reviewer at % the TUG were both of great help in ironing out last-minute % wrinkles, while Ron made some important suggestions which may help % to make future versions of \edmac{} even more efficient. % Wayne % Sullivan,\index{Sullivan, Wayne} in particular, provided several % important fixes and contributions, including adapting the % Mittelbach\slash % Sch\"opf\index{Sch\"opf, Rainer}\index{Mittelbach, Frank} `New % Font Selection Scheme' for use with \PlainTeX\ and \edmac. % Another project Wayne has worked % on is a \verb"DVI" post-processor which works with an \edmac{} % that has been slightly modified to output \cs{special}s. This % combination enables you to recover to some extent the text of % each line, as {\sc ascii} code, facilitating the creation of % concordances, an {\em index verborum}, etc. % % At the time of writing (1994), we are pleased to be able to say that \edmac{} is % being used for real-life book production of several interesting % editions, such as the Latin texts of Euclid's {\sl % Elements},\footnote{Gerhard Brey\index{Brey, Gerhard} used \edmac{} in % the production of Hubert L. L. Busard\index{Busard, Hubert L. L.} and % Menso Folkerts,\index{Folkerts, Menso} {\em Robert of Chester's % (?)\index{Chester, Robert of} Redaction of Euclid's\index{Euclid} {\em % Elements}, the so-called Adelard II\index{Adelard II} Version}, 2 vols., % (Basel, Boston, Berlin: Birkh\"auser, 1992).} an edition of the letters % of Nicolaus Copernicus,\footnote{Being prepared at the German Copernicus % Research Institute, Munich.}\index{Copernicus, Nicolaus} Simon % Bredon's\index{Bredon, Simon} {\em Arithmetica},\footnote{Being prepared % by Menso Folkerts {\em et al.}, at the Institut f\"ur Geschichte der % Naturwissenschaften in Munich.} a Latin translation by Plato of % Tivoli\index{Plato of Tivoli} of an Arabic astrolabe % text,\footnote{Richard Lorch,\index{Lorch, Richard} Gerhard % Brey\index{Brey, Gerhard} {\em et al.}, at the same Institute.} a Latin % translation of part II of the Arabic {\em Algebra\/} by Ab\=u K\=amil % Shuj\=a' b. Aslam,\index{Abu Kamil Shuja' b. Aslam}\footnote{Richard % Lorch, `Ab\=u K\=amil on the Pentagon and Decagon' in {\em Vestigia % Mathematica}, ed.\ M. Folkerts and J. P. Hogendijk (Amsterdam, Atlanta: % Rodopi, 1993).} the Latin {\em Rithmachia\/} of Werinher von % Tegernsee,\footnote{Menso Folkerts, `Die {\em Rithmachia\/} des Werinher % von Tegernsee', ibid.} a middle-Dutch romance epic on the % Crusades,\footnote{Geert H. M. Claassens,\index{Claassens, Geert H. M.} % {\em De Middelnederlandse Kruisvaartromans}, (Amsterdam: Schiphower en % Brinkman, 1993).} a seventeenth-century Hungarian politico-philosophical % tract,\footnote{Emil Hargittay, {\em Cs\'aky Istv\'an: Politica % philosophiai Okoskod\'as-szerint val\'o rendes \'eletnek p\'eld\'aja % (1664--1674)\/} (Budapest: Argumentum Kiad\'o, 1992).} an anonymous % Latin compilation from Hungary entitled {\em Sermones Compilati in % Studio Gererali Quinqeecclesiensi in Regno Ungarie},\footnote{Being % produced, as was the previous book, by Gyula Mayer\index{Mayer, Gyula} % in Budapest.} the collected letters and papers of % Leibniz,\index{Leibniz}\footnote{Leibniz, {\em S\"amtliche Schriften und % Briefe}, series {\sc I, III, VII,} being edited by Dr.\ H. % Breger\index{Breger, Herbert}, Dr. N. G\"adeke\index{G\"adeke, Nora} and % others, % at the Leibniz-Archiv, Nieders\"achsische Landesbibliothek, Hannover. % (see \url{http://www.nlb-hannover.de/Leibniz})} % Theodosius's\index{Theodosius} {\em Spherics}, the German {\em % Algorismus} of Sacrobosco,\index{Sacrobosco} the Sanskrit text of the % {\em K\={a}\'{s}ik\={a}\-v\d{r}tti\/} of V\={a}mana\index{Vamana} and % Jay\={a}ditya\index{Jayaditya},\footnote{Being prepared at Poona and % Lausanne Universities.} and the English texts of Thomas % Middleton's\index{Middleton, Thomas} collected works. % % \subsubsection{eledmac} % % % % Version 1.0 of \tabmac{} was released by % Herbert Breger\index{Breger, Herbert} in October % 1996. This added the capability for typesetting tabular material. % % Version 0.01 of \edstanza{} was released by % Wayne Sullivan~\index{Sullivan, Wayne} % in June 1992, to help a colleague with typesetting Irish verse. % % In March 2003 Peter Wilson started an attempt to port \edmac{} % from TeX to LaTeX. The starting point was \edmac{} version 3.16 % as documented on 19 July 1994 (available from CTAN). In August 2003 % the \tabmac{} functions were added; the starting point for these % being version 1.0 of Ocober 1996. The \edstanza{} (v0.01) functions were % added in February 2004. Sidenotes and regular footnotes in numbered % text were added in April 2004. % % This port was called \emph{ledmac}. % % Since July~2011, ledmac is maintained by Ma\"ieul Rouquette. % % Important changes were put in version 1.0, to make eledmac more easily extensible (see \reff{displayoptions}). % These changes can trigger small problems with the old customization. % That is why a new name was selected: \emph{eledmac}. To migrate from ledmac to eledmac, please read Appendix \ref{migration} (p.~\pageref{migration}). % % \subsubsection{List of works edited with (e)ledmac} % A collaborative list of works edited with (e)ledmac is available on \url{https://www.zotero.org/groups/critical_editions_typeset_with_edmac_ledmac_and_eledmac/items}. Please add your own edition made with (e)ledmac. % % \section{The \Eledmac{} package}\label{howto} % % % \Eledmac{} is a three-pass package like % \LaTeX\ itself. % Although your textual apparatus and line % numbers will be printed even on the first run, it takes two more % passes through \LaTeX\ to be sure that everything gets to its right % place. Any changes you make to the input file may similarly % require three passes to get everything to the right place, if the % changes alter the number of lines or notes. \Eledmac{} will tell % you that you need to make more runs, when it notices, but it does % not expend the labor to check this thoroughly. If you have % problems with a line or two misnumbered at the top of a page, try % running \LaTeX\ once or twice more. % % A file may mix \emph{numbered} and \emph{unnumbered} text. % Numbered text is printed with marginal line numbers and can include % footnotes and endnotes that are referenced to those line numbers: % this is how you'll want to print the text that you're editing. % Unnumbered text is not printed with line numbers, and you can't % use \eledmac's note commands with it: this is appropriate for % introductions and other material added by the editor around the % edited text. % % % \section{Options} % The package can be loaded with a number of global options which are listed here. % It is advised to read the relevant parts of the handbook before reading this section. % \begin{description} % \item[draft] underlines lemmas in the main text. % \item[ledsecnolinenumber] is deprecated. % \item[nocritical] disables tools for critical footnotes (\cs{Afootnote}, \cs{Bfootnote} etc.). If you do not need critical footnotes, this option lets \eledmac\ run faster. % It will also preserve room for other packages. % \item[noeledsec] disables tools for \cs{eledsection} and related commands (\reff{eledsection}). % \item[noend] disables tools for endnotes (\cs{Aendnote}, \cs{Bendnote} etc.). If you do not need endnotes, this option lets \eledmac\ run faster. % It will also preserve room for other packages. % \item[nofamiliar] disables tools for familiar footnotes (\cs{footnoteA}, \cs{footnoteB} etc.). If you do not need familiar footnotes, this option lets \eledmac\ run faster. % It will also preserve room for other packages. % \item[noledgroup] \eledmac{} allows to use of (two or more) critical series of notes and (two or more) new series of normal notes inside minipage and ledgroup environments (see~\reff{ledgroup}). However, such features use up computer memory, at the expense of other processing needs. So if you do not need this feature, use \verb+noledgroup+ option. This should make \eledmac{} faster. % \item[nopbinverse] prevents page break inside verses. % \item[noquotation] by default, the quotation environment is redefined inside numbered text. You can disable this redefinition with \verb|noquotation| (see \reff{noquotation}). % \item[oldprintnpnumspace] is only to be used if you want to have the (bugged) behavior of \cs{doendnotes} of \Eledmac{} versions prior to v.1.21.0 (see \reff{oldprintnpnumspace}) % \item[parapparatus] by default, the apparatus cannot contain paragraph breaks; this option enables paragraphing inside the apparatus. % \item[series] \Lpack{eledmac} defines six levels of notes: A, B, C, D, E, Z. % Using all these levels consumes memory space and processing speed. % This is why, if your work does not require all of the A-E, Z series, you can narrow down the available number of series. % For example, if you only need A and B series, call the package with \verb+series={A,B}+ option. % \item[xindy] and \verb|xindy+hyperref| are for selecting \verb+xindy+ as the index processor (\reff{xindy}). % \item[widthliketwocolumns] set the width of the text disposed on one column to be the same as the width of the text disposed on two parallel columns with \Lpack{eledpar}. This is useful when alternating between normal and parallel typesetting. % \end{description} % \section{Text lines and paragraphs numbering} % \subsection{Text lines numbering} % \DescribeMacro{\beginnumbering} % \DescribeMacro{\endnumbering} % Each section of numbered text must be preceded by % \cs{beginnumbering} and followed by \cs{endnumbering}, like: \\ % \cs{beginnumbering} \\ % \meta{text} \\ % \cs{endnumbering} % % The \cs{beginnumbering} macro resets the line number to zero, % reads an auxiliary file called \meta{jobname}.\file{nn} (where % \meta{jobname} is the name of the main input file for this job, % and \file{nn} is 1 for the first numbered section, 2 for % the second section, and so on), and then creates a new version of % this auxiliary file to collect information during this run. The % first instance of \cs{beginnumbering} also opens a file called % \meta{jobname}\file{.end} to receive the text of the endnotes. % \cs{endnumbering} closes the \meta{jobname}.\file{nn} file. % % If the line numbering of a text is to be continuous from start to end, % then the whole text will be typed between one pair of % \cs{beginnumbering} and \cs{endnumbering} commands. But your text % will most often contain chapter or other divisions marking sections % that should be independently numbered, and these will be appropriate % places to begin new numbered sections. \Eledmac{} has to read and store % in memory % a certain amount of information about the entire section when it % encounters a \cs{beginnumbering} command, so it speeds up the % processing and reduces memory use when a text is divided into a larger % number of sections (at the expense of multiplying the number of % external files that are generated). % % \subsection{Paragraphs} % \subsubsection{Basis} % \DescribeMacro{\pstart} % \DescribeMacro{\pend} % Within a numbered section, each paragraph of numbered text must % be marked using the \cs{pstart} and \cs{pend} commands: \\ % \cs{pstart} \\ % \meta{paragraph of text} \\ % \cs{pend} % % Text that appears within a numbered section but isn't marked with % \cs{pstart} and \cs{pend} will not be numbered. % % The following example shows the proper section and paragraph % markup, and the kind of output that would typically be generated: % \egstart % \begin{verbatim} % \beginnumbering % \pstart % This is a sample paragraph, with % lines numbered automatically. % \pend % % \pstart % This paragraph too has its % lines automatically numbered. % \pend % % The lines of this paragraph are % not numbered. % % \pstart % And here the numbering begins % again. % \pend % \endnumbering % \end{verbatim} % \egmid % {\parskip0pt \count255=0 % \everypar{\advance \count255 by 1 \hbox to 1.5em{\the\count255\hfil}} % This is a sample paragraph\par % with lines numbered\par % automatically.\smallskip % % This paragraph too\par % has its lines automatically\par % numbered.\smallskip % % \everypar{\hbox to 1.5em{\hfil}} % The lines of this paragraph\par % are not numbered.\smallskip % % \everypar{\advance \count255 by 1 \hbox to 1.5em{\the\count255\hfil}} % And here the numbering\par % begins again.\par} % \egend % % \subsubsection{Content before specific \cs{pstart} and after \cs{pend}}\label{pstart:optionalarg} % \changes{v1.12.0}{2014/08/05}{Optional arguments for \cs{pstart} and \cs{pend}.} % Both \cs{pstart} and \cs{pend} can take a optional argument, in brackets. % Its content will be printed before the beginning of \cs{pstart} / after the end of \cs{pend} instead of the argument of \cs{AtEveryPstart} / \cs{AtEveryPend}. % If you need to start a \cs{pstart} by brackets, or to add brackets after a \cs{pend}, just add a \cs{relax} between \cs{pstart}/\cs{pend} and the brackets. % % For example, \Lpack{eledmac} does not insert \cs{parskip} between paragraphs. This feature allows you to insert it: % \begin{verbatim} % \parskip=2\baselineskip% Set the skip between paragraphs % \AtEveryPend{\vskip\parskip}% Apply after every \Pend % \end{verbatim} %. This feature is also useful when typesetting verses (see~\reff{verse}) or \Lpack{eledpar} (see~\reff{eledpar}). % % A \cs{noindent} is automatically added before this argument. % \subsubsection{Content before every \cs{pstart} and after every \cs{pend}} % \changes{v1.15.0}{2015/01/12}{New commands \cs{AtEveryPstart} and \cs{AtEveryPend}.} % \label{AtEveryPstart} \DescribeMacro{\AtEveryPstart}\DescribeMacro{\AtEveryPend} % You can use both \cs{AtEveryPstart} and \cs{AtEveryPend}. % Their arguments will be printed before every \cs{pstart} begins / after every \cs{pend} ends. % \subsubsection{Producting automatically \cs{pstart}\ldots{}\cs{pend}} % \DescribeMacro{\autopar} % You can use \cs{autopar} to avoid the nuisance of this paragraph markup % and still have every paragraph automatically numbered. The scope of the % \cs{autopar} command needs to be limited by keeping it within a group, as % follows: % \egstart % \begin{verbatim} % \begingroup % \beginnumbering % \autopar % % A paragraph of numbered text. % % Another paragraph of numbered % text. % % \endnumbering % \endgroup % \end{verbatim} % \egmid % {\parskip0pt \count255=0 % \everypar{\advance \count255 by 1 \hbox to 1.5em{\the\count255\hfil}} % A paragraph of numbered\par % text.\smallskip % % Another paragraph of\par % numbered text.\par} % \egend % % \cs{autopar} fails, however, on paragraphs that start with a % \verb"{" or with any other command that starts a new group before it % generates any text. Such paragraphs need to be started explicitly, % before the new group is opened, % using \cs{indent}, \cs{noindent}, or \cs{leavevmode}, or using % \cs{pstart} itself.\footnote{For a detailed study of the % reasons for this restriction, see Barbara Beeton, `Initiation % rites', \textit{TUGboat} \textbf{12} (1991), % pp.\,257--258.\protect\index{Beeton, Barbara Ann Neuhaus Friend}} % % \subsubsection{Numbering paragraphs (\cs{pstart})} %\changes{v0.12.0}{2011/10/01}{Possibility to number \cs{pstart}.} % It is possible to insert a number at every \cs{pstart} command. You must use the \DescribeMacro{\numberpstarttrue}\cs{numberpstarttrue} command to have it. You can stop the numbering with \DescribeMacro{\numberpstartfalse}\cs{numberpstartfalse}. % You can redefine the command \DescribeMacro{\thepstart}\cs{thepstart} to change style. % You can change the value of the pstart number by using \emph{after} \cs{beginnumbering}: % \begin{verbatim} % \setcounter{numberpstart}{value} % \end{verbatim} % On each \cs{beginnumbering} the numbering restarts. % \changes{v0.15.0}{2012/06/11}{Possibility to print \cs{pstart} number inside.} % % With the \cs{sidepstartnumtrue} command, the number of \cs{pstart} will be printed inside. In this case, the line number will be not printed. % % \changes{v1.1.0}{2012/09/25}{Add \cs{labelpstarttrue}.} % With the \cs{labelpstarttrue} command, a \cs{label} added just after a \cs{pstart} will refer to the number of this pstart. % \subsubsection{Languages written in Right to Left} % If you use languages written in right to left, we \LuaLaTeX\ or \XeLaTeX, so % you must switch text direction \cs{before} the \cs{pstart} command. % \subsubsection{Memory limits} % \textbf{This paragraph is kept for history, but problem described below should not appear with \Lpack{eledmac}.} % \DescribeMacro{\pausenumbering} % \DescribeMacro{\resumenumbering} % \phantomsection\label{pause}\relax % \Eledmac{} stores a lot of information about line numbers and % footnotes in memory as it goes through a numbered section. But % at the end of such a section, it empties its memory out, so to % speak. If your text has a very long numbered section it is % possible that your \LaTeX\ may reach its memory limit. There are % two solutions to this. The first is to get a larger \LaTeX\ with % increased memory. % The second solution is to % split your long section into several smaller ones. The trouble % with this is that your line numbering will start again at zero % with each new section. To avoid this problem, we provide % \cs{pausenumbering} and \cs{resumenumbering} which are just % like \cs{endnumbering} \ldots\ \cs{beginnumbering}, except that % they arrange for your line numbering to continue across the break. % Use \cs{pausenumbering} only between numbered paragraphs: % \egstart % \begin{verbatim} % \beginnumbering % \pstart % Paragraph of text. % \pend % \pausenumbering % % \resumenumbering % \pstart % Another paragraph. % \pend % \endnumbering % \end{verbatim} % \egmid % {\parskip0pt \count255=0 % \everypar{\advance \count255 by 1 \hbox to 1.5em{\the\count255\hfil}} % Paragraph of\par % text.\medskip % % Another paragraph.\par} % \egend % % We have % defined these commands as two macros, in case you find it necessary % to insert text between numbered sections without disturbing the % line numbering. But if you are really just using these macros to % save memory, you might as well say % \begin{verbatim} % \newcommand{\memorybreak}{\pausenumbering\resumenumbering} % \end{verbatim} % and say \cs{memorybreak} between the relevant \cs{pend} and % \cs{pstart}. % % \subsection{Lineation commands} % \subsubsection{Disabling lineation} % \DescribeMacro{\numberlinefalse} \DescribeMacro{\numberlinetrue} % Line numbering can be disabled with \cs{numberlinefalse}. It can be enabled again with \cs{numberlinetrue}. % \subsubsection{Setting lineation start and step} % \DescribeMacro{\firstlinenum} % \DescribeMacro{\linenumincrement} % By default, \Eledmac{} numbers every 5th line. There are two counters, % \verb?firstlinenum? and \verb?linenumincrement?, that control this % behaviour; they can be changed using \cs{firstlinenum}\marg{num} and % \cs{linenumincrement}\marg{num}. \cs{firstlinenum} specifies the first % line that will have a printed number, and \cs{linenumincrement} is % the difference between succesive % numbered lines. For example, to start printing numbers at the first line % and to have every other line numbered: \\ % \verb?\firstlinenum{1} \linenumincrement{2}? % % \DescribeMacro{\firstsublinenum} % \DescribeMacro{\sublinenumincrement} % There are similar commands, \cs{firstsublinenum}\marg{num} and % \cs{sublinenumincrement}\marg{num} for controlling sub-line numbering. % \DescribeMacro{\linenumberlist} % You can define \cs{linenumberlist} to specify a non-uniform distribution % of printed line numbers. For example: \\ % \verb?\def\linenumberlist{1,2,3,5,7,11,13,17,19,23,29}? \\ % to have numbers printed on prime-numbered lines only. There must be % no spaces within the definition which consists of comma-separated decimal % numbers. The numbers can be in any order but it is easier to read if you % put them in numerical order. Either omitting the definition of % \cs{linenumberlist} or following the vacuous definition \\ % \verb?\def\linenumberlist{}? \\ % the standard numbering sequence is applied. The standard sequence % is that specified by the combination of the \texttt{firstlinenum}, % \texttt{linenumincrement}, \texttt{firstsublinenum} and % \texttt{linenumincrement} counter values. % \subsubsection{Setting lineation reset} % \DescribeMacro{\lineation} % \changes{v1.0.0}{2012/09/15}{Debug in lineation command} % Lines can be numbered either by page, by pstart or by section; you specify % this using the \cs{lineation}\marg{arg} % macro, where \meta{arg} is either % \texttt{page}, \texttt{pstart} or \texttt{section}. You may only use this command at places % where numbering is not in effect; you can't change the lineation system % within a section. You can change it between sections: they don't all % have to use the same lineation system. % The package's standard setting is \verb"\lineation{section}". If the lineation is by pstart, the pstart number will be printed before the line number in the notes. % % \subsubsection{Setting line number margin} % \DescribeMacro{\linenummargin} % The command \cs{linenummargin}\meta{location} specifies the margin % where the line (or pstart) numbers will be printed. The permissable value % for \meta{location} is one out of the list \texttt{left}, \texttt{right}, % \texttt{inner}, or \texttt{outer}, % for example \verb"\linenummargin{inner}". % The package's default setting is \\ % \verb"\linenummargin{left}" \\ % to typeset the numbers in the left hand margin. % You can change this whenever you're not in the middle of % making a paragraph. % % More precisely, the value of % \cs{linenummargin} used is that in effect at the \cs{pend} % of a numbered paragraph. Apart from an initial setting for % \cs{linenummargin}, only change it after a \cs{pend}, whereupon % it will apply to all following numbered paragraphs, until % changed again (changing it between a \cs{pstart} and \cs{pend} % pair will apply the change to all the current paragraph). % % % \subsubsection{Other settings} % % \DescribeMacro{\leftlinenum} % \DescribeMacro{\rightlinenum} % \DescribeMacro{\linenumsep} % When a marginal line number is to be printed, there are a % lot of ways to display it. % You can redefine \cs{leftlinenum} and \cs{rightlinenum} to % change the way marginal line numbers are printed in the % left and right margins respectively; the initial % versions print the number in font \cs{numlabfont} (described % below) at a distance \cs{linenumsep} (initially set to one pica) % from the text. % % \subsection{Changing the line numbers} % % Normally the line numbering starts at 1 for the first line of % a section and steps up by one for each line thereafter. There % are various common modifications of this system, however; the % commands described here allow you to put such modifications % into effect. % % \DescribeMacro{\startsub} % \DescribeMacro{\endsub} % You insert the \cs{startsub} and \cs{endsub} commands in your text % to turn sub-lineation on and off. In plays, for % example, stage directions are often numbered with sub-line % numbers: as line $10.1$, $10.2$, % $10.3$, rather than as $11$, $12$, and $13$. % Titles and headings are sometimes numbered with sub-line numbers % as well. % % When sub-lineation is in effect, the line number counter is % frozen and the sub-line counter advances instead. If one of these % commands appears in the middle of a line, it doesn't take effect % until the next line; in other words, a line is counted as a line % or sub-line depending on what it started out as, even if that % changes in the middle. % % \DescribeMacro{\startlock} % \DescribeMacro{\endlock} % The \cs{startlock} command, used in running text, locks the % line number at its current value, until you say \cs{endlock}. % It can tell for itself whether you are in a patch of line or % sub-line numbering. One use for line-number locking is in printing % poetry: there the line numbers should be those of verse lines % rather than of printed lines, even when a verse line requires several % printed lines. % % \DescribeMacro{\lockdisp} % When line-number locking is used, % several printed lines may have the same line number, and you have to % specify whether you want the number attached to the first printed % line or the last, or whether you just want the number printed by % them all. (This assumes that, on the basis of the settings of % the previous parameters, it is necessary to display a line number for % this line.) You specify your preference using \cs{lockdisp}\marg{arg}; its % argument is a word, either \texttt{first}, \texttt{last}, or \texttt{all}. % The package initially sets this as \verb"\lockdisp{first}". % % \DescribeMacro{\setline} % \DescribeMacro{\advanceline} % In some cases you may want to modify the line numbers that are % automatically calculated: if you are printing only fragments % of a work but want to print line numbers appropriate to a complete % version, for example. The \cs{setline}\marg{num} and % \cs{advanceline}\marg{num} commands % may be used to change the current line's number (or the sub-line % number, if sub-lineation is currently on). They change both the % marginal line numbers and the line numbers passed to the notes. % \cs{setline} takes one argument, the value to which you want % the line number set; it must be $0$ or greater. \cs{advanceline} % takes one argument, an amount that should be added to the current % line number; it may be positive or negative. % % \DescribeMacro{\setlinenum} % The \verb?\setline? and \verb?\advanceline? macros should only be used % within a \verb?\pstart...\pend? group. The \cs{setlinenum}\marg{num} % command can be used outside such a group, for example between % a \verb?pend? and a \verb?\pstart?. It sets the line number % to \meta{num}. % It has no effect if used within a \verb?\pstart...\pend? group % % \DescribeMacro{\linenumberstyle} % \DescribeMacro{\sublinenumberstyle} % Line numbers are nomally printed as arabic numbers. You can % use \cs{linenumberstyle}\marg{style} to change the numbering style. % \meta{style} must be one of: % \begin{itemize} % \item[\texttt{Alph}] Uppercase letters (A\ldots\ Z). % \item[\texttt{alph}] Lowercase letters (a\ldots\ z). % \item[\texttt{arabic}] Arabic numerals (1, 2, \ldots) % \item[\texttt{Roman}] Uppercase Roman numerals (I, II, \ldots) % \item[\texttt{roman}] Lowercase Roman numerals (i, ii, \ldots) % \end{itemize} % Note that with the \texttt{Alph} or \texttt{alph} styles, `numbers' % must be between 1 and 26 inclusive. % % Similarly \cs{sublinenumberstyle}\marg{style} can be used to change % the numbering style of sub-line numbers, which is normally arabic numerals. % % \DescribeMacro{\skipnumbering} % When inserted into a numbered line the macro \cs{skipnumbering} causes % the numbering of that particular line to be skipped; that is, the line % number is unchanged and no line number will be printed. % Note that if you use it in \cs{stanza}, you must call it at the beginning of the verse. % % \DescribeMacro{\hidenumbering} % \changes{v1.21.0}{2015/04/13}{Add \cs{hidenumbering}} % When inserted into a numbered line the macro \cs{hidenumbering} causes % the number for that particular line to be hidden; namely, no line number will print. % Note that if you use it in \cs{stanza}, you must call it at the beginning of the verse. % \section{The apparatus} % \subsection{Commands} % \subsubsection{The lemma} % \DescribeMacro{\edtext} % Within numbered paragraphs, all footnotes and endnotes are generated % by the \cs{edtext} macro: % \begin{verse} % \cs{edtext}\marg{lemma}\marg{commands} % \end{verse} % % % The \meta{lemma} argument is the lemma in the main text: \cs{edtext} % both prints this as part of the text, and makes it available to the % \meta{commands} you specify to generate notes. % % For example: % \egstart % \begin{verbatim} % I saw my friend \edtext{Smith}{ % \Afootnote{Jones C, D.}} % on Tuesday. % \end{verbatim} % \egmid % 1\enspace I saw my friend\\ % 2\enspace Smith on Tuesday.\smallskip % \hrule width 1.5cm % \strut {\bf 2} Smith] Jones C, D. % \egend % % The lemma \verb?Smith? is printed as part of this sentence in % the text, and is also made available to the footnote % that specifies a variant, \verb?Jones C, D?. The footnote macro % is supplied with the line number at which the lemma appears % in the main text. % % The \meta{lemma} may contain further \cs{edtext} commands. % Nesting makes % it possible to print an explanatory note on a long passage together with % notes on variants for individual words within the passage. For % example: % \egstart % \begin{verbatim} % \edtext{I saw my friend % \edtext{Smith}{\Afootnote{Jones % C, D.}} on Tuesday.}{ % \Bfootnote{The date was % July 16, 1954.} % } % \end{verbatim} % \egmid % 1\enspace I saw my friend\\ % 2\enspace Smith on Tuesday.\smallskip % \hrule width 1.5cm % \strut {\bf 2} Smith] Jones C, D.\smallskip % \hrule width 1.5cm % \strut {\bf 1--2} I saw my friend \\ % Smith on Tuesday.] The\\ date was % July 16, 1954. % \egend % % However, \cs{edtext} cannot handle overlapping but unnested % notes---for example, one note covering lines 10--15, and another % covering 12--18; a \cs{edtext} that starts in the \meta{lemma} % argument of another \cs{edtext} must end there, too. (The % \cs{lemma} and \cs{linenum} commands may be used to % generate overlapping notes if necessary.) % % \subsubsection{Footnotes} % % The second argument of the \cs{edtext} macro, \meta{commands}, % may contain a series of subsidiary commands that generate % various kinds of notes. % % \DescribeMacro{\Afootnote} % \DescribeMacro{\Bfootnote} % \DescribeMacro{\Cfootnote} % \DescribeMacro{\Dfootnote} % \DescribeMacro{\Efootnote} % \DescribeMacro{\Zfootnote} % Six separate series of the footnotes are maintained; each macro % takes one argument like \cs{Afootnote}\marg{text}. % When all of the six % are used, the \texttt{A} notes appear in a layer just below the main % text, followed by the rest in turn, down to the \texttt{Z} notes at % the bottom. % These are the main macros that you will use to construct % the critical apparatus of your text. % % If you need more series of critical notes, please look at \reff{newseries}. % %\changes{v1.0.0}{2012/09/15}{Options nonum and nosep in \cs{Xfootnote}.} %\changes{v1.20.0}{2015/03/22}{Options fulllines in \cs{Xfootnote}.}\label{Xfootnoteopt} %An optional argument can be added before the text of the footnote. Its value is a comma separated list of options. % \label{fulllines}The available options are: % \begin{itemize} % \item \verb|fulllines| to disable \cs{twolines} and \cs{morethantwolines} features for this note (cf. \reff{twolines}). % \item \verb|nonum| to disable line numbering for this note. % \item \verb|nosep| to disable the lemma separator for this note. % \end{itemize} % % Example: \cs{Afootnote}\verb|[nonum]|\marg{text}. % % \subsubsection{Endnotes} % \DescribeMacro{\Aendnote} % \DescribeMacro{\Bendnote} % \DescribeMacro{\Cendnote} % \DescribeMacro{\Dendnote} % \DescribeMacro{\Eendnote} % \DescribeMacro{\Zendnote} % The package also maintains six separate series of endnotes. % % If you do not need the endnotes facility, you should use \verb+noend+ option when loading \Lpack{eledmac}. % % The mechanism is similar to the one for footnotes: each macro takes one or more optional arguments and one single argument, like:\\ % \cs{Aendnote}\oarg{option}\marg{text}. % % \verb+[