5aaf241b02062d68ec2a17d21e5f6acc36f8009d
[debian/jabref.git] / src / help / BibtexHelp.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <html><head></head>
3
4 <body style="color: rgb(39, 88, 86);">
5 <basefont size="4" color="#2F4958" face="arial">
6
7 <h1>About <em>bibtex</em></h1>
8
9
10
11
12
13 JabRef helps you work with your <em>bibtex</em> databases, but
14 there are still rules to keep in mind when editing your entries, to
15 ensure that your database is treated properly by the <em>bibtex</em>
16 program.
17
18 <h2><em>Bibtex</em> fields</h2>
19
20
21
22
23
24 There is a lot of different fields in <em>bibtex</em>, and some
25 additional fields that you can set in JabRef. 
26 <p>
27 Generally, you can use LaTeX commands inside of fields containing
28 text. <em>Bibtex</em> will automatically format your reference lists,
29 and those fields that are included in the lists will be
30 (de)capitalized according to your bibliography style. To ensure that
31 certain characters remain capitalized, enclose them in braces, like in
32 the word {B}elgium.
33
34 </p>
35
36
37
38 <p>
39 Notes about some of the field types:
40 </p>
41
42
43
44 <ul>
45
46
47
48 <li><strong style="font-style: italic;">Bibtexkey</strong> A unique string used to refer to the entry in
49 LaTeX documents. Note that when referencing an entry from LaTeX, the
50 key must match case-sensitively with the reference string.<br>
51     <br>
52 </li>
53
54   <li><strong>address<br>
55     </strong>Usually the address of the <tt>publisher</tt> or other type
56 of institution.
57 For major publishing houses,
58 van&nbsp;Leunen recommends omitting the information entirely.
59 For small publishers, on the other hand, you can help the
60 reader by giving the complete address.
61     <p>
62     </p>
63   </li>
64   <li><strong>annote<br>
65     </strong>An annotation.
66 It is not used by the standard bibliography styles,
67 but may be used by others that produce an annotated bibliography.
68     <p>
69     </p>
70   </li>
71   <li><strong>author<br>
72     </strong>This field should contain the complete author
73 list for your entry. The names are separated by the word <em>and</em>,
74 even if there are more than two authors. Each name can be written
75 in two equivalent forms:<br>
76
77  Donald E. Knuth <em>or</em> Knuth, Donald E.<br>
78
79  Eddie van Halen <em>or</em> van Halen, Eddie<br>
80
81
82 The second form should be used for authors with more than two names,
83 to differentiate between middle names and last names.<br>
84     <br>
85     <span style="font-weight: bold;"></span></li>
86   <li><span style="font-weight: bold;"></span><strong>booktitle<br>
87     </strong>Title of a book, part of which is being cited.
88 See the LaTeX book for how to type titles.
89 For book entries, use the <tt>title</tt> field instead.
90     <p>
91     </p>
92   </li>
93   <li><strong>chapter<br>
94     </strong>A chapter (or section or whatever) number.
95     <p>
96     </p>
97   </li>
98   <li><strong>crossref<br>
99     </strong>The database key of the entry being cross referenced.
100     <p>
101     </p>
102   </li>
103   <li><strong>edition<br>
104     </strong>The edition of a book--for example, ``Second''.
105 This should be an ordinal, and
106 should have the first letter capitalized, as shown here;
107 the standard styles convert to lower case when necessary.
108     <p>
109     </p>
110   </li>
111   <li><strong>editor<br>
112     </strong>This field is analogue to the <em>author</em> field.
113 If there is also an <tt>author</tt> field, then
114 the <tt>editor</tt> field gives the editor of the book or collection
115 in which the reference appears.
116     <p>
117     </p>
118   </li>
119   <li><strong>howpublished<br>
120     </strong>How something strange has been published.
121 The first word should be capitalized.
122     <p>
123     </p>
124   </li>
125   <li><strong>institution<br>
126     </strong>The sponsoring institution of a technical report.
127     <p>
128     </p>
129   </li>
130   <li><strong>journal<br>
131     </strong>A journal name.
132 Abbreviations are provided for many journals; see the <i>Local Guide</i>.
133     <p>
134     </p>
135   </li>
136   <li><strong>key<br>
137     </strong>Used for alphabetizing, cross referencing, and creating a label when
138 the ``author'' information is missing.
139 This field should not be confused with the key that appears in the
140     <code>\cite</code> command and at the beginning of the database entry.
141     <p>
142     </p>
143   </li>
144   <li><strong>month<br>
145     </strong>The month in which the work was
146 published or, for an unpublished work, in which it was written.
147 You should use the standard three-letter abbreviation,
148 as described in Appendix B.1.3 of the LaTeX book.
149     <p>
150     </p>
151   </li>
152   <li><strong>note<br>
153     </strong>Any additional information that can help the reader.
154 The first word should be capitalized.
155     <p>
156     </p>
157   </li>
158   <li><strong>number</strong><br>
159 The number of a journal, magazine, technical report,
160 or of a work in a series.
161 An issue of a journal or magazine is usually
162 identified by its volume and number;
163 the organization that issues a
164 technical report usually gives it a number;
165 and sometimes books are given numbers in a named series.
166     <p>
167     </p>
168   </li>
169   <li><strong>organization<br>
170     </strong>The organization that sponsors a conference or that publishes a manual.
171     <p>
172     </p>
173   </li>
174   <li><strong>pages<br>
175     </strong>One or more page numbers or range of numbers,
176 such as <tt>42-111</tt> or <tt>7,41,73-97</tt> or <tt>43+</tt>
177 (the `<tt>+</tt>' in this last example indicates pages following
178 that don't form a simple range).
179 To make it easier to maintain <em>Scribe</em>-compatible databases,
180 the standard styles convert a single dash (as in <tt>7-33</tt>)
181 to the double dash used in TeX to denote number ranges
182 (as in <tt>7-33</tt>).
183     <p>
184     </p>
185   </li>
186   <li><strong>publisher<br>
187     </strong>The publisher's name.
188     <p>
189     </p>
190   </li>
191   <li><strong>school<br>
192     </strong>The name of the school where a thesis was written.
193     <p>
194     </p>
195   </li>
196   <li><strong>series<br>
197     </strong>The name of a series or set of books.
198 When citing an entire book, the the <tt>title</tt> field
199 gives its title and an optional <tt>series</tt> field gives the
200 name of a series or multi-volume set
201 in which the book is published.
202     <p>
203     </p>
204   </li>
205   <li><strong>title<br>
206     </strong>The work's title, typed as explained in the LaTeX book.
207     <p>
208     </p>
209   </li>
210   <li><strong>type<br>
211     </strong>The type of a technical report--for example,
212 ``Research Note''.
213     <p>
214     </p>
215   </li>
216   <li><strong>volume<br>
217     </strong>The volume of a journal or multivolume book.
218     <p>
219     </p>
220   </li>
221   <li><strong>year<br>
222     </strong>The year of publication or, for
223 an unpublished work, the year it was written.
224 Generally it should consist of four numerals, such as <tt>1984</tt>,
225 although the standard styles can handle any <tt>year</tt> whose
226 last four nonpunctuation characters are numerals,
227 such as `(about 1984)'. This field is required
228 for most entry types.</li>
229 </ul>
230
231
232
233
234
235
236 <br>
237
238
239 <h2>Other fields</h2>
240
241
242
243 BibTeX is extremely popular, and many people have used it to store
244 information.  Here is a list of some of the more common fields:
245
246 <dl>
247
248
249 </dl>
250
251 <ul>
252
253   <li><strong><span style="font-weight: normal; font-style: italic;">affiliation*</span><br>
254     </strong>The authors affiliation.<br>
255     <br>
256
257   </li>
258   <li><strong>abstract<br>
259     </strong>An abstract of the work.<br>
260     <br>
261
262   </li>
263   <li><strong><span style="font-weight: normal; font-style: italic;">contents*</span><br>
264     </strong>A Table of Contents<br>
265     <br>
266
267   </li>
268   <li><strong><span style="font-weight: normal; font-style: italic;">copyright*</span><br>
269     </strong>Copyright information.<br>
270     <br>
271   </li>
272   <li><strong><span style="font-weight: normal; font-style: italic;">ISBN*</span><br>
273     </strong>The International Standard Book Number.<br>
274     <br>
275
276   </li>
277   <li><strong><span style="font-weight: normal; font-style: italic;">ISSN*</span><br>
278     </strong>The International Standard Serial Number.  Used to identify a journal.<br>
279     <br>
280
281   </li>
282   <li><strong>keywords<br>
283     </strong>Key words used for searching or possibly for annotation.<br>
284     <br>
285
286   </li>
287   <li><strong><span style="font-weight: normal; font-style: italic;">language*</span><br>
288     </strong>The language the document is in.<br>
289     <br>
290
291   </li>
292   <li><strong><span style="font-weight: normal; font-style: italic;">location*</span><br>
293     </strong>A location associated with the entry, such as the city in which a conference took place.<br>
294     <br>
295
296   </li>
297   <li><strong><span style="font-weight: normal; font-style: italic;">LCCN*</span><br>
298     </strong>The Library of Congress Call Number.  I've also seen this as <tt>lib-congress</tt>.<br>
299     <br>
300
301   </li>
302   <li><strong><span style="font-weight: normal; font-style: italic;">mrnumber*</span><br>
303     </strong>The <i>Mathematical Reviews</i> number.<br>
304     <br>
305
306   </li>
307   <li><strong><span style="font-weight: normal; font-style: italic;">price*</span><br>
308     </strong>The price of the document.<br>
309     <br>
310
311   </li>
312   <li><strong><span style="font-weight: normal; font-style: italic;">size*</span><br>
313     </strong>The physical dimensions of a work.<br>
314     <br>
315
316   </li>
317   <li><strong>URL<br>
318     </strong>The WWW Universal Resource Locator that points to the item being
319     referenced.  This often is used for technical reports to point to
320     the ftp site where the postscript source of the report is located.
321
322   </li>
323 </ul>
324
325 <dl>
326
327
328 </dl>
329
330
331
332
333
334
335 <h3><br>
336 </h3>
337
338
339
340 <h3>JuraBib</h3>
341
342
343
344
345 <ul>
346
347   <li><strong>urldate<br>
348     </strong>The date of the last page visit.</li>
349
350 </ul>
351
352
353 <br>
354
355 *) not direct supported by JabRef<br>
356
357
358
359
360
361
362
363 <br>
364
365
366
367 </body></html>