]> git.lyx.org Git - lyx.git/blobdiff - lib/doc/fr/Customization.lyx
Update of localized versions of Customization manual
[lyx.git] / lib / doc / fr / Customization.lyx
index 3c9a4da4882230a847ee14d40885a4c5823e7bcd..0427c35ea32c15f7e27a1c5331937b65a408b9f1 100644 (file)
@@ -1,5 +1,5 @@
 #LyX 2.3 created this file. For more info see http://www.lyx.org/
-\lyxformat 541
+\lyxformat 544
 \begin_document
 \begin_header
 \save_transient_properties true
@@ -100,6 +100,7 @@ logicalmkup
 \suppress_date false
 \justification true
 \use_refstyle 0
+\use_minted 0
 \notefontcolor #0000ff
 \branch Obsolete
 \selected 0
@@ -115,7 +116,10 @@ logicalmkup
 \paragraph_separation indent
 \paragraph_indentation default
 \is_math_indent 1
+\math_indentation default
+\math_numbering_side default
 \quotes_style swiss
+\dynamic_quotes 0
 \papercolumns 1
 \papersides 2
 \paperpagestyle headings
@@ -124,6 +128,7 @@ logicalmkup
 \html_math_output 0
 \html_css_as_file 0
 \html_be_strict false
+\author 34634807 "Jean-Pierre"
 \end_header
 
 \begin_body
@@ -237,7 +242,7 @@ Nouvel exemple pour le paragraphe 4.1.1.1 + quelques corrections mineures,
 \begin_inset Newline newline
 \end_inset
 
-Version 2.2.x
+Version 2.3.x
 \end_layout
 
 \begin_layout Standard
@@ -620,6 +625,47 @@ $LANG_xxx.bind
 , celle-ci sera détectée et utilisée en premier.
 \end_layout
 
+\begin_layout Labeling
+\labelwidthstring 00.00.0000
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+citeengines/
+\end_layout
+
+\end_inset
+
+ contains files with the extension 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+.citeengine
+\end_layout
+
+\end_inset
+
+ which define the diverse citation possibilities (natbib, biblatex etc.).
+ See 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Cite-Engine-Files"
+plural "false"
+caps "false"
+noprefix "false"
+
+\end_inset
+
+ for details.
+\end_layout
+
 \begin_layout Labeling
 \labelwidthstring 00.00.0000
 \begin_inset Flex Code
@@ -893,6 +939,45 @@ status collapsed
  les menus et quels éléments apparaissent dans la barre d'outils.
 \end_layout
 
+\begin_layout Labeling
+\labelwidthstring 00.00.0000
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+xtemplates/
+\end_layout
+
+\end_inset
+
+ contains files with the extension 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+.xtemplate
+\end_layout
+
+\end_inset
+
+ which define the templates for the insertion of external material to a
+ \SpecialChar LyX
+ document; see 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "chap:Including-External-Material"
+
+\end_inset
+
+.
+\end_layout
+
 \begin_layout Subsection
 Fichiers que vous n'avez pas à modifier
 \end_layout
@@ -973,40 +1058,6 @@ encodings
 \begin_layout Labeling
 \labelwidthstring 00.00.0000
 
-\family typewriter
-external_templates
-\family default
- contient les modèles disponibles pour la nouvelle fonction d'
-\begin_inset Flex Noun
-status collapsed
-
-\begin_layout Plain Layout
-Objet
-\begin_inset space ~
-\end_inset
-
-Externe
-\end_layout
-
-\end_inset
-
-, voir
-\begin_inset space ~
-\end_inset
-
-
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "chap:Insérer-un-Objet"
-
-\end_inset
-
-.
-\end_layout
-
-\begin_layout Labeling
-\labelwidthstring 00.00.0000
-
 \family typewriter
 languages
 \family default
@@ -7251,6 +7302,164 @@ Le convertisseur ne gère que les changements de syntaxe.
  ceux-ci doivent être convertis séparément.
 \end_layout
 
+\begin_layout Subsection
+
+\lang english
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:Cite-Engine-Files"
+
+\end_inset
+
+Cite engine files
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+A specific form of layout files are the so-called 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+*.citeengine
+\end_layout
+
+\end_inset
+
+ files that are located in the 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+citeengines/
+\end_layout
+
+\end_inset
+
+ sub-directory.
+ Their purpose is to define the specifics of \SpecialChar LaTeX
+ packages aimed at bibliography
+ generation, such as 
+\family sans
+natbib
+\family default
+,
+\family sans
+ jurabib
+\family default
+ or 
+\family sans
+biblatex
+\family default
+, but also the way how normal Bib\SpecialChar TeX
+ citations (without additional packages)
+ are handled in \SpecialChar LyX
+ is defined in such a file.
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+More specifically, it is defined which packages \SpecialChar LyX
+ needs to load, which citation
+ commands are available, how these are to be displayed in \SpecialChar LyX
+ (in the workarea,
+ the dialogs, the context menus) as well as in the XHTML and plain text
+ output.
+ Furthermore, the files specify available style variants (author-year, numerical
+, etc.) and their specifics.
+ The cite engine files are also used to generate the options that are available
+ in 
+\family sans
+Document\SpecialChar menuseparator
+Settings\SpecialChar ldots
+\SpecialChar menuseparator
+Bibliography\SpecialChar menuseparator
+Style engine
+\family default
+.
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+Even though a cite engine file is essentially a normal layout file that
+ could theoretically include any layout information, it usually primarily
+ includes some specific parameters such as 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+MaxCiteNames
+\end_layout
+
+\end_inset
+
+, 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+CiteFramework
+\end_layout
+
+\end_inset
+
+, 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+CiteEngine
+\end_layout
+
+\end_inset
+
+ and 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+CiteFormat
+\end_layout
+
+\end_inset
+
+ blocks.
+ The syntax of the latter two is described in 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Citation-engine-description"
+plural "false"
+caps "false"
+noprefix "false"
+
+\end_inset
+
+ and 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Citation-format-description"
+
+\end_inset
+
+, as well as in the files themselves.
+\end_layout
+
 \begin_layout Section
 Syntaxe des fichiers de format
 \begin_inset CommandInset label
@@ -8132,68 +8341,197 @@ telmodule.module
 \end_layout
 
 \begin_layout Subsection
-Numéro d'identification syntaxique
+
+\lang english
+The CiteEngine file declaration
 \end_layout
 
 \begin_layout Standard
-La première ligne non commentée doit contenir le numéro d'identification
- syntaxique du contenu du fichier de format:
-\end_layout
 
-\begin_layout Description
-\begin_inset Flex Code
-status collapsed
+\lang english
+A cite engine file must begin with a line like the following:
+\end_layout
 
-\begin_layout Plain Layout
+\begin_layout LyX-Code
 
 \lang english
-Format
+#
+\backslash
+DeclareLyXCiteEngineModule[biblatex.sty]{Biblatex}
 \end_layout
 
-\end_inset
+\begin_layout Standard
 
- [
-\begin_inset Flex Code
+\lang english
+The mandatory argument, in curly brackets, is the name of the module, as
+ it should appear in 
+\begin_inset Flex Noun
 status collapsed
 
 \begin_layout Plain Layout
 
 \lang english
-int
+Document\SpecialChar menuseparator
+Settings\SpecialChar menuseparator
+Bibliography
 \end_layout
 
 \end_inset
 
-] identification syntaxique du fichier de format
+.
+ The argument in square brackets is optional: It declares any \SpecialChar LaTeX
+ packages
+ on which the cite engine depends.
 \end_layout
 
 \begin_layout Standard
-Ce balisage a été introduit dans \SpecialChar LyX
 
-\begin_inset space ~
-\end_inset
-
-1.4.0 Les fichiers de format des versions antérieures n'avaient pas de numéro
- de format explicite et sont affectés du 
 \lang english
-
-\begin_inset Flex Code
+The cite engine declaration should then be followed by lines like the following
+\begin_inset Foot
 status collapsed
 
 \begin_layout Plain Layout
 
 \lang english
-Format
-\begin_inset space ~
+Preferably in English if the module should be published with \SpecialChar LyX
+.
+ This description will appear in the list of messages to be translated and
+ will be thus translated with the next interface update.
+\end_layout
+
 \end_inset
 
-1
+:
 \end_layout
 
-\end_inset
+\begin_layout LyX-Code
 
+\lang english
+# DescriptionBegin
+\end_layout
 
-\lang french
+\begin_layout LyX-Code
+
+\lang english
+#   Biblatex supports many author-year and numerical styles.
+\end_layout
+
+\begin_layout LyX-Code
+
+\lang english
+#   It is mainly aimed at the Humanities.
+ It is highly
+\end_layout
+
+\begin_layout LyX-Code
+
+\lang english
+#   customizable, fully localized and provides many features
+\end_layout
+
+\begin_layout LyX-Code
+
+\lang english
+#   that are not possible with BibTeX.
+ The use of 'biber' as
+\end_layout
+
+\begin_layout LyX-Code
+
+\lang english
+#   bibliography processor is advised.
+\end_layout
+
+\begin_layout LyX-Code
+
+\lang english
+# DescriptionEnd
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+The description is used in 
+\begin_inset Flex Noun
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+Document\SpecialChar menuseparator
+Settings\SpecialChar menuseparator
+Bibliography
+\end_layout
+
+\end_inset
+
+ to provide the user with information about the cite engine.
+\end_layout
+
+\begin_layout Subsection
+Numéro d'identification syntaxique
+\end_layout
+
+\begin_layout Standard
+La première ligne non commentée doit contenir le numéro d'identification
+ syntaxique du contenu du fichier de format:
+\end_layout
+
+\begin_layout Description
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+Format
+\end_layout
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+int
+\end_layout
+
+\end_inset
+
+] identification syntaxique du fichier de format
+\end_layout
+
+\begin_layout Standard
+Ce balisage a été introduit dans \SpecialChar LyX
+
+\begin_inset space ~
+\end_inset
+
+1.4.0 Les fichiers de format des versions antérieures n'avaient pas de numéro
+ de format explicite et sont affectés du 
+\lang english
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+Format
+\begin_inset space ~
+\end_inset
+
+1
+\end_layout
+
+\end_inset
+
+
+\lang french
 .
  Le numéro de format du présent fichier est le numéro 60.
  mais chaque version de \SpecialChar LyX
@@ -8352,6 +8690,66 @@ status collapsed
 
 \begin_layout Plain Layout
 
+\lang english
+CiteEngine <engine>
+\end_layout
+
+\end_inset
+
+ Defines the possibilities for displaying citation references.
+ See 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Citation-engine-description"
+plural "false"
+caps "false"
+noprefix "false"
+
+\end_inset
+
+ for details.
+ Must end with 
+\begin_inset Quotes eld
+\end_inset
+
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+End
+\end_layout
+
+\end_inset
+
+
+\begin_inset Quotes erd
+\end_inset
+
+.
+ Primarily used in cite engine files (see 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Cite-Engine-Files"
+plural "false"
+caps "false"
+noprefix "false"
+
+\end_inset
+
+).
+\end_layout
+
+\begin_layout Description
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
 \lang english
 CiteFormat
 \end_layout
@@ -8393,6 +8791,77 @@ End
 \end_inset
 
 .
+
+\lang english
+ Primarily used in cite engine files (see 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Cite-Engine-Files"
+plural "false"
+caps "false"
+noprefix "false"
+
+\end_inset
+
+).
+\end_layout
+
+\begin_layout Description
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+CiteFramework
+\end_layout
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\emph on
+\lang english
+bibtex
+\end_layout
+
+\end_inset
+
+,
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+biblatex
+\end_layout
+
+\end_inset
+
+] Determines whether 
+\family sans
+Biblatex
+\family default
+ or Bib\SpecialChar TeX
+ is used to generate a Bibliography.
+ Primarily used in cite engine files (see 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Cite-Engine-Files"
+plural "false"
+caps "false"
+noprefix "false"
+
+\end_inset
+
+).
 \end_layout
 
 \begin_layout Description
@@ -9238,6 +9707,55 @@ status collapsed
 
 \begin_layout Plain Layout
 
+\lang english
+MaxCiteNames
+\end_layout
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+integer
+\end_layout
+
+\end_inset
+
+] An integer that determines the maximal number of names displayed in an
+ author-year citation before the citation switches to 
+\begin_inset Quotes eld
+\end_inset
+
+FirstAuthor et al.
+\begin_inset Quotes erd
+\end_inset
+
+.
+ Primarily used in cite engine files (see 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Cite-Engine-Files"
+plural "false"
+caps "false"
+noprefix "false"
+
+\end_inset
+
+).
+\end_layout
+
+\begin_layout Description
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
 \lang english
 ModifyStyle
 \end_layout
@@ -10828,18 +11346,50 @@ status collapsed
 \begin_layout Plain Layout
 
 \lang english
-Align
+AddToToc
 \end_layout
 
 \end_inset
 
-
-\lang french
  [
-\family typewriter
-\emph on
-block
-\emph default
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+string
+\end_layout
+
+\end_inset
+
+=""] This paragraph will appear in the table of contents of the given type.
+ An empty string disables.
+ See also the OutlinerName and the IsTocCaption commands.
+ Default: disabled.
+\end_layout
+
+\begin_layout Description
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+Align
+\end_layout
+
+\end_inset
+
+
+\lang french
+ [
+\family typewriter
+\emph on
+block
+\emph default
 , left, right, center
 \family default
 ] alignement de paragraphe.
@@ -11686,6 +12236,54 @@ status collapsed
 
 \begin_layout Plain Layout
 
+\lang english
+PassThru
+\end_layout
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\emph on
+\lang english
+inherited
+\emph default
+, true, false
+\end_layout
+
+\end_inset
+
+] Whether the contents of this argument should be output in raw form, meaning
+ without special translations that \SpecialChar LaTeX
+ would require.
+ By default, the 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+PassThru
+\end_layout
+
+\end_inset
+
+ status is inherited by the inset or paragraph layout the argument belongs
+ to, true and false change the status for the given argument only.
+\end_layout
+
+\begin_layout Itemize
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
 \lang english
 PassThruChars
 \end_layout
@@ -11724,6 +12322,54 @@ PassThruChars
  de leur insert ou format parent.
 \end_layout
 
+\begin_layout Itemize
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+IsTocCaption
+\end_layout
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\emph on
+\lang english
+0
+\end_layout
+
+\end_inset
+
+,
+\begin_inset space \thinspace{}
+\end_inset
+
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+1
+\end_layout
+
+\end_inset
+
+] If this is set to 1, the argument will output its content in the corresponding
+ item in the table of contents.
+ See AddToToc.
+\end_layout
+
 \begin_layout Standard
 Implicitement, le texte saisi dans la fenêtre de travail de \SpecialChar LyX
  dans le style
@@ -12741,6 +13387,54 @@ status collapsed
 
 \begin_layout Plain Layout
 
+\lang english
+IsTocCaption
+\end_layout
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\emph on
+\lang english
+0
+\end_layout
+
+\end_inset
+
+,
+\begin_inset space \thinspace{}
+\end_inset
+
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+1
+\end_layout
+
+\end_inset
+
+] If this is set to 1 and AddToToc is enabled, the paragraph adds a summary
+ of its contents in its item in the table of contents.
+ Otherwise, only the label, if it exists, appears.
+\end_layout
+
+\begin_layout Description
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
 \lang english
 ItemCommand
 \end_layout
@@ -15621,6 +16315,73 @@ status collapsed
 
 \begin_layout Plain Layout
 
+\lang english
+ResumeCounter
+\end_layout
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\emph on
+\lang english
+0
+\end_layout
+
+\end_inset
+
+,
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+1
+\end_layout
+
+\end_inset
+
+] Resumes a counter that is usually reset at each new sequence of layouts.
+ This is currently only useful when 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+LabelType
+\end_layout
+
+\end_inset
+
+ is 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+Enumerate
+\end_layout
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Description
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
 \lang english
 RightDelim
 \end_layout
@@ -15885,49 +16646,117 @@ status collapsed
 \begin_layout Plain Layout
 
 \lang english
-TextFont
+StepMasterCounter
 \end_layout
 
 \end_inset
 
+ [
+\begin_inset Flex Code
+status collapsed
 
-\lang french
- fixe la police utilisée pour le corps du texte.
- Voir la 
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "subsec:polices"
-
-\end_inset
+\begin_layout Plain Layout
 
-.
+\emph on
+\lang english
+0
 \end_layout
 
-\begin_layout Description
+\end_inset
 
-\lang english
+,
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
 
 \lang english
-TocLevel
+1
 \end_layout
 
 \end_inset
 
-
-\lang french
- [
+] Steps the master counter of a given counter at the beginning of a new
+ sequence of layouts.
+ This is currently only useful when 
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
-int=3
-\end_layout
 
-\end_inset
+\lang english
+LabelType
+\end_layout
+
+\end_inset
+
+ is 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+Enumerate
+\end_layout
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Description
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+TextFont
+\end_layout
+
+\end_inset
+
+
+\lang french
+ fixe la police utilisée pour le corps du texte.
+ Voir la 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:polices"
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Description
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+TocLevel
+\end_layout
+
+\end_inset
+
+
+\lang french
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+int=3
+\end_layout
+
+\end_inset
 
 ] fixe le niveau du style dans le table des matières.
  Ceci est utilisé pour la numérotation automatique des en-têtes.
@@ -18357,6 +19186,39 @@ status collapsed
 
 \begin_layout Plain Layout
 
+\lang english
+AddToToc
+\end_layout
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+string
+\end_layout
+
+\end_inset
+
+=""] This inset will appear in the table of contents of the given type.
+ An empty string disables.
+ See also the OutlinerName and the IsTocCaption commands.
+ This is only implemented for Flex insets.
+ Default: disabled.
+\end_layout
+
+\begin_layout Description
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
 \lang english
 Argument
 \end_layout
@@ -19414,6 +20276,10 @@ status collapsed
 \end_inset
 
 Plan
+\lang english
+ for all table of contents, regardless of the AddToToc setting
+\lang french
+
 \begin_inset Quotes crd
 \end_inset
 
@@ -19441,6 +20307,54 @@ status collapsed
 
 \begin_layout Plain Layout
 
+\lang english
+IsTocCaption
+\end_layout
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\emph on
+\lang english
+0
+\end_layout
+
+\end_inset
+
+,
+\begin_inset space \thinspace{}
+\end_inset
+
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+1
+\end_layout
+
+\end_inset
+
+] If this is set to 1 and AddToToc is enabled, the inset adds a summary
+ of its contents in its item in the table of contents.
+ Otherwise, only the label appears.
+\end_layout
+
+\begin_layout Description
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
 \lang english
 KeepEmpty
 \end_layout
@@ -19902,10 +20816,6 @@ LatexName
 .
 \end_layout
 
-\begin_layout Description
-
-\end_layout
-
 \begin_layout Standard
 En rassemblant ceci, la sortie \SpecialChar LaTeX
  sera soit: 
@@ -22201,281 +23111,1857 @@ giant
 \end_layout
 
 \begin_layout Subsection
-Description d'une insertion de citation
+
+\lang english
 \begin_inset CommandInset label
 LatexCommand label
-name "subsec:Description citation"
+name "subsec:Citation-engine-description"
+
+\end_inset
+
+Citation engine description
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+The 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+CiteEngine
+\end_layout
+
+\end_inset
+
+ blocks, as used mainly in cite engine files (see 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Cite-Engine-Files"
+plural "false"
+caps "false"
+noprefix "false"
+
+\end_inset
+
+), define the citation commands provided by a specific 
+\begin_inset Quotes eld
+\end_inset
+
+cite engine
+\begin_inset Quotes erd
+\end_inset
+
+.
+ A cite engine, in \SpecialChar LyX
+ terms, is way specific way to format citations, using
+ numbers, author names and/or years.
+ Currently, \SpecialChar LyX
+ supports three such engine types, namely:
+\end_layout
+
+\begin_layout Enumerate
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+default
+\end_layout
+
+\end_inset
+
+: the default Bib\SpecialChar TeX
+ way to format citations, a simple numeric style (e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g., 
+\begin_inset Quotes eld
+\end_inset
+
+[1]
+\begin_inset Quotes erd
+\end_inset
+
+)
+\end_layout
+
+\begin_layout Enumerate
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+authoryear
+\end_layout
+
+\end_inset
+
+: Harvard-styled citations using author names and publication year (e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g., 
+\begin_inset Quotes eld
+\end_inset
+
+Smith and Miller (2017b)
+\begin_inset Quotes erd
+\end_inset
+
+)
+\end_layout
+
+\begin_layout Enumerate
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+numerical
+\end_layout
+
+\end_inset
+
+: extended numerical citations that also allow for author or title next
+ to the number (e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g., 
+\begin_inset Quotes eld
+\end_inset
+
+Smith and Miller [1]
+\begin_inset Quotes erd
+\end_inset
+
+)
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+CiteEngine
+\end_layout
+
+\end_inset
+
+ blocks look like this:
+\end_layout
+
+\begin_layout LyX-Code
+
+\lang english
+CiteEngine default
+\end_layout
+
+\begin_layout LyX-Code
+
+\lang english
+ cite
+\end_layout
+
+\begin_layout LyX-Code
+
+\lang english
+ Citep*[][]
+\end_layout
+
+\begin_layout LyX-Code
+
+\lang english
+ citeyearpar[][]=parencite*
+\end_layout
+
+\begin_layout LyX-Code
+
+\lang english
+ ...
+\end_layout
+
+\begin_layout LyX-Code
+
+\lang english
+End
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+The tag following 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+CiteEngine
+\end_layout
+
+\end_inset
+
+ denotes the engine.
+ The individual lines respectively define a cite command or cite command
+ paradigm supported by this engine.
+ The line can be as simple as a cite command that is used both to name the
+ respective \SpecialChar LyX
+ command and the \SpecialChar LaTeX
+ output or more complex in order to differentiate
+ things.
+ The full syntax is:
+\end_layout
+
+\begin_layout LyX-Code
+
+\lang english
+LyXName|alias$*<!_stardesc!_stardesctooltip>[][]=latexcmd
+\end_layout
+
+\begin_layout Itemize
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+LyXName
+\end_layout
+
+\end_inset
+
+: The name as used in the 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+*.lyx
+\end_layout
+
+\end_inset
+
+ file.
+\end_layout
+
+\begin_deeper
+\begin_layout Standard
+
+\lang english
+For portability reasons, we try to use the same name for same-formatted
+ commands in different cite packages (thus many names stem from natbib,
+ and thus we need to differentiate a 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+latexcmd
+\end_layout
+
+\end_inset
+
+ sometimes, if the \SpecialChar LaTeX
+ command names differ).
+\end_layout
+
+\end_deeper
+\begin_layout Itemize
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+alias
+\end_layout
+
+\end_inset
+
+: a (comma-separated) list of commands that fall back to the given 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+LyXName
+\end_layout
+
+\end_inset
+
+ in the current engine.
+ This eases the switch of citation packages and engines.
+ The 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+alias
+\end_layout
+
+\end_inset
+
+ can be compared to 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+ObsoletedBy
+\end_layout
+
+\end_inset
+
+ in layout definitions.
+\end_layout
+
+\begin_layout Itemize
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+latexcmd
+\end_layout
+
+\end_inset
+
+: The actual \SpecialChar LaTeX
+ command that is output.
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+Alias
+\end_layout
+
+\end_inset
+
+ and 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+latexcmd
+\end_layout
+
+\end_inset
+
+ are optional.
+ If no 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+latexcmd
+\end_layout
+
+\end_inset
+
+ is given, the 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+LyXName
+\end_layout
+
+\end_inset
+
+ will be output to \SpecialChar LaTeX
+.
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+Note further:
+\end_layout
+
+\begin_layout Itemize
+
+\lang english
+Capitalization indicates that the command also has a capitalized form (
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+
+\backslash
+Latexcmd
+\end_layout
+
+\end_inset
+
+ vs.
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+
+\backslash
+latexcmd
+\end_layout
+
+\end_inset
+
+).
+ These usually enforce up-casing of name prefixes (
+\emph on
+von Goethe
+\emph default
+\begin_inset Formula $\Rightarrow$
+\end_inset
+
+\emph on
+Von Goethe
+\emph default
+).
+\end_layout
+
+\begin_layout Itemize
+
+\lang english
+Brackets 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+[]
+\end_layout
+
+\end_inset
+
+ indicate the number of optional arguments (there can be 0–2).
+\end_layout
+
+\begin_layout Itemize
+
+\lang english
+A star 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+*
+\end_layout
+
+\end_inset
+
+ indicates there is a starred version of the command (
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+
+\backslash
+latexcmd*
+\end_layout
+
+\end_inset
+
+ vs.
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+
+\backslash
+latexcmd
+\end_layout
+
+\end_inset
+
+).
+\end_layout
+
+\begin_deeper
+\begin_layout Standard
+
+\lang english
+By default, the starred version means: Output all authors even if it should
+ be shortened with 
+\begin_inset Quotes eld
+\end_inset
+
+et al.
+\begin_inset Quotes erd
+\end_inset
+
+ due to the 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+MaxCiteNames
+\end_layout
+
+\end_inset
+
+ threshold.
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+If the star has a different meaning for a given command, it can be specified
+ in angle brackets: 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+<!_stardesc!_stardesctooltip>
+\end_layout
+
+\end_inset
+
+.
+ Maximal two translatable macro keywords, marked by the prefix 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+!_
+\end_layout
+
+\end_inset
+
+, can be given.
+ The first points to the string that replaces the 
+\begin_inset Quotes eld
+\end_inset
+
+Full aut&hor list
+\begin_inset Quotes erd
+\end_inset
+
+ checkbox label in the citation dialog, the second one to an optional tool
+ tip for this checkbox.
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+Note that these two macros have to be defined in a 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+CiteFormat
+\end_layout
+
+\end_inset
+
+ (see next section), dropping the 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+!
+\end_layout
+
+\end_inset
+
+ from the prefix, like this: 
+\end_layout
+
+\begin_layout LyX-Code
+
+\lang english
+_stardesc Sta&rred command label
+\end_layout
+
+\begin_layout LyX-Code
+
+\lang english
+_stardesctooltip Tooltip for the starred command checkbox.
+\end_layout
+
+\end_deeper
+\begin_layout Itemize
+
+\lang english
+A dollar sign 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+$
+\end_layout
+
+\end_inset
+
+ indicates that this command features 
+\begin_inset Quotes eld
+\end_inset
+
+qualified citation lists
+\begin_inset Quotes erd
+\end_inset
+
+.
+ This is a 
+\family sans
+Biblatex
+\family default
+-specific feature for multi-reference citations where an individual pre-
+ and postnote can be given to each reference in the list.
+ Please refer to the 
+\family sans
+Biblatex
+\family default
+ manual for details.
+\end_layout
+
+\begin_layout Subsection
+Description d'une insertion de citation
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:Description citation"
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Les blocs 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+CiteFormat
+\end_layout
+
+\end_inset
+
+ servent à décrire comment les citations bibliographiques doivent être affichées
+, à la fois dans \SpecialChar LyX
+ (dans la fenêtre de citation et dans les bulles d'aide,
+ par exemple) et dans le résultat XHTML.
+ Un tel bloc se présente comme suit:
+\end_layout
+
+\begin_layout LyX-Code
+
+\lang english
+CiteFormat
+\end_layout
+
+\begin_layout LyX-Code
+
+\lang english
+ article ...
+\end_layout
+
+\begin_layout LyX-Code
+
+\lang english
+ book ...
+\end_layout
+
+\begin_layout LyX-Code
+
+\lang english
+End
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+ou
+\end_layout
+
+\begin_layout LyX-Code
+
+\lang english
+CiteFormat
+\end_layout
+
+\begin_layout LyX-Code
+
+\lang english
+ cite ...
+\end_layout
+
+\begin_layout LyX-Code
+
+\lang english
+ citet*[][] ...
+\end_layout
+
+\begin_layout LyX-Code
+
+\lang english
+End
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+Dans le premier cas,
+\lang french
+ les différentes lignes définissent l'affichage de l'information correspondant
+ à une article ou à un livre, respectivement, et une telle définition peut
+ être créée pour tout type d'entrée apparaissant dans un fichier Bib\SpecialChar TeX
+.
+ \SpecialChar LyX
+ définit un format implicite dans le code source qui sera utilisé si aucune
+ définition spécifique n'est fournie.
+ \SpecialChar LyX
+ prédéfinit plusieurs formats dans le fichier 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+stdciteformats.inc
+\end_layout
+
+\end_inset
+
+, qui est inclus dans la plupart des classes de document \SpecialChar LyX
+.
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+In the second case, the lines define how a specific citation command (in
+ the example 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+
+\backslash
+cite
+\end_layout
+
+\end_inset
+
+, 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+
+\backslash
+citet
+\end_layout
+
+\end_inset
+
+) is to be displayed on the citation inset label, in the citation dialog,
+ menu or XHTML output.
+ \SpecialChar LyX
+ defines such formats for the citation style variants it supports via 
+\family sans
+Document\SpecialChar menuseparator
+Setting\SpecialChar menuseparator
+Bibliography\SpecialChar ldots
+
+\family default
+ in specific 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+*.citeengine
+\end_layout
+
+\end_inset
+
+ files that are shipped with \SpecialChar LyX
+ (see 
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Cite-Engine-Files"
+plural "false"
+caps "false"
+noprefix "false"
+
+\end_inset
+
+).
+\end_layout
+
+\begin_layout Standard
+Les définitions utilisent un langage simple qui permet
+\begin_inset space ~
+\end_inset
+
+de remplacer les clés Bib\SpecialChar TeX
+ par leurs valeurs.
+ les clés doivent être encloses entre caractères
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+%
+\end_layout
+
+\end_inset
+
+, e.g.: 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+%author%
+\end_layout
+
+\end_inset
+
+.
+
+\lang french
+ Une définition simple serait par exemple:
+\end_layout
+
+\begin_layout LyX-Code
+
+\lang english
+misc %author%, 
+\begin_inset Quotes eld
+\end_inset
+
+%title%
+\begin_inset Quotes erd
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Standard
+Ceci imprimerait le nom de l'auteur, suivi d'une virgule, suivi du titre,
+ entre double guillemets, suivi d'un point.
+\end_layout
+
+\begin_layout Standard
+Bien entendu, vous voudrez parfois n'imprimer une clé que si elle existe.
+ Ceci est obtenu par une construction conditionnelle, comme: 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+{%volume%[[vol.
+\begin_inset space ~
+\end_inset
+
+%volume%]]}
+\end_layout
+
+\end_inset
+
+.
+ Ceci signifie: si la clé 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+volume
+\end_layout
+
+\end_inset
+
+ existe, alors imprimer 
+\begin_inset Quotes cld
+\end_inset
+
+vol.
+\begin_inset Quotes crd
+\end_inset
+
+ suivi de la clé volume.
+ On peut aussi introduire une clause 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+else
+\end_layout
+
+\end_inset
+
+ dans l'expression conditionnelle, comme dans:
+\begin_inset Newline newline
+\end_inset
+
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+{%author%[[%author%]][[%editor%, ed.]]}
+\end_layout
+
+\end_inset
+
+
+\begin_inset Newline newline
+\end_inset
+
+Ici, la clé 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+author
+\end_layout
+
+\end_inset
+
+ est imprimée si elle existe; sinon la clé 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+editor
+\end_layout
+
+\end_inset
+
+ est imprimée, suivi de 
+\begin_inset Quotes cld
+\end_inset
+
+, ed.
+\begin_inset Quotes crd
+\end_inset
+
+.
+ Noter que la clé est encore enclose entre caractères 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+%
+\end_layout
+
+\end_inset
+
+; la clause conditionnelle entière est enclose entre accolades, et les clauses
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+if
+\end_layout
+
+\end_inset
+
+ et 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+else
+\end_layout
+
+\end_inset
+
+ sont encloses entre double crochets 
+\begin_inset Quotes cld
+\end_inset
+
+[[
+\begin_inset Quotes crd
+\end_inset
+
+ et 
+\begin_inset Quotes cld
+\end_inset
+
+]]
+\begin_inset Quotes crd
+\end_inset
+
+.
+ Il ne peut avoir d'espaces entre ces marqueurs.
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+Next to the entry keys, there are some special keys that can be used for
+ these conditionals:
+\end_layout
+
+\begin_layout Itemize
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+{%dialog%[[true]][[false]]}
+\end_layout
+
+\end_inset
+
+: process the 
+\begin_inset Quotes eld
+\end_inset
+
+true
+\begin_inset Quotes erd
+\end_inset
+
+ part for dialogs and menus, the 
+\begin_inset Quotes eld
+\end_inset
+
+false
+\begin_inset Quotes erd
+\end_inset
+
+ part for other contexts (workarea, export)
+\end_layout
+
+\begin_layout Itemize
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+{%export%[[true]][[false]]}
+\end_layout
+
+\end_inset
+
+: process the 
+\begin_inset Quotes eld
+\end_inset
+
+true
+\begin_inset Quotes erd
+\end_inset
+
+ part for export and menus, the 
+\begin_inset Quotes eld
+\end_inset
+
+false
+\begin_inset Quotes erd
+\end_inset
+
+ part for other contexts (workarea, dialog)
+\end_layout
+
+\begin_layout Itemize
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+{%next%[[true]]}
+\end_layout
+
+\end_inset
+
+: process the 
+\begin_inset Quotes eld
+\end_inset
+
+true
+\begin_inset Quotes erd
+\end_inset
+
+ part if another item follows (e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g., in a citation with multiple keys)
+\end_layout
+
+\begin_layout Itemize
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+{%second%[[true]][[false]]}
+\end_layout
+
+\end_inset
+
+: process the 
+\begin_inset Quotes eld
+\end_inset
+
+true
+\begin_inset Quotes erd
+\end_inset
+
+ if this is the second of multiple items, else the 
+\begin_inset Quotes eld
+\end_inset
+
+false
+\begin_inset Quotes erd
+\end_inset
+
+ part
+\end_layout
+
+\begin_layout Itemize
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+{%ifstar%[[true]][[false]]}
+\end_layout
+
+\end_inset
+
+: process the 
+\begin_inset Quotes eld
+\end_inset
+
+true
+\begin_inset Quotes erd
+\end_inset
+
+ part for starred citation commands (such as 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+
+\backslash
+cite*
+\end_layout
+
+\end_inset
+
+), the false part for unstarred
+\end_layout
+
+\begin_layout Itemize
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+{%ifentrytype:<type>%[[true]][[false]]}
+\end_layout
+
+\end_inset
+
+: process the 
+\begin_inset Quotes eld
+\end_inset
+
+true
+\begin_inset Quotes erd
+\end_inset
+
+ if the current entry type matches 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+<type>
+\end_layout
+
+\end_inset
+
+, else the false part (e.g., in a citation definition: 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+{%ifentrytype:book%[[this is a book]][[this is no book]]}
+\end_layout
+
+\end_inset
+
+)
+\end_layout
+
+\begin_layout Itemize
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+{%ifmultiple:<authortype>%[[true]][[false]]}
+\end_layout
+
+\end_inset
+
+: process the 
+\begin_inset Quotes eld
+\end_inset
+
+true
+\begin_inset Quotes erd
+\end_inset
+
+ if the current author type (author, editor etc.) has multiple authors, else
+ the false part (e.g., in a bibliography definition: 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+{%ifmultiple:editor%[[eds.]][[ed.]]}
+\end_layout
+
+\end_inset
+
+)
+\end_layout
+
+\begin_layout Itemize
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+{%ifqualified%[[true]][[false]]}
+\end_layout
+
+\end_inset
+
+: process the 
+\begin_inset Quotes eld
+\end_inset
+
+true
+\begin_inset Quotes erd
+\end_inset
+
+ part if the current citation is a qualified citation list (a specific 
+\family sans
+Biblatex
+\family default
+ format for multi-reference citations), the false part if this is not the
+ case.
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+We said that 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+%author%
+\end_layout
+
+\end_inset
+
+ prints the author key as it is recorded in the bibliography file.
+ This might not be what you want, since it will result in a string such
+ as 
+\begin_inset Quotes eld
+\end_inset
+
+Miller, Peter and Smith, Mary and White, Jane
+\begin_inset Quotes erd
+\end_inset
+
+ (since 
+\begin_inset Quotes eld
+\end_inset
+
+and
+\begin_inset Quotes erd
+\end_inset
+
+ is used by Bib\SpecialChar TeX
+ to delimit authors).
+ \SpecialChar LyX
+ therefore provides some methods to get properly formatted name lists (which
+ will also get translated).
+ The following keys are provided:
+\end_layout
+
+\begin_layout Enumerate
+
+\lang english
+For name lists with pre- and surname, suitable for the main authors/editors
+ of a bibliography item.
+ The 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+<nametype>
+\end_layout
+
+\end_inset
+
+ part denotes the kind of list that is requested (e.g.
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+<nametype:author>
+\end_layout
+
+\end_inset
+
+):
+\end_layout
+
+\begin_deeper
+\begin_layout Itemize
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+%abbrvnames:<nametype>%
+\end_layout
+
+\end_inset
+
+: Provides a name list which is abbreviated (with 
+\begin_inset Quotes eld
+\end_inset
+
+et al.
+\begin_inset Quotes erd
+\end_inset
+
+) when 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+MaxCiteNames
+\end_layout
+
+\end_inset
+
+ is reached.
+\end_layout
+
+\begin_layout Itemize
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+%fullnames:<nametype>%
+\end_layout
+
+\end_inset
+
+: Provides a full name list (never abbreviated with 
+\begin_inset Quotes eld
+\end_inset
+
+et al.
+\begin_inset Quotes erd
+\end_inset
+
+).
+\end_layout
+
+\begin_layout Itemize
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+%forceabbrvnames:<nametype>%
+\end_layout
+
+\end_inset
+
+: Provides a name list which is always abbreviated (with 
+\begin_inset Quotes eld
+\end_inset
+
+et al.
+\begin_inset Quotes erd
+\end_inset
+
+) irrespective of 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+MaxCiteNames
+\end_layout
+
+\end_inset
+
+.
+\end_layout
+
+\end_deeper
+\begin_layout Enumerate
+
+\lang english
+Alternative name lists with pre- and surname, if the order of pre- and surname
+ inside the bibliography item differs (as in: 
+\begin_inset Quotes eld
+\end_inset
+
+Miller, John: Some text, in: Mary Smith, ed.: A volume
+\begin_inset Quotes erd
+\end_inset
+
+):
+\end_layout
+
+\begin_deeper
+\begin_layout Itemize
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+%abbrvbynames:<nametype>%
+\end_layout
 
 \end_inset
 
+: Provides a name list which is abbreviated (with 
+\begin_inset Quotes eld
+\end_inset
 
-\end_layout
+et al.
+\begin_inset Quotes erd
+\end_inset
 
-\begin_layout Standard
-Les blocs 
+) when 
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
-CiteFormat
+
+\lang english
+MaxCiteNames
 \end_layout
 
 \end_inset
 
- servent à décrire comment les citations bibliographiques doivent être affichées
-, à la fois dans \SpecialChar LyX
- (dans la fenêtre de citation et dans les bulles d'aide,
- par exemple) et dans le résultat XHTML.
- Un tel bloc se présente comme suit:
+ is reached.
 \end_layout
 
-\begin_layout LyX-Code
+\begin_layout Itemize
 
 \lang english
-CiteFormat
-\end_layout
+\begin_inset Flex Code
+status collapsed
 
-\begin_layout LyX-Code
+\begin_layout Plain Layout
 
 \lang english
- article ...
+%fullbynames:<nametype>%
 \end_layout
 
-\begin_layout LyX-Code
+\end_inset
 
-\lang english
- book ...
-\end_layout
+: Provides a full name list (never abbreviated with 
+\begin_inset Quotes eld
+\end_inset
 
-\begin_layout LyX-Code
+et al.
+\begin_inset Quotes erd
+\end_inset
 
-\lang english
-End
+).
 \end_layout
 
-\begin_layout Standard
-Les différentes lignes définissent l'affichage de l'information correspondant
- à une article ou à un livre, respectivement, et une telle définition peut
- être créée pour tout type d'entrée apparaissant dans un fichier Bib\SpecialChar TeX
-.
- \SpecialChar LyX
- définit un format implicite dans le code source qui sera utilisé si aucune
- définition spécifique n'est fournie.
- \SpecialChar LyX
- prédéfinit plusieurs formats dans le fichier 
+\begin_layout Itemize
+
+\lang english
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
-stdciteformats.inc
+
+\lang english
+%forceabbrvbynames:<nametype>%
 \end_layout
 
 \end_inset
 
-, qui est inclus dans la plupart des classes de document \SpecialChar LyX
-.
-\end_layout
+: Provides a name list which is always abbreviated (with 
+\begin_inset Quotes eld
+\end_inset
 
-\begin_layout Standard
-Les définitions utilisent un langage simple qui permet
-\begin_inset space ~
+et al.
+\begin_inset Quotes erd
 \end_inset
 
-de remplacer les clés Bib\SpecialChar TeX
- par leurs valeurs.
- les clés doivent être encloses entre caractères
-\lang english
+) irrespective of 
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
 
 \lang english
-%
+MaxCiteNames
 \end_layout
 
 \end_inset
 
-, e.g.: 
+.
+\end_layout
+
+\end_deeper
+\begin_layout Enumerate
+
+\lang english
+And finally name lists which consist of family names only, as used in author-yea
+r citation labels.
+ these do not take a 
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
 
 \lang english
-%author%
+<nametype>
 \end_layout
 
 \end_inset
 
-.
-
-\lang french
- Une définition simple serait par exemple:
+ part, but always return either an author list or, if this does not exist,
+ an editor list (as common in author-year labels):
 \end_layout
 
-\begin_layout LyX-Code
+\begin_deeper
+\begin_layout Itemize
 
 \lang english
-misc %author%, 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+%abbrvciteauthor%
+\end_layout
+
+\end_inset
+
+: Provides a name list which is abbreviated (with 
 \begin_inset Quotes eld
 \end_inset
 
-%title%
+et al.
 \begin_inset Quotes erd
 \end_inset
 
-.
-\end_layout
-
-\begin_layout Standard
-Ceci imprimerait le nom de l'auteur, suivi d'une virgule, suivi du titre,
- entre double guillemets, suivi d'un point.
-\end_layout
-
-\begin_layout Standard
-Bien entendu, vous voudrez parfois n'imprimer une clé que si elle existe.
- Ceci est obtenu par une construction conditionnelle, comme: 
+) when 
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
-{%volume%[[vol.
-\begin_inset space ~
-\end_inset
 
-%volume%]]}
+\lang english
+MaxCiteNames
 \end_layout
 
 \end_inset
 
-.
- Ceci signifie: si la clé 
+ is reached.
+\end_layout
+
+\begin_layout Itemize
+
+\lang english
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
-volume
+
+\lang english
+%fullciteauthor%
 \end_layout
 
 \end_inset
 
- existe, alors imprimer 
-\begin_inset Quotes cld
+: Provides a full name list (never abbreviated with 
+\begin_inset Quotes eld
 \end_inset
 
-vol.
-\begin_inset Quotes crd
+et al.
+\begin_inset Quotes erd
 \end_inset
 
- suivi de la clé volume.
- On peut aussi introduire une clause 
+).
+\end_layout
+
+\begin_layout Itemize
+
+\lang english
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
-else
+
+\lang english
+%forceabbrvciteauthor%
 \end_layout
 
 \end_inset
 
- dans l'expression conditionnelle, comme dans:
-\begin_inset Newline newline
+: Provides a name list which is always abbreviated (with 
+\begin_inset Quotes eld
 \end_inset
 
+et al.
+\begin_inset Quotes erd
+\end_inset
 
+) irrespective of 
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
-{%author%[[%author%]][[%editor%, ed.]]}
+
+\lang english
+MaxCiteNames
 \end_layout
 
 \end_inset
 
+.
+\end_layout
 
-\begin_inset Newline newline
-\end_inset
-
-Ici, la clé 
-\begin_inset Flex Code
-status collapsed
+\end_deeper
+\begin_layout Standard
 
-\begin_layout Plain Layout
-author
+\lang english
+The order of pre- and surname in the former two lists can be adjusted by
+ these macros:
 \end_layout
 
-\end_inset
+\begin_layout Itemize
 
- est imprimée si elle existe; sinon la clé 
+\lang english
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
-editor
+
+\lang english
+!firstnameform %surname%, %prename%
 \end_layout
 
 \end_inset
 
- est imprimée, suivi de 
-\begin_inset Quotes cld
-\end_inset
+ (first author in lists of type 1)
+\end_layout
 
-, ed.
-\begin_inset Quotes crd
-\end_inset
+\begin_layout Itemize
 
-.
- Noter que la clé est encore enclose entre caractères 
+\lang english
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
-%
+
+\lang english
+!othernameform %surname%, %prename%
 \end_layout
 
 \end_inset
 
-; la clause conditionnelle entière est enclose entre accolades, et les clauses
+ (other authors in lists of type 1)
+\end_layout
+
+\begin_layout Itemize
+
+\lang english
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
-if
+
+\lang english
+!firstbynameform %prename% %surname%
 \end_layout
 
 \end_inset
 
- et 
+ (first author in lists of type 2)
+\end_layout
+
+\begin_layout Itemize
+
+\lang english
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
-else
+
+\lang english
+!otherbynameform %prename% %surname%
 \end_layout
 
 \end_inset
 
- sont encloses entre double crochets 
-\begin_inset Quotes cld
-\end_inset
+ (other authors in lists of type 2)
+\end_layout
 
-[[
-\begin_inset Quotes crd
-\end_inset
+\begin_layout Standard
 
- et 
-\begin_inset Quotes cld
+\lang english
+This allows you to configure namings like 
+\begin_inset Quotes eld
 \end_inset
 
-]]
-\begin_inset Quotes crd
+Miller, Peter and Mary Smith: \SpecialChar ldots
+, in: John Doe and Pat Green, eds.:\SpecialChar ldots
+
+\begin_inset Quotes erd
 \end_inset
 
 .
- Il ne peut avoir d'espaces entre ces marqueurs.
 \end_layout
 
 \begin_layout Standard
@@ -22601,7 +25087,11 @@ _pptext pp.
 
 \begin_layout Standard
 Ceci définit un segment de texte susceptible de traduction, ce qui permet
- de traduire les parties appropriées de la bibliographie.
+ de traduire les parties appropriées de la bibliographie
+\lang english
+ or citation
+\lang french
+.
  Cette syntaxe peut être incluse dans une définition normale en la considérant
  comme une clé: 
 \begin_inset Flex Code
@@ -22625,6 +25115,22 @@ stdciteformats.inc
 \end_inset
 
 .
+
+\lang english
+ and the diverse 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+*.citeengine
+\end_layout
+
+\end_inset
+
+ files
+\lang french
  Notez bien que ce ne sont pas des macro-instructions, au sens défini ci-dessus:
  elles ne seront pas interprétées.
 \end_layout
@@ -24540,7 +27046,11 @@ tag
 \end_inset
 
  dans les exemples ci-dessus.
- La valeur implicite dépend  du réglage de 
+ La valeur implicite dépend
+\change_deleted 34634807 1501859535
+\change_unchanged
+ du réglage de 
 \begin_inset Flex Code
 status collapsed
 
@@ -25232,18 +27742,37 @@ Ceci dit, nous vous encourageons à créer des cadres intéressants et à nous
 \end_layout
 
 \begin_layout Standard
-Les cadres externes sont définis dans le fichier 
+Les cadres externes sont définis dans le fichier
+\lang english
+
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
-Rép\SpecialChar LyX
-/external_templates
+
+\lang english
+*.xtemplate
+\end_layout
+
+\end_inset
+
+ files that are stored in the 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+LyXDir/lib/xtemplates/
 \end_layout
 
 \end_inset
 
+ directory.
+ Each template is defined in a file of its own.
 
+\lang french
 \family typewriter
 
 \begin_inset Foot
@@ -25274,17 +27803,23 @@ template
 
 \family default
 .
- Vous pouvez mettre votre propre version dans 
+ Vous pouvez mettre votre propre version dans
+\lang english
+ templates in 
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
-MonRép/external_templates
+
+\lang english
+MonRép/xtemplates/
 \end_layout
 
 \end_inset
 
-.
+ or copy existing templates to that directory in order to modify them.
+
+\lang french
  
 \end_layout