.TH BIBTEX2HTML 1
.SH NAME
BibTeX2HTML \- A translator of bibliography databases into HTML
.SH SYNOPSIS
.B bibtex2html [options]
.SH DESCRIPTION
.B bibtex2html
is a translator which reads a bibliography file and outputs two HTML
documents that contain respectively the cited bibliography in a nice
presentation, and the original BibTeX file augmented with several
transparent HTML links to allow easy navigation.
.SH OPTIONS
.SS General aspect of the HTML document
.TP
.B \-t \fIstring\fB, \-\-title \fIstring
specify the title of the HTML file (default is the file name).
.TP
.B \-\-header \fIstring
give an additional header for the HTML document.
.TP
.B \-\-footer \fIstring
give an additional footer for the HTML document.
.TP
.B \-s \fIstring\fB, \-\-style \fIstring\fB
use BibTeX style \fIstring\fR (plain, alpha, etc.). Default style is plain.
.TP
.B \-noabstract, \-\-no\-abstract
do not print the abstracts (if any).
.TP
.B \-nokeywords, \-\-no\-keywords
do not print the keywords (if any).
.TP
.B \-both, \-\-both
produce both pages with and without abstracts. If the BibTeX file is
foo.bib then the two pages will be respectively foo.html and
foo_abstracts.html (The suffix may be different, see option
\-\-suffix). Links are inserted from the page without abstracts to the
page with abstracts.
.TP
.B \-nokeys, \-\-no\-keys
do not print the cite keys.
.TP
.B \-use\-keys, \-\-use\-keys
use the cite keys from the BibTeX input file (and not the ones
generated by the BibTeX style file).
.TP
.B \-rawurl, \-\-raw\-url
print URLs instead of files' types.
.TP
.B \-heveaurl, \-\-hevea-url
interpret the macro \\url as HeVeA's one, i.e. with two arguments,
the first one being the url and the second one the text to print. The
default behavior is to interpret the macro \\url as the one from the
package url, which has only one argument (the url itself).
.TP
.B \-f \fIfield\fB, \-\-field \fIfield\fB
add a web link for that BibTeX field.
.TP
.B \-nf \fIfield string\fB, \-\-named\-field \fIfield string
similar to \-f but specifies the way to display the link (e.g. \-nf springer
"At Springer's").
.TP
.B \-note \fIfield\fB, \-\-note \fIfield\fB
declare that a field must be treated like the abstract field, i.e. is
an annotation to be displayed as a text paragraph below the entry.
.TP
.B \-multiple, \-\-multiple
make a separate web page for each entry. Beware: this option produces
as many HTML files as BibTeX entries!
.TP
.B \-single, \-\-single
produce a single document, inserting each BibTeX entry (the input)
right after its BibTeX output.
.TP
.B \-bg \fIcolor\fB, \-\-background \fIcolor
set the background color of the HTML file (default is none).
.TP
.B
\-css \fIfile\fB, \-\-style\-sheet \fIfile\fB
set a style sheet file for the HTML document (default is none).
.TP
.B \-charset \fIc\fB, \-\-charset \fIc\fB
specify the charset to use in the META tag of generated html
files. The default is the output of the command locale charmap, or if
this doesn't work, ISO-8859-1.
.TP
.B \-dl, \-\-dl
use HTML DL lists instead of HTML tables to format entries.
.TP
.B \-unicode, \-\-unicode
use Unicode entities for some macros, such as ⊨ for \\models, etc.
.TP
.B \-html\-entities, \-\-html\-entities
use HTML entities for some macros, such as ≈ for \\approx, etc.
.SS Controlling the translation
.TP
.B \-m \fIfile\fB, \-\-macros\-from \fIfile\fB
read the LATEX macros in the given file. Note: bibtex2html does not
handle macros arguments; arguments are simply discarded.
.TP
.B
\-noexpand, \-\-no\-expand
do not expand the abbreviation strings, leave them in the output file.
.SS Selecting the entries
.TP
.B \-citefile \fIfilename\fB, \-\-citefile \fIfilename
Select only keys appearing in \fIfilename\fR. To be used manually or in
conjonction with bib2bib.
.TP
.B \-e \fIkey\fB, \-\-exclude \fIkey
exclude an particular entry.
.SS Sorting the entries
.TP
.B \-d, \-\-sort\-by\-date
sort by date.
.TP
.B \-a, \-\-sort\-as\-bibtex
sort as BibTeX (usually by author).
.TP
.B \-u, \-\-unsorted
unsorted i.e. same order as in .bib file (default).
.TP
.B \-r, \-\-reverse\-sort
reverse the sort.
.TP
.B \-\-revkeys
number entries in reverse order (i.e. from n to 1 in plain style).
.SS Miscellaneous options
.TP
.B \-\-print\-keys
do not produce any HTML documents but write to \fIstdout\fR the sorted list
of BibTeX keys (one key per line).
.TP
.B \-nodoc, \-\-nodoc
do not produce a full HTML document but only its body (useful to
merge the HTML bibliography in a bigger HTML document).
.TP
.B \-nobibsource, \-\-nobibsource
do not produce the _bib.html file. In that case, no BibTeX
entry links are inserted in the HTML file.
.TP
.B \-suffix \fIstring\fB, \-\-suffix \fIstring
give an alternate suffix string for both HTML files and links (default
is .html).
.TP
.B \-fsuffix \fIstring\fB, \-\-file\-suffix \fIstring
give an alternate suffix string for HTML files (default is .html).
.TP
.B \-lsuffix \fIstring\fB, \-\-link\-suffix \fIstring
give an alternate suffix string for HTML links (default is .html).
.TP
.B \-o \fIfile\fB, \-\-output \fIfile
specifies the output file. If \fIfile\fR is -, then the standard output is
selected.
.TP
.B \-c \fIcommand\fB, \-\-command \fIcommand
specify the BibTeX command (default is bibtex
\-min-crossrefs=1000). May be useful for example if you need to specify
the full path of the bibtex command.
.TP
.B \-i, \-\-ignore\-errors
ignore BibTeX errors.
.TP
.B \-q, \-\-quiet
be quiet.
.TP
.B \-w, \-\-warn-error
stop at the first warning.
.TP
.B \-h, \-\-help
print a short usage and exit.
.TP
.B \-v, \-\-version
print the version and exit.
.TP
.B \-noheader, \-\-no-header
do not insert the bibtex2html command in the HTML document (default is to
insert it as a comment at the beginning).
.SH AUTHOR
Bibtex2html has been written by Jean-Christophe Filliâtre and Claude
Marché. This manpage has been compiled by Ralf Treinen from the original
bibtex2html documentation.
.SH SEE ALSO
.BR bib2bib (1), bibtex (1), hevea (1)
.br
.I http://www.lri.fr/~filliatr/bibtex2html/
.P
For complete documentation, please check the bibtex2html manual.
On a Debian system the manual can be found at
.I /usr/share/doc/bibtex2html
both in the formats postscript and HTML, or via the Debian help system.