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.

bibtexconv                                      November 10, 2023                                  bibtexconv(1)