]> git.lyx.org Git - lyx.git/commitdiff
Update documentation for multiple bibliographies
authorJuergen Spitzmueller <spitz@lyx.org>
Sat, 4 Feb 2017 11:08:20 +0000 (12:08 +0100)
committerJuergen Spitzmueller <spitz@lyx.org>
Sat, 4 Feb 2017 11:09:13 +0000 (12:09 +0100)
lib/doc/Additional.lyx

index a43300f42667bf0d234350bb0d848ce91b4b52f5..a6b0f2c06384888e65ecb0ceef5c0dbd97f447dd 100644 (file)
@@ -1,5 +1,5 @@
 #LyX 2.3 created this file. For more info see http://www.lyx.org/
-\lyxformat 531
+\lyxformat 533
 \begin_document
 \begin_header
 \save_transient_properties true
@@ -1029,6 +1029,7 @@ On that last point, \SpecialChar LyX
 LatexCommand href
 name "CTAN"
 target "http://www.ctan.org/"
+literal "false"
 
 \end_inset
 
@@ -2592,7 +2593,13 @@ natbib
 \end_layout
 
 \begin_layout Subsection
-Sectioned Bibliographies
+S
+\change_deleted -712698321 1486199102
+ection
+\change_inserted -712698321 1486199104
+ubdivid
+\change_unchanged
+ed Bibliographies
 \end_layout
 
 \begin_layout Standard
@@ -2730,7 +2737,13 @@ Bibliography
 status collapsed
 
 \begin_layout Plain Layout
-Sectioned bibliography
+S
+\change_deleted -712698321 1486199132
+ection
+\change_inserted -712698321 1486199136
+ubdivid
+\change_unchanged
+ed bibliography
 \end_layout
 
 \end_inset
@@ -2833,7 +2846,7 @@ bibtopic
 
 \begin_layout Standard
 
-\change_inserted -712698321 1485696667
+\change_inserted -712698321 1486200403
 With 
 \family sans
 Biblatex
@@ -2853,8 +2866,8 @@ status collapsed
 
 \begin_layout Plain Layout
 
-\change_inserted -712698321 1485695841
-Sectioned bibliography
+\change_inserted -712698321 1486200382
+Subdivided bibliography
 \end_layout
 
 \end_inset
@@ -2868,7 +2881,7 @@ Biblatex
 \family sans
 Biblatex
 \family default
- provides its own means to generate sectioned bibliographies.
+ provides its own means to generate subdivided bibliographies.
  You can either add keywords to bibliography entries via the 
 \begin_inset Flex Code
 status collapsed
@@ -3006,10 +3019,94 @@ g.
 \begin_inset space \space{}
 \end_inset
 
-a bibliography for each section or chapter of the document, are not supported
- by Bib\SpecialChar TeX
+a bibliography for each 
+\change_inserted -712698321 1486199441
+part, chapter, 
+\change_unchanged
+section or 
+\change_inserted -712698321 1486199445
+subsection
+\change_deleted -712698321 1486199447
+chapter
+\change_unchanged
+ of the document, are 
+\change_deleted -712698321 1486199458
+not 
+\change_inserted -712698321 1486200433
+also 
+\change_unchanged
+supported 
+\change_inserted -712698321 1486202058
+by \SpecialChar LyX
+.
+ In order to enable it, go to 
+\begin_inset Flex Noun
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1486199572
+Document\SpecialChar menuseparator
+Settings\SpecialChar menuseparator
+Bibliography
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+ and select the relevant unit (e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g., 
+\begin_inset Quotes eld
+\end_inset
+
+by section
+\begin_inset Quotes erd
+\end_inset
+
+) in the 
+\begin_inset Flex Noun
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1486199553
+Multiple Bibliographies
+\change_unchanged
+
+\end_layout
+
+\end_inset
+
+ combo box.
+\change_deleted -712698321 1486199771
+by Bib\SpecialChar TeX
  itself.
- But the 
+\change_inserted -712698321 1486200569
+Then add a Bib(la)\SpecialChar TeX
+ bibliography to each unit (e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g., section) of your document.
+ In the output, a separate bibliography, containing only the references
+ done in the current unit is generated.
+\end_layout
+
+\begin_layout Standard
+
+\change_inserted -712698321 1486199829
+If you use Bib\SpecialChar TeX
+, 
+\change_deleted -712698321 1486199835
+But 
+\change_unchanged
+the 
 \begin_inset Flex Code
 status collapsed
 
@@ -3019,10 +3116,23 @@ bibtopic
 
 \end_inset
 
- package, which is used for the creation of sectioned bibliographies in
- \SpecialChar LyX
- (see the previous section), provides an easy way to solve this task, if
- you are willing to use some 
+ package, which is
+\change_inserted -712698321 1486199815
+ also
+\change_unchanged
+ used for the creation of 
+\change_deleted -712698321 1486199277
+section
+\change_inserted -712698321 1486199815
+subdivid
+\change_unchanged
+ed bibliographies in \SpecialChar LyX
+ (see the previous section), 
+\change_inserted -712698321 1486199852
+is used to create multiple bibliographies.
+\change_deleted -712698321 1486200505
+provides an easy way to solve this task, if you are willing to use some
 \begin_inset Flex Noun
 status collapsed
 
@@ -3045,11 +3155,41 @@ reference "sec:Inserting-TeX-Code"
 \end_inset
 
 ).
+\change_unchanged
+
 \begin_inset Foot
 status collapsed
 
 \begin_layout Plain Layout
-An alternative approach is to use the 
+An alternative approach
+\change_inserted -712698321 1486199215
+, if you are willing to use some 
+\begin_inset Flex Noun
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1486199212
+\SpecialChar TeX
+ Code
+\end_layout
+
+\end_inset
+
+ (see section
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "sec:Inserting-TeX-Code"
+
+\end_inset
+
+),
+\change_unchanged
+ is to use the 
 \begin_inset Flex Code
 status collapsed
 
@@ -3075,9 +3215,15 @@ bibunits
 \end_inset
 
 
+\change_inserted -712698321 1486202156
+\change_deleted -712698321 1486202138
+
 \end_layout
 
 \begin_layout Standard
+
+\change_deleted -712698321 1486202126
 First go to 
 \begin_inset Flex Noun
 status collapsed
@@ -3114,6 +3260,23 @@ Sectioned bibliography
  their own bibliography (including the Bib\SpecialChar TeX
  bibliography itself), between
  
+\change_inserted -712698321 1486201472
+\SpecialChar LyX
+ encloses the specified units in 
+\begin_inset Flex Code
+status collapsed
+
+\begin_layout Plain Layout
+
+\change_inserted -712698321 1486201443
+bibtopic
+\end_layout
+
+\end_inset
+
+'s 
+\change_unchanged
+
 \begin_inset Flex Code
 status collapsed
 
@@ -3137,7 +3300,17 @@ end{btUnit}
 
 \end_inset
 
- (those commands have to be inserted as \SpecialChar TeX
+
+\change_inserted -712698321 1486201491
+ in order to create the units.
+ Note that this approach has
+\change_unchanged
+\change_inserted -712698321 1486201489
+some limitations.
+\change_deleted -712698321 1486200476
+(those commands have to be inserted as \SpecialChar TeX
  code).
  The bibliography will contain all references that have been cited in the
  current 
@@ -3155,19 +3328,11 @@ btUnit
 \series bold
 Note:
 \series default
- If you are using this approach, then every citation reference has to be
- inside some 
-\begin_inset Flex Code
-status collapsed
-
-\begin_layout Plain Layout
-btUnit
-\end_layout
-
-\end_inset
-
-.
- Also, the 
+ If you are using this approach, then 
+\change_inserted -712698321 1486201489
+First, 
+\change_unchanged
+every citation reference has to be inside some 
 \begin_inset Flex Code
 status collapsed
 
@@ -3177,187 +3342,131 @@ btUnit
 
 \end_inset
 
-s cannot be nested.
-\change_inserted -712698321 1485696937
-
-\end_layout
-
-\begin_layout Standard
-
-\change_inserted -712698321 1485698355
-Again, with 
-\family sans
-Biblatex
-\family default
-, the procedure differs, since 
-\family typewriter
-bibtopic
-\family default
- does not work with 
-\family sans
-Biblatex
-\family default
 .
- Biblatex has its own commands to get multiple bibliographies.
- Generally, two different ways are differentiated: 
-\emph on
-refsections
-\emph default
- are fully self-enclosed sections containing their own bibliography, 
-\emph on
-refsegments
-\emph default
- are sections that contain their own bibliography, but maintain a global
- numbering scheme (so that if two different 
-\emph on
-refsegments
-\emph default
- contain references to two different papers by Miller published in 2016,
- they will be labeled as 
-\begin_inset Quotes eld
-\end_inset
-
-Miller 2016a
-\begin_inset Quotes erd
+\change_inserted -712698321 1486201489
+So citations outside a defined unit (e.
+\begin_inset space \thinspace{}
 \end_inset
 
- and 
+g., before the first section if you use 
 \begin_inset Quotes eld
 \end_inset
 
-Miller 2016b
+by section
 \begin_inset Quotes erd
 \end_inset
 
- in an author-year scheme, while with 
-\emph on
-refsections
-\emph default
-, they will both be labeled as 
+) will appear as 
 \begin_inset Quotes eld
 \end_inset
 
-Miller 2016
+???
 \begin_inset Quotes erd
 \end_inset
 
-, as the two sections are considered to be independent).
-\end_layout
-
-\begin_layout Standard
-
-\change_inserted -712698321 1485698499
-If you need a 
-\emph on
-refsection
-\emph default
- or 
-\emph on
-refsegment
-\emph default
- per part, chapter, section or subsection, all you have to do is to enter,
- respectively, 
+.
+ You can also create your own units by entering 
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
 
-\change_inserted -712698321 1485697458
-refsection=part
-\change_unchanged
+\change_inserted -712698321 1486200131
 
+\backslash
+begin{btUnit}
 \end_layout
 
 \end_inset
 
-, 
+ and 
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
 
-\change_inserted -712698321 1485697463
-refsection=chapter
-\change_unchanged
+\change_inserted -712698321 1486200131
 
+\backslash
+end{btUnit}
 \end_layout
 
 \end_inset
 
-, 
+ as \SpecialChar TeX
+ code (for instance to work around the mentioned limitation).
+ Note, though, that
+\change_deleted -712698321 1486200476
+Also, the
+\change_unchanged
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
-
-\change_inserted -712698321 1485697469
-refsection=section
-\change_unchanged
-
+btUnit
 \end_layout
 
 \end_inset
 
- or 
+s cannot be nested.
+
+\change_inserted -712698321 1486201489
+ A second limitation is that 
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
 
-\change_inserted -712698321 1485697474
-refsection=subsection
-\change_unchanged
-
+\change_inserted -712698321 1486200199
+bibtopic
 \end_layout
 
 \end_inset
 
- (or 
-\begin_inset Flex Code
-status collapsed
-
-\begin_layout Plain Layout
+ always processes all references of a bibliography database, even if they
+ are not cited.
+ This can result in odd labels (e.
+\begin_inset space \thinspace{}
+\end_inset
 
-\change_inserted -712698321 1485697532
-refsegment=\SpecialChar ldots
+g.
+\begin_inset Quotes eld
+\end_inset
 
-\change_unchanged
+Miller 2014b
+\begin_inset Quotes erd
+\end_inset
 
+ if two works of this author from 2014 are in the database, even if only
+ one is cited).
 \end_layout
 
-\end_inset
+\begin_layout Standard
 
- for 
-\emph on
-refsegments
-\emph default
-) to 
-\begin_inset Flex Noun
+\change_inserted -712698321 1486204109
+If you use 
+\family sans
+Biblatex
+\family default
+, the 
+\begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
 
-\change_inserted -712698321 1485697573
-Document\SpecialChar menuseparator
-Settings\SpecialChar menuseparator
-Bibliography\SpecialChar menuseparator
-Options
+\change_inserted -712698321 1486202183
+refsection
 \change_unchanged
 
 \end_layout
 
 \end_inset
 
-.
- If you need specific 
-\emph on
-refsections
-\emph default
- or 
-\emph on
-refsegments
-\emph default
-, you can start them with the \SpecialChar TeX
+ option is used instead.
+ If you need specific units, you can start them with the \SpecialChar TeX
  code 
 \begin_inset Flex Code
 status collapsed
@@ -3391,9 +3500,7 @@ newrefsegment
 \end_inset
 
 , respectively.
- If you also want to control the end of the section\SpecialChar breakableslash
-segment, use the environment
+ If you also want to control the end of the unit, use the environment 
 \begin_inset Flex Code
 status collapsed
 
@@ -3422,118 +3529,42 @@ end{refsection}
 
 \end_inset
 
- or 
-\begin_inset Flex Code
-status collapsed
-
-\begin_layout Plain Layout
-
-\change_inserted -712698321 1485697791
-
-\backslash
-begin{refsegment}
-\end_layout
-
-\end_inset
-
- \SpecialChar ldots
+ instead.
+ Note, though, that 
 \begin_inset Flex Code
 status collapsed
 
 \begin_layout Plain Layout
 
-\change_inserted -712698321 1485697797
+\change_inserted -712698321 1486201999
+refsection
+\change_unchanged
 
-\backslash
-end{refsegment}
 \end_layout
 
 \end_inset
 
- instead.
-\end_layout
-
-\begin_layout Standard
-
-\change_inserted -712698321 1485698580
-In order to actually output the bibliography of the respective section or
- segment, simply insert it at the place where it should appear via 
-\family sans
-Insert\SpecialChar menuseparator
-List
-\family default
-/
+s cannot be nested.
+ In addition to the individual bibliography of the current unit, 
 \family sans
-TOC\SpecialChar menuseparator
-Bib(la)TeX
-\begin_inset space ~
-\end_inset
-
-Bibliography
+Biblatex
 \family default
- (within the given 
-\emph on
-refsection
-\emph default
- or 
-\emph on
-refsegment
-\emph default
-).
- If you want to output all 
-\emph on
-refsections
-\emph default
- or 
-\emph on
-refsegments
-\emph default
- at one place (e.
+ also provides an easy way to output all bibliographies, subsequently, at
+ one place (e.
 \begin_inset space \thinspace{}
 \end_inset
 
-g., at the end of the document), 
-\family sans
-Biblatex
-\family default
- provides the commands 
-\begin_inset Flex Code
-status collapsed
-
-\begin_layout Plain Layout
-
-\change_inserted -712698321 1485698571
-
-\backslash
-bibbysection
-\change_unchanged
-
-\end_layout
-
+g., at the end of the document).
+ Select 
+\begin_inset Quotes eld
 \end_inset
 
- and 
-\begin_inset Flex Code
-status collapsed
-
-\begin_layout Plain Layout
-
-\change_inserted -712698321 1485698580
-
-\backslash
-bibbysegment
-\change_unchanged
-
-\end_layout
-
+all reference units
+\begin_inset Quotes erd
 \end_inset
 
- which automatically loop over all sections/segments and output them subsequentl
-y.
- Currently, these commands need to be entered as \SpecialChar TeX
- code in \SpecialChar LyX
-.
+ from the Content combo box of the Bib(la)TeX inset dialog in order to achieve
+ this.
  Please refer to the 
 \family sans
 Biblatex
@@ -5291,6 +5322,7 @@ er
 LatexCommand href
 name "http://elyxer.nongnu.org/"
 target "http://elyxer.nongnu.org/"
+literal "false"
 
 \end_inset
 
@@ -5396,6 +5428,7 @@ development/HTML.notes
 LatexCommand href
 name "accessed online"
 target "http://www.lyx.org/trac/browser/lyxgit/development/HTML/HTML.notes?rev=master"
+literal "false"
 
 \end_inset
 
@@ -5405,6 +5438,7 @@ target "http://www.lyx.org/trac/browser/lyxgit/development/HTML/HTML.notes?rev=m
 LatexCommand href
 name "the bug tracker"
 target "http://www.lyx.org/trac/query?status=reopened&status=assigned&status=new&max=0&component=xhtml+export&order=id&col=id&col=summary&col=reporter&col=keywords&keywords=%21%7Efixedintrunk&desc=1"
+literal "false"
 
 \end_inset
 
@@ -5648,6 +5682,7 @@ have to be on for images to be output, however.
 LatexCommand href
 name "bug 6894"
 target "http://www.lyx.org/trac/ticket/6894"
+literal "false"
 
 \end_inset
 
@@ -5713,6 +5748,7 @@ Finally, \SpecialChar LyX
 LatexCommand href
 name "jsMath"
 target "http://www.math.union.edu/~dpvc/jsMath/"
+literal "false"
 
 \end_inset
 
@@ -8225,6 +8261,7 @@ SumatraPDF can also use DDE commands through the external program CMCDDE
 \begin_inset CommandInset href
 LatexCommand href
 target "http://www.istri.fr/spip/zip/CMCDDE.zip"
+literal "false"
 
 \end_inset
 
@@ -19161,6 +19198,7 @@ chktex
 \begin_inset CommandInset href
 LatexCommand href
 target "http://www.ctan.org/tex-archive/help/Catalogue/entries/chktex.html"
+literal "false"
 
 \end_inset
 
@@ -20278,6 +20316,7 @@ status collapsed
 \begin_inset CommandInset href
 LatexCommand href
 target "http://svnbook.red-bean.com/"
+literal "false"
 
 \end_inset
 
@@ -22508,6 +22547,7 @@ In addition to installing \SpecialChar LyX
 LatexCommand href
 name "CollabNet"
 target "http://www.collab.net/nonav/downloads/subversion/"
+literal "false"
 
 \end_inset
 
@@ -22517,6 +22557,7 @@ target "http://www.collab.net/nonav/downloads/subversion/"
 LatexCommand href
 name "TortoiseSVN"
 target "http://tortoisesvn.tigris.org/"
+literal "false"
 
 \end_inset
 
@@ -25058,6 +25099,7 @@ multicol
 \begin_inset CommandInset citation
 LatexCommand cite
 key "multicol"
+literal "true"
 
 \end_inset
 
@@ -26853,6 +26895,7 @@ Install the program
 LatexCommand href
 name "Jpgfdraw"
 target "http://www.ctan.org/tex-archive/graphics/jpgfdraw"
+literal "false"
 
 \end_inset
 
@@ -26899,6 +26942,7 @@ For more information see
 \begin_inset CommandInset href
 LatexCommand href
 target "http://www.dickimaw-books.com/apps/jpgfdraw/manual/shapepar.html"
+literal "false"
 
 \end_inset
 
@@ -27072,6 +27116,7 @@ shapepar
 \begin_inset CommandInset citation
 LatexCommand cite
 key "shapepar"
+literal "true"
 
 \end_inset
 
@@ -27082,6 +27127,7 @@ key "shapepar"
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
 key "multicol"
+literal "true"
 
 \end_inset
 
@@ -27091,6 +27137,7 @@ Documentation of the \SpecialChar LaTeX
 LatexCommand href
 name "multicol"
 target "http://mirror.ctan.org/macros/latex/required/tools/multicol.pdf"
+literal "false"
 
 \end_inset
 
@@ -27101,6 +27148,7 @@ target "http://mirror.ctan.org/macros/latex/required/tools/multicol.pdf"
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
 key "shapepar"
+literal "true"
 
 \end_inset
 
@@ -27110,6 +27158,7 @@ Documentation of the \SpecialChar LaTeX
 LatexCommand href
 name "shapepar"
 target "http://mirrors.ctan.org/macros/latex/contrib/shapepar/shapepar.pdf"
+literal "false"
 
 \end_inset