From 76ef99e2d795bddd9d7642642817978a2a1781c3 Mon Sep 17 00:00:00 2001
From: John R Hudson <j.r.hud...@virginmedia.com>
Date: Tue, 27 Dec 2022 10:51:40 +0000
Subject: [PATCH] Insert entries for Customizable lists and Paragraph lists
into Chapter 4 Modules of Additional.lyx
---
lib/doc/Additional.lyx | 1320 ++++++++++++++++++++++++++++++++++++++++
1 file changed, 1320 insertions(+)
diff --git a/lib/doc/Additional.lyx b/lib/doc/Additional.lyx
index 74558a56d7..07695291f4 100644
--- a/lib/doc/Additional.lyx
+++ b/lib/doc/Additional.lyx
@@ -37,6 +37,7 @@ theorems-ams-extended
multicol
shapepar
graphicboxes
+enumitem
\end_modules
\maintain_unincluded_children no
\language english
@@ -14814,6 +14815,1315 @@ Rnw
have been loaded.
\end_layout
+\begin_layout Section
+
+\change_inserted 564990737 1672138150
+
+\lang american
+List enhancements
+\end_layout
+
+\begin_layout Subsection
+
+\change_inserted 564990737 1672138150
+
+\lang american
+Customizable Lists
+\begin_inset CommandInset label
+LatexCommand label
+name "subsec:Customizable-Lists"
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\lang american
+This module uses the
+\family sans
+ enumitem
+\family default
+ package to enable the customization of various list environments.
+\end_layout
+
+\begin_layout Subsubsection
+
+\change_inserted 564990737 1672138150
+
+\lang american
+Custom Enumerate Lists
+\end_layout
+
+\begin_layout Standard
+\noindent
+
+\change_inserted 564990737 1672138150
+
+\lang american
+The default numbering of numbered lists can be changed by adding an optional
+ argument (menu
+\family sans
+\bar under
+I
+\bar default
+nsert\SpecialChar menuseparator
+
+\bar under
+S
+\bar default
+hort Title
+\family default
+) to the first item of each level in the list.
+ There you add the command
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\family sans
+\lang american
+label=
+\backslash
+roman{enumi}
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\lang american
+in \SpecialChar TeX
+ Code (shortcut
+\begin_inset Info
+type "shortcut"
+arg "ert-insert"
+\end_inset
+
+).
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\family sans
+\lang american
+enumi
+\family default
+ is the first level counter of the enumeration.
+ To change the numbering for the list sublevels, replace the “
+\family sans
+i
+\family default
+” in the command by the small Roman numeral of the level (
+\family sans
+enumi
+\family default
+,
+\family sans
+enumii
+\family default
+,
+\family sans
+enumiii
+\family default
+,
+\family sans
+enumiv
+\family default
+).
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\lang american
+The command
+\family sans
+
+\backslash
+roman
+\family default
+ outputs the counter as a small Roman numeral.
+ For capital Roman numerals replace
+\family sans
+
+\backslash
+roman
+\family default
+ with
+\family sans
+
+\backslash
+Roman
+\family default
+ in the command above.
+ For Arabic numerals use
+\family sans
+
+\backslash
+arabic
+\family default
+.
+ To
+\begin_inset Quotes eld
+\end_inset
+
+number
+\begin_inset Quotes erd
+\end_inset
+
+ items with capital or small Latin letters use
+\family sans
+
+\backslash
+Alph
+\family default
+ or
+\family sans
+
+\backslash
+alph
+\family default
+, respectively.
+\end_layout
+
+\begin_layout Standard
+\noindent
+
+\change_inserted 564990737 1672138150
+
+\lang american
+\begin_inset Note Greyedout
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 564990737 1672138150
+
+\series bold
+\lang american
+Note:
+\series default
+ You can only number 26
+\begin_inset space ~
+\end_inset
+
+items with Latin letters, because this numbering is limited to single letters.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\lang american
+Here is a list with custom numbering:
+\end_layout
+
+\begin_layout Enumerate
+
+\change_inserted 564990737 1672138150
+
+\lang american
+\begin_inset Argument 1
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 564990737 1672138150
+
+\lang american
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 564990737 1672138150
+
+label=
+\backslash
+#
+\backslash
+Alph{enumi}
+\backslash
+#
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\end_inset
+
+Level 1
+\begin_inset Separator latexpar
+\end_inset
+
+
+\end_layout
+
+\begin_deeper
+\begin_layout Enumerate
+
+\change_inserted 564990737 1672138150
+
+\lang american
+\begin_inset Argument 1
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 564990737 1672138150
+
+\lang american
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 564990737 1672138150
+
+label=
+\backslash
+Alph{enumi}.
+\backslash
+arabic{enumii}
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\end_inset
+
+Level 2
+\end_layout
+
+\begin_layout Enumerate
+
+\change_inserted 564990737 1672138150
+
+\lang american
+Level 2
+\begin_inset Separator latexpar
+\end_inset
+
+
+\end_layout
+
+\begin_deeper
+\begin_layout Enumerate
+
+\change_inserted 564990737 1672138150
+
+\lang american
+\begin_inset Argument 1
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 564990737 1672138150
+
+\lang american
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 564990737 1672138150
+
+label=
+\backslash
+bf{
+\backslash
+arabic{enumiii}}
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\end_inset
+
+Level 3
+\begin_inset Separator latexpar
+\end_inset
+
+
+\end_layout
+
+\begin_deeper
+\begin_layout Enumerate
+
+\change_inserted 564990737 1672138150
+
+\lang american
+\begin_inset Argument 1
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 564990737 1672138150
+
+\lang american
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 564990737 1672138150
+
+label=
+\backslash
+emph{
+\backslash
+roman{enumiv})}
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\end_inset
+
+Level 4
+\end_layout
+
+\end_deeper
+\end_deeper
+\end_deeper
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\lang american
+For this list these commands were used:
+\end_layout
+
+\begin_layout Standard
+\noindent
+
+\change_inserted 564990737 1672138150
+
+\family sans
+\lang american
+label=
+\backslash
+#
+\backslash
+Alph{enumi}
+\backslash
+#
+\begin_inset Newline newline
+\end_inset
+
+label=
+\backslash
+Alph{enumi}.
+\backslash
+arabic{enumii}
+\begin_inset Newline newline
+\end_inset
+
+label=
+\backslash
+bf{
+\backslash
+arabic{enumiii}}
+\begin_inset Newline newline
+\end_inset
+
+label=
+\backslash
+emph{
+\backslash
+roman{enumiv})}
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\lang american
+where the command
+\family sans
+
+\backslash
+emph{}
+\family default
+ makes the label emphasized and
+\family sans
+
+\backslash
+bf{}
+\family default
+ makes it bold.
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\lang american
+\begin_inset Note Greyedout
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 564990737 1672138150
+
+\series bold
+\lang american
+Note:
+\series default
+ When you change the label of a list level, it will be used for all following
+ lists until you change the definition.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\lang british
+\begin_inset ERT
+status open
+
+\begin_layout Plain Layout
+
+\change_inserted 564990737 1672138150
+
+
+\backslash
+renewcommand{
+\backslash
+labelenumi}{
+\backslash
+thesection.
+\backslash
+arabic{enumi}}
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Subsubsection
+
+\change_inserted 564990737 1672138150
+
+\lang american
+Numbered Paragraphs in Reports
+\end_layout
+
+\begin_layout Enumerate
+
+\change_inserted 564990737 1672138213
+
+\lang american
+Official reports often include numbered paragraphs; you can achieve this
+ with a variation on the approach outlined in the footnote
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "fn:If-you-really"
+plural "false"
+caps "false"
+noprefix "false"
+
+\end_inset
+
+.
+ Replace
+\family sans
+item
+\family default
+ in each command with
+\family sans
+enum
+\family default
+.
+\end_layout
+
+\begin_layout Enumerate
+
+\change_inserted 564990737 1672138150
+
+\lang american
+These numbered paragraphs were generated by inserting the \SpecialChar TeX
+ Code
+\begin_inset Separator latexpar
+\end_inset
+
+
+\end_layout
+
+\begin_deeper
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\family sans
+\lang american
+
+\backslash
+renewcommand{
+\backslash
+labelenumi}{
+\backslash
+thesection.
+\backslash
+arabic{enumi}}
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\lang american
+before the start of the section;
+\family sans
+
+\backslash
+thesection
+\family default
+ uses the \SpecialChar LaTeX
+ section counter to generate the first part of the number.
+\end_layout
+
+\end_deeper
+\begin_layout Enumerate
+
+\change_inserted 564990737 1672138150
+
+\lang american
+I have ignored the subsection heading in this example because, with paragraphs
+ numbered in this way, subsections are less likely to be used.
+\end_layout
+
+\begin_layout Subsubsection
+
+\change_inserted 564990737 1672138150
+
+\lang american
+Resumed Enumeration
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\lang british
+\begin_inset ERT
+status open
+
+\begin_layout Plain Layout
+
+\change_inserted 564990737 1672138150
+
+
+\backslash
+renewcommand{
+\backslash
+labelenumi}{
+\backslash
+arabic{enumi}}
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\lang american
+Enumerations can be resumed after intermediate paragraphs:
+\end_layout
+
+\begin_layout Enumerate
+
+\change_inserted 564990737 1672138150
+
+\lang american
+\begin_inset Argument 1
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 564990737 1672138150
+
+\lang american
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 564990737 1672138150
+
+label=
+\backslash
+arabic{enumi}.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\end_inset
+
+first
+\begin_inset Note Note
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 564990737 1672138150
+
+\lang american
+goes back to default numbering
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Enumerate
+
+\change_inserted 564990737 1672138150
+
+\lang american
+second
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\lang american
+regular text
+\end_layout
+
+\begin_layout Enumerate-Resume
+
+\change_inserted 564990737 1672138150
+
+\lang american
+resumed
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\lang american
+To resume an enumeration, use the style
+\family sans
+Enumerate-Resume
+\family default
+.
+ Its numbering appears in blue within \SpecialChar LyX
+ to indicate that it is a resumed
+ list and that the numbering will not be correct in \SpecialChar LyX
+, but in the output.
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\lang american
+\begin_inset Note Greyedout
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 564990737 1672138150
+
+\series bold
+\lang american
+Note:
+\series default
+ If there is no previous enumeration to resume, you will get a \SpecialChar LaTeX
+ error.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\lang american
+Perhaps you might want to resume the list with a different number from the
+ next one.
+ Or you want to start a new enumeration with a defined number.
+ This is possible by adding an optional argument to the first list item
+ of a normal enumeration.
+ There, insert the command
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\family sans
+\lang american
+start=number
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\lang american
+where
+\family sans
+number
+\family default
+ is the number with which you want to resume the list.
+ An example:
+\end_layout
+
+\begin_layout Enumerate
+
+\change_inserted 564990737 1672138150
+
+\lang american
+first item
+\end_layout
+
+\begin_layout Enumerate
+
+\change_inserted 564990737 1672138150
+
+\lang american
+second item
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\lang american
+Enumeration starting at a given value:
+\end_layout
+
+\begin_layout Enumerate
+
+\change_inserted 564990737 1672138150
+
+\lang american
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+
+\change_inserted 564990737 1672138150
+
+\lang american
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 564990737 1672138150
+
+start=4
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\end_inset
+
+This enumeration starts at 4
+\end_layout
+
+\begin_layout Subsubsection
+
+\change_inserted 564990737 1672138150
+
+\lang american
+List Spacing
+\begin_inset Index idx
+range none
+pageformat default
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 564990737 1672138150
+
+\lang american
+Lists ! Spacing
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\lang american
+In some cases you might want less or more vertical space between the items
+ of a list.
+ For example if the default space is too much in your opinion in this case:
+\end_layout
+
+\begin_layout Itemize
+
+\change_inserted 564990737 1672138150
+
+\lang american
+A bullet list
+\end_layout
+
+\begin_layout Itemize
+
+\change_inserted 564990737 1672138150
+
+\lang american
+with standard spacing
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\lang american
+You can decrease the space by adding an optional argument to the first item
+ of the list.
+ Add there the command
+\family sans
+nolistsep
+\family default
+ to get no additional list space like in this example:
+\end_layout
+
+\begin_layout Itemize
+
+\change_inserted 564990737 1672138150
+
+\lang american
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+
+\change_inserted 564990737 1672138150
+
+\lang american
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 564990737 1672138150
+
+nolistsep
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\end_inset
+
+A bullet list
+\end_layout
+
+\begin_layout Itemize
+
+\change_inserted 564990737 1672138150
+
+\lang american
+without additional
+\end_layout
+
+\begin_layout Itemize
+
+\change_inserted 564990737 1672138150
+
+\lang american
+vertical space
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\lang american
+To add space you can use several other commands provided by the
+\family sans
+enumitem
+\family default
+
+\begin_inset Index idx
+range none
+pageformat default
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 564990737 1672138150
+
+\lang american
+\SpecialChar LaTeX
+-packages ! enumitem
+\end_layout
+
+\end_inset
+
+ package.
+ For more information see the
+\begin_inset CommandInset href
+LatexCommand href
+name "enumitem documentation"
+target "http://mirrors.ctan.org/macros/latex/contrib/enumitem/enumitem.pdf";
+literal "false"
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\lang american
+There are also many commands available to change the horizontal spacing
+ and indentation.
+ Here is an example where the indentation was changed to that of the paragraphs
+ in the document and the label separation was set to 2
+\begin_inset space \thinspace{}
+\end_inset
+
+cm so that the number is in the page margin:
+\end_layout
+
+\begin_layout Enumerate
+
+\change_inserted 564990737 1672138150
+
+\lang american
+\begin_inset Argument 1
+status open
+
+\begin_layout Plain Layout
+
+\change_inserted 564990737 1672138150
+
+\lang american
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 564990737 1672138150
+
+labelindent=
+\backslash
+parindent, labelsep=2cm
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\end_inset
+
+An enumeration
+\end_layout
+
+\begin_layout Enumerate
+
+\change_inserted 564990737 1672138150
+
+\lang american
+with negative indentation
+\end_layout
+
+\begin_layout Subsubsection
+
+\change_inserted 564990737 1672138150
+
+\lang american
+Further Customization
+\begin_inset Index idx
+range none
+pageformat default
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 564990737 1672138150
+
+\lang american
+Lists ! Customization
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\lang american
+You can also change the style of description lists.
+ The command
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\family sans
+\lang american
+font=definition
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\lang american
+changes the description label font, the command
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\family sans
+\lang american
+style=definitio
+\family default
+\series bold
+n
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\lang american
+sets the list style.
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\lang american
+An example where the command
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\family sans
+\lang american
+font=
+\backslash
+itshape, style=nextline
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\lang american
+is used:
+\end_layout
+
+\begin_layout Description
+
+\change_inserted 564990737 1672138150
+
+\lang american
+Ionizing
+\begin_inset space ~
+\end_inset
+
+radiation:
+\begin_inset Argument 1
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 564990737 1672138150
+
+\lang american
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 564990737 1672138150
+
+labelindent=0pt, labelsep=1cm, font=
+\backslash
+itshape, style=nextline
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\end_inset
+
+Ionizing radiation consists of particles or electromagnetic waves that are
+ energetic enough to detach electrons from atoms or molecules, therefore
+ ionizing them.
+\end_layout
+
+\begin_layout Description
+
+\change_inserted 564990737 1672138150
+
+\lang american
+Reference
+\begin_inset space ~
+\end_inset
+
+counting: In computer science, reference counting is a technique of storing
+ the number of references, pointers, or handles to a resource such as an
+ object, block of memory, disk space or other resource.
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\lang american
+There are many more commands and features provided by the
+\family sans
+enumitem
+\family default
+
+\begin_inset Index idx
+range none
+pageformat default
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted 564990737 1672138150
+
+\lang american
+\SpecialChar LaTeX
+-packages ! enumitem
+\end_layout
+
+\end_inset
+
+ package.
+ For more information see the
+\begin_inset CommandInset href
+LatexCommand href
+name "enumitem documentation"
+target "http://mirrors.ctan.org/macros/latex/contrib/enumitem/enumitem.pdf";
+literal "false"
+
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Subsection
+
+\change_inserted 564990737 1672138150
+
+\series bold
+\lang american
+Paragraph Lists
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted 564990737 1672138150
+
+\lang american
+This module uses the package
+\family sans
+paralist
+\family default
+ to provide nine new list environments.
+ Itemized and enumerated lists can be typeset within paragraphs, as paragraphs
+ and in a compact version.
+ Most environments have optional arguments to format the labels.
+ Additionally, the \SpecialChar LaTeX
+ list environments itemize and enumerate are extended
+ to use a similar optional argument.
+ For further details see
+\family sans
+File\SpecialChar menuseparator
+Open Example\SpecialChar menuseparator
+Modules\SpecialChar menuseparator
+Paragraph Lists (paralist)
+\family default
+,
+\family sans
+Help\SpecialChar menuseparator
+Specific Manuals\SpecialChar menuseparator
+Paralist
+\family default
+ and the
+\begin_inset CommandInset href
+LatexCommand href
+name "paralist documentation"
+target "http://mirrors.ctan.org/macros/latex/contrib/paralist/paralist.pdf";
+literal "false"
+
+\end_inset
+
+.
+\end_layout
+
\begin_layout Section
Multiple Text Columns
\end_layout
@@ -18917,6 +20227,16 @@ You can reset a bullet shape to the default simply by clicking your right
status open
\begin_layout Plain Layout
+
+\change_inserted 564990737 1672138075
+\begin_inset CommandInset label
+LatexCommand label
+name "fn:If-you-really"
+
+\end_inset
+
+
+\change_unchanged
If you
\emph on
really
--
2.35.3
--
lyx-devel mailing list
lyx-devel@lists.lyx.org
http://lists.lyx.org/mailman/listinfo/lyx-devel
