$Id: INSTALL-TeX.txt 373 2023-01-21 22:36:22Z karl $ (public domain) The steps below install the Lucida OpenType font distribution from TUG into your TeX setup, for use with XeTeX and LuaTeX engines. (These OpenType fonts will not work with pdfTeX; if you need that, you can order the Lucida Type 1 distribution from TUG, http://tug.org/lucida.) 1) Download the lucidaot-tex.zip file from TUG via the url given to you after ordering. 2) Change directory to a suitable texmf hierarchy. If you have administrative privileges, the best choice is usually your system TEXMFLOCAL tree; if you don't, you'll need to use your personal TEXMFHOME tree if you don't. More on this below(*). 3) Unzip the archive as retrieved. It unpacks into subdirectories doc/, fonts/, and tex/. These directories should 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 "lucidaot/"), but simply 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 macOS. Under Unix, this is generally done by running the command mktexlsr. (on macOS, typically as root, so: sudo 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". Or from a DOS command line, if you prefer: initexmf --update-fndb 5) The distribution has two sample documents explaining the basic usage of the fonts in LaTeX, and themselves typeset using Lucida. doc/fonts/lucidaot/lucidaot.pdf - general documentation doc/fonts/lucidaot/lucidaot-sys-example.pdf - using system font lookups TeX can find the fonts either by filename or by (system) font name, as explained in these documents. 6) The LaTeX sources for the documentation are also included. After installation, running these files through XeLaTeX or LuaLaTeX yourself is a good test of the installation. (If you don't have the DK fonts, you'll need to remove all references to them for lucidaot.tex to run.) Lucida OpenType can be used with both LaTeX and ConTeXt (and any macro package with OpenType text and math support). (See README.txt for additional documentation, contact information, legalities, and more.) -- (*) Finding and/or creating the right "texmf" tree: TeX systems have thousands of files, arranged in one or more "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 or trees, 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. How to find or define a local tree depends on your TeX 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: You can create a new local tree by clicking on "Add"; a typical name is "C:\Local TeX Files". 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 These systems have two local trees: 1) the "TEXMFLOCAL" tree for site-wide files, which usually requires system privileges to change; and 2) the "TEXMFHOME" tree, which is located under your home directory. You can use either to install the Lucida fonts. For the local tree, from a system terminal (aka command prompt, shell window) run the command: kpsewhich --var-value TEXMFLOCAL to see the directory name. The default is /usr/local/texlive/texmf-local. For the personal tree, run the command kpsewhich --var-value TEXMFHOME The default is ~/Library/texmf with MacTeX and ~/texmf otherwise.