summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/teubner/README
blob: 86b7d308de4486bdffa862ad168ecdc747759f5d (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
                 EXTENSION FOR PHILOLOGICAL TYPESETTING


Copyright  2001-2006 Claudio Beccari

The programs contained  in  this  bundle  can  be  redistributed  and/or
modified   under   the   terms  of  the  LaTeX  Project  Public  License
Distributed from CTAN  archives in directory macros/latex/base/lppl.txt;
either version 1.3 of the License, or any later version.

This bundle contains the following files

teubner.txt          this file
teubner.dtx          documented TeX file
teubner.ins          installation file
teubner-doc.pdf      documentation file
teubner-doc.tex      source documentation file

File teubner-doc.pdf  is  the  documentation  file  that  shows what can
be done with this  extension  package  and  displays  several  examples.
The first edition of this file could not resort to scalable type 1 Greek
fonts  (2001);  by  the  end  of 2002 such fonts were available on CTAN,
therefore this edition not only reports  the enhancements  introduced in
version 2.0 but also it displays and prints perfectly.

In  order  to  use  this  extension  package  with  LaTeX  you  have  to
install  it.  Run  teubner.ins  through  LaTeX;  the  generated  file is
teubner.sty and must be  moved  where  TeX  the  program  can  find  it.
This  depends  very  much  on  your  particular  implementation  of  the
TeX   system,   but   if   your  system  copes  with  the  standard  TeX
directory  structure  and   with   a   multiplicity  of  different  root
directory   structures,   you   probably   have   a   localtexmf   root,
containing  a  tex  directory   which   on   turn   contains   a   latex
directory.   Under   the   latter  directory  create  a  new  directory,
named, say, teubner, and move there teubner.sty.

I suggest  you  to  create  a  directory  teubner  in  the doc directory
of   the   localtexmf   rooted   structure  and    move    there    both
teubner-doc.pdf   and   teubner.dvi   that  you  get  by  running  LaTeX
directly on teubner.dtx.

For what concerns the fonts, I suggest you download the type 1 pdf fonts
from CTAN: there you can get also the tfm files and  the sources for all
the Greek and metric symbol files; in case you prefer to use the  raster
fonts generated  by METAFONT  you can download  also the source METAFONT
files.


In  the  texmf  rooted  directory   structure  there should  be  a  file
under fontname, named  special.map;  edit such file and possibly add the
line

gmtr            public          teubner

possibly preceded by a comment line of the form

@c Metric symbols font

This last task is not  really  necessary,  but  it  is  useful,  because
the  generated  tfm  and  pixel  files  will  be automatically deposited
in the proper directories, with no confusion with other fonts.

Another important  step  is  to  control  that  you  have  the latest CB
Greek fonts; even  if  you  got  them  installed  with  the  TeX  system
installation   program,   may   be  they  are  not  the latest  version,
compatible  with  this  extension   package.  Control  your  cbgreek.txt
file and  at  the  end  of  the  file  there  is  its  date;  this  date
should be not earlier than 15th of August 2002.  If the date  is earlier
than this, connect to CTAN and  download  the latest version of  the  CB
Greek  fonts  both  in  METAFONT  and  in pfb  type 1 format. Follow the
instructions  for inserting  the proper files in the proper directories,
and for adding the proper  map file  to the configuration files of dvips
and  pdfLaTeX.   If you  already  had the  metric tfm files, remember to
delete  them  in order  to have  them generated  on the fly  by LaTeX or
pdfLaTeX, or download the newer tfm files from CTAN.


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
CB fonts 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.

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, classical Latin, et cetera.

This   set   of   extension   commands   has   been  tested  in  several
documents; nevertheless I  prepared  them  as  a  hobby,  in the hope of
helping 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  worst  possible  things that my
happen to anybody working  with  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  to  face  the
consequences   (...   which  nevertheless  I  hope  they  are  what  you
expected).

If you find  this  package  of  some  utility  and  you find some errors
and/or    some    glitches,    please     write     me     by     e-mail
(claudio.beccari@polito.it). 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
do  not  guarantee  I'll  be  able  to  satisfy  your  request, but I'll
give it a try. In  any  case  don't  ask  things  LaTeX can't do; and if
you use LaTeX, you know what are its pros and cons.

Happy philological LaTeXing!

Claudio Beccari
Dipartimento di Elettronica
Politecnico di Torino, Italy

Turin, 16th of January 2006