* UserGuide: add documentation of the multiple indexes feature.

git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/trunk@31089 a592a061-630c-0410-9148-cb99ea01b6c8
This commit is contained in:
Jürgen Spitzmüller 2009-08-17 10:16:46 +00:00
parent db0c752fc2
commit eb657c9f8a

View File

@ -1,5 +1,5 @@
#LyX 2.0.0svn created this file. For more info see http://www.lyx.org/
\lyxformat 369
\lyxformat 370
\begin_document
\begin_header
\textclass scrbook
@ -97,6 +97,7 @@
\use_bibtopic false
\use_indices false
\paperorientation portrait
\suppress_date false
\branch Question
\selected 1
\filename_suffix 0
@ -107,6 +108,10 @@
\filename_suffix 0
\color #aa55ff
\end_branch
\index Index
\shortcut idx
\color #008000
\end_index
\secnumdepth 3
\tocdepth 3
\paragraph_separation indent
@ -115,8 +120,9 @@
\papercolumns 1
\papersides 2
\paperpagestyle default
\tracking_changes false
\tracking_changes true
\output_changes false
\author 1 "Jürgen Spitzmüller"
\end_header
\begin_body
@ -25576,13 +25582,25 @@ Entry
\end_inset
.
A gray box labeled
A
\change_deleted 1 1250501350
gray
\change_unchanged
box labeled
\begin_inset Quotes eld
\end_inset
\family sans
Idx
I
\change_inserted 1 1250501353
n
\change_unchanged
d
\change_inserted 1 1250501354
e
\change_unchanged
x
\family default
\begin_inset Quotes erd
@ -25607,6 +25625,8 @@ key "latexcompanion,latexguide,latexbook"
\end_layout
\begin_layout Standard
\change_deleted 1 1250501388
You can change index entries by clicking on the index box.
\end_layout
@ -26364,6 +26384,8 @@ key "makeindex,xindy"
\end_inset
.
\change_inserted 1 1250502076
\end_layout
\begin_layout Subsection
@ -26388,16 +26410,55 @@ name "sub:Index-Program"
\end_layout
\begin_layout Standard
When the index entry program
\change_deleted 1 1250501423
When
\change_inserted 1 1250501423
If
\change_unchanged
the index entry program
\family sans
xindy
\change_deleted 1 1250501596
\family default
, which is only available for Linux, is installed, LyX uses it for index
generation; otherwise the program
, which is only available for Linux,
\change_unchanged
is installed, LyX uses it for index generation; otherwise the program
\family sans
makeindex
\family default
, that is part of every LaTeX distribution, is used.
\change_inserted 1 1250501973
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
\change_inserted 1 1250502015
\family sans
Makeindex
\family default
is very old, no longer under development and has many pitfalls, notably
that it was developed with only the English language in mind.
So it fails to sort anything other than a monolingual English text correctly.
We have shown above how to fix this sorting.
However, if you are writing in another than the English language, consider
to use
\family sans
xindy
\family default
.
\change_unchanged
\end_layout
\end_inset
\change_unchanged
Both programs can be controlled by options that can be set in LyX's preferences
dialog, see section
\begin_inset space ~
@ -26419,11 +26480,48 @@ key "makeindex,xindy"
\end_inset
.
You can also specify there another program to generate the index.
\change_inserted 1 1250501656
In this dialog,
\change_deleted 1 1250501657
Y
\change_inserted 1 1250501657
y
\change_unchanged
ou can also specify
\change_deleted 1 1250501665
there another
\change_inserted 1 1250501676
an alternative
\change_unchanged
program to generate the index.
\change_inserted 1 1250501450
\end_layout
\begin_layout Standard
\change_inserted 1 1250501906
If you need specific options or an alternative index program only for a
given document, you can define the programm and\SpecialChar \slash{}
or the options in
\family sans
Document\SpecialChar \menuseparator
Settings\SpecialChar \ldots{}
\SpecialChar \menuseparator
Indexes
\family default
.
This is especially useful if you need to pass language-specific options
to the index program or if you need a specific layout style.
\change_deleted 1 1250501980
\end_layout
\begin_layout Standard
\change_deleted 1 1250501966
\family sans
makeindex
\family default
@ -26437,6 +26535,178 @@ makeindex
xindy
\family default
.
\change_inserted 1 1250502093
\end_layout
\begin_layout Subsection
\change_inserted 1 1250502212
Multiple Indexes
\end_layout
\begin_layout Standard
\change_inserted 1 1250502759
In many fields, it is common to have more than one index.
For instance, you might need to set up a separate
\begin_inset Quotes eld
\end_inset
Index of Names
\begin_inset Quotes erd
\end_inset
next to the standard index.
LaTeX does not provide this possibility out of the box, but there are many
packages that add this feature.
LyX uses the
\series bold
splitidx
\series default
\begin_inset Index idx
status collapsed
\begin_layout Plain Layout
\change_inserted 1 1250502516
LaTeX-packages ! splitidx
\end_layout
\end_inset
package to generate multiple indexes.
The package is included in all recent LaTeX distributions.
If yours does not ship it, consult the TeX Catalogue,
\begin_inset CommandInset citation
LatexCommand cite
key "TeXCatalogue"
\end_inset
.
Note that the package does not only consist of a LaTeX style, but it also
includes specific preprocessor programs that need to be installed as well.
Please consult the package's manual for details.
\end_layout
\begin_layout Standard
\change_inserted 1 1250503374
To set up LyX for the use of multiple indexes, go to
\family sans
Document\SpecialChar \menuseparator
Settings\SpecialChar \ldots{}
\SpecialChar \menuseparator
Indexes
\family default
and select
\begin_inset Quotes eld
\end_inset
Use multiple Indexes
\begin_inset Quotes erd
\end_inset
.
Note that the list of
\begin_inset Quotes eld
\end_inset
Available Indexes
\begin_inset Quotes erd
\end_inset
below already contains the standard index.
To add further indexes, add the name of the index (in the form that should
also appear as a heading) to the
\begin_inset Quotes eld
\end_inset
New
\begin_inset Quotes erd
\end_inset
input field and press the
\begin_inset Quotes eld
\end_inset
Add
\begin_inset Quotes erd
\end_inset
button.
The new index should now appear in the list as well.
If you like, you can attribute an alternative label color to the new index
by selecting the index in the list and hitting the
\begin_inset Quotes eld
\end_inset
Alter Color\SpecialChar \ldots{}
\begin_inset Quotes erd
\end_inset
button.
The label color may help you to differentiate index entries of different
indexes in the LyX work area.
\end_layout
\begin_layout Standard
\change_inserted 1 1250503916
Once the document changes have been applied, you can find the new index
list in
\family sans
Insert\SpecialChar \menuseparator
List
\begin_inset space ~
\end_inset
/
\begin_inset space ~
\end_inset
TOC
\family default
and the
\family sans
Insert
\family default
menu has a separate index entry for each of the defined indexes.
The workflow is basically the same as for the default index, but there
are some additional features:
\end_layout
\begin_layout Itemize
\change_inserted 1 1250503922
If you want to change the attribution of a specific index entry, right-clicking
on the entry will open a dialog where you can do that.
\end_layout
\begin_layout Itemize
\change_inserted 1 1250504088
By right-clicking on an index, you can change its type.
Furthermore, you can specify an index list to be a
\begin_inset Quotes eld
\end_inset
Subindex
\begin_inset Quotes erd
\end_inset
.
If you do that, the heading of that list will be decreased by one level.
E.
\begin_inset space \thinspace{}
\end_inset
g., if you use a book class, where the standard index heading is defined
as a chapter, subindexes will be defined as sections and can thus be nested
to the non-subindexes.
\end_layout
\begin_layout Section
@ -39857,7 +40127,13 @@ Bibliography
\end_layout
\begin_layout Standard
You can specify here a citation style using the LaTeX-packages
You can specify here a citation style using the LaTeX
\change_inserted 1 1250501112
\change_deleted 1 1250501112
-
\change_unchanged
packages
\series bold
natbib
\series default
@ -39885,6 +40161,27 @@ LaTeX-packages ! jurabib
\end_inset
\change_inserted 1 1250501161
, you can enable subdivided bibliographies using the LaTeX package
\series bold
bibtopic
\series default
\begin_inset Index idx
status collapsed
\begin_layout Plain Layout
\change_inserted 1 1250501123
LaTeX-packages ! bibtopic
\end_layout
\end_inset
and you can customize how the bibliography of the given document is being
generated
\change_unchanged
.
For a further description see section
\begin_inset space ~
@ -39898,6 +40195,35 @@ reference "sec:Bibliography"
\end_inset
.
\change_inserted 1 1250501100
\end_layout
\begin_layout Section
\change_inserted 1 1250500845
Indexes
\end_layout
\begin_layout Standard
\change_inserted 1 1250501193
Here, you can customize how the index of your document is being generated
and you can define additional indexes.
Please refer to section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
reference "sec:Index"
\end_inset
for details.
\change_unchanged
\end_layout
\begin_layout Section