diff options
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.html | 44 |
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’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’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 “general” and an “authors” 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’re processing, at all. (There’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 ‘tag’ (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’s +finally printed; it can also change the item that’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: +“normal” 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 “main” (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’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[<<i>index name</i>>]{<<i>shortcut</i>>}</code> -</blockquote> +</blockquote><p> and <i>splitidx</i> will generate a file <code>\</code><code>jobname</code><code>.<<i>shortcut</i>></code> to receive index entries generated by commands like <code>\</code><code>sindex[<<i>shortcut</i>>]{<<i>item</i>>}</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’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’t use +<code>split</code>), there’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. |