Load /tmp/tmp.JUKpM13035/jabref-2.0.1+2.1b2 into
[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 For book entries, use the <tt>title</tt> field instead.
89     <p>
90     </p>
91   </li>
92   <li><strong>chapter<br>
93     </strong>A chapter (or section or whatever) number.
94     <p>
95     </p>
96   </li>
97   <li><strong>crossref<br>
98     </strong>The database key of the entry being cross referenced.
99     <p>
100     </p>
101   </li>
102   <li><strong>edition<br>
103     </strong>The edition of a book--for example, ``Second''.
104 This should be an ordinal, and
105 should have the first letter capitalized, as shown here;
106 the standard styles convert to lower case when necessary.
107     <p>
108     </p>
109   </li>
110   <li><strong>editor<br>
111     </strong>This field is analogue to the <em>author</em> field.
112 If there is also an <tt>author</tt> field, then
113 the <tt>editor</tt> field gives the editor of the book or collection
114 in which the reference appears.
115     <p>
116     </p>
117   </li>
118   <li><strong>howpublished<br>
119     </strong>How something strange has been published.
120 The first word should be capitalized.
121     <p>
122     </p>
123   </li>
124   <li><strong>institution<br>
125     </strong>The sponsoring institution of a technical report.
126     <p>
127     </p>
128   </li>
129   <li><strong>journal<br>
130     </strong>A journal name.
131 The name of a journal can be abbreviated using a "string".
132 To define such string, use the <a href="StringEditorHelp.html">string editor</a>.
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 (jan, feb, mar, apr, may, jun, jul, aug, sep, oct, nov, dec).
148     <p>
149     </p>
150   </li>
151   <li><strong>note<br>
152     </strong>Any additional information that can help the reader.
153 The first word should be capitalized.
154     <p>
155     </p>
156   </li>
157   <li><strong>number</strong><br>
158 The number of a journal, magazine, technical report,
159 or of a work in a series.
160 An issue of a journal or magazine is usually
161 identified by its volume and number;
162 the organization that issues a
163 technical report usually gives it a number;
164 and sometimes books are given numbers in a named series.
165     <p>
166     </p>
167   </li>
168   <li><strong>organization<br>
169     </strong>The organization that sponsors a conference or that publishes a manual.
170     <p>
171     </p>
172   </li>
173   <li><strong>pages<br>
174     </strong>One or more page numbers or range of numbers,
175 such as <tt>42-111</tt> or <tt>7,41,73-97</tt> or <tt>43+</tt>
176 (the `<tt>+</tt>' in this last example indicates pages following
177 that don't form a simple range).
178 To make it easier to maintain <em>Scribe</em>-compatible databases,
179 the standard styles convert a single dash (as in <tt>7-33</tt>)
180 to the double dash used in TeX to denote number ranges
181 (as in <tt>7-33</tt>).
182     <p>
183     </p>
184   </li>
185   <li><strong>publisher<br>
186     </strong>The publisher's name.
187     <p>
188     </p>
189   </li>
190   <li><strong>school<br>
191     </strong>The name of the school where a thesis was written.
192     <p>
193     </p>
194   </li>
195   <li><strong>series<br>
196     </strong>The name of a series or set of books.
197 When citing an entire book, the <tt>title</tt> field
198 gives its title and an optional <tt>series</tt> field gives the
199 name of a series or multi-volume set
200 in which the book is published.
201     <p>
202     </p>
203   </li>
204   <li><strong>title<br>
205     </strong>The work's title. The capitalization may depend on
206 the bibliography style and on the language used. For words that
207 have to be capitalized (such as a proper noun), enclose the word
208 (or its first letter) in braces.
209     <p>
210     </p>
211   </li>
212   <li><strong>type<br>
213     </strong>The type of a technical report--for example,
214 ``Research Note''.
215     <p>
216     </p>
217   </li>
218   <li><strong>volume<br>
219     </strong>The volume of a journal or multivolume book.
220     <p>
221     </p>
222   </li>
223   <li><strong>year<br>
224     </strong>The year of publication or, for
225 an unpublished work, the year it was written.
226 Generally it should consist of four numerals, such as <tt>1984</tt>,
227 although the standard styles can handle any <tt>year</tt> whose
228 last four nonpunctuation characters are numerals,
229 such as `(about 1984)'. This field is required
230 for most entry types.</li>
231 </ul>
232
233
234
235
236
237
238 <br>
239
240
241 <h2>Other fields</h2>
242
243
244
245 BibTeX is extremely popular, and many people have used it to store
246 information.  Here is a list of some of the more common fields:
247
248 <dl>
249
250
251 </dl>
252
253 <ul>
254
255   <li><strong><span style="font-weight: normal; font-style: italic;">affiliation*</span><br>
256     </strong>The authors affiliation.<br>
257     <br>
258
259   </li>
260   <li><strong>abstract<br>
261     </strong>An abstract of the work.<br>
262     <br>
263
264   </li>
265   <li><strong><span style="font-weight: normal; font-style: italic;">contents*</span><br>
266     </strong>A Table of Contents<br>
267     <br>
268
269   </li>
270   <li><strong><span style="font-weight: normal; font-style: italic;">copyright*</span><br>
271     </strong>Copyright information.<br>
272     <br>
273   </li>
274   <li><strong><span style="font-weight: normal; font-style: italic;">ISBN*</span><br>
275     </strong>The International Standard Book Number.<br>
276     <br>
277
278   </li>
279   <li><strong><span style="font-weight: normal; font-style: italic;">ISSN*</span><br>
280     </strong>The International Standard Serial Number.  Used to identify a journal.<br>
281     <br>
282
283   </li>
284   <li><strong>keywords<br>
285     </strong>Key words used for searching or possibly for annotation.<br>
286     <br>
287
288   </li>
289   <li><strong><span style="font-weight: normal; font-style: italic;">language*</span><br>
290     </strong>The language the document is in.<br>
291     <br>
292
293   </li>
294   <li><strong><span style="font-weight: normal; font-style: italic;">location*</span><br>
295     </strong>A location associated with the entry, such as the city in which a conference took place.<br>
296     <br>
297
298   </li>
299   <li><strong><span style="font-weight: normal; font-style: italic;">LCCN*</span><br>
300     </strong>The Library of Congress Call Number.  I've also seen this as <tt>lib-congress</tt>.<br>
301     <br>
302
303   </li>
304   <li><strong><span style="font-weight: normal; font-style: italic;">mrnumber*</span><br>
305     </strong>The <i>Mathematical Reviews</i> number.<br>
306     <br>
307
308   </li>
309   <li><strong><span style="font-weight: normal; font-style: italic;">price*</span><br>
310     </strong>The price of the document.<br>
311     <br>
312
313   </li>
314   <li><strong><span style="font-weight: normal; font-style: italic;">size*</span><br>
315     </strong>The physical dimensions of a work.<br>
316     <br>
317
318   </li>
319   <li><strong>URL<br>
320     </strong>The WWW Universal Resource Locator that points to the item being
321     referenced.  This often is used for technical reports to point to
322     the ftp site where the postscript source of the report is located.
323
324   </li>
325 </ul>
326
327 <dl>
328
329
330 </dl>
331
332
333
334
335
336
337 <h3><br>
338 </h3>
339
340
341
342 <h3>JuraBib</h3>
343
344
345
346
347 <ul>
348
349   <li><strong>urldate<br>
350     </strong>The date of the last page visit.</li>
351
352 </ul>
353
354
355 <br>
356
357 *) not direct supported by JabRef<br>
358
359
360
361
362
363
364
365 <br>
366
367
368
369 </body></html>