summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/teubner/teubner.txt
blob: d3732df0c1e9cec3fc5b9a8fd10e76ee66f99581 (plain)
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
             THE TEUBNER PACKAGE VERSION 3.4a OF SEPTEMBER 2013
                 EXTENSION FOR PHILOLOGICAL TYPESETTING


Copyright  2001-2004-2013 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

By running pdflatex on teubner.dtx in addition to the documentation file 
teubner.pdf,  the byproduct files teubner.sty, teubnertx.sty, LGRaccents-
glyphs.def are generated; teubner-doc.pdf  must be generated  by running 
pdflatex on the source file teubner-doc.tex file. The two mentioned .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 3.x of the teubner package contains many new enhancements, among 
which  it's worth  noting  the new  extended  accent macros  (that avoid 
kerning  problems  that might show up using the ligature  mechanism) and 
the  new  macros  that allow  to use  the LGR  encoded  CBgreek fonts in 
conjunction  with other  PostScript  scalable  fonts;  the compatibility 
with the Times eXtended  and  the  Palatino  eXtended  fonts, accessible  
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 the teubner package.

While this package was upgraded and uploaded to CTAN, 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.  

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  file the
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  it;  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 LGRaccents-glyphs.def,  besides 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 
root directory structures,  you probably  have a  \localtexmf rooted TDS, 
or a /texmmf one in your Home directory containing a tex directory which 
on turn contains  a latex directory.  Under the latter one  create a new 
directory named, say, teubner, and move there teubner.sty, teubnertx.sty, 
and LGRaccents-glyphs.def.

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
teubner.pdf  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 n eeds  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 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 todo 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;  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.7. I suggest you to upgrade  your TeX
system to the most up to date one you can find on CTAN.

Connected  to this point  there is  the question  of the updated  metric 
files related to the Lipsian  fonts; if your TeX system distribution has 
been updated to what is 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 the hard copy close 
to you. 

Remember,  though,  that most commands  are Latin names or abbreviations 
that  should  be familiar  to any philologist  specialized in classical/
ancient European languages, such as classical Greek, Latin, et cetera.

This set of extension  commands  has been tested  in several  documents;
nevertheless I prepared them as a hobby, trying to help a friend philolo-
gist. 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 worst  
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 by e-mail (see below).  If you'd like me 
to realize 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                             Turin, 29 of September 2013
Former Professor of Electronics
Politecnico di Torino, Italy
claudio dot beccari at gmail dot com

PS: I underline  my former  professorship  in electronics,  in order to 
stress  the point  that I am not  a philologist, therefore beware: this 
work might be simply "trash" to the eyes of a real philologist!