summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/bibtex/inlinebib/inlinebib.txt
blob: cfd51dcee57c89438472c0be1cb6ff6077cc27e4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
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