3  The Entries

This section is simply a corrected version of Appendix B.2 of the LATEX book [2], © 1986, by Addison-Wesley. The basic scheme is the same, only a few details have changed.

3.1  Entry Types

When entering a reference in the database, the first thing to decide is what type of entry it is. No fixed classification scheme can be complete, but BIBTEX provides enough entry types to handle almost any reference reasonably well.

References to different types of publications contain different information; a reference to a journal article might include the volume and number of the journal, which is usually not meaningful for a book. Therefore, database entries of different types have different fields. For each entry type, the fields are divided into three classes:

required
Omitting the field will produce a warning message and, rarely, a badly formatted bibliography entry. If the required information is not meaningful, you are using the wrong entry type. However, if the required information is meaningful but, say, already included is some other field, simply ignore the warning.

optional
The field's information will be used if present, but can be omitted without causing any formatting problems. You should include the optional field if it will help the reader.

ignored
The field is ignored. BIBTEX ignores any field that is not required or optional, so you can include any fields you want in a bib file entry. It's a good idea to put all relevant information about a reference in its bib file entry -- even information that may never appear in the bibliography. For example, if you want to keep an abstract of a paper in a computer file, put it in an abstract field in the paper's bib file entry. The bib file is likely to be as good a place as any for the abstract, and it is possible to design a bibliography style for printing selected abstracts. Note: Misspelling a field name will result in its being ignored, so watch out for typos (especially for optional fields, since BIBTEX won't warn you when those are missing).

The following are the standard entry types, along with their required and optional fields, that are used by the standard bibliography styles. The fields within each class (required or optional) are listed in order of occurrence in the output, except that a few entry types may perturb the order slightly, depending on what fields are missing. These entry types are similar to those adapted by Brian Reid from the classification scheme of van Leunen [4] for use in the Scribe system. The meanings of the individual fields are explained in the next section. Some nonstandard bibliography styles may ignore some optional fields in creating the reference. Remember that, when used in the bib file, the entry-type name is preceded by an @ character.

article     
An article from a journal or magazine. Required fields: author, title, journal, year. Optional fields: volume, number, pages, month, note.

book     
A book with an explicit publisher. Required fields: author or editor, title, publisher, year. Optional fields: volume or number, series, address, edition, month, note.

booklet     
A work that is printed and bound, but without a named publisher or sponsoring institution. Required field: title. Optional fields: author, howpublished, address, month, year, note.

conference     
The same as INPROCEEDINGS, included for Scribe compatibility.

inbook     
A part of a book, which may be a chapter (or section or whatever) and/or a range of pages. Required fields: author or editor, title, chapter and/or pages, publisher, year. Optional fields: volume or number, series, type, address, edition, month, note.

incollection     
A part of a book having its own title. Required fields: author, title, booktitle, publisher, year. Optional fields: editor, volume or number, series, type, chapter, pages, address, edition, month, note.

inproceedings     
An article in a conference proceedings. Required fields: author, title, booktitle, year. Optional fields: editor, volume or number, series, pages, address, month, organization, publisher, note.

manual     
Technical documentation. Required field: title. Optional fields: author, organization, address, edition, month, year, note.

mastersthesis     
A Master's thesis. Required fields: author, title, school, year. Optional fields: type, address, month, note.

misc     
Use this type when nothing else fits. Required fields: none. Optional fields: author, title, howpublished, month, year, note.

phdthesis     
A PhD thesis. Required fields: author, title, school, year. Optional fields: type, address, month, note.

proceedings     
The proceedings of a conference. Required fields: title, year. Optional fields: editor, volume or number, series, address, month, organization, publisher, note.

techreport     
A report published by a school or other institution, usually numbered within a series. Required fields: author, title, institution, year. Optional fields: type, number, address, month, note.

unpublished     
A document having an author and title, but not formally published. Required fields: author, title, note. Optional fields: month, year.

In addition to the fields listed above, each entry type also has an optional key field, used in some styles for alphabetizing, for cross referencing, or for forming a \bibitem label. You should include a key field for any entry whose ``author'' information is missing; the ``author'' information is usually the author field, but for some entry types it can be the editor or even the organization field (Section 4 describes this in more detail). Do not confuse the key field with the key that appears in the \cite command and at the beginning of the database entry; this field is named ``key'' only for compatibility with Scribe.

3.2  Fields

Below is a description of all fields recognized by the standard bibliography styles. An entry can also contain other fields, which are ignored by those styles.

address     
Usually the address of the publisher or other type of institution. For major publishing houses, van Leunen recommends omitting the information entirely. For small publishers, on the other hand, you can help the reader by giving the complete address.

annote     
An annotation. It is not used by the standard bibliography styles, but may be used by others that produce an annotated bibliography.

author     
The name(s) of the author(s), in the format described in the LATEX book.

booktitle     
Title of a book, part of which is being cited. See the LATEX book for how to type titles. For book entries, use the title field instead.

chapter     
A chapter (or section or whatever) number.

crossref     
The database key of the entry being cross referenced.

edition     
The edition of a book -- for example, ``Second''. This should be an ordinal, and should have the first letter capitalized, as shown here; the standard styles convert to lower case when necessary.

editor     
Name(s) of editor(s), typed as indicated in the LATEX book. If there is also an author field, then the editor field gives the editor of the book or collection in which the reference appears.

howpublished     
How something strange has been published. The first word should be capitalized.

institution     
The sponsoring institution of a technical report.

journal     
A journal name. Abbreviations are provided for many journals; see the Local Guide.

key     
Used for alphabetizing, cross referencing, and creating a label when the ``author'' information (described in Section 4) is missing. This field should not be confused with the key that appears in the \cite command and at the beginning of the database entry.

month     
The month in which the work was published or, for an unpublished work, in which it was written. You should use the standard three-letter abbreviation, as described in Appendix B.1.3 of the LATEX book.

note     
Any additional information that can help the reader. The first word should be capitalized.

number     
The number of a journal, magazine, technical report, or of a work in a series. An issue of a journal or magazine is usually identified by its volume and number; the organization that issues a technical report usually gives it a number; and sometimes books are given numbers in a named series.

organization     
The organization that sponsors a conference or that publishes a manual.

pages     
One or more page numbers or range of numbers, such as 42--111 or 7,41,73--97 or 43+ (the `+' in this last example indicates pages following that don't form a simple range). To make it easier to maintain Scribe-compatible databases, the standard styles convert a single dash (as in 7-33) to the double dash used in TEX to denote number ranges (as in 7--33).

publisher     
The publisher's name.

school     
The name of the school where a thesis was written.

series     
The name of a series or set of books. When citing an entire book, the the title field gives its title and an optional series field gives the name of a series or multi-volume set in which the book is published.

title     
The work's title, typed as explained in the LATEX book.

type     
The type of a technical report -- for example, ``Research Note''.

volume     
The volume of a journal or multivolume book.

year     
The year of publication or, for an unpublished work, the year it was written. Generally it should consist of four numerals, such as 1984, although the standard styles can handle any year whose last four nonpunctuation characters are numerals, such as `(about 1984)'.