summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/robustindex/multisample.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/robustindex/multisample.tex')
-rw-r--r--Master/texmf-dist/doc/latex/robustindex/multisample.tex167
1 files changed, 32 insertions, 135 deletions
diff --git a/Master/texmf-dist/doc/latex/robustindex/multisample.tex b/Master/texmf-dist/doc/latex/robustindex/multisample.tex
index 39e57112dff..545d19f8149 100644
--- a/Master/texmf-dist/doc/latex/robustindex/multisample.tex
+++ b/Master/texmf-dist/doc/latex/robustindex/multisample.tex
@@ -1,22 +1,22 @@
-% multisample.tex
+% multisample.tex 2017/09/29
\documentclass{book}
\usepackage{makeidx}
\usepackage[multind]{robustindex}
-\usepackage{robustglossary}
\usepackage[plainpages=false,hyperindex=false]{hyperref}
\title {A file with several indexes}
-\author{Wilberd van der Kallen\index{Wilberd}}
+\author{Wilberd van der Kallen\index{wilberd@Wilberd}}
\date{2017}
\makeindex % obligatory with robustindex
\makeglossary % obligatory with robustglossary
\begin{document}
-
+%\renewcommand{\indexcapstyle}[1]{\par\vskip1em plus.5em minus.3em\textbf{\uppercase{#1}}}
\renewcommand\thepage{\roman{page}}
+\index{zz@z}
\setindex{b1}
@@ -35,7 +35,11 @@
\addcontentsline{toc}{chapter}{Preface}
\markboth{Preface}{Preface}
This file illustrates some features of the \verb!robustindex! package with option \verb!multind!. This option
- supports multiple indexes, albeit in a plain style only.
+ supports multiple indexes. We 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}!.
+
Although this is not a book, we have chosen the book style for illustration.
Let us say we want to use four indexes. First we choose tags to identify them.
@@ -46,8 +50,7 @@ Thus \verb!\setindex{main}! tells \LaTeX\ that the active index is now the index
before, then a new index with that tag is created. The tag \verb|main| is always known and
the index with tag \verb|main| becomes active at the \verb|\begin{document}|.
The \verb!\index! command and
-the \verb|\printindex| commands write to/from the active index.
-This is all you need to know about the option \verb!multind!.\\
+the \verb|\printindex| commands write to/from the active index.\\
If you wish you may use \verb!\sindex[bis]{!\emph{entry}\verb!}! as shorthand for\\
@@ -76,12 +79,9 @@ a repeat in the index.\setindex{a1}\index{other term!cited twice on same page}
That is inherent in our method.
Indeed we had to disable the implicit page range formation of makeindex.
-Of course the index file {\it filename}.\texttt{ind}
-may be edited to remedy such flaws, but our hacking has made this file pretty unreadable.
-Use the option \verb!multind! only if you are willing to keep the indexes simple. Even without editing the index file
-one may create complicated effects like the page ranges on
-page \pageref{range}, which use several fonts in their page numbers.
-That is bad style, but it is possible. Note that if you open a page range you must close
+The index file {\it filename}.\texttt{ind} has become quite unreadable. Do not edit it.
+Use the option \verb!multind! only if you are willing to keep the indexes standard.
+Note that if you open a page range you must close
it again with the same index active as when you opened the range.
We have hacked various mechanisms of makeindex.
@@ -124,8 +124,9 @@ because of the roman page numbers in the beginning.
\usepackage{makeidx}
\usepackage[multind]{robustindex}
+\usepackage[plainpages=false,hyperindex=false]{hyperref}
...
-...\author{Wilberd van der Kallen\index{Wilberd}}
+...\author{Wilberd van der Kallen\index{wilberd@Wilberd}}
...
\makeindex % obligatory with robustindex
@@ -141,21 +142,20 @@ because of the roman page numbers in the beginning.
\setindex{a1}\index{alpha!see beta} % on page 5
\index{alpha!see also gamma\gobblepageref} % on page 5
...
-...
\indexincontents % before the index.
\setindex{main}
\printindex
-
-\renewcommand{\indexname}{Index bis}
-....
+...
+\renewcommand{\indexcapstyle}[1]{\indexspace\textsc{#1}\par}
+\renewcommand{\indexname}{Index with headings}
+\setindex{main}
+\printindex
\end{document}
\end{verbatim}
-\index{c1int@as! t@is}
+\index{as! t@is}
-\index{998b@998}
-
-\index{997b@tris}
+\index{tris}
\setindex{main}\index{alpha}
@@ -163,12 +163,12 @@ because of the roman page numbers in the beginning.
\setindex{bis}\index{bis}
-\setindex{main}\index{hier@vardelta}
+\setindex{main}\index{delta!vardelta}
+
-%\setindex{main}\index{hier@animal!than@fish}
-\setindex{main}\index{hier@animal!than@fish}
+\setindex{main}\index{animal!than@fish}
-\setindex{main}\index{hier@animal!ruminant!cow}
+\setindex{main}\index{animal!ruminant!cow}
\setindex{main}\index{time!here@now}
@@ -195,7 +195,7 @@ With option \verb!multind! the package supports multiple indexes. But one still
latex \emph{filename}.tex, makeindex \emph{filename}, latex \emph{filename}.tex.
\index{page range|)textit}%
-%\setindex{b1}\index{page range!risky@this $\vert$is$\vert$ complicated|texttt}
+
\sindex[b1]{page range!risky@this $\vert$is$\vert$ complicated|texttt}
%
@@ -204,58 +204,7 @@ latex \emph{filename}.tex, makeindex \emph{filename}, latex \emph{filename}.tex.
%
\index{simpler!page range|)}%
\index{simplest page range|)}%
-% Let us pretend this page explains $\mathrm{Ext}^i_B(M,N)$.
-\glossary{$\mathrm{Ext}^i_B(M,N)$&Ext group in the category $\mathcal C_B$}
-
-% Let us pretend this page explains $H^0(X,\mathcal L)$.
-\glossary{$H^0(X,\mathcal L)$&the sections of the vector bundle
-$\mathcal L|_X$ over $X$}
-
-
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-%
-% Our glossary entries are given in the format
-% \glossaryentry{$B$&Borel subgroup}{page number}
-% which would be generated by \glossary{$B$&Borel subgroup}
-% and written into the filename.glo file.
-% So the & separates the formula from its explanation.
-% We assume the explanation fits on the line.
-%
-% Our implementation:
-
-\def\itemamp#1&#2{%
- \mbox{%
- \hbox to 10em{%
- #1% the formula
- \hss
- }%
- }%
- #2% its explanation
-}%
-
-\def\glossaryentry#1#2{%
- {\itemamp #1{\unskip, #2}%
- }\par
-}%
-
-\newenvironment{theglossary}{\parindent0pt\parskip0pt}{}
-
-\chapter*{Glossary of Notations}
-
-\begin{theglossary}\addcontentsline{toc}{chapter}{Glossary of Notations}
-
-% Now we copy from filename.glo, making changes as appropriate.
-% In this example we just changed the order of the entries.
-
-\glossaryentry{$H^0(X,\mathcal L)$&the sections of the vector bundle $\mathcal
-L
-|_X$ over $X$}{\glopageref{4}}
-\glossaryentry{$\mathrm{Ext}^i_B(M,N)$&Ext group in the category $\mathcal
-C_B$}
-{\glopageref{2}}
-
-\end{theglossary}
% If you want the index in the table of contents, you may do
%
@@ -267,9 +216,8 @@ C_B$}
\indexincontents % before \printindex
-\let\oldpage\newpage
-%\def\newpage{\relax}
+
\renewcommand{\indexname}{Index}
\setindex{main}
@@ -283,65 +231,14 @@ C_B$}
\setindex{a1}
\printindex
+
\renewcommand{\indexname}{Index with tag b1}
\setindex{b1}
\printindex
-\chapter*{Indexes get plain layout}\addcontentsline{toc}{chapter}{Indexes get plain layout}
-Our option \verb!multind! breaks yet another mechanisms of makeindex.
-Recall that \verb!robustindex! breaks automatic page ranges. The option \verb!multind! prevents
-makeindex from inserting
- \verb!\indexspace! commands at appropriate points in the index file.
-This makes the layout of an index more plain.
-Let us compare the index produced by \verb!\robustmanual.tex! with the same index produced
-after the package
-\verb!robustindex! is called with the option \verb!multind!.
-Curiously the order changes a little too.
-To get them in the same order replace \verb!\index{Wilberd}! with \verb!\index{wilberd@Wilberd}!.
-
-\renewcommand{\indexname}{First without option }
-\begin{theindex}
-
- \item alpha, 1
- \subitem see also gamma
- \subitem see beta, 2
- \item \&, {\textbf2}
-
- \indexspace
-
- \item discussion, 1--2
-
- \indexspace
-
- \item gamma, {\textbf2}
-
- \indexspace
-
- \item Wilberd, 1
-
-\end{theindex}
-\renewcommand{\indexname}{Next with option \texttt {multind} }
+\renewcommand{\indexcapstyle}[1]{\indexspace\textsc{#1}\par}
+\renewcommand{\indexname}{Index with headings}
\setindex{main}
-\begin{theindex}
-
-\item Wilberd, 1
-
-
- \item alpha, 1
- \subitem see also gamma
- \subitem see beta, 2
- \item \&, {\textbf2}
-
-
- \item discussion, 1--2
-
-
-
- \item gamma, {\textbf2}
-
-
-
-\end{theindex}
-
+\printindex
\end{document}