NAME
BibTeX2HTML - A translator of bibliography databases into HTML
SYNOPSIS
bibtex2html [options] <filename>
DESCRIPTION
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.
OPTIONS
General aspect of the HTML document
-t string, --title string
specify the title of the HTML file (default is the file name).
--header string
give an additional header for the HTML document.
--footer string
give an additional footer for the HTML document.
-s string, --style string
use BibTeX style string (plain, alpha, etc.). Default style is
plain.
-noabstract, --no-abstract
do not print the abstracts (if any).
-nokeywords, --no-keywords
do not print the keywords (if any).
-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.
-nokeys, --no-keys
do not print the cite keys.
-use-keys, --use-keys
use the cite keys from the BibTeX input file (and not the ones
generated by the BibTeX style file).
-rawurl, --raw-url
print URLs instead of files’ types.
-heveaurl, --hevea-url
interpret the macro rl 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).
-f field, --field field
add a web link for that BibTeX field.
-nf field string, --named-field field string
similar to -f but specifies the way to display the link (e.g.
-nf springer "At Springer’s").
-note field, --note field
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.
-multiple, --multiple
make a separate web page for each entry. Beware: this option
produces as many HTML files as BibTeX entries!
-single, --single
produce a single document, inserting each BibTeX entry (the
input) right after its BibTeX output.
-bg color, --background color
set the background color of the HTML file (default is none).
-css file, --style-sheet file
set a style sheet file for the HTML document (default is none).
-charset c, --charset c
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.
-dl, --dl
use HTML DL lists instead of HTML tables to format entries.
-unicode, --unicode
use Unicode entities for some macros, such as ⊨ for
\models, etc.
-html-entities, --html-entities
use HTML entities for some macros, such as ≈ for \approx,
etc.
Controlling the translation
-m file, --macros-from file
read the LATEX macros in the given file. Note: bibtex2html does
not handle macros arguments; arguments are simply discarded.
-noexpand, --no-expand
do not expand the abbreviation strings, leave them in the output
file.
Selecting the entries
-citefile filename, --citefile filename
Select only keys appearing in filename. To be used manually or
in conjonction with bib2bib.
-e key, --exclude key
exclude an particular entry.
Sorting the entries
-d, --sort-by-date
sort by date.
-a, --sort-as-bibtex
sort as BibTeX (usually by author).
-u, --unsorted
unsorted i.e. same order as in .bib file (default).
-r, --reverse-sort
reverse the sort.
--revkeys
number entries in reverse order (i.e. from n to 1 in plain
style).
Miscellaneous options
--print-keys
do not produce any HTML documents but write to stdout the sorted
list of BibTeX keys (one key per line).
-nodoc, --nodoc
do not produce a full HTML document but only its body (useful to
merge the HTML bibliography in a bigger HTML document).
-nobibsource, --nobibsource
do not produce the _bib.html file. In that case, no BibTeX entry
links are inserted in the HTML file.
-suffix string, --suffix string
give an alternate suffix string for both HTML files and links
(default is .html).
-fsuffix string, --file-suffix string
give an alternate suffix string for HTML files (default is
.html).
-lsuffix string, --link-suffix string
give an alternate suffix string for HTML links (default is
.html).
-o file, --output file
specifies the output file. If file is -, then the standard
output is selected.
-c command, --command command
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.
-i, --ignore-errors
ignore BibTeX errors.
-q, --quiet
be quiet.
-w, --warn-error
stop at the first warning.
-h, --help
print a short usage and exit.
-v, --version
print the version and exit.
-noheader, --no-header
do not insert the bibtex2html command in the HTML document
(default is to insert it as a comment at the beginning).
AUTHOR
Bibtex2html has been written by Jean-Christophe Filliatre and Claude
Marche. This manpage has been compiled by Ralf Treinen from the
original bibtex2html documentation.
SEE ALSO
bib2bib(1),bibtex(1),hevea(1)
http://www.lri.fr/~filliatr/bibtex2html/
For complete documentation, please check the bibtex2html manual. On a
Debian system the manual can be found at /usr/share/doc/bibtex2html
both in the formats postscript and HTML, or via the Debian help system.
BIBTEX2HTML(1)