NAME

bibtexconv —

BibTeX Converter

SYNOPSIS

bibtexconv BibTeX_file [-export-to-bibtex=file] [-export-to-separate-bibtexs=prefix] [-export-to-xml=file] [-export-to-separate-xmls=prefix] [-nbsp=string] [-linebreak=string] [-non-interactive] [-check-urls] [-only-check-new-urls] [-store-downloads=directory] [-add-url-command] [-skip-notes-with-isbn-and-issn] [-add-notes-with-isbn-and-issn]

DESCRIPTION

bibtexconv is a BibTeX file converter which allows one to export BibTeX entries to other formats, including customly defined text output. Furthermore, it provides the possibility to check URLs (including MD5, size and MIME type computations) and to verify ISBN and ISSN numbers.
bibtexconv provides an interactive mode (usually used in form of export scripts) which allows for fine-granular selection of entries, sorting and export template specification.

OPTIONS

The following arguments may be provided:

BibTeX_File: The BibTeX input file.
-export-to-bibtex=file: Write the results as BibTeX into the given file.
-export-to-separate-bibtexs=prefix: Write the results as BibTeX; for each entry, an own file will be created. The filename will be generated from given prefix (e.g. "/tmp/MyBibTex-"), the entry key and ".bib".
-export-to-xml=file: Write the results as XML (as used by IETF Internet Draft processing tools) into the given file.
-export-to-separate-xmls=prefix: Write the results as XML; for each entry, an own file will be created. The filename will be generated from given prefix (e.g. "/tmp/MyBibTex-"), the entry key and ".xml".
-nbsp=string: Replace non-breakable space by given string (for example, " " when writing HTML).
-linebreak=string: Replace linebreak by given string (for example, "<br />" when writing HTML).
-check-urls: Check URLs by downloading the content file and adding MD5, size and MIME type entries.
-only-check-new-urls: Combined with -check-urls, checks are only performed for new entries where MD5, size and/or MIME type are still unknown.
-store-downloads=directory: Combined with -check-urls, all checked references are downloaded and stored in the given directory. Existing files will be overwritten.
-add-url-command: Add \url{} commands to url tags in BibTeX export.
-skip-notes-with-isbn-and-issn: When reading the BibTeX file, ignore "note" items with ISBN and ISSN.
-add-notes-with-isbn-and-issn: When writing a BibTeX file, create "note" items with ISBN and ISSN.
-non-interactive: Turns on non-interactive mode. Useful for just performing URL checks and ISBN/ISSN verification.

COMMANDS

After startup, bibtexconv accepts the following commands from standard input (not as command-line arguments!):

cite key custom1 custom2 custom3 custom4 custom5: Select specific entry in the input BibTeX file, given by key. Optionally, up to five custom strings may be attached to the selected entry.
citeAll: Select all entries in the input BibTeX file.
clear: Clear all selections.
echo string: Write given string to standard output.
export: Export selected entries to standard output, according to configured printing template.
header
include file: Include another export script, given by file name.
monthNames jan feb mar apr may jun jul aug sep oct nov dec: Changes textual representation of month names. This is necessary when non-English names are required for export.
nbsp: Changes textual representation of the "non-breakable space", for example   in HTML or ~ in BibTeX.
sort
template
template+
templatenew
trailer
utf8Style
xmlStyle

EXAMPLES

Have a look into /usr/share/doc/bibtexconv/examples/ (or corresponding path of your system) for example export scripts. The export scripts contain the commands which are read by bibtexconv from standard input.

bibtexconv \: /usr/share/doc/bibtexconv/examples/ExampleReferences.bib \
-export-to-bibtex=UpdatedReferences.bib \
-check-urls -only-check-new-urls -non-interactive
Checks URLs of all entries in /usr/share/doc/bibtexconv/examples/ExampleReferences.bib, adds MD5, size and MIME type items and writes the results to UpdatedReferences.bib.
bibtexconv \: /usr/share/doc/bibtexconv/examples/ExampleReferences.bib \
</usr/share/doc/bibtexconv/examples/web-example.export >MyPublications.html
Uses export script /usr/share/doc/bibtexconv/examples/web-example.export to export references from /usr/share/doc/bibtexconv/examples/ExampleReferences.bib to MyPublications.html as XHTML 1.1.
bibtexconv \: /usr/share/doc/bibtexconv/examples/ExampleReferences.bib \
</usr/share/doc/bibtexconv/examples/text-example.export >MyPublications.txt
Uses export script /usr/share/doc/bibtexconv/examples/text-example.export to export references from /usr/share/doc/bibtexconv/examples/ExampleReferences.bib to MyPublications.txt as plain text.
bibtexconv \: /usr/share/doc/bibtexconv/examples/ExampleReferences.bib \
-non-interactive -export-to-separate-xmls=reference.
Convert all references to XML references to be includable in IETF Internet Drafts. For each reference, an own file is generated, named with the prefix "reference.", for example reference.Globecom2010.xml for entry Globecom2010.
bibtexconv \: /usr/share/doc/bibtexconv/examples/ExampleReferences.bib \
-non-interactive -export-to-separate-bibtexs=
Convert all references to BibTeX references. For each reference, an own file is generated, named with the prefix "", for example Globecom2010.bib for entry Globecom2010.