--- /dev/null
+
+For lyx 2.3.0
+
+* Sec. 2.1.2: new citeengines item
+ new xtemplates item
+
+* Sec. 2.1.4: remove external_templates item
+
+* Sec. 5.2.6: new section (Cite engine files)
+
+* Sec. 5.3.3: new section (Cite engine file declaration)
+
+* Sec. 5.3.4->5: new CiteEngine item
+ new CiteFramework item
+ new MaxCiteNames item
+ new OutlinerName item
+
+* Sec. 5.3.6->7: new AddToToc item
+ new PassThru
+ new IsTocCaption
+ new IsTocCaption item
+ new ResumeCounter item
+ new StepMasterCounter item
+
+* Sec. 5.3.9->10: new AddToToc item
+ edit InToc item
+ new IsTocCaption item
+
+* Sec. 5.3.12->13: new section (Citation engine description)
+
+* Sec. 5.3.13->14: add CiteFormat item syntax
+ add use instructions (2nd par.)
+ new paragraph about special keys
+ new paragraph about author lists
+ word citation added (translatable text)
+ phrase about cittengines (id.)
+
+* Sec. 6.2: 3rd paragraph, introduce xtemplate files
+
+
+
+For LyX 2.2.1:
+
+- sec. 5.3.9: additions in description of "LyxType"
+
+
+For LyX 2.2.0:
+
+Modified:
+
+first step:
+- sec. 5.3.4 new sentence for "Requires"
+- sec. 5.3.4 new entry "ProvideStyle"
+- sec. 5.3.6 new items for "Argument"
+- sec. 5.3.6 new entry "ParagraphGroup"
+- sec. 5.3.6 changed ifo for "Requires"
+- sec. 5.3.6 new entry "ToggleIndent"
+- sec. 5.3.8 new entries "AllowedPlacement", "AllowsSideways" and "AllowsWide"
+- sec. 5.3.9 new entry "FixedWidthPreambleEncoding"
+- sec. 5.3.9 new entry "ForceOwnlines"
+- sec. 5.3.9 new entry "ObsoletedBy"
+- sec. 6.3 new entry "pngOrjpg"
+
+second step:
+- sec. 5.1: (Spanish and Japanese only) new paths
#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
\suppress_date false
\justification true
\use_refstyle 0
+\use_minted 0
\notefontcolor #0000ff
\branch OutDated
\selected 0
\paragraph_separation indent
\paragraph_indentation default
\is_math_indent 1
+\math_indentation default
+\math_numbering_side default
\quotes_style english
\dynamic_quotes 0
\papercolumns 1
\papersides 2
\paperpagestyle headings
-\tracking_changes true
+\tracking_changes false
\output_changes false
\html_math_output 0
\html_css_as_file 0
\html_be_strict true
-\author -712698321 "Jürgen Spitzmüller"
-\author 2047637253 "Guillaume Munch"
-\author 2089657418 "Usti"
\end_header
\begin_body
\begin_inset Newline newline
\end_inset
-Version 2.2.x
+Version 2.3.x
\end_layout
\begin_layout Standard
\end_inset
, that will be used first.
-\change_inserted -712698321 1483535138
-
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
-
-\change_inserted -712698321 1483874001
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483535144
citeengines/
\end_layout
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483869840
.citeengine
-\change_unchanged
-
\end_layout
\end_inset
\end_inset
for details.
-\change_unchanged
-
\end_layout
\begin_layout Labeling
.
That is, the files define which items appear in which menus and the items
appearing on the toolbar.
-\change_inserted -712698321 1490533733
-
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
-
-\change_inserted -712698321 1490533849
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1490533738
xtemplates/
\end_layout
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1490533759
.xtemplate
\end_layout
\end_inset
.
-\change_unchanged
-
\end_layout
\begin_layout Subsection
mapped to Unicode
\end_layout
-\begin_layout Labeling
-\labelwidthstring 00.00.0000
-
-\change_deleted -712698321 1490533856
-\begin_inset Flex Code
-status collapsed
-
-\begin_layout Plain Layout
-external_templates
-\end_layout
-
-\end_inset
-
- this file contains the templates available to the new
-\begin_inset Flex Noun
-status collapsed
-
-\begin_layout Plain Layout
-External
-\begin_inset space ~
-\end_inset
-
-Template
-\end_layout
-
-\end_inset
-
- feature, see
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "chap:Including-External-Material"
-
-\end_inset
-
-.
-\change_unchanged
-
-\end_layout
-
\begin_layout Labeling
\labelwidthstring 00.00.0000
\begin_inset Flex Code
\begin_layout Standard
Note that manual conversion does not affect included files, so these will
have to be converted separately.
-\change_inserted -712698321 1483873435
-
\end_layout
\begin_layout Subsection
-
-\change_inserted -712698321 1483875083
\begin_inset CommandInset label
LatexCommand label
name "subsec:Cite-Engine-Files"
\end_layout
\begin_layout Standard
-
-\change_inserted -712698321 1483874213
A specific form of layout files are the so-called
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483873546
*.citeengine
\end_layout
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483873546
citeengines/
\end_layout
\end_layout
\begin_layout Standard
-
-\change_inserted -712698321 1483874969
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
\end_layout
\begin_layout Standard
-
-\change_inserted -712698321 1483875180
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
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483874688
MaxCiteNames
-\change_unchanged
-
\end_layout
\end_inset
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483875180
CiteFramework
-\change_unchanged
-
\end_layout
\end_inset
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483874477
CiteEngine
-\change_unchanged
-
\end_layout
\end_inset
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483874482
CiteFormat
-\change_unchanged
-
\end_layout
\end_inset
\end_inset
, as well as in the files themselves.
-\change_unchanged
-
\end_layout
\begin_layout Section
\end_inset
.
-\change_inserted -712698321 1483873000
-
\end_layout
\begin_layout Subsection
-
-\change_inserted -712698321 1483873010
The CiteEngine file declaration
\end_layout
\begin_layout Standard
-
-\change_inserted -712698321 1483873022
A cite engine file must begin with a line like the following:
\end_layout
\begin_layout LyX-Code
-
-\change_inserted -712698321 1483873047
#
\backslash
DeclareLyXCiteEngineModule[biblatex.sty]{Biblatex}
\end_layout
\begin_layout Standard
-
-\change_inserted -712698321 1483873077
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
-
-\change_inserted -712698321 1483873068
Document\SpecialChar menuseparator
Settings\SpecialChar menuseparator
Bibliography
\end_layout
\begin_layout Standard
-
-\change_inserted -712698321 1483873102
The cite engine declaration should then be followed by lines like the following
\begin_inset Foot
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483873000
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
\end_layout
\begin_layout LyX-Code
-
-\change_inserted -712698321 1483873128
# DescriptionBegin
\end_layout
\begin_layout LyX-Code
-
-\change_inserted -712698321 1483873140
# Biblatex supports many author-year and numerical styles.
\end_layout
\begin_layout LyX-Code
-
-\change_inserted -712698321 1483873152
# It is mainly aimed at the Humanities.
It is highly
\end_layout
\begin_layout LyX-Code
-
-\change_inserted -712698321 1483873160
# customizable, fully localized and provides many features
\end_layout
\begin_layout LyX-Code
-
-\change_inserted -712698321 1483873170
# that are not possible with BibTeX.
The use of 'biber' as
\end_layout
\begin_layout LyX-Code
-
-\change_inserted -712698321 1483873174
# bibliography processor is advised.
\end_layout
\begin_layout LyX-Code
-
-\change_inserted -712698321 1483873224
# DescriptionEnd
\end_layout
\begin_layout Standard
-
-\change_inserted -712698321 1483873207
The description is used in
\begin_inset Flex Noun
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483873194
Document\SpecialChar menuseparator
Settings\SpecialChar menuseparator
Bibliography
\end_inset
to provide the user with information about the cite engine.
-\change_unchanged
-
\end_layout
\begin_layout Subsection
\end_inset
.
-\change_inserted -712698321 1483872509
-
\end_layout
\begin_layout Description
-
-\change_inserted -712698321 1483874560
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483872558
CiteEngine <engine>
\end_layout
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483872548
End
\end_layout
\end_inset
).
-\change_unchanged
-
\end_layout
\begin_layout Description
\end_inset
.
-
-\change_inserted -712698321 1483875199
Primarily used in cite engine files (see
\begin_inset CommandInset ref
LatexCommand ref
\end_inset
).
-\change_unchanged
-
\end_layout
\begin_layout Description
-
-\change_inserted -712698321 1483874578
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483872820
CiteFramework
\end_layout
\begin_layout Plain Layout
-\change_inserted -712698321 1483872852
-
\emph on
bibtex
-\change_unchanged
-
\end_layout
\end_inset
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483872857
biblatex
-\change_unchanged
-
\end_layout
\end_inset
\end_inset
).
-\change_unchanged
-
\end_layout
\begin_layout Description
\end_inset
.)
-\change_inserted -712698321 1483872681
-
\end_layout
\begin_layout Description
-
-\change_inserted -712698321 1483874598
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483872687
MaxCiteNames
\end_layout
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483872692
integer
\end_layout
\end_inset
).
-\change_unchanged
-
\end_layout
\begin_layout Description
\end_inset
] Deletes an existing style.
-\change_inserted 2047637253 1483900342
-
\end_layout
\begin_layout Description
-
-\change_inserted 2047637253 1483900479
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted 2047637253 1483900346
OutlinerName
\end_layout
status collapsed
\begin_layout Plain Layout
-
-\change_inserted 2047637253 1483900369
<type>
\end_layout
status collapsed
\begin_layout Plain Layout
-
-\change_inserted 2047637253 1483900418
<string>
\end_layout
status collapsed
\begin_layout Plain Layout
-
-\change_inserted 2047637253 1483900414
<type>
\end_layout
status collapsed
\begin_layout Plain Layout
-
-\change_inserted 2047637253 1483900419
<string>
\end_layout
.
See also the AddToToc commands.
-\change_unchanged
-
\end_layout
\begin_layout Description
\end_layout
\begin_layout Description
-
-\change_inserted 2047637253 1483963019
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted 2047637253 1483901753
AddToToc
\end_layout
status collapsed
\begin_layout Plain Layout
-
-\change_inserted 2047637253 1483963007
string
\end_layout
, this argument will be inserted with a copy of the co-text (either selected
text or the whole paragraph) as content.
-\change_inserted -712698321 1477038290
-
\end_layout
\begin_layout Itemize
-
-\change_inserted -712698321 1477038425
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1477038295
PassThru
\end_layout
\begin_layout Plain Layout
-\change_inserted -712698321 1477038311
-
\emph on
inherited
\emph default
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1477038356
PassThru
\end_layout
status is inherited by the inset or paragraph layout the argument belongs
to, true and false change the status for the given argument only.
-\change_unchanged
-
\end_layout
\begin_layout Itemize
arguments.
That is, arguments do not inherit PassThruChars from their parent inset
or layout.
-\change_inserted 2047637253 1483899840
-
\end_layout
\begin_layout Itemize
-
-\change_inserted 2047637253 1483900841
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted 2047637253 1483900841
IsTocCaption
\end_layout
\begin_layout Plain Layout
-\change_inserted 2047637253 1483900841
-
\emph on
0
\end_layout
status collapsed
\begin_layout Plain Layout
-
-\change_inserted 2047637253 1483900841
1
\end_layout
] If this is set to 1, the argument will output its content in the corresponding
item in the table of contents.
See AddToToc.
-\change_unchanged
-
\end_layout
\begin_layout Standard
\end_layout
\begin_layout Description
-
-\change_inserted 2047637253 1483902824
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted 2047637253 1483902211
IsTocCaption
\end_layout
\begin_layout Plain Layout
-\change_inserted 2047637253 1483902211
-
\emph on
0
\end_layout
status collapsed
\begin_layout Plain Layout
-
-\change_inserted 2047637253 1483902211
1
\end_layout
\end_inset
, but you do not want to inherit its (required and optional) arguments.
-\change_inserted 2089657418 1476488475
-
\end_layout
\begin_layout Description
-
-\change_inserted 2089657418 1476488475
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted 2089657418 1476488475
ResumeCounter
\end_layout
\begin_layout Plain Layout
-\change_inserted 2089657418 1476488475
-
\emph on
0
\end_layout
status collapsed
\begin_layout Plain Layout
-
-\change_inserted 2089657418 1476488475
1
\end_layout
status collapsed
\begin_layout Plain Layout
-
-\change_inserted 2089657418 1476488475
LabelType
\end_layout
status collapsed
\begin_layout Plain Layout
-
-\change_inserted 2089657418 1476488475
Enumerate
\end_layout
\end_inset
.
-\change_unchanged
-
\end_layout
\begin_layout Description
] Allow spell-checking paragraphs of this style.
Default is true.
-\change_inserted 2089657418 1476488264
-
\end_layout
\begin_layout Description
-
-\change_inserted 2089657418 1476488264
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted 2089657418 1476488264
StepMasterCounter
\end_layout
\begin_layout Plain Layout
-\change_inserted 2089657418 1476488264
-
\emph on
0
\end_layout
status collapsed
\begin_layout Plain Layout
-
-\change_inserted 2089657418 1476488264
1
\end_layout
status collapsed
\begin_layout Plain Layout
-
-\change_inserted 2089657418 1476488264
LabelType
\end_layout
status collapsed
\begin_layout Plain Layout
-
-\change_inserted 2089657418 1476488264
Enumerate
\end_layout
\end_inset
.
-\change_unchanged
-
\end_layout
\begin_layout Description
\end_layout
\begin_layout Description
-
-\change_inserted 2047637253 1483963036
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted 2047637253 1483900123
AddToToc
\end_layout
status collapsed
\begin_layout Plain Layout
-
-\change_inserted 2047637253 1483962897
string
\end_layout
\end_inset
] Whether to include the contents of this inset in the strings generated
- for the `Outline' pane
-\change_inserted 2047637253 1483900773
- for all table of contents, regardless of the AddToToc setting
-\change_unchanged
-.
+ for the `Outline' pane for all table of contents, regardless of the AddToToc
+ setting.
One would not, for example, want the content of a footnote in a section
header to be included in the TOC displayed in the outline, but one would
normally want the content of a character style displayed.
Default is false: not to include.
-\change_inserted 2047637253 1483900609
-
\end_layout
\begin_layout Description
-
-\change_inserted 2047637253 1483901257
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted 2047637253 1483900725
IsTocCaption
\end_layout
\begin_layout Plain Layout
-\change_inserted 2047637253 1483900620
-
\emph on
0
\end_layout
status collapsed
\begin_layout Plain Layout
-
-\change_inserted 2047637253 1483900620
1
\end_layout
] 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.
-\change_unchanged
-
\end_layout
\begin_layout Description
\end_layout
\begin_layout Subsection
-
-\change_inserted -712698321 1483869872
\begin_inset CommandInset label
LatexCommand label
name "subsec:Citation-engine-description"
\end_layout
\begin_layout Standard
-
-\change_inserted -712698321 1483875281
The
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483869913
CiteEngine
-\change_unchanged
-
\end_layout
\end_inset
\end_layout
\begin_layout Enumerate
-
-\change_inserted -712698321 1483875764
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483870430
default
-\change_unchanged
-
\end_layout
\end_inset
\end_layout
\begin_layout Enumerate
-
-\change_inserted -712698321 1483875766
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483870434
authoryear
-\change_unchanged
-
\end_layout
\end_inset
\end_layout
\begin_layout Enumerate
-
-\change_inserted -712698321 1483875769
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483870457
numerical
-\change_unchanged
-
\end_layout
\end_inset
\end_layout
\begin_layout Standard
-
-\change_inserted -712698321 1483870566
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483870552
CiteEngine
\end_layout
\end_layout
\begin_layout LyX-Code
-
-\change_inserted -712698321 1483870590
CiteEngine default
\end_layout
\begin_layout LyX-Code
-
-\change_inserted -712698321 1483870615
cite
\end_layout
\begin_layout LyX-Code
-
-\change_inserted -712698321 1483870633
Citep*[][]
\end_layout
\begin_layout LyX-Code
-
-\change_inserted -712698321 1483870652
citeyearpar[][]=parencite*
\end_layout
\begin_layout LyX-Code
-
-\change_inserted -712698321 1483870652
...
\end_layout
\begin_layout LyX-Code
-
-\change_inserted -712698321 1483870668
End
\end_layout
\begin_layout Standard
-
-\change_inserted -712698321 1483871113
The tag following
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483871085
CiteEngine
\end_layout
command and the \SpecialChar LaTeX
output or more complex in order to differentiate
things.
-
-\change_deleted -712698321 1483871114
-
-\end_layout
-
-\begin_layout Standard
-
-\change_inserted -712698321 1483871119
-The full syntax is:
+ The full syntax is:
\end_layout
\begin_layout LyX-Code
-
-\change_inserted -712698321 1484997816
LyXName|alias$*<!_stardesc!_stardesctooltip>[][]=latexcmd
\end_layout
\begin_layout Itemize
-
-\change_inserted -712698321 1483871222
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483871181
LyXName
-\change_unchanged
-
\end_layout
\end_inset
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483871216
*.lyx
-\change_unchanged
-
\end_layout
\end_inset
\begin_deeper
\begin_layout Standard
-
-\change_inserted -712698321 1483871487
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
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483871402
latexcmd
\end_layout
\end_deeper
\begin_layout Itemize
-
-\change_inserted -712698321 1483871583
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483871186
alias
-\change_unchanged
-
\end_layout
\end_inset
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483871257
LyXName
\end_layout
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483871559
alias
\end_layout
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483871278
ObsoletedBy
-\change_unchanged
-
\end_layout
\end_inset
\end_layout
\begin_layout Itemize
-
-\change_inserted -712698321 1483871307
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483871296
latexcmd
-\change_unchanged
-
\end_layout
\end_inset
\end_layout
\begin_layout Standard
-
-\change_inserted -712698321 1483871348
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483871316
Alias
-\change_unchanged
-
\end_layout
\end_inset
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483871321
latexcmd
-\change_unchanged
-
\end_layout
\end_inset
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483871333
latexcmd
\end_layout
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483871340
LyXName
\end_layout
\end_layout
\begin_layout Standard
-
-\change_inserted -712698321 1483871604
Note further:
\end_layout
\begin_layout Itemize
-
-\change_inserted -712698321 1483871664
Capitalization indicates that the command also has a capitalized form (
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-\change_inserted -712698321 1483871622
-
\backslash
Latexcmd
-\change_unchanged
-
\end_layout
\end_inset
\begin_layout Plain Layout
-\change_inserted -712698321 1483871626
-
\backslash
latexcmd
-\change_unchanged
-
\end_layout
\end_inset
\end_layout
\begin_layout Itemize
-
-\change_inserted -712698321 1483871690
Brackets
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483871670
[]
-\change_unchanged
-
\end_layout
\end_inset
\end_layout
\begin_layout Itemize
-
-\change_inserted -712698321 1483871747
A star
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483871698
*
-\change_unchanged
-
\end_layout
\end_inset
\begin_layout Plain Layout
-\change_inserted -712698321 1483871718
-
\backslash
latexcmd*
-\change_unchanged
-
\end_layout
\end_inset
\begin_layout Plain Layout
-\change_inserted -712698321 1483871724
-
\backslash
latexcmd
-\change_unchanged
-
\end_layout
\end_inset
\begin_deeper
\begin_layout Standard
-
-\change_inserted -712698321 1483871864
By default, the starred version means: Output all authors even if it should
be shortened with
\begin_inset Quotes eld
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483871835
MaxCiteNames
-\change_unchanged
-
\end_layout
\end_inset
\end_layout
\begin_layout Standard
-
-\change_inserted -712698321 1483872045
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
-
-\change_inserted -712698321 1483871856
<!_stardesc!_stardesctooltip>
-\change_unchanged
-
\end_layout
\end_inset
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483872014
!_
-\change_unchanged
-
\end_layout
\end_inset
\end_layout
\begin_layout Standard
-
-\change_inserted -712698321 1483872164
Note that these two macros have to be defined in a
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483871983
CiteFormat
-\change_unchanged
-
\end_layout
\end_inset
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483872023
!
-\change_unchanged
-
\end_layout
\end_inset
\end_layout
\begin_layout LyX-Code
-
-\change_inserted -712698321 1483872092
_stardesc Sta&rred command label
\end_layout
\begin_layout LyX-Code
-
-\change_inserted -712698321 1484997832
_stardesctooltip Tooltip for the starred command checkbox.
\end_layout
\end_deeper
\begin_layout Itemize
-
-\change_inserted -712698321 1484997948
A dollar sign
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1484997871
$
-\change_unchanged
-
\end_layout
\end_inset
\begin_layout LyX-Code
End
-\change_inserted -712698321 1483867197
-
\end_layout
\begin_layout Standard
-
-\change_inserted -712698321 1483867200
or
\end_layout
\begin_layout LyX-Code
-
-\change_inserted -712698321 1483867195
CiteFormat
\end_layout
\begin_layout LyX-Code
-
-\change_inserted -712698321 1483867204
cite ...
\end_layout
\begin_layout LyX-Code
-
-\change_inserted -712698321 1483867359
citet*[][] ...
\end_layout
\begin_layout LyX-Code
-
-\change_inserted -712698321 1483867195
End
-\change_unchanged
-
\end_layout
\begin_layout Standard
-
-\change_inserted -712698321 1483867269
-In the first case,
-\change_deleted -712698321 1483867270
-T
-\change_inserted -712698321 1483867270
-t
-\change_unchanged
-he individual lines define how the bibliographic information associated
- with an article or book, respectively, is to be displayed, and such a definitio
-n can be given for any
-\change_deleted -712698321 1483867550
-`
-\change_inserted -712698321 1483867550
-
+In the first case, the individual lines define how the bibliographic information
+ associated with an article or book, respectively, is to be displayed, and
+ such a definition can be given for any
\begin_inset Quotes els
\end_inset
-
-\change_unchanged
entry type
-\change_deleted -712698321 1483867552
-'
-\change_inserted -712698321 1483867552
-
\begin_inset Quotes ers
\end_inset
-
-\change_unchanged
that might be present in a Bib\SpecialChar TeX
file.
\SpecialChar LyX
, which is included in most of \SpecialChar LyX
's document classes.
-\change_inserted -712698321 1483867288
-
\end_layout
\begin_layout Standard
-
-\change_inserted -712698321 1483875512
In the second case, the lines define how a specific citation command (in
the example
\begin_inset Flex Code
\begin_layout Plain Layout
-\change_inserted -712698321 1483867674
-
\backslash
cite
-\change_unchanged
-
\end_layout
\end_inset
\begin_layout Plain Layout
-\change_inserted -712698321 1483867679
-
\backslash
citet
-\change_unchanged
-
\end_layout
\end_inset
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483875503
*.citeengine
\end_layout
\end_inset
).
-\change_unchanged
-
\end_layout
\begin_layout Standard
.
There must be no space between any of these.
-\change_inserted -712698321 1483867855
-
\end_layout
\begin_layout Standard
-
-\change_inserted -712698321 1483867910
Next to the entry keys, there are some special keys that can be used for
these conditionals:
\end_layout
\begin_layout Itemize
-
-\change_inserted -712698321 1483868049
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483867962
{%dialog%[[true]][[false]]}
-\change_unchanged
-
\end_layout
\end_inset
\end_layout
\begin_layout Itemize
-
-\change_inserted -712698321 1483868068
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483868052
{%export%[[true]][[false]]}
\end_layout
\end_layout
\begin_layout Itemize
-
-\change_inserted -712698321 1483868138
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483868076
{%next%[[true]]}
\end_layout
\end_layout
\begin_layout Itemize
-
-\change_inserted -712698321 1483868174
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483868144
{%second%[[true]][[false]]}
\end_layout
\end_layout
\begin_layout Itemize
-
-\change_inserted -712698321 1483868321
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483868259
{%ifstar%[[true]][[false]]}
\end_layout
\begin_layout Plain Layout
-\change_inserted -712698321 1483868310
-
\backslash
cite*
-\change_unchanged
-
\end_layout
\end_inset
\end_layout
\begin_layout Itemize
-
-\change_inserted -712698321 1483978485
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483868330
{%ifentrytype:<type>%[[true]][[false]]}
\end_layout
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483868364
<type>
-\change_unchanged
-
\end_layout
\end_inset
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483868420
{%ifentrytype:book%[[this is a book]][[this is no book]]}
-\change_unchanged
-
\end_layout
\end_inset
\end_layout
\begin_layout Itemize
-
-\change_inserted -712698321 1484997600
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483978499
{%ifmultiple:<authortype>%[[true]][[false]]}
\end_layout
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483978571
{%ifmultiple:editor%[[eds.]][[ed.]]}
\end_layout
\end_layout
\begin_layout Itemize
-
-\change_inserted -712698321 1484997681
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1484997608
{%ifqualified%[[true]][[false]]}
\end_layout
\family default
format for multi-reference citations), the false part if this is not the
case.
-\change_unchanged
-
\end_layout
\begin_layout Standard
-
-\change_inserted -712698321 1483978958
We said that
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483978693
%author%
\end_layout
\end_layout
\begin_layout Enumerate
-
-\change_inserted -712698321 1483979807
For name lists with pre- and surname, suitable for the main authors/editors
of a bibliography item.
The
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483979800
<nametype>
-\change_unchanged
-
\end_layout
\end_inset
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483979807
<nametype:author>
-\change_unchanged
-
\end_layout
\end_inset
\begin_deeper
\begin_layout Itemize
-
-\change_inserted -712698321 1483979186
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483979743
%abbrvnames:<nametype>%
-\change_unchanged
-
\end_layout
\end_inset
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483979186
MaxCiteNames
-\change_unchanged
-
\end_layout
\end_inset
\end_layout
\begin_layout Itemize
-
-\change_inserted -712698321 1483979527
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483979748
%fullnames:<nametype>%
-\change_unchanged
-
\end_layout
\end_inset
\end_layout
\begin_layout Itemize
-
-\change_inserted -712698321 1483979553
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483980138
%forceabbrvnames:<nametype>%
-\change_unchanged
-
\end_layout
\end_inset
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483979535
MaxCiteNames
\end_layout
\end_inset
.
-\change_unchanged
-
\end_layout
\end_deeper
\begin_layout Enumerate
-
-\change_inserted -712698321 1483979413
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
):
-\change_unchanged
-
\end_layout
\begin_deeper
\begin_layout Itemize
-
-\change_inserted -712698321 1483979565
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483979751
%abbrvbynames:<nametype>%
-\change_unchanged
-
\end_layout
\end_inset
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483979565
MaxCiteNames
\end_layout
\end_inset
is reached.
-\change_unchanged
-
\end_layout
\begin_layout Itemize
-
-\change_inserted -712698321 1483979570
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483979753
%fullbynames:<nametype>%
-\change_unchanged
-
\end_layout
\end_inset
\end_inset
).
-\change_unchanged
-
\end_layout
\begin_layout Itemize
-
-\change_inserted -712698321 1483979576
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483980143
%forceabbrvbynames:<nametype>%
-\change_unchanged
-
\end_layout
\end_inset
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483979574
MaxCiteNames
\end_layout
\end_deeper
\begin_layout Enumerate
-
-\change_inserted -712698321 1483980219
And finally name lists which consist of family names only, as used in author-yea
r citation labels.
these do not take a
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483979871
<nametype>
-\change_unchanged
-
\end_layout
\end_inset
part, but always return either an author list or, if this does not exist,
an editor list (as common in author-year labels):
-\change_unchanged
-
\end_layout
\begin_deeper
\begin_layout Itemize
-
-\change_inserted -712698321 1483979715
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483979700
%abbrvciteauthor%
-\change_unchanged
-
\end_layout
\end_inset
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483979715
MaxCiteNames
\end_layout
\end_inset
is reached.
-\change_unchanged
-
\end_layout
\begin_layout Itemize
-
-\change_inserted -712698321 1483979721
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483979703
%fullciteauthor%
-\change_unchanged
-
\end_layout
\end_inset
\end_inset
).
-\change_unchanged
-
\end_layout
\begin_layout Itemize
-
-\change_inserted -712698321 1483980272
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483979705
%forceabbrvciteauthor%
-\change_unchanged
-
\end_layout
\end_inset
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483979726
MaxCiteNames
\end_layout
\end_deeper
\begin_layout Standard
-
-\change_inserted -712698321 1483980314
The order of pre- and surname in the former two lists can be adjusted by
these macros:
\end_layout
\begin_layout Itemize
-
-\change_inserted -712698321 1483980535
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483980354
!firstnameform %surname%, %prename%
-\change_unchanged
-
\end_layout
\end_inset
\end_layout
\begin_layout Itemize
-
-\change_inserted -712698321 1483980557
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483980367
!othernameform %surname%, %prename%
-\change_unchanged
-
\end_layout
\end_inset
(other authors in lists of type 1)
-\change_unchanged
-
\end_layout
\begin_layout Itemize
-
-\change_inserted -712698321 1483980550
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483980373
!firstbynameform %prename% %surname%
-\change_unchanged
-
\end_layout
\end_inset
\end_layout
\begin_layout Itemize
-
-\change_inserted -712698321 1483980570
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483980381
!otherbynameform %prename% %surname%
-\change_unchanged
-
\end_layout
\end_inset
\end_layout
\begin_layout Standard
-
-\change_inserted -712698321 1483980643
This allows you to configure namings like
\begin_inset Quotes eld
\end_inset
\end_inset
.
-\change_unchanged
-
\end_layout
\begin_layout Standard
\begin_layout Standard
This defines a translatable piece of text, which allows relevant parts of
- the bibliography
-\change_inserted -712698321 1483868477
-or citation
-\change_unchanged
-to be translated.
+ the bibliography or citation to be translated.
It can be included in a definition by treating it as a key:
\begin_inset Flex Code
status collapsed
\end_inset
-
-\change_inserted -712698321 1483868503
and the diverse
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1483868503
*.citeengine
-\change_unchanged
-
\end_layout
\end_inset
- files
-\change_unchanged
-.
+ files.
Note that these are not macros, in the sense just defined.
They will not be expanded.
\end_layout
\end_layout
\begin_layout Section
-The external template configuration file
-\change_inserted -712698321 1490533960
-s
-\change_unchanged
-
+The external template configuration files
\end_layout
\begin_layout Standard
\end_layout
\begin_layout Standard
-The external templates are defined in the
-\change_inserted -712698321 1490534022
-
+The external templates are defined in the
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-
-\change_inserted -712698321 1490533996
*.xtemplate
\end_layout
\end_inset
- files that are stored in the
-\change_unchanged
-
+ files that are stored in the
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-LyXDir/lib/
-\change_deleted -712698321 1490533984
-external_
-\change_inserted -712698321 1490533984
-x
-\change_unchanged
-templates
-\change_inserted -712698321 1490534077
-/
-\change_unchanged
-
+LyXDir/lib/xtemplates/
\end_layout
\end_inset
-
-\change_deleted -712698321 1490534025
-file
-\change_inserted -712698321 1490534028
-directory
-\change_unchanged
-.
-
-\change_inserted -712698321 1490534233
-Each template is defined in a file of its own.
-
-\change_unchanged
-You can place your own
-\change_deleted -712698321 1490534089
-version
-\change_inserted -712698321 1490534090
-templates
-\change_unchanged
- in
+ directory.
+ Each template is defined in a file of its own.
+ You can place your own templates in
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-UserDir/
-\change_deleted -712698321 1490534069
-external_
-\change_inserted -712698321 1490534069
-x
-\change_unchanged
-templates
-\change_inserted -712698321 1490534080
-/
-\change_unchanged
-
+UserDir/xtemplates/
\end_layout
\end_inset
-
-\change_inserted -712698321 1490534112
- or copy existing templates to that directory in order to modify them
-\change_unchanged
-.
+ or copy existing templates to that directory in order to modify them.
\end_layout
\begin_layout Standard
#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
\suppress_date false
\justification true
\use_refstyle 0
+\use_minted 0
\notefontcolor #0000ff
\branch OutDated
\selected 0
\paragraph_separation indent
\paragraph_indentation default
\is_math_indent 1
+\math_indentation default
+\math_numbering_side default
\quotes_style german
+\dynamic_quotes 0
\papercolumns 1
\papersides 2
\paperpagestyle headings
\html_math_output 0
\html_css_as_file 0
\html_be_strict false
+\author 34634807 "Jean-Pierre"
\end_header
\begin_body
\begin_inset Newline newline
\end_inset
-Version 2.2.x
+Version 2.3.x
\end_layout
\begin_layout Standard
\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
+
\family typewriter
\series medium
clipart/
welchen Menüs sind, und wie die Werkzeugleiste zusammengesetzt ist.
\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
Dateien, die Sie nicht verändern sollten
\end_layout
\begin_layout Labeling
\labelwidthstring 00.00.0000
-\family typewriter
-external_templates
-\family default
- Diese Datei enthält die Vorlagen für das Feature
-\family sans
-Externes
-\begin_inset space \space{}
-\end_inset
-
-Material
-\family default
--Modul.
- Siehe dazu
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "cha:Externes-Material-einfügen"
-
-\end_inset
-
-
-\end_layout
-
-\begin_layout Labeling
-\labelwidthstring 00.00.0000
-
\family typewriter
languages
\family default
Diese müssen separat konvertiert werden.
\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
Das Layout-Dateiformat
\begin_inset CommandInset label
\end_layout
\begin_layout Subsection
-Dateiformat
+
+\lang english
+The CiteEngine file declaration
\end_layout
\begin_layout Standard
-Die erste Zeile, die kein Kommentar ist, muss die Dateiformatnummer enthalten:
+
+\lang english
+A cite engine file must begin with a line like the following:
\end_layout
-\begin_layout Description
-\begin_inset Flex Code
-status collapsed
+\begin_layout LyX-Code
-\begin_layout Plain Layout
-Format
+\lang english
+#
+\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
-int
+
+\lang english
+Document\SpecialChar menuseparator
+Settings\SpecialChar menuseparator
+Bibliography
\end_layout
\end_inset
-] Die Nummer des Formats der Layout-Datei.
+.
+ The argument in square brackets is optional: It declares any \SpecialChar LaTeX
+ packages
+ on which the cite engine depends.
\end_layout
\begin_layout Standard
-Dieser Tag wurde mit \SpecialChar LyX
-
-\begin_inset space ~
-\end_inset
-1.4.0 eingeführt.
- Layout-Dateien älteren \SpecialChar LyX
--Versionen haben kein explizites Format und werden
- als
-\begin_inset Flex Code
+\lang english
+The cite engine declaration should then be followed by lines like the following
+\begin_inset Foot
status collapsed
\begin_layout Plain Layout
-Format
-\begin_inset space ~
-\end_inset
-1
+\lang english
+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
- behandelt.
- Das Format dieser \SpecialChar LyX
--Version ist 60.
- Aber jede \SpecialChar LyX
--Version kann ältere Versionen von Layout-Dateien lesen, so wie
- es ältere \SpecialChar LyX
+:
+\end_layout
+
+\begin_layout LyX-Code
+
+\lang english
+# DescriptionBegin
+\end_layout
+
+\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
+Dateiformat
+\end_layout
+
+\begin_layout Standard
+Die erste Zeile, die kein Kommentar ist, muss die Dateiformatnummer enthalten:
+\end_layout
+
+\begin_layout Description
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+Format
+\end_layout
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+int
+\end_layout
+
+\end_inset
+
+] Die Nummer des Formats der Layout-Datei.
+\end_layout
+
+\begin_layout Standard
+Dieser Tag wurde mit \SpecialChar LyX
+
+\begin_inset space ~
+\end_inset
+
+1.4.0 eingeführt.
+ Layout-Dateien älteren \SpecialChar LyX
+-Versionen haben kein explizites Format und werden
+ als
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+Format
+\begin_inset space ~
+\end_inset
+
+1
+\end_layout
+
+\end_inset
+
+ behandelt.
+ Das Format dieser \SpecialChar LyX
+-Version ist 60.
+ Aber jede \SpecialChar LyX
+-Version kann ältere Versionen von Layout-Dateien lesen, so wie
+ es ältere \SpecialChar LyX
-Dateien lesen kann.
Es gibt jedoch keine Unterstützung in ältere Formate zu konvertieren.
\end_layout
\begin_layout Description
+\lang english
+\begin_inset Flex Code
+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
+
\family typewriter
\begin_inset Flex Code
status collapsed
\end_inset
beendet werden.
+
+\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
\end_inset
.
+
+\lang english
+ (Note that this is not a `length', like
+\begin_inset Quotes eld
+\end_inset
+
+2ex
+\begin_inset Quotes erd
+\end_inset
+
+.)
\end_layout
\begin_layout Description
+
+\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-ModifyStyle
+
+\lang english
+MaxCiteNames
\end_layout
\end_inset
status collapsed
\begin_layout Plain Layout
-<Stil>
+
+\lang english
+integer
\end_layout
\end_inset
-] Ändert die Eigenschaften des angegebenen Paragraphstils.
- Wenn dieser nicht existiert, wird die Anweisung ignoriert.
- Muss mit
-\begin_inset Quotes gld
+] 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
-
-\begin_inset Flex Code
-status collapsed
-
-\begin_layout Plain Layout
-End
-\end_layout
-
+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"
-\begin_inset Quotes grd
\end_inset
- beendet werden.
+).
\end_layout
\begin_layout Description
status collapsed
\begin_layout Plain Layout
-NoCounter
+ModifyStyle
+\end_layout
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+<Stil>
+\end_layout
+
+\end_inset
+
+] Ändert die Eigenschaften des angegebenen Paragraphstils.
+ Wenn dieser nicht existiert, wird die Anweisung ignoriert.
+ Muss mit
+\begin_inset Quotes gld
+\end_inset
+
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+End
+\end_layout
+
+\end_inset
+
+
+\begin_inset Quotes grd
+\end_inset
+
+ beendet werden.
+\end_layout
+
+\begin_layout Description
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+NoCounter
\end_layout
\end_inset
Innerhalb des Blocks sind folgende Befehle erlaubt:
\end_layout
+\begin_layout Description
+
+\lang english
+\begin_inset Flex Code
+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 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
\begin_inset Flex Code
status collapsed
text or the whole paragraph) as content.
\end_layout
+\begin_layout Itemize
+
+\lang english
+\begin_inset Flex Code
+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
\begin_inset Flex Code
status collapsed
or layout.
\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
\lang english
).
\end_layout
+\begin_layout Description
+
+\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 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
\begin_inset Flex Code
status collapsed
\end_layout
\begin_layout Description
+
+\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-RightDelim
+
+\lang english
+ResumeCounter
\end_layout
\end_inset
status collapsed
\begin_layout Plain Layout
-string
-\end_layout
-\end_inset
-
-] Eine Zeichenkette, die am Ende des Inhalts des Stils ausgegeben wird.
- Ein Zeilenumbruch in der Ausgabe wird mit
-\begin_inset Flex Code
-status collapsed
-
-\begin_layout Plain Layout
-<br/>
+\emph on
+\lang english
+0
\end_layout
\end_inset
- angegeben.
-\end_layout
-
-\begin_layout Description
+,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-RightMargin
+
+\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
-string=""
+
+\lang english
+LabelType
\end_layout
\end_inset
-] Ähnlich wie
+ is
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-LeftMargin
+
+\lang english
+Enumerate
\end_layout
\end_inset
status collapsed
\begin_layout Plain Layout
-Spacing
+RightDelim
\end_layout
\end_inset
status collapsed
\begin_layout Plain Layout
-
-\emph on
-single
+string
\end_layout
\end_inset
-,
+] Eine Zeichenkette, die am Ende des Inhalts des Stils ausgegeben wird.
+ Ein Zeilenumbruch in der Ausgabe wird mit
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-onehalf
+<br/>
\end_layout
\end_inset
-,
+ angegeben.
+\end_layout
+
+\begin_layout Description
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+RightMargin
+\end_layout
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+string=""
+\end_layout
+
+\end_inset
+
+] Ähnlich wie
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+LeftMargin
+\end_layout
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Description
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+Spacing
+\end_layout
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\emph on
+single
+\end_layout
+
+\end_inset
+
+,
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+onehalf
+\end_layout
+
+\end_inset
+
+,
\begin_inset Flex Code
status collapsed
\end_inset
- angeben, müssen Sie als
+ angeben, müssen Sie
+\change_deleted 34634807 1501859525
+
+\change_unchanged
+ als
\emph on
Wert
\emph default
] Erlaubt es, den Inhalt des Absatzes auf Rechtschreibung zu überprüfen.
\end_layout
+\begin_layout Description
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+StepMasterCounter
+\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
+
+] 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
+
+\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
\begin_inset Flex Code
status collapsed
-Definition kann folgende Einträge enthalten:
\end_layout
+\begin_layout Description
+
+\lang english
+\begin_inset Flex Code
+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
\begin_inset Flex Code
status collapsed
\end_inset
] Ob der Inhalt der Einfügung für die Zeichenketten des 'Gliederungs'-Fensters
- verwendet werden soll.
+ verwendet werden soll
+\lang english
+ for all table of contents, regardless of the AddToToc setting
+\lang ngerman
+.
Zum Beispiel will man nicht, dass der Inhalt einer Fußzeile im Namen des
Abschnitts im Inhaltsverzeichnis des Gliederungs-Fensters erscheint.
Aber man will normalerweise, dass der Inhalt von Zeichenstilen erscheint.
\end_layout
+\begin_layout Description
+
+\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 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
\begin_inset Flex Code
status collapsed
.
\end_layout
-\begin_layout Description
-
-\end_layout
-
\begin_layout Standard
Zusammenfassend bedeutet das, dass die \SpecialChar LaTeX
-Ausgabe entweder:
\end_inset
-,
-\begin_inset Flex Code
-status collapsed
+,
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+normal
+\end_layout
+
+\end_inset
+
+,
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+large
+\end_layout
+
+\end_inset
+
+,
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+larger
+\end_layout
+
+\end_inset
+
+,
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+largest
+\end_layout
+
+\end_inset
+
+,
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+huge
+\end_layout
+
+\end_inset
+
+,
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+giant
+\end_layout
+
+\end_inset
+
+]
+\end_layout
+
+\begin_layout Subsection
+
+\lang english
+\begin_inset CommandInset label
+LatexCommand label
+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
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:Citation-format-description"
+
+\end_inset
+
+
+\lang english
+Citation format description
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+The
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+CiteFormat
+\end_layout
+
+\end_inset
+
+ blocks are used to describe how bibliographic information should be displayed,
+ both within \SpecialChar LyX
+ itself (in the citation dialog and in tooltips, for example)
+ and in XHTML output.
+ Such a block might look like this:
+\end_layout
+
+\begin_layout LyX-Code
+CiteFormat
+\end_layout
+
+\begin_layout LyX-Code
+ article ...
+\end_layout
+
+\begin_layout LyX-Code
+ book ...
+\end_layout
+
+\begin_layout LyX-Code
+End
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+or
+\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
+In the first case, t
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+he individual lines define how the bibliographic information associated
+ with an article or book, respectively, is to be displayed, and such a definitio
+n can be given for any `entry type' that might be present in a Bib\SpecialChar TeX
+ file.
+ \SpecialChar LyX
+ defines a default format in the source code that will be used if no specific
+ definition has been given.
+ \SpecialChar LyX
+ predefines several formats in the file
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+stdciteformats.inc
+\end_layout
+
+\end_inset
+
+, which is included in most of \SpecialChar LyX
+'s document classes.
+\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
+
+\lang english
+The definitions use a simple language that allows Bib\SpecialChar TeX
+ keys to be replaced
+ with their values.
+ Keys should be enclosed in
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+%
+\end_layout
+
+\end_inset
+
+ signs, e.g.:
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+%author%
+\end_layout
+
+\end_inset
+
+.
+ So a simple definition might look like this:
+\end_layout
+
+\begin_layout LyX-Code
+misc %author%,
+\begin_inset Quotes eld
+\end_inset
+
+%title%
+\begin_inset Quotes erd
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+This would print the author, followed by a comma, followed by the title,
+ in quotes, followed by a period.
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+Of course, sometimes you may want to print a key only if it exists.
+ This can be done by using a conditional construction, such as:
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+{%volume%[[vol.
+\begin_inset space ~
+\end_inset
+
+%volume%]]}
+\end_layout
+
+\end_inset
+
+.
+ This says: If the
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+volume
+\end_layout
+
+\end_inset
+
+ key exists, then print
+\begin_inset Quotes eld
+\end_inset
+
+vol.
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset Quotes erd
+\end_inset
+
+ followed by the volume key.
+ It is also possible to have an else clause in the conditional, such as:
+\begin_inset Newline newline
+\end_inset
+
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+{%author%[[%author%]][[%editor%, ed.]]}
+\end_layout
+
+\end_inset
+
+
+\begin_inset Newline newline
+\end_inset
+
+Here, the
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+author
+\end_layout
+
+\end_inset
+
+ key is printed if it exists; otherwise, the editor key is printed, followed
+ by
+\begin_inset Quotes eld
+\end_inset
+
+,
+\begin_inset space ~
+\end_inset
+
+ed.
+\begin_inset Quotes erd
+\end_inset
+
+ Note that the key is again enclosed in
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+%
+\end_layout
+
+\end_inset
+
+ signs; the entire conditional is enclosed in braces; and the if and else
+ clauses are enclosed in double brackets,
+\begin_inset Quotes eld
+\end_inset
+
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+[[
+\end_layout
+
+\end_inset
+
+
+\begin_inset Quotes eld
+\end_inset
+
+ and
+\begin_inset Quotes eld
+\end_inset
+
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+]]
+\end_layout
+
+\end_inset
+
+
+\begin_inset Quotes erd
+\end_inset
+
+.
+ There must be no space between any of these.
+\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
-\begin_layout Plain Layout
-normal
+):
\end_layout
-\end_inset
+\begin_deeper
+\begin_layout Itemize
-,
+\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-large
+
+\lang english
+%abbrvbynames:<nametype>%
\end_layout
\end_inset
-,
-\begin_inset Flex Code
-status collapsed
-
-\begin_layout Plain Layout
-larger
-\end_layout
+: 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
-largest
+
+\lang english
+MaxCiteNames
\end_layout
\end_inset
-,
-\begin_inset Flex Code
-status collapsed
-
-\begin_layout Plain Layout
-huge
+ is reached.
\end_layout
-\end_inset
+\begin_layout Itemize
-,
+\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-giant
-\end_layout
-
-\end_inset
-]
+\lang english
+%fullbynames:<nametype>%
\end_layout
-\begin_layout Subsection
-\begin_inset CommandInset label
-LatexCommand label
-name "subsec:Citation-format-description"
+\end_inset
+: Provides a full name list (never abbreviated with
+\begin_inset Quotes eld
\end_inset
+et al.
+\begin_inset Quotes erd
+\end_inset
-\lang english
-Citation format description
+).
\end_layout
-\begin_layout Standard
+\begin_layout Itemize
\lang english
-The
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
-CiteFormat
+%forceabbrvbynames:<nametype>%
\end_layout
\end_inset
- blocks are used to describe how bibliographic information should be displayed,
- both within \SpecialChar LyX
- itself (in the citation dialog and in tooltips, for example)
- and in XHTML output.
- Such a block might look like this:
-\end_layout
-
-\begin_layout LyX-Code
-CiteFormat
-\end_layout
-
-\begin_layout LyX-Code
- article ...
-\end_layout
-
-\begin_layout LyX-Code
- book ...
-\end_layout
-
-\begin_layout LyX-Code
-End
-\end_layout
+: Provides a name list which is always abbreviated (with
+\begin_inset Quotes eld
+\end_inset
-\begin_layout Standard
+et al.
+\begin_inset Quotes erd
+\end_inset
-\lang english
-The individual lines define how the bibliographic information associated
- with an article or book, respectively, is to be displayed, and such a definitio
-n can be given for any `entry type' that might be present in a Bib\SpecialChar TeX
- file.
- \SpecialChar LyX
- defines a default format in the source code that will be used if no specific
- definition has been given.
- \SpecialChar LyX
- predefines several formats in the file
+) irrespective of
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
-stdciteformats.inc
+MaxCiteNames
\end_layout
\end_inset
-, which is included in most of \SpecialChar LyX
-'s document classes.
+.
\end_layout
-\begin_layout Standard
+\end_deeper
+\begin_layout Enumerate
\lang english
-The definitions use a simple language that allows Bib\SpecialChar TeX
- keys to be replaced
- with their values.
- Keys should be enclosed in
+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
-%
+<nametype>
\end_layout
\end_inset
- signs, e.g.:
+ 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_deeper
+\begin_layout Itemize
+
+\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
-%author%
+%abbrvciteauthor%
\end_layout
\end_inset
-.
- So a simple definition might look like this:
-\end_layout
-
-\begin_layout LyX-Code
-misc %author%,
+: 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
-
-\lang english
-This would print the author, followed by a comma, followed by the title,
- in quotes, followed by a period.
-\end_layout
-
-\begin_layout Standard
-
-\lang english
-Of course, sometimes you may want to print a key only if it exists.
- This can be done by using a conditional construction, such as:
+) when
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
-{%volume%[[vol.
-\begin_inset space ~
+MaxCiteNames
+\end_layout
+
\end_inset
-%volume%]]}
+ is reached.
\end_layout
-\end_inset
+\begin_layout Itemize
-.
- This says: If the
+\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
-volume
+%fullciteauthor%
\end_layout
\end_inset
- key exists, then print
+: Provides a full name list (never abbreviated with
\begin_inset Quotes eld
\end_inset
-vol.
-\begin_inset space ~
-\end_inset
-
-
+et al.
\begin_inset Quotes erd
\end_inset
- followed by the volume key.
- It is also possible to have an else clause in the conditional, such as:
-\begin_inset Newline newline
-\end_inset
+).
+\end_layout
+\begin_layout Itemize
+\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
-{%author%[[%author%]][[%editor%, ed.]]}
+%forceabbrvciteauthor%
\end_layout
\end_inset
+: Provides a name list which is always abbreviated (with
+\begin_inset Quotes eld
+\end_inset
-\begin_inset Newline newline
+et al.
+\begin_inset Quotes erd
\end_inset
-Here, the
+) irrespective of
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
-author
+MaxCiteNames
\end_layout
\end_inset
- key is printed if it exists; otherwise, the editor key is printed, followed
- by
-\begin_inset Quotes eld
-\end_inset
+.
+\end_layout
-,
-\begin_inset space ~
-\end_inset
+\end_deeper
+\begin_layout Standard
-ed.
-\begin_inset Quotes erd
-\end_inset
+\lang english
+The order of pre- and surname in the former two lists can be adjusted by
+ these macros:
+\end_layout
- Note that the key is again enclosed in
+\begin_layout Itemize
+
+\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
-%
+!firstnameform %surname%, %prename%
\end_layout
\end_inset
- signs; the entire conditional is enclosed in braces; and the if and else
- clauses are enclosed in double brackets,
-\begin_inset Quotes eld
-\end_inset
+ (first author in lists of type 1)
+\end_layout
+\begin_layout Itemize
+\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
-[[
+!othernameform %surname%, %prename%
\end_layout
\end_inset
+ (other authors in lists of type 1)
+\end_layout
-\begin_inset Quotes eld
-\end_inset
+\begin_layout Itemize
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+!firstbynameform %prename% %surname%
+\end_layout
- and
-\begin_inset Quotes eld
\end_inset
+ (first author in lists of type 2)
+\end_layout
+
+\begin_layout Itemize
+\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
-]]
+!otherbynameform %prename% %surname%
+\end_layout
+
+\end_inset
+
+ (other authors in lists of type 2)
\end_layout
+\begin_layout Standard
+
+\lang english
+This allows you to configure namings like
+\begin_inset Quotes eld
\end_inset
+Miller, Peter and Mary Smith: \SpecialChar ldots
+, in: John Doe and Pat Green, eds.:\SpecialChar ldots
\begin_inset Quotes erd
\end_inset
.
- There must be no space between any of these.
\end_layout
\begin_layout Standard
\lang english
This defines a translatable piece of text, which allows relevant parts of
- the bibliography to be translated.
+ the bibliography or citation to be translated.
It can be included in a definition by treating it as a key:
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
-stdciteformats.inc
+stdciteformats.inc and the diverse
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+*.citeengine
+\end_layout
+
+\end_inset
+
+ files
\end_layout
\end_inset
\begin_layout Section
\lang english
-The external template configuration file
+The external template configuration files
\end_layout
\begin_layout Standard
\begin_layout Plain Layout
-\family sans
\lang english
-LyX
-\family default
-Dir/lib/external_templates
+*.xtemplate
\end_layout
\end_inset
- file.
- You can place your own version in
+ files that are stored in the
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\lang english
-UserDir/external_templates
+LyXDir/lib/xtemplates/
\end_layout
\end_inset
-.
+ directory.
+ Each template is defined in a file of its own.
+ You can place your own templates in
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+UserDir/xtemplates/
+\end_layout
+
+\end_inset
+
+ or copy existing templates to that directory in order to modify them.
\end_layout
\begin_layout Standard
#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
\suppress_date false
\justification true
\use_refstyle 0
+\use_minted 0
\notefontcolor #0000ff
\branch OutDated
\selected 0
\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
\begin_inset Newline newline
\end_inset
-Versión 2.2.x
+Versión 2.3.x
\end_layout
\begin_layout Standard
, ésta se usará en primer lugar.
\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
que definen la interfaz de usuario de \SpecialChar LyX
.
Esto es, archivos que definen qué ítems aparecen en qué menús y barras
- de herramientas.
+ de herramientas
+\lang english
+.
+\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
\begin_inset Flex Code
status collapsed
-\begin_layout Plain Layout
-external_templates
-\end_layout
-
-\end_inset
-
- contiene las plantillas disponibles para la característica
-\begin_inset Flex Noun
-status collapsed
-
-\begin_layout Plain Layout
-Material externo
-\end_layout
-
-\end_inset
-
-, véase
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "cap:Inserción-de-material"
-
-\end_inset
-
-.
-\end_layout
-
-\begin_layout Labeling
-\labelwidthstring 00.00.0000
-\begin_inset Flex Code
-status collapsed
-
\begin_layout Plain Layout
languages
\end_layout
tendrán que convertirse separadamente.
\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
Estructura del archivo `layout'
\begin_inset CommandInset label
\end_layout
\begin_layout Subsection
-Número de formato
+
+\lang english
+The CiteEngine file declaration
\end_layout
\begin_layout Standard
-La primera línea no comentada de cualquier archivo `layout', `inc' o `module'
-
-\emph on
-debe
-\emph default
- contener el número de formato del archivo:
+
+\lang english
+A cite engine file must begin with a line like the following:
\end_layout
-\begin_layout Description
-\begin_inset Flex Code
-status collapsed
+\begin_layout LyX-Code
-\begin_layout Plain Layout
-Format
+\lang english
+#
+\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
-int
+
+\lang english
+Document\SpecialChar menuseparator
+Settings\SpecialChar menuseparator
+Bibliography
\end_layout
\end_inset
-] El número de formato del archivo de formato (`layout').
+.
+ The argument in square brackets is optional: It declares any \SpecialChar LaTeX
+ packages
+ on which the cite engine depends.
\end_layout
\begin_layout Standard
-Esta etiqueta se introdujo en \SpecialChar LyX
-
-\begin_inset space ~
-\end_inset
-1.4.0.
- Los archivos anteriores no tienen un número explícito y se consideran como
-
-\begin_inset Flex Code
+\lang english
+The cite engine declaration should then be followed by lines like the following
+\begin_inset Foot
status collapsed
\begin_layout Plain Layout
-Format
-\begin_inset space ~
-\end_inset
-1
+\lang english
+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
-.
- El número para la versión actual de \SpecialChar LyX
+:
+\end_layout
+
+\begin_layout LyX-Code
+
+\lang english
+# DescriptionBegin
+\end_layout
+
+\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
+Número de formato
+\end_layout
+
+\begin_layout Standard
+La primera línea no comentada de cualquier archivo `layout', `inc' o `module'
+
+\emph on
+debe
+\emph default
+ contener el número de formato del archivo:
+\end_layout
+
+\begin_layout Description
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+Format
+\end_layout
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+int
+\end_layout
+
+\end_inset
+
+] El número de formato del archivo de formato (`layout').
+\end_layout
+
+\begin_layout Standard
+Esta etiqueta se introdujo en \SpecialChar LyX
+
+\begin_inset space ~
+\end_inset
+
+1.4.0.
+ Los archivos anteriores no tienen un número explícito y se consideran como
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+Format
+\begin_inset space ~
+\end_inset
+
+1
+\end_layout
+
+\end_inset
+
+.
+ El número para la versión actual de \SpecialChar LyX
es formato 60.
Cada versión de \SpecialChar LyX
es capaz de leer los formatos de versiones anteriores,
.
\end_layout
+\begin_layout Description
+
+\lang english
+\begin_inset Flex Code
+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
\begin_inset Flex Code
status collapsed
\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
.
\end_layout
+\begin_layout Description
+
+\lang english
+\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
+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
\begin_inset Flex Code
status collapsed
\end_layout
\begin_layout Description
+
+\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-Align
+
+\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 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
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+Align
\end_layout
\end_inset
o párrafo completo) como contenido.
\end_layout
+\begin_layout Itemize
+
+\lang english
+\begin_inset Flex Code
+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
\begin_inset Flex Code
status collapsed
o formato padre.
\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
Por omisión, el texto introducido en el área de trabajo de \SpecialChar LyX
en el archivo
).
\end_layout
+\begin_layout Description
+
+\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 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
\begin_inset Flex Code
status collapsed
, pero no quieres heredar sus argumentos (requerido y opcional).
\end_layout
+\begin_layout Description
+
+\lang english
+\begin_inset Flex Code
+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
\begin_inset Flex Code
status collapsed
\end_layout
\begin_layout Description
+
+\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-TextFont
+
+\lang english
+StepMasterCounter
\end_layout
\end_inset
- La tipografía para el cuerpo del texto.
- Véase la sección
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "subsec:Tipografía"
+ [
+\begin_inset Flex Code
+status collapsed
-\end_inset
+\begin_layout Plain Layout
-.
+\emph on
+\lang english
+0
\end_layout
-\begin_layout Description
+\end_inset
+
+,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-TocLevel
+
+\lang english
+1
\end_layout
\end_inset
- [
+] 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
+
+\lang english
+LabelType
\end_layout
\end_inset
-] El nivel del estilo en el índice general.
- Esto se usa para la numeración automática de los encabezados de sección.
-\end_layout
-
-\begin_layout Description
+ is
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-ToggleIndent
-\end_layout
+
+\lang english
+Enumerate
+\end_layout
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Description
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+TextFont
+\end_layout
+
+\end_inset
+
+ La tipografía para el cuerpo del texto.
+ Véase la sección
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Tipografía"
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Description
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+TocLevel
+\end_layout
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+int=3
+\end_layout
+
+\end_inset
+
+] El nivel del estilo en el índice general.
+ Esto se usa para la numeración automática de los encabezados de sección.
+\end_layout
+
+\begin_layout Description
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+ToggleIndent
+\end_layout
\end_inset
puede contener las siguientes entradas:
\end_layout
+\begin_layout Description
+
+\lang english
+\begin_inset Flex Code
+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
\begin_inset Flex Code
status collapsed
\end_inset
] Incluye o no el contenido de este inset en la cadena generada para el
- panel 'Navegador de contorno'.
+ panel 'Navegador de contorno'
+\lang english
+ for all table of contents, regardless of the AddToToc setting
+\lang spanish
+.
El no sería, por ejemplo, para que el contenido de una nota al pie en un
encabezado de sección no aparezca en el índice que se despliega en el navegador
de contorno, sin embargo, normalmente sí se incluiría el contenido de un
Predeterminado es false: no incluir.
\end_layout
+\begin_layout Description
+
+\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 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
\begin_inset Flex Code
status collapsed
\end_inset
-\end_layout
-
-\begin_layout Description
-
\end_layout
\begin_layout Standard
\end_inset
-,
+,
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+giant
+\end_layout
+
+\end_inset
+
+]
+\end_layout
+
+\begin_layout Subsection
+
+\lang english
+\begin_inset CommandInset label
+LatexCommand label
+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
+Descripción del formato de cita
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:Descripción-formato-cita"
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Los bloques
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+CiteFormat
+\end_layout
+
+\end_inset
+
+ se usan para describir la forma en que debe mostrarse la información bibliográf
+ica, tanto en \SpecialChar LyX
+ (en el diálogo de citas y en las ayudas emergentes, por ejemplo)
+ como en la salida XHTML.
+ El aspecto de unode estos bloques podría ser este:
+\end_layout
+
+\begin_layout LyX-Code
+CiteFormat
+\end_layout
+
+\begin_layout LyX-Code
+ article ...
+\end_layout
+
+\begin_layout LyX-Code
+ book ...
+\end_layout
+
+\begin_layout LyX-Code
+End
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+or
+\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
+In the first case, the individual lines
+\lang spanish
+definen cómo se va a mostrar la información bibliográfica asociada con un
+ artículo o libro, respectivamente, y tales definiciones se pueden dar para
+ cualquier `tipo de entrada' que pudiera estar presente en un archivo Bib\SpecialChar TeX
+.
+ \SpecialChar LyX
+ define un formato por omsión en el código fuente que se usará si no se
+ da una definición específica.
+ \SpecialChar LyX
+ predefine varios formatos en el archivo
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+stdciteformats.inc
+\end_layout
+
+\end_inset
+
+, que se incluye en la mayoría de las clases de documento de \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
+Las definiciones usan un lenguaje simple que permite reemplazar las claves
+ Bib\SpecialChar TeX
+ por sus valores.
+ Las claves deben encerrarse entre símbolos
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+%
+\end_layout
+
+\end_inset
+
+, p.
+\begin_inset space \thinspace{}
+\end_inset
+
+ej.:
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+%author%
+\end_layout
+
+\end_inset
+
+.
+ Así, una simple definición sería:
+\end_layout
+
+\begin_layout LyX-Code
+misc %author%,
+\begin_inset Quotes eld
+\end_inset
+
+%title%
+\begin_inset Quotes erd
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Standard
+Esto imprimiría el autor, una coma, a continuación el título entre comillas
+ y un punto para finalizar.
+\end_layout
+
+\begin_layout Standard
+A veces querrás, por supuesto, imprimir una clave solo si existe.
+ Esto puede hacerse mediante una construcción condicional tal como:
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+{%volume%[[vol.
+\begin_inset space ~
+\end_inset
+
+%volume%]]}
+\end_layout
+
+\end_inset
+
+, que quiere decir: si la clave
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+volume
+\end_layout
+
+\end_inset
+
+ existe, imprime
+\begin_inset Quotes eld
+\end_inset
+
+vol.
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset Quotes erd
+\end_inset
+
+ seguido de la clave.
+ También es posible tener una cláusula de otro modo en el condicional, como:
+\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
+
+Aquí, la clave
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+author
+\end_layout
+
+\end_inset
+
+ se imprime si existe; por otra parte, se imprime la clave
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+author
+\end_layout
+
+\end_inset
+
+ seguida por
+\begin_inset Quotes eld
+\end_inset
+
+,
+\begin_inset space ~
+\end_inset
+
+ed.
+\begin_inset Quotes erd
+\end_inset
+
+.
+ Advierte que la clave se encierra entre signos
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+%
+\end_layout
+
+\end_inset
+
+; el condicional entero se encierra entre llaves; y las cláusulas condicional
+ y por otra parte se ponen entre cobles corchetes,
+\begin_inset Quotes eld
+\end_inset
+
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+[[
+\end_layout
+
+\end_inset
+
+
+\begin_inset Quotes eld
+\end_inset
+
+ y
+\begin_inset Quotes eld
+\end_inset
+
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+]]
+\end_layout
+
+\end_inset
+
+
+\begin_inset Quotes erd
+\end_inset
+
+.
+ No debe haber espacios entre ninguno de ellos.
+\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
+
+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
-giant
-\end_layout
-
-\end_inset
-]
+\lang english
+%fullbynames:<nametype>%
\end_layout
-\begin_layout Subsection
-Descripción del formato de cita
-\begin_inset CommandInset label
-LatexCommand label
-name "subsec:Descripción-formato-cita"
+\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 Standard
-Los bloques
+\begin_layout Itemize
+
+\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-CiteFormat
-\end_layout
-
-\end_inset
-
- se usan para describir la forma en que debe mostrarse la información bibliográf
-ica, tanto en \SpecialChar LyX
- (en el diálogo de citas y en las ayudas emergentes, por ejemplo)
- como en la salida XHTML.
- El aspecto de unode estos bloques podría ser este:
-\end_layout
-\begin_layout LyX-Code
-CiteFormat
+\lang english
+%forceabbrvbynames:<nametype>%
\end_layout
-\begin_layout LyX-Code
- article ...
-\end_layout
+\end_inset
-\begin_layout LyX-Code
- book ...
-\end_layout
+: Provides a name list which is always abbreviated (with
+\begin_inset Quotes eld
+\end_inset
-\begin_layout LyX-Code
-End
-\end_layout
+et al.
+\begin_inset Quotes erd
+\end_inset
-\begin_layout Standard
-Las líneas definen cómo se va a mostrar la información bibliográfica asociada
- con un artículo o libro, respectivamente, y tales definiciones se pueden
- dar para cualquier `tipo de entrada' que pudiera estar presente en un archivo
- Bib\SpecialChar TeX
-.
- \SpecialChar LyX
- define un formato por omsión en el código fuente que se usará si no se
- da una definición específica.
- \SpecialChar LyX
- predefine varios formatos en el archivo
+) irrespective of
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-stdciteformats.inc
+
+\lang english
+MaxCiteNames
\end_layout
\end_inset
-, que se incluye en la mayoría de las clases de documento de \SpecialChar LyX
.
\end_layout
-\begin_layout Standard
-Las definiciones usan un lenguaje simple que permite reemplazar las claves
- Bib\SpecialChar TeX
- por sus valores.
- Las claves deben encerrarse entre símbolos
+\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
+<nametype>
\end_layout
\end_inset
-, p.
-\begin_inset space \thinspace{}
-\end_inset
+ 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
-ej.:
+\begin_deeper
+\begin_layout Itemize
+
+\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-%author%
+
+\lang english
+%abbrvciteauthor%
\end_layout
\end_inset
-.
- Así, una simple definición sería:
-\end_layout
-
-\begin_layout LyX-Code
-misc %author%,
+: 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
-Esto imprimiría el autor, una coma, a continuación el título entre comillas
- y un punto para finalizar.
-\end_layout
-
-\begin_layout Standard
-A veces querrás, por supuesto, imprimir una clave solo si existe.
- Esto puede hacerse mediante una construcción condicional tal como:
+) 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
-, que quiere decir: si la clave
+ 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, imprime
+: Provides a full name list (never abbreviated with
\begin_inset Quotes eld
\end_inset
-vol.
-\begin_inset space ~
-\end_inset
-
-
+et al.
\begin_inset Quotes erd
\end_inset
- seguido de la clave.
- También es posible tener una cláusula de otro modo en el condicional, como:
-\begin_inset Newline newline
-\end_inset
+).
+\end_layout
+\begin_layout Itemize
+\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-{%author%[[%author%]][[%editor%, ed.]]}
+
+\lang english
+%forceabbrvciteauthor%
\end_layout
\end_inset
+: Provides a name list which is always abbreviated (with
+\begin_inset Quotes eld
+\end_inset
-\begin_inset Newline newline
+et al.
+\begin_inset Quotes erd
\end_inset
-Aquí, la clave
+) irrespective of
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-author
+
+\lang english
+MaxCiteNames
\end_layout
\end_inset
- se imprime si existe; por otra parte, se imprime la clave
+.
+\end_layout
+
+\end_deeper
+\begin_layout Standard
+
+\lang english
+The order of pre- and surname in the former two lists can be adjusted by
+ these macros:
+\end_layout
+
+\begin_layout Itemize
+
+\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-author
-\end_layout
-\end_inset
+\lang english
+!firstnameform %surname%, %prename%
+\end_layout
- seguida por
-\begin_inset Quotes eld
\end_inset
-,
-\begin_inset space ~
-\end_inset
+ (first author in lists of type 1)
+\end_layout
-ed.
-\begin_inset Quotes erd
-\end_inset
+\begin_layout Itemize
-.
- Advierte que la clave se encierra entre signos
+\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-%
+
+\lang english
+!othernameform %surname%, %prename%
\end_layout
\end_inset
-; el condicional entero se encierra entre llaves; y las cláusulas condicional
- y por otra parte se ponen entre cobles corchetes,
-\begin_inset Quotes eld
-\end_inset
+ (other authors in lists of type 1)
+\end_layout
+\begin_layout Itemize
+\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-[[
-\end_layout
-
-\end_inset
+\lang english
+!firstbynameform %prename% %surname%
+\end_layout
-\begin_inset Quotes eld
\end_inset
- y
-\begin_inset Quotes eld
-\end_inset
+ (first author in lists of type 2)
+\end_layout
+\begin_layout Itemize
+\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-]]
+
+\lang english
+!otherbynameform %prename% %surname%
+\end_layout
+
+\end_inset
+
+ (other authors in lists of type 2)
\end_layout
+\begin_layout Standard
+
+\lang english
+This allows you to configure namings like
+\begin_inset Quotes eld
\end_inset
+Miller, Peter and Mary Smith: \SpecialChar ldots
+, in: John Doe and Pat Green, eds.:\SpecialChar ldots
\begin_inset Quotes erd
\end_inset
.
- No debe haber espacios entre ninguno de ellos.
\end_layout
\begin_layout Standard
\begin_layout Standard
Esto define un trozo de texto traducible, que permite traducir partes relevantes
- de la bibliografía.
+ de la bibliografía
+\lang english
+ or citation
+\lang spanish
+.
Puede incluirse en una definición tratándolo como una clave:
\begin_inset Flex Code
status collapsed
\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 spanish
.
Advertiremos que no son macros en el sentido definido.
No se expandirán.
\end_layout
\begin_layout Standard
-Las plantillas externas se definen en el archivo
+Las plantillas externas se definen en el archivo
+\lang english
+
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-\SpecialChar LyX
-Dir/lib/external_templates
+
+\lang english
+*.xtemplate
\end_layout
\end_inset
-.
- Puedes colocar tus versiones propias en
+ files that are stored in the
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-UserDir/external_templates
+
+\lang english
+LyXDir/lib/xtemplates/
\end_layout
\end_inset
-.
+ directory.
+ Each template is defined in a file of its own.
+
+\lang spanish
+ .
+ Puedes colocar tus
+\lang english
+templates
+\lang spanish
+ propias en
+\lang english
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+UserDir/xtemplates/
+\end_layout
+
+\end_inset
+
+ or copy existing templates to that directory in order to modify them.
+
+\lang spanish
+
\end_layout
\begin_layout Standard
#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
\suppress_date false
\justification true
\use_refstyle 0
+\use_minted 0
\notefontcolor #0000ff
\branch Obsolete
\selected 0
\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
\html_math_output 0
\html_css_as_file 0
\html_be_strict false
+\author 34634807 "Jean-Pierre"
\end_header
\begin_body
\begin_inset Newline newline
\end_inset
-Version 2.2.x
+Version 2.3.x
\end_layout
\begin_layout Standard
, 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
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
\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
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
\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
\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
\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
\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
\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.
\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
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
\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
\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
\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.
\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
\end_inset
Plan
+\lang english
+ for all table of contents, regardless of the AddToToc setting
+\lang french
+
\begin_inset Quotes crd
\end_inset
\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
.
\end_layout
-\begin_layout Description
-
-\end_layout
-
\begin_layout Standard
En rassemblant ceci, la sortie \SpecialChar LaTeX
sera soit:
\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
\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
\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
\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
\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
\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
#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
\suppress_date false
\justification false
\use_refstyle 0
+\use_minted 0
\notefontcolor #0000ff
\branch OutDated
\selected 0
\paragraph_separation indent
\paragraph_indentation default
\is_math_indent 1
+\math_indentation default
+\math_numbering_side default
\quotes_style english
+\dynamic_quotes 0
\papercolumns 1
\papersides 2
\paperpagestyle headings
\begin_inset Newline newline
\end_inset
-第2.2.x版
+第2.3.x版
\end_layout
\begin_layout Standard
という名称の割当ファイルの各国語版がある場合には，そちらが用いられます．
\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
のファイルが納められています．つまり，これらのファイルは，どのメニュー項目がどのメニューに現れるかを定義し，どの項目がツールバーに現れるかを定義しています．
\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
変更を加えない方がよいファイル
\end_layout
\begin_inset Flex Code
status collapsed
-\begin_layout Plain Layout
-external_templates
-\end_layout
-
-\end_inset
-
- このファイルには，新しく導入された
-\begin_inset Flex MenuItem
-status collapsed
-
-\begin_layout Plain Layout
-外用ひな型
-\end_layout
-
-\end_inset
-
-機能で使用できるひな型が載っています．
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "chap:外部素材を取り込む"
-
-\end_inset
-
-を参照のこと．
-\end_layout
-
-\begin_layout Labeling
-\labelwidthstring 00.00.0000
-\begin_inset Flex Code
-status collapsed
-
\begin_layout Plain Layout
languages
\end_layout
手動変換は，インクルードされているファイル内部の変更までは取り扱いませんので，それらのファイルは別に変換されなくてはなりません．
\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
\begin_inset CommandInset label
LatexCommand label
\end_inset
-のことです．
+のこ
\end_layout
\begin_layout Subsection
-書式番号
+
+\lang english
+The CiteEngine file declaration
\end_layout
\begin_layout Standard
-レイアウトファイルやインクルードされたファイル，またはモジュールの最初の非コメント行には，以下のように，かならずファイル形式番号が記されていなくてはなりません．
+
+\lang english
+A cite engine file must begin with a line like the following:
\end_layout
-\begin_layout Description
-\begin_inset Flex Code
-status collapsed
+\begin_layout LyX-Code
-\begin_layout Plain Layout
-Format
+\lang english
+#
+\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
+Document\SpecialChar menuseparator
+Settings\SpecialChar menuseparator
+Bibliography
\end_layout
\end_inset
-] このレイアウトファイルの書式
+.
+ The argument in square brackets is optional: It declares any \SpecialChar LaTeX
+ packages
+ on which the cite engine depends.
\end_layout
\begin_layout Standard
-このタグは\SpecialChar LyX
-\begin_inset space ~
-\end_inset
+\lang english
+The cite engine declaration should then be followed by lines like the following
+\begin_inset Foot
+status collapsed
-1.4.0で導入されました．\SpecialChar LyX
+\begin_layout Plain Layout
+
+\lang english
+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
-\begin_inset space ~
\end_inset
-1.3.x以前のレイアウトファイルには，明示されたファイル形式がないため，書式1と解されます．\SpecialChar LyX
-現行版のファイル形式は，書式60です．しかし，\SpecialChar LyX
-の各版は，旧版の\SpecialChar LyX
-で作成さ
-れたファイルを読むことができるように，旧版のレイアウトファイルも読むことができます．しかしながら，以前の書式に変換する方法はありません．
+:
\end_layout
-\begin_layout Subsection
-\begin_inset CommandInset label
-LatexCommand label
-name "subsec:汎用テキストクラスパラメータ"
-
-\end_inset
+\begin_layout LyX-Code
-汎用テキストクラスパラメータ
+\lang english
+# DescriptionBegin
+\end_layout
+
+\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.
+\lang japanese
+とです．
+\end_layout
+
+\begin_layout Subsection
+書式番号
+\end_layout
+
+\begin_layout Standard
+レイアウトファイルやインクルードされたファイル，またはモジュールの最初の非コメント行には，以下のように，かならずファイル形式番号が記されていなくてはなりません．
+\end_layout
+
+\begin_layout Description
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+Format
+\end_layout
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+整数型
+\end_layout
+
+\end_inset
+
+] このレイアウトファイルの書式
+\end_layout
+
+\begin_layout Standard
+このタグは\SpecialChar LyX
+
+\begin_inset space ~
+\end_inset
+
+1.4.0で導入されました．\SpecialChar LyX
+
+\begin_inset space ~
+\end_inset
+
+1.3.x以前のレイアウトファイルには，明示されたファイル形式がないため，書式1と解されます．\SpecialChar LyX
+現行版のファイル形式は，書式60です．しかし，\SpecialChar LyX
+の各版は，旧版の\SpecialChar LyX
+で作成さ
+れたファイルを読むことができるように，旧版のレイアウトファイルも読むことができます．しかしながら，以前の書式に変換する方法はありません．
+\end_layout
+
+\begin_layout Subsection
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:汎用テキストクラスパラメータ"
+
+\end_inset
+
+汎用テキストクラスパラメータ
\end_layout
\begin_layout Standard
」で閉じる必要があります．
\end_layout
+\begin_layout Description
+
+\lang english
+\begin_inset Flex Code
+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
\begin_inset Flex Code
status collapsed
\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
」．（これは，「2ex」のような「長さ」ではないことに注意してください．）
\end_layout
+\begin_layout Description
+
+\lang english
+\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
+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
\begin_inset Flex Code
status collapsed
\end_layout
\begin_layout Description
+
+\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-OutputFormat
+
+\lang english
+OutlinerName
\end_layout
\end_inset
status collapsed
\begin_layout Plain Layout
-<形式>
+
+\lang english
+<type>
\end_layout
\end_inset
-] このクラスによって生成されるファイル形式を示す文字列（
-\family sans
-設定
-\family default
-ダイアログで定義される形のもの）．おもに，
+] [
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-OutputType
+
+\lang english
+<string>
+\end_layout
+
+\end_inset
+
+] Define a new table of contents with type
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+<type>
+\end_layout
+
+\end_inset
+
+ and name
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+<string>
+\end_layout
+
+\end_inset
+
+.
+ See also the AddToToc commands.
+\end_layout
+
+\begin_layout Description
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+OutputFormat
+\end_layout
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+<形式>
+\end_layout
+
+\end_inset
+
+] このクラスによって生成されるファイル形式を示す文字列（
+\family sans
+設定
+\family default
+ダイアログで定義される形のもの）．おもに，
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+OutputType
\end_layout
\end_inset
ここでは，以下のコマンドを使用することができます．
\end_layout
+\begin_layout Description
+
+\lang english
+\begin_inset Flex Code
+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 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
\begin_inset Flex Code
status collapsed
に設定されると，この引数は，副文(選択した文ないしは段落全体)のコピーを内容にとって挿入されます．
\end_layout
+\begin_layout Itemize
+
+\lang english
+\begin_inset Flex Code
+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
\begin_inset Flex Code
status collapsed
り，引数は，親差込枠や親レイアウトからPassThruCharsを継承しません．
\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
既定では，
\begin_inset Flex Code
も参照）．
\end_layout
+\begin_layout Description
+
+\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 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
\begin_inset Flex Code
status collapsed
\end_layout
\begin_layout Description
+
+\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-RightDelim
+
+\lang english
+ResumeCounter
\end_layout
\end_inset
status collapsed
\begin_layout Plain Layout
-文字列
-\end_layout
-
-\end_inset
-
-] 様式の内容の最後に置かれる文字列．出力中の改行は
-\begin_inset Flex Code
-status collapsed
-\begin_layout Plain Layout
-<br/>
+\emph on
+\lang english
+0
\end_layout
\end_inset
-で指示できます．
-\end_layout
-
-\begin_layout Description
+,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-RightMargin
+
+\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
-LeftMargin
+
+\lang english
+Enumerate
\end_layout
\end_inset
-に同様．
+.
\end_layout
\begin_layout Description
status collapsed
\begin_layout Plain Layout
-Spacing
+RightDelim
\end_layout
\end_inset
status collapsed
\begin_layout Plain Layout
-
-\emph on
-single
+文字列
+\end_layout
+
+\end_inset
+
+] 様式の内容の最後に置かれる文字列．出力中の改行は
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+<br/>
+\end_layout
+
+\end_inset
+
+で指示できます．
+\end_layout
+
+\begin_layout Description
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+RightMargin
+\end_layout
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+文字列=""
+\end_layout
+
+\end_inset
+
+]
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+LeftMargin
+\end_layout
+
+\end_inset
+
+に同様．
+\end_layout
+
+\begin_layout Description
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+Spacing
+\end_layout
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\emph on
+single
\end_layout
\end_inset
] この様式の段落をスペルチェックするか否か．既定値は真です．
\end_layout
+\begin_layout Description
+
+\lang english
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+StepMasterCounter
+\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
+
+] 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
+
+\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
\begin_inset Flex Code
status collapsed
定義には以下の項目を入れることができます．
\end_layout
+\begin_layout Description
+
+\lang english
+\begin_inset Flex Code
+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
\begin_inset Flex Code
status collapsed
\end_inset
-] 現在のレイアウトに関連付けられたコマンドまたは環境の引数番号を定義します．定義は
+] 現在のレイアウトに関連付けられたコマンドまたは環境の引
+\end_layout
+
+\begin_layout Description
+数番号を定義します．定義は
\begin_inset Flex Code
status collapsed
\end_inset
-] 「文書構造」ペイン用に出力される文字列に，この差込枠の内容を含めるかどうか．たとえば，節見出しの脚註の内容が，文書構造の目次に表示されることは望まないでしょ
-うが，通常，文字様式の内容は表示されることを望むでしょう．既定値は偽，すなわち含めません．
+]
+\lang english
+Whether to include the contents of this inset in the strings generated for
+ the `Outline' pane for all table of contents, regardless of the AddToToc
+ setting.
+ One would not, for example, want the content of a footnote in a section
+ header to be included in the TOC displayed in the outline, but one would
+ normally want the content of a character style displayed.
+ Default is false: not to includ
+\lang japanese
+e「文書構造」ペイン用に出力される文字列に，この差込枠の内容を含めるかどうか．たとえば，節見出しの脚註の内容が，文書構造の目次に表示されることは望まないでしょう
+が，通常，文字様式の内容は表示されることを望むでしょう．既定値は偽，すなわち含めません．
+\end_layout
+
+\begin_layout Description
+
+\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 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
\end_inset
-,
+,
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\emph on
+normal
+\end_layout
+
+\end_inset
+
+,
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+large
+\end_layout
+
+\end_inset
+
+,
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+larger
+\end_layout
+
+\end_inset
+
+,
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+largest
+\end_layout
+
+\end_inset
+
+,
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+huge
+\end_layout
+
+\end_inset
+
+,
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+giant
+\end_layout
+
+\end_inset
+
+]
+\end_layout
+
+\begin_layout Subsection
+
+\lang english
+\begin_inset CommandInset label
+LatexCommand label
+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
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:引用書式指定"
+
+\end_inset
+
+引用書式指定
+\end_layout
+
+\begin_layout Standard
+（引用ダイアログやツールチップなどの）\SpecialChar LyX
+内部やXHTML出力において，書誌情報をどのように表示するべきかの叙述には，
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+CiteFormat
+\end_layout
+
+\end_inset
+
+ブロックが使用されています．このブロックは，以下のような形をしています．
+\end_layout
+
+\begin_layout LyX-Code
+CiteFormat
+\end_layout
+
+\begin_layout LyX-Code
+ article ...
+\end_layout
+
+\begin_layout LyX-Code
+ book ...
+\end_layout
+
+\begin_layout LyX-Code
+End
+\end_layout
+
+\begin_layout Standard
+
+\lang english
+or
+\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
+In the first case, the individual lines
+\end_layout
+
+\begin_layout Standard
+上記の各行は，それぞれarticleやbookに関連付けられた書誌情報をどのように表示するべきかを定義するものですが，このような定義は，Bib\SpecialChar TeX
+ファイル中に存在し
+うる「項目型」すべてについて与えることができます．特定の定義が与えられなければ，\SpecialChar LyX
+は，ソースコード中に定義されている既定書式を使用します．\SpecialChar LyX
+は，いくつかの書式を
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+stdciteformats.inc
+\end_layout
+
+\end_inset
+
+ファイルで事前定義しており，これはほとんどの\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
+文書クラスにインクルードされています．
+\end_layout
+
+\begin_layout Standard
+この定義は，Bib\SpecialChar TeX
+キーをその値で置換できる機能を持った，簡単な言語を使用しています．キーは，
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+%author%
+\end_layout
+
+\end_inset
+
+のように
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+%
+\end_layout
+
+\end_inset
+
+記号でくくらなくてはなりません．したがって，簡単な定義は以下のようになります．
+\end_layout
+
+\begin_layout LyX-Code
+misc %author%,
+\begin_inset Quotes eld
+\end_inset
+
+%title%
+\begin_inset Quotes erd
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+これは，「著者名・コンマ・引用に囲まれたタイトル・終止符」を出力します．
+\end_layout
+
+\begin_layout Standard
+もちろん，キーが存在するときのみ，キーを出力したい時があるはずです．このようなときには
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+{%volume%[[vol.
+\begin_inset space ~
+\end_inset
+
+%volume%]]}
+\end_layout
+
+\end_inset
+
+のように，条件付きの構成を使用することができます．これは，
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+volume
+\end_layout
+
+\end_inset
+
+が存在するならば，「vol.
+\begin_inset space ~
+\end_inset
+
+」とvolumeキーを出力するという意味です．また，
+\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
+
+のように，条件の中にelse節を含めることも可能です．ここでは，もし
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+author
+\end_layout
+
+\end_inset
+
+キーが存在するならば出力され，そうでなければeditorキーと「,
+\begin_inset space ~
+\end_inset
+
+ed.」が出力されます．ここでもキーは，
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+%
+\end_layout
+
+\end_inset
+
+記号でくくられていることに注意してください．条件全体は，波括弧で囲まれています．if節およびelse節は，「
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+[[
+\end_layout
+
+\end_inset
+
+」と「
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+]]
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+」の二重角括弧で囲まれてい
+\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
+
+et al.
+\begin_inset Quotes erd
+\end_inset
+
+) when
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-\emph on
-normal
+\lang english
+MaxCiteNames
\end_layout
\end_inset
-,
-\begin_inset Flex Code
-status collapsed
-
-\begin_layout Plain Layout
-large
+ is reached.
\end_layout
-\end_inset
+\begin_layout Itemize
-,
+\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-larger
+
+\lang english
+%fullbynames:<nametype>%
\end_layout
\end_inset
-,
-\begin_inset Flex Code
-status collapsed
+: Provides a full name list (never abbreviated with
+\begin_inset Quotes eld
+\end_inset
-\begin_layout Plain Layout
-largest
+et al.
+\begin_inset Quotes erd
+\end_inset
+
+).
\end_layout
-\end_inset
+\begin_layout Itemize
-,
+\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-huge
+
+\lang english
+%forceabbrvbynames:<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
-giant
-\end_layout
-\end_inset
-
-]
+\lang english
+MaxCiteNames
\end_layout
-\begin_layout Subsection
-\begin_inset CommandInset label
-LatexCommand label
-name "subsec:引用書式指定"
-
\end_inset
-引用書式指定
+.
\end_layout
-\begin_layout Standard
-（引用ダイアログやツールチップなどの）\SpecialChar LyX
-内部やXHTML出力において，書誌情報をどのように表示するべきかの叙述には，
+\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
-CiteFormat
-\end_layout
-\end_inset
-
-ブロックが使用されています．このブロックは，以下のような形をしています．
-\end_layout
-
-\begin_layout LyX-Code
-CiteFormat
+\lang english
+<nametype>
\end_layout
-\begin_layout LyX-Code
- article ...
-\end_layout
+\end_inset
-\begin_layout LyX-Code
- book ...
+ 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
-End
-\end_layout
+\begin_deeper
+\begin_layout Itemize
-\begin_layout Standard
-上記の各行は，それぞれarticleやbookに関連付けられた書誌情報をどのように表示するべきかを定義するものですが，このような定義は，Bib\SpecialChar TeX
-ファイル中に存在し
-うる「項目型」すべてについて与えることができます．特定の定義が与えられなければ，\SpecialChar LyX
-は，ソースコード中に定義されている既定書式を使用します．\SpecialChar LyX
-は，いくつかの書式を
+\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-stdciteformats.inc
+
+\lang english
+%abbrvciteauthor%
\end_layout
\end_inset
-ファイルで事前定義しており，これはほとんどの\SpecialChar LyX
-文書クラスにインクルードされています．
-\end_layout
+: Provides a name list which is abbreviated (with
+\begin_inset Quotes eld
+\end_inset
-\begin_layout Standard
-この定義は，Bib\SpecialChar TeX
-キーをその値で置換できる機能を持った，簡単な言語を使用しています．キーは，
+et al.
+\begin_inset Quotes erd
+\end_inset
+
+) when
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-%author%
+
+\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
+%fullciteauthor%
\end_layout
\end_inset
-記号でくくらなくてはなりません．したがって，簡単な定義は以下のようになります．
-\end_layout
-
-\begin_layout LyX-Code
-misc %author%,
+: Provides a full name list (never abbreviated with
\begin_inset Quotes eld
\end_inset
-%title%
+et al.
\begin_inset Quotes erd
\end_inset
-
+).
\end_layout
-\begin_layout Standard
-これは，「著者名・コンマ・引用に囲まれたタイトル・終止符」を出力します．
-\end_layout
+\begin_layout Itemize
-\begin_layout Standard
-もちろん，キーが存在するときのみ，キーを出力したい時があるはずです．このようなときには
+\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-{%volume%[[vol.
-\begin_inset space ~
-\end_inset
-%volume%]]}
+\lang english
+%forceabbrvciteauthor%
\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
-volume
+
+\lang english
+MaxCiteNames
\end_layout
\end_inset
-が存在するならば，「vol.
-\begin_inset space ~
-\end_inset
+.
+\end_layout
-」とvolumeキーを出力するという意味です．また，
-\begin_inset Newline newline
-\end_inset
+\end_deeper
+\begin_layout Standard
+
+\lang english
+The order of pre- and surname in the former two lists can be adjusted by
+ these macros:
+\end_layout
+\begin_layout Itemize
+\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-{%author%[[%author%]][[%editor%, ed.]]}
+
+\lang english
+!firstnameform %surname%, %prename%
\end_layout
\end_inset
+ (first author in lists of type 1)
+\end_layout
-\begin_inset Newline newline
-\end_inset
+\begin_layout Itemize
-のように，条件の中にelse節を含めることも可能です．ここでは，もし
+\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-author
+
+\lang english
+!othernameform %surname%, %prename%
\end_layout
\end_inset
-キーが存在するならば出力され，そうでなければeditorキーと「,
-\begin_inset space ~
-\end_inset
+ (other authors in lists of type 1)
+\end_layout
-ed.」が出力されます．ここでもキーは，
+\begin_layout Itemize
+
+\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-%
+
+\lang english
+!firstbynameform %prename% %surname%
\end_layout
\end_inset
-記号でくくられていることに注意してください．条件全体は，波括弧で囲まれています．if節およびelse節は，「
+ (first author in lists of type 2)
+\end_layout
+
+\begin_layout Itemize
+
+\lang english
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-[[
+
+\lang english
+!otherbynameform %prename% %surname%
\end_layout
\end_inset
-」と「
-\begin_inset Flex Code
-status collapsed
-
-\begin_layout Plain Layout
-]]
+ (other authors in lists of type 2)
\end_layout
+\begin_layout Standard
+
+\lang english
+This allows you to configure namings like
+\begin_inset Quotes eld
+\end_inset
+
+Miller, Peter and Mary Smith: \SpecialChar ldots
+, in: John Doe and Pat Green, eds.:\SpecialChar ldots
+
+\begin_inset Quotes erd
\end_inset
-」の二重角括弧で囲まれています．これらすべてのあいだには，空白は入ってはなりません．
+.
+\lang japanese
+ます．これらすべてのあいだには，空白は入ってはなりません．
\end_layout
\begin_layout Standard
_pptext pp.
\end_layout
+\begin_layout LyX-Code
+
+\lang english
+This defines a translatable piece of text, which allows relevant parts of
+ the bibliography or citation to be translated.
+
+\end_layout
+
\begin_layout Standard
のようなものです．これは，文字列の翻訳可能な部分を定義するもので，書誌情報中の関連部分が翻訳されるようにすることができます．
\begin_inset Flex Code
\begin_layout Plain Layout
stdciteformats.inc
+\lang english
+ and the diverse
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+*.citeengine
+\end_layout
+
+\end_inset
+
+ files
\end_layout
\end_inset
\end_inset
のセキュリティに関する議論を読んでおいてください．
+\lang english
+The external templates are defined in the
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\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.
+ You can place your own templates in
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\lang english
+UserDir/xtemplates/
+\end_layout
+
+\end_inset
+
+ or copy existing templates to that directory in order to modify them.
\end_layout
\begin_layout Standard
projects / lyx.git / commitdiff