diff options
author | Karl Berry <karl@freefriends.org> | 2018-05-02 20:49:48 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2018-05-02 20:49:48 +0000 |
commit | b0b1eec080787a40ef4abe3eec0d79fcba29d423 (patch) | |
tree | 0568b5577fd1539138cb71d64406377060ecdfde /Master/texmf-dist/doc/latex | |
parent | a64b09172eb57721992bd3f70e80997a6b7ee9d4 (diff) |
manyind (2may18)
git-svn-id: svn://tug.org/texlive/trunk@47574 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex')
-rw-r--r-- | Master/texmf-dist/doc/latex/manyind/README.md | 21 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/manyind/mind.html | 46 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/manyind/mindsample.pdf | bin | 0 -> 151815 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/manyind/mindsample.tex | 251 |
4 files changed, 318 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/manyind/README.md b/Master/texmf-dist/doc/latex/manyind/README.md new file mode 100644 index 00000000000..9ce930daa6f --- /dev/null +++ b/Master/texmf-dist/doc/latex/manyind/README.md @@ -0,0 +1,21 @@ +Package manyind.sty, Wilberd van der Kallen 2018. +Date of last change of _anything_ in the bundle 2018/05/01 + + This package provides support for many indexes, leaving all the bookkeeping to LaTeX and + makeindex. No extra programs or files are needed. One runs latex and makeindex as if + there is just one index. In the main file one puts commands like \setindex{main} to + steer the flow. + + Some features of makeindex may no longer work. + + [Home page of package](https://www.staff.science.uu.nl/~kalle101/mind.html) + + + Copyright 2018 Wilberd van der Kallen + + This package may be distributed under the conditions of the + LaTeX Project Public License, either version 1.2 of this license or + (at your option) any later version. The latest version of this license is in + [lpp.txt](http://www.latex-project.org/lppl.txt) + and version 1.2 or later is part of all distributions of LaTeX + version 1999/12/01 or later. diff --git a/Master/texmf-dist/doc/latex/manyind/mind.html b/Master/texmf-dist/doc/latex/manyind/mind.html new file mode 100644 index 00000000000..680c3c023d3 --- /dev/null +++ b/Master/texmf-dist/doc/latex/manyind/mind.html @@ -0,0 +1,46 @@ +<HTML> +<HEAD> +<TITLE>manyind package for LaTeX</TITLE> +</HEAD> + +<BODY> +<H1><A NAME="top"> manyind package for many indexes in LaTeX</A></H1> + + +<H2>Just run latex and makeindex as if there is one index only</H2> + The package +<A HREF="manyind.sty">manyind.sty</A> (version 2018/05/01) + provides support for many indexes, leaving all the bookkeeping to LaTeX and makeindex. + No extra programs or files are needed. One runs latex and makeindex as if there is + just one index. In the main file one puts commands like + \setindex{main} + to steer the flow. + + Some features of makeindex may no longer work. + + +<P>The sample file <A HREF="mindsample.tex">mindsample.tex</A> +explains and illustrates the usage. + +<P>After the old fashioned +<DL> +<DD>pdflatex <A HREF="mindsample.tex">mindsample.tex</A> +<DD>makeindex mindsample +<DD>pdflatex mindsample.tex +<DD>pdflatex mindsample.tex +</DL> +you should have something like <A HREF="mindsample.pdf">this PDF file</A>. + +<P>If you want several indexes with pagerefs you may try + \usepackage[multind]{robustindex} instead. + See <A HREF="https://www.staff.science.uu.nl/~kalle101/stind.html">Home page of + robustindex.sty</A> + +<BR> + +<BR><BR><BR> +<A HREF="https://www.staff.science.uu.nl/~kalle101/">Wilberd van der Kallen</A> + + +</BODY> +</HTML> diff --git a/Master/texmf-dist/doc/latex/manyind/mindsample.pdf b/Master/texmf-dist/doc/latex/manyind/mindsample.pdf Binary files differnew file mode 100644 index 00000000000..23326abb845 --- /dev/null +++ b/Master/texmf-dist/doc/latex/manyind/mindsample.pdf diff --git a/Master/texmf-dist/doc/latex/manyind/mindsample.tex b/Master/texmf-dist/doc/latex/manyind/mindsample.tex new file mode 100644 index 00000000000..9e3d674f75c --- /dev/null +++ b/Master/texmf-dist/doc/latex/manyind/mindsample.tex @@ -0,0 +1,251 @@ +% mindsample.tex 2018/04/29 +\documentclass{book} + +\usepackage{manyind} +\usepackage[plainpages=false,colorlinks=true]{hyperref} + +\title {Package manyind provides support for many indexes} + + +\author{Wilberd van der Kallen\index{Wilberd}} +\date{April 2018} + +\makeindex % obligatory with manyindex + +\begin{document} + +\renewcommand\thepage{\roman{page}} +\index{z}% ends up in index main. + + +\setindex{b1} + +\maketitle % So Wilberd will end up in index b1. + +\tableofcontents +\addcontentsline{toc}{chapter}{Contents} + + +\chapter*{Preface} + +\addcontentsline{toc}{chapter}{Preface} +\markboth{Preface}{Preface} +This file illustrates some features of the \verb!manyind! package. +One runs latex and makeindex as if there is just one index. No extra programs are required. +We let makeindex and \TeX\ do the work. As we are using makeindex in a way that was never intended, +some features of makeindex may not work anymore. + + 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. +In this file we use the tags \verb|main|, \verb|bis|, \verb|a1|, \verb|b1|. +With the \verb!\setindex! command we activate an index. +Thus \verb!\setindex{main}! (no spaces!) tells \LaTeX\ that the active index is now the index identified by the tag +\verb|main|, until the next \verb!\setindex! command. If a tag has not been encountered +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.\\ + +After running latex on {\it filename}.\verb!tex! one must run makeindex on {\it +filename} to get the index entries in {\it filename}.\texttt{ind}. +Before this there may be warnings about labels or names. +Do not exclude any relevant files. For instance, do not use +\verb|\includeonly|. + +(A tool like pdflatexmk in TeXShop on the MAC will call makeindex for you.)\\ + +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!}!.\\ + + One may give (at most) two optional arguments to \verb|\printindex|. +\noindent While + + \verb|\printindex| + +\noindent prints the active index, + + \verb|\printindex[b1]| + +\noindent first makes \verb|b1| the active index. + And + + \verb|\printindex[b1][Index with tag b1]| + + \noindent also first does a + \verb|\renewcommand{\indexname}{Index with tag b1}|. + + +To see how package \verb|manyind| may be used, you may also compare the file +\verb|mindsample.tex| with the output. + +This preface has an \emph{indexed term}.\setindex{b1}\index{indexed term} + (You see this in the source file only.) + +\chapter{Introduction}\sloppy +\renewcommand\thepage{\arabic{page}} +\addtocounter{page}{-6}% Just to get overlap in roman and arabic page numbers. +This introduction has another indexed term +\setindex{a1} +\index{other term!cited twice on same page}% +as well as the old indexed term.\setindex{b1}\index{indexed term}% will appear in an automatic page range +The page number is \thepage, but now in arabic. +If you index the same term twice on the same page, then it gets listed only once. + +We have hacked various mechanisms of makeindex. +Subentries are still supported. We illustrate this in +\verb|mindsample.tex| and appendix \ref{appendix} with alpha, beta and gamma (output on page \pageref{range}). +This also illustrates the use of \verb|\gobblepageref|, a variant of \verb!\see!. + +The package \verb|manyind| + is similar to option \verb!multind! of package \verb|robustindex|, but it does not + put any \verb|\pageref| in an index. Therefore it does not have to disable the automatic page range mechanism of makeindex. + +The index file {\it filename}.\texttt{ind} has become quite unreadable. Do not edit it. +Use the package \verb!manyind! only if you are willing to keep the indexes standard. + + +\setindex{a1}\index{alpha!see beta} +\index{alpha!see also gamma\gobblepageref} + +\newpage +\setindex{b1}\index{indexed term}% will appear in an automatic page range + +\setindex{b1}\index{page range!risky@this $\vert$is$\vert$ complicated|(textbf}% +\index{page range|(textit}% +\index{page range!risky@this $\vert$is$\vert$ complicated|textbf}% +\index{page range!risky@this $\vert$is$\vert$ complicated|textbf}% +\index{page range!risky@this $\vert$is$\vert$ complicated|textbf}% +% +\index{simpler!page range|(}% +\index{simplest page range|(}% +\setindex{b1}\index{indexed term}% will appear in an automatic page range +\appendix +\setindex{b1}\index{indexed term}% will appear in an automatic page range +\chapter{Structure of the \LaTeX\ file}\label{appendix} +\setindex{b1}\index{indexed term}% will appear in an automatic page range +\begin{verbatim} +\documentclass{book} + +\usepackage{manyind} +\usepackage[plainpages=false,colorlinks=true]{hyperref} + +... +...\author{Wilberd van der Kallen\index{Wilberd}} +... +\makeindex % obligatory with manyind + +\begin{document} +... +\tableofcontents +...\index{indexed term} % on page vi +... +...\index{other term!cited twice on same page} % on page 1 +...\index{indexed term} % on page 1 +...\index{other term!cited twice on same page} % on page 1 +... +\setindex{a1}\index{alpha!see beta} % on page 1 +\index{alpha!see also gamma\gobblepageref} % on page 1 +... +\indexincontents % before the indexes. +\setindex{main} +\printindex +... +\renewcommand{\indexcapstyle}[1]{\indexspace\textsc{#1}\par} +\printindex[main][Index with headings] +\end{document} +\end{verbatim} + +\setindex{b1}\index{indexed term}% will appear in an automatic page range + +\sindex{as! t@is} + +\index{tris} + +\setindex{main}\index{alpha} + +\setindex{a1}\index{gamma} + +\setindex{bis}\index{bis} + +\setindex{main}\index{delta!vardelta} + + +\setindex{main}\index{animal!than@fish} + + +\setindex{main}\index{time!here@now} + + +\setindex{b1}\index{page range!risky@this $\vert$is$\vert$ complicated|)textbf} + + +\index{page range|)textit}% + +\sindex[b1]{page range!risky@this $\vert$is$\vert$ complicated|textbf} + +% +\setindex{a1}\index{page range!with risky label\label{range}} +% This label actually works and was used above in a \pageref{range} command. +% +\sindex[b1]{simpler!page range|)}% +\index{simplest page range|)}% + + +% If you want the index in the table of contents, you may do +% +% \clearpage +% \phantomsection +% \addcontentsline{toc}{chapter}{\indexname} +% +% We have a command for this: + +\indexincontents % before \printindex + + + +\renewcommand{\indexname}{Index} +\setindex{main} +\printindex + +\renewcommand{\indexname}{Index bis} +\setindex{bis} +\printindex + + +\renewcommand{\indexname}{Index with tag a1} +\setindex{a1} +\printindex + + +\renewcommand{\indexname}{Index with tag b1} +\setindex{b1} +\printindex +\subsection*{Embellishment} +The command \verb!\indexcapstyle! +takes one argument. Its original definition is \verb!\newcommand{\indexcapstyle}[1]{\indexspace}!. + +One may embellish an index with letter headings, like this.\\ + +\setindex{main}\index{animal!ruminant!cow} + + +\verb!\renewcommand{\indexcapstyle}[1]{\indexspace\textsc{#1}\par}!% + + +\verb!\printindex[main][Index with headings]! \\ + +\noindent This gives + + + +\renewcommand{\indexcapstyle}[1]{\indexspace\textsc{#1}\par} +\printindex[main][Index with headings] + + +\end{document} |