#LyX 2.3 created this file. For more info see http://www.lyx.org/
-\lyxformat 528
+\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_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
+\is_math_indent 1
\quotes_style english
\dynamic_quotes 0
\papercolumns 1
\html_css_as_file 0
\html_be_strict true
\author -712698321 "Jürgen Spitzmüller"
+\author 2047637253 "Guillaume Munch"
\author 2089657418 "Usti"
\end_header
LatexCommand href
target "lyx-docs@lists.lyx.org"
type "mailto:"
+literal "false"
\end_inset
.
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
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
\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
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
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
-KeepEmpty
+
+\change_inserted 2047637253 1483900725
+IsTocCaption
\end_layout
\end_inset
[
-\emph on
-
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
+
+\change_inserted 2047637253 1483900620
+
+\emph on
0
\end_layout
\end_inset
-
-\emph default
,
\begin_inset space \thinspace{}
\end_inset
status collapsed
\begin_layout Plain Layout
+
+\change_inserted 2047637253 1483900620
1
\end_layout
\end_inset
-] As with paragraph styles, see
-\begin_inset CommandInset ref
-LatexCommand ref
-reference "subsec:Paragraph-Styles"
-
-\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
status collapsed
\begin_layout Plain Layout
-LabelFont
+KeepEmpty
\end_layout
\end_inset
- The font used for the label.
- See
-\begin_inset CommandInset ref
-LatexCommand ref
+ [
+\emph on
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+0
+\end_layout
+
+\end_inset
+
+
+\emph default
+,
+\begin_inset space \thinspace{}
+\end_inset
+
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+1
+\end_layout
+
+\end_inset
+
+] As with paragraph styles, see
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "subsec:Paragraph-Styles"
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Description
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+LabelFont
+\end_layout
+
+\end_inset
+
+ The font used for the label.
+ See
+\begin_inset CommandInset ref
+LatexCommand ref
reference "subsec:Font-description"
\end_inset
\begin_layout LyX-Code
-\change_inserted -712698321 1483870927
-LyXName|alias*<!_stardesc!_stardesctooltip>[][]=latexcmd
+\change_inserted -712698321 1484997816
+LyXName|alias$*<!_stardesc!_stardesctooltip>[][]=latexcmd
\end_layout
\begin_layout Itemize
\begin_layout LyX-Code
-\change_inserted -712698321 1483872184
+\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
\begin_layout Itemize
-\change_inserted -712698321 1483868404
+\change_inserted -712698321 1483978485
\begin_inset Flex Code
status collapsed
, else the false part (e.g., in a citation definition:
\begin_inset Flex Code
-status open
+status collapsed
\begin_layout Plain Layout
\end_inset
)
-\change_unchanged
-
\end_layout
-\begin_layout Standard
-There is one other piece of syntax available in definitions, which looks
- like this:
+\begin_layout Itemize
+
+\change_inserted -712698321 1484997600
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-{!<i>!}
+
+\change_inserted -712698321 1483978499
+{%ifmultiple:<authortype>%[[true]][[false]]}
\end_layout
\end_inset
-.
- This defines a piece of formatting information that is to be used when
- creating
+: process the
\begin_inset Quotes eld
\end_inset
-rich text
+true
\begin_inset Quotes erd
\end_inset
-.
- Obviously, we do not want to output HTML tags when writing plain text,
- so they should be wrapped in
-\begin_inset Quotes eld
-\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_inset Quotes erd
-\end_inset
+\begin_layout Plain Layout
- and
-\begin_inset Quotes eld
-\end_inset
+\change_inserted -712698321 1483978571
+{%ifmultiple:editor%[[eds.]][[ed.]]}
+\end_layout
-!}
-\begin_inset Quotes erd
\end_inset
-.
+)
\end_layout
-\begin_layout Standard
-Two special sorts of definitions are also possible in a
+\begin_layout Itemize
+
+\change_inserted -712698321 1484997681
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-CiteFormat
+
+\change_inserted -712698321 1484997608
+{%ifqualified%[[true]][[false]]}
\end_layout
\end_inset
- block.
- An example of the first would be:
-\end_layout
-
-\begin_layout LyX-Code
-!quotetitle
+: process the
\begin_inset Quotes eld
\end_inset
-%title%
+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
-This is an abbreviation, or macro, and it can be used by treating it as
- if it were a key:
+
+\change_inserted -712698321 1483978958
+We said that
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-%!quotetitle%
+
+\change_inserted -712698321 1483978693
+%author%
\end_layout
\end_inset
-.
- \SpecialChar LyX
- will treat
-\begin_inset Flex Code
-status collapsed
-
-\begin_layout Plain Layout
-%!quotetitle%
-\end_layout
+ 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
- exactly as it would treat its definition.
- So, let us issue the obvious
-\emph on
-warning
-\emph default
-.
- Do not do this:
-\end_layout
+ (since
+\begin_inset Quotes eld
+\end_inset
-\begin_layout LyX-Code
-!funfun %funfun%
-\end_layout
+and
+\begin_inset Quotes erd
+\end_inset
-\begin_layout Standard
-or anything like it.
+ is used by Bib\SpecialChar TeX
+ to delimit authors).
\SpecialChar LyX
- shouldn't go into an infinite loop, but it may go into a long one before
- it gives up.
-\end_layout
-
-\begin_layout Standard
-The second sort of special definition might look like this:
+ therefore provides some methods to get properly formatted name lists (which
+ will also get translated).
+ The following keys are provided:
\end_layout
-\begin_layout LyX-Code
-_pptext pp.
-\end_layout
+\begin_layout Enumerate
-\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.
- It can be included in a definition by treating it as a key:
+\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
-%_pptext%
+
+\change_inserted -712698321 1483979800
+<nametype>
+\change_unchanged
+
\end_layout
\end_inset
-.
- Several of these are predefined in
+ part denotes the kind of list that is requested (e.g.
+
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-stdciteformats.inc
+
+\change_inserted -712698321 1483979807
+<nametype:author>
+\change_unchanged
+
\end_layout
\end_inset
+):
+\end_layout
-\change_inserted -712698321 1483868503
- and the diverse
+\begin_deeper
+\begin_layout Itemize
+
+\change_inserted -712698321 1483979186
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-\change_inserted -712698321 1483868503
-*.citeengine
+\change_inserted -712698321 1483979743
+%abbrvnames:<nametype>%
\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.
-\end_layout
+: Provides a name list which is abbreviated (with
+\begin_inset Quotes eld
+\end_inset
-\begin_layout Standard
-So here then is an example that use all these features:
-\begin_inset VSpace defskip
+et al.
+\begin_inset Quotes erd
\end_inset
+) when
+\begin_inset Flex Code
+status collapsed
-\end_layout
+\begin_layout Plain Layout
-\begin_layout Standard
-\noindent
+\change_inserted -712698321 1483979186
+MaxCiteNames
+\change_unchanged
-\family typewriter
-!authoredit {%author%[[%author%, ]][[{%editor%[[%editor%, %_edtext%, ]]}]]}
\end_layout
-\begin_layout Standard
-\begin_inset VSpace defskip
\end_inset
-This defines a macro that prints the author, followed by a comma, if the
-
-\begin_inset Flex Code
-status collapsed
-
-\begin_layout Plain Layout
-author
+ is reached.
\end_layout
-\end_inset
+\begin_layout Itemize
- key is defined, or else prints the name of the editor, followed by the
-
+\change_inserted -712698321 1483979527
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
-_edtext
+
+\change_inserted -712698321 1483979748
+%fullnames:<nametype>%
+\change_unchanged
+
\end_layout
\end_inset
- or its translation (it is by default
+: Provides a full name list (never abbreviated with
\begin_inset Quotes eld
\end_inset
-ed.
+et al.
\begin_inset Quotes erd
\end_inset
-), if the
-\begin_inset Flex Code
-status collapsed
+).
+\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
+
+\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
+
+: Provides a full name list (never abbreviated with
+\begin_inset Quotes eld
+\end_inset
+
+et al.
+\begin_inset Quotes erd
+\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
+
+: 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 1483979574
+MaxCiteNames
+\end_layout
+
+\end_inset
+
+.
+\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
+\begin_inset Flex Code
+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
+
+: 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 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
+
+: Provides a full name list (never abbreviated with
+\begin_inset Quotes eld
+\end_inset
+
+et al.
+\begin_inset Quotes erd
+\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
+
+: 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 1483979726
+MaxCiteNames
+\end_layout
+
+\end_inset
+
+.
+\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
+
+ (first author in lists of type 1)
+\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
+
+ (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
+
+.
+\change_unchanged
+
+\end_layout
+
+\begin_layout Standard
+There is one other piece of syntax available in definitions, which looks
+ like this:
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+{!<i>!}
+\end_layout
+
+\end_inset
+
+.
+ This defines a piece of formatting information that is to be used when
+ creating
+\begin_inset Quotes eld
+\end_inset
+
+rich text
+\begin_inset Quotes erd
+\end_inset
+
+.
+ Obviously, we do not want to output HTML tags when writing plain text,
+ so they should be wrapped in
+\begin_inset Quotes eld
+\end_inset
+
+{!
+\begin_inset Quotes erd
+\end_inset
+
+ and
+\begin_inset Quotes eld
+\end_inset
+
+!}
+\begin_inset Quotes erd
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Standard
+Two special sorts of definitions are also possible in a
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+CiteFormat
+\end_layout
+
+\end_inset
+
+ block.
+ An example of the first would be:
+\end_layout
+
+\begin_layout LyX-Code
+!quotetitle
+\begin_inset Quotes eld
+\end_inset
+
+%title%
+\begin_inset Quotes erd
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+This is an abbreviation, or macro, and it can be used by treating it as
+ if it were a key:
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+%!quotetitle%
+\end_layout
+
+\end_inset
+
+.
+ \SpecialChar LyX
+ will treat
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+%!quotetitle%
+\end_layout
+
+\end_inset
+
+ exactly as it would treat its definition.
+ So, let us issue the obvious
+\emph on
+warning
+\emph default
+.
+ Do not do this:
+\end_layout
+
+\begin_layout LyX-Code
+!funfun %funfun%
+\end_layout
+
+\begin_layout Standard
+or anything like it.
+ \SpecialChar LyX
+ shouldn't go into an infinite loop, but it may go into a long one before
+ it gives up.
+\end_layout
+
+\begin_layout Standard
+The second sort of special definition might look like this:
+\end_layout
+
+\begin_layout LyX-Code
+_pptext pp.
+\end_layout
+
+\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.
+ It can be included in a definition by treating it as a key:
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+%_pptext%
+\end_layout
+
+\end_inset
+
+.
+ Several of these are predefined in
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+stdciteformats.inc
+\end_layout
+
+\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.
+\end_layout
+
+\begin_layout Standard
+So here then is an example that use all these features:
+\begin_inset VSpace defskip
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\noindent
+
+\family typewriter
+!authoredit {%author%[[%author%, ]][[{%editor%[[%editor%, %_edtext%, ]]}]]}
+\end_layout
+
+\begin_layout Standard
+\begin_inset VSpace defskip
+\end_inset
+
+This defines a macro that prints the author, followed by a comma, if the
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+author
+\end_layout
+
+\end_inset
+
+ key is defined, or else prints the name of the editor, followed by the
+
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+_edtext
+\end_layout
+
+\end_inset
+
+ or its translation (it is by default
+\begin_inset Quotes eld
+\end_inset
+
+ed.
+\begin_inset Quotes erd
+\end_inset
+
+), if the
+\begin_inset Flex Code
+status collapsed
\begin_layout Plain Layout
editor
\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