summaryrefslogtreecommitdiff
path: root/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-install-where.html
blob: 0764f0a54507a11984cd16f8dc090ceb2cab18ab (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
<head>
<title>UK TeX FAQ -- question label install-where</title>
</head><body>
<h3>Where to install packages</h3>
<p/>Where precisely you put files that you have downloaded depends on
what TeX distribution you have.  We will assume that you have one
of the modern TDS-compliant distributions, and discuss the
general rules that you should follow.
<p/>First, you must decide which tree to put your files into; this isn&rsquo;t
entirely trivial, and is discussed in 
&ldquo;<a href="FAQ-what-TDS.html">choosing a TDS tree</a>&rdquo;.
<p/>We&rsquo;ll assume from here on, that you&rsquo;ve decided on a directory tree,
and we will write <code>$TEXMF</code> for it, whatever it is for your
system.
<p/>The basic idea is to imitate the directory structure in your
existing tree(s). Here are some examples of where various sorts of
files should go:
<blockquote>
<pre>
.sty, .cls or .fd: $TEXMF/tex/latex/&lt;package&gt;/
.dvi, .ps or .pdf: $TEXMF/doc/latex/&lt;package&gt;/
.mf:   $TEXMF/fonts/source/&lt;supplier&gt;/&lt;font&gt;/
.tfm:  $TEXMF/fonts/tfm/&lt;supplier&gt;/&lt;font&gt;/
.vf:   $TEXMF/fonts/vf/&lt;supplier&gt;/&lt;font&gt;/
.afm:  $TEXMF/fonts/afm/&lt;supplier&gt;/&lt;font&gt;/
.pfb:  $TEXMF/fonts/type1/&lt;supplier&gt;/&lt;font&gt;/
.ttf:  $TEXMF/fonts/truetype/&lt;supplier&gt;/&lt;font&gt;/
.otf:  $TEXMF/fonts/opentype/&lt;supplier&gt;/&lt;font&gt;/
.pool, .fmt, .base or .mem: $TEXMF/web2c
</pre>
</blockquote><p>
and for modern systems (those distributed in 2005 or later, using TDS
v1.1 layouts):
<blockquote>
<pre>
.map:  $TEXMF/fonts/map/&lt;syntax&gt;/&lt;bundle&gt;/
.enc:  $TEXMF/fonts/enc/&lt;syntax&gt;/&lt;bundle&gt;/
</pre>
</blockquote><p>
(Map and encoding files went to directories under
<i>$TEXMF/dvips/</i>, in earlier distributions.)
<p/>In the lists above, &lt;<i>package</i>&gt;, &lt;<i>font</i>&gt; and &lt;<i>supplier</i>&gt; depend
upon what&rsquo;s appropriate for the individual file &mdash; the supplier
&ldquo;public&rdquo; is commonly used for free fonts.  The &lt;<i>syntax</i>&gt;
(for <code>.map</code> and <code>.enc</code> files) is a categorisation based
on the way the files are written; typically, it&rsquo;s the name of a
program such as <i>dvips</i> or <i>pdftex</i>.
<p/>&ldquo;Straight&rdquo; (La)TeX input can take other forms than the <code>.sty</code>,
<code>.cls</code> or <code>.fd</code> listed above, too.  Examples are
<code>.sto</code> and <code>.clo</code> for package and class options,
<code>.cfg</code> for configuration information, and so on.
<p/>Note that &lt;<i>font</i>&gt; may stand for a single font or an entire family:
for example, files for all of Knuth&rsquo;s Computer Modern fonts are to be
found in <code>.../public/cm</code>, with various prefixes as appropriate.
<p/>The font &ldquo;supplier&rdquo; <em>public</em> is a sort of hold-all for
&ldquo;free fonts produced for use with (La)TeX&rdquo;: as well as Knuth&rsquo;s
fonts, <em>public</em>&rsquo;s directory holds fonts designed by others
(originally, but no longer exclusively, in Metafont).
<p/>Some packages have configuration files (commonly with file suffix
<code>.cfg</code>), and occasionally other run-time files.  The package
documentation <em>should</em> mention these things, but sometimes
doesn&rsquo;t.  An exception is the <code>.drv</code> file, used by some
packages as part of the documentation building process; this is
usually part of the package documentation process, and should not be
installed.
<p/><p>This question on the Web: <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=install-where">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=install-where</a>
</body>