From: John R Hudson Date: Sun, 18 Dec 2022 09:30:32 +0000 (+0000) Subject: Create Chapter 6 Bullets in Additional.lyx and move the bullet section into it; this... X-Git-Url: https://git.lyx.org/gitweb/?a=commitdiff_plain;h=399fd96fab53cdb75e164c41d1f9727a024a3bdc;p=features.git Create Chapter 6 Bullets in Additional.lyx and move the bullet section into it; this completes the reordering of chapters in Additional.lyx to reflect entries in Document Settings --- diff --git a/lib/doc/Additional.lyx b/lib/doc/Additional.lyx index 23c4305a83..8cb138dc48 100644 --- a/lib/doc/Additional.lyx +++ b/lib/doc/Additional.lyx @@ -8958,12 +8958,25 @@ Selection \end_inset +\change_inserted 564990737 1671355684 + +\begin_inset CommandInset ref +LatexCommand ref +reference "chap:bullets" + +\end_inset + + +\change_deleted 564990737 1671355684 + \begin_inset CommandInset ref LatexCommand ref reference "sec:bullet" \end_inset + +\change_unchanged . \end_layout @@ -15844,1706 +15857,1727 @@ Biblatex \end_layout \begin_layout Chapter -Supplemental Tools -\end_layout -\begin_layout Section -Multipart Documents -\end_layout +\change_deleted 564990737 1671355654 +Itemize +\change_unchanged +Bullet +\change_inserted 564990737 1671355667 +s +\change_deleted 564990737 1671355661 + Selection +\change_inserted 564990737 1671355684 -\begin_layout Subsection -General Operation -\end_layout +\begin_inset CommandInset label +LatexCommand label +name "chap:bullets" -\begin_layout Standard -When you are working on a large file with many sections, it is often convenient - to break up the document into several files, or perhaps you have something - where a table may change from time to time, but the preceding text does - not. - In these cases, you should seriously consider using multipart documents. - For example, scientific papers often have five major sections: the introduction -, observations, results, discussion, and conclusion. - Each of these could be its own separate \SpecialChar LyX - file, with one -\begin_inset Quotes eld \end_inset -master -\begin_inset Quotes erd -\end_inset - file which contains the title, authors, abstract, references, etc., plus - the five included files. - It is important to note that each of these files is a full \SpecialChar LyX - file which - can be formatted and printed on its own, as well as included in a master - file. - Each of these files must have the same document class, however—don't attempt - to mix book classes with article classes. - You may also include \SpecialChar LaTeX - files; however, these files must not have their own - preamble (i. -\begin_inset space \thinspace{} -\end_inset +\change_deleted 564990737 1671355684 + +\begin_inset CommandInset label +LatexCommand label +name "sec:bullet" -e. -\begin_inset space \space{} \end_inset -everything up to and including the -\begin_inset Flex Code -status collapsed -\begin_layout Plain Layout +\change_unchanged -\backslash -begin{document} \end_layout -\end_inset +\begin_layout Standard +by +\noun on + Allan Rae +\end_layout - line as well as the -\begin_inset Flex Code +\begin_layout Section +Introduction +\end_layout + +\begin_layout Standard +\SpecialChar LyX + provides 216 bullet shapes that can be accessed from a simple dialog. + Using this dialog you can easily specify what bullet shape to use at each + level of an itemized list. + These settings are document-wide so you won't be able to specify different + sets of bullets for different paragraphs. +\begin_inset Foot status collapsed \begin_layout Plain Layout - -\backslash -end{document} +Well, actually you can but you'll have to do it by hand. \end_layout \end_inset - line must be deleted) or else errors will be generated when you try to - make a DVI file. + +\end_layout + +\begin_layout Section +How it looks \end_layout \begin_layout Standard -\SpecialChar LyX - allows you to include files quite easily with +Open the dialog by selecting the \begin_inset Flex Noun status collapsed \begin_layout Plain Layout -Insert\SpecialChar menuseparator -Child -\begin_inset space ~ +Document\SpecialChar menuseparator +Settings +\end_layout + \end_inset -Document + menu item and then select the +\begin_inset Flex Noun +status collapsed + +\begin_layout Plain Layout +Bullets \end_layout \end_inset -. - When you click on this selection a small box is inserted into the file - at the current cursor location. - Clicking on the box raises a dialog which allows you to select the file - to be included, and the method of its inclusion. - + tab. \end_layout \begin_layout Standard -The file selection box should by now be obvious. - The three inclusion methods are -\begin_inset Quotes eld -\end_inset - -include -\begin_inset Quotes erd -\end_inset +The dialog provides you with a table of bullet shapes. + A column of buttons on the left of the table provides access to the six + different panels of bullet shapes. + The row of buttons across the top is used to select which bullet depth + you are changing. -, -\begin_inset Quotes eld -\end_inset +\change_deleted 244031559 1603875981 + A text entry under the table shows the currently selected bullet shape's + \SpecialChar LaTeX + equivalent and this can be edited if desired. + If you do modify the text you will also need to specify any needed packages + in the \SpecialChar LaTeX + preamble. +\change_unchanged -input -\begin_inset Quotes erd -\end_inset +\end_layout -, and -\begin_inset Quotes eld -\end_inset +\begin_layout Standard +The six panels are divided up by the packages they require. + The following table shows the mappings from button name to \SpecialChar LaTeX + package. +\end_layout -verbatim -\begin_inset Quotes erd -\end_inset +\begin_layout Standard +\align center +\begin_inset Tabular + + + + + + +\begin_inset Text -. - The methods -\begin_inset Quotes eld -\end_inset +\begin_layout Plain Layout -include -\begin_inset Quotes erd -\end_inset +\family roman +\series medium +\shape up +\size normal +\emph off +\bar no +\noun off +\color none +Button +\end_layout - and -\begin_inset Quotes eld \end_inset + + +\begin_inset Text -input -\begin_inset Quotes erd -\end_inset +\begin_layout Plain Layout - are similar in many ways, but there are also some notable differences: +\family roman +\series medium +\shape up +\size normal +\emph off +\bar no +\noun off +\color none +Packages Required \end_layout -\begin_layout Enumerate -Files that are -\begin_inset Quotes eld \end_inset + + + + +\begin_inset Text -included -\begin_inset Quotes erd -\end_inset +\begin_layout Plain Layout - are typeset beginning on a new page, while files that are -\begin_inset Quotes eld -\end_inset +\family sans +\series medium +\shape up +\size normal +\emph off +\bar no +\noun off +\color none +Standard +\end_layout -inputted -\begin_inset Quotes erd \end_inset + + +\begin_inset Text - are typeset starting on the current page. -\end_layout +\begin_layout Plain Layout -\begin_layout Enumerate -\begin_inset Quotes eld -\end_inset +\series medium +\shape up +\size normal +\emph off +\bar no +\noun off +\color none +base \SpecialChar LaTeX -Included -\begin_inset Quotes erd -\end_inset +\end_layout - files cannot themselves -\begin_inset Quotes eld -\end_inset - -include -\begin_inset Quotes erd \end_inset + + + + +\begin_inset Text - further files ( -\begin_inset Quotes eld -\end_inset +\begin_layout Plain Layout -grandchilds -\begin_inset Quotes erd -\end_inset +\family sans +\series medium +\shape up +\size normal +\emph off +\bar no +\noun off +\color none +Maths +\end_layout -). - With -\begin_inset Quotes eld \end_inset + + +\begin_inset Text -input -\begin_inset Quotes erd -\end_inset +\begin_layout Plain Layout -, on the other hand, infinite sub-inputting is possible. +\family typewriter +\series medium +\shape up +\size normal +\emph off +\bar no +\noun off +\color none +amssymb.sty \end_layout -\begin_layout Enumerate -\begin_inset Quotes eld \end_inset + + + + +\begin_inset Text -Include -\begin_inset Quotes erd -\end_inset +\begin_layout Plain Layout - allow for the output of only selected -\begin_inset Quotes eld -\end_inset +\family sans +\series medium +\shape up +\size normal +\emph off +\bar no +\noun off +\color none +Ding1 +\end_layout -included -\begin_inset Quotes erd \end_inset + + +\begin_inset Text - files, while maintaining the actual counters (pagination etc.) and references - (please refer to the section -\emph on -Child -\begin_inset space ~ -\end_inset +\begin_layout Plain Layout + +\family typewriter +\series medium +\shape up +\size normal +\emph off +\bar no +\noun off +\color none +pifont.sty +\end_layout -Documents -\emph default - of the -\emph on -Embedded -\begin_inset space ~ \end_inset + + + + +\begin_inset Text -Objects -\emph default - manual for details). +\begin_layout Plain Layout + +\family sans +\series medium +\shape up +\size normal +\emph off +\bar no +\noun off +\color none +Ding2 \end_layout -\begin_layout Standard -Hence, -\begin_inset Quotes eld \end_inset + + +\begin_inset Text -include -\begin_inset Quotes erd -\end_inset +\begin_layout Plain Layout - is the preferred method for chapters that are outsourced to child documents, - while -\begin_inset Quotes eld -\end_inset +\family typewriter +\series medium +\shape up +\size normal +\emph off +\bar no +\noun off +\color none +pifont.sty +\end_layout -input -\begin_inset Quotes erd \end_inset + + + + +\begin_inset Text - is more suitable for arbitrary file inheritance. +\begin_layout Plain Layout + +\family sans +\series medium +\shape up +\size normal +\emph off +\bar no +\noun off +\color none +Ding3 \end_layout -\begin_layout Standard -A -\begin_inset Quotes eld \end_inset + + +\begin_inset Text -verbatim -\begin_inset Quotes erd -\end_inset +\begin_layout Plain Layout - included file allows you to include a file typeset exactly as it appears - in the file, i. -\begin_inset space \thinspace{} -\end_inset +\family typewriter +\series medium +\shape up +\size normal +\emph off +\bar no +\noun off +\color none +pifont.sty +\end_layout -e. -\begin_inset space \space{} \end_inset - -in -\begin_inset Flex Code -status collapsed + + + + +\begin_inset Text \begin_layout Plain Layout -verbatim + +\family sans +\series medium +\shape up +\size normal +\emph off +\bar no +\noun off +\color none +Ding4 \end_layout \end_inset - - mode, with the characters set in a fixed-width typewriter font. - Normally, spaces in this file are invisible, though two consecutive spaces - are conserved, unlike \SpecialChar LyX -'s normal treatment of spaces. - However, setting the -\begin_inset Flex Noun -status collapsed + + +\begin_inset Text \begin_layout Plain Layout -Mark -\begin_inset space ~ -\end_inset -spaces -\begin_inset space ~ +\family typewriter +\series medium +\shape up +\size normal +\emph off +\bar no +\noun off +\color none +pifont.sty +\end_layout + \end_inset + + + -in -\begin_inset space ~ \end_inset -output + +\end_layout + +\begin_layout Standard +\SpecialChar LyX + doesn't stop you using bullets from packages you don't have. + If you get errors from \SpecialChar LaTeX + when you try to view or print the file, then it + is likely you are missing a package. +\begin_inset Foot +status collapsed + +\begin_layout Plain Layout +\SpecialChar LyX + doesn't restrict your use since you may be editing locally and exporting + elsewhere. \end_layout \end_inset - checkbox typesets a mark to unambiguously define the presence of a space. - + \end_layout -\begin_layout Standard -Generally, the master file is converted into a full \SpecialChar LaTeX - file before typesetting, - while the included files are converted to \SpecialChar LaTeX - files that do not have all the - preamble information. +\begin_layout Section +How to use it \end_layout -\begin_layout Subsection -Cross-References Between Files +\begin_layout Standard +Select which bullet depth you want to change then select the bullet shape + and size. + Any changes will not be visible in \SpecialChar LyX +, but are visible when viewing the document. \end_layout \begin_layout Standard -\begin_inset Box Shadowbox -position "t" -hor_pos "c" -has_inner_box 1 -inner_pos "t" -use_parbox 0 -use_makebox 0 -width "100col%" -special "none" -height "1in" -height_special "totalheight" -thickness "0.4pt" -separation "3pt" -shadowsize "4pt" -framecolor "black" -backgroundcolor "none" +You can reset a bullet shape to the default simply by clicking your right + mouse button on the appropriate bullet depth button. +\begin_inset Foot status open \begin_layout Plain Layout -This section is somewhat out of date. - Need to describe default master documents and how children are opened when - the master is. - [[FIXME]] +If you +\emph on +really +\emph default + want to have multiple sets of paragraphs with different sets of bullets + in each, then you're going to have to get your hands dirty with \SpecialChar TeX + code. + The bullet selection dialog can help though because it provides you with + the \SpecialChar LaTeX + code for a wide range of bullet shapes. + To make your own custom paragraphs you have the following options: \end_layout -\end_inset +\begin_layout Plain Layout +\begin_inset ERT +status open + +\begin_layout Plain Layout +\backslash +let +\backslash +savelabelitemi= +\backslash +labelitemi \end_layout -\begin_layout Standard -It is possible to set up cross-references between the different files. - First, open all the files in question: let's call them A and B in a two - file example, where B is included in A. - Let's say you insert a label in A, then want to reference it in B. - Open the cross-reference dialog whilst in document B, and you can select - the -\begin_inset Quotes eld \end_inset -buffer -\begin_inset Quotes erd + +\end_layout + +\begin_layout Plain Layout +\begin_inset ERT +status open + +\begin_layout Plain Layout + + +\backslash +renewcommand +\backslash +labelitemi[0]{ +\backslash +small +\backslash +( +\backslash +sharp +\backslash +)} +\end_layout + \end_inset - to use. + \end_layout -\begin_layout Subsection -Bibliography Lists in all Subdocuments +\begin_layout Itemize +Use the \SpecialChar LaTeX + command +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout + +\backslash +renewcommand{}{} +\end_layout + +\end_inset + + to specify a new bullet shape for a given depth. + You'll also need to save the current bullet shape so you can restore it + again afterwards. + In this itemized list the following \SpecialChar LaTeX + code was used to change the bullet + used for the first depth. \end_layout -\begin_layout Standard -If you work with child documents, you might want to have only one main bibliogra -phy at the end, but still be able to have a selected bibliography for the - child if you output it on its own. - Here is how to achieve this. -\end_layout +\begin_deeper +\begin_layout LyX-Code -\begin_layout Standard -For the main document, you just insert a bibliography inset at the place - where the main bibliography has to appear (within the master file or within - a child). - If the bibliography inset is in the master file, the references will be - inherited by all children, so they are available in the citation dialog - within each child. +\backslash +let +\backslash +savelabelitemi= +\backslash +labelitemi \end_layout -\begin_layout Standard -For child-specific bibliographies, insert bibliography insets within the - child documents, at the place where the bibliography should appear when - the child is compiled separately. - However, the trick is to insert them into a branch ( -\family sans -Insert\SpecialChar menuseparator -Branch\SpecialChar menuseparator -Insert New Branch... -\family default -), e. -\begin_inset space \thinspace{} -\end_inset +\begin_layout LyX-Code -g. - called -\begin_inset Quotes eld -\end_inset +\backslash +renewcommand +\backslash +labelitemi[0]{ +\backslash +small +\backslash +( +\backslash +sharp +\backslash +)} +\end_layout -Childonly -\begin_inset Quotes erd -\end_inset +\end_deeper +\begin_layout Itemize +Note that the itemize depth is specified in Roman numerals as part of the + +\family typewriter -. - Within the children, activate the branch ( -\family sans -Document\SpecialChar menuseparator -Settings...\SpecialChar menuseparator -Branches -\family default -). - Within the master, deactivate the branch ( -\family sans -Document\SpecialChar menuseparator -Settings...\SpecialChar menuseparator -Branches +\backslash +labelitem \family default -). - Now the child's bibliography will be ignored by the master, but considered - by the child. + command. \end_layout -\begin_layout Standard -If you need multiple bibliographies (e. -\begin_inset space \thinspace{} -\end_inset +\begin_layout Itemize +\begin_inset Argument item:1 +status open -g., one per child in the -\emph on -main document -\emph default -), please refer to sec. -\begin_inset space ~ -\end_inset +\begin_layout Plain Layout +\begin_inset ERT +status open +\begin_layout Plain Layout -\begin_inset CommandInset ref -LatexCommand ref -reference "subsec:Multiple-Bibliographies" + +\backslash +( +\backslash +star +\backslash +) +\end_layout \end_inset -. -\end_layout -\begin_layout Section -\SpecialChar LyX - Archives \end_layout -\begin_layout Standard -Users sometimes need to be able to +\end_inset + + Specify each individual entry by starting each item with the bullet shape + enclosed in a \begin_inset Quotes eld \end_inset -bundle +Custom Item \begin_inset Quotes erd \end_inset - a \SpecialChar LyX - file together with all the images (and other files) on which it depends, - either for sending to a publisher or for sharing with a co-author. - \SpecialChar LyX - includes a Python script ( -\begin_inset Flex Code + inset (available at +\family sans +Insert\SpecialChar menuseparator +Custom Item +\family default +) and set as +\begin_inset Flex Noun status collapsed \begin_layout Plain Layout -lyxpak.py +\SpecialChar TeX + Code \end_layout \end_inset -) that automates this process. - To use it, you must have either the +. + For example, this item was started with \begin_inset Flex Code status collapsed \begin_layout Plain Layout -zipfile + +\backslash +( +\backslash +star +\backslash +) \end_layout \end_inset - or -\begin_inset Flex Code -status collapsed +. +\end_layout \begin_layout Plain Layout -tarfile -\end_layout +\begin_inset ERT +status open -\end_inset +\begin_layout Plain Layout - python modules installed on your system. - By default, the script prefers the -\begin_inset Flex Code -status collapsed -\begin_layout Plain Layout -gzip +\backslash +renewcommand +\backslash +labelitemi[0]{ +\backslash +savelabelitemi} \end_layout \end_inset --compressed -\begin_inset Flex Code -status collapsed -\begin_layout Plain Layout -tar \end_layout -\end_inset +\begin_layout Plain Layout +You'll also need to revert the labelitem back to its previous setting for + the global bullet shape settings to remain in effect. + The way used here was: +\end_layout - format on Unix-like systems and the -\begin_inset Flex Code -status collapsed +\begin_layout LyX-Code -\begin_layout Plain Layout -zip +\backslash +renewcommand +\backslash +labelitemi[0]{ +\backslash +savelabelitemi} \end_layout \end_inset - format on Windows. -\end_layout -\begin_layout Standard -\SpecialChar LyX -'s configuration process will set the script up to export a `\SpecialChar LyX - Archive', - and this format will then be available under -\begin_inset Flex Code -status collapsed +\end_layout -\begin_layout Plain Layout -File\SpecialChar menuseparator -Export +\begin_layout Chapter +Supplemental Tools \end_layout -\end_inset +\begin_layout Section +Multipart Documents +\end_layout -. +\begin_layout Subsection +General Operation \end_layout \begin_layout Standard -Independently of the platform, the generation of a particular archive format - can be forced by adding either the -\begin_inset Flex Code -status collapsed +When you are working on a large file with many sections, it is often convenient + to break up the document into several files, or perhaps you have something + where a table may change from time to time, but the preceding text does + not. + In these cases, you should seriously consider using multipart documents. + For example, scientific papers often have five major sections: the introduction +, observations, results, discussion, and conclusion. + Each of these could be its own separate \SpecialChar LyX + file, with one +\begin_inset Quotes eld +\end_inset -\begin_layout Plain Layout --t -\end_layout +master +\begin_inset Quotes erd +\end_inset + file which contains the title, authors, abstract, references, etc., plus + the five included files. + It is important to note that each of these files is a full \SpecialChar LyX + file which + can be formatted and printed on its own, as well as included in a master + file. + Each of these files must have the same document class, however—don't attempt + to mix book classes with article classes. + You may also include \SpecialChar LaTeX + files; however, these files must not have their own + preamble (i. +\begin_inset space \thinspace{} +\end_inset + +e. +\begin_inset space \space{} \end_inset - (for the +everything up to and including the \begin_inset Flex Code status collapsed \begin_layout Plain Layout -tar + +\backslash +begin{document} \end_layout \end_inset - format) or + line as well as the \begin_inset Flex Code status collapsed \begin_layout Plain Layout --z + +\backslash +end{document} \end_layout \end_inset - (for the -\begin_inset Flex Code -status collapsed - -\begin_layout Plain Layout -zip + line must be deleted) or else errors will be generated when you try to + make a DVI file. \end_layout -\end_inset - - format) switch to the -\begin_inset Flex Code +\begin_layout Standard +\SpecialChar LyX + allows you to include files quite easily with +\begin_inset Flex Noun status collapsed \begin_layout Plain Layout -\SpecialChar LyX -\SpecialChar menuseparator -\SpecialChar LyX - Archive -\end_layout - +Insert\SpecialChar menuseparator +Child +\begin_inset space ~ \end_inset - converter in -\begin_inset Flex Code -status collapsed - -\begin_layout Plain Layout -Tools\SpecialChar menuseparator -Preferences\SpecialChar menuseparator -File Handling\SpecialChar menuseparator -Converters +Document \end_layout \end_inset . - (Make sure you add the switch after the script name, not before it.) -\end_layout - -\begin_layout Section -Fancy Headers and Footers + When you click on this selection a small box is inserted into the file + at the current cursor location. + Clicking on the box raises a dialog which allows you to select the file + to be included, and the method of its inclusion. + \end_layout \begin_layout Standard -The default page layout is rather plain; for an -\begin_inset Flex Code -status collapsed +The file selection box should by now be obvious. + The three inclusion methods are +\begin_inset Quotes eld +\end_inset -\begin_layout Plain Layout -article -\end_layout +include +\begin_inset Quotes erd +\end_inset +, +\begin_inset Quotes eld \end_inset - document class, all you get is a centered page number at the bottom of - the page. - This document uses KOMA-script's book class, so it appears to be a bit - fancier. - But to really put on a show, you need to set the document page style to - +input +\begin_inset Quotes erd +\end_inset + +, and \begin_inset Quotes eld \end_inset -fancy +verbatim \begin_inset Quotes erd \end_inset -, as mentioned in the -\emph on -User Guide -\emph default . - This section describes the \SpecialChar LaTeX - code you need to insert in your \SpecialChar LaTeX - preamble in - order to get the desired effects. -\end_layout + The methods +\begin_inset Quotes eld +\end_inset -\begin_layout Standard -For more information on fancy headers, see the -\begin_inset Flex Code -status collapsed +include +\begin_inset Quotes erd +\end_inset -\begin_layout Plain Layout -fancyhdr -\end_layout + and +\begin_inset Quotes eld +\end_inset +input +\begin_inset Quotes erd \end_inset - package documentation. - ( -\begin_inset Flex URL -status collapsed + are similar in many ways, but there are also some notable differences: +\end_layout -\begin_layout Plain Layout +\begin_layout Enumerate +Files that are +\begin_inset Quotes eld +\end_inset -https://www.ctan.org/tex-archive/help/Catalogue/entries/fancyhdr.html -\end_layout +included +\begin_inset Quotes erd +\end_inset + are typeset beginning on a new page, while files that are +\begin_inset Quotes eld \end_inset -) +inputted +\begin_inset Quotes erd +\end_inset + + are typeset starting on the current page. \end_layout -\begin_layout Standard -The page header is divided into three fields, not surprisingly labeled +\begin_layout Enumerate \begin_inset Quotes eld \end_inset -left +Included \begin_inset Quotes erd \end_inset -, + files cannot themselves \begin_inset Quotes eld \end_inset -center +include \begin_inset Quotes erd \end_inset -, and + further files ( \begin_inset Quotes eld \end_inset -right +grandchilds \begin_inset Quotes erd \end_inset -. - The footer is also divided into these three fields. - The \SpecialChar LaTeX - commands to set these fields in the simplest manner are -\begin_inset Flex Code -status collapsed +). + With +\begin_inset Quotes eld +\end_inset -\begin_layout Plain Layout +input +\begin_inset Quotes erd +\end_inset -\backslash -lhead +, on the other hand, infinite sub-inputting is possible. \end_layout +\begin_layout Enumerate +\begin_inset Quotes eld \end_inset -, -\begin_inset Flex Code -status collapsed - -\begin_layout Plain Layout +Include +\begin_inset Quotes erd +\end_inset -\backslash -chead -\end_layout + allow for the output of only selected +\begin_inset Quotes eld +\end_inset +included +\begin_inset Quotes erd \end_inset -, -\begin_inset Flex Code -status collapsed + files, while maintaining the actual counters (pagination etc.) and references + (please refer to the section +\emph on +Child +\begin_inset space ~ +\end_inset -\begin_layout Plain Layout +Documents +\emph default + of the +\emph on +Embedded +\begin_inset space ~ +\end_inset -\backslash -rhead +Objects +\emph default + manual for details). \end_layout +\begin_layout Standard +Hence, +\begin_inset Quotes eld \end_inset -, -\begin_inset Flex Code -status collapsed - -\begin_layout Plain Layout +include +\begin_inset Quotes erd +\end_inset -\backslash -lfoot -\end_layout + is the preferred method for chapters that are outsourced to child documents, + while +\begin_inset Quotes eld +\end_inset +input +\begin_inset Quotes erd \end_inset -, etc. - Suppose you wish to put your name in the upper left hand corner of each - page. - Simply insert the following command in the preamble: + is more suitable for arbitrary file inheritance. \end_layout \begin_layout Standard +A +\begin_inset Quotes eld +\end_inset -\family typewriter - -\backslash -lhead{John Q. - DocWriter} -\end_layout +verbatim +\begin_inset Quotes erd +\end_inset -\begin_layout Standard -You will now see your name in the upper left. - If a field has a default entry that you would like to get rid of (often - the page number appears in the central footer) simply include a command - with a blank argument, e. + included file allows you to include a file typeset exactly as it appears + in the file, i. \begin_inset space \thinspace{} \end_inset -g.: -\end_layout - -\begin_layout Standard +e. +\begin_inset space \space{} +\end_inset -\family typewriter +in +\begin_inset Flex Code +status collapsed -\backslash -cfoot{} +\begin_layout Plain Layout +verbatim \end_layout -\begin_layout Standard -Let's get really fancy: lets put the section number with the word -\begin_inset Quotes eld \end_inset -Section -\begin_inset Quotes erd -\end_inset + mode, with the characters set in a fixed-width typewriter font. + Normally, spaces in this file are invisible, though two consecutive spaces + are conserved, unlike \SpecialChar LyX +'s normal treatment of spaces. + However, setting the +\begin_inset Flex Noun +status collapsed - (e. -\begin_inset space \thinspace{} +\begin_layout Plain Layout +Mark +\begin_inset space ~ \end_inset -g. -\begin_inset space \space{} +spaces +\begin_inset space ~ \end_inset -Section 3) in the upper left, the page number (e. -\begin_inset space \thinspace{} +in +\begin_inset space ~ \end_inset -g. -\begin_inset space \space{} +output +\end_layout + \end_inset -Page 4) in the upper right, your name in the lower left, and the date in - the lower right. - The following commands should now appear in the preamble: + checkbox typesets a mark to unambiguously define the presence of a space. + \end_layout \begin_layout Standard +Generally, the master file is converted into a full \SpecialChar LaTeX + file before typesetting, + while the included files are converted to \SpecialChar LaTeX + files that do not have all the + preamble information. +\end_layout -\family typewriter - -\backslash -lhead{Section -\backslash -thesection} +\begin_layout Subsection +Cross-References Between Files \end_layout \begin_layout Standard +\begin_inset Box Shadowbox +position "t" +hor_pos "c" +has_inner_box 1 +inner_pos "t" +use_parbox 0 +use_makebox 0 +width "100col%" +special "none" +height "1in" +height_special "totalheight" +thickness "0.4pt" +separation "3pt" +shadowsize "4pt" +framecolor "black" +backgroundcolor "none" +status open -\family typewriter - -\backslash -chead{} +\begin_layout Plain Layout +This section is somewhat out of date. + Need to describe default master documents and how children are opened when + the master is. + [[FIXME]] \end_layout -\begin_layout Standard +\end_inset -\family typewriter -\backslash -rhead{Page -\backslash -thepage} \end_layout \begin_layout Standard +It is possible to set up cross-references between the different files. + First, open all the files in question: let's call them A and B in a two + file example, where B is included in A. + Let's say you insert a label in A, then want to reference it in B. + Open the cross-reference dialog whilst in document B, and you can select + the +\begin_inset Quotes eld +\end_inset -\family typewriter +buffer +\begin_inset Quotes erd +\end_inset -\backslash -lfoot{John Q. - DocWriter} + to use. \end_layout -\begin_layout Standard - -\family typewriter - -\backslash -cfoot{} +\begin_layout Subsection +Bibliography Lists in all Subdocuments \end_layout \begin_layout Standard - -\family typewriter - -\backslash -rfoot{ -\backslash -today} +If you work with child documents, you might want to have only one main bibliogra +phy at the end, but still be able to have a selected bibliography for the + child if you output it on its own. + Here is how to achieve this. \end_layout \begin_layout Standard -The commands -\begin_inset Flex Code -status collapsed - -\begin_layout Plain Layout - -\backslash -thesection +For the main document, you just insert a bibliography inset at the place + where the main bibliography has to appear (within the master file or within + a child). + If the bibliography inset is in the master file, the references will be + inherited by all children, so they are available in the citation dialog + within each child. \end_layout +\begin_layout Standard +For child-specific bibliographies, insert bibliography insets within the + child documents, at the place where the bibliography should appear when + the child is compiled separately. + However, the trick is to insert them into a branch ( +\family sans +Insert\SpecialChar menuseparator +Branch\SpecialChar menuseparator +Insert New Branch... +\family default +), e. +\begin_inset space \thinspace{} \end_inset - and -\begin_inset Flex Code -status collapsed +g. + called +\begin_inset Quotes eld +\end_inset -\begin_layout Plain Layout +Childonly +\begin_inset Quotes erd +\end_inset -\backslash -thepage +. + Within the children, activate the branch ( +\family sans +Document\SpecialChar menuseparator +Settings...\SpecialChar menuseparator +Branches +\family default +). + Within the master, deactivate the branch ( +\family sans +Document\SpecialChar menuseparator +Settings...\SpecialChar menuseparator +Branches +\family default +). + Now the child's bibliography will be ignored by the master, but considered + by the child. \end_layout +\begin_layout Standard +If you need multiple bibliographies (e. +\begin_inset space \thinspace{} \end_inset - access \SpecialChar LaTeX -'s section and page counters, and so print out the current section - and page number. - -\begin_inset Flex Code -status collapsed +g., one per child in the +\emph on +main document +\emph default +), please refer to sec. +\begin_inset space ~ +\end_inset -\begin_layout Plain Layout -\backslash -today -\end_layout +\begin_inset CommandInset ref +LatexCommand ref +reference "subsec:Multiple-Bibliographies" \end_inset - simply prints out today's date. +. \end_layout -\begin_layout Standard -The thicknesses of the horizontal rules drawn beneath the header and above - the footer can also be modified. - If you don't want one of the rules, set its thickness to 0. - The header rule has a default thickness of 0.4pt, the footer rule is 0pt. - Use commands -\family typewriter - -\family default -like -\begin_inset Flex Code -status collapsed - -\begin_layout Plain Layout - -\backslash -renewcommand{ -\backslash -headrulewidth}{0.4pt} +\begin_layout Section +\SpecialChar LyX + Archives \end_layout +\begin_layout Standard +Users sometimes need to be able to +\begin_inset Quotes eld +\end_inset + +bundle +\begin_inset Quotes erd \end_inset - and + a \SpecialChar LyX + file together with all the images (and other files) on which it depends, + either for sending to a publisher or for sharing with a co-author. + \SpecialChar LyX + includes a Python script ( \begin_inset Flex Code status collapsed \begin_layout Plain Layout - -\backslash -renewcommand{ -\backslash -footrulewidth}{0.4pt} +lyxpak.py \end_layout \end_inset - to set the thicknesses. -\end_layout - -\begin_layout Standard -You can switch the header/footer settings on and off for individual pages - using commands like +) that automates this process. + To use it, you must have either the \begin_inset Flex Code status collapsed \begin_layout Plain Layout - -\backslash -thispagestyle{empty} +zipfile \end_layout \end_inset -, + or \begin_inset Flex Code status collapsed \begin_layout Plain Layout - -\backslash -thispagestyle{plain} +tarfile \end_layout \end_inset -, and + python modules installed on your system. + By default, the script prefers the \begin_inset Flex Code status collapsed \begin_layout Plain Layout - -\backslash -thispagestyle{fancy} +gzip \end_layout \end_inset -. - Simply insert them in the text on the page you want changed and mark them - as \SpecialChar TeX - code. - In fact, title pages are marked as plain by default, while following pages - are marked fancy when using the global fancy setting. -\end_layout +-compressed +\begin_inset Flex Code +status collapsed -\begin_layout Standard -As a final example, it is possible to include an image in the header or - footer. - Suppose you want to put a company logo in the upper lefthand corner. - You might try something like +\begin_layout Plain Layout +tar \end_layout -\begin_layout Standard - -\family typewriter - -\backslash -lhead{ -\backslash -resizebox{1in}{!}{ -\backslash -includegraphics{logo.eps}}} -\end_layout +\end_inset -\begin_layout Standard -\noindent -(you may need to preface this with + format on Unix-like systems and the \begin_inset Flex Code status collapsed \begin_layout Plain Layout - -\backslash -usepackage{graphics} +zip \end_layout \end_inset - if you don't include graphics elsewhere in your document). + format on Windows. \end_layout -\begin_layout Section -Itemize Bullet Selection -\begin_inset CommandInset label -LatexCommand label -name "sec:bullet" - -\end_inset - +\begin_layout Standard +\SpecialChar LyX +'s configuration process will set the script up to export a `\SpecialChar LyX + Archive', + and this format will then be available under +\begin_inset Flex Code +status collapsed +\begin_layout Plain Layout +File\SpecialChar menuseparator +Export \end_layout -\begin_layout Standard -by -\noun on - Allan Rae -\end_layout +\end_inset -\begin_layout Subsection -Introduction +. \end_layout \begin_layout Standard -\SpecialChar LyX - provides 216 bullet shapes that can be accessed from a simple dialog. - Using this dialog you can easily specify what bullet shape to use at each - level of an itemized list. - These settings are document-wide so you won't be able to specify different - sets of bullets for different paragraphs. -\begin_inset Foot +Independently of the platform, the generation of a particular archive format + can be forced by adding either the +\begin_inset Flex Code status collapsed \begin_layout Plain Layout -Well, actually you can but you'll have to do it by hand. +-t \end_layout \end_inset + (for the +\begin_inset Flex Code +status collapsed +\begin_layout Plain Layout +tar \end_layout -\begin_layout Subsection -How it looks -\end_layout +\end_inset -\begin_layout Standard -Open the dialog by selecting the -\begin_inset Flex Noun + format) or +\begin_inset Flex Code status collapsed \begin_layout Plain Layout -Document\SpecialChar menuseparator -Settings +-z \end_layout \end_inset - menu item and then select the -\begin_inset Flex Noun + (for the +\begin_inset Flex Code status collapsed \begin_layout Plain Layout -Bullets +zip \end_layout \end_inset - tab. -\end_layout - -\begin_layout Standard -The dialog provides you with a table of bullet shapes. - A column of buttons on the left of the table provides access to the six - different panels of bullet shapes. - The row of buttons across the top is used to select which bullet depth - you are changing. - -\change_deleted 244031559 1603875981 - A text entry under the table shows the currently selected bullet shape's - \SpecialChar LaTeX - equivalent and this can be edited if desired. - If you do modify the text you will also need to specify any needed packages - in the \SpecialChar LaTeX - preamble. -\change_unchanged + format) switch to the +\begin_inset Flex Code +status collapsed +\begin_layout Plain Layout +\SpecialChar LyX +\SpecialChar menuseparator +\SpecialChar LyX + Archive \end_layout -\begin_layout Standard -The six panels are divided up by the packages they require. - The following table shows the mappings from button name to \SpecialChar LaTeX - package. -\end_layout +\end_inset -\begin_layout Standard -\align center -\begin_inset Tabular - - - - - - -\begin_inset Text + converter in +\begin_inset Flex Code +status collapsed \begin_layout Plain Layout - -\family roman -\series medium -\shape up -\size normal -\emph off -\bar no -\noun off -\color none -Button +Tools\SpecialChar menuseparator +Preferences\SpecialChar menuseparator +File Handling\SpecialChar menuseparator +Converters \end_layout \end_inset - - -\begin_inset Text -\begin_layout Plain Layout +. + (Make sure you add the switch after the script name, not before it.) +\end_layout -\family roman -\series medium -\shape up -\size normal -\emph off -\bar no -\noun off -\color none -Packages Required +\begin_layout Section +Fancy Headers and Footers \end_layout -\end_inset - - - - -\begin_inset Text +\begin_layout Standard +The default page layout is rather plain; for an +\begin_inset Flex Code +status collapsed \begin_layout Plain Layout - -\family sans -\series medium -\shape up -\size normal -\emph off -\bar no -\noun off -\color none -Standard +article \end_layout \end_inset - - -\begin_inset Text -\begin_layout Plain Layout + document class, all you get is a centered page number at the bottom of + the page. + This document uses KOMA-script's book class, so it appears to be a bit + fancier. + But to really put on a show, you need to set the document page style to + +\begin_inset Quotes eld +\end_inset -\series medium -\shape up -\size normal -\emph off -\bar no -\noun off -\color none -base \SpecialChar LaTeX +fancy +\begin_inset Quotes erd +\end_inset +, as mentioned in the +\emph on +User Guide +\emph default +. + This section describes the \SpecialChar LaTeX + code you need to insert in your \SpecialChar LaTeX + preamble in + order to get the desired effects. \end_layout -\end_inset - - - - -\begin_inset Text +\begin_layout Standard +For more information on fancy headers, see the +\begin_inset Flex Code +status collapsed \begin_layout Plain Layout - -\family sans -\series medium -\shape up -\size normal -\emph off -\bar no -\noun off -\color none -Maths +fancyhdr \end_layout \end_inset - - -\begin_inset Text + + package documentation. + ( +\begin_inset Flex URL +status collapsed \begin_layout Plain Layout -\family typewriter -\series medium -\shape up -\size normal -\emph off -\bar no -\noun off -\color none -amssymb.sty +https://www.ctan.org/tex-archive/help/Catalogue/entries/fancyhdr.html \end_layout \end_inset - - - - -\begin_inset Text -\begin_layout Plain Layout - -\family sans -\series medium -\shape up -\size normal -\emph off -\bar no -\noun off -\color none -Ding1 +) \end_layout +\begin_layout Standard +The page header is divided into three fields, not surprisingly labeled +\begin_inset Quotes eld \end_inset - - -\begin_inset Text - -\begin_layout Plain Layout -\family typewriter -\series medium -\shape up -\size normal -\emph off -\bar no -\noun off -\color none -pifont.sty -\end_layout +left +\begin_inset Quotes erd +\end_inset +, +\begin_inset Quotes eld \end_inset - - - - -\begin_inset Text -\begin_layout Plain Layout +center +\begin_inset Quotes erd +\end_inset -\family sans -\series medium -\shape up -\size normal -\emph off -\bar no -\noun off -\color none -Ding2 -\end_layout +, and +\begin_inset Quotes eld +\end_inset +right +\begin_inset Quotes erd \end_inset - - -\begin_inset Text + +. + The footer is also divided into these three fields. + The \SpecialChar LaTeX + commands to set these fields in the simplest manner are +\begin_inset Flex Code +status collapsed \begin_layout Plain Layout -\family typewriter -\series medium -\shape up -\size normal -\emph off -\bar no -\noun off -\color none -pifont.sty +\backslash +lhead \end_layout \end_inset - - - - -\begin_inset Text + +, +\begin_inset Flex Code +status collapsed \begin_layout Plain Layout -\family sans -\series medium -\shape up -\size normal -\emph off -\bar no -\noun off -\color none -Ding3 +\backslash +chead \end_layout \end_inset - - -\begin_inset Text + +, +\begin_inset Flex Code +status collapsed \begin_layout Plain Layout -\family typewriter -\series medium -\shape up -\size normal -\emph off -\bar no -\noun off -\color none -pifont.sty +\backslash +rhead \end_layout \end_inset - - - - -\begin_inset Text + +, +\begin_inset Flex Code +status collapsed \begin_layout Plain Layout -\family sans -\series medium -\shape up -\size normal -\emph off -\bar no -\noun off -\color none -Ding4 +\backslash +lfoot \end_layout \end_inset - - -\begin_inset Text -\begin_layout Plain Layout +, etc. + Suppose you wish to put your name in the upper left hand corner of each + page. + Simply insert the following command in the preamble: +\end_layout + +\begin_layout Standard \family typewriter -\series medium -\shape up -\size normal -\emph off -\bar no -\noun off -\color none -pifont.sty + +\backslash +lhead{John Q. + DocWriter} \end_layout +\begin_layout Standard +You will now see your name in the upper left. + If a field has a default entry that you would like to get rid of (often + the page number appears in the central footer) simply include a command + with a blank argument, e. +\begin_inset space \thinspace{} \end_inset - - - -\end_inset +g.: +\end_layout + +\begin_layout Standard +\family typewriter +\backslash +cfoot{} \end_layout \begin_layout Standard -\SpecialChar LyX - doesn't stop you using bullets from packages you don't have. - If you get errors from \SpecialChar LaTeX - when you try to view or print the file, then it - is likely you are missing a package. -\begin_inset Foot -status collapsed +Let's get really fancy: lets put the section number with the word +\begin_inset Quotes eld +\end_inset -\begin_layout Plain Layout -\SpecialChar LyX - doesn't restrict your use since you may be editing locally and exporting - elsewhere. -\end_layout +Section +\begin_inset Quotes erd +\end_inset + + (e. +\begin_inset space \thinspace{} +\end_inset + +g. +\begin_inset space \space{} +\end_inset +Section 3) in the upper left, the page number (e. +\begin_inset space \thinspace{} \end_inset +g. +\begin_inset space \space{} +\end_inset +Page 4) in the upper right, your name in the lower left, and the date in + the lower right. + The following commands should now appear in the preamble: \end_layout -\begin_layout Subsection -How to use it +\begin_layout Standard + +\family typewriter + +\backslash +lhead{Section +\backslash +thesection} \end_layout \begin_layout Standard -Select which bullet depth you want to change then select the bullet shape - and size. - Any changes will not be visible in \SpecialChar LyX -, but are visible when viewing the document. -\end_layout -\begin_layout Standard -You can reset a bullet shape to the default simply by clicking your right - mouse button on the appropriate bullet depth button. -\begin_inset Foot -status open +\family typewriter -\begin_layout Plain Layout -If you -\emph on -really -\emph default - want to have multiple sets of paragraphs with different sets of bullets - in each, then you're going to have to get your hands dirty with \SpecialChar TeX - code. - The bullet selection dialog can help though because it provides you with - the \SpecialChar LaTeX - code for a wide range of bullet shapes. - To make your own custom paragraphs you have the following options: +\backslash +chead{} \end_layout -\begin_layout Plain Layout -\begin_inset ERT -status open - -\begin_layout Plain Layout +\begin_layout Standard +\family typewriter \backslash -let -\backslash -savelabelitemi= +rhead{Page \backslash -labelitemi +thepage} \end_layout -\end_inset +\begin_layout Standard +\family typewriter +\backslash +lfoot{John Q. + DocWriter} \end_layout -\begin_layout Plain Layout -\begin_inset ERT -status open - -\begin_layout Plain Layout +\begin_layout Standard +\family typewriter \backslash -renewcommand -\backslash -labelitemi[0]{ -\backslash -small -\backslash -( +cfoot{} +\end_layout + +\begin_layout Standard + +\family typewriter + \backslash -sharp +rfoot{ \backslash -)} +today} \end_layout -\end_inset +\begin_layout Standard +The commands +\begin_inset Flex Code +status collapsed +\begin_layout Plain Layout +\backslash +thesection \end_layout -\begin_layout Itemize -Use the \SpecialChar LaTeX - command +\end_inset + + and \begin_inset Flex Code status collapsed \begin_layout Plain Layout \backslash -renewcommand{}{} +thepage \end_layout \end_inset - to specify a new bullet shape for a given depth. - You'll also need to save the current bullet shape so you can restore it - again afterwards. - In this itemized list the following \SpecialChar LaTeX - code was used to change the bullet - used for the first depth. -\end_layout + access \SpecialChar LaTeX +'s section and page counters, and so print out the current section + and page number. + +\begin_inset Flex Code +status collapsed -\begin_deeper -\begin_layout LyX-Code +\begin_layout Plain Layout \backslash -let -\backslash -savelabelitemi= -\backslash -labelitemi +today \end_layout -\begin_layout LyX-Code +\end_inset -\backslash -renewcommand -\backslash -labelitemi[0]{ -\backslash -small -\backslash -( -\backslash -sharp -\backslash -)} + simply prints out today's date. \end_layout -\end_deeper -\begin_layout Itemize -Note that the itemize depth is specified in Roman numerals as part of the - +\begin_layout Standard +The thicknesses of the horizontal rules drawn beneath the header and above + the footer can also be modified. + If you don't want one of the rules, set its thickness to 0. + The header rule has a default thickness of 0.4pt, the footer rule is 0pt. + Use commands \family typewriter + +\family default +like +\begin_inset Flex Code +status collapsed + +\begin_layout Plain Layout \backslash -labelitem -\family default - command. +renewcommand{ +\backslash +headrulewidth}{0.4pt} \end_layout -\begin_layout Itemize -\begin_inset Argument item:1 -status open +\end_inset -\begin_layout Plain Layout -\begin_inset ERT -status open + and +\begin_inset Flex Code +status collapsed \begin_layout Plain Layout - -\backslash -( \backslash -star +renewcommand{ \backslash -) +footrulewidth}{0.4pt} \end_layout \end_inset - + to set the thicknesses. \end_layout -\end_inset +\begin_layout Standard +You can switch the header/footer settings on and off for individual pages + using commands like +\begin_inset Flex Code +status collapsed - Specify each individual entry by starting each item with the bullet shape - enclosed in a -\begin_inset Quotes eld -\end_inset +\begin_layout Plain Layout + +\backslash +thispagestyle{empty} +\end_layout -Custom Item -\begin_inset Quotes erd \end_inset - inset (available at -\family sans -Insert\SpecialChar menuseparator -Custom Item -\family default -) and set as -\begin_inset Flex Noun +, +\begin_inset Flex Code status collapsed \begin_layout Plain Layout -\SpecialChar TeX - Code + +\backslash +thispagestyle{plain} \end_layout \end_inset -. - For example, this item was started with +, and \begin_inset Flex Code status collapsed \begin_layout Plain Layout \backslash -( -\backslash -star -\backslash -) +thispagestyle{fancy} \end_layout \end_inset . + Simply insert them in the text on the page you want changed and mark them + as \SpecialChar TeX + code. + In fact, title pages are marked as plain by default, while following pages + are marked fancy when using the global fancy setting. \end_layout -\begin_layout Plain Layout -\begin_inset ERT -status open +\begin_layout Standard +As a final example, it is possible to include an image in the header or + footer. + Suppose you want to put a company logo in the upper lefthand corner. + You might try something like +\end_layout -\begin_layout Plain Layout +\begin_layout Standard +\family typewriter \backslash -renewcommand +lhead{ \backslash -labelitemi[0]{ +resizebox{1in}{!}{ \backslash -savelabelitemi} +includegraphics{logo.eps}}} \end_layout -\end_inset - - -\end_layout +\begin_layout Standard +\noindent +(you may need to preface this with +\begin_inset Flex Code +status collapsed \begin_layout Plain Layout -You'll also need to revert the labelitem back to its previous setting for - the global bullet shape settings to remain in effect. - The way used here was: -\end_layout - -\begin_layout LyX-Code \backslash -renewcommand -\backslash -labelitemi[0]{ -\backslash -savelabelitemi} +usepackage{graphics} \end_layout \end_inset - + if you don't include graphics elsewhere in your document). \end_layout \begin_layout Chapter @@ -28820,10 +28854,14 @@ Specific Manuals \end_layout \begin_layout Chapter + +\change_deleted 564990737 1671355343 Special features \end_layout \begin_layout Standard + +\change_deleted 564990737 1671355343 You can do everything with \SpecialChar LyX that you can do with \SpecialChar LaTeX . @@ -28843,6 +28881,8 @@ Embedded Objects \emph default manual. +\change_unchanged + \end_layout \end_body