summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/psnfssx/lucidabr/README.TUG
blob: 9bfecad1b4221c9b120f2a671c83b14685092f85 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
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"
   tree is 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.(***)
   
   The short text file doc/fonts/lucidabr/lucidabr.txt lists the options
   to the package.  Additional documentation and samples are 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
http://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 http://tug.org/lucida. 
Happy typesetting!

--
(*) Finding and/or creating your texmf-local 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,
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.

Typical names for local trees are "C:\Local TeX Files" on Windows or
"/usr/local/texlive/texmf-local" on Unix.  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 do try latex-ing lucida-type1.tex and get an error at the line:
  \DeclareEncodingSubset{TS1}{hlh}{1}  % including \oldstylenums
Please check your version of the textcomp.sty style file against 
the current release, available at:
  http://www.ctan.org/tex-archive/macros/latex/unpacked/textcomp.sty


--
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
http://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 Y&Y for the original Lucida TeX distribution,
Walter Schmidt for creating and updating the TeX font support files, and
PCTeX for sponsoring him and allowing his work to be redistributed.