$Id: README.TUG 350 2021-02-03 23:28:03Z karl $ To install the Lucida Type 1 font distribution from TUG: 1) download the zip file from TUG via the url given to you after ordering. 2) change directories to a suitable texmf hierarchy; your "local texmf" (texmf-local) tree is typically the best choice. More info below(*). 3) unzip the archive as retrieved. It unpacks into subdirectories fonts/, tex/, and so on. These directories will probably already exist if you already have a local texmf tree; that's ok. You must use an unzip program or settings which does *not* create any top-level directory of its own (such as "lucida-type1/"), but just unpacks what is in the zip file. 4) remake the so-called "filename database", unless you unpacked in a personal directory, such as ~/Library/texmf on MacOSX. Under Unix, this is generally done by running the command mktexlsr (on MacOSX, typically as root, so: sudo -H mktexlsr). Under MiKTeX, it is generally done through the GUI: Start > Programs > MiKTeX > Maintenance > Settings > General > Refresh FNDB In older versions of MiKTeX, it may be under a menu called "MiKTeX Options" instead of "Maintenance". There may also be a "Maintenance(Admin)" entry if you have administrative privileges; if so, that is usually the better choice. Or from a DOS command line, if you prefer: initexmf --update-fndb 5) enable the Lucida "map files", if necessary. Under Unix, this is generally done by running the command updmap-sys --force --enable Map lucida.map (on MacOSX, typically as root, so: sudo -H updmap-sys ...) For MiKTeX, the procedure is more complicated; see below(**). Some distributions already have the map file enabled. You can tell by running the sample document mentioned below on your system. If it starts calling programs like mktexpk, and fonts are unable to be loaded, and you don't get any actual Lucida in the output, then you need to enable the map file. If the output is fine, you're all set. 6) remake the filename database again; this is not always necessary, depending on your setup, but should never hurt. 7) the document doc/fonts/lucidabr/lucida-type1.pdf explains the basic usage of the fonts in LaTeX, and is itself typeset using Lucida. The LaTeX source is also included (lucida-type1.tex) so that you can see how it was produced. Running this file through LaTeX yourself is a good test of the installation.(***) Some additional documentation and samples are included in doc/fonts/lucidabr and doc/fonts/lucida. If you have questions or problems regarding installation or use, please email lucida@tug.org; this is an open and publicly archived list for Lucida discussion, and you can subscribe via https://lists.tug.org/lucida. Questions or problems related to ordering or licensing should go to lucida-admin@tug.org. The TUG Lucida home page is https://tug.org/lucida. Happy typesetting! -- (*) Finding and/or creating your texmf-local tree: TeX systems have thousands of files, arranged in several "trees" of directories. Your system can quickly look through the trees that it knows about. When you install TeX, you may have noticed or set up a "local" tree, used for your own macros and other files. The advantage of a local tree is that if you install an new version of your TeX system then these local materials will not be overwritten. A local tree is the best place to install the Lucida fonts. The default place for the local tree is /usr/local/texlive/texmf-local on Unix or C:\texlive\texmf-local on Windows. They might be entirely empty. How to find or define a local tree depends on your system: MiKTeX Navigate through the MiKTeX program: Start > Programs > MiKTeX > Maintenance > Roots (or "MiKTeX Settings", in older versions). Some paths shown there have a "Description" such as Install, UserConfig or UserData. A tree labeled UserConfig (but not any of the others) is an acceptable target for your new fonts, if you have no permission to create a new tree. However, it is better to use a tree without a description, as follows: You can create a new local tree by clicking on "Add". The folder must not contain files at its root level or MiKTeX will reject it. Files in the folder must be in subfolders similar to the subfolders in the "Install" root. For more info, see http://docs.miktex.org/manual/localadditions.html. TeX Live and MacTeX From a system terminal (aka command prompt, shell window) enter the command kpsewhich --var-value TEXMFLOCAL to see the directory name. (**) Enabling the Lucida map file under MiKTeX: 1. Edit the map configuration file updmap.cfg. In a DOS Window/Command Prompt window, run: initexmf --edit-config-file updmap You'll want to edit this in a text editor such as Notepad. If the file or any of the leading directories do not exist, create them. 2. Add this one line to updmap.cfg and save it: Map lucida.map 3. Back at the DOS prompt, run: initexmf --mkmaps (Ignore any error messages.) Hopefully that is it. Resume above at step 5. (***) Potential problems: 1. If when you run a Lucida document you get complaints about missing fonts, mktexpk could not make bitmaps, etc., most likely you need to enable the Lucida map file. See step 4 above. 2. If you try to do everything, and the Lucida fonts are still not being recognized (e.g.,, TeX tries to find the nonexistent bitmaps for them), try running: updmap-sys --syncwithtrees -- Legal: the Lucida fonts are made available only under an end-user or site license, which you must have agreed to when you ordered the fonts. The license text is available in the distribution files doc/fonts/lucidabr/lucida-license-*.txt, or online at https://tug.org/store/lucida. (This documentation itself may be freely used, modified and/or distributed.) The Lucida typeface family was designed by Charles Bigelow and Kris Holmes. (R) Lucida is a trademark of Bigelow & Holmes Inc. registered in the U.S. Patent & Trademark Office and other jurisdictions. TUG gratefully acknowledges: B&H for making this distribution by TUG possible, Y&Y for the original Lucida TeX distribution, Walter Schmidt for creating and updating the TeX font support files, PCTeX for sponsoring him and allowing his work to be redistributed. and many other volunteer contributors to all aspects of the Lucida support in the TeX world.