1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
|
THE TEUBNER PACKAGE VERSION 5/0 OF NOVEMBER 2020
EXTENSION FOR PHILOLOGICAL TYPESETTING
Copyright 2001-2004-2020 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
dated 2008-05-04 or later as it appears in
CTAN/macros/latex/base/lppl.tex.
This bundle contains the following files
README short information abut installing this bundle
teubner.txt this file
teubner.dtx documented TeX file
teubner-doc.tex documentation file
teubner.pdf technical documentation
teubner-doc.pdf usage 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.
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.0 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
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.
Some time ago Antonis Tsolomitis uploaded the package txfontsb which
adds the possibility of using nice TX compatible Greek fonts when using
the TX latin fonts so as to let the users typeset their documents in
mixed script. The upright shape resembles the traditional Didot one,
and the italic shape resembles the Lipsian one; they come in both the
medium and the bold series and match the TX latin fonts pretty well.
They probably match also the newer newtxtext fonts by Michael Sharpe,
but since the latter have different font family names, the automatically
produced .fd files for adapting the LGR encoded fonts to the TX fonts
are not suited for the newtxtext fonts; in order to have matching .fd
files it is necessary to proceed in the same way as with any other font
collection different from the TX one; the procedure is described in the
teubner-doc.pdf document.
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
specified the TX fonts by calling the txfonts package.
In order to use this extension package with LaTeX you have to
install it. May be the very installation of your (recent) TeX system
distribution 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 the default complete one) run tlmgr.
If you feel more comfortable to do everything by yourself and/or want to
make a personal installation, run teubner.dtx through pdflatex; the
generated files are teubner.sty and the aforementioned teubnertx.sty
file; they must be moved where TeX-the-program can find them. This
depends very much on your particular implementation of the TeX system,
but if your system copes with the TDS (standard TeX Directory Structure)
and has a multiplicity of different TeX directory trees, you probably
have a \localtexmf rooted TDS, or a /texmf one in your Home directory
containing a tex directory tree which on turn contains a latex directory.
Under the latter one create a new directory named, say, teubner, and
move to this folder the teubner.sty, and teubnertx.sty files.
I suggest you to create a directory /teubner in the /doc directory of
the locally rooted structure and move there both teubner-doc.pdf and
the teubner.pdf file that you get by running pdflatex directly on
teubner.dtx.
For what concerns fonts, they should already be installed with a recent
TeX system distribution; this means that there are already all the
files TeX-the-program needs in order to do its work; there is one
point, though, that requires full attention; the default basic TeX
system installation loads only the PostScript fonts in size 10pt; all
other sizes are obtained by reducing or enlarging that single size.
A complete TeX system installation does not exhibit this limitation.
There are also non standard scalable Type 1 fonts, such for example, the
Fourier ones, that come only in one size, the 10pt one; for these
fonts it is not strictly necessary to do the same with the sizes of the
CBfonts, but if you prefer you can.
In any case the teubner package copes with this situation if you specify
the "10pt" option when calling this package, but if you want to have
perfect optical sizes, then you should download from CTAN the full
collection and install it in your computer. The details for this
installation require you read with due attention the instructions that
come with your TeX system distribution; it's not difficult, but it
requires to be very careful at every step. Remember, though, that your
Package Manager can do all the work for you.
It's important to control that you have the latest CBfonts; even if you
got them pre-installed with your TeX system distribution, may be they
are not the latest version. The full collection has been redone in
the year 2007, and partially upgraded in 2010; the reduced collection is
a subset of the full one. Earlier distributions, dated at least 2002,
might be compatible, but if you notice something strange with the CBfonts,
verify if your fonts are up to date.
Another question you might ask yourself: is my TeX system complete and
up to date? The fact you installed a TeX system and you did not have the
CBfonts may be an index that you still have the babel package locked at
a version number earlier than 3.9g. I suggest you to upgrade your TeX
system to the most up to date one you can find on CTAN.
This point is connected with the question of the updated metric files
related to the Lipsian fonts; if your TeX system distribution has been
updated to what was available on CTAN by May 2010, your distribution
already contains the updated .tfm files. Otherwise, please, update your
CBfonts.
After all these steps are done, you are ready to use your teubner
extensions; it will not be easy at the beginning, because there are
hundreds of new commands. Be sure to have already thoroughly read the
documentation file teubner-doc.pdf and that you have a hard copy close
to you.
Remember, though, that most commands are Latin names or abbreviations
that should be familiar to any philologist specialised in classical/
ancient European languages, such as classical Greek, Latin, and so on.
This set of extension commands has been tested in several documents;
Since I am neither a philologist nor a Greek scholar, I prepared them as
a *hobby* while trying to help a philologist friend. I hope this package
may be useful also to you, but I must disclaim any liability for any
unwanted results you might get, including the most dreadful possible
things that may happen to anybody using a computer.
I will not write down any strong disclaimer sentence in capital letters,
because it should be absolutely evident that I did something I consider
useful, but is up to you to decide to use it and face the consequences
(... which, nevertheless, I hope they are what you expected).
If you find this package of some utility but you find some errors and/or
some glitches, please write me an e-mail (see below). If you'd like me
to realise some other commands, please send me by e-mail your request
together with a scanned image containing the visual result you'd like to
obtain. I don't guarantee I'll be able to satisfy your request, but I'll
give it a try. In any case don't ask for things LaTeX can't do; and if
you use LaTeX, you know what are its pros and cons.
Happy philological LaTeXing!
Claudio Beccari November 2020
Professor Emeritus
Politecnico di Torino, Italy
claudio dot beccari at gmail dot com
PS: My former professorship is in electronics, just to stress the
point that I am not a philologist, therefore beware: this work might
simply be "trash" to the eyes of a real philologist!
|