bib2html
NAME
bib2html - BibTeX bibliography to HTML converter
SYNOPSIS
bib2html [ -a ] [ -c ] [ -d delimiter ] [ -h heading ] [ - r
] -s style ] [ -t ] [ -v ] [ -3 ] sourcefile [ htmlfile ]
DESCRIPTION
bib2html converts a bibtex-format bibliography file to HTML.
sourcefile may be either a BibTeX-format bibliography (.bib)
file or a LaTeX-format (.aux) file.
Since the HTML-formatted bibliography will often be just
part of a larger HTML file, bib2html attempts to update the
HTML file in place. It does this by searching htmlfile for
two special strings, which delimit the bibliography part of
the file. These strings are the HTML comments
<!-- BEGIN BIBLIOGRAPHY delimiter -->
<!-- END BIBLIOGRAPHY delimiter -->
If these delimiters are found, the old bibliography between
them is replaced with the new bibliography. Otherwise the
new bibliography, with the appropriate delimiters, is
appended to the end of htmlfile, and it will be necessary to
move it to the proper location by hand. Note that it is
possible for htmlfile to contain any number of bibliogra-
phies, and they may be updated independently. If no
htmlfile is specified, the bibliography is written to stan-
dard output.
The tag of each BibTeX bibliography entry is converted into
a name anchor (<A NAME="tag">) in htmlfile, and may be used
to construct a link to this particular entry.
Special Field Processing
Several BibTeX fields are treated specially. The filenames
specified in the postscript, pdf, and dvi fields are rela-
tive to the htmlfile directory. In addition, bib2html
recognizes compressed or gzipped files (those with filenames
ending in .Z, .gz, or .z).
url If the url field exists, a link (``A'' tag) is created.
The destination of the link is the url tag's value.
The bibliography entry's title is the source of the
link. This can be used to create a link to a HTML ver-
sion of the paper, or to a version that is available by
ftp.
postscript
If the postscript field exists, its value is used as
the name of a PostScript file. bib2html creates a link
to the file. , and updates htmlfile with the number of
pages and size of the PostScript file.
pdf If the pdf field exists, its value is used as the name
of a PDF (portable document format) file. bib2html
creates a link to the file and updates htmlfile with
the size of the PDF file.
dvi If the dvi field exists, its value is used as the name
of a TeX DVI file. bib2html creates a link to the file
and updates htmlfile with the number of pages and size
of the DVI file.
author, keywords
The full author and keywords fields of each BibTeX
entry are included in htmlfile as HTML comments, and
may be used by CGI scripts (such as bibsearch, which is
supplied) to select only certain entries.
Hints
bib2html's LaTeX to HTML conversion is not very smart. If
something isn't being converted correctly, try doing it in a
different way.
bib2html does not currently understand \verb. To get a
tilde into a filename or URL, use \~{}.
OPTIONS
-a Include the BibTeX file's abstract field in the
bibliography.
-c Sort chronologically. Normally, the bibliography is
ordered first by author and then by year. With this
option, the bibliography is ordered by year and then
author.
-d delimiter
Specify the delimiter that sets the bibliography off
from the rest of the HTML file. The default delimiter
is the name of the bibliography file with the .bib
extension stripped.
-h heading
Use the string heading instead of the default title
when creating a new htmlfile. If updating an existing
htmlfile, this option is ignored.
-r Reverse the chronological sorting order. Normally, the
bibliography is sorted from the earliest entry to the
latest entry. With this option, the order is reversed.
-s style
Create a style-style bibliography. Supported styles
are empty (the default), plain, unsort, alpha, and
named. An empty bibliography is a bulleted list. A
plain bibliography is a numbered list. unsort is like
plain except that the entries in the HTML file are in
the same order as as they are in the source file. An
alpha bibliography has labels that are in the BibTeX
alpha style. A named bibliography has labels of the
form [name, year].
-t Write a timestamp with the date at which the bibliog-
raphy was updated to htmlfile.
-v Report version number on stderr.
-3 Perform some HTML 3.0 mappings.
FILES
html-a.bst alpha HTML BibTeX style file
html-n.bst named HTML BibTeX style file
html-u.bst unsort HTML BibTeX style file
html-aa.bst, html-na.bst, html-ua.bst
versions of the above style files with
abstracts
bibsearch a CGI script for performing bibliography
searches
SEE ALSO
perl(L), bibtex(L).
BUGS
The LaTeX to HTML translation, while decent, is not perfect.
Requires bibtex and perl. However, I think that most sites
that would want to convert BibTeX to HTML will already have
both programs installed.
Relies on dviselect to count the number of pages in a DVI
file.
AUTHOR
David Hull (hull@cs.uiuc.edu), University of Illinois at
Urbana-Champaign. See
http://pertsserver.cs.uiuc.edu/~hull/bib2html/ for the
latest version. This is free software, and may be modified
or redistributed under the terms of the GNU Public License.