X-Git-Url: https://git.lyx.org/gitweb/?a=blobdiff_plain;f=lib%2Fdoc%2FCustomization.lyx;h=079b7f74d3aa688a2367cec8e27a85743731b0a1;hb=cde4537a42d0281600aabdd141d5ba91b6e4ef75;hp=f1df44169a5ebed343c8f6a43a93ef2b44c27d63;hpb=68212499945aead616b76e2d7de9d4df1263f372;p=features.git diff --git a/lib/doc/Customization.lyx b/lib/doc/Customization.lyx index f1df44169a..079b7f74d3 100644 --- a/lib/doc/Customization.lyx +++ b/lib/doc/Customization.lyx @@ -1,5 +1,5 @@ #LyX 2.4 created this file. For more info see https://www.lyx.org/ -\lyxformat 601 +\lyxformat 608 \begin_document \begin_header \save_transient_properties true @@ -109,7 +109,7 @@ logicalmkup \branch OutDated \selected 0 \filename_suffix 0 -\color #f5fae7 +\color #f5fae7 #0a0518 \end_branch \index Index \shortcut idx @@ -136,11 +136,13 @@ logicalmkup \html_css_as_file 0 \html_be_strict true \docbook_table_output 0 +\docbook_mathml_prefix 1 \author -970929547 "Thibaut Cuvelier" \author -712698321 "Jürgen Spitzmüller" \author -584632292 "Richard Kimberly Heck" \author -495245474 "Jean-Marc Lasgouttes" \author 5863208 "ab" +\author 34634807 "Jean-Pierre" \author 232239728 "Owner" \author 731793113 "Richard Kimberly Heck" rikiheck@lyx.org \author 1075283030 "Thibaut" @@ -10375,6 +10377,131 @@ stdclass.inc \end_inset , which contains most of the basic layouts. +\change_inserted -712698321 1611646803 + +\end_layout + +\begin_layout Description + +\change_inserted -712698321 1611646804 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -712698321 1611646837 +InputGlobal +\change_unchanged + +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -712698321 1611646804 + +\change_unchanged + +\end_layout + +\end_inset + +] is a variant of the +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -712698321 1611646804 +Input +\change_unchanged + +\end_layout + +\end_inset + + command which does not look for files in the user directory. + This allows to create a file +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -712698321 1611646804 +name.layout +\change_unchanged + +\end_layout + +\end_inset + + or +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -712698321 1611646804 +name.inc +\change_unchanged + +\end_layout + +\end_inset + + in the user directory which includes a global file with the same name via + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -712698321 1611646853 +InputGlobal name +\change_unchanged + +\end_layout + +\end_inset + + or +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -712698321 1611646855 +InputGlobal name.inc +\change_unchanged + +\end_layout + +\end_inset + +, respectively (with +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -712698321 1611646804 +Input +\change_unchanged + +\end_layout + +\end_inset + +, the file would recursively include itself). + This way, you can modify global files without having to completely copy + them. +\change_unchanged + \end_layout \begin_layout Description @@ -10527,6 +10654,63 @@ noprefix "false" ). \end_layout +\begin_layout Description + +\change_inserted -712698321 1612018485 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -712698321 1612018457 +ModifyInsetLayout +\change_unchanged + +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -712698321 1612018466 + +\change_unchanged + +\end_layout + +\end_inset + +] Modifies the layout of an inset. + If the layout 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 + +\change_inserted -712698321 1612018452 +End +\change_unchanged + +\end_layout + +\end_inset + + +\begin_inset Quotes erd +\end_inset + +. +\end_layout + \begin_layout Description \begin_inset Flex Code status collapsed @@ -11103,6 +11287,67 @@ EndPreamble \end_inset . +\change_inserted -712698321 1612018500 + +\end_layout + +\begin_layout Description + +\change_inserted -712698321 1612018547 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -712698321 1612018506 +ProvideInsetLayout +\change_unchanged + +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -712698321 1612018509 + +\change_unchanged + +\end_layout + +\end_inset + +] Defines the layout of an inset if it does not already exist. + If the layout does exist, this section is ignored. + Must end with +\begin_inset Quotes eld +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -712698321 1612018500 +End +\change_unchanged + +\end_layout + +\end_inset + + +\begin_inset Quotes erd +\end_inset + +. +\change_unchanged + \end_layout \begin_layout Description @@ -11698,7 +11943,13 @@ Simple_Grid \end_inset -, but with the header column offset with a second horizontal line. +, but with the header +\change_deleted 34634807 1619712593 +column +\change_inserted 34634807 1619712594 +row +\change_inserted -712698321 1553618309 + offset with a second horizontal line. This is also the default style of \SpecialChar LyX . \end_layout @@ -12501,7 +12752,41 @@ int ] Defines argument number of a command\SpecialChar breakableslash environment associated with the current style. - This is useful for things like section headings, and only makes sense with + +\change_inserted -584632292 1615846868 + The definition must end with +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846867 +EndArgument +\change_unchanged + +\end_layout + +\end_inset + +. + +\change_unchanged + +\change_inserted -584632292 1615846880 +See +\begin_inset CommandInset ref +LatexCommand ref +reference "subsec:Arguments" +plural "false" +caps "false" +noprefix "false" + +\end_inset + + for more information. + +\change_deleted -584632292 1615846694 +This is useful for things like section headings, and only makes sense with \SpecialChar LaTeX . Every (optional or required) argument of a command or environment – except @@ -12525,41 +12810,55 @@ EndArgument \begin_deeper \begin_layout Quote +\change_deleted -584632292 1615846694 + \family typewriter Argument 1 \end_layout \begin_layout Quote +\change_deleted -584632292 1615846694 + \family typewriter ... \end_layout \begin_layout Quote +\change_deleted -584632292 1615846694 + \family typewriter EndArgument \end_layout \begin_layout Quote +\change_deleted -584632292 1615846694 + \family typewriter Argument 2 \end_layout \begin_layout Quote +\change_deleted -584632292 1615846694 + \family typewriter ... \end_layout \begin_layout Quote +\change_deleted -584632292 1615846694 + \family typewriter EndArgument \end_layout \begin_layout Standard + +\change_deleted -584632292 1615846694 Inside the \begin_inset Flex Code status collapsed @@ -12574,6 +12873,8 @@ Argument \end_layout \begin_layout Itemize + +\change_deleted -584632292 1615846694 \begin_inset Flex Code status collapsed @@ -12644,6 +12945,8 @@ Short Title|S \end_layout \begin_layout Itemize + +\change_deleted -584632292 1615846694 \begin_inset Flex Code status collapsed @@ -12715,6 +13018,8 @@ LabelString \end_layout \begin_layout Itemize + +\change_deleted -584632292 1615846694 \begin_inset Flex Code status collapsed @@ -12739,6 +13044,8 @@ status collapsed \end_layout \begin_layout Itemize + +\change_deleted -584632292 1615846694 \begin_inset Flex Code status collapsed @@ -12798,13 +13105,11 @@ status collapsed \end_inset -\change_inserted -712698321 1555579782 - \end_layout \begin_layout Itemize -\change_inserted -712698321 1555579780 +\change_deleted -584632292 1615846694 \begin_inset Flex Code status collapsed @@ -12852,11 +13157,11 @@ status collapsed ) to be used for line breaks. The initial backslash must not be specified. -\change_unchanged - \end_layout \begin_layout Itemize + +\change_deleted -584632292 1615846694 \begin_inset Flex Code status collapsed @@ -12921,6 +13226,8 @@ Argument 2 \end_layout \begin_layout Itemize + +\change_deleted -584632292 1615846694 \begin_inset Flex Code status collapsed @@ -12975,6 +13282,8 @@ status collapsed \end_layout \begin_layout Itemize + +\change_deleted -584632292 1615846694 \begin_inset Flex Code status collapsed @@ -13029,6 +13338,8 @@ status collapsed \end_layout \begin_layout Itemize + +\change_deleted -584632292 1615846694 \begin_inset Flex Code status collapsed @@ -13063,6 +13374,8 @@ if no argument inset has been inserted (note that also an empty argument \end_layout \begin_layout Itemize + +\change_deleted -584632292 1615846694 \begin_inset Flex Code status collapsed @@ -13088,6 +13401,8 @@ status collapsed \end_layout \begin_layout Itemize + +\change_deleted -584632292 1615846694 \begin_inset Flex Code status collapsed @@ -13105,13 +13420,11 @@ reference "subsec:Font-description" \end_inset . -\change_inserted -712698321 1559484228 - \end_layout \begin_layout Itemize -\change_inserted -712698321 1559484228 +\change_deleted -584632292 1615846694 \begin_inset Flex Code status collapsed @@ -13167,11 +13480,11 @@ reference "subsec:Paragraph-Styles" \end_inset . -\change_unchanged - \end_layout \begin_layout Itemize + +\change_deleted -584632292 1615846694 \begin_inset Flex Code status collapsed @@ -13192,6 +13505,8 @@ reference "subsec:Font-description" \end_layout \begin_layout Itemize + +\change_deleted -584632292 1615846694 \begin_inset Flex Code status collapsed @@ -13219,6 +13534,8 @@ Classic \end_layout \begin_layout Itemize + +\change_deleted -584632292 1615846694 \begin_inset Flex Code status collapsed @@ -13253,13 +13570,13 @@ status collapsed \change_deleted -712698321 1559484200 Currently, only one argument per style\SpecialChar breakableslash layout can be automatically inserted. -\change_unchanged +\change_deleted -584632292 1615846694 \end_layout \begin_layout Itemize -\change_inserted -712698321 1559491402 +\change_deleted -584632292 1615846694 \begin_inset Flex Code status collapsed @@ -13319,6 +13636,8 @@ AutoInsert \end_layout \begin_layout Itemize + +\change_deleted -584632292 1615846694 \begin_inset Flex Code status collapsed @@ -13353,6 +13672,8 @@ status collapsed \end_layout \begin_layout Itemize + +\change_deleted -584632292 1615846694 \begin_inset Flex Code status collapsed @@ -13394,6 +13715,8 @@ PassThru \end_layout \begin_layout Itemize + +\change_deleted -584632292 1615846694 \begin_inset Flex Code status collapsed @@ -13431,6 +13754,8 @@ that should be output in raw form, meaning without special translations \end_layout \begin_layout Itemize + +\change_deleted -584632292 1615846694 \begin_inset Flex Code status collapsed @@ -13472,6 +13797,8 @@ status collapsed \end_layout \begin_layout Standard + +\change_deleted -584632292 1615846694 By default, the text entered in the \SpecialChar LyX workarea in the respective layout is the last (mandatory) argument of a command if the @@ -13542,6 +13869,8 @@ Command \end_layout \begin_layout Standard + +\change_deleted -584632292 1615846694 Arguments for list \begin_inset Flex Code status collapsed @@ -13595,13 +13924,11 @@ Argument item:1 \end_inset ). -\change_inserted -712698321 1534487781 - \end_layout \begin_layout Standard -\change_inserted -712698321 1534488561 +\change_deleted -584632292 1615846694 Finally, there is a special argument type with the prefix \begin_inset Flex Code status collapsed @@ -14270,7 +14597,11 @@ FreeSpacing Note that \change_unchanged \SpecialChar LyX - will create protected blanks for the additional blanks when in + will create protected blanks for the additional blanks when +\change_deleted 34634807 1619626461 + in +\change_unchanged + \change_inserted -495245474 1550490096 \begin_inset Flex Code @@ -19856,13 +20187,35 @@ EndArgument . See +\change_inserted -584632292 1615846847 + +\begin_inset CommandInset ref +LatexCommand ref +reference "subsec:Arguments" +plural "false" +caps "false" +noprefix "false" + +\end_inset + + +\change_deleted -584632292 1615846847 + \begin_inset CommandInset ref LatexCommand ref reference "subsec:Paragraph-Styles" \end_inset - for details. + +\change_unchanged + for +\change_deleted -584632292 1615846902 +details +\change_inserted -584632292 1615846906 +more information +\change_unchanged +. \end_layout \begin_layout Description @@ -21223,6 +21576,8 @@ custom \end_inset , +\change_deleted -584632292 1615846609 + \begin_inset Flex Code status collapsed @@ -21232,7 +21587,9 @@ element \end_inset - or + +\change_unchanged +or \begin_inset Flex Code status collapsed @@ -22116,12 +22473,1520 @@ reference "subsec:Paragraph-Styles" . \end_layout -\begin_layout Description +\begin_layout Description +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout +ResetArgs +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\emph on +0 +\end_layout + +\end_inset + +, +\begin_inset space \thinspace{} +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout +1 +\end_layout + +\end_inset + +] Resets the \SpecialChar LaTeX + arguments of this layout (as defined via the +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout +Argument +\end_layout + +\end_inset + + tag). + This is useful if you have copied a style via +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout +CopyStyle +\end_layout + +\end_inset + +, but you do not want to inherit its (required and optional) arguments. +\end_layout + +\begin_layout Description +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout +ResetsFont +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\emph on +0 +\end_layout + +\end_inset + +, +\begin_inset space \thinspace{} +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout +1 +\end_layout + +\end_inset + +] +\change_inserted -712698321 1597733473 +If +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -712698321 1597732178 +1 +\change_unchanged + +\end_layout + +\end_inset + +, font changes are redone inside the respective inset (in the output) even + if the inset itself is in the context of this font changes (e. +\begin_inset space \thinspace{} +\end_inset + +g., +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -712698321 1597733683 + +\backslash +textbf{Sourrounding text +\backslash +myinset{ +\backslash +textbf{content}}\SpecialChar ldots +} +\change_unchanged + +\end_layout + +\end_inset + + rather than +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -712698321 1597733686 + +\backslash +textbf{Sourrounding text +\backslash +myinset{content}\SpecialChar ldots +} +\change_unchanged + +\end_layout + +\end_inset + +. + Setting this makes sense for commands that internally reset font settings + (e. +\begin_inset space \thinspace{} +\end_inset + +g., footnotes). + Note that wrongly setting this might lead to unwanted result (e. +\begin_inset space \thinspace{} +\end_inset + +g., with +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -712698321 1597733688 + +\backslash +emph{Sourrounding text +\backslash +myinset{ +\backslash +emph{content}}\SpecialChar ldots +} +\change_unchanged + +\end_layout + +\end_inset + +, content is upright, as +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -712698321 1597733278 + +\backslash +emph +\change_unchanged + +\end_layout + +\end_inset + + toggles. + +\change_deleted -712698321 1597733283 +Whether this inset should use the font of its surrounding environment or + uses its own. + +\change_unchanged +Default is +\change_deleted -712698321 1597733290 +false +\change_inserted -712698321 1597733290 + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -712698321 1597733292 +0 +\change_unchanged + +\end_layout + +\end_inset + + +\change_unchanged +: +\change_deleted -712698321 1597733327 +use the font of the surrounding environment +\change_inserted -712698321 1597733343 +font changes are not redone inside the inset +\change_unchanged +. +\end_layout + +\begin_layout Description +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout +RightDelim +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout +string +\end_layout + +\end_inset + +] A string that is put at the end of the layout content. + A line break in the output can be indicated by +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout +
+\end_layout + +\end_inset + +. +\end_layout + +\begin_layout Description +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout +Spellcheck +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout +0 +\end_layout + +\end_inset + +, +\begin_inset space \thinspace{} +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\emph on +1 +\end_layout + +\end_inset + +] Allow spell-checking the contents of this inset. + Default is true. +\change_inserted -584632292 1615846659 + +\end_layout + +\begin_layout Subsection + +\change_inserted -584632292 1615846729 +Arguments +\begin_inset CommandInset label +LatexCommand label +name "subsec:Arguments" + +\end_inset + + +\end_layout + +\begin_layout Standard + +\change_inserted -584632292 1615846807 +Both paragraph styles and inset layouts allow for +\emph on +arguments +\emph default + as well as the main content. + This is especially useful for things like section headings and only makes + sense with \SpecialChar LaTeX +. + Each (optional or required) argument of a command or environment—except + for the required argument that is associated with the content—has a separate + definition, where the number specifies the order of the arguments. + The definition must end with +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +EndArgument +\change_unchanged + +\end_layout + +\end_inset + +. + So a command with two optional arguments looks like: +\end_layout + +\begin_layout Quote + +\change_inserted -584632292 1615846730 + +\family typewriter +Argument 1 +\end_layout + +\begin_layout Quote + +\change_inserted -584632292 1615846730 + +\family typewriter +... +\end_layout + +\begin_layout Quote + +\change_inserted -584632292 1615846730 + +\family typewriter +EndArgument +\end_layout + +\begin_layout Quote + +\change_inserted -584632292 1615846730 + +\family typewriter +Argument 2 +\end_layout + +\begin_layout Quote + +\change_inserted -584632292 1615846730 + +\family typewriter +... +\end_layout + +\begin_layout Quote + +\change_inserted -584632292 1615846730 + +\family typewriter +EndArgument +\end_layout + +\begin_layout Standard + +\change_inserted -584632292 1615846730 +Inside the +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +Argument +\change_unchanged + +\end_layout + +\end_inset + + definition, the following specifications are possible: +\end_layout + +\begin_layout Itemize + +\change_inserted -584632292 1615846730 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +LabelString +\change_unchanged + +\end_layout + +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +[string] +\change_unchanged + +\end_layout + +\end_inset + + The string that will appear both in the menu (to insert this argument) + and on the argument inset button (unless you also specify a separate +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +MenuString +\change_unchanged + +\end_layout + +\end_inset + +). + For the menu, you can define an accelerator by appending the respective + character to the string, divided by +\begin_inset Quotes eld +\end_inset + +| +\begin_inset Quotes erd +\end_inset + + (e. +\begin_inset space \thinspace{} +\end_inset + +g. +\begin_inset space \space{} +\end_inset + + +\begin_inset Quotes eld +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +Short Title|S +\change_unchanged + +\end_layout + +\end_inset + + +\begin_inset Quotes erd +\end_inset + +). +\end_layout + +\begin_layout Itemize + +\change_inserted -584632292 1615846730 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +MenuString +\change_unchanged + +\end_layout + +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +[string] +\change_unchanged + +\end_layout + +\end_inset + + A separate string for the menu. + You can define an accelerator by appending the respective character to + the string, divided by +\begin_inset Quotes eld +\end_inset + +| +\begin_inset Quotes erd +\end_inset + + (e. +\begin_inset space \thinspace{} +\end_inset + +g. +\begin_inset space \space{} +\end_inset + + +\begin_inset Quotes eld +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +Short Title|S +\change_unchanged + +\end_layout + +\end_inset + + +\begin_inset Quotes erd +\end_inset + +). + This specification is optional. + If it is not given the +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +LabelString +\change_unchanged + +\end_layout + +\end_inset + + will be used instead for the menu. +\end_layout + +\begin_layout Itemize + +\change_inserted -584632292 1615846730 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +Tooltip +\change_unchanged + +\end_layout + +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +[string] +\change_unchanged + +\end_layout + +\end_inset + + A longer explanatory text that appears in the tooltip when hovering over + the argument inset. +\end_layout + +\begin_layout Itemize + +\change_inserted -584632292 1615846730 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +Mandatory +\change_unchanged + +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 + +\emph on +0 +\change_unchanged + +\end_layout + +\end_inset + +, +\begin_inset space \thinspace{} +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +1 +\change_unchanged + +\end_layout + +\end_inset + +] Declare if this is a mandatory (1) or an optional (0) argument. + Mandatory arguments will be output empty if not given, while optional arguments + will not be output at all. + By default, mandatory arguments are delimited by +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +{...} +\change_unchanged + +\end_layout + +\end_inset + +, while optional arguments are delimited by +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +[...] +\change_unchanged + +\end_layout + +\end_inset + + +\end_layout + +\begin_layout Itemize + +\change_inserted -584632292 1615846730 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +NewlineCmd +\change_unchanged + +\end_layout + +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +[string] +\change_unchanged + +\end_layout + +\end_inset + + Option to define a different command (from the default +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 + +\backslash + +\backslash + +\change_unchanged + +\end_layout + +\end_inset + +) to be used for line breaks. + The initial backslash must not be specified. +\end_layout + +\begin_layout Itemize + +\change_inserted -584632292 1615846730 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +Requires +\change_unchanged + +\end_layout + +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +[int=0] +\change_unchanged + +\end_layout + +\end_inset + + defines another argument (by its number) which this argument requires to + be output if it is itself output. + E. +\begin_inset space \thinspace{} +\end_inset + +g., in \SpecialChar LaTeX + commands, optional arguments often require previous optional arguments + to be output (at least empty), as in +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 + +\backslash +command[][argument]{text} +\change_unchanged + +\end_layout + +\end_inset + +. + This can be achieved by the statement +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +Requires 1 +\change_unchanged + +\end_layout + +\end_inset + + within +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +Argument 2 +\change_unchanged + +\end_layout + +\end_inset + +. +\end_layout + +\begin_layout Itemize + +\change_inserted -584632292 1615846730 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +LeftDelim +\change_unchanged + +\end_layout + +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +[string] +\change_unchanged + +\end_layout + +\end_inset + + defines a custom left delimiter (instead of +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +{ +\change_unchanged + +\end_layout + +\end_inset + + or +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +[ +\change_unchanged + +\end_layout + +\end_inset + +). + A line break in the output can be indicated by +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +
+\change_unchanged + +\end_layout + +\end_inset + +. +\end_layout + +\begin_layout Itemize + +\change_inserted -584632292 1615846730 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +RightDelim +\change_unchanged + +\end_layout + +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +[string] +\change_unchanged + +\end_layout + +\end_inset + + defines a custom right delimiter (instead of +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +} +\change_unchanged + +\end_layout + +\end_inset + + or +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +] +\change_unchanged + +\end_layout + +\end_inset + +). + A line break in the output can be indicated by +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +
+\change_unchanged + +\end_layout + +\end_inset + +. +\end_layout + +\begin_layout Itemize + +\change_inserted -584632292 1615846730 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +DefaultArg +\change_unchanged + +\end_layout + +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +[string] +\change_unchanged + +\end_layout + +\end_inset + + defines an argument that is inserted if and only if no user-specified arguments + were given, i. +\begin_inset space \thinspace{} +\end_inset + +e. +\begin_inset space \space{} +\end_inset + +if no argument inset has been inserted (note that also an empty argument + inset omits the DefaultArg). + Multiple arguments need to be separated by comma. +\end_layout + +\begin_layout Itemize + +\change_inserted -584632292 1615846730 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +PresetArg +\change_unchanged + +\end_layout + +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +[string] +\change_unchanged + +\end_layout + +\end_inset + + defines an argument that is inserted in any case (alone or in addition + to user-specified arguments). + Multiple arguments need to be separated by comma. +\end_layout + +\begin_layout Itemize + +\change_inserted -584632292 1615846730 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +Font +\change_unchanged + +\end_layout + +\end_inset + + The font used for the argument content, see +\begin_inset CommandInset ref +LatexCommand ref +reference "subsec:Font-description" + +\end_inset + +. +\end_layout + +\begin_layout Itemize + +\change_inserted -584632292 1615846730 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +FreeSpacing +\change_unchanged + +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 + +\emph on +0 +\change_unchanged + +\end_layout + +\end_inset + +, +\begin_inset space \thinspace{} +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +1 +\change_unchanged + +\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 Itemize + +\change_inserted -584632292 1615846730 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +LabelFont +\change_unchanged + +\end_layout + +\end_inset + + The font used for the label; see +\begin_inset CommandInset ref +LatexCommand ref +reference "subsec:Font-description" + +\end_inset + +. +\end_layout + +\begin_layout Itemize + +\change_inserted -584632292 1615846730 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +Decoration +\change_unchanged + +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 + +\emph on +Classic +\emph default +, Minimalistic, Conglomerate +\change_unchanged + +\end_layout + +\end_inset + +] describes the rendering style used for the inset's frame and buttons. +\end_layout + +\begin_layout Itemize + +\change_inserted -584632292 1615846730 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +AutoInsert +\change_unchanged + +\end_layout + +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +[int=0] +\change_unchanged + +\end_layout + +\end_inset + + If this is set to +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +1 +\change_unchanged + +\end_layout + +\end_inset + +, this argument is automatically inserted when the respective style is selected. +\end_layout + +\begin_layout Itemize + +\change_inserted -584632292 1615846730 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +InsertOnNewline +\change_unchanged + +\end_layout + +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +[int=0] +\change_unchanged + +\end_layout + +\end_inset + + If this is set to +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +1 +\change_unchanged + +\end_layout + +\end_inset + +, this argument will be inserted on a new line with +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +AutoInsert +\change_unchanged + +\end_layout + +\end_inset + + (only available within Flex insets). +\end_layout + +\begin_layout Itemize + +\change_inserted -584632292 1615846730 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +InsertCotext +\change_unchanged + +\end_layout + +\end_inset + + +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +[int=0] +\change_unchanged + +\end_layout + +\end_inset + + If this is set to +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +1 +\change_unchanged + +\end_layout + +\end_inset + +, this argument will be inserted with a copy of the co-text (either selected + text or the whole paragraph) as content. +\end_layout + +\begin_layout Itemize + +\change_inserted -584632292 1615846730 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +PassThru +\change_unchanged + +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 + +\emph on +inherited +\emph default +, true, false +\change_unchanged + +\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 -584632292 1615846730 +PassThru +\change_unchanged + +\end_layout + +\end_inset + + status is inherited by the inset or paragraph layout the argument belongs + to, true and false change the status for the given argument only. +\end_layout + +\begin_layout Itemize + +\change_inserted -584632292 1615846730 +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +PassThruChars +\change_unchanged + +\end_layout + +\end_inset + + [ +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\change_inserted -584632292 1615846730 +string of characters +\change_unchanged + +\end_layout + +\end_inset + +] +\family typewriter + +\family default +Defines individual characters +\begin_inset Newline linebreak +\end_inset + +that should be output in raw form, meaning without special translations + that \SpecialChar LaTeX + would require. + Note that, contrary to PassThru, this needs to be explicitly defined for + arguments. + That is, arguments do not inherit PassThruChars from their parent inset + or layout. +\end_layout + +\begin_layout Itemize + +\change_inserted -584632292 1615846730 \begin_inset Flex Code status collapsed \begin_layout Plain Layout -ResetArgs + +\change_inserted -584632292 1615846730 +IsTocCaption +\change_unchanged + \end_layout \end_inset @@ -22132,8 +23997,12 @@ status collapsed \begin_layout Plain Layout +\change_inserted -584632292 1615846730 + \emph on 0 +\change_unchanged + \end_layout \end_inset @@ -22147,127 +24016,107 @@ status collapsed status collapsed \begin_layout Plain Layout + +\change_inserted -584632292 1615846730 1 +\change_unchanged + \end_layout \end_inset -] Resets the \SpecialChar LaTeX - arguments of this layout (as defined via the -\begin_inset Flex Code -status collapsed - -\begin_layout Plain Layout -Argument +] If this is set to 1, the argument will output its content in the corresponding + item in the table of contents. + See AddToToc. \end_layout -\end_inset +\begin_layout Standard - tag). - This is useful if you have copied a style via +\change_inserted -584632292 1615846730 +By default, the text entered in the \SpecialChar LyX + workarea in the respective layout is + the last (mandatory) argument of a command if the \begin_inset Flex Code status collapsed \begin_layout Plain Layout -CopyStyle -\end_layout - -\end_inset - -, but you do not want to inherit its (required and optional) arguments. -\end_layout -\begin_layout Description -\begin_inset Flex Code -status collapsed +\change_inserted -584632292 1615846730 +LatexType +\change_unchanged -\begin_layout Plain Layout -ResetsFont \end_layout \end_inset - [ + is \begin_inset Flex Code status collapsed \begin_layout Plain Layout -\emph on -0 -\end_layout +\change_inserted -584632292 1615846730 +Command +\change_unchanged -\end_inset +\end_layout -, -\begin_inset space \thinspace{} \end_inset - +. + However, arguments with the prefix \begin_inset Flex Code status collapsed \begin_layout Plain Layout -1 + +\change_inserted -584632292 1615846730 +post: +\change_unchanged + \end_layout \end_inset -] -\change_inserted -712698321 1597733473 -If + are output after this workarea argument. + Note that post-argument numbering restarts at 1, so the first argument + following the workarea argument is \begin_inset Flex Code status collapsed \begin_layout Plain Layout -\change_inserted -712698321 1597732178 -1 +\change_inserted -584632292 1615846730 +post:1 \change_unchanged \end_layout \end_inset -, font changes are redone inside the respective inset (in the output) even - if the inset itself is in the context of this font changes (e. -\begin_inset space \thinspace{} -\end_inset - -g., +. + Post-arguments are ignored in any other \begin_inset Flex Code status collapsed \begin_layout Plain Layout -\change_inserted -712698321 1597733683 - -\backslash -textbf{Sourrounding text -\backslash -myinset{ -\backslash -textbf{content}}\SpecialChar ldots -} +\change_inserted -584632292 1615846730 +LatexType \change_unchanged \end_layout \end_inset - rather than + than \begin_inset Flex Code status collapsed \begin_layout Plain Layout -\change_inserted -712698321 1597733686 - -\backslash -textbf{Sourrounding text -\backslash -myinset{content}\SpecialChar ldots -} +\change_inserted -584632292 1615846730 +Command \change_unchanged \end_layout @@ -22275,161 +24124,161 @@ myinset{content}\SpecialChar ldots \end_inset . - Setting this makes sense for commands that internally reset font settings - (e. -\begin_inset space \thinspace{} -\end_inset +\end_layout -g., footnotes). - Note that wrongly setting this might lead to unwanted result (e. -\begin_inset space \thinspace{} -\end_inset +\begin_layout Standard -g., with +\change_inserted -584632292 1615846730 +Arguments for list \begin_inset Flex Code status collapsed \begin_layout Plain Layout -\change_inserted -712698321 1597733688 +\change_inserted -584632292 1615846730 \backslash -emph{Sourrounding text -\backslash -myinset{ -\backslash -emph{content}}\SpecialChar ldots -} +item \change_unchanged \end_layout \end_inset -, content is upright, as +s (as in \begin_inset Flex Code status collapsed \begin_layout Plain Layout -\change_inserted -712698321 1597733278 +\change_inserted -584632292 1615846730 \backslash -emph +item[foo] \change_unchanged \end_layout \end_inset - toggles. - -\change_deleted -712698321 1597733283 -Whether this inset should use the font of its surrounding environment or - uses its own. - -\change_unchanged -Default is -\change_deleted -712698321 1597733290 -false -\change_inserted -712698321 1597733290 - +) have the prefix \begin_inset Flex Code status collapsed \begin_layout Plain Layout -\change_inserted -712698321 1597733292 -0 +\change_inserted -584632292 1615846730 +item: \change_unchanged \end_layout \end_inset + followed by the number (e. +\begin_inset space \thinspace{} +\end_inset + +g. +\begin_inset space \space{} +\end_inset -\change_unchanged -: -\change_deleted -712698321 1597733327 -use the font of the surrounding environment -\change_inserted -712698321 1597733343 -font changes are not redone inside the inset -\change_unchanged -. -\end_layout -\begin_layout Description \begin_inset Flex Code status collapsed \begin_layout Plain Layout -RightDelim + +\change_inserted -584632292 1615846730 +Argument item:1 +\change_unchanged + \end_layout \end_inset - [ -\begin_inset Flex Code -status collapsed - -\begin_layout Plain Layout -string +). \end_layout -\end_inset +\begin_layout Standard -] A string that is put at the end of the layout content. - A line break in the output can be indicated by +\change_inserted -584632292 1615846730 +Finally, there is a special argument type with the prefix \begin_inset Flex Code status collapsed \begin_layout Plain Layout -
+ +\change_inserted -584632292 1615846730 +listpreamble: +\change_unchanged + \end_layout \end_inset . -\end_layout + It is not really an argument, but uses the argument interface (thus, the + prefix is also followed by a number, e. +\begin_inset space \thinspace{} +\end_inset -\begin_layout Description +g. + \begin_inset Flex Code status collapsed \begin_layout Plain Layout -Spellcheck -\end_layout - -\end_inset - [ -\begin_inset Flex Code -status collapsed +\change_inserted -584632292 1615846730 +Argument listpreamble:1 +\change_unchanged -\begin_layout Plain Layout -0 \end_layout \end_inset -, -\begin_inset space \thinspace{} -\end_inset - - +). + As the name implies, it is targeted at lists such as +\family sans +Itemize +\family default +, +\family sans +Enumerate +\family default +, +\family sans +Description +\family default +, or +\family sans +Bibliography +\family default +. + Its content will be output at the list start, before the first \begin_inset Flex Code status collapsed \begin_layout Plain Layout -\emph on -1 +\change_inserted -584632292 1615846730 + +\backslash +item +\change_unchanged + \end_layout \end_inset -] Allow spell-checking the contents of this inset. - Default is true. +, on an own line (a place that is otherwise not accessible in \SpecialChar LyX +). + This way, users can insert redefinitions (of lengths etc.) to individual + lists. + By default, these arguments do not have a delimiter. +\change_unchanged + \end_layout \begin_layout Subsection @@ -22940,7 +24789,13 @@ string ] The counter name as used in \SpecialChar LaTeX . - (E.g., in \SpecialChar LyX + ( +\change_inserted 34634807 1619711355 +e +\change_deleted 34634807 1619711355 +E +\change_inserted -584632292 1607202682 +.g., in \SpecialChar LyX , there is a counter named `theorem', but it is output to \SpecialChar LaTeX as `thm'.) \change_unchanged @@ -28382,9 +30237,14 @@ MultiPar \end_inset - is true—then the contents of the inset will itself be output as paragraphs - formatted according to the styles used for those paragraphs (standard, - quote, and the like). + is true—then the contents of the inset will +\change_deleted 34634807 1620029217 +itself +\change_inserted 34634807 1620029219 +themselves +\change_inserted -970929547 1515111183 + be output as paragraphs formatted according to the styles used for those + paragraphs (standard, quote, and the like). The inner tag is optional and, by default, does not appear. \end_layout @@ -29754,8 +31614,11 @@ string \end_inset -] Specifies attribute information to be output with the outer tag, replacing - +] Specifies attribute information to be output with the outer +\change_inserted 34634807 1620057958 +wrapper +\change_inserted -970929547 1515110832 +tag, replacing \begin_inset Quotes eld \end_inset @@ -30105,10 +31968,19 @@ biblioentry \begin_layout Standard \change_inserted 1075283030 1597700112 -When the bibliographic entries are manually inserted into the LyX document - as Bibliography Items, the user deals with formatting themself: there is - no attempt of parsing what the user wrote, the string is directly used - (with the +When the bibliographic entries are manually inserted into the +\change_deleted 34634807 1620057319 +LyX +\change_inserted 34634807 1620057319 +\SpecialChar LyX + +\change_inserted 1075283030 1597700112 + document as Bibliography Items, the user deals with formatting +\change_unchanged +them +\change_inserted 1075283030 1597700112 +self: there is no attempt of parsing what the user wrote, the string is + directly used (with the \begin_inset Flex Code status collapsed