Debian Codegraph @

texmf-dist/doc/latex/psnfss/README

raw
1 ------------------------------------------------------------
2 PSNFSS 9.3 -- installation instructions
3 ------------------------------------------------------------
4 2020-03-25
5 Walter Schmidt
6
7
8 Contents
9 --------
10
11 - Overview
12 - Removing obsolete files
13 - Installing the virtual fonts, metrics and .fd files
14 - Installing the PSNFSS macro packages
15 - Installing the documentation
16 - Fonts required for PSNFSS
17 - Font map files
18 - The encoding vector 8r.enc
19 - Extra packages required for PSNFSS
20 - Making sure that everything works
21 - Files from PSNFSS v7.x, which are no longer part of the
22 distribution.
23
24
25
26 Overview
27 --------
28
29 PSNFSS, originally developed by Sebastian Rahtz, is a set of
30 LaTeX2e package files to use common PostScript text and
31 symbol fonts, together with packages for typesetting math
32 using virtual math fonts to match Times and Palatino.
33
34 The macro packages are useless without the font description
35 (fd) files, virtual fonts (vf) and font metric (tfm) files
36 for the font families used. On CTAN, those for the Base 35
37 fonts are provided in the archive lw35nfss.zip. The
38 metrics, fd's and font map files for the free Utopia,
39 Charter, FPL and Pazo fonts are provided in the archive file
40 freenfss.zip.
41
42 The PSNFSS collection does, however, NOT include the actual
43 PostScript fonts, i.e., the .pfb and .afm files. See the
44 below section "Fonts required for PSNFSS" .
45
46 This document describes how to _install_ or _update_ PSNFSS.
47 Detailed instructions how to _use_ PSNFSS with LaTeX can be
48 found in the PDF document psnfss2e.pdf.
49
50
51
52 Removing obsolete files
53 -----------------------
54
55 * If your current version of PSNFSS is 7.0 or older, you
56 should remove manually _all_ macro files, .fd files, font
57 metrics and virtual fonts, that have to do with the PSNFSS
58 system or with the Base35, Utopia, Charter or Pazo fonts.
59
60 * If your current version of PSNFSS is 8.x or 9.1, delete
61 the files ot1fplmbb.fd and t1fplmbb.fd. In a TDS-compliant
62 TeX system, they should reside in the directory
63 texmf/tex/latex/psnfss.
64
65 * Previous distributions of PSNFSS 9.0x would erroneously
66 comprise a number of files named *8a.tfm in the directory
67 texmf/fonts/tfm/adobe/palatino. These files did not do any
68 harm, yet they are useless and should be deleted -- unless
69 you are using VTeX, which does require them.
70
71
72
73 Installing the virtual fonts, metrics and .fd files
74 ---------------------------------------------------
75 Obtain the archive files lw35nfss.zip and freenfss.zip from
76 CTAN:macros/latex/required/psnfss. If the file system
77 layout of your TeX system complies with TDS, unzip them in
78 the texmf root directory (usually named texmf) of your TeX
79 system; all files will be unpacked into the right
80 directories then. Otherwise you have to sort out manually
81 the files from the .zip archives and copy them to the
82 appropriate directories of your TeX system.
83
84 The archives do _not_ include TFM files for the "raw" (= not
85 re-encoded) PostScript text fonts. These files are required
86 by VTeX only (and they are not PSNFSS-specific, anyway).
87
88
89
90 Installing the PSNFSS macro packages
91 ------------------------------------
92
93 Copy the files
94
95 00readme.txt
96 changes.txt
97 manifest.txt
98 mathtest.tex
99 pitest.tex
100 psfonts.dtx
101 psfonts.ins
102 psnfss2e.tex
103 test0.tex
104 test1.tex
105 test2.tex
106 test3.tex
107
108 to a directory where you keep documented LaTeX sources.
109 In a TDS-compliant system this should be the directory
110
111 texmf/source/latex/psnfss/ .
112
113 Run LaTeX on the installation script psfonts.ins to create
114 the package (.sty) files. Move them to a directory where
115 LaTeX will find them. In a TDS-compliant system this should
116 be the directory
117
118 texmf/tex/latex/psnfss/ .
119
120 The latter step is executed automagically by the
121 installation script, provided that your DocStrip program has
122 been configured appropriately and the target directory
123 exists already.
124
125
126
127 Installing the documentation
128 ----------------------------
129
130 Copy the documentation file psnfss2e.pdf to a suitable
131 directory; in a TDS-compliant system this should be
132
133 texmf/doc/latex/psnfss .
134
135
136
137 Fonts required for PSNFSS
138 -------------------------
139
140 The "Base 35" fonts
141 Free substitutes for the commercial PostScript Base fonts
142 are available from the CTAN directory fonts/urw/base35.
143
144 Adobe Utopia
145 Bitstream Charter
146 The Type1 font files can be obtained for free from various
147 sources, e.g., CTAN:fonts/utopia and CTAN:fonts/charter.
148
149 | The Utopia fonts are no longer a "required" component of
150 | the LaTeX system, because of their license conditions.
151 | Yet YOU MUST NOT OMIT the related font metrics and map
152 | file records, regardless of whether or not the Type1 font
153 | files are actually installed. Thus, the user will be
154 | able to add the fonts without any further changes;
155 | besides, other packages or virtual fonts may rely on
156 | these TFMs.
157
158 FPL (=Palatino SC/OsF)
159 Free substitutes for the commercial Palatino SC/OsF fonts
160 are available from CTAN:fonts/fpl
161
162 Pazo
163 The Type1 fonts can be obtained from the CTAN directory
164 fonts/mathpazo. Notice that PSNFSS 9 needs version 1.003
165 (2002-05-17) of the Pazo fonts.
166
167 Computer Modern
168 RSFS (Ralph Smith's Formal Script)
169 Euler Math
170 These font families are required when typesetting math
171 using the packages mathptm, mathptmx, mathpple, or
172 mathpazo. They are available in Type1 as well as METAFONT
173 format Make sure to install at least the Type1 variants,
174 possibly beside .mf.
175
176
177
178 Font map files
179 --------------
180
181 The following font map files (in a format that suits dvips
182 and pdfTeX) are provided in the PSNFSS distribution. Use
183 them immediately or merge them into one common map file:
184
185 psnfss.map: for the Base35 fonts, eurmo10 and eurbo10
186 charter.map: for Bitstream Charter
187 utopia.map: for Adobe Utopia
188 pazo.map for the Pazo math fonts
189 fpls.map for the free substitutes (FPL) of the
190 Palatino SC/OsF fonts
191
192 psnfss.map is primarily destined for use with dvips. The
193 entries for the fonts "eurmo10" and "eurbo10" may need to be
194 customized: Feel free to change the /FontName's (EURM10 and
195 EURB10) to lower case, if you have got the Type1 fonts from
196 MicroPress rather than the BlueSky collection. This
197 particular change is _not_ regarded as a violation of the
198 license conditions.
199
200 psnfss.map does _not_ make dvips embed the Base35 fonts.
201 For use with pdfTeX you will, most likely, have to create a
202 modified copy, which specifies embedding of all Base fonts.
203 The other map files are equally suitable for use with either
204 dvips or pdfTeX.
205
206 Other applications, such as VTeX, need a different format of
207 the font map files. They may also require entries for the
208 raw (= not reencoded) fonts. When creating these map files,
209 take those for dvips/pdfTeX as a model!
210
211
212
213 The encoding vector 8r.enc
214 --------------------------
215
216 Most Type1 text fonts, when used from TeX, are reencoded to
217 the so-called TeXBase1 encoding, in order to make all glyphs
218 accessible. This is performed using the reencoding file
219
220 8r.enc
221
222 which distributed with PSNFSS. Consult the documentation of
223 your TeX system, where to store this file!
224
225 |
226 | PSNFSS 9.x includes version 2.0 of 8r.enc. Make sure
227 | that there exist no other, obsolete, instances of 8r.enc
228 | in the applicable search path of your TeX system
229 |
230
231
232
233 Extra packages required for PSNFSS
234 ----------------------------------
235
236 The "Graphics" bundle must be installed, since PSNFSS makes
237 use of the package keyval.sty.
238
239
240
241 Making sure that everything works
242 ---------------------------------
243
244 Run the test following files through LaTeX:
245
246 test0.tex
247 test1.tex
248 test2.tex
249 test3.tex
250 mathtest.tex
251 pitest.tex
252
253
254
255 Files from PSNFSS v7.x, which are no longer part of the
256 distribution
257 -------------------------------------------------------
258
259 The files to support the commercial Lucida Bright and
260 MathTime fonts are now distributed from the CTAN directories
261 macros/latex/contrib/psnfssx/ and fonts/metrics/bh/lucida/.
262
263
264 -- finis