diff options
author | Karl Berry <karl@freefriends.org> | 2006-01-09 00:49:07 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2006-01-09 00:49:07 +0000 |
commit | 007f67a693e4d031fd3d792df8e4d5f43e2cb2e7 (patch) | |
tree | 90d17e00e572ecb1e24764b6f29c80e098b08d29 /Master/texmf-dist/doc/latex/teubner/teubner-doc.tex | |
parent | 950209b26f70aa87ed07c54f82a95b6f03b7c3a0 (diff) |
doc/latex
git-svn-id: svn://tug.org/texlive/trunk@84 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/teubner/teubner-doc.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/teubner/teubner-doc.tex | 850 |
1 files changed, 850 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/teubner/teubner-doc.tex b/Master/texmf-dist/doc/latex/teubner/teubner-doc.tex new file mode 100644 index 00000000000..e96adce2315 --- /dev/null +++ b/Master/texmf-dist/doc/latex/teubner/teubner-doc.tex @@ -0,0 +1,850 @@ +\documentclass[12pt]{article} +\usepackage{mflogo} +\usepackage[greek,english]{babel} +\usepackage[or]{teubner} +\usepackage{mflogo} +\usepackage{afterpage} +\title{\texttt{teubner.sty} +\thanks{This paper documents \texttt{teubner.sty} version 2.2 of 2004/09/02.}\\ +An extension of the \textsf{greek} option\\ of the \textsf{\slshape babel} +package} +\author{Claudio Beccari\thanks{Dipartimento di Elettronica del Politecnico di Torino}} +\date{2004/09/03} +\def\comando#1{\texttt{\expandafter\string\noexpand#1}} +\def\ARG#1{\texttt{\char123}$\langle$\textit{#1}$\rangle$\texttt{\char125}} +\def\Arg#1{$\langle$\textit{#1}$\rangle$} +\def\brArg#1{\texttt{\char123#1\char125}} +\def\opt#1{\texttt{[}$\langle$\textit{#1}$\rangle$\texttt{]}} +\def\g#1 {\textDidot{#1}} +\def\l#1 {\textLipsias{#1}} +\renewcommand*{\textfraction}{0} +\renewcommand*{\topfraction}{1.} +\renewcommand*{\bottomfraction}{.5} +\def\acro#1{\expandafter\textsc\expandafter{\MakeLowercase{#1}}} +\begin{document} + +\maketitle + +\section{Introduction} +\begin{sloppypar} +This package \texttt{teubner.sty} is an extension of the \textsf{greek} option +of the \textsf{\slshape babel} package intended to typeset classical Greek with +a philological approach. This version 2.1 cannot yet typeset the critical +apparatus as the philologists are used to, but may be this work will continue +and include also that facility. +\end{sloppypar} + +This project is being carried on with the help of Mr. Paolo Ciacchi, who got +a``master'' degree at the University of Trieste, when he was writing his +``master thesis'' where he has to deal with ancient Greek philology. + +This package is supposed to work with my CB fonts available on the +Comprehensive \TeX\ Archive Network (\textsc{ctan}); one of the actions of this +package consists in replacing the default ``italic'' Greek shape with the one +called ``Lispiakos'' in Greece; this name derives from the high quality of the +fonts used in the printers' shops in the city of Lipsia in the past 100 years +or so; one of the printer shops that continues printing books for philologists +(since 1849) is the B.G.~Teubner Verlags\-gesell\-schaft, that publishes the +collection called ``Bibliotheca Scriptorum Graecorum et Latinorum +Teubneriana''. The name given to this extension package is in homage to that +printing company and to its high quality tradition in printing Greek texts. + +The reader is supposed to know how to install a package with all its components +in his/her \TeX\ installation; here we do not spend a word on this topic, since +the various implementations of the \TeX\ systems are so idiosyncratic that the +explanations good for one implementation are not good for another; the various +operating systems also do not help in such matters. Since I have access only +to a Windows~2k computer with \textsc{MiKTeX} and a Debian Linux one with the +\TeX-Live implementation of \texttt{teTeX}, I realize that the explanations +would be so different that they would result too confusing. Let's not speak of +other operating systems and \TeX\ distributions\dots\ Nevertheless do not +forget to read carefully the accompanying file \texttt{teubner.txt}. + +Another warning: while I am upgrading this documentation, the \TeX-Live Team is +studying how to reduce the amount of material to distribute on the \TeX-Live +disk, since the contributions are growing at such a rapid rate that it becomes +urgent to chose what to include and what to leave outside, although always +downloadable form the \acro{ctan} archives. One of the candidates to reduction +is the collection of my CB Greek fonts; it is true that the whole collection of +files, that includes the \MF\ source and driver files, the metric \texttt{tfm} +files, and the PostScript \texttt{pfb} files, amounts to nearly 2000 files and +the volume exceeds 100\,MB. One of the proposals is to distribute a reduced +zipped set called \texttt{cbsmall.zip} on the \TeX-Live disk while retaining +three other collections \texttt{cbtiny.zip}, \texttt{cbmedium.zip} and +\texttt{cbhuge.zip} so that the user can proportionate the amount of downloaded +fonts to his/her real needs. For using \texttt{teubner.sty} you need the full +set of Lipsian fonts, so you should download it from \acro{ctan} should it be +missing from your customized-size set of Greek fonts. Since the operation of +the \TeX-Live Team is under way, I cannot be more precise for the moment; +should that Team decide as outlined, maybe I might modify this package so as to +conform to the specific font collection of your installation. + +This short documentation will start with briefly recalling some peculiarities +of the CB fonts and their mapping to the Latin keyboard; afterwards it will +list the new commands and their syntax. + +\section{The Greek CB fonts} +The CB fonts come in all shapes, sizes and series as the extended European +fonts that conform with the T1 encoding introduced after the Cork Conference of +the \TeX\ Users Group Society in 1991\footnote{If the \TeX-Live Team takes the +decisions outlined in the previous section the smaller sets will have the fonts +scaled up or down from a subset of the whole collection.}. The CB fonts conform +to the encoding that is still being called LGR, since up to now there is no +established encoding name for the Greek alphabet among the \TeX\ users, not +yet, at least. + +The regular shape has capital letters with serifs that are in the +same style as the roman capital ones, while the lower case letters +derive from the design by Didot and are very common in all texts. +This shape comes also in boldface, together with the two +corresponding oblique (or slanted) versions. The CB fonts contain +also the upright and slanted, medium and boldface small caps +alphabets. + +The ``italic'' shape was designed in order to imitate the Olga font designed so +as to have a contrasting style compared with the slanted Didot shape, in order +to play the same role as the italic letters play with the latin roman +alphabets. The Olga alphabets come in medium and boldface series, and in +oblique and upright shapes. + +The CB fonts are completed with the sans serif fonts, the +monospaced typewriter fonts and the fonts for slides, besides an +outline family that shows the regular shapes and series just with +their contours. + +The ``cbleipzig'' fonts imitate the beautiful shapes used in +Lipsia; they come in medium bold and extra-bold series, without +an upright version, and they are meant to replace the +corresponding Olga shapes (the bold series is good for mixing +with PostScript fonts, whose medium series is slightly blacker +than the corresponding CM and EC fonts usually used with \LaTeX). + +\section{Font installation} +In order to use the Greek CB fonts and the extensions provided with this +package, you need to install them. You can freely download those fonts from +\textsc{ctan}\footnote{At the time of writing the \textsc{ctan} archives +contain a huge compressed file that includes all the \texttt{tfm} metric files, +all the \MF\ files and all the postscript \texttt{pfb} files, inclusive of the +\texttt{cbgreek.map} file needed to instruct \textsf{dvips} and +\textsf{pdflatex} for using the scalable postscript fonts.}, where you can find +also the collection of driver files for generating them with \MF, but since you +are unlikely going to use all families, series, shapes and sizes, and since the +cbleipzig and metrics fonts are lacking the driver files, I suggest you to +follow the instructions given in the file \texttt{cbgreek.txt}; in facts the CB +fonts need only an interface between \MF\ and the \texttt{.tfm} and +\texttt{.pk} files, in order to overcome the \MF\ limitation that the output +files must have the same name of the input file (not considering the filename +extension); therefore all the driver files contain the same instruction: +\begin{quote} +\ttfamily input cbgreek; +\end{quote} +and differ only in the name; the latter is made up of four +letters and four digits; the four letters identify the Greek +fonts by family, series and shape, while the four digits identify +the size in points, multiplied by 100 and left padded with a zero +in order to complete the four digits. + +The cbleipzig fonts have their shape identified with the letter \texttt{l}, +therefore for a 9\,pt font you need a file named \texttt{grml0900.mf} +containing the above mentioned single instruction; for the metric symbol fonts +at 12\,pt you need a file named \texttt{gmtr1200.mf} containing the above +mentioned single instruction. So, should the cbleipzig and the metric symbol +\MF\ driver files be missing, you don't have too much work to do to create +them. + +\section{Inputting Greek text with a Latin keyboard} + +\begin{table}[bt]\def\g #1 {\textDidot{#1}}\tabcolsep4pt +\centering +\begin{tabular}{*{25}c} +\g a & \g b &\g g &\g d &\g e &\g z &\g h &\g j &\g i &\g k &\g l &\g m &\g n &\g x &\g o &\g p &\g r &\g c &\g sv &\g t &\g u &\g f &\g q &\g y &\g w \\ + a & b & g & d & e & z & h & j & i & k & l & m & n & x & o & p & r & c & s & t & u & f & q & y & w +\end{tabular} +\caption{Keyboard correspondence between Latin and Greek +letters}\label{t:corrispondenza} +\end{table} + +In order to input Greek text with a Latin keyboard some simple and +mostly obvious key substitutions are performed according to the +correspondence shown in table~\ref{t:corrispondenza}. + +Notice that there is the possibility of inputting \texttt{c} in +order to get the final sigma \textDidot{c}, but the CB fonts are +conceived with the non-Greek typist in mind, so that it is even +possible to input \texttt{s} at the end of words, because the +whole software is smart enough to detect the word boundary and to +use the correct shape of the letter sigma within or at the word +end. This mechanism is so ``sticky'' that it becomes difficult to +type an isolated initial or middle sigma; to this purpose the CB +fonts contain an invisible character, \texttt{v}, that may be +used for several purposes, one of which is to hide the word +boundary after a sigma; therefore if you type \texttt{sv}, you get +\textDidot{sv} without any effort. + +The invisible character \texttt{v} may be used also as a support +for (apparently) isolated accents, especially when macros have to +be used; if you type \verb"\={v}" you get +\,\textDidot{\=v}\enspace, while if you omit the invisible +\texttt{v} you get \,\textDidot{\={}}\enspace. + +Accent, spirits and dieresis are input \emph{before} each letter +(prefix notation) without using any particular control sequence; +the correspondence between the Latin symbols and the Greek +diacritical marks is shown in table~\ref{t:accenti}; all ``upper'' +diacritical marks must be prefixed (in any order), while the iota +subscript must be postfixed. Therefore if you input \verb">'a|", you +get \textDidot{>'a|}. + +\begin{table}[bt]\def\g #1 {\textDidot{#1}} +\centering +\begin{tabular}{l*{7}c} +Greek &\g > & \g < &\g "v &\g ' &\g ` &\g \~v &\g | \\ +Latin &$>$ & $<$ & " & ' & ` & \~{} & $|$ +\end{tabular} +\caption{Correspondence between the Latin keyboard symbols and +Greek diacritical marks}\label{t:accenti} +\end{table} + +Macrons and breves are just single glyphs and do not appear in combination with +any letter, due to the limitation of 256 glyphs per font; but they may be input +by means of the standard \LaTeX\ commands \verb|\=| and \verb|\u| respectively +in order to use them as accents. Together with the macros for inserting such +symbols, a complete set is available for inserting any combination of +diacritical marks over or under any letter, not only vowels: see +table~\ref{t:accentmacros}. Of course the results may not be comparable with +the ones one can obtain with the regular ligature mechanism; the advantage of +the accent macros is twofold: (a) it is connected only to the possibility of +inserting macrons and breves and/or to set the various combinations over or +under any letter, even if it is a consonant; (b) for all accent vowel +combinations that have a specific glyph in the font, the actual accented symbol +is used so that kernings and ligatures are maintained; as shown elsewhere there +is a noticeable difference between \textLipsias{a>ut'os} and +\textLipsias{a\s{u}t\'os}. In this example the first word is typed in as +\verb+a>ut'os+, while the second may be typed as \verb+a\s{u}t\'os+, or +\verb*+a\us t\oa s+, or even in mixed form \verb*+a\us t'os+ thanks to the fact +that there is no kerning between `tau' and `omicron with or without acute' + + + + +\begin{table}[tb]\makebox[\textwidth]{% +\begin{tabular}{cl|cl} +Example & \multicolumn1c{Syntax} & Example & \multicolumn1c{Syntax} \\ +\hline +\g \`{a} & \comando\`\ARG{letter} & \g\ut{aw} & \comando\ut\ARG{letters} \\ +\g \'a & \comando\'\ARG{letter} & \g\Ab{a} & \comando\Ab\ARG{letter} \\ +\g \~a & \comando\~\ARG{letter}\ap{1} & \g\Gb{a} & \comando\Gb\ARG{letter} \\ +\g \"i & \comando\"\ARG{letter} & \g\Arb{a} & \comando\Arb\ARG{letter} \\ +\g \u{a} & \comando\u\ARG{letter} & \g\Grb{a} & \comando\Grb\ARG{letter} \\ +\g \U{ai} & \comando\U\ARG{diphthong} & \g\Asb{a} & \comando\Asb\ARG{letter} \\ +\g \=a & \comando\=\ARG{letter} & \g\Gsb{a} & \comando\Gsb\ARG{letter} \\ +\g \r{a} & \comando\r\ARG{letter} & \g\Am{a} & \comando\Am\ARG{letter} \\ +\g \s{a} & \comando\s\ARG{letter} & \g\Gm{a} & \comando\Gm\ARG{letter} \\ +\g\Ad{i} & \comando\Ad\ARG{letter} & \g\Cm{a} & \comando\Cm\ARG{letter} \\ +\g\Gd{i} & \comando\Gd\ARG{letter} & \g\Arm{a} & \comando\Arm\ARG{letter} \\ +\g\Cd{i} & \comando\Cd\ARG{letter} & \g\Grm{a} & \comando\Grm\ARG{letter} \\ +\g\Ar{a} & \comando\Ar\ARG{letter} & \g\Crm{a} & \comando\Crm\ARG{letter} \\ +\g\Gr{a} & \comando\Gr\ARG{letter} & \g\Asm{a} & \comando\Asm\ARG{letter} \\ +\g\Cr{a} & \comando\Cr\ARG{letter} & \g\Gsm{a} & \comando\Gsm\ARG{letter} \\ +\g\As{a} & \comando\As\ARG{letter} & \g\Csm{a} & \comando\Csm\ARG{letter} \\ +\g\Gs{a} & \comando\Gs\ARG{letter} & \g\Sm{a} & \comando\Sm\ARG{letter} \\ +\g\Cs{a} & \comando\Cs\ARG{letter} & \g\Rm{a} & \comando\Rm\ARG{letter} \\ +\g\c{i} & \comando\c\ARG{letter} & \g\iS{a} & \comando\iS\ARG{letter} \\ +\semiv{u} & \comando\semiv\ARG{letter}\ap{2} & \g\d{p} & \comando\d\ARG{letter} \\ +\ring{a} & \comando\ring\ARG{letter}\ap{2} & \g\bd{i} & \comando\bd\ARG{letter} \\ +\hline +\end{tabular}} +\caption{Accent macros}\label{t:accentmacros} +\vskip\baselineskip +REMARKS\\[3pt]\footnotesize +\ap{1}\quad The circumflex accent may be obtained with \comando\~\ only if +attribute \textsf{polutoniko} was specified for the +Greek language with \textsf{\slshape babel} v.3.7.\\ +\ap{2}\quad Most commands may be used also with latin letters. +\end{table} + +\section{Ligatures} +It should be clear from the previous section that the ligature mechanism is the +one that offers the best results with most accented vowels; in any case it +speeds up the keying in of the text to be typeset; nevertheless there are +situations where you might be unsatisfied. + +Fore example compare \l a>ut'on \ with \textLipsias{a\us t\oa n}. +The small spacing difference between tau and the accented omicron +is hardly noticeable, but the spacing difference between alpha +and the marked upsilon is remarkable. Where does that difference +come from? It comes from the fact that the smooth spirit marker +inhibits kerning between the previous alpha and the resulting +ligature from the spirit marker and the upsilon. In other words, +by inputting \verb"a>ut'on", as it is suggested in the previous +section, the spirit marker and the acute accent inhibit the +kerning mechanism with the previous letter. In most instances the +lack of such kerning is hardly noticeable, but in others it +strikes your attention. + +For this reason a set of macros has been defined such that it is +possible to input the accented characters directly, without +resorting to the ligature mechanism. Such macros have a common +structure; they are formed with the letters that make up the +complex glyph in a certain order, precisely every macro is made +up as such: +\begin{quote}\obeylines +the first character, obviously, is the backslash character \texttt{\char92}; +the next character is the name of the vowel, one of a, e, h, i, o, u, w; +the next optional character is the code for dieresis, smooth or rough spirit, with one of the letters d, s, r; +the next character is the code for the circumflex, acute, or grave accent with one of the letters c, a, or g; +the last optional character indicates iota subscript with the presence of an i. +\end{quote} + +That means that, for instance, \comando\asai\ stands for \textDidot{\asai}. For +your convenience such macros are collected in table~\ref{t:compoundvowels}. +Such set may introduce incompatibilities with other packages or even with the +primitive \TeX\ commands. Of course one can always resort to the accent--vowel +combination as exemplified at the end of the previous section; the above +example \textDidot{\asai} may be obtained also with +\verb+\As{a}|+.\footnote{Postfixed markings do not pose any problem with +kernings and ligatures; this is why the postfixed ligature for the iota +subscript may still be used also when the accent--vowel combinations are used.} + +\begin{table}[tb]\let\c\comando\let\l\textLipsias +\makebox[\textwidth]{% +\begin{tabular}{lclclclclclc} +\c\aa &\l\aa &\c\ag &\l\ag &\c\ac &\l\ac &\c\ai &\l\ai &\c\ar &\l\ar &\c\as &\l\as \\ +\c\asa &\l\asa &\c\asg &\l\asg &\c\asc &\l\asc &\c\asi &\l\asi &\c\aai &\l\aai \\ +\c\ara &\l\ara &\c\arg &\l\arg &\c\arc &\l\arc &\c\ari &\l\ari &\c\agi &\l\agi &\c\aci &\l\aci \\ +\c\arai &\l\arai&\c\argi&\l\argi&\c\arci&\l\arci&\c\asai&\l\asai&\c\asgi&\l\asgi&\c\asci&\l\asci\\ +\hline +\c\ha &\l\ha &\c\hg &\l\hg &\c\hc &\l\hc &\c\hi &\l\hi &\c\hr &\l\hr &\c\hs &\l\hs \\ +\c\hsa &\l\hsa &\c\hsg &\l\hsg &\c\hsc &\l\hsc &\c\hsi &\l\hsi &\c\hai &\l\hai \\ +\c\hra &\l\hra &\c\hrg &\l\hrg &\c\hrc &\l\hrc &\c\hri &\l\hri &\c\hgi &\l\hgi &\c\hci &\l\hci \\ +\c\hrai &\l\hrai&\c\hrgi&\l\hrgi&\c\hrci&\l\hrci&\c\hsai&\l\hsai&\c\hsgi&\l\hsgi&\c\hsci&\l\hsci\\ +\hline +\c\wa &\l\wa &\c\wg &\l\wg &\c\wc &\l\wc &\c\wi &\l\wi &\c\wr &\l\wr &\c\ws &\l\ws \\ +\c\wsa &\l\wsa &\c\wsg &\l\wsg &\c\wsc &\l\wsc &\c\wsi &\l\wsi &\c\wai &\l\wai \\ +\c\wra &\l\wra &\c\wrg &\l\wrg &\c\wrc &\l\wrc &\c\wri &\l\wri &\c\wgi &\l\wgi &\c\wci &\l\wci \\ +\c\wrai &\l\wrai&\c\wrgi&\l\wrgi&\c\wrci&\l\wrci&\c\wsai&\l\wsai&\c\wsgi&\l\wsgi&\c\wsci&\l\wsci\\ +\hline +\c\ia &\l\ia &\c\ig &\l\ig &\c\ic &\l\ic &\c\ir &\l\ir &\c\is &\l\is \\ +\c\isa &\l\isa &\c\isg &\l\isg &\c\isc &\l\isc &\c\ida &\l\ida &\c\idg &\l\idg \\ +\c\ira &\l\ira &\c\irg &\l\irg &\c\irc &\l\irc &\c\idc &\l\idc &\c\id &\l\id \\ +\hline +\c\ua &\l\ua &\c\ug &\l\ug &\c\uc &\l\uc &\c\ur &\l\ur &\c\us &\l\us \\ +\c\usa &\l\usa &\c\usg &\l\usg &\c\usc &\l\usc &\c\uda &\l\uda &\c\udg &\l\udg \\ +\c\ura &\l\ura &\c\urg &\l\urg &\c\urc &\l\urc &\c\udc &\l\udc &\c\ud &\l\ud \\ +\hline +\c\ea &\l\ea &\c\eg &\l\eg &\c\er &\l\er &\c\es &\l\es \\ +\c\esa &\l\esa &\c\esg &\l\esg &\c\era &\l\era &\c\erg &\l\erg \\ +\hline +\c\oa &\l\oa &\c\og &\l\og &\c\oR\ap{1}&\l\oR &\c\os &\l\os \\ +\c\osa &\l\osa &\c\osg &\l\osg &\c\ora &\l\ora &\c\org &\l\org \\ +\hline +\end{tabular}% +} +\caption{Accented vowel macros}\label{t:compoundvowels} +\bigskip +REMARKS\\[3pt]\footnotesize +\ap{1}\quad As mentioned in the body of this text the command +{\let\or\relax\comando\or} may produce incompatibilities with the +primitive command with the same name. +\end{table} + +What I suggest is to typeset your paper with the regular accent +vowel ligatures and to substitute them in the final revision with +the accented vowel macros only in those instances where the lack +of kerning is disturbing. + +\section{Other Greek symbols} +Other Greek symbols may be obtained with ligatures or explicit +commands; table~\ref{t:gsymbols} contains such ligatures and +symbols; notice that some of these are specific additions +introduced with this extension package. + +\begin{table}[tb]\let\c\comando\let\l\textDidot +\makebox[\textwidth]{% +\begin{tabular}{lclclc} +\c{''} &\l{''} &\c{((} &\l{((} &\c{))} &\l{))} \\ +\c\GEodq &\l\GEodq &\c\GEcdq &\l\GEcdq &\c: &\l: \\ +\c\GEoq &\l\GEoq &\c\GEcq &\l\GEcq &\c? &\l? \\ +\c\ENodq &\l\ENodq &\c\ENcdq &\l\ENcdq &\c; &\l; \\ +\c\stigma &\l\stigma &\c\varstigma&\l\varstigma&\c\Stigma&\l\Stigma\\ +\c\coppa &\l\coppa &\c\koppa &\l\koppa &\c\Coppa &\l\Coppa\\ +\c\sampi &\l\sampi &\c\Sampi &\l\Sampi &\c\permill &\l\permill\\ +\c\digamma &\l\digamma &\c\Digamma &\l\Digamma &\c\euro &\l\euro\\ +\c\f &\l\f &\c\F &\l\F &\c\shwa &\l\shwa\\ +\end{tabular}% +} +\caption{Greek symbols}\label{t:gsymbols} +\end{table} + +I draw your attention on the necessity of using the ligature +\comando{''} for producing the simple apostrophe, which, by the +way, in Greek typography must always be followed by a space. The +single tick mark \comando'\ produces an acute accent, not an +apostrophe, this is why it is necessary to use the double tick +mark ligature. + +The Milesian numerals should not worry anybody, because they are seldom used as +isolated symbols; the \textsf{greek} or \textsf{polutonikogreek} option or the +\textsf{polutoniko} attribute of the Greek language with the \textsf{\slshape +babel} package offer the commands \comando\greeknumeral\ and +\comando\Greeknumeral, that convert common arabic positive numbers in the +Milesian counterparts within a Greek section of your document; the +corresponding commands followed by an asterisk change the digamma glyph with +the stigma one\footnote{The stigma version is the standard one with the +\textsf{\slshape babel} language support for Greek; with this package we +adopted the digamma as the ``regular'' sign with the value of~6, and attributed +stigma to the ``variant'' representation of Milesian numbers.}: +\begin{quote}\obeylines +if you type \verb"\greeknumeral{1996}" you get \textLipsias{\greeknumeral{1996}} +if you type \verb"\Greeknumeral{1996}" you get \textLipsias{\Greeknumeral{1996}} +if you type \verb"\greeknumeral*{1996}" you get \textLipsias{\greeknumeral*{1996}} +if you type \verb"\Greeknumeral*{1996}" you get \textLipsias{\Greeknumeral*{1996}} +\end{quote} + +\section{New commands} +This extension package introduces many new commands for +typesetting Greek in a philological way. Most of such commands are +collected in table~\ref{t:extcomandi}. + +A short remark on the command \comando\ap: this useful command inserts +\emph{anything} as a superscript of anything else; it works both in text mode +and in math mode\footnote{Numerical superscripts or apices do not require math +mode; numerical footnote labels are automatically inserted by \LaTeX's +\comando\footnote\ command; non numerical footnote labels are easily inserted +with \LaTeX's \comando\footnotemark\ and \comando\footnotetext\ commands with +their optional arguments.}. In particular while typesetting a philological text +in different languages and with different alphabets, \comando\ap\ typesets the +superscript with the current language and alphabet; if any change is required +the \comando\ap's argument can contain any language or alphabet specific +declaration. You can typeset things such as +\textLipsias{Baq\'ulides\,\ap{\textlatin{a}}} by switching language and +alphabet as required; the specific declarations and the commands contained in +table~\ref{t:extcomandi} come handy also in these cases. + +\afterpage{\clearpage} + +\begin{table}[p]\let\c\comando\let\l\textLipsias\let\g\textDidot +\makebox[\textwidth]{\footnotesize +\begin{tabular}{cl|cl} +Example & Syntax &Example & Syntax \\[3pt] +\l{Baq\'ulides} & (declaration) &abcde & (declaration) \\ +\l{Baq\'ulides} & \c\textLipsias\ARG{text} &\l{\lesp{abg}} &\c\lesp\ARG{text} \\ +\g{Baq\'ulides} &\c\textDidot\ARG{text} &\LitNil &\c\LitNil \\ +text & \c\textlatin\ARG{text} &\cap{g} &\c\cap\ARG{letter} \\ +\l{\frapar{Baq\'ulides}}& \c\frapar\ARG{text} &\Coronis &\c\Coronis \\ +( & \c\lpar &\lmqi &\c\lmqi \\ +) &\c\rpar &\rmqi &\c\rmqi \\ +\qmark &\c\qmark &\l{\mqi{abg}} &\c\mqi\ARG{text} \\ +\l{\Dots[3]} &\c\Dots\opt{number} &\lmqs &\c\lmqs \\ +\l{\DOTS[3]} &\c\DOTS\opt{number} &\rmqs &\c\rmqs \\ +\l{\Dashes[3]} &\c\Dashes\opt{number} &\l{\mqs{abg}} &\c\mqs\ARG{text} \\ +\l{\DASHES[3]} &\c\DASHES\opt{number} &\l{\zeugma{abg}} &\c\zeugma\ARG{text} \\ +\ap{foo} &\c\ap\ARG{text} &\l{\siniz{abg}} &\c\siniz\ARG{text} \\ +\sinafia &\c\sinafia &\paragr &\c\paragr \\ +\l{\:} &\c\: &\dparagr &\c\dparagr \\ +\l\; &\c\; &\FinisCarmen &\c\FinisCarmen \\ +\l\? &\c\? &\crux &\c\crux \\ +\l\mutpers &\c\antilabe &\l{\apici{abg}} &\c\apici\ARG{text} \\ +\| &\c\| &\apex &\c\apex \\ +\dBar &\c\dBar &\responsio &\c\responsio \\ +\tBar &\c\tBar &\Int &\c\Int \\ +\lbrk &\c\lbrk &\l{\star a} &\c\star \\ +\rbrk &\c\rbrk &\l{\dstar a} &\c\dstar \\ +\l{\ladd{abg}} &\c\ladd\ARG{text} &\l{\tstar a} &\c\tstar \\ +\l{\lladd{abg}} &\c\lladd\ARG{text} &\l{\|\|\quad\|\,\|} &\c\, \\ +\l{\Ladd{abg}} &\c\Ladd\ARG{text} &\l{\|\|\quad\|\!\|} &\c\! \\ +\l{\LLadd{abg}} &\c\LLadd\ARG{text} &\OSN{0123456789} &\c\OSN\ARG{digits} \\ +\l{\nexus{abg}} &\c\nexus\ARG{text} &\l{\nesso{abg}} &\c\nesso\ARG{text} \\ +\Utie{AB} &\c\Utie\ARG{2 letters} &\l{a\h b} &\c\h \\ +\l{a\yod b} &\c\yod &\l{a\shwa b} &\c\shwa \\ +\l{a\q b} &\c\q &\l{A\F B} &\c\F \\ +\l{a\f b} &\c\f &\semiv{i} &\c\semiv\ARG{letter} \\ +\hv &\c\skewstack\ARG{base}\ARG{apex}&\md{e} &\c\md\ARG{letter} \\ +\Ud{e} &\c\Ud\ARG{letter} &\mO{e} &\c\mO\ARG{letter} \\ +\UO{e} &\c\UO\ARG{letter} &\Open{e} &\c\Open\ARG{letter} \\ +\nasal{e} &\c\nasal\ARG{letter} &\cut{d} &\c\cut\ARG{b\|d\|g} \\ +\dracma &\c\dracma &\denarius &\c\denarius \\ +\stater &\c\stater &\etos &\c\etos \\ +\hemiobelion &\c\hemiobelion &\tetartemorion &\c\tetartemorion \\ +\splus &\c\splus &\stimes &\c\stimes \\ +\kclick &\c\kclick & & \\ +\end{tabular}% +} +\caption{Extended commands}\label{t:extcomandi} +\end{table} + +\section{Metrics} +Philological writings often require the description of metrics; +for this purpose a new font has been developed that contains most +of the frequent metric signs; the corresponding macros have been +defined so as to set the metric glyphs as if they were text; but, +most important, a new definition command has been introduced so +as to enable to declare new control sequences to represent +complete metric feet or even complete verse metrics. + +The metric glyph names are collected in table~\ref{t:metrics}, +while the declaration command is described hereafter. + +The syntax for that definition command is similar to that of +{\comando\newcommand}; +\[ +\hbox{\comando\newmetrics\ARG{name}\ARG{definition}} +\] +where \Arg{name} is a control sequence name made up of letters +(as usual with \LaTeX) with the exception that it may start with +one of the digits 2, or 3, or 4. Of course the \Arg{definition} +must reflect the replication by 2, or 3, or 4; moreover if the +\Arg{name} starts with a digit, when it is used by the typesetter, +\emph{it must be followed by a space}. Some examples follow: +\begin{quote}\let\c\comando\obeylines% +\c\newmetrics\brArg{\c\iam}\brArg{\c\barbrevis\c\longa\c\brevis\c\longa} +\c\newmetrics\brArg{\c{\2iam}}\brArg{\c\iam\c\iam} +\c\newmetrics\brArg{\c{\4MACRO}}\brArg{\c\longa\c\longa\c\longa\c\longa} +\end{quote} +The above definitions produce the following results (notice the space +before the colon): +\begin{quote}\let\c\comando\obeylines% +\c\iam: \iam +\c{\2iam} : \iam\iam +\c{\4MACRO} : \4MACRO \ +\end{quote} +The definitions may contain also some symbols collected in +table~\ref{t:extcomandi}, such as \dBar, for example, and other +symbols from the other tables. + + +\begin{table}[tb]\let\c\comando +\makebox[\textwidth]{% +\begin{tabular}{llll} +Command & Metric symbol & Command & Metric symbol \\[3pt] +\c\longa & \longa &\c\brevis & \brevis \\ +\c\bbrevis & \bbrevis &\c\barbrevis & \barbrevis \\ +\c\ubarbrevis & \ubarbrevis &\c\ubarbbrevis & \ubarbbrevis \\ +\c\ubarsbrevis & \ubarsbrevis &\c\coronainv & \coronainv \\ +\c\corona & \corona & \c\ElemInd & \ElemInd \\ +\c\catal & \catal &\c\ipercatal & \ipercatal \\ +\c\anceps & \anceps &\c\banceps & \banceps \\ +\c\ancepsdbrevis& \ancepsdbrevis &\c\hiatus\ap{1}& \hiatus \\ +\c\iam\ap{2} & \iam &\c\chor & \chor \\ +\c\enopl & \enopl &\c{\4MACRO} & \4MACRO \ \\ +\c\aeolchorsor & \aeolchorsor &\c\hexam & \hexam \\ +\c{\2tr} & \2tr \ &\c\pentam & \pentam \\ +\c\ubrevislonga & \ubrevislonga &\c\aeolicbii & \aeolicbii \\ +\c\aeolicbiii & \aeolicbiii &\c\aeolicbiv & \aeolicbiv\ap{3} \\ +\end{tabular}% +} +\caption{Metric symbols}\label{t:metrics} +\bigskip +REMARKS\\[3pt]\footnotesize +\ap{1}\quad A similar command \c\Hiatus\ produces the same +visible result as \c\hiatus, except for the fact that it does not +occupy horizontal space; it is useful in the definitions of full +verse metrics where a hiatus needs to be inserted between two +consecutive metric symbols; for example: \longa\Hiatus\longa.\\ +\ap{2}\quad This extension package predefines some examples +of metric feet and complete verses.\\ +\ap{3}\quad Sometimes it might be convenient to use a shortcut +for inserting the Aeolic bases +by inputting \texttt{\char123\comando\metricsfont\ I\char125} or +\texttt{\char123\comando\metricsfont\ II\char125} or +\texttt{\char123\comando\metricsfont\ III\char125} in order to get +\aeolicbii\ or \aeolicbiii\ or \aeolicbiv. +\end{table} + +Another important metric command is the following: +\[ +\hbox{\comando\metricstack\ARG{base}\ARG{superscript}} +\] +which is meant for superimposing some superscript (generally a +number) over some metric symbol, which may be a single symbol or a +metric foot; since the superscript gets printed in math mode, the +superscript hiatus \hiatus\ may be obtained with \comando\Hiatus\ +when it falls between two metric symbols, but must be well +described as a math roman element when it is superscripted over +something else; similarly any other superscript which is not a +math symbol must be suitably set as a math roman object. In any +case this command makes it easy to get something such +as~\metricstack{\longa\brevis\brevis}{48}. + +The environment for setting metric sequences grouped with braces +is described in the next section, since it is generally used within +the composition of verses. + +\section{Poetry environments} +In order to set poetry it is always possible to use the +standard \LaTeX\ \texttt{verse} environment; nevertheless such +simple environment is not suited for philological purposes, except +perhaps for very short citations. This extension package contains +three new environments with various levels of complexity. Due to +their relative complexity an example will be given for each one +with both the input code and the corresponding result. All three +environments require that any language change be declared before +their opening statement, otherwise the language change lasts only +to the end of the verse. + +\begin{description} +\item[\texttt{versi}] This environment does not actually set each +verse on a separate line; it rather resembles an in-line list; it +resorts to a command \comando\verso\ that inserts a small vertical +separator with a progressive number over it. Both the environment +opening and the command \comando\verso\ accept arguments +according to the following syntax: + \begin{quote}\let\c\comando\obeylines + \c\begin\brArg{versi}\ARG{label} + \Arg{verses} + \c\end\brArg{versi} + \null\ + \c\verso\opt{number} + \end{quote} +where \Arg{label} is a short text (let's say not more than 15 +characters) indicating for example the poem title and the stanza +number; the whole set of verses will be typeset with a left margin +wide enough to contain \Arg{label}; the optional argument +\Arg{number} indicates the starting value for the verse +enumeration; the default value is~1, but if it is specified, it is +required only with the first occurrence of \comando\verso\ or when +the enumeration is restarted. In this environment the standard +\LaTeX\ command \comando{\\} behaves normally as in regular text. +\begin{verbatim} +\begin{versi}{Meropis fr. 3} +\item[\textlatin{Meropis fr. 4}] +>'enj'' <o m`en e\ladd{>isplh} \verso[68] j`un +Mer'opwn k'ien. <h \ladd{d`e dia} \verso pr`o\\ +a>iqem\hc i sj~htos \ladd{>'elassen.} +\verso <`o d'' >ex'equt''; o>u +g`ar \ladd{<omo~iai}\\ +\ladd{>a} \verso j'anatai jnhta~isi bol\ladd{a`i kat`a} +\verso ga~ian >'asin.\\ +prh\lladd{m}n\ladd{~hs d\dots} \verso thse. m'elas d`e +perie.\ladd{\dots}\verso +rw +\end{versi} +\end{verbatim} + +\Lipsiakostext +\begin{versi}{Meropis fr. 3} +\item[\textlatin{Meropis fr. 4}] +>'enj'' <o m`en e\ladd{>isplh} \verso[68] j`un +Mer'opwn k'ien. <h \ladd{d`e dia} \verso pr`o\\ +a>iqem\hc i sj~htos \ladd{>'elassen.} \verso <`o d'' >ex'equt''; +o>u +g`ar \ladd{<omo~iai}\\ +\ladd{>a} \verso j'anatai jnhta~isi bol\ladd{a`i kat`a} +\verso ga~ian >'asin.\\ +prh\lladd{m}n\ladd{~hs d\dots} \verso thse. m'elas d`e perie.\ladd{\dots}\verso +rw +\end{versi} +\NoLipsiakostext + +\item[\texttt{Versi}] This environment is very similar to the +standard \LaTeX\ environment \texttt{verse}; the difference is +that \texttt{Versi} automatically enumerates the verses +(displaying only verse numbers that are multiples of 5) with a +number in the left margin. The syntax is as follows: + \begin{quote}\let\c\comando\obeylines + \c\begin\brArg{Versi}\opt{number} + \Arg{verses} + \c\end\brArg{Versi} + \end{quote} +where \Arg{number} is the starting value of the verse enumeration; +of course each verse is separated from the next one with the usual +command \comando{\\}, which has been redefined so that it just +divides the verses and provides to the possible display of the +verse number; it accepts the optional information that the +standard \LaTeX\ command usually accepts, both the asterisk and +the vertical space amount. + + +\NoLipsiakostext + +\begin{verbatim} +\begin{Versi}[45] +ta; pr'osje qeir~wn b'ian\\ +\paragr de\ladd{'i}xomen; +t`a d" >epi'onta da\ladd{'imo}n srine~i.---\\ +t'os" e>'ipen >ar'etaikmos <'hrws;\\ +t{\rbrk}'afon d`e naub'atai\\ +f{\rbrk}wt`os <uper'afanon\\[1ex] +j{\rbrk}'arsos; <Al'iou te gambr~wi q'olwsen >~htor +\end{Versi} +\end{verbatim} + +\Lipsiakostext +\begin{Versi}[45] +ta; pr'osje qeir~wn b'ian\\ +\paragr de\ladd{'i}xomen; +t`a d" >epi'onta da\ladd{'imo}n srine~i.---\\ +t'os" e>'ipen >ar'etaikmos <'hrws;\\ +t{\rbrk}'afon d`e naub'atai\\ +f{\rbrk}wt`os <uper'afanon\\[1ex] +j{\rbrk}'arsos; <Al'iou te gambr~wi q'olwsen >~htor +\end{Versi} +\NoLipsiakostext + +\item[\texttt{VERSI}] This third poetry environment behaves +similarly to \texttt{Versi} but it displays a double verse +enumeration in the left margin. The principal verse enumeration +is displayed when the value is a multiple of 5; the second +enumeration, just to the left of the verses, may be turned on and +off; when the secondary enumeration is on, the verses are flush +left, while when it is off the verses are suitably indented. The +turning on and off of the secondary enumeration is achieved by +means of the commands \comando\SubVerso\ and \comando\NoSubVerso; +the syntax is as follows: + \begin{quote}\let\c\comando\obeylines + \c\begin\brArg{VERSI}\opt{outer number} + \Arg{verses} + \c\end\brArg{VERSI} + \null{} + \c\SubVerso\opt{inner number} + \c\NoSubVerso{} + \end{quote} +where \Arg{outer number} is the starting value of the primary +verse enumeration, while \Arg{inner number} is the starting value +of the secondary enumeration. The commands \comando\SubVerso\ and +\comando\NoSubVerso\ must be input at the very beginning of the +verse they should be applicable to. The command \comando{\\} behaves +as in \LaTeX, and accepts the usual optional arguments. + +With the environments \texttt{Versi} and \texttt{VERSI} when typesetting in two +column format, you have the possibility of specifying \comando\BreakVersitrue\ +(and of course \comando\BreakVersifalse) for allowing (or disallowing) line +breaks of verses; broken verses are continued in the next line with a +generous indentation so as to recognize them as belonging to the same verse; +the verse counter is not incremented when breaking verses across lines. + +\NoLipsiakostext + +\begin{verbatim} +\begin{VERSI}[40] +k'elomai pol\ua stonon\\ +\SubVerso[18] +>er'uken <'ub\apex rin; o>u g`ar >`an j'eloi-\\ +\NoSubVerso +m'' >'ambroton >erann`on >Ao\lbrk ~us\\ +\SubVerso +>ide~in f'aos, >epe'i tin'' >h"ij\siniz{'e\lbrk w}n\\ +s`u dam'aseias >a'ekon-\\ +\NoSubVerso +ta; pr'osje qeir~wn b'ian\\ +\SubVerso +\paragr de\ladd{'i}xomen; +t`a d'' >epi'onta da\ladd{'imw}n krine~i.\GEcdq\\ +\SubVerso[1] +t'os'' e>~ipen >ar'etaiqmos <'hrws;\\ +t\rbrk 'afon d`e na\ua batai\\ +f\rbrk wt`os <uper'afanon\\ +j\rbrk 'arsos;\Dots[4] +\end{VERSI} +\end{verbatim} + +\Lipsiakostext +\begin{VERSI}[40] +k'elomai pol\ua stonon\\ +\SubVerso[18] +>er'uken <'ub\apex rin; o>u g`ar >`an j'eloi-\\ +\NoSubVerso +m'' >'ambroton >erann`on >Ao\lbrk ~us\\ +\SubVerso +>ide~in f'aos, >epe'i tin'' >h"ij\siniz{'e\lbrk w}n\\ +s`u dam'aseias >a'ekon-\\ +\NoSubVerso +ta; pr'osje qeir~wn b'ian\\ +\SubVerso +\coronis de\ladd{'i}xomen; t`a d'' >epi'onta da\ladd{'imw}n krine~i.\GEcdq\\ +\SubVerso[1] +t'os'' e>~ipen >ar'etaiqmos <'hrws;\\ +t\rbrk 'afon d`e na\ua batai\\ +f\rbrk wt`os <uper'afanon\\ +j\rbrk 'arsos;\Dots[4] +\end{VERSI} +\NoLipsiakostext +\item[\texttt{bracedmetrics}] This is an environment different +from the preceding ones, although it always deals with verses. +Its purpose is to set the verse metric lines grouped with a right +brace, so as to show the variants of a certain metric scheme. + +In order to align the metric variants and in order to place the +right brace in the proper place it is necessary to fix specific +lengths in terms of a unit that is compatible with the metric +symbols; therefore the syntax of such spacing command and of the +environment itself is the following + \begin{quote}\let\c\comando\obeylines + \c\begin\brArg{bracedmetrics}\ARG{length} + \Arg{metric lines} + \c\end\brArg{bracedmetrics} + \null + \c\verseskip\ARG{number} + \end{quote} +where \Arg{number} specifies the number of metric symbols the +\comando\verseskip\ should be equivalent to. Approximately the +\comando\verseskip\ will be as long as a sequence of \Arg{number} +long syllables; the \Arg{length} specified as the width of the +environment should equal the longest metric line contained in the +block, and should be specified by means of the +\comando\verseskip\ command with its argument; but since the +metric symbols are not all of the same length, it is wise to +count the symbols of the longest metric line and to add a couple +of units; after producing the first draft it is possible to review +the number specified as the argument of \comando\verseskip. Of +course the same \comando\verseskip\ command may be used to align +the various fragments of metric lines within the environment. +Examine the following example of input code: +\begin{verbatim} +\begin{verse} + \brevis\svert\longa\brevis\brevis\longa + \brevis\brevis\longa\svert\longa\\ + \begin{bracedmetrics}{\verseskip{13}} + \Hfill \brevis\svert\longa\brevis\longa + \svert\longa\\ + \longa\brevis\brevis\longa\brevis\brevis + \zeugma{\longa\svert\longa}\\ + \Hfill\longa\brevis\longa\svert\longa + \verseskip{2}\\ + \Hfill\longa\brevis\longa\dBar + \end{bracedmetrics}\\ + \begin{bracedmetrics}{\longa\brevis\brevis\longa + \brevis\brevis\longa\svert\longa} + \longa\brevis\brevis\longa\brevis\brevis + \longa\svert\longa\\ + \longa\brevis\brevis\longa\brevis\brevis\longa + \end{bracedmetrics}\\ +\verseskip{7}\brevis\brevis\longa\svert\ubarbrevis\tBar +\end{verse}% +\end{verbatim} +which produces: +\begin{verse} + \brevis\svert\longa\brevis\brevis\longa + \brevis\brevis\longa\svert\longa\\ + \begin{bracedmetrics}{\verseskip{13}} + \Hfill \brevis\svert\longa\brevis\longa\svert\longa\\ + \longa\brevis\brevis\longa\brevis\brevis + \zeugma{\longa\svert\longa}\\ + \Hfill\longa\brevis\longa\svert\longa\verseskip{2}\\ + \Hfill\longa\brevis\longa\dBar + \end{bracedmetrics}\\ + \begin{bracedmetrics}{\longa\brevis\brevis\longa + \brevis\brevis\longa\svert\longa} + \longa\brevis\brevis\longa\brevis\brevis\longa\svert\longa\\ + \longa\brevis\brevis\longa\brevis\brevis\longa + \end{bracedmetrics}\\ +\verseskip{7}\brevis\brevis\longa\svert\ubarbrevis\tBar +\end{verse}% + + +\end{description} + +\section*{Acknowledgements} +I warmly thank Paolo Ciacchi for his patience in driving me along the path of +philological typography, which was totally unknown to me. He patiently chose +examples from the best printed books, scanned them and sent them to me by +e-mail; he patiently pointed out the flaws of my programming and suggested +ameliorations. Recently this young man discussed his master thesis, and I am +sure that his deep love for ancient classics will drive him to a position where +he will have all the satisfactions he deserves. + +%And up to date \texttt{teubner.sty} is not finished yet! +\begin{flushright} +Turin, 2004/09/03 +\end{flushright} +\end{document} |