From beeaf703741d4a46737ccf3c06680c071950a657 Mon Sep 17 00:00:00 2001
From: Karl Berry I want to have by BiBTeX generated references inlined in footnotes
+rather than the very terse references BiBTeX generates by default, so I
+hacked together a BiBTeX style to do that. These macros are not
+polished or in the form of a proper distribution, but I have used them
+with succes myself. The following discription have been made in haste. I will document
+it better when I have the time (RSN :-). There are two files: inlinebib.sty and indexing.bst. This works just like any other BiBTeX style. It will still generate
+the bibliography at the end of the document, but it will also store all
+the entries in the The first time a citation is made using Citations of this form are designed to be used in footnotes. A little example migth be appropriate (don't we all love
+screenshots!). Footnotes from page one: Footnotes from page two:Inline bibliography style
+
+The idea
+
+.aux
files, so they can be inlined in
+the following latex
run.\cite
the
+complete bibliography entry is inserted. The following citations to the
+same entry will generate a short form, with only authors last name and a
+shortened title, followed by a "cit.". If the same bibliography
+entry is cited several times in a row, the text will only be
+"ibid.".
+
+
+(the overstrike problem is courtesy of xdvi(1))
+
+
+
+
+
+
+
+
+
It is not possible to avoid having the complete bibliography at the +end of the document. The macros simply won't work without it. If you +don't need it, just don't print it.
+ + + +To use these macros put the file inlinebib.sty
in your
+LaTeX search path and inlinebib.bst
in your BiBTeX style
+search path and then put the line:
++ +\usepackage{inlinebib}+
in the preamble of your document.
+ +Other commands have to be added at the point where you want the
+bibliography to appear, usually at the end of the document. To tell
+BiBTeX to use the inlinebib style, you have to use
+bibliographystyle
:
+
+
++ ++\bibliographystyle{inlinebib} ++
Often I add a leading explanation to the bibliography with the
+\bibliographycomment
macro. That is:
++ ++\bibliographycomment{This bibliography ...} ++
The actual index is produced by the \bibliography
+macro. Here you have to specify which BiBTeX databases you want to use.
++ ++\bibliography{file ...} ++
These were all the formalities.
+ + +When writing, just make citations as usual. Remember that these +macros can produce very verbose references, and they are intended for +footnotes.
+ +The default implementation of \cite
allows several
+bibliography entries to be cited. This version allows only one at a
+time. It still supports the optional argument, which should be a page
+reference within the cited text.
There are a few additional macros available. \fullycite
+forces a reference in the long form, \shortcite
forces
+the short form, and \noibid
disables the generation
+"ibid." references for the next citation (this can for example be
+used at the end of each chapter).
To force later citations for certain entries to be either long or
+short, the macros \fullcitenext{}
and
+\shortcitenext{}
can be used. The single argument is a
+comma separated list of BiBTeX labels that should be either long or
+short the next time they are cited. E.g., the code
+\fullcitenext{book1, book2} will cause LaTeX to forget that
+the two references might have been seen earlier and they will be handled
+as if they haven't be cited yet.
This style does not require special changes to the BiBTeX +databases.
+ +Sometimes the BiBTeX style doesn't manage to calculate the proper
+short forms of the author and the title. In that case the BiBTeX
+entries in question can be extended with shortauthor = {shorter
+author name}
and shorttitle = {short form of
+title}
.
I have some macros to format page ranges, that I use with this BiBTeX +style. They should be usable with other styles as well.
+ +The macros are here: pageranges.sty
+ +This file defined one user visible macro: \pages{}
,
+which will do the following transformations of the single argument:
\pages{N}
+p.~N
+\pages{N-}
+pp.~N~ff
+\pages{N-M}
+pp.~N--M
+\pages{N M}
+pp.~N M
+The last version is for cases like \pages{213, 345
+and~654}
which will become pp.~213, 345 and~654
.
I often have this little definition in a LaTeX style file. It makes
+\cite
do page ranges automatically and also puts the author
+in the index (see the indexing macros).
++ + + + + ++%% Automatically fix page ranges in citations and index author +\let\RS@citex\@citex +\def\@citex[#1]#2{\I@indexonly-{#2}\RS@citex[\pages{#1}]{#2}} ++
If you have comments, please write me.
+ + + + + diff --git a/Master/texmf-dist/doc/bibtex/inlinebib/inlinebib.txt b/Master/texmf-dist/doc/bibtex/inlinebib/inlinebib.txt new file mode 100644 index 00000000000..cfd51dcee57 --- /dev/null +++ b/Master/texmf-dist/doc/bibtex/inlinebib/inlinebib.txt @@ -0,0 +1,151 @@ + + Inline bibliography style + + I want to have by BiBTeX generated references inlined in footnotes + rather than the very terse references BiBTeX generates by default, so + I hacked together a BiBTeX style to do that. These macros are not + polished or in the form of a proper distribution, but I have used them + with succes myself. + + The following discription have been made in haste. I will document it + better when I have the time (RSN :-). + + There are two files: [1]inlinebib.sty and [2]indexing.bst. + +The idea + + This works just like any other BiBTeX style. It will still generate + the bibliography at the end of the document, but it will also store + all the entries in the .aux files, so they can be inlined in the + following latex run. + + The first time a citation is made using \cite the complete + bibliography entry is inserted. The following citations to the same + entry will generate a short form, with only authors last name and a + shortened title, followed by a "cit.". If the same bibliography entry + is cited several times in a row, the text will only be "ibid.". + + Citations of this form are designed to be used in footnotes. + + A little example migth be appropriate (don't we all love + screenshots!). + + Footnotes from page one: + [Example 1] + + Footnotes from page two: + [Example 2] + + (the overstrike problem is courtesy of xdvi(1)) + + It is not possible to avoid having the complete bibliography at the + end of the document. The macros simply won't work without it. If you + don't need it, just don't print it. + +Usage + + Formalities + + To use these macros put the file inlinebib.sty in your LaTeX search + path and inlinebib.bst in your BiBTeX style search path and then put + the line: + +\usepackage{inlinebib} + + in the preamble of your document. + + Other commands have to be added at the point where you want the + bibliography to appear, usually at the end of the document. To tell + BiBTeX to use the inlinebib style, you have to use bibliographystyle: + +\bibliographystyle{inlinebib} + + Often I add a leading explanation to the bibliography with the + \bibliographycomment macro. That is: + +\bibliographycomment{This bibliography ...} + + The actual index is produced by the \bibliography macro. Here you have + to specify which BiBTeX databases you want to use. + +\bibliography{file ...} + + These were all the formalities. + + Doing citations + + When writing, just make citations as usual. Remember that these macros + can produce very verbose references, and they are intended for + footnotes. + + The default implementation of \cite allows several bibliography + entries to be cited. This version allows only one at a time. It still + supports the optional argument, which should be a page reference + within the cited text. + + There are a few additional macros available. \fullycite forces a + reference in the long form, \shortcite forces the short form, and + \noibid disables the generation "ibid." references for the next + citation (this can for example be used at the end of each chapter). + + To force later citations for certain entries to be either long or + short, the macros \fullcitenext{} and \shortcitenext{} can be used. + The single argument is a comma separated list of BiBTeX labels that + should be either long or short the next time they are cited. E.g., the + code \fullcitenext{book1, book2} will cause LaTeX to forget that the + two references might have been seen earlier and they will be handled + as if they haven't be cited yet. + + The BiBTeX databases + + This style does not require special changes to the BiBTeX databases. + + Sometimes the BiBTeX style doesn't manage to calculate the proper + short forms of the author and the title. In that case the BiBTeX + entries in question can be extended with shortauthor = {shorter author + name} and shorttitle = {short form of title}. + +Tips and tricks + + I have some macros to format page ranges, that I use with this BiBTeX + style. They should be usable with other styles as well. + + The macros are here: [3]pageranges.sty + + This file defined one user visible macro: \pages{}, which will do the + following transformations of the single argument: + + \pages{N} + becomes: p.~N + + \pages{N-} + becomes: pp.~N~ff + + \pages{N-M} + becomes: pp.~N--M + + \pages{N M} + becomes: pp.~N M + + The last version is for cases like \pages{213, 345 and~654} which will + become pp.~213, 345 and~654. + + I often have this little definition in a LaTeX style file. It makes + \cite do page ranges automatically and also puts the author in the + index (see [4]the indexing macros). + +%% Automatically fix page ranges in citations and index author +\let\RS@citex\@citex +\def\@citex[#1]#2{\I@indexonly-{#2}\RS@citex[\pages{#1}]{#2}} + +Comments + + If you have comments, please [5]write me. + +References + + 1. http://www.seindal.dk/rene/software/TeX/inlinebib.sty + 2. http://www.seindal.dk/rene/software/TeX/inlinebib.bst + 3. http://www.seindal.dk/rene/software/TeX/pageranges.sty + 4. http://www.seindal.dk/rene/software/TeX/indexing.htm + 5. mailto:rene@seindal.dk?Subject=Inlinebibmacros diff --git a/Master/texmf-dist/doc/bibtex/inlinebib/inlinebib1.gif b/Master/texmf-dist/doc/bibtex/inlinebib/inlinebib1.gif new file mode 100644 index 00000000000..6bcbbd0c8c3 Binary files /dev/null and b/Master/texmf-dist/doc/bibtex/inlinebib/inlinebib1.gif differ diff --git a/Master/texmf-dist/doc/bibtex/inlinebib/inlinebib2.gif b/Master/texmf-dist/doc/bibtex/inlinebib/inlinebib2.gif new file mode 100644 index 00000000000..8aaec961c0f Binary files /dev/null and b/Master/texmf-dist/doc/bibtex/inlinebib/inlinebib2.gif differ -- cgit v1.2.3