summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-makeindex.html
blob: e520837782a48faf1bfb97620d79d7b3a6d8f5fe (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
<head>
<title>UK TeX FAQ -- question label makeindex</title>
</head><body>
<h3>Generating an index in (La)TeX</h3>
<p/>Making an index is not trivial; what to index, and how to index it, is
difficult to decide, and uniform implementation is difficult to
achieve.  You will need to mark all items to be indexed in your text
(typically with <code>\</code><code>index</code> commands).
<p/>It is not practical to sort a large index within TeX, so a
post-processing program is used to sort the output of one TeX run,
to be included into the document at the next run.
<p/>The following programs are available:
<dl>
<dt>makeindex<dd> Comes with most distributions &#8212; a good workhorse,
  but is not well-arranged to deal with other sort orders than the
  canonical ASCII ordering.
<p/>  The <i>makeindex</i> documentation is a good source of
  information on how to create your own index. <i>Makeindex</i> can
  be used with some TeX
  macro packages other than LaTeX, such as 
  <a href="FAQ-eplain.html">Eplain</a>, and TeX (whose macros can
  be used independently with Plain TeX).
<dt>idxtex<dd> for LaTeX under VMS, which comes with a
  glossary-maker called <i>glotex</i>.
<dt>texindex<dd> A witty little shell/<i>sed</i>-script-based
  utility for LaTeX under Unix.
<p/>  The <a href="FAQ-texinfo.html">Texinfo</a> system also uses a program
  <i>texindex</i>, whose source is to be found in the
  <i>texinfo</i> distribution.  The <i>ltxindex</i> package
  provides macros to allow LaTeX users to use <em>this</em>
  <i>texindex</i>.
<dt>xindy<dd> arose from frustration at the difficulty of making a
  multi-language version of <i>makeindex</i>.  It is designed to
  be a successor to <i>makeindex</i>, by a team that included the
  then-current maintainer of <i>makeindex</i>.  It successfully
  addresses many of <i>makeindex</i>&#8217;s shortcomings, including
  difficulties with collation order in different languages, and it is
  highly flexible.  Sadly, its take-up is proving rather slow.
</dl>
<dl>
<dt><tt><i>idxtex</i></tt><dd><a href="http://www.tex.ac.uk/tex-archive/indexing/glo+idxtex.zip">indexing/glo+idxtex</a> (or <a href="http://www.tex.ac.uk/tex-archive/indexing/glo+idxtex/">browse the directory</a>)
<dt><tt><i>ltxindex.sty</i></tt><dd><a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/ltxindex.zip">macros/latex/contrib/ltxindex</a> (or <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/ltxindex/">browse the directory</a>)
<dt><tt><i>makeindex</i></tt><dd><a href="http://www.tex.ac.uk/tex-archive/indexing/makeindex.zip">indexing/makeindex</a> (or <a href="http://www.tex.ac.uk/tex-archive/indexing/makeindex/">browse the directory</a>)
<dt><tt><i>makeindex (Macintosh)</i></tt><dd><a href="http://www.tex.ac.uk/tex-archive/systems/mac/macmakeindex2.12.sea.hqx">systems/mac/macmakeindex2.12.sea.hqx</a>
<dt><tt><i>texindex (the script)</i></tt><dd><a href="http://www.tex.ac.uk/tex-archive/indexing/texindex.zip">indexing/texindex</a> (or <a href="http://www.tex.ac.uk/tex-archive/indexing/texindex/">browse the directory</a>)
<dt><tt><i>texindex (the program)</i></tt><dd>Distributed
  with <a href="http://www.tex.ac.uk/tex-archive/macros/texinfo/texinfo.zip">macros/texinfo/texinfo</a> (or <a href="http://www.tex.ac.uk/tex-archive/macros/texinfo/texinfo/">browse the directory</a>)
<dt><tt><i>texsis (system)</i></tt><dd><a href="http://www.tex.ac.uk/tex-archive/macros/texsis.zip">macros/texsis</a> (or <a href="http://www.tex.ac.uk/tex-archive/macros/texsis/">browse the directory</a>)
<dt><tt><i>texsis (makeindex support)</i></tt><dd><a href="http://www.tex.ac.uk/tex-archive/macros/texsis/index/index.tex">macros/texsis/index/index.tex</a>
<dt><tt><i>xindy</i></tt><dd><a href="http://www.tex.ac.uk/tex-archive/indexing/xindy/">indexing/xindy/</a>
</dl>
<p/><p>This question on the Web: <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=makeindex">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=makeindex</a>
</body>