Mise à jour pour 2.4.0, 28 mai 2021 (JPC)
\end_layout
+\begin_layout Plain Layout
+Mise à jour pour 2.4.0, 28 novembre 2022 (JPC) : sémantique de
+\begin_inset Quotes cld
+\end_inset
+
+graphique
+\begin_inset Quotes crd
+\end_inset
+
+
+\end_layout
+
\end_inset
vous guidera dans ce choix.
\end_layout
+\begin_layout Standard
+
+\series bold
+Avertissement:
+\series default
+ dans le document, on utilise « graphique » en tant que raccourci de « objet
+ graphique »: graphique, diagramme, image, schéma, etc.
+\end_layout
+
\begin_layout Section
À quoi \SpecialChar LyX
ressemble-t-il?
\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
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
insécable
\family default
-.
- Voir la section
+; voir la section
\begin_inset space ~
\end_inset
\end_inset
- pour plus d'informations.).
+ pour plus d'informations).
En voici un exemple :
\end_layout
\family default
comme une espace de taille fixe
\begin_inset Foot
-status collapsed
+status open
\begin_layout Plain Layout
Dans l'environnement
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
\end_layout
\begin_layout Verbatim
+
This is Verbatim.
\end_layout
\begin_layout Verbatim
\noindent
\align block
+
The following 2 lines are empty:
\end_layout
\end_layout
\begin_layout Verbatim
+
Almost everything is allowed in Verbatim:"%&$§#~'`
\backslash
}][{|
\end_layout
\begin_layout Verbatim*
+
This is Verbatim*.
\end_layout
\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
\end_inset
-\begin_inset Quotes erd
+\begin_inset Quotes crd
\end_inset
.
\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 ~
\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
dans la barre d'outils, ou faites
\family sans
Insertion\SpecialChar menuseparator
-Graphique
+Graphique/image
\family default
.
Une fenêtre s'ouvre, qui vous permet de choisir le fichier à charger.
et en utilisant le menu
\family sans
Insertion\SpecialChar menuseparator
-Graphique
+Graphique/image
\family default
ou le bouton
\begin_inset Info
arg "index-insert"
\end_inset
- de la barre d'outils.
- Une boîte est insérée contenant le texte qui apparaîtra dans l'index.
+ de la barre d'outils (mais voyez la section
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Convenience-Functions-Index"
+
+\end_inset
+
+ pour quelques méthodes plus sophistiquée).
+ Un insert avec une étiquette verte est insérée: il contient le texte qui
+ apparaîtra dans l'index (si vous lisez ceci en \SpecialChar LyX
+, voyez la référence d'index
+ dans le titre de la présente section).
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
-.
+ (i.e.
+ copié dans l'insert).
\end_layout
\begin_layout Standard
\end_inset
apparaîtra à l'endroit où l'index sera imprimé dans la sortie finale.
- La boîte de l'index n'est pas cliquable comme les autre boîtes de \SpecialChar LyX
-.
+ Implicitement, l'insert de l'index n'est pas cliquable comme les autre
+ boîtes de \SpecialChar LyX
+, puisqu'il n'y a aucun réglage à préciser.
+ Ceci change si vous sélectionnez
+\begin_inset Quotes cld
+\end_inset
+
+Utilisez plusieurs index
+\begin_inset Quotes crd
+\end_inset
+
+ (voir la section
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Plusieurs-index"
+plural "false"
+caps "false"
+noprefix "false"
+
+\end_inset
+
+).
+ Dans ce cas, l'insert devient gris et cliquable, puisqu'il peut y avoir
+ de réglages à faire.
+\end_layout
+
+\begin_layout Standard
+Implicitement, une entrée d'index est simplement un mot ou un phrase dans
+ l'index (ordonné alphabétiquement), avec une référence à la ou les pages
+ où l’entrée d'index a été insérée dans le document.
+ Cependant, vous pouvez paramétrer les entrées d'index pour qu'elles apparaissen
+t différemment.
+ Vous pouvez grouper les entrée dans des arborescences, vous référer à une
+ série de pages plutôt qu'à une seule page, introduire une référence à une
+ autre entrée de l'index à la place ou en plus du numéro de page, vous pouvez
+ mettre en forme les références de pages (en gras par exemple pour certaines
+ pages spécifiques) et vous pouvez modifier l'ordre des entrées dans l'index.
+ Ces fonctionnalités sont disponibles en \SpecialChar LyX
+ soit comme des
+\begin_inset Quotes cld
+\end_inset
+
+sous-entrées
+\begin_inset Quotes crd
+\end_inset
+
+ via le menu
+\family sans
+Insertion\SpecialChar menuseparator
+Propriétés de l'index
+\family default
+ qui apparaît si le curseur se trouve dans une entrée d'index, ou bien par
+ le menu des paramètres d'index qui peut être ouvert par un clic droit dans
+ l'insert d'index.
\end_layout
\begin_layout Standard
status open
\begin_layout Plain Layout
-Rassembrer les entrées
+Rassembler les entrées
\end_layout
\end_inset
\end_inset
-\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
-
-Listes
-\begin_inset Quotes crd
-\end_inset
-
-.
- D'abord, nous allons créer une entrée
-\begin_inset Quotes cld
-\end_inset
-
-Listes
-\begin_inset Quotes crd
-\end_inset
-
- dans la section
-\begin_inset space ~
-\end_inset
-
-
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "sec:Env-par-listes"
-
-\end_inset
-
- qui est la section sur les listes.
- Nous insérons ensuite une entrée d'index dans la section
-\begin_inset space ~
-\end_inset
-
-
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "sec:Enumeration"
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:Rassembler-les-entrées"
\end_inset
- qui parle des énumérations.
- Dans le champ de l'entrée d'index, nous insérons la commande
-\end_layout
-
-\begin_layout Standard
-\series bold
-Listes
\end_layout
\begin_layout Standard
-On fait la même chose avec les listes à puces (section
-\begin_inset space ~
-\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
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "subsec:ListePuces"
+\emph on
+Pommes\SpecialChar menuseparator
-\end_inset
+\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
-), et cette fois on met la commande
+\family default
+Rassembler les entrées
+\emph default
+)
+\emph on
+.
\end_layout
\begin_layout Standard
-
-\series bold
-Listes
+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
\begin_layout Standard
-Le point d'exclamation
+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 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
-\begin_inset Quotes cld
+.
+ 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
-Listes
-\begin_inset Quotes crd
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Index-Special-Characters"
+
\end_inset
-, \SpecialChar LaTeX
- en imprimerait une quand même, mais sans numéro de page.
+ pour les détails.
\end_layout
\begin_layout Subsection
-Ensemble de pages consécutives
+Série de pages consécutives
\begin_inset Index idx
range none
pageformat default
\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 ~
+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ées 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 le même texte d'entrée d'index (et éventuelle
+ment les sous-entrées).
+ Pour marquer le début et la fin, sélectionner l'option
+\family sans
+Page initiale
+\family default
+ ou
+\family sans
+Page finale
+\family default
+ 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 CommandInset ref
-LatexCommand ref
-reference "sec:Environnements-par"
-
+(
+\begin_inset Quotes crd
\end_inset
- avec la commande
-\end_layout
-
-\begin_layout Standard
-
-\series bold
-Environnements de paragraphe|(
-\end_layout
-
-\begin_layout Standard
-et une autre à la fin de la section
-\begin_inset space ~
+ et
+\begin_inset Quotes cld
\end_inset
-
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "subsec:LyX-Code"
-
+)
+\begin_inset Quotes crd
\end_inset
- avec la commande
+.
\end_layout
\begin_layout Standard
\series bold
-Environnements de paragraphes|)
-\end_layout
-
-\begin_layout Standard
-Les commandes
-\begin_inset Quotes eld
-\end_inset
-
-
-\series bold
-|(
-\series default
-
-\begin_inset Quotes erd
-\end_inset
-
- et
-\begin_inset Quotes eld
-\end_inset
-
-
-\series bold
-|)
+Notez bien
\series default
-
-\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.
+ que vous devez vérifier que les marqueurs de début et de fin sont équilibrés.
+ Si une série commence sans qu'un marqueur de fin soit déclaré (et vice-versa),
+ le processeur d'index risque de stopper sans produire d'index et sans vous
+ informer de l'origine de l'erreur.
\end_layout
\begin_layout Subsection
\begin_layout Plain Layout
Index
\begin_inset IndexMacro subentry
-status open
+status collapsed
\begin_layout Plain Layout
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
-\end_inset
-
- (dans la section
+Il est aussi possible de faire référence à une autre entrée d'index à la
+ place de, ou en plus d'un numéro de page.
+ Ceci est utile si vous pensez que vos lecteurs pourraient chercher une
+ entrée à un endroit différent, par exemple
+\emph on
+Graphiques
+\emph default
+ ou
+\emph on
+Images
+\emph default
+ (ce qui peut être résolu par des références comme
+\emph on
+Images
+\emph default
+,
+\emph on
+voir
+\emph default
+
+\emph on
+Graphiques
+\emph default
+) ou bien si vous utilisez les regroupements arborescents (section
\begin_inset space ~
\end_inset
\begin_inset CommandInset ref
LatexCommand ref
-reference "subsec:Formats-d'images"
+reference "subsec:Rassembler-les-entrées"
+plural "false"
+caps "false"
+noprefix "false"
\end_inset
-) à l'entrée d'index
+), comme avec
+\emph on
+Pommes
+\emph default
+, voir
+\emph on
+Fruits
+\emph default
+.
+\end_layout
+
+\begin_layout Standard
+Ceci est possible en \SpecialChar LyX
+ via
+\family sans
+Insertion\SpecialChar menuseparator
+Propriétés d'Index\SpecialChar menuseparator
+Voir.
+\end_layout
+
+\begin_layout Standard
+Si vous voulez afficher une référence croisée et des références de page,
+ vous pouvez utiliser
+\family sans
+Insertion\SpecialChar menuseparator
+Propriétés d'Index\SpecialChar menuseparator
+Voir aussi
+\family default
+.
+ Ceci imprime
\begin_inset Quotes cld
\end_inset
-Formats d'images
+
+\emph on
+voir aussi
+\emph default
+
\begin_inset Quotes crd
\end_inset
- qui est dans la même section, en utilisant la commande
-\end_layout
+ et est plus approprié si vous ajoutez des entrées référencées par numéro
+ de page, comme dans
+\begin_inset Quotes cld
+\end_inset
-\begin_layout Standard
-\series bold
-GIF|see{Formats d'images}
-\end_layout
+\emph on
+Pommes
+\emph default
+, 3, 12, 22,
+\emph on
+voir aussi Fruits
+\emph default
+
+\begin_inset Quotes crd
+\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.
\end_layout
\begin_layout Subsection
\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
-
-\begin_inset Foot
-status collapsed
-
-\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
-
-
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "subsec:Programme-d'indexation"
-
-\end_inset
-
-.
+Parfois, l'ordre de tri des entrées dans la liste d'index n'est pas celui
+ que vous souhaitez.
+ Ceci peut être le cas avec certains processeurs d'index (comme
+\family sans
+makeindex
+\family default
+) si vous utilisez des caractères accentués dans vos entrées d'index.
\end_layout
+\begin_layout Standard
+Pour régler ce problème, vous pouvez utiliser
+\family sans
+Insertion\SpecialChar menuseparator
+Propriétés d'index\SpecialChar menuseparator
+Clé de tri
+\family default
+.
+ La clé spécifiée n'est pas affichée dans la liste d'index, elle est uniquement
+ utilisée pour le tri (à la place de l'entrée effective).
+ Par exemple, vous pouvez saisir la clé
+\begin_inset Quotes cld
\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
+etude
+\begin_inset Quotes crd
+\end_inset
-\begin_layout Plain Layout
-En français dans le texte (NdT)
+ pour trier le mot
+\emph on
+Étude
+\emph default
+ si votre processeur d'index ne sait pas trier alphabétiquement les caractères
+ accentués.
\end_layout
-\end_inset
-
+\begin_layout Standard
+Notez qu'en \SpecialChar LaTeX
+, la clé de tri est séparée du texte de l'entrée par le caractère
\begin_inset Quotes cld
\end_inset
-maison
+@
\begin_inset Quotes crd
\end_inset
-,
-\begin_inset Quotes cld
+.
+ Ceci fonctionne aussi en \SpecialChar LyX
+à condition que vous vous assuriez que le caractère
+ n'est pas mis en forme.
+ Pour cette raison, un vrai caractère @ doit être saisi d'une façon particulière
+, voir la section
+\begin_inset space ~
\end_inset
-maïs
-\begin_inset Quotes crd
-\end_inset
-, et
-\begin_inset Quotes cld
-\end_inset
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Index-Special-Characters"
-maître
-\begin_inset Quotes crd
\end_inset
-.
+ pour les détails.
+\end_layout
+
+\begin_layout Subsection
+Typographie des entrées d'index
\begin_inset Index idx
range none
pageformat default
status collapsed
\begin_layout Plain Layout
-Entrées bidons
+Index
\begin_inset IndexMacro subentry
status open
\begin_layout Plain Layout
-maïs
+Format des entrées
\end_layout
\end_inset
\end_inset
+\end_layout
+
+\begin_layout Standard
+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.
+ Les entrées apparaîtront dans la liste d'index avec la mise en forme du
+ texte de l'entrée.
\begin_inset Index idx
range none
pageformat default
-status collapsed
+status open
\begin_layout Plain Layout
Entrées bidons
status open
\begin_layout Plain Layout
-maître
+
+\shape italic
+Ceci est une entrée en italique
\end_layout
\end_inset
\end_inset
-\begin_inset Index idx
-range none
-pageformat default
-status collapsed
+\end_layout
-\begin_layout Plain Layout
-Entrées bidons
-\begin_inset IndexMacro subentry
-status open
+\begin_layout Standard
+Notez que ceci implique que deux entrées identiques par ailleurs seront
+ listées séparément dans l'index, comme par exemple Bananes et
+\series bold
+Bananes
+\series default
+.
+\end_layout
-\begin_layout Plain Layout
-\begin_inset IndexMacro sortkey
-status collapsed
+\begin_layout Standard
+Pour mettre en forme une références à un numéro de page, utilisez les cases
+ à cocher de mise en forme dans le menu de paramétrage des entrées d'index
+ via
+\family sans
+ Insertion\SpecialChar menuseparator
+Propriétés d'index
+\family default
+.
+ Vous pouvez sélectionner l'une des options proposées (
+\family sans
+gras
+\family default
+,
+\family sans
+italique
+\family default
+,
+\family sans
+en évidence
+\family default
+) ou choisir
+\family sans
+Personnalisée
+\family default
+.
+ Dans ce dernier cas, vous popuvez saisir une macro \SpecialChar LaTeX
+ valide sans la barre
+ injvers initiale, e.g.
+ une macro personnelle comme
+\family typewriter
+monformat
+\family default
+ ou une macro existante comme
+\family typewriter
+textsf
+\family default
+.
+\end_layout
-\begin_layout Plain Layout
-maïs
+\begin_layout Standard
+En général, nous vous encourageons à utiliser des commandes définies par
+ vous-mêmes.
+
+\lang english
+ use self-defined commands.
+ Ceci facilite la mise ne forme, si vous ou votre éditeur décide de chager
+ plus tard.
+ Par exemple, ajoutez une mavccro de mise en fortme pour les entrées se
+ référant à des numéros de la page ou l'entrée ets définie en insérant ceci
+ dans le préambule
\end_layout
-\end_inset
+\begin_layout Standard
+
+\series bold
-maison
+\backslash
+newcommand{
+\backslash
+IndexDef}[1]{
+\backslash
+textit{#1}}
\end_layout
-\end_inset
+\begin_layout Standard
+et ajoutez la misen page persopnnamisée
+\lang english
+
+\begin_inset Flex Code
+status collapsed
+\begin_layout Plain Layout
+\lang english
+IndexDef
\end_layout
\end_inset
- 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
+ dans les inserts d'entrées d'index appropriées.
\end_layout
\begin_layout Standard
-\series bold
-entrée
-\begin_inset space ~
-\end_inset
-
-précédente@entrée
-\begin_inset space ~
-\end_inset
+\lang english
+Avec cecio, toutes les rérérences de pages aux définitions des entre's d'index
+ seront imprimées en italique.
-courante
+\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 Standard
-Dans notre cas, nous voulons avoir
-\begin_inset Quotes cld
+
+\lang english
+\begin_inset Note Greyedout
+status open
+
+\begin_layout Plain Layout
+
+\series bold
+Nota:
+\series default
+ si vous préférez utiliser le processeur d'index
+\family sans
+ xindy
+\family default
+
+\family sans
+plutôt que makeindex ou xindex
+\family default
+ (voir section
+\begin_inset space ~
\end_inset
-maison
-\begin_inset Quotes crd
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Programme-d'indexation"
+plural "false"
+caps "false"
+noprefix "false"
+
\end_inset
- après
+), de telles macro personnalisées ne fonctionnent pas si simplement.
+ Ceci parce que
+\family sans
+xindy
+\family default
+ nécessite que vous définissiez des éléments sémantiques dans un
\begin_inset Quotes cld
\end_inset
-maïs
+module
\begin_inset Quotes crd
\end_inset
-.
- Nous écrivons donc comme entrée d'index pour le mot
-\begin_inset Quotes cld
+ xindy (fichier de style) avant de pouvoir utiliser des mises en forme.
+ Dans le cas présent, cela suppose d'ajouter la ligne suivante dans le fichier
+ module:
+\end_layout
+
+\begin_layout Verbatim
+(markup-locref :open "
+\backslash
+IndexDef{" :close "}" :attr "IndexDef")
+\end_layout
+
+\begin_layout Plain Layout
+Voyez
+\begin_inset space ~
\end_inset
-maison
-\begin_inset Quotes crd
+
+\begin_inset CommandInset citation
+LatexCommand cite
+after "p. 678 ff."
+key "latexcompanion"
+literal "true"
+
\end_inset
-:
+ pour les détails.
\end_layout
-\begin_layout Standard
+\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
+\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.
+ Il est en général plus approprié (et c'est requis pour des situations plus
+ complexes) de construire un fichier nommé
+\emph on
+Index Style File
+\emph default
+ (
+\emph on
+fichier de style d'inde
+\emph default
+x
+\family sans
+, makeindex
+\family default
+),
+\emph on
+module
+\emph default
+ (
+\family sans
+xindy
+\family default
+) or
+\emph on
+config file
+\emph default
+ (
+\emph on
+fichier de configuration
+\emph default
+,
+\family sans
+ xindex
+\family default
+) pour préciser la mise en forme.
+ Veuillez vous référer aux documentations respectives de
+\family sans
+makeindex,
+\family default
+
+\family sans
+xindy
+\family default
+ ou
+\family sans
+xindex
+\family default
+ pour les détails,
+\begin_inset CommandInset citation
+LatexCommand cite
+key "makeindex,xindex,xindy"
+literal "true"
-\begin_layout Subsection
-Typographie des entrées d'index
-\begin_inset Index idx
-range none
-pageformat default
+\end_inset
+
+.
+ Quelques paquetages \SpecialChar LaTeX
+ facilitent la mise en forme, voir
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset Flex URL
status collapsed
\begin_layout Plain Layout
-Index
-\begin_inset IndexMacro subentry
-status open
-\begin_layout Plain Layout
-Format des entrées
+https://ctan.org/topic/index
\end_layout
\end_inset
-
+.
\end_layout
+\begin_layout Subsection
+
+\lang english
+Special Characters in Index Entries
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:Index-Special-Characters"
+
\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_layout Plain Layout
-Entrées bidons
-\begin_inset IndexMacro subentry
-status open
+\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
-\shape italic
-Ceci est une entrée en italique
+\lang english
+!
\end_layout
\end_inset
+,
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+\lang english
+@
\end_layout
\end_inset
+,
+\begin_inset Flex Code
+status collapsed
-\shape slanted
-
-\shape default
-Vous pouvez aussi changer le format du numéro de page en utilisant le caractère
-
-\begin_inset Quotes cld
-\end_inset
+\begin_layout Plain Layout
-|
-\begin_inset Quotes crd
+\lang english
+\begin_inset Quotes qld
\end_inset
- suivi par une commande \SpecialChar LaTeX
- sans sa barre de fraction inverse.
- Par exemple, nous pouvons écrire
-\end_layout
-\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
+, and
+\begin_inset Flex Code
+status collapsed
\begin_layout Plain Layout
-numéro de page en italique
+
+\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
+\begin_layout Standard
+
+\lang english
+In order to use these characters in inset entries, they have to be
+\begin_inset Quotes els
\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
+escaped
+\begin_inset Quotes ers
\end_inset
+, 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
-\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 ~
+\end_layout
+
\end_inset
-de
-\begin_inset space ~
+ (but this can be changed).
+ So enter
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+\begin_inset Quotes qld
\end_inset
-page}
-\series default
-.
- Voyez la section
-\begin_inset space ~
+!
+\end_layout
+
\end_inset
+,
+\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
+
+,
+\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"
+\begin_inset Quotes qrd
+\end_inset
+
+
+\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"
+, or
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+\lang english
+\begin_inset Quotes qld
\end_inset
- pour plus de détails.
-
+|
\end_layout
\end_inset
+ to get the special character you want.
+ Note that the escape character,
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+\begin_inset Quotes qld
+\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 Standard
+\end_inset
-\series bold
+,
+\emph on
+must
+\emph default
+ be inserted in a TeX code box (see section
+\begin_inset space ~
+\end_inset
-\backslash
-newcommand{
-\backslash
-IndexDef}[1]{
-\backslash
-textit{#1}}
-\end_layout
-\begin_layout Standard
-and write
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:TeX-Code-Boxes"
+
+\end_inset
+
+).
\end_layout
-\begin_layout Standard
+\begin_layout Subsection
-\series bold
-mon entrée|IndexDef
+\lang english
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:Convenience-Functions-Index"
+
+\end_inset
+
+Convenience Functions for Index Handling
\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
+\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
-\begin_layout Plain Layout
-mon entrée
+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
+
+\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
\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
\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"
\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
\end_inset
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:Plusieurs-index"
+
+\end_inset
+
+
\end_layout
\begin_layout Standard
\end_layout
\begin_layout Subsection
-Graphique
+Graphique/image
\end_layout
\begin_layout Standard
-Insère un graphique.
+Insère un graphique ou une image.
Les graphiques sont décrits section
\begin_inset space ~
\end_inset
\family sans
Insertion\SpecialChar menuseparator
-Graphique
+Graphique/image
\end_layout
\end_inset
\end_inset
+\end_layout
+
+\begin_layout Bibliography
+\begin_inset CommandInset bibitem
+LatexCommand bibitem
+key "xindex"
+literal "true"
+
+\end_inset
+
+
+\begin_inset CommandInset href
+LatexCommand href
+name "Documentation"
+target "http://www.xindy.org/documentation.html"
+literal "false"
+
+\end_inset
+
+ du programme
+\family sans
+xindex
+\family default
+:
+\begin_inset Newline newline
+\end_inset
+
+
+\begin_inset Flex URL
+status collapsed
+
+\begin_layout Plain Layout
+
+http://mirrors.ctan.org/indexing/xindex/doc/xindex-doc.pdf
+\end_layout
+
+\end_inset
+
+
+\begin_inset Flex URL
+status collapsed
+
+\begin_layout Plain Layout
+
+http://www.xindy.org/documentation.html
+\end_layout
+
+\end_inset
+
+
\end_layout
\begin_layout Bibliography
\lang english
\begin_inset Note Note
-status open
+status collapsed
\begin_layout Plain Layout
Cette commande rend le numéro de page cliquable vers un lien hypertextuel,
projects / lyx.git / blobdiff