summaryrefslogtreecommitdiff
path: root/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-multind.html
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-doc/doc/english/FAQ-en/html/FAQ-multind.html')
-rw-r--r--Master/texmf-doc/doc/english/FAQ-en/html/FAQ-multind.html44
1 files changed, 22 insertions, 22 deletions
diff --git a/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-multind.html b/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-multind.html
index 032560db89d..5bd54ce8209 100644
--- a/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-multind.html
+++ b/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-multind.html
@@ -2,7 +2,7 @@
<title>UK TeX FAQ -- question label multind</title>
</head><body>
<h3>Multiple indexes</h3>
-<p>LaTeX's standard indexing capabilities (those provided by the
+<p>LaTeX&rsquo;s standard indexing capabilities (those provided by the
<i>makeidx</i> package) only provide for one index in your
document; even quite modest documents can be improved by indexes for
separate topics.
@@ -11,25 +11,25 @@ multiple indexing. You tag each <code>\</code><code>makeindex</code>, <code>\</
<code>\</code><code>printindex</code> command with a file name, and indexing commands are
written to (or read from) the name with the appropriate (<code>.idx</code> or
<code>.ind</code>) extension appended. The <code>\</code><code>printindex</code> command is modified
-from the LaTeX standard so that it doesn't create its own chapter
+from the LaTeX standard so that it doesn&rsquo;t create its own chapter
or section heading; you therefore decide what names (or sectioning
level, even) to use for the indexes, and
<a href="FAQ-fixnam.html"><code>\</code><code>indexname</code></a> is completely ignored.
-<p>To create a "general" and an "authors" index, one might write:
+<p>To create a &ldquo;general&rdquo; and an &ldquo;authors&rdquo; index, one might write:
<blockquote>
<pre>
\usepackage{multind}
\makeindex{general}
\makeindex{authors}
...
-\index{authors}{Robin Fairbairns}
+\index{authors}{Another Idiot}
...
\index{general}{FAQs}
...
\printindex{general}{General index}
\printindex{authors}{Author index}
</pre>
-</blockquote>
+</blockquote><p>
To complete the job, run LaTeX on your file enough times that
labels, etc., are stable, and then execute the commands
<blockquote>
@@ -37,39 +37,39 @@ labels, etc., are stable, and then execute the commands
makeindex general
makeindex authors
</pre>
-</blockquote>
+</blockquote><p>
before running LaTeX again. Note that the names of the index files
to process are not necessarily related to the name of the LaTeX
-file you're processing, at all. (There's no documentation that comes
+file you&rsquo;re processing, at all. (There&rsquo;s no documentation that comes
with the package: what you see above is as good as you will
get...)
<p>The <i>index</i> package provides a comprehensive set of indexing
facilities, including a <code>\</code><code>newindex</code> command that allows the
-definition of new styles of index. <code>\</code><code>newindex</code> takes a 'tag' (for
+definition of new styles of index. <code>\</code><code>newindex</code> takes a &lsquo;tag&rsquo; (for
use in indexing commands), replacements for the <code>.idx</code> and
-<code>.ind</code> file extensions, and a title for the index when it's
-finally printed; it can also change the item that's being indexed
+<code>.ind</code> file extensions, and a title for the index when it&rsquo;s
+finally printed; it can also change the item that&rsquo;s being indexed
against (for example, one might have an index of artists referenced by
the figure number where their work is shown).
<p>Using <i>index</i>, to create an author index together with a
-"normal" index, one would start with preamble commands:
+&ldquo;normal&rdquo; index, one would start with preamble commands:
<blockquote>
<pre>
\usepackage{index}
\makeindex
\newindex{aut}{adx}{and}{Name Index}
</pre>
-</blockquote>
-which load the package, define a "main" (original-style) index, and
+</blockquote><p>
+which load the package, define a &ldquo;main&rdquo; (original-style) index, and
then define an author index. Then, in the body of the document, we
might find commands like:
<blockquote>
<pre>
-\index[aut]{Robin Fairbairns}
+\index[aut]{Another Idiot}
...
\index{FAQs}
</pre>
-</blockquote>
+</blockquote><p>
Which place an entry in the author index, and then one in the main
index. At the end of the document, we have two commands:
<blockquote>
@@ -77,18 +77,18 @@ index. At the end of the document, we have two commands:
\printindex
\printindex[aut]
</pre>
-</blockquote>
+</blockquote><p>
Which will print the main index and then the author index. Supposing
this lot to be in <i>myfile.tex</i>, after enough runs through
LaTeX that labels are stable, execute the following commands
(Unix-style shell commands shown here, but the principle is the same
-whatever system you're using):
+whatever system you&rsquo;re using):
<blockquote>
<pre>
makeindex myfile
makeindex myfile.adx -o myfile.and
</pre>
-</blockquote>
+</blockquote><p>
and rerun LaTeX. The <i>makeindex</i> commands process
<i>myfile.idx</i> to <i>myfile.ind</i> (the default action), and then
<i>myfile.adx</i> to <i>myfile.and</i>, the two files needed as input
@@ -98,15 +98,15 @@ others: load the package with the <code>split</code> option, and
declare each index with a <code>\</code><code>newindex</code> command:
<blockquote>
<code>\</code><code>newindex[&lt;<i>index name</i>&gt;]{&lt;<i>shortcut</i>&gt;}</code>
-</blockquote>
+</blockquote><p>
and <i>splitidx</i> will generate a file
<code>\</code><code>jobname</code><code>.&lt;<i>shortcut</i>&gt;</code> to receive index entries
generated by commands like <code>\</code><code>sindex[&lt;<i>shortcut</i>&gt;]{&lt;<i>item</i>&gt;}</code>.
-As with the other packages, this method is limited by TeX's total
+As with the other packages, this method is limited by TeX&rsquo;s total
number of output files. However, <i>splitindex</i> also comes with
a small executable <i>splitindex</i> (available for a variety of
-operating systems); if you use this auxiliary program (and don't use
-<code>split</code>), there's no limit to the number of indexes. Apart
+operating systems); if you use this auxiliary program (and don&rsquo;t use
+<code>split</code>), there&rsquo;s no limit to the number of indexes. Apart
from this trick, <i>splitidx</i> supports the same sorts of things
as does <i>index</i>. An example of use appears in
the documentation.