diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/IEEEtran/font_install_how.txt')
-rw-r--r-- | Master/texmf-dist/doc/latex/IEEEtran/font_install_how.txt | 236 |
1 files changed, 135 insertions, 101 deletions
diff --git a/Master/texmf-dist/doc/latex/IEEEtran/font_install_how.txt b/Master/texmf-dist/doc/latex/IEEEtran/font_install_how.txt index 1f4afb529d0..23ca81fc5e5 100644 --- a/Master/texmf-dist/doc/latex/IEEEtran/font_install_how.txt +++ b/Master/texmf-dist/doc/latex/IEEEtran/font_install_how.txt @@ -6,43 +6,55 @@ ***** LaTeX Using Adobe's Euro Font as an ***** ***** Illustrative Example ***** -Version 1.3 -February 18, 2003 +Version 1.4 +January 10, 2007 -Copyright 2003, by Michael Shell - mshell@ece.gatech.edu +Copyright 2002-2007, by Michael Shell + http://www.michaelshell.org/ See: -http://www.ctan.org/tex-archive/macros/latex/contrib/supported/IEEEtran/ -for the latest version and current contact information. +http://www.ctan.org/tex-archive/macros/latex/contrib/IEEEtran/extras/ +for the latest version of this document. -NOTE: This text file uses UNIX line feed conventions. When (human) +NOTE: This text file uses Unix line feed conventions. When (human) reading this file on other platforms, you may have to use a text -editor that can handle lines terminated by the UNIX line feed +editor that can handle lines terminated by the Unix line feed character (0x0A). *** Free to use and distribute if all credits are retained and the *** -*** document is unchanged. *** -*** No warranty expressed or implied. User assumes all risk. *** +*** document is unchanged. No warranty expressed or implied. User *** +*** assumes all risk. *** Note: This guide is intended to be "hands on" and covers only a specific, practical example. There are other, more formal and comprehensive guides -to installing fonts under LaTeX that are also worthy of consideration: +to installing fonts under LaTeX: -1. "The Simple Guide to Type 1 Fonts in LaTeX" +1. "The Font Installation Guide" + by Philipp Lehman + http://www.ctan.org/tex-archive/info/Type1fonts/fontinstallationguide/ + This is perhaps the best book ever written on the subject. Tutorial IV, + "The Euro Currency Symbol" covers the euro symbol. + +2. "Fonts and layouts", Chapter 8 of "A Beginner's Introduction to + Typesetting with LaTeX" (Section 8.3.2 covers the installation of + PostScript fonts) by Peter Flynn + http://www.ctan.org/tex-archive/info/beginlatex/html/chapter8.html#instfonts + +3. "fontinst - Font Installation Software for LaTeX" + by Alan Jeffrey, Rowland McDonnell and Lars Hellstrom + http://ctan.tug.org/tex-archive/fonts/utilities/fontinst/doc/ + +4. "The Simple Guide to Type 1 Fonts in LaTeX" by Matthew Amster-Burton http://www.mamster.net/tex/latex-fontfaq-amster-burton.pdf + Although the author states that this guide has been superseded by + Lehman's, it may still be of some value. -2. "Installing PostScript Fonts" - by Peter Flynn - http://www.silmaril.ie/downloads/documents/installpsfonts.pdf - -3. "The No BS Guide to teTeX Font Installation" +5. "The No BS Guide to teTeX Font Installation" by Donovan Rebbechi http://www.pegasus.rutgers.edu/~elflord/unix/latex/no-bs.html + May be out of date today, but may still have some useful tips about the + fontinst application. -4. "fontinst - Font Installation Software for LaTeX" - by Alan Jeffrey and Rowland McDonnell - http://ctan.tug.org/tex-archive/fonts/utilities/fontinst/doc/ Installing a euro font in LaTeX, although not always trivial, is a straight @@ -53,21 +65,22 @@ from multiple sources. So, if you can get a euro font going, you can probably handle most other fonts you might want to install. Admittedly, there are also those that are more difficult to install, especially if the TeX metric and/or dvips map files have not already been created for them. -The installation of such fonts is not completely covered by the information -provided here. +The installation of such fonts is not covered by the information provided +here. -The five basic steps for manually installing a (type 1) font under LaTeX are: +The four basic steps for manually installing a (type 1) font under LaTeX are: + +1. Install the actual PostScript font (.pfb) files; +2. Install the .tfm metric files; +3. Install the .sty and .fd files to provide a LaTeX interface; +4. Update the map configuration files and LaTeX directory lookup (hash) + tables. -1. Install the actual PostScript font files; -2. Install the tfm metric files; -3. Install the .sty and .fd files to provide a user interface; -4. Update the dvips/pdftex/yap/xdvi configuration files; -5. Update the LaTeX directory lookup (hash) tables (teTeX and MiKTeX users). The euro font has a number of issues that make it a tad more difficult to install than most LaTeX fonts. The euro standards commission: -http://www.europa.eu.int/euro/html/entry.html +http://europa.eu.int/euro/ originally mandated that the official standard euro symbol should always be rendered in the sans style even if the surrounding text uses a different @@ -92,16 +105,16 @@ as to what to recommend to use here. I assume that you want a Type 1 Postscript font as opposed to anything bitmapped - this will help ensure the best quality rendering possible for a given printer resolution. I will also assume here that the LaTeX system -you have does not already have any support for Type 1 euro glyphs - this is +you have does not already have any support for Type 1 euro glyphs, as is often the case. -Adobe gives out a FREE set of PostScript Type 1 euro fonts. +Adobe gives out a free set of PostScript Type 1 euro fonts. See: http://www.adobe.com/type/eurofont.html -Adobe does not allow its fonts to be bundled with other software products. -This is why the fonts cannot be already pre-loaded in the LaTeX +However, Adobe does not allow its fonts to be bundled with other software +products. This is why the fonts cannot be already pre-loaded in the LaTeX distributions and LaTeX users must manually obtain and install them. [Note: Also worthy of consideration is Martin Vogel's marvosym package: @@ -114,7 +127,7 @@ This guide will focus on the use of the Adobe euro fonts. Now, you do not have to register, but can get the needed Adobe euro font files directly from: -Windows and UNIX: +Windows and Unix: ftp://ftp.adobe.com/pub/adobe/type/win/all/ eurofont.exe eurofont.txt @@ -125,7 +138,7 @@ eurofont.sea.hqx eurofont.txt Note that the file eurofont.exe is actually a zip file that is self -extracting when run under Windows. UNIX users can do a: +extracting when run under Windows. Unix users can do a: unzip eurofont.exe @@ -137,8 +150,8 @@ STEP #1 - INSTALL THE ACTUAL POSTSCRIPT FONT FILES Now, the eurofont.txt will tell you that you need ATM - ignore this since you are using LaTeX and will have to do a manual install of the font files. -You can install them into Windows using Adobe ATM, but even if you do, you -will still have to follow the instructions here. +You can install them into MS Windows using Adobe ATM, but even if you do, +you will still have to follow the instructions here. The Adobe font files will have strange looking names. You are primarily interested in the ones that end in PFB ("Printer Font Binary" - but @@ -147,9 +160,9 @@ PostScript code which describes what the glyphs look like. It is these files (or portions of them) that get embedded into your PostScript or PDF output files. The AFM (Adobe Font Metric) files describe the size of the boxes each glyph takes up. The PFM files do the same thing, but are used -only by Windows system. LaTeX does not use AFM or PFM files, but rather -uses TFM (TeX Font Metric) files. There is a program (afm2tfm) that can -convert AFM to TFM, but you don't need this as the TeX/LaTeX developers +only by the MS Windows system. LaTeX does not use AFM or PFM files, but +rather uses TFM (TeX Font Metric) files. There is a program (afm2tfm) that +can convert AFM to TFM, but you don't need this as the TeX/LaTeX developers have done this for you already. Some font conversion programs (e.g., ps2pk) may require access to the AFM or PFM files. The INF files describe the fonts to Windows - so you don't need them (but, if curious, you can find @@ -173,25 +186,26 @@ _3BI____.PFB -> zpeubi.pfb The new names are, more or less, based on Karl Berry's scheme for TeX font names. For more information on this topic, see Karl Berry's "Filenames -for TeX Fonts": http://www.ctan.org/tex-archive/info/fontname/ +for TeX Fonts": http://www.ctan.org/tex-archive/info/fontname/fontname.pdf Now, find your texmf directory where your LaTeX system is installed. I'll -call this directory "<texmf>". Go to <texmf>/fonts/type1/adobe and make -a directory called "eurofont". Copy all the renamed .pfb files into -<texmf>/fonts/type1/adobe/eurofont +call this directory "<texmf>". (You may wish to use the local tree +"<texmf-local>", or "localtexmf" under MiKTeX, instead so that your changes +will remain even after the system is upgraded.) Go to +<texmf>/fonts/type1/adobe and make a directory called "eurofont". Copy all +the renamed .pfb files into <texmf>/fonts/type1/adobe/eurofont -[Note (for fonts other the one in this example): Sometimes PostScript font - files come in ASCII, not binary. Such ".pfa" files would go in the same - directory as their pfb equivalents. Any virtual font files ".vf" would - go in <texmf>/fonts/vf/ directory tree.] +[Note: Some PostScript font files come in ASCII, not binary. Such ".pfa" + files would go in the same directory as their pfb equivalents. Any virtual + font files ".vf" would go in the <texmf>/fonts/vf/ directory tree.] You may also want to do the same with the AFM and PFM files so that certain font conversion programs can access these as well. Put the renamed AFM and PFM files in <texmf>/fonts/afm/adobe/eurofont and <texmf>/fonts/pfm/adobe/eurofont, respectively. -UNIX users will have to have super user privileges to make system changes -like this. +Unix users will have to have super user privileges to make changes to the +<texmf> directory. @@ -202,26 +216,22 @@ the new Adobe euro fonts. Of the several LaTeX packages that do this, I think that two are the best. The most complete, and complex, is Rowland McDonnell's eurofont package: -http://www.ctan.org/tex-archive/help/Catalogue/entries/eurofont.html +http://www.ctan.org/tex-archive/macros/latex/contrib/eurofont/ This is an EXTREMELY comprehensive (and high quality) work. The user's -guide alone is over 60 pages! But, I'll show here how to install the +guide alone is over 60 pages. But, I'll show here how to install the leaner, LaTeX euro package (this actually consists of two smaller LaTeX -packages "europs" and "eurosans"), which you can get in .tar.gz (UNIX) -or .zip (Windows) formats: - -euro.tar.gz or euro.zip -http://www.ctan.org/getfile/?filename=fonts/euro/&preferredCTAN=tug.ctan.org&action=/tex-archive/fonts/euro/ +packages "europs" and "eurosans"): -[The unarchived euro package home page is at: - http://www.ctan.org/tex-archive/fonts/euro/ ] +http://www.ctan.org/tex-archive/fonts/euro/ Download and unpack this euro package archive. The readme.txt tells what -to do. But, I'll repeat the steps here in my own words. I recommend that -you do things manually rather than try to use any automated install scripts. +to do. But, I'll repeat the steps here in my own words. I will show how +to do things manually rather than rely on any automated install scripts. -Some these files may already be installed in some LaTeX systems, you don't -have to reinstall them if that is the case. +Some of these files (including the tfm and map files) may already be +installed in some LaTeX systems, you don't have to reinstall them if +that is the case. @@ -243,12 +253,12 @@ LaTeX with set of names that the euro glyphs will be called by. In the latex subdirectory of the archive there will be two packages: europs and eurosans. eurosans restricts it's use to the sans euro because many -knowledgeable in the typographic field feel that the sans euro better -matches with most fonts, including many popular serif ones such as Times. -eurosans also allows the user to specify an arbitrary scaling factor so -that the size of the euro can be adjusted (if needed) to more closely -match that of the surrounding text. The europs package allows you to -decide if you want a serif euro. It is easy enough to install them both. +people who are knowledgeable in the typographic field feel that the sans +euro better matches with most fonts, including many popular serif ones such +as Times. eurosans also allows the user to specify an arbitrary scaling +factor so that the size of the euro can be adjusted (if needed) to more +closely match that of the surrounding text. The europs package allows you +to decide if you want a serif euro. It is easy enough to install them both. Now, in your <texmf>/tex/latex directory, make a directory called @@ -272,11 +282,23 @@ The next step is to also inform dvips, pdfTeX, Yap, and/or xdvi, etc., so that you can make and view documents with the euro symbol. The file you need is "zpeu.map" which is found in the dvips subdirectory of -the archive. Copy zpeu.map to your <texmf>/dvips/config directory. Now, in -your <texmf>/dvips/config directory, edit your config.ps file (with a -simple text editor) and add the following line (somewhere after the -"p psfonts.map" line - there will be a bunch of other "p +" lines in -this area): +the archive. There is also a "zpeu-origname.map" which will allow the use +of the original Adobe names (e.g., "_1______.PFB"), but it is best to change +the names, as mentioned previously, to follow the LaTeX convention (so as to +improve clarity and avoid future name clashes). + + +Font map handling has been changed to use an updmap utility in conjunction +with an updmap.cfg configuration file for the newer (teTeX 2.0, MiKTeX 2.4 +and later) LaTeX systems. Use one of the appropriate subsections below +depending on your system: + + +-- For Systems Older Than teTeX 2.0 or MiKTeX 2.4 -- +Copy zpeu.map to your <texmf>/dvips/config directory. Now, in your +<texmf>/dvips/config directory, edit your config.ps file (with a text editor) +and add the following line (somewhere after the "p psfonts.map" line - there +will be a bunch of other "p +" lines in this area): p +zpeu.map @@ -286,22 +308,24 @@ For pdfTeX (and pdfLaTeX), the line: map +zpeu.map -should be added to the pdftex.cfg file in the <texmf>/pdftex/config -directory (there is no need to make another copy of the zpeu.map file -as pdfTeX will know to look for it in dvips' config directory). +should be added to the pdftex.cfg file in the <texmf>/pdftex/config +directory (there is no need to make another copy of the zpeu.map file as +pdfTeX will know to look for it in dvips' config directory). MiKTeX users will also want to add to the line: p +zpeu.map -to the <texmf>\miktex\config\config.makepk file so that Yap can find -the font if it does not already look at dvips' config.ps file. +to the <texmf>\miktex\config\config.makepk file so that Yap can find the +font if it does not already look at dvips' config.ps file. MiKTeX users may also want to add the lines contained in the zpeu.map to -<texmf>\miktex\dvips\ps2pk\ps2pk.map for other applications that may need it. +<texmf>\miktex\dvips\ps2pk\ps2pk.map for other applications that may need +it. MetaPost users may want to add the lines contained in the zpeu.map file to -the <texmf>/dvips/config/psfonts.map file as that is what MetaPost relies on. +the <texmf>/dvips/config/psfonts.map file as that is what MetaPost relies +on. Older versions of xdvi that rely on gsftopk (to convert Type 1 fonts to bitmap form) may also require the psfonts.map file to be updated. Newer @@ -309,24 +333,24 @@ versions of (the Kpathsea enabled version "xdvi-k") xdvi are able to render Type 1 fonts directly from the .pfb files. See Stefan Ulrich's xdvi-k site on Sourceforge for details: http://xdvi.sourceforge.net/ -Additional information on upgrading xdvi can also be found in the testflow -documentation: -http://www.ctan.org/tex-archive/macros/latex/contrib/supported/IEEEtran/ +Note that versions of dvips prior to V5.83 have a bug with partial font +downloading that may cause a dvips error when using some types of fonts, +like the euro packages. (The error messages can be like: "File <xxx.pfb> +ended before all chars have been found" or "xx Subr not found", etc.) +If you encounter this, the workaround is to update dvips or use the +-j0 option: + +dvips -j0 -o myfile.ps myfile Thanks to Dan Luecking for posting much information about map file configuration. +OK, now all the files are in place. Most TeX systems (teTeX Unix and MiKTeX +Windows) need to be told to rescan their directories in order to add the +names of all the newly added files to the lookup cache. - -STEP #5 - UPDATE THE LATEX DIRECTORY LOOKUP (HASH) TABLES - (teTeX and MikTeX users) - -OK, now all the files are in place. Some TeX systems (most commonly teTeX -UNIX and MikTeX Windows) need to be told to rescan their directories in -order to add the names of all the newly added files to the lookup cache. - -In teTeX (and fpTeX), the command to run is "texhash" or "texlsr". +In teTeX (and fpTeX), the command to run is "texhash" or "mktexlsr". In MiKTeX it is "initexmf -u" to refresh the filename database and then "initexmf --mkpsres --search" to rebuild the PostScript resource database. @@ -338,16 +362,26 @@ LaTeX's directories. Run this application/command. -OTHER NOTES +-- For teTeX 2.0, MiKTeX 2.4 and Newer Systems -- +Copy zpeu.map to your <texmf>/fonts/map/dvips/misc directory. Edit the +<texmf>/web2c/updmap.cfg file with a text editor and add the line: -Note that versions of dvips prior to V5.83 have a bug with partial font -downloading that may cause a dvips error when using some types of fonts, -like the euro packages. (The error messages can be like: "File <xxx.pfb> -ended before all chars have been found" or "xx Subr not found", etc.) -If you encounter this, the workaround is to update dvips (see the testflow -docs for info) or use the -j0 option: +Map zpeu.map -dvips -j0 -o myfile.ps myfile +Now, you will have to refresh the directory lookup (hash) tables so +that the LaTeX system can see the new zpeu.map file in the lookup cache. + +In teTeX (and fpTeX), the command to run is "texhash" or "mktexlsr". + +In MiKTeX use "initexmf -u" to refresh the filename database. The +MiKTeX Options application has a "Refresh Now" button which does the +same thing. + +Now, for teTeX 2.0 and MiKTeX systems, run the "updmap" command to update +the map file configuration. For teTeX 3.0 and later, the command you will +likely want to run is "updmap-sys" which updates the map files system-wide +(as "updmap" does in teTeX 2.0). (Under teTeX 3.0 and later, "updmap" updates +the map file settings only for the current user.) |