diff options
author | Karl Berry <karl@freefriends.org> | 2017-10-02 21:58:27 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2017-10-02 21:58:27 +0000 |
commit | b05bbbaa1cd9b63551731cdd1577f90225da2079 (patch) | |
tree | b00d557f9bddbf3a303b45572fce477b6484804d /Master/texmf-dist/doc/latex/robustindex/robustmanual.tex | |
parent | f3d0235a07baa8c6f8430bddcaa95ba3ad6de5ee (diff) |
robustindex (1oct17)
git-svn-id: svn://tug.org/texlive/trunk@45452 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/robustindex/robustmanual.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/robustindex/robustmanual.tex | 58 |
1 files changed, 46 insertions, 12 deletions
diff --git a/Master/texmf-dist/doc/latex/robustindex/robustmanual.tex b/Master/texmf-dist/doc/latex/robustindex/robustmanual.tex index 9f1b76b1595..103733c2580 100644 --- a/Master/texmf-dist/doc/latex/robustindex/robustmanual.tex +++ b/Master/texmf-dist/doc/latex/robustindex/robustmanual.tex @@ -1,12 +1,12 @@ -% robustmanual.tex +% robustmanual.tex 2017/09/29 \documentclass{article} \usepackage{makeidx} -\usepackage{robustindex} +\usepackage[multind]{robustindex} \usepackage[hyperindex=false]{hyperref} \title {Manual of robustindex package} -\author{Wilberd van der Kallen\index{Wilberd}} +\author{Wilberd van der Kallen\index{wilberd@Wilberd}} \date{2017} \makeindex % obligatory with robustindex @@ -84,10 +84,6 @@ If you want a page range in the index you have to use the \emph{explicit} page range mechanism of makeindex as in $$\verb!\index{discussion|(}!$$% used above -%\index{discussion}% inside range, hence would be suppressed. - -%\index{discussion|blah}% inside range, hence would be suppressed. - @@ -101,11 +97,21 @@ somewhere before the \verb!\printindex!. \index{alpha!see beta} Before discussing the \verb|multind| option we now use $\verb!\printindex!$ to get an index (on a new page). + \printindex \section*{The \texttt{multind} option} The \verb!multind! option provides -support for multiple indexes, albeit in a plain index style. +support for multiple indexes. For the package to function properly we now require that +the argument to an \verb!\index! command starts with at least two lower case +letters or with the symbol \verb!<!. +So use \verb!\index{new york@New York}! instead of \verb!\index{New York}!, \verb!\index{za@z}! +instead of \verb!\index{z}!. + +If you have an entry that should go before the letter a, then start the argument of \verb!\index! with \verb!<!, +as in \index{<@$<$ comes before alphabet}\verb!\index{<@$<$ comes before alphabet}!. + + Suppose the preamble contains \verb!\usepackage[multind]{robustindex}!. Let us say we want to use four indexes. First we choose tags to identify them. @@ -119,12 +125,21 @@ Thus \verb!\setindex{bis}! tells \LaTeX\ that the active index is now the index If a tag has not been encountered before, then a new index with that tag is created. The \verb!\index! command and -the \verb|\printindex| commands write to/from the active index. -This is all you need to know about option \verb!multind!.\\ +the \verb|\printindex| commands write to/from the active index. All indexes are hidden in one +big index file and \LaTeX\ knows how to find the active index in there. + +If you wish you may use \verb!\sindex[bis]{!\emph{entry}\verb!}! as shorthand for\\ + +\hspace{5em} \verb!\setindex{bis}\index{!\emph{entry}\verb!}!\\ + +and \verb!\sindex{!\emph{entry}\verb!}! as shorthand for\\ + + \hspace{5em} \verb!\setindex{main}\index{!\emph{entry}\verb!}!.\\ + -To see how option \verb!multind! may be used, you may also compare the file -\verb|multisample.tex| with the output after +The compilation sequence does not change. That is the main point of all our hacking. +For instance, the file \verb!multisample.tex! produces multiple indexes and is processed like this latex multisample.tex @@ -134,7 +149,26 @@ latex multisample.tex latex multisample.tex +\subsection*{Embellishment} +One may embellish an index with headings, like this. +\verb!\setindex{main}! + +\verb!\renewcommand{\indexname}{Embellished Index}! + +\verb!\renewcommand{\indexcapstyle}[1]{\indexspace\textsc{#1}\par}!% + +\verb!\printindex! \\ + +\noindent This gives + +\setindex{main} + +\renewcommand{\indexname}{Embellished Index} + +\renewcommand{\indexcapstyle}[1]{\indexspace\textsc{#1}\par}% + +\printindex \end{document} |