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)'.