-#LyX 2.2 created this file. For more info see http://www.lyx.org/
-\lyxformat 508
+#LyX 2.3 created this file. For more info see http://www.lyx.org/
+\lyxformat 541
\begin_document
\begin_header
\save_transient_properties true
}
}{}
\end_preamble
-\options fleqn,bibliography=totoc,index=totoc,BCOR7.5mm,titlepage,captions=tableheading
+\options bibliography=totoc,index=totoc,BCOR7.5mm,titlepage,captions=tableheading
\use_default_options false
\begin_modules
logicalmkup
\font_osf false
\font_sf_scale 100 100
\font_tt_scale 100 100
+\use_microtype false
+\use_dash_ligatures true
\graphics default
\default_output_format pdf2
\output_sync 0
\tocdepth 3
\paragraph_separation indent
\paragraph_indentation default
-\quotes_language english
+\is_math_indent 1
+\quotes_style english
+\dynamic_quotes 0
\papercolumns 1
\papersides 2
\paperpagestyle headings
-\tracking_changes false
+\tracking_changes true
\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
LatexCommand href
target "lyx-docs@lists.lyx.org"
type "mailto:"
+literal "false"
\end_inset
\begin_layout Standard
\begin_inset Branch OutDated
+inverted 0
status collapsed
\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
+
+\end_inset
+
+ contains files with the extension
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1483869840
+.citeengine
+\change_unchanged
+
+\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.
+\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
+
+\end_inset
+
+ contains files with the extension
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1490533759
+.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
+
+.
+\change_unchanged
+
\end_layout
\begin_layout Subsection
\begin_layout Labeling
\labelwidthstring 00.00.0000
+
+\change_deleted -712698321 1490533856
\begin_inset Flex Code
status collapsed
\end_inset
.
+\change_unchanged
+
\end_layout
\begin_layout Labeling
LatexCommand href
name "IANA"
target "http://www.iana.org/assignments/media-types/"
+literal "false"
\end_inset
LatexCommand href
name "freedesktop.org"
target "http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec"
+literal "false"
\end_inset
LatexCommand href
name "information on the web"
target "http://www.lyx.org/HowToUseGIT"
+literal "false"
\end_inset
LatexCommand href
name "http://www.lyx.org/Translation"
target "http://www.lyx.org/Translation"
+literal "false"
\end_inset
LatexCommand href
name "http://www.lyx.org/trac/timeline"
target "http://www.lyx.org/trac/timeline"
+literal "false"
\end_inset
\begin_layout Standard
\begin_inset Branch OutDated
+inverted 0
status collapsed
\begin_layout Section
LatexCommand href
name "CTAN"
target "http://www.ctan.org/"
+literal "false"
\end_inset
LatexCommand href
name "layout section on the LyX wiki"
target "http://wiki.lyx.org/Layouts/Layouts"
+literal "false"
\end_inset
\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_inset
+
+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
+
+\end_inset
+
+ files that are located in the
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1483873546
+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
+
+\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
+ (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
+
+\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
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1483874688
+MaxCiteNames
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+,
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1483875180
+CiteFramework
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+,
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1483874477
+CiteEngine
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+ and
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1483874482
+CiteFormat
+\change_unchanged
+
+\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.
+\change_unchanged
+
\end_layout
\begin_layout Section
\end_inset
.
+\change_inserted -712698321 1483873000
+
\end_layout
\begin_layout Subsection
-Format number
+
+\change_inserted -712698321 1483873010
+The CiteEngine file declaration
\end_layout
\begin_layout Standard
-The first non-comment line of any layout file, included file, or module
-
-\emph on
-must
-\emph default
- contain the file format number:
+
+\change_inserted -712698321 1483873022
+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
+\change_inserted -712698321 1483873047
+#
+\backslash
+DeclareLyXCiteEngineModule[biblatex.sty]{Biblatex}
\end_layout
-\end_inset
+\begin_layout Standard
- [
-\begin_inset Flex Code
+\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
-int
+
+\change_inserted -712698321 1483873068
+Document\SpecialChar menuseparator
+Settings\SpecialChar menuseparator
+Bibliography
\end_layout
\end_inset
-] The format number of the layout file.
+.
+ The argument in square brackets is optional: It declares any \SpecialChar LaTeX
+ packages
+ on which the cite engine depends.
\end_layout
\begin_layout Standard
-This tag was introduced with \SpecialChar LyX
-\begin_inset space ~
-\end_inset
-
-1.4.0.
- Layout files from older \SpecialChar LyX
- versions do not have an explicit file format and
- are considered to have
-\begin_inset Flex Code
+\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
-Format
-\begin_inset space ~
-\end_inset
-1
+\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
+ will be thus translated with the next interface update.
\end_layout
\end_inset
-.
- The format for the present version of \SpecialChar LyX
- is format 60.
- But each version of \SpecialChar LyX
- is capable of reading earlier versions' layout files,
- just as they are capable of reading files produced by earlier versions
- of \SpecialChar LyX
-.
- There is, however, no provision for converting to earlier formats.
+:
\end_layout
-\begin_layout Subsection
-\begin_inset CommandInset label
-LatexCommand label
-name "subsec:General-text-class"
-
-\end_inset
+\begin_layout LyX-Code
-General text class parameters
+\change_inserted -712698321 1483873128
+# DescriptionBegin
\end_layout
-\begin_layout Standard
+\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_layout
+
+\end_inset
+
+ to provide the user with information about the cite engine.
+\change_unchanged
+
+\end_layout
+
+\begin_layout Subsection
+Format number
+\end_layout
+
+\begin_layout Standard
+The first non-comment line of any layout file, included file, or module
+
+\emph on
+must
+\emph default
+ contain the file format number:
+\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
+
+] The format number of the layout file.
+\end_layout
+
+\begin_layout Standard
+This tag was introduced with \SpecialChar LyX
+
+\begin_inset space ~
+\end_inset
+
+1.4.0.
+ Layout files from older \SpecialChar LyX
+ versions do not have an explicit file format and
+ are considered to have
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+Format
+\begin_inset space ~
+\end_inset
+
+1
+\end_layout
+
+\end_inset
+
+.
+ The format for the present version of \SpecialChar LyX
+ is format 60.
+ But each version of \SpecialChar LyX
+ is capable of reading earlier versions' layout files,
+ just as they are capable of reading files produced by earlier versions
+ of \SpecialChar LyX
+.
+ There is, however, no provision for converting to earlier formats.
+\end_layout
+
+\begin_layout Subsection
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:General-text-class"
+
+\end_inset
+
+General text class parameters
+\end_layout
+
+\begin_layout Standard
These are general parameters that govern the behavior of an entire document
class.
(This does
\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
+
+\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
+
+\change_inserted -712698321 1483872548
+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
+
+).
+\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
+reference "subsec:Cite-Engine-Files"
+plural "false"
+caps "false"
+noprefix "false"
+
+\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
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1483872852
+
+\emph on
+bibtex
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+,
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1483872857
+biblatex
+\change_unchanged
+
+\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
+
+).
+\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
-ModifyStyle
+
+\change_inserted -712698321 1483872687
+MaxCiteNames
\end_layout
\end_inset
status collapsed
\begin_layout Plain Layout
-<style>
+
+\change_inserted -712698321 1483872692
+integer
\end_layout
\end_inset
-] Modifies the properties of the given paragraph style.
- If the style does not exist, this section is ignored.
- Must end with
+] 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 erd
\end_inset
-.
+).
+\change_unchanged
+
\end_layout
\begin_layout Description
status collapsed
\begin_layout Plain Layout
-NoCounter
+ModifyStyle
\end_layout
\end_inset
status collapsed
\begin_layout Plain Layout
-<counter>
+<style>
\end_layout
\end_inset
-] Deletes an existing counter, usually one defined in an included file.
-\end_layout
+] Modifies the properties of the given paragraph style.
+ If the style does not exist, this section is ignored.
+ Must end with
+\begin_inset Quotes eld
+\end_inset
+
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+End
+\end_layout
+
+\end_inset
+
+
+\begin_inset Quotes erd
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Description
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+NoCounter
+\end_layout
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+<counter>
+\end_layout
+
+\end_inset
+
+] Deletes an existing counter, usually one defined in an included file.
+\end_layout
\begin_layout Description
\begin_inset Flex Code
\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
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 2047637253 1483900369
+<type>
+\end_layout
+
+\end_inset
+
+] [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 2047637253 1483900418
+<string>
+\end_layout
+
+\end_inset
+
+] Define a new table of contents with type
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 2047637253 1483900414
+<type>
+\end_layout
+
+\end_inset
+
+ and name
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 2047637253 1483900419
+<string>
+\end_layout
+
+\end_inset
+
+.
+ See also the AddToToc commands.
+\change_unchanged
+
\end_layout
\begin_layout Description
where the following commands are allowed:
\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
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 2047637253 1483963007
+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
, 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
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1477038311
+
+\emph on
+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
+
+\change_inserted -712698321 1477038356
+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.
+\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
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 2047637253 1483900841
+
+\emph on
+0
+\end_layout
+
+\end_inset
+
+,
+\begin_inset space \thinspace{}
+\end_inset
+
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 2047637253 1483900841
+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.
+\change_unchanged
+
\end_layout
\begin_layout Standard
global entries).
\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
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 2047637253 1483902211
+
+\emph on
+0
+\end_layout
+
+\end_inset
+
+,
+\begin_inset space \thinspace{}
+\end_inset
+
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 2047637253 1483902211
+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_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
definition can contain the following entries:
\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
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 2047637253 1483962897
+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
] Whether to include the contents of this inset in the strings generated
- for the `Outline' pane.
+ for the `Outline' pane
+\change_inserted 2047637253 1483900773
+ for all table of contents, regardless of the AddToToc setting
+\change_unchanged
+.
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
+
+\end_inset
+
+ [
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 2047637253 1483900620
+
+\emph on
+0
+\end_layout
+
+\end_inset
+
+,
+\begin_inset space \thinspace{}
+\end_inset
+
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 2047637253 1483900620
+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.
+\change_unchanged
+
\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
+
+\change_inserted -712698321 1483869872
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:Citation-engine-description"
+
+\end_inset
+
+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
+
+ 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
+
+\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
+
+: 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
+
+\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
+
+: 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
+
+\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
+
+: 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
+
+\change_inserted -712698321 1483870566
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1483870552
+CiteEngine
+\end_layout
+
+\end_inset
+
+ blocks look like this:
+\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
+
+\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.
+
+\change_deleted -712698321 1483871114
+
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted -712698321 1483871119
+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
+
+: The name as used in the
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1483871216
+*.lyx
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+ file.
+\end_layout
+
+\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
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1483871402
+latexcmd
+\end_layout
+
+\end_inset
+
+ sometimes, if the \SpecialChar LaTeX
+ command names differ).
+\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
+
+: a (comma-separated) list of commands that fall back to the given
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1483871257
+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
+
+\change_inserted -712698321 1483871559
+alias
+\end_layout
+
+\end_inset
+
+ can be compared to
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1483871278
+ObsoletedBy
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+ in layout definitions.
+\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
+
+: The actual \SpecialChar LaTeX
+ command that is output.
+
+\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
+
+ and
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1483871321
+latexcmd
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+ are optional.
+ If no
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1483871333
+latexcmd
+\end_layout
+
+\end_inset
+
+ is given, the
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1483871340
+LyXName
+\end_layout
+
+\end_inset
+
+ will be output to \SpecialChar LaTeX
+.
+\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
+
+ vs.
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1483871626
+
+\backslash
+latexcmd
+\change_unchanged
+
+\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
+
+\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
+
+ indicate the number of optional arguments (there can be 0–2).
+\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
+
+ indicates there is a starred version of the command (
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1483871718
+
+\backslash
+latexcmd*
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+ vs.
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1483871724
+
+\backslash
+latexcmd
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+).
+
+\end_layout
+
+\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
+\end_inset
+
+et al.
+\begin_inset Quotes erd
+\end_inset
+
+ due to the
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1483871835
+MaxCiteNames
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+ threshold.
+\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
+
+.
+ Maximal two translatable macro keywords, marked by the prefix
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1483872014
+!_
+\change_unchanged
+
+\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
+
+\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
+
+ (see next section), dropping the
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1483872023
+!
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+ from the prefix, like this:
+\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
+
+ 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
+
+Citation format description
+\end_layout
+
+\begin_layout Standard
+The
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+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
+\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
+
+\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
+ 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
+stdciteformats.inc
+\end_layout
+
+\end_inset
+
+, 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
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1483867674
+
+\backslash
+cite
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+,
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1483867679
+
+\backslash
+citet
+\change_unchanged
+
+\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
+
+\change_inserted -712698321 1483875503
+*.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
+
+).
+\change_unchanged
+
+\end_layout
+
+\begin_layout Standard
+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
+%
+\end_layout
+
+\end_inset
+
+ signs, e.g.:
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+%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
+This would print the author, followed by a comma, followed by the title,
+ in quotes, followed by a period.
+\end_layout
+
+\begin_layout Standard
+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
+{%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
+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
+{%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
+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
+%
+\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
+[[
+\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
+]]
+\end_layout
+
+\end_inset
+
+
+\begin_inset Quotes erd
+\end_inset
+
+.
+ 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
+
+: 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
+
+\change_inserted -712698321 1483868068
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1483868052
+{%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
+
+\change_inserted -712698321 1483868138
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1483868076
+{%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
+
+\change_inserted -712698321 1483868174
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1483868144
+{%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
+
+\change_inserted -712698321 1483868321
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1483868259
+{%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
+
+\change_inserted -712698321 1483868310
+
+\backslash
+cite*
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+), the false part for unstarred
+\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
+
+\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
+
+\change_inserted -712698321 1483868364
+<type>
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+, else the false part (e.g., in a citation definition:
+\begin_inset Flex Code
+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
+
+\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
+
+\change_inserted -712698321 1483978571
+{%ifmultiple:editor%[[eds.]][[ed.]]}
+\end_layout
+
+\end_inset
+
+)
+\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
+
+\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.
+\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_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
+
+\change_inserted -712698321 1483979807
+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
+
+\change_inserted -712698321 1483979800
+<nametype>
+\change_unchanged
+
+\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
+
+\change_inserted -712698321 1483979807
+<nametype:author>
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+):
+\end_layout
+
+\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
+
+: 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
+
+\change_inserted -712698321 1483979186
+MaxCiteNames
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+ is reached.
+\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
+
+: 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
+
+\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
+
+: 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
+
+\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
+
+Miller, John: Some text, in: Mary Smith, ed.: A volume
+\begin_inset Quotes erd
+\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
+
+: 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
+\change_inserted -712698321 1483979565
+MaxCiteNames
\end_layout
\end_inset
-,
-\begin_inset Flex Code
-status collapsed
+ is reached.
+\change_unchanged
-\begin_layout Plain Layout
-large
\end_layout
-\end_inset
+\begin_layout Itemize
-,
+\change_inserted -712698321 1483979570
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-larger
+
+\change_inserted -712698321 1483979753
+%fullbynames:<nametype>%
+\change_unchanged
+
\end_layout
\end_inset
-,
-\begin_inset Flex Code
-status collapsed
+: Provides a full name list (never abbreviated with
+\begin_inset Quotes eld
+\end_inset
+
+et al.
+\begin_inset Quotes erd
+\end_inset
+
+).
+\change_unchanged
-\begin_layout Plain Layout
-largest
\end_layout
-\end_inset
+\begin_layout Itemize
-,
+\change_inserted -712698321 1483979576
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-huge
+
+\change_inserted -712698321 1483980143
+%forceabbrvbynames:<nametype>%
+\change_unchanged
+
\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
-]
+\change_inserted -712698321 1483979574
+MaxCiteNames
\end_layout
-\begin_layout Subsection
-\begin_inset CommandInset label
-LatexCommand label
-name "subsec:Citation-format-description"
-
\end_inset
-Citation format description
+.
\end_layout
-\begin_layout Standard
-The
+\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
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-CiteFormat
-\end_layout
-\end_inset
+\change_inserted -712698321 1483979871
+<nametype>
+\change_unchanged
- 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
+\end_inset
-\begin_layout LyX-Code
- article ...
-\end_layout
+ 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
-\begin_layout LyX-Code
- book ...
\end_layout
-\begin_layout LyX-Code
-End
-\end_layout
+\begin_deeper
+\begin_layout Itemize
-\begin_layout Standard
-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
+\change_inserted -712698321 1483979715
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-stdciteformats.inc
+
+\change_inserted -712698321 1483979700
+%abbrvciteauthor%
+\change_unchanged
+
\end_layout
\end_inset
-, which is included in most of \SpecialChar LyX
-'s document classes.
-\end_layout
+: Provides a name list which is abbreviated (with
+\begin_inset Quotes eld
+\end_inset
-\begin_layout Standard
-The definitions use a simple language that allows Bib\SpecialChar TeX
- keys to be replaced
- with their values.
- Keys should be enclosed in
+et al.
+\begin_inset Quotes erd
+\end_inset
+
+) when
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-%
+
+\change_inserted -712698321 1483979715
+MaxCiteNames
\end_layout
\end_inset
- signs, e.g.:
+ is reached.
+\change_unchanged
+
+\end_layout
+
+\begin_layout Itemize
+
+\change_inserted -712698321 1483979721
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-%author%
-\end_layout
-\end_inset
+\change_inserted -712698321 1483979703
+%fullciteauthor%
+\change_unchanged
-.
- So a simple definition might look like this:
\end_layout
-\begin_layout LyX-Code
-misc %author%,
+\end_inset
+
+: 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
+).
+\change_unchanged
-\begin_layout Standard
-This would print the author, followed by a comma, followed by the title,
- in quotes, followed by a period.
\end_layout
-\begin_layout Standard
-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_layout Itemize
+
+\change_inserted -712698321 1483980272
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-{%volume%[[vol.
-\begin_inset space ~
-\end_inset
-%volume%]]}
-\end_layout
-
-\end_inset
-
-.
- This says: If the
-\begin_inset Flex Code
-status collapsed
+\change_inserted -712698321 1483979705
+%forceabbrvciteauthor%
+\change_unchanged
-\begin_layout Plain Layout
-volume
\end_layout
\end_inset
- key exists, then print
+: Provides a name list which is always 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
-
-
+) irrespective of
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-{%author%[[%author%]][[%editor%, ed.]]}
+
+\change_inserted -712698321 1483979726
+MaxCiteNames
\end_layout
\end_inset
.
-\begin_inset Newline newline
-\end_inset
+\end_layout
-Here, the
+\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
-author
-\end_layout
-\end_inset
+\change_inserted -712698321 1483980354
+!firstnameform %surname%, %prename%
+\change_unchanged
- 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
-ed.
-\begin_inset Quotes erd
-\end_inset
+ (first author in lists of type 1)
+\end_layout
- Note that the key is again enclosed in
+\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
- 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
+ (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
-[[
-\end_layout
-\end_inset
+\change_inserted -712698321 1483980373
+!firstbynameform %prename% %surname%
+\change_unchanged
+\end_layout
-\begin_inset Quotes eld
\end_inset
- and
-\begin_inset Quotes eld
-\end_inset
+ (first author in lists of type 2)
+\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
+
+ (other authors in lists of type 2)
\end_layout
+\begin_layout Standard
+
+\change_inserted -712698321 1483980643
+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.
+\change_unchanged
+
\end_layout
\begin_layout Standard
\begin_layout Standard
This defines a translatable piece of text, which allows relevant parts of
- the bibliography to be translated.
+ the bibliography
+\change_inserted -712698321 1483868477
+or citation
+\change_unchanged
+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
.
Note that these are not macros, in the sense just defined.
They will not be expanded.
\begin_layout Section
The external template configuration file
+\change_inserted -712698321 1490533960
+s
+\change_unchanged
+
\end_layout
\begin_layout Standard
\end_layout
\begin_layout Standard
-The external templates are defined in the
+The external templates are defined in the
+\change_inserted -712698321 1490534022
+
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-LyXDir/lib/external_templates
+
+\change_inserted -712698321 1490533996
+*.xtemplate
\end_layout
\end_inset
- file.
- You can place your own version in
+ files that are stored in the
+\change_unchanged
+
+\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
+
+\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
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-UserDir/external_templates
+UserDir/
+\change_deleted -712698321 1490534069
+external_
+\change_inserted -712698321 1490534069
+x
+\change_unchanged
+templates
+\change_inserted -712698321 1490534080
+/
+\change_unchanged
+
\end_layout
\end_inset
+
+\change_inserted -712698321 1490534112
+ or copy existing templates to that directory in order to modify them
+\change_unchanged
.
\end_layout
projects / lyx.git / blobdiff