| 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 |