anne/lyx_mirror
1
0
Fork 0
mirror of https://git.lyx.org/repos/lyx.git synced 2024-11-25 19:07:45 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Update documentation for multiple bibliographies

Browse Source
This commit is contained in:
Juergen Spitzmueller 2017-02-04 12:08:20 +01:00
parent 7ca20b292c
commit 970d4311fe
1 changed files with 330 additions and 281 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

611
lib/doc/Additional.lyx
View File

@ -1,5 +1,5 @@
#LyX 2.3 created this file. For more info see http://www.lyx.org/ #LyX 2.3 created this file. For more info see http://www.lyx.org/
\lyxformat 531 \lyxformat 533
\begin_document \begin_document
\begin_header \begin_header
\save_transient_properties true \save_transient_properties true
@ -1029,6 +1029,7 @@ On that last point, \SpecialChar LyX
LatexCommand href LatexCommand href
name "CTAN" name "CTAN"
target "http://www.ctan.org/" target "http://www.ctan.org/"
literal "false"
\end_inset \end_inset
@ -2592,7 +2593,13 @@ natbib
\end_layout \end_layout
\begin_layout Subsection \begin_layout Subsection
Sectioned Bibliographies S
\change_deleted -712698321 1486199102
ection
\change_inserted -712698321 1486199104
ubdivid
\change_unchanged
ed Bibliographies
\end_layout \end_layout
\begin_layout Standard \begin_layout Standard
@ -2730,7 +2737,13 @@ Bibliography
status collapsed status collapsed
\begin_layout Plain Layout \begin_layout Plain Layout
Sectioned bibliography S
\change_deleted -712698321 1486199132
ection
\change_inserted -712698321 1486199136
ubdivid
\change_unchanged
ed bibliography
\end_layout \end_layout
\end_inset \end_inset
@ -2833,7 +2846,7 @@ bibtopic
\begin_layout Standard \begin_layout Standard
\change_inserted -712698321 1485696667 \change_inserted -712698321 1486200403
With With
\family sans \family sans
Biblatex Biblatex
@ -2853,8 +2866,8 @@ status collapsed
\begin_layout Plain Layout \begin_layout Plain Layout
\change_inserted -712698321 1485695841 \change_inserted -712698321 1486200382
Sectioned bibliography Subdivided bibliography
\end_layout \end_layout
\end_inset \end_inset
@ -2868,7 +2881,7 @@ Biblatex
\family sans \family sans
Biblatex Biblatex
\family default \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 You can either add keywords to bibliography entries via the
\begin_inset Flex Code \begin_inset Flex Code
status collapsed status collapsed
@ -3006,10 +3019,94 @@ g.
\begin_inset space \space{} \begin_inset space \space{}
\end_inset \end_inset
a bibliography for each section or chapter of the document, are not supported a bibliography for each
by Bib\SpecialChar TeX \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. 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 \begin_inset Flex Code
status collapsed status collapsed
@ -3019,10 +3116,23 @@ bibtopic
\end_inset \end_inset
package, which is used for the creation of sectioned bibliographies in package, which is
\SpecialChar LyX \change_inserted -712698321 1486199815
(see the previous section), provides an easy way to solve this task, if also
you are willing to use some \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 \begin_inset Flex Noun
status collapsed status collapsed
@ -3045,11 +3155,41 @@ reference "sec:Inserting-TeX-Code"
\end_inset \end_inset
). ).
\change_unchanged
\begin_inset Foot \begin_inset Foot
status collapsed status collapsed
\begin_layout Plain Layout \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 \begin_inset Flex Code
status collapsed status collapsed
@ -3075,9 +3215,15 @@ bibunits
\end_inset \end_inset
\change_inserted -712698321 1486202156
\change_deleted -712698321 1486202138
\end_layout \end_layout
\begin_layout Standard \begin_layout Standard
\change_deleted -712698321 1486202126
First go to First go to
\begin_inset Flex Noun \begin_inset Flex Noun
status collapsed status collapsed
@ -3114,6 +3260,23 @@ Sectioned bibliography
their own bibliography (including the Bib\SpecialChar TeX their own bibliography (including the Bib\SpecialChar TeX
bibliography itself), between 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 \begin_inset Flex Code
status collapsed status collapsed
@ -3137,7 +3300,17 @@ end{btUnit}
\end_inset \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). code).
The bibliography will contain all references that have been cited in the The bibliography will contain all references that have been cited in the
current current
@ -3155,8 +3328,11 @@ btUnit
\series bold \series bold
Note: Note:
\series default \series default
If you are using this approach, then every citation reference has to be If you are using this approach, then
inside some \change_inserted -712698321 1486201489
First,
\change_unchanged
every citation reference has to be inside some
\begin_inset Flex Code \begin_inset Flex Code
status collapsed status collapsed
@ -3167,7 +3343,64 @@ btUnit
\end_inset \end_inset
. .
Also, the
\change_inserted -712698321 1486201489
So citations outside a defined unit (e.
\begin_inset space \thinspace{}
\end_inset
g., before the first section if you use
\begin_inset Quotes eld
\end_inset
by section
\begin_inset Quotes erd
\end_inset
) will appear as
\begin_inset Quotes eld
\end_inset
???
\begin_inset Quotes erd
\end_inset
.
You can also create your own units by entering
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\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 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 \begin_inset Flex Code
status collapsed status collapsed
@ -3178,186 +3411,62 @@ btUnit
\end_inset \end_inset
s cannot be nested. s cannot be nested.
\change_inserted -712698321 1485696937
\end_layout \change_inserted -712698321 1486201489
A second limitation is that
\begin_inset Flex Code
status collapsed
\begin_layout Standard \begin_layout Plain Layout
\change_inserted -712698321 1485698355 \change_inserted -712698321 1486200199
Again, with
\family sans
Biblatex
\family default
, the procedure differs, since
\family typewriter
bibtopic bibtopic
\family default \end_layout
does not work with
\family sans \end_inset
Biblatex
\family default always processes all references of a bibliography database, even if they
. are not cited.
Biblatex has its own commands to get multiple bibliographies. This can result in odd labels (e.
Generally, two different ways are differentiated: \begin_inset space \thinspace{}
\emph on \end_inset
refsections
\emph default g.
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 \begin_inset Quotes eld
\end_inset \end_inset
Miller 2016a Miller 2014b
\begin_inset Quotes erd \begin_inset Quotes erd
\end_inset \end_inset
and if two works of this author from 2014 are in the database, even if only
\begin_inset Quotes eld one is cited).
\end_inset
Miller 2016b
\begin_inset Quotes erd
\end_inset
in an author-year scheme, while with
\emph on
refsections
\emph default
, they will both be labeled 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 \end_layout
\begin_layout Standard \begin_layout Standard
\change_inserted -712698321 1485698499 \change_inserted -712698321 1486204109
If you need a If you use
\emph on \family sans
Biblatex
\family default
, the
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\change_inserted -712698321 1486202183
refsection refsection
\emph default
or
\emph on
refsegment
\emph default
per part, chapter, section or subsection, all you have to do is to enter,
respectively,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\change_inserted -712698321 1485697458
refsection=part
\change_unchanged \change_unchanged
\end_layout \end_layout
\end_inset \end_inset
, option is used instead.
\begin_inset Flex Code If you need specific units, you can start them with the \SpecialChar TeX
status collapsed
\begin_layout Plain Layout
\change_inserted -712698321 1485697463
refsection=chapter
\change_unchanged
\end_layout
\end_inset
,
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\change_inserted -712698321 1485697469
refsection=section
\change_unchanged
\end_layout
\end_inset
or
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\change_inserted -712698321 1485697474
refsection=subsection
\change_unchanged
\end_layout
\end_inset
(or
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\change_inserted -712698321 1485697532
refsegment=\SpecialChar ldots
\change_unchanged
\end_layout
\end_inset
for
\emph on
refsegments
\emph default
) to
\begin_inset Flex Noun
status collapsed
\begin_layout Plain Layout
\change_inserted -712698321 1485697573
Document\SpecialChar menuseparator
Settings\SpecialChar menuseparator
Bibliography\SpecialChar menuseparator
Options
\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
code code
\begin_inset Flex Code \begin_inset Flex Code
status collapsed status collapsed
@ -3391,9 +3500,7 @@ newrefsegment
\end_inset \end_inset
, respectively. , respectively.
If you also want to control the end of the section\SpecialChar breakableslash If you also want to control the end of the unit, use the environment
segment, use the environment
\begin_inset Flex Code \begin_inset Flex Code
status collapsed status collapsed
@ -3420,120 +3527,44 @@ status collapsed
end{refsection} end{refsection}
\end_layout \end_layout
\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
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\change_inserted -712698321 1485697797
\backslash
end{refsegment}
\end_layout
\end_inset \end_inset
instead. instead.
Note, though, that
\begin_inset Flex Code
status collapsed
\begin_layout Plain Layout
\change_inserted -712698321 1486201999
refsection
\change_unchanged
\end_layout \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
/
\family sans
TOC\SpecialChar menuseparator
Bib(la)TeX
\begin_inset space ~
\end_inset \end_inset
Bibliography s cannot be nested.
\family default In addition to the individual bibliography of the current unit,
(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.
\begin_inset space \thinspace{}
\end_inset
g., at the end of the document),
\family sans \family sans
Biblatex Biblatex
\family default \family default
provides the commands also provides an easy way to output all bibliographies, subsequently, at
\begin_inset Flex Code one place (e.
status collapsed \begin_inset space \thinspace{}
\begin_layout Plain Layout
\change_inserted -712698321 1485698571
\backslash
bibbysection
\change_unchanged
\end_layout
\end_inset \end_inset
and g., at the end of the document).
\begin_inset Flex Code Select
status collapsed \begin_inset Quotes eld
\begin_layout Plain Layout
\change_inserted -712698321 1485698580
\backslash
bibbysegment
\change_unchanged
\end_layout
\end_inset \end_inset
which automatically loop over all sections/segments and output them subsequentl all reference units
y. \begin_inset Quotes erd
Currently, these commands need to be entered as \SpecialChar TeX \end_inset
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 Please refer to the
\family sans \family sans
Biblatex Biblatex
@ -5291,6 +5322,7 @@ er
LatexCommand href LatexCommand href
name "http://elyxer.nongnu.org/" name "http://elyxer.nongnu.org/"
target "http://elyxer.nongnu.org/" target "http://elyxer.nongnu.org/"
literal "false"
\end_inset \end_inset
@ -5396,6 +5428,7 @@ development/HTML.notes
LatexCommand href LatexCommand href
name "accessed online" name "accessed online"
target "http://www.lyx.org/trac/browser/lyxgit/development/HTML/HTML.notes?rev=master" target "http://www.lyx.org/trac/browser/lyxgit/development/HTML/HTML.notes?rev=master"
literal "false"
\end_inset \end_inset
@ -5405,6 +5438,7 @@ target "http://www.lyx.org/trac/browser/lyxgit/development/HTML/HTML.notes?rev=m
LatexCommand href LatexCommand href
name "the bug tracker" 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" 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 \end_inset
@ -5648,6 +5682,7 @@ have to be on for images to be output, however.
LatexCommand href LatexCommand href
name "bug 6894" name "bug 6894"
target "http://www.lyx.org/trac/ticket/6894" target "http://www.lyx.org/trac/ticket/6894"
literal "false"
\end_inset \end_inset
@ -5713,6 +5748,7 @@ Finally, \SpecialChar LyX
LatexCommand href LatexCommand href
name "jsMath" name "jsMath"
target "http://www.math.union.edu/~dpvc/jsMath/" target "http://www.math.union.edu/~dpvc/jsMath/"
literal "false"
\end_inset \end_inset
@ -8225,6 +8261,7 @@ SumatraPDF can also use DDE commands through the external program CMCDDE
\begin_inset CommandInset href \begin_inset CommandInset href
LatexCommand href LatexCommand href
target "http://www.istri.fr/spip/zip/CMCDDE.zip" target "http://www.istri.fr/spip/zip/CMCDDE.zip"
literal "false"
\end_inset \end_inset
@ -19161,6 +19198,7 @@ chktex
\begin_inset CommandInset href \begin_inset CommandInset href
LatexCommand href LatexCommand href
target "http://www.ctan.org/tex-archive/help/Catalogue/entries/chktex.html" target "http://www.ctan.org/tex-archive/help/Catalogue/entries/chktex.html"
literal "false"
\end_inset \end_inset
@ -20278,6 +20316,7 @@ status collapsed
\begin_inset CommandInset href \begin_inset CommandInset href
LatexCommand href LatexCommand href
target "http://svnbook.red-bean.com/" target "http://svnbook.red-bean.com/"
literal "false"
\end_inset \end_inset
@ -22508,6 +22547,7 @@ In addition to installing \SpecialChar LyX
LatexCommand href LatexCommand href
name "CollabNet" name "CollabNet"
target "http://www.collab.net/nonav/downloads/subversion/" target "http://www.collab.net/nonav/downloads/subversion/"
literal "false"
\end_inset \end_inset
@ -22517,6 +22557,7 @@ target "http://www.collab.net/nonav/downloads/subversion/"
LatexCommand href LatexCommand href
name "TortoiseSVN" name "TortoiseSVN"
target "http://tortoisesvn.tigris.org/" target "http://tortoisesvn.tigris.org/"
literal "false"
\end_inset \end_inset
@ -25058,6 +25099,7 @@ multicol
\begin_inset CommandInset citation \begin_inset CommandInset citation
LatexCommand cite LatexCommand cite
key "multicol" key "multicol"
literal "true"
\end_inset \end_inset
@ -26853,6 +26895,7 @@ Install the program
LatexCommand href LatexCommand href
name "Jpgfdraw" name "Jpgfdraw"
target "http://www.ctan.org/tex-archive/graphics/jpgfdraw" target "http://www.ctan.org/tex-archive/graphics/jpgfdraw"
literal "false"
\end_inset \end_inset
@ -26899,6 +26942,7 @@ For more information see
\begin_inset CommandInset href \begin_inset CommandInset href
LatexCommand href LatexCommand href
target "http://www.dickimaw-books.com/apps/jpgfdraw/manual/shapepar.html" target "http://www.dickimaw-books.com/apps/jpgfdraw/manual/shapepar.html"
literal "false"
\end_inset \end_inset
@ -27072,6 +27116,7 @@ shapepar
\begin_inset CommandInset citation \begin_inset CommandInset citation
LatexCommand cite LatexCommand cite
key "shapepar" key "shapepar"
literal "true"
\end_inset \end_inset
@ -27082,6 +27127,7 @@ key "shapepar"
\begin_inset CommandInset bibitem \begin_inset CommandInset bibitem
LatexCommand bibitem LatexCommand bibitem
key "multicol" key "multicol"
literal "true"
\end_inset \end_inset
@ -27091,6 +27137,7 @@ Documentation of the \SpecialChar LaTeX
LatexCommand href LatexCommand href
name "multicol" name "multicol"
target "http://mirror.ctan.org/macros/latex/required/tools/multicol.pdf" target "http://mirror.ctan.org/macros/latex/required/tools/multicol.pdf"
literal "false"
\end_inset \end_inset
@ -27101,6 +27148,7 @@ target "http://mirror.ctan.org/macros/latex/required/tools/multicol.pdf"
\begin_inset CommandInset bibitem \begin_inset CommandInset bibitem
LatexCommand bibitem LatexCommand bibitem
key "shapepar" key "shapepar"
literal "true"
\end_inset \end_inset
@ -27110,6 +27158,7 @@ Documentation of the \SpecialChar LaTeX
LatexCommand href LatexCommand href
name "shapepar" name "shapepar"
target "http://mirrors.ctan.org/macros/latex/contrib/shapepar/shapepar.pdf" target "http://mirrors.ctan.org/macros/latex/contrib/shapepar/shapepar.pdf"
literal "false"
\end_inset \end_inset