commit e1fc687f079814fdc163b3824153316f9805b671
Author: Juergen Spitzmueller <[email protected]>
Date: Fri Jul 28 09:49:40 2017 +0200
Improve and fix description of multipart documents.
---
lib/doc/Additional.lyx | 268 +++++++++++++++++++++++++++++++++++++++++++++++-
1 files changed, 263 insertions(+), 5 deletions(-)
diff --git a/lib/doc/Additional.lyx b/lib/doc/Additional.lyx
index 49e62b0..7e6e576 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
