summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/teubner
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2022-08-28 19:53:21 +0000
committerKarl Berry <karl@freefriends.org>2022-08-28 19:53:21 +0000
commitaafcfaa73eef83820b5eaaf6c1da363c530331da (patch)
tree44a53894e1fab3837f483b033588fcf70db680f4 /Master/texmf-dist/doc/latex/teubner
parent2ebf3159c9c1bc2d15a019c44c7e6eb4d1b4923e (diff)
teubner (28aug22)
git-svn-id: svn://tug.org/texlive/trunk@64217 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/teubner')
-rw-r--r--Master/texmf-dist/doc/latex/teubner/README40
-rw-r--r--Master/texmf-dist/doc/latex/teubner/teubner-doc.pdfbin400279 -> 433138 bytes
-rw-r--r--Master/texmf-dist/doc/latex/teubner/teubner-doc.tex38
-rw-r--r--Master/texmf-dist/doc/latex/teubner/teubner.pdfbin624428 -> 670825 bytes
-rw-r--r--Master/texmf-dist/doc/latex/teubner/teubner.txt60
5 files changed, 78 insertions, 60 deletions
diff --git a/Master/texmf-dist/doc/latex/teubner/README b/Master/texmf-dist/doc/latex/teubner/README
index cc4b9fbb4a7..097e845f1d2 100644
--- a/Master/texmf-dist/doc/latex/teubner/README
+++ b/Master/texmf-dist/doc/latex/teubner/README
@@ -1,6 +1,6 @@
-This accompanies the teubner bundle version 5.4 dated February 2021 or later.
+This accompanies the teubner bundle version 6.x dated November 2020 or later.
-Copyright 2010-2021 Claudio Beccari
+Copyright 2010-2020 Claudio Beccari
The bundle contains the files
@@ -11,40 +11,40 @@ teubner-doc.tex an extended documentation file
teubner.pdf general and technical documentation
teubner-doc.pdf specific documentation with examples
-The bundle is distributed under the LPPL license version 1.3c or any later version.
+The bundle is distributed under the LPPL license version 1.3c or any later
+version.
The bundle has the status of author maintained.
The main purpose of this bundle is to provide classical philologists with
some means for typesetting their documents that usually contain very
specific mark up.
-This version allows the typesetter to use both "italic" shapes: the Olga-like
-and the Lipsian-like ones; it complies with the LICR (LaTeX Internal
-Character Representation) of the Greek glyphs that avoid the kerning problems
-that arise with the ligature mechanism embedded in the LGR encoded default
-CBfonts; it is compatible with the use of different vector Latin Type 1
-fonts; contains new designs for the horizontally stretchable markers, et
-cetera.
+This version allows the typesetter to use both "italic" shapes: the
+Olga-like and the Lipsian-like ones; it complies with the LICR (LaTeX
+Internal Character Representation) of the Greek glyphs that avoid the
+kerning problems that arise with the ligature mechanism embedded in the
+LGR encoded default CBfonts; it is compatible with the use of different
+vector Latin Type 1 fonts; contains new designs for the horizontally stretchable markers, et cetera.
Running pdflatex on the .dtx file produces both the documentation and
extracts the byproduct files teubner.sty, teubnertx.sty, teubner.pdf.
The readable extended documentation file teubner-doc.pdf is obtained by
running pdflatex on the teubner-doc.tex file.
-Moreover this teubner package generates on the fly the font description files
-necessary to use the LGR encoded Greek fonts with some non standard TeX
-PostScript fonts; for example, it automatically generates the necessary
+Moreover this teubner package generates on the fly the font description
+files necessary to use the LGR encoded Greek fonts with some non standard
+TeX PostScript fonts; for example, it automatically generates the necessary
files if using the TX or the PX fonts; with other Type 1 fonts the
necessary .fd files require manual intervention, which simply means giving
a suitable command from within another open file that loads teubner.
-Please, be sure to work with a *2010* updated collection of the CBfonts;
-moreover with a *2019* or later updated version of the TeX system; with a
-babel version 3.9g or later; with the language description file greek.ldf
-version 1.9b or later; package teubner, version 5.2 and later, patches the
-modifications of greek.ldf 1.10 so as cope with the ancient Greek numbering
-system. The teubner package does not work with previous versions of
-the above pieces of software; it may even produce fatal errors; therefore be sure to work only with a complete and up-to-date TeX system installation.
+Please, be sure to work with a 2010 updated collection of the CBfonts;
+with a *2020* updated version of the TeX system; with a babel version
+3.9g or later; with the language description file greek.ldf version 1.9b
+or later; teubner version 6.2 and later patches the modifications of
+greek.ldf 1.10 so as cope with the ancient Greek numbering system. The
+teubner package works also with previous versions of the above pieces of
+software, but with limited performances.
Claudio Beccari
claudio dot beccari at gmail dot com \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/teubner/teubner-doc.pdf b/Master/texmf-dist/doc/latex/teubner/teubner-doc.pdf
index b9b8b39554d..99117e0e594 100644
--- a/Master/texmf-dist/doc/latex/teubner/teubner-doc.pdf
+++ b/Master/texmf-dist/doc/latex/teubner/teubner-doc.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/teubner/teubner-doc.tex b/Master/texmf-dist/doc/latex/teubner/teubner-doc.tex
index c0e8e11d499..a0928ce0c19 100644
--- a/Master/texmf-dist/doc/latex/teubner/teubner-doc.tex
+++ b/Master/texmf-dist/doc/latex/teubner/teubner-doc.tex
@@ -41,17 +41,20 @@
\usepackage{graphicx}
\usepackage{microtype}
\usepackage{multicol}
-\title{\texttt{teubner.sty}%
-\thanks{This paper documents \texttt{teubner.sty} version \fileversion\ of \filedate.}\\
-A package to extend the \textsf{greek} option\\ of the \babel\ package}
+\title{\texttt{teubner}%
+\thanks{This paper documents \texttt{teubner} version \fileversion\ of \filedate.}\\
+An extension for Greek philology\\
+User manual}
\author{Claudio Beccari\thanks{\texttt{claudio dot beccari at gmail dot com}}}
-\date{February 2021}% <---- this is the date of the teubenr-doc document!
+\date{August 2022}% <---- this is the date of the teubenr-doc document!
\def\comando#1{\expandafter\texttt\expandafter{\string#1}}
\def\cs#1{\texttt{\char92#1}}
\def\ARG#1{\texttt{\char123}\meta{#1}\texttt{\char125}}
\def\meta#1{$\langle${\normalfont\itshape#1}$\rangle$}
\let\marg\ARG\let\Arg\meta
\def\Marg#1{\texttt{\char123#1\char125}}\let\brArg\Marg
+\def\oarg#1{\texttt{[\meta{#1}]}}
+\def\Oarg#1{\texttt{[#1]}}
\def\opt#1{\texttt{[}\meta{#1}\texttt{]}}
\def\g#1 {\textDidot{#1}}
\def\l#1 {\textLipsias{#1}}
@@ -78,6 +81,8 @@ A package to extend the \textsf{greek} option\\ of the \babel\ package}
\DeclareRobustCommand*\setfontsize[2][1.2]{%
\linespread{#1}\fontsize{#2}{#2}\selectfont}
+\listfiles
+
\begin{document}\errorcontextlines=20
@@ -118,7 +123,6 @@ Since \pack{teubner} is a module that adds to the |greek.ldf| support for \pack{
\section{Package options}
The options available to \pack{teubner} are collected in table~\ref{t:opzioni} with their meaning and usefulness.
-
\begin{table}
\thrule
\centering\def\R{\rule[-1ex]{0pt}{3ex}}\let \i\itshape
@@ -218,9 +222,11 @@ You can see that the family name \texttt{futs}, corresponding to the regular Fou
Notice the \verb|\Lipsiantrue| command before issuing the matching command \verb|\ifFamily}|. This command is optional and is used only if the composer wishes to use the Lipsian fonts; in this case the \texttt{li} shape is also defined, so that the \verb|\textli| and
\verb|\lishape| commands do not issue any error message. At the end of the execution of the \verb|\ifFamily| command, the boolean switch is automatically reset to \verb|\Lipsianfalse|.
-\noindent\textbf{Warning}: According to several maintainers of the language support packages, the procedure used with \verb|\ifFamily|, that produces in the local working directory a real, permanent \texttt{.fd} file, is not the best approach to create such pairing of fonts. G\"unter Milde, for example, produced a \pack{substitutefontfamily} package that defines the command \comando\subtitutefontfamily\ which creates a similar association, but does not write anything to the disk; simply the created association declarations are stored in the job memory, so that when the typesetting job is over, no traces remain on disk; this certainly avoids clogging the disk with the same files scattered all over in different directories that were the working ones for different typesetting jobs.
+\noindent\textbf{Warning}: According to several maintainers of the language support packages, the procedure used with \verb|\ifFamily|, that produces in the local working directory a real, permanent \texttt{.fd} file, is not the best approach to create such pairing of fonts. G\"unter Milde, for example, produced a \pack{substitutefontfamily} package that defines the command \comando\subtitutefontfamily\ which creates a similar association, but does not write anything to the disk; simply the created association declarations are stored in the \TeX\ working memory, so that when the typesetting job is over, no traces remain on disk; this certainly avoids clogging the disk with the same files scattered all over in different directories that were the working ones for different typesetting jobs.
+
+\noindent\textbf{A small caveat}: when you issue for the first time the \verb|\ifFamily| command you might not see the expected result (while with Milde's package you immediately obtain the expected result), and your Greek text might be typeset with the default “Greek error font”. But the second time you typeset your document the expected result is obtained with the correct fonts. This is because with the very first run a new font description file is generated, and this file will be available only in subsequent typesetting runs.
-A small caveat: when you issue for the first time the \verb|\ifFamily| command you might not see the expected result (while with Milde's package you immediately obtain the expected result), and your Greek text might be typeset with the default “Greek error font”. But the second time you typeset your document the expected result is obtained with the correct fonts. This is because with the very first run a new font description file is generated, and this file will be available only in subsequent typesetting runs.
+\noindent\textbf{Another warning}: this \pack{teubner} package sometimes uses the “bold not extended” series, typical with the Lipsian fonts, so as to better match their medium blackness with darker fonts such as, for example, the Times extend ones. Sometimes the Lipsian shape is in force, but the metric symbols (see below) are also used, but such fonts lack the Lipsian shape. It might happen that you use some math symbols; the math symbols with \pdfLaTeX\ do not have anything similar to the Lipsian shape.In such cases the typesetting program issues a warning and at the end of the job you might read in the \texttt{.log} file a message such as \emph{Some font shapes were not available, defaults substituted.} No worry; the message is correct, but no errors are actually visible in the output PDF file. See below what you can do if you find such warning messages as “annoying” ones.
Nevertheless this does not imply that the correct fonts are used if the font switching macros are used without scoping groups or environments. Sometimes, when you use declarations instead of commands, it might be necessary to issue an apparently redundant \verb|\rmfamily| or \verb|\selectfont| command in order to re-establish the correct defaults.
@@ -229,13 +235,17 @@ In order to insert \emph{short texts} in Greek, either in Didot upright or in Li
The \emph{text commands}, contrary to the corresponding \emph{text declarations}, typeset their argument within a group, so that the font characteristics are also correctly restored after the command execution is completed.
-Therefore I suggest you to either use the text commands or to use the declarations as environment names (without the initial backslash), so that they provide the necessary group delimiters; it is syntactically correct and useful to input something such as:
+Therefore we suggest you to either use the text commands or to use the declarations as environment names (without the initial backslash), so that they provide the necessary group delimiters; it is syntactically correct and useful to input something such as:
\begin{quote}
\verb|\begin{Lipsiakostext}|\\
\meta{Greek text to be typeset with the Lipsian font}\\
\verb|\end{Lipsiakostext}|
\end{quote}
+Some authors have defined themselves the environments \amb{GRD} and \amb{GRL} to typeset longer texts with Didot or, respectively, Lipsian fonts and such definitions are included in the \pack{teubner} package; see the documentation of the code in the \file{teubner.pdf} file.
+
+Such environments have been tested with the Latin Modern, extended Times and extended Palatino fonts and with the standard classes besides the \class{memoir} and \class{scrbook} ones. No kludges were necessary with the Latin Modern fonts and the standard classes; some kludges were necessary in order to get the expected results with the other tested fonts and classes; such kludges are described in the above code documentation file. They are not complicated, but users that use different fonts and/or different classes might need to apply similar kludges to their software.
+
\section{Font installation}
In order to use the Greek CB fonts and the facilities provided by this
@@ -307,7 +317,7 @@ Greek diacritical marks; extended accent macros are also shown; notice that a co
\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 commands \verb|\M| and \verb|\B| respectively when typesetting in Greek in order to use them as single diacritics; for more than one diacritic superimposed to one another, when macrons and breves are involved, some other commands are available as shown in table~\ref{t:accentmacros}.
-
+f
The new (2013) Greek support for \babel\ contains now the LICR encoded accent macros that allow to use any encoding input method, including direct input of Greek characters. The internal representation of accent macros resorts to the same symbols shown in table~\ref{t:accenti}; simply they are prefixed by a backslash and/or the accent sequence is prefixed with one backslash; therefore \textDidot{>'a|} may be obtained with \verb+>'a|+, or \verb+\>\'a|+, or \verb+\>'a|+. The last form is to be preferred with some shapes as discussed in the following paragraphs. But the LICR (\LaTeX\ Internal Character Representation) is much more than this; it separates the input encoding from the output font encoding, so that direct literal greek input is possible (of course with the \opt{utf8} encoding) and the output is useful for both LGR encoded 8-bit fonts and the UNICODE encoded OpentType fonts; this way \pack{babel} and the Greek support for \babel, provided by the new \file{greek.ldf}, may be used also with \XeLaTeX\ and \LuaLaTeX. Moreover now (October 2014) file \file{greek.ldf} can select the ancient Greek hyphenation when typesetting with \pdfLaTeX\footnote{This is why with this release of the \pack{teubner} package, the default language attribute is set to \texttt{ancient}.}; with \pack{polyglossia} this possibility was available from the very beginning of the Greek support by this package.
The 2020 version of the \file{greek.ldf} file introduces some new coding incompatible with the extension provided by this module (up to version~48) to get Greek Milesian and Attic numerals. From \pack{teubner} version~5.0, the LICR codes used by the new \file{greek.ldf} file are extended in oder to get Greek numerals that use the ancient glyphs, and therefore some macros are redefined. On the occasion of this update, the necessary macros for the Greek numerals have been redefined by means of the \LaTeX\,3 language through the interface macros previously defined by the \pack{xparse} package and now (2020) integral part of the \LaTeX\ kernel; see below for further details.
@@ -563,8 +573,15 @@ This package introduces many new commands for typesetting Greek in a philologica
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 something 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.
+Please, read the \file{teubner.pdf} file for what concerns command \cs{LLadd}; it accepts two optional kerning values in order to adapt the internal spaces in accordance with the nature of the \meta{text} argument; with capital letters and/or sloping fonts, such kerning values may come handy for a perfect final result.
+Its new syntax is the following:
+\begin{quote}
+\cs{LLadd}\oarg{left kerning}\marg{text}\oarg{right kerning}
+\end{quote}
+where both kerning values imply a reduction of space if they are specified as positive values; use o font size units, such as \texttt{ex} or \texttt{em} are recommended, since they assure the automatic correct value even when changing font size.
-\begin{table}[!p]\thrule%\centering
+
+\begin{table}[!p]\thrule
\let\c\comando
\resizebox*{\textwidth}{!}{\footnotesize
\begin{tabular}{cl|cl}
@@ -1006,5 +1023,4 @@ which produces:
\section*{Acknowledgements}
This project was initially carried on with the help of Mr Paolo Ciacchi when he was writing his ancient Greek philology master thesis. After he got his master's degree at the University of Trieste, I continued by myself, but I remain really indebted to Mr~Ciacchi.
-
\end{document}
diff --git a/Master/texmf-dist/doc/latex/teubner/teubner.pdf b/Master/texmf-dist/doc/latex/teubner/teubner.pdf
index 2440e1eb7dd..362ca69f6a3 100644
--- a/Master/texmf-dist/doc/latex/teubner/teubner.pdf
+++ b/Master/texmf-dist/doc/latex/teubner/teubner.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/teubner/teubner.txt b/Master/texmf-dist/doc/latex/teubner/teubner.txt
index 64db196c6fc..1c088910a26 100644
--- a/Master/texmf-dist/doc/latex/teubner/teubner.txt
+++ b/Master/texmf-dist/doc/latex/teubner/teubner.txt
@@ -1,9 +1,9 @@
- THE TEUBNER PACKAGE VERSION 5.4 OF FEBRUARY 2021
+ THE TEUBNER PACKAGE VERSION 5.7 OF AUGUST 2022
EXTENSION FOR PHILOLOGICAL TYPESETTING
-Copyright 2001-2004-2021 Claudio Beccari
+Copyright 2001-2022 Claudio Beccari
The programs contained in this bundle can be distributed and/or modified
under the terms of the LaTeX Project Public License (LPPL), version 1.3c
@@ -13,40 +13,42 @@ dated 2008-05-04 or later as it appears in
This bundle contains the following files
-README short information abut installing this bundle
+README short description of this bundle
teubner.txt this file
-teubner.dtx documented TeX file
-teubner-doc.tex documentation file
+teubner.dtx technical documented TeX source file
+teubner-doc.tex user documentation TeX source file
teubner.pdf technical documentation
-teubner-doc.pdf usage documentation
+teubner-doc.pdf user documentation
-By running pdflatex on teubner.dtx in addition to the documentation
-file teubner.pdf, the byproduct files teubner.sty, teubnertx.sty, are
-generated; teubner-doc.pdf must be generated by running pdflatex on the
-source file teubner-doc.tex file.
+By running pdflatex on teubner.dtx in addition to the technical
+documentation file teubner.pdf, the byproduct files teubner.sty,
+ teubnertx.sty, are generated; teubner-doc.pdf must be generated
+ by running pdflatex on the source file teubner-doc.tex source file.
These two .pdf files are already contained in the bundle.
File teubner-doc.pdf is the documentation file that shows what can be
done with this extension package and displays several examples.
-Version 5.2 of the teubner package is compliant with the Greek language
-support to babel version 3.9g, that makes use of the encoding independent
-LICR (LaTeX Internal Character Representation) of the Greek characters &
-diacritics; it contains also the macros that allow using the LGR encoded
-CBfonts together with other PostScript scalable fonts; the compatibility
-with the Times and the Palatino eXtended fonts, through the packages
-txfonts and pxfonts, are already built in; the compatibility with the
-Latin Modern fonts was already available with version 2.x of this package.
-With the upgrade of the Greek support to babel through file greek.ldf
-version 1.10, teubner package versions previous to 5.0 became unable to
-transform Arabic numerals into the classical Milesian and Attic number
-representations. From version 5.0 the teubner package has been patched
-in order to re-establish the above number transformations; some other
+Versiosn 5.2 and later of the teubner package is compliant with the Greek
+language support to babel version 3.9g, that makes use of the encoding
+independent LICR (LaTeX Internal Character Representation) of the Greek
+characters & diacritics; it contains also the macros that allow using
+the LGR encoded CBfonts together with other PostScript scalable fonts;
+the compatibility with the Times and the Palatino eXtended fonts,
+through the packages txfonts and pxfonts, are already built in; the
+compatibility with the Latin Modern fonts was already available with
+version 2.x of this package.
+
+With the upgrade of the Greek support to babel through file greek.ldf
+version 1.10, teubner package versions previous to 5.0 became unable to
+transform Arabic numerals into the classical Milesian and Attic number
+representations. From version 5.0 the teubner package has been patched
+in order to re-establish the above number transformations; some other
improvements have been added that are transparent to the end user, since
-they deal with the package internal workings. But these improvements
-require a recent installation of the TeX system, because they use
+they deal with the package internal workings. But these improvements
+require a recent installation of the TeX system, because they use
interfaces to the new LaTeX 3 language; the minimum date of the LaTeX
-kernel should not be earlier than January 2019.
+kernel should not be earlier than January 2020.
Some time ago Antonis Tsolomitis uploaded the package txfontsb which
adds the possibility of using nice TX compatible Greek fonts when using
@@ -66,7 +68,7 @@ Although Tsolomitis' fonts satisfy very well the everyday typesetting
necessities of the Greek users and blend well also with the TX math
fonts, they do not satisfy the requirements of the teubner package. This
is why the processing of the teubner.dtx file generates also the file
-teubnertx.sty that is being input at begin document time if the user
+teubnertx.sty that is being input at begin document time when the user
specified the TX fonts by calling the txfonts package.
In order to use this extension package with LaTeX you have to install it.
@@ -75,7 +77,7 @@ already provided for this task; may be your TeX system is configured to
load missing packages on the fly. In any case you can check and possibly
run your Package Manager (with MiKTeX follow the path:
Programs|MiKTeX Settings|Packages;
-with TeXlive and MacTeX (if their installation configuration was not
+with TeXlive and MacTeX (if their installation configuration was not
the default complete one) run tlmgr.
If you feel more comfortable to do everything by yourself and/or want to
@@ -167,7 +169,7 @@ you use LaTeX, you know what are its pros and cons.
Happy philological LaTeXing!
-Claudio Beccari February 2021
+Claudio Beccari
Professor Emeritus
Politecnico di Torino, Italy
claudio dot beccari at gmail dot com