From e1fc687f079814fdc163b3824153316f9805b671 Mon Sep 17 00:00:00 2001 From: Juergen Spitzmueller Date: Fri, 28 Jul 2017 09:49:40 +0200 Subject: [PATCH] Improve and fix description of multipart documents. --- lib/doc/Additional.lyx | 268 ++++++++++++++++++++++++++++++++++++++++- 1 file changed, 263 insertions(+), 5 deletions(-) diff --git a/lib/doc/Additional.lyx b/lib/doc/Additional.lyx index 49e62b0f99..7e6e576bfc 100644 --- a/lib/doc/Additional.lyx +++ b/lib/doc/Additional.lyx @@ -3025,6 +3025,17 @@ Subdivided Bibliographies \begin_layout Subsection Multiple Bibliographies +\change_inserted -712698321 1501227893 + +\begin_inset CommandInset label +LatexCommand label +name "subsec:Multiple-Bibliographies" + +\end_inset + + +\change_unchanged + \end_layout \begin_layout Standard @@ -3568,7 +3579,13 @@ verbatim \end_inset . - The difference between + The +\change_deleted -712698321 1501225702 +difference between +\change_inserted -712698321 1501225703 +methods +\change_unchanged + \begin_inset Quotes eld \end_inset @@ -3584,9 +3601,22 @@ input \begin_inset Quotes erd \end_inset - is really only meaningful to \SpecialChar LaTeX -perts, but the practical difference is that - files that are + +\change_deleted -712698321 1501225710 +is really only meaningful to \SpecialChar LaTeX +perts +\change_inserted -712698321 1501225747 +are similar in many ways, but there are also some notable differences: +\end_layout + +\begin_layout Enumerate + +\change_deleted -712698321 1501225754 +, but the practical difference is that f +\change_inserted -712698321 1501225754 +F +\change_unchanged +iles that are \begin_inset Quotes eld \end_inset @@ -3603,14 +3633,121 @@ inputted \end_inset are typeset starting on the current page. +\change_inserted -712698321 1501225760 + +\end_layout + +\begin_layout Enumerate + +\change_inserted -712698321 1501225830 +\begin_inset Quotes eld +\end_inset + +Included +\begin_inset Quotes erd +\end_inset + + files cannot themselves +\begin_inset Quotes eld +\end_inset + +include +\begin_inset Quotes erd +\end_inset + + further files ( +\begin_inset Quotes eld +\end_inset + +grandchilds +\begin_inset Quotes erd +\end_inset + +). + With +\begin_inset Quotes eld +\end_inset + +input +\begin_inset Quotes erd +\end_inset + +, on the other hand, infinite sub-inputting is possible. +\end_layout + +\begin_layout Enumerate + +\change_inserted -712698321 1501226017 +\begin_inset Quotes eld +\end_inset + +Include +\begin_inset Quotes erd +\end_inset + + allow for the output of only selected +\begin_inset Quotes eld +\end_inset + +included +\begin_inset Quotes erd +\end_inset + + files, while maintaining the actual counters (pagination etc.) and references + (please refer to the section +\emph on +Child +\begin_inset space ~ +\end_inset + +Documents +\emph default + of the +\emph on +Embedded +\begin_inset space ~ +\end_inset + +Objects +\emph default + manual for details). +\change_unchanged + \end_layout \begin_layout Standard + +\change_inserted -712698321 1501225947 +Hence, +\begin_inset Quotes eld +\end_inset + +include +\begin_inset Quotes erd +\end_inset + + 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 + + is more suitable for arbitrary file inheritance. +\end_layout + +\begin_layout Standard + +\change_deleted -712698321 1501226562 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. +\change_unchanged + \end_layout \begin_layout Standard @@ -3669,6 +3806,20 @@ output checkbox typesets a mark to unambiguously define the presence of a space. +\change_inserted -712698321 1501226563 + +\end_layout + +\begin_layout Standard + +\change_inserted -712698321 1501226564 +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. +\change_unchanged + \end_layout \begin_layout Subsection @@ -3728,6 +3879,8 @@ Bibliography Lists in all Subdocuments \end_layout \begin_layout Standard + +\change_deleted -712698321 1501227275 \begin_inset Box Frameless position "t" hor_pos "c" @@ -3754,9 +3907,104 @@ This section also needs updating. \end_inset +\change_unchanged + +\end_layout + +\begin_layout Standard + +\change_inserted -712698321 1501226979 +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 + +\change_inserted -712698321 1501227105 +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 + +\change_inserted -712698321 1501227910 +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 + +g. + called +\begin_inset Quotes eld +\end_inset + +Childonly +\begin_inset Quotes erd +\end_inset + +. + 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 + +\change_inserted -712698321 1501228082 +If you need multiple bibliographies (e. +\begin_inset space \thinspace{} +\end_inset + +g., one per child in the +\emph on +main document +\emph default +), please refer to sec. +\begin_inset space ~ +\end_inset + + +\begin_inset CommandInset ref +LatexCommand ref +reference "subsec:Multiple-Bibliographies" + +\end_inset + +. +\change_unchanged + +\end_layout + +\begin_layout Standard + +\change_deleted -712698321 1501227257 Copy the bibliography list with all entries to all subdocuments and transform them to a comment. This way \SpecialChar LyX @@ -3775,6 +4023,8 @@ status collapsed \end_layout \begin_layout Standard + +\change_deleted -712698321 1501227257 As the bibliography list is in a comment, \SpecialChar LaTeX won't use it and the references will look like this: [?], instead of like this: [1]. @@ -3796,20 +4046,26 @@ comment \begin_layout LyX-Code +\change_deleted -712698321 1501227257 + \backslash usepackage{comment} \end_layout \begin_layout LyX-Code +\change_deleted -712698321 1501227257 + \backslash includecomment{comment} \end_layout \begin_layout Standard + +\change_deleted -712698321 1501227257 See also \begin_inset Flex URL -status collapsed +status open \begin_layout Plain Layout @@ -3819,6 +4075,8 @@ http://wiki.lyx.org/FAQ/Unsorted#toc31 \end_inset . +\change_unchanged + \end_layout \begin_layout Section -- 2.39.5