]> git.lyx.org Git - lyx.git/commitdiff
Translation of new index features step 1
authorjpc <jpc@lyx.org>
Mon, 21 Nov 2022 17:34:07 +0000 (18:34 +0100)
committerjpc <jpc@lyx.org>
Mon, 21 Nov 2022 17:34:38 +0000 (18:34 +0100)
lib/doc/fr/UserGuide.lyx

index 16b42b45ad012e055c7b7ec9ddbf2c5b0e61bb62..ec5961a7d3c02b461c0ada7d752111c0b6ce3e66 100644 (file)
@@ -7315,7 +7315,7 @@ Espace
 \family default
  utilisée au début de la première ligne d'un élément, dit à \SpecialChar LyX
  de quitter
- le marqueur et de commencer le texte de la description .
+ le marqueur et de commencer le texte de la description.
 \end_layout
 
 \begin_layout Standard
@@ -7332,14 +7332,13 @@ Espace
 
 Insécable
 \family default
-.
- (Soit avec 
+ (soit avec 
 \begin_inset Info
 type  "shortcut"
 arg   "command-alternatives math-space ; space-insert protected"
 \end_inset
 
- soit avec 
+, soit avec 
 \family sans
 Insertion\SpecialChar menuseparator
 Formats\SpecialChar menuseparator
@@ -7349,8 +7348,7 @@ Espace
 
 insécable
 \family default
-.
- Voir la section
+; voir la section
 \begin_inset space ~
 \end_inset
 
@@ -7361,7 +7359,7 @@ reference "subsec:Espace-Insécable"
 
 \end_inset
 
- pour plus d'informations.).
+ pour plus d'informations).
  En voici un exemple :
 \end_layout
 
@@ -9365,7 +9363,7 @@ Espace
 \family default
  comme une espace de taille fixe
 \begin_inset Foot
-status collapsed
+status open
 
 \begin_layout Plain Layout
 Dans l'environnement 
@@ -9651,7 +9649,7 @@ Entrée
 Espace
 \family default
  est traitée comme une espace normale en texte (et pas comme une espace
protégée) et vous pouvez avoir des lignes vides.
insécable) et vous pouvez avoir des lignes vides.
  Contrairement à 
 \family sans
 \SpecialChar LyX
@@ -9682,12 +9680,14 @@ Verbatim
 \end_layout
 
 \begin_layout Verbatim
+
 This is Verbatim.
 \end_layout
 
 \begin_layout Verbatim
 \noindent
 \align block
+
 The following 2 lines are empty:
 \end_layout
 
@@ -9700,6 +9700,7 @@ The following 2 lines are empty:
 \end_layout
 
 \begin_layout Verbatim
+
 Almost everything is allowed in Verbatim:"%&$§#~'`
 \backslash
 }][{|
@@ -9732,6 +9733,7 @@ Verbatim
 \end_layout
 
 \begin_layout Verbatim*
+
 This is Verbatim*.
 \end_layout
 
@@ -12241,15 +12243,15 @@ reference "sec:Bibliographie"
 \begin_layout Standard
 Il semble évident qu'il serait judicieux de mettre une espace insécable
  entre 
-\begin_inset Quotes eld
+\begin_inset Quotes cld
 \end_inset
 
 section
-\begin_inset Quotes erd
+\begin_inset Quotes crd
 \end_inset
 
  et 
-\begin_inset Quotes eld
+\begin_inset Quotes cld
 \end_inset
 
 
@@ -12260,7 +12262,7 @@ reference "sec:Bibliographie"
 \end_inset
 
 
-\begin_inset Quotes erd
+\begin_inset Quotes crd
 \end_inset
 
 .
@@ -12373,7 +12375,7 @@ Inter-mots
 
 \begin_layout Standard
 Certaines langues comme l'anglais suivent la convention typographique d'ajouter
- un espace supplémentaire après la marque de ponctuation de fin de phrase
+ une espace supplémentaire après la marque de ponctuation de fin de phrase
  et \SpecialChar LyX
  respecte cette règle, voir la section
 \begin_inset space ~
@@ -12386,7 +12388,7 @@ reference "subsec:Abbreviations"
 
 \end_inset
 
- pour examples.
+ pour les exemples.
  Cependant, un espacement de fin de phrase après une abréviation suivie
  d'un point n'est pas souhaitable : dans ce cas, on insère l'espacement
  avec le menu 
@@ -34131,7 +34133,7 @@ type  "icon"
 arg   "index-insert"
 \end_inset
 
- de la barre d'outils.
+ de la barre d'outils mais voyez.
  Une boîte est insérée contenant le texte qui apparaîtra dans l'index.
  Le mot dans lequel le curseur se trouve ou la portion de texte qui est
  actuellement sélectionnée est proposé comme entrée d'index par \SpecialChar LyX
@@ -34193,7 +34195,7 @@ Rassembler les entrées d'index
 \begin_inset Index idx
 range none
 pageformat default
-status collapsed
+status open
 
 \begin_layout Plain Layout
 Index
@@ -34201,7 +34203,7 @@ Index
 status open
 
 \begin_layout Plain Layout
-Rassembrer les entrées
+Rassembler les entrées
 \end_layout
 
 \end_inset
@@ -34215,108 +34217,166 @@ Rassembrer les entrées
 \end_layout
 
 \begin_layout Standard
-Les entrées d'index sont souvent rassemblées pour permettre au lecteur une
- recherche plus rapide dans l'index.
- Par exemple, nous voulons rassembler les entrées concernant les listes
- à puces et les énumérations sous l'entrée 
-\begin_inset Quotes cld
-\end_inset
+Les entrées d'index sont souvent rassemblées en arborescences pour permettre
+ au lecteur une recherche plus rapide dans l'index et pour collecter les
+ catégories (e.g
+\emph on
+, Fruits
+\family sans
+\emph default
+\SpecialChar menuseparator
 
-Listes
-\begin_inset Quotes crd
-\end_inset
+\emph on
+Pommes\SpecialChar menuseparator
+
+\family default
+Reinettes
+\emph default
+).
+ Ceci peut se faire en \SpecialChar LyX
+ via 
+\family sans
+Insertion\SpecialChar menuseparator
+Propriétés de l'index \SpecialChar menuseparator
+Sous-entrée
+\family default
+ ou plus simplement en pressant la touche
+\family sans
+ Entrée
+\family default
+ dans un insert d'index.
+ Dans les deux cas s'ouvre un sous-insert dans lequel vous pouvez saisir
+ la sous-entrée.
+ Deux sous-inserts sont autorisés au maximum, i.e.
+ trois niveaux de groupage au plus par entrée d'index.
+ Notez que l'endroit où vous insérer ces sous-inserts dans l'entrée d'index
+ n'a pas d'importance, mais leur ordre compte et détermine l’arborescence
+ de groupage.
+ Dans le fichier \SpecialChar LyX
+, l'entrée d'index de l'en-tête ci-dessus illustre un exemple
+ d'une entrée à deux niveaux (et vous pouvez voir le résultat dans l'index
+ de ce document à l'entrée 
+\emph on
+Index
+\family sans
+\SpecialChar menuseparator
 
+\family default
+Rassembler les entrées
+\emph default
+)
+\emph on
 .
- D'abord, nous allons créer une entrée 
-\begin_inset Quotes cld
-\end_inset
+\end_layout
 
-Listes
-\begin_inset Quotes crd
-\end_inset
+\begin_layout Standard
+Dans le résultat imprimable, chaque sous-entrée est sur une nouvelle ligne
+ et un peu plus rentrée.
+ Notez que les niveaux les plus hauts n'ont leur propre référence de page
+ que s'ils apparaissent dans une entrée d'index isolée (sans sous-entrées).
+\end_layout
 
- dans la section
-\begin_inset space ~
+\begin_layout Standard
+Notez également que, en \SpecialChar LaTeX
+, les sous-entrées sont précédées par un point d'exclama
+tion 
+\begin_inset Quotes cld
 \end_inset
 
-
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "sec:Env-par-listes"
-
+!
+\begin_inset Quotes crd
 \end_inset
 
- qui est la section sur les listes.
- Nous insérons ensuite une entrée d'index dans la section
+.
+ Ceci_ fonctionne aussi en \SpecialChar LyX
+, bien qu'il faille prendre garde à ne pas mettre
+ en forme le caractère.
+ De ce fait, un vrai point d'exclamation doit être saisi dans une entrée
+ d'index de façon particulière.
+ voir la section
 \begin_inset space ~
 \end_inset
 
 
 \begin_inset CommandInset ref
 LatexCommand ref
-reference "sec:Enumeration"
+reference "subsec:Index-Special-Characters"
 
 \end_inset
 
- qui parle des énumérations.
- Dans le champ de l'entrée d'index, nous insérons la commande
+ pour les détails.
 \end_layout
 
-\begin_layout Standard
+\begin_layout Subsection
+Série de pages consécutives
+\begin_inset Index idx
+range none
+pageformat default
+status collapsed
 
-\series bold
-Listes
+\begin_layout Plain Layout
+Index
+\begin_inset IndexMacro subentry
+status open
+
+\begin_layout Plain Layout
+Pages consécutives
 \end_layout
 
-\begin_layout Standard
-On fait la même chose avec les listes à puces (section
-\begin_inset space ~
 \end_inset
 
 
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "subsec:ListePuces"
+\end_layout
 
 \end_inset
 
-), et cette fois on met la commande
-\end_layout
-
-\begin_layout Standard
 
-\series bold
-Listes
 \end_layout
 
 \begin_layout Standard
-Le point d'exclamation 
+Implicitement une entrée d'index se réfère à la seule page où cette entrée
+ a été insérée.
+ Si vous voulez vous référer plutôt à une série de pages, vous pouvez le
+ faire en insérant deux entrée s d'index: l'une marque le début de la série
+ de pages, l'autre marque la fin.
+ Les deux entrées doivent contenir la même entrée d'index (et éventuellement
+ les sous-entrées).
+ Pour marquer le début et la fin, sélectionner l'option 
+\family sans
+Page Range
+\family default
+ adéquate dans les paramètres de l'insert d'index.
+ Le début et la fin de la série de pages sont indiquées dans l'insert via
 \begin_inset Quotes cld
 \end_inset
 
-!
+(
 \begin_inset Quotes crd
 \end_inset
 
- marque les niveaux de regroupement.
- Vous pouvez avoir jusqu'à trois niveaux, chaque niveau d'index est décalé
- un peu plus par rapport au précédent.
- Il n'est pas obligatoire de créer une entrée d'index pour le niveau le
- plus élevé.
- Si nous n'avions pas d'entrée pour 
+ et 
 \begin_inset Quotes cld
 \end_inset
 
-Listes
+)
 \begin_inset Quotes crd
 \end_inset
 
-, \SpecialChar LaTeX
- en imprimerait une quand même, mais sans numéro de page.
+.
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+Note that you have to take care that range markers are complete.
+ If a range start without a respective end (or vice versa) is found, the
+ index processor might terminate and not produce an index without informing
+ you about the reason.
 \end_layout
 
 \begin_layout Subsection
-Ensemble de pages consécutives
+Références croisées
 \begin_inset Index idx
 range none
 pageformat default
@@ -34328,7 +34388,7 @@ Index
 status open
 
 \begin_layout Plain Layout
-Pages consécutives
+Références croisées
 \end_layout
 
 \end_inset
@@ -34342,95 +34402,110 @@ Pages consécutives
 \end_layout
 
 \begin_layout Standard
-En principe une entrée d'index apparaît avec le numéro de la page où se
- trouve la section indexée.
- Mais parfois vous avez besoin d'indexer un ensemble de pages sous une même
- entrée d'index.
- Par exemple, si nous voulons indexer les environnements de paragraphes,
- nous allons créer une entrée d'index dans la section
-\begin_inset space ~
-\end_inset
-
-
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "sec:Environnements-par"
+Il est aussi possible de faire référence à une autre entrée d'index.
 
+\lang english
+ rather than, or in addition to, a page.
+ This might be useful if you anticipate that your readers might look for
+ an entry at different places, e.
+\begin_inset space \thinspace{}
 \end_inset
 
- avec la commande
-\end_layout
-
-\begin_layout Standard
+g., 
+\emph on
+Graphics
+\emph default
+ or 
+\emph on
+Images
+\emph default
+ (which could be resolved by a cross reference 
+\begin_inset Quotes eld
+\end_inset
 
-\series bold
-Environnements de paragraphe|(
-\end_layout
+Images, 
+\emph on
+see
+\emph default
+ Graphics
+\begin_inset Quotes erd
+\end_inset
 
-\begin_layout Standard
-et une autre à la fin de la section
+) or also if you use hierarchical grouping (section
 \begin_inset space ~
 \end_inset
 
 
 \begin_inset CommandInset ref
 LatexCommand ref
-reference "subsec:LyX-Code"
+reference "subsec:Grouping-Index-Entries"
+
+\end_inset
+
+), as in 
+\begin_inset Quotes eld
+\end_inset
 
+Apples, 
+\emph on
+see
+\emph default
+ Fruits
+\begin_inset Quotes erd
 \end_inset
 
- avec la commande
+.
 \end_layout
 
 \begin_layout Standard
 
-\series bold
-Environnements de paragraphes|)
+\lang english
+This is possible in \SpecialChar LyX
+ via 
+\family sans
+Insert\SpecialChar menuseparator
+Index Properties\SpecialChar menuseparator
+See
+\family default
+.
 \end_layout
 
 \begin_layout Standard
-Les commandes 
+
+\lang english
+If you want a cross-reference and page references, you can use 
+\family sans
+Insert\SpecialChar menuseparator
+Index Properties\SpecialChar menuseparator
+Seealso
+\family default
+.
+ This outputs 
 \begin_inset Quotes eld
 \end_inset
 
-
-\series bold
-|(
-\series default
-
+see also
 \begin_inset Quotes erd
 \end_inset
 
- et 
+ instead and makes more sense if you also add entries that are referred
+ to by page number as in 
 \begin_inset Quotes eld
 \end_inset
 
-
-\series bold
-|)
-\series default
-
+Apples, 3, 12, 22, 
+\emph on
+see also
+\emph default
+ Fruits
 \begin_inset Quotes erd
 \end_inset
 
- respectivement ouvrent et ferment la plage de pages indexées.
- Vous pouvez aussi ajouter la même entrée d'index à plusieurs endroits de
- votre document.
- Elles apparaîtront toutes dans une seule entrée dans la liste d'index,
- avec une liste de numéros de pages séparés par des virgules.
- Un exemple est l'entrée d'index 
-\begin_inset Quotes cld
-\end_inset
-
-Document ! Paramètres
-\begin_inset Quotes crd
-\end_inset
-
- dans ce manuel.
+.
 \end_layout
 
 \begin_layout Subsection
-Références croisées
+Ordre des entrées d'index
 \begin_inset Index idx
 range none
 pageformat default
@@ -34442,7 +34517,7 @@ Index
 status open
 
 \begin_layout Plain Layout
-Références croisées
+Ordre des entrées
 \end_layout
 
 \end_inset
@@ -34456,53 +34531,81 @@ Références croisées
 \end_layout
 
 \begin_layout Standard
-Il est aussi possible de faire référence à une autre entrée d'index.
- Nous faisons référence, par exemple, dans l'entrée d'index 
-\begin_inset Quotes cld
-\end_inset
 
-GIF
-\begin_inset Quotes crd
+\lang english
+Sometimes the automatic ordering of index entries is not the one you want.
+ This might be the case with some index processors (such as 
+\family sans
+makeindex
+\family default
+) 
+\lang french
+si vous utilisez des caractères accentués dans vos entrées d'index.
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+To accommodate for that, you can use 
+\family sans
+Insert\SpecialChar menuseparator
+Index Properties\SpecialChar menuseparator
+Sortkey
+\family default
+.
+ The sortkey you enter here is not output in the index, it is just used
+ for sorting (instead of the actual entry).
+ For instance, you can pass the sort key 
+\begin_inset Quotes eld
 \end_inset
 
- (dans la section
-\begin_inset space ~
+zizek
+\begin_inset Quotes erd
 \end_inset
 
+ to sort the name 
+\emph on
+Žižek
+\emph default
+ should your index processor be incapable to sort Slovenian postmodern philosoph
+ers correctly.
+\end_layout
 
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "subsec:Formats-d'images"
+\begin_layout Standard
 
+\lang english
+Note that in \SpecialChar LaTeX
+, sortkeys are separated from the actual entry by the character
+\begin_inset Quotes eld
 \end_inset
 
-) à l'entrée d'index 
-\begin_inset Quotes cld
+@
+\begin_inset Quotes erd
 \end_inset
 
-Formats d'images
-\begin_inset Quotes crd
+.
+ This also works in \SpecialChar LyX
+, although you have to take care that the character
+ is not formatted.
+ For this reason, a real @ character has to be inserted to an index entry
+ in a specific way.
+ See section
+\begin_inset space ~
 \end_inset
 
- qui est dans la même section, en utilisant la commande
-\end_layout
 
-\begin_layout Standard
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Index-Special-Characters"
 
-\series bold
-GIF|see{Formats d'images}
-\end_layout
+\end_inset
 
-\begin_layout Standard
-Les accolades doivent être insérées en code \SpecialChar TeX
-.
- Le texte qui se trouve entre les accolades est l'entrée d'index à laquelle
- on fait référence.
- La référence apparaîtra à l'impression sans numéro de page.
+ for details.
 \end_layout
 
 \begin_layout Subsection
-Ordre des entrées d'index
+Typographie des entrées d'index
 \begin_inset Index idx
 range none
 pageformat default
@@ -34514,7 +34617,7 @@ Index
 status open
 
 \begin_layout Plain Layout
-Ordre des entrées
+Format des entrées
 \end_layout
 
 \end_inset
@@ -34528,489 +34631,633 @@ Ordre des entrées
 \end_layout
 
 \begin_layout Standard
-Vous pouvez utiliser des caractères accentués dans vos entrées d'index,
- mais dans ce cas les entrées risquent de ne plus suivre l'ordre correct.
- Les entrées d'index sont triées par ordre alphabétique, mais \SpecialChar LaTeX
+L'apparence de vos entrées d'index peut être mise en forme;comme d'habitude
+ grâce à la fenêtre de dialogue de style du texte, les barres d'outils ou
+ les raccourcis.
+\lang english
+Entries will appear in the index list in the way they are formatted in the
+ index entry.
+\lang french
 
-\begin_inset Foot
-status collapsed
+\begin_inset Index idx
+range none
+pageformat default
+status open
 
 \begin_layout Plain Layout
-La génération de l'index est réalisée en interne par un programme séparé,
- voir la section
-\begin_inset space ~
-\end_inset
+Entrées bidons
+\begin_inset IndexMacro subentry
+status open
 
+\begin_layout Plain Layout
 
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "subsec:Programme-d'indexation"
+\shape italic
+Ceci est une entrée en italique
+\end_layout
 
 \end_inset
 
-.
+
 \end_layout
 
 \end_inset
 
- ne sait pas comment ordonner les caractères accentués dans les différentes
- langues.
- Nous avons créé comme exemple trois entrées d'index bidons
-\begin_inset Note Note
-status collapsed
-
-\begin_layout Plain Layout
-En français dans le texte (NdT)
-\end_layout
-
-\end_inset
 
+\shape slanted
  
-\begin_inset Quotes cld
-\end_inset
+\shape default
+\lang english
+To format a page reference, use the 
+\family sans
+Format
+\family default
+ option in the index entry settings dialog.
+ You can either select one of the proposed formatting options (
+\family sans
+Bold
+\family default
+, 
+\family sans
+Italic
+\family default
+, 
+\family sans
+Emphasized
+\family default
+) or 
+\family sans
+Custom.
 
-maison
-\begin_inset Quotes crd
+\family default
+ With the latter, you are supposed to enter a valid \SpecialChar LaTeX
+ macro 
+\emph on
+without
+\emph default
+ leading backslash, e.
+\begin_inset space \thinspace{}
 \end_inset
 
-, 
-\begin_inset Quotes cld
-\end_inset
+g.
+ a self-defined command 
+\begin_inset Flex Code
+status collapsed
 
-maïs
-\begin_inset Quotes crd
-\end_inset
+\begin_layout Plain Layout
 
-, et 
-\begin_inset Quotes cld
-\end_inset
+\lang english
+myformat
+\end_layout
 
-maître
-\begin_inset Quotes crd
 \end_inset
 
-.
-\begin_inset Index idx
-range none
-pageformat default
+ or an existing macro such as 
+\begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
-Entrées bidons
-\begin_inset IndexMacro subentry
-status open
 
-\begin_layout Plain Layout
-maïs
+\lang english
+textsf
 \end_layout
 
 \end_inset
 
+.
+\end_layout
+
+\begin_layout Standard
+En général, nous vous encourageons à
+\lang english
+ use self-defined commands.
+ This makes it easier to change the formatting, should you or your publisher
+ decide to do that later.
 
+\lang french
+ de typographier les numéros de pages directement comme c'est décrit ci-dessus.
+ À la place, vous devriez écrire une macro dans le préambule et l'utiliser.
+ Peut-être voulez vous que toutes les pages qui font référence à la définition
+ du terme indexé soient en italique pour que le lecteur puisse retrouver
+ facilement les définitions.
+ Si c'est le cas, mettez ce qui suit dans le préambule
 \end_layout
 
-\end_inset
+\begin_layout Standard
 
+\series bold
 
-\begin_inset Index idx
-range none
-pageformat default
+\backslash
+newcommand{
+\backslash
+IndexDef}[1]{
+\backslash
+textit{#1}}
+\end_layout
+
+\begin_layout Standard
+and 
+\lang english
+add the custom formatting 
+\begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
-Entrées bidons
-\begin_inset IndexMacro subentry
-status open
 
-\begin_layout Plain Layout
-maître
+\lang english
+IndexDef
 \end_layout
 
 \end_inset
 
-
+ to the respective entry settings dialog.
 \end_layout
 
-\end_inset
+\begin_layout Standard
 
+\lang english
+This will cause all page references that use this custom format to be printed
+ in italics.
 
-\begin_inset Index idx
-range none
-pageformat default
-status collapsed
+\lang french
+ Si vous changez d'avis plus tard ou si votre éditeur demande que les définition
+s ne soient pas en italique, mais en gras, vous n'aurez qu'à modifier la
+ macro qui se trouve dans le préambule, et pas chacune des entrées d'index.
+\end_layout
 
-\begin_layout Plain Layout
-Entrées bidons
-\begin_inset IndexMacro subentry
-status open
+\begin_layout Standard
 
-\begin_layout Plain Layout
-\begin_inset IndexMacro sortkey
-status collapsed
+\lang english
+\begin_inset Note Greyedout
+status open
 
 \begin_layout Plain Layout
-maïs
-\end_layout
 
+\series bold
+\lang english
+Note:
+\series default
+ If you use the index processor 
+\family sans
+xindy
+\family default
+ rather than 
+\family sans
+makeindex or xindex
+\family default
+ (see section
+\begin_inset space ~
 \end_inset
 
-maison
-\end_layout
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Index-Program"
 
 \end_inset
 
+), such custom macros do not work out of the box.
+ This is because 
+\family sans
+xindy
+\family default
+ requires you to define semantic elements in the xindy 
+\begin_inset Quotes eld
+\end_inset
+
+module
+\begin_inset Quotes erd
+\end_inset
 
+ (style file) you use before they can be used.
+ In the given case, this would require to add the following line in the
+ module file:
 \end_layout
 
-\end_inset
+\begin_layout Verbatim
 
- elles seront triées dans l'ordre maïs, maître, maison, mais nous aurions
- préféré l'ordre maïs, maison, maître.
- Pour obtenir ce résultat, nous utilisons la commande
+(markup-locref :open "
+\backslash
+IndexDef{" :close "}" :attr "IndexDef")
 \end_layout
 
-\begin_layout Standard
+\begin_layout Plain Layout
 
-\series bold
-entrée
-\begin_inset space ~
-\end_inset
+\lang english
+Please refer to 
+\begin_inset CommandInset citation
+LatexCommand cite
+after "p. 678 ff."
+key "latexcompanion"
+literal "true"
 
-précédente@entrée
-\begin_inset space ~
 \end_inset
 
-courante
+ for details.
 \end_layout
 
-\begin_layout Standard
-Dans notre cas, nous voulons avoir 
-\begin_inset Quotes cld
 \end_inset
 
-maison
-\begin_inset Quotes crd
-\end_inset
 
- après 
-\begin_inset Quotes cld
-\end_inset
+\lang french
+Vous pouvez aussi changer la mise en forme de l'ensemble de votre index.
+ Par exemple, si vous marquez la boîte indiquant la position de l'index
+ en gras, toutes les entrées d'index seront en caractères gras.
+\lang english
+In general, however, it is better (and required for
+\lang french
+des situations plus complexes) 
+\lang english
+to set up a so-called 
+\emph on
+Index Style File
+\emph default
+ (
+\family sans
+makeindex
+\family default
+), 
+\emph on
+module
+\emph default
+ (
+\family sans
+xindy
+\family default
+) or 
+\emph on
+config file
+\emph default
+ (
+\family sans
+xindex
+\family default
+) to determine the formatting; please refer to the 
+\family sans
+makeindex,
+\family default
+\family sans
+xindy
+\family default
+ or 
+\family sans
+xindex
+\family default
+ documentations for details, 
+\begin_inset CommandInset citation
+LatexCommand cite
+key "makeindex,xindex,xindy"
+literal "true"
 
-maïs
-\begin_inset Quotes crd
 \end_inset
 
 .
- Nous écrivons donc comme entrée d'index pour le mot 
-\begin_inset Quotes cld
+ There are also some \SpecialChar LaTeX
+ packages available that ease such formatting, see
+\begin_inset Flex URL
+status collapsed
+
+\begin_layout Plain Layout
+
+https://ctan.org/topic/index
+\end_layout
+
 \end_inset
 
-maison
-\begin_inset Quotes crd
+.
+\lang french
+vous aurez à utiliser un fichier de style d'index (
+\emph on
+Index Style File
+\emph default
+), voyez la documentation de 
+\family sans
+makeindex
+\family default
+ ou de 
+\family sans
+xindy
+\family default
+ pour plus de détails, 
+\begin_inset CommandInset citation
+LatexCommand cite
+key "makeindex,xindy"
+literal "true"
+
 \end_inset
 
-:
+.
 \end_layout
 
-\begin_layout Standard
+\begin_layout Subsection
+
+\lang english
+Special Characters in Index Entries
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:Index-Special-Characters"
+
+\end_inset
+
 
-\series bold
-maïs@maison
 \end_layout
 
 \begin_layout Standard
-L'entrée précédente n'a pas besoin d'être une vraie entrée, présente dans
- le document, vous pouvez utiliser un mot qui donne à \SpecialChar LaTeX
- l'ordre dans lequel
- il doit classer l'entrée courante.
- Voyez la sous-section suivante pour un exemple.
-\end_layout
 
-\begin_layout Subsection
-Typographie des entrées d'index
-\begin_inset Index idx
-range none
-pageformat default
+\lang english
+As already mentioned above, some characters have a special meaning in index
+ entries, namely: 
+\begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
-Index
-\begin_inset IndexMacro subentry
-status open
 
-\begin_layout Plain Layout
-Format des entrées
+\lang english
+!
 \end_layout
 
 \end_inset
 
+, 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
 
+\lang english
+@
 \end_layout
 
 \end_inset
 
-
-\end_layout
-
-\begin_layout Standard
-Vous pouvez changer l'apparence de vos entrées d'index grâce à la fenêtre
- de dialogue de style du texte.
-\begin_inset Index idx
-range none
-pageformat default
-status open
+, 
+\begin_inset Flex Code
+status collapsed
 
 \begin_layout Plain Layout
-Entrées bidons
-\begin_inset IndexMacro subentry
-status open
 
-\begin_layout Plain Layout
+\lang english
+\begin_inset Quotes qld
+\end_inset
+
 
-\shape italic
-Ceci est une entrée en italique
 \end_layout
 
 \end_inset
 
+, and 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
 
+\lang english
+|
 \end_layout
 
 \end_inset
 
+.
+ If you use them literally, you might get surprising results or even a non-worki
+ng index.
+ In any case, you will not get the character itself.
+\end_layout
 
-\shape slanted
-\shape default
-Vous pouvez aussi changer le format du numéro de page en utilisant le caractère
-\begin_inset Quotes cld
+\begin_layout Standard
+
+\lang english
+In order to use these characters in inset entries, they have to be 
+\begin_inset Quotes els
 \end_inset
 
-|
-\begin_inset Quotes crd
+escaped
+\begin_inset Quotes ers
 \end_inset
 
- suivi par une commande \SpecialChar LaTeX
- sans sa barre de fraction inverse.
- Par exemple, nous pouvons écrire
-\end_layout
+, that is prepended by a character that tells the index processor to treat
+ this character without its special meaning.
+ By default, the escape character is 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+\begin_inset Quotes qld
+\end_inset
 
-\begin_layout Standard
 
-\series bold
-numéro de page en italique:|textit
 \end_layout
 
-\begin_layout Standard
-pour obtenir le numéro de page en italique.
-\begin_inset Index idx
-range none
-pageformat textit
-status open
+\end_inset
 
-\begin_layout Plain Layout
-Entrées bidons
-\begin_inset IndexMacro subentry
-status open
+ (but this can be changed).
+ So enter 
+\begin_inset Flex Code
+status collapsed
 
 \begin_layout Plain Layout
-numéro de page en italique
+
+\lang english
+\begin_inset Quotes qld
+\end_inset
+
+!
 \end_layout
 
 \end_inset
 
+, 
+\begin_inset Flex Code
+status collapsed
 
-\end_layout
+\begin_layout Plain Layout
 
+\lang english
+\begin_inset Quotes qld
 \end_inset
 
- Normalement, toutes les commandes \SpecialChar LaTeX
- commencent par une barre de fraction
- inverse, mais dans ce cas spécial 
-\begin_inset Quotes cld
+@
+\end_layout
+
 \end_inset
 
+, 
+\begin_inset Flex Code
+status collapsed
 
-\series bold
-|commande
-\series default
+\begin_layout Plain Layout
 
-\begin_inset Quotes crd
+\lang english
+\begin_inset Quotes qld
 \end_inset
 
- signifie en fait 
-\series bold
 
-\backslash
-commande{numéro
-\begin_inset space ~
+\begin_inset Quotes qrd
 \end_inset
 
-de
-\begin_inset space ~
-\end_inset
 
-page}
-\series default
-.
- Voyez la section
-\begin_inset space ~
+\end_layout
+
 \end_inset
 
+, or 
+\begin_inset Flex Code
+status collapsed
 
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "subsec:Syntaxe-de-Latex"
+\begin_layout Plain Layout
 
+\lang english
+\begin_inset Quotes qld
 \end_inset
 
- pour en apprendre un peu plus sur la syntaxe des commandes \SpecialChar LaTeX
-.
+|
 \end_layout
 
-\begin_layout Standard
-\begin_inset Note Greyedout
-status open
+\end_inset
+
+ to get the special character you want.
+ Note that the escape character, 
+\begin_inset Flex Code
+status collapsed
 
 \begin_layout Plain Layout
 
-\series bold
-Nota:
-\series default
- la typographie individuelle des entrées d'index ne fonctionne que si vous
- utilisez le programme 
-\family sans
-makeindex
-\family default
- pour générer l'index, voir la section
-\begin_inset space ~
+\lang english
+\begin_inset Quotes qld
 \end_inset
 
 
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "subsec:Programme-d'indexation"
+\end_layout
 
 \end_inset
 
-.
- Cependant, si vous utilisez 
-\family sans
-xindy
-\family default
-, cela ne fonctionnera que pour le texte en gras ou en italique.
- Cela vient du fait que 
-\family sans
-xindy
-\family default
- demande de redéfinir les éléments sémantiques avant qu'ils puissent être
- utilisés, voir 
-\begin_inset CommandInset citation
-LatexCommand cite
-after "p. 678 ff."
-key "latexcompanion"
-literal "true"
-
+, 
+\emph on
+must
+\emph default
+ be inserted in a TeX code box (see section
+\begin_inset space ~
 \end_inset
 
- pour plus de détails.
-\end_layout
 
-\end_inset
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:TeX-Code-Boxes"
 
+\end_inset
 
+).
 \end_layout
 
-\begin_layout Standard
-En général, nous vous déconseillons de typographier les numéros de pages
- directement comme c'est décrit ci-dessus.
- À la place, vous devriez écrire une macro dans le préambule et l'utiliser.
- Peut-être voulez vous que toutes les pages qui font référence à la définition
- du terme indexé soient en italique pour que le lecteur puisse retrouver
- facilement les définitions.
- Si c'est le cas, mettez ce qui suit dans le préambule
-\end_layout
+\begin_layout Subsection
 
-\begin_layout Standard
+\lang english
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:Convenience-Functions-Index"
 
-\series bold
+\end_inset
 
-\backslash
-newcommand{
-\backslash
-IndexDef}[1]{
-\backslash
-textit{#1}}
+Convenience Functions for Index Handling
 \end_layout
 
 \begin_layout Standard
-and write
-\end_layout
 
-\begin_layout Standard
+\lang english
+Indexing a document can be a tedious task, since you often have to insert
+ the same index entry multiple times in order to refer to passages at different
+ pages.
+ This is not only time-consuming, but also error-prone; e.
+\begin_inset space \thinspace{}
+\end_inset
 
-\series bold
-mon entrée|IndexDef
+g., you have to remember how exactly an inset entry has been inserted to
+ avoid redundant entries.
+ \SpecialChar LyX
+ provides some functions to ease the task.
 \end_layout
 
 \begin_layout Standard
-dans l'entrée d'index
-\begin_inset Index idx
-range none
-pageformat IndexDef
-status collapsed
-
-\begin_layout Plain Layout
-Entrées bidons
-\begin_inset IndexMacro subentry
-status open
-
-\begin_layout Plain Layout
-mon entrée
-\end_layout
 
+\lang english
+First, if you want to add an entry which you already used before, you can
+ open the outliner via 
+\family sans
+View\SpecialChar menuseparator
+Outline Pane
+\family default
+ (see section
+\begin_inset space ~
 \end_inset
 
 
-\end_layout
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:The-Outliner"
 
 \end_inset
 
-.
- L'avantage est que si vous changez d'avis plus tard ou si votre éditeur
- demande que les définitions ne soient pas en italique, mais en gras, vous
- n'aurez qu'à modifier la macro qui se trouve dans le préambule, et pas
- chacune des entrées d'index.
-\end_layout
-
-\begin_layout Standard
-Vous pouvez aussi changer la mise en forme de l'ensemble de votre index.
- Par exemple, nous avons mis la boîte indiquant la position de l'index en
- gras pour que toutes les entrées d'index soient en caractères gras.
- Pour des situations plus complexes vous aurez à utiliser un fichier de
- style d'index (
-\emph on
-Index Style File
-\emph default
-), voyez la documentation de 
+), select the 
 \family sans
-makeindex
+Index Entries
 \family default
- ou de 
+ section (it is convenient to have this open while indexing anyway), scroll
+ to the entry in question (if you check 
 \family sans
-xindy
+Sort
 \family default
- pour plus de détails, 
-\begin_inset CommandInset citation
-LatexCommand cite
-key "makeindex,xindy"
-literal "true"
+, it will be more easier), then 
+\emph on
+right
+\emph default
+-click on the entry and select 
+\family sans
+Insert Copy at Cursor Position
+\family default
+ from the context menu.
+ This will do just what it says: it will insert a copy of that index inset
+ at the position where the cursor is.
+\end_layout
 
-\end_inset
+\begin_layout Standard
 
+\lang english
+Second, \SpecialChar LyX
+ also provides a semi-automated solution to index a word.
+ If you right-click on an index entry inset, you can select from the context
+ menu 
+\family sans
+Index All Occurrences of this Word
+\family default
 .
+ This will search the whole document (only single documents, not master
+ and child documents) and insert a copy of this index inset after each occurrenc
+e of the word that precedes the inset.
+ Note that casing of the word does not matter, but only full words in the
+ same grammatical form are considered (so if 
+\emph on
+table
+\emph default
+ is the word before the index entry, 
+\emph on
+Table
+\emph default
+ will be considered as well, but not 
+\emph on
+tables
+\emph default
+).
+ Please take care to not overuse this function and to carefully check the
+ result afterwards.
+ Remember, a good index does not simply list all occurrences of a given
+ word in a specific document (that is a concordance rather), but only relevant
+ occurrences! So as convenient as this function might seem, it is suitable
+ especially for particular cases.
+ With others, you will have more work with removing again falsely inserted
+ entries than you would have with manually inserting them at the right place.
 \end_layout
 
 \begin_layout Subsection
@@ -35047,19 +35294,118 @@ name "subsec:Programme-d'indexation"
 \end_layout
 
 \begin_layout Standard
-Quand le programme de génération d'index 
+Si le programme de génération d'index 
 \family sans
 xindy
 \family default
  est installé, \SpecialChar LyX
- l'utilise implicitement, sinon il utilise le programme 
+ l'utilise implicitement
+\lang english
+ (the 
+\family sans
+texindy
+\family default
+ variant of it, for that matter)
+\lang french
+, sinon il utilise le programme 
+\family sans
+makeindex
+\family default
+, qui inclus dans toutes les distributions
+\lang english
+ \SpecialChar LaTeX
+.
+
+\lang french
+ Une autre option consiste à utiliser le processeur d'index relativement
+ nouveau
+\family sans
+\lang english
+ xindex
+\family default
+\end_layout
+
+\begin_layout Itemize
+
+\family sans
+\lang english
+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, section
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Index-Entry-Order"
+
+\end_inset
+
+, how to manually fix this sorting, but this is very tedious work).
+\end_layout
+
+\begin_layout Itemize
+
+\lang english
+The alternative program, 
+\family sans
+xindy
+\family default
+, is a newer and much more mighty alternative.
+ It can sort most languages correctly, and it is also much more customizable
+ in the output.
+ However, also 
+\family sans
+xindy
+\family default
+ is no longer actively maintained, and it has bugs that are most likely
+ not being addressed anytime soon.
+ Also, 
+\family sans
+xindy
+\family default
+ is not always available out of the box and quite a challenge to install
+ on some systems (particularly Windows).
+ But if you have it available, it is almost always a better option than
 \family sans
 makeindex
 \family default
 .
- Ces deux programmes peuvent être contrôlés par des options qui sont modifiées
- dans la fenêtre de dialogue des préférences de \SpecialChar LyX
- , voyez la section
+\end_layout
+
+\begin_layout Itemize
+
+\lang english
+The third option, 
+\family sans
+xindex
+\family default
+, is a quite new and actively developed index processor.
+ It is included in modern \SpecialChar TeX
+ distributions such as \SpecialChar TeX
+Live and Mik\SpecialChar TeX
+, is pretty
+ much customizable and supports many languages.
+ The program is still in development, so not everything might work equally
+ well than in the older processors.
+ But the program is definitely worth a try, particularly if 
+\family sans
+xindy
+\family default
+ does not work or not satisfy your needs.
+\end_layout
+
+\begin_layout Standard
+Tous les processeurs d'index peuvent être contrôlés par des options qui
+ sont modifiées dans la fenêtre de dialogue des préférences de \SpecialChar LyX
+ , voyez
+ la section
 \begin_inset space ~
 \end_inset
 
@@ -35071,7 +35417,19 @@ reference "subsec:LaTeX-settings"
 \end_inset
 
 .
- Les options disponibles sont listées et expliquées dans 
+ Les options disponibles sont listées et expliquées dans
+\lang english
+\begin_inset CommandInset citation
+LatexCommand cite
+key "makeindex-man,xindex,xindy"
+literal "true"
+
+\end_inset
+
+
+\lang french
 \begin_inset CommandInset citation
 LatexCommand cite
 key "makeindex-man,xindy"
@@ -35080,7 +35438,8 @@ literal "true"
 \end_inset
 
 .
- Vous pouvez aussi préciser un autre programme pour générer l'index.
+ Vous pouvez aussi préciser dans cette fenêtre un autre programme arbitraire
+ pour générer l'index.
 \end_layout
 
 \begin_layout Standard