bibutils - Man Page

Several flags available for the end2xml, endx2xml, bib2xml, ris2xml, med2xml, and copac2xml programs. Most options have both a short and a long version.

bib2xml converts a bibtex-formatted reference file to an XML-intermediate bibliography file. Specify file(s) to be converted on the command line. Files containing bibtex substitutions strings should be specified before the files where substitutions are specified (or in the same file before their use). If no files are specified, then bibtex information will be read from standard input.

bib2xml bibtex_file.bib > output_file.xml

biblatex2xml converts a biblatex (not to be confused with bibtex) formatted reference file to an MODS XML-intermediate bibliography file.

biblatex2xml biblatex_file.bib > outputfile.xml

copac2xmlconverts a COPAC formatted reference file to a MODS XML-intermediate bibliography file.

end2xml converts a text endnote-formatted reference file to an XML-intermediate bibliography file. This program will not work on the binary library; the file needs to be exported first. Endnote tagged formats ("Refer" format export) look like Example 1, “Example refer format file”. There are very nice instructions for making sure that you are properly exporting this at http://www.sonnysoftware.com/endnoteimport.html^[5]

Usage for end2xml is the same as bib2xml.

end2xml endnote_file.end > output_file.xml

ebi2xml converts a EBI XML file to a MODS XML-intermediate bibliography file.

endx2xml converts a EndNote-XML exported reference file to a MODS XML-intermediate bibliography file. This program will not work on the binary library; the file needs to be exported first.

isi2xml converts an ISI-web-of-science-formatted reference file to an XML-intermediate bibliography file.

Usage for isi2xml is the same as bib2xml.

isi2xml input_file.isi > output_file.xml

ris2xml converts a RIS-formatted reference file to an XML-intermediate bibliography file. ris2xml usage is as end2xml and bib2xml

ris2xml ris_file.ris >	output_file.xml

wordbib2xml convert a Word2007-formatted reference file to an XML-intermediate bibliogrpahy file.

Note that --output-encoding refers to the input file

xml2bib converts the MODS XML bibliography into a bibtex-formatted reference file. xml2bib usage is as for other tools

xml2bib xml_file.xml > output_file.bib

Since the BibTeX reference format is fairly flexible and seems to have the greatest number of personal preferences, it has also accumulated a number of specific options that are not available for other formats.

Starting with 3.24, xml2bib output uses lowercase tags and mixed case reference types for better interaction with other software. The older behavior with all uppercase tags/reference types can still be generated using the command-line switch -U/--uppercase.

xml2bib-specific Options:

xml2ads converts the MODS XML bibliography to the Smithsonian Astrophysical Observatory (SAO)/National Aeronautics and Space Administration (NASA) Astrophyics Data System or ADS reference format^[6] (which is very similar to the tagged Endnote style). xml2ads usage is as for other tools

xml2ads xml_file.xml > output_file.ads

xml2ris converts the MODS XML bibliography to RIS-formatted bibliography file. xml2ris usage is as for other tools

xml2ris xml_file.xml > output_file.ris

xml2end converts the MODS XML bibliography to tagged Endnote (refer-format) bibliography file. xml2end usage is as for other tools

xml2end xml_file.xml >  output_file.end

xml2wordbib converts the MODS XML bibliography to Word 2007-formatted XML bibliography file. xml2wordbib usage is as for other tools

xml2wordbib xml_file.xml >  output_file.word.xml

xml2wordbib was called xml2word in versions of bibutils prior to 3.40. It was renamed to avoid confusion with other tools. Hopefully this will not break too many scripts already in use.

Example 2. Default

	      @Article{Putnam1992, 
	      author="C. D. Putnam
	      and C. S. Pikaard",
	      year="1992",
	      month="Nov",
	      title="Cooperative binding of the 
	      Xenopus RNA polymerase I transcription 
	      factor xUBF to repetitive ribosomal 
	      gene enhancers",
	      journal="Mol Cell Biol",
	      volume="12",
	      pages="4970--4980",
	      number="11"}

Example 3. Final Comma

	      @Article{Putnam1992,
	      author="C. D. Putnam
	      and C. S. Pikaard",
	      year="1992",
	      month="Nov",
	      title="Cooperative binding of the 
	      Xenopus RNA polymerase I transcription 
	      factor xUBF to repetitive ribosomal 
	      gene enhancers",
	      journal="Mol Cell Biol",
	      volume="12",
	      pages="4970--4980",
	      number="11",}

Example 4. Single Dash

	      @Article{Putnam1992,
	      author="C. D. Putnam
	      and C. S. Pikaard",
	      year="1992",
	      month="Nov",
	      title="Cooperative binding of the 
	      Xenopus RNA polymerase I transcription 
	      factor xUBF to repetitive ribosomal 
	      gene enhancers",
	      journal="Mol Cell Biol",
	      volume="12",
	      pages="4970-4980",
	      number="11"}

Example 5. Whitespace

@Article{Putnam1992,
  author =      "C. D. Putnam
                and C. S. Pikaard",
  year =        "1992",
  month =       "Jan",
  title =       "Cooperative binding of 
the Xenopus RNA polymerase I transcription 
factor xUBF to repetitive ribosomal gene 
enhancers",
  journal =     "Mol Cell Biol",
  volume =      "12",
  pages =       "4970--4980"
}

Example 6. Brackets

	    @Article{Putnam1992,
	    author={Putnam, C. D.
	    and Pikaard, C. S.},
	    title={Cooperative binding of the Xenopus 
	    RNA polymerase I transcription factor xUBF 
	    to repetitive ribosomal gene enhancers},
	    journal={Mol Cell Biol},
	    year={1992},
	    month={Nov},
	    volume={12},
	    number={11},
	    pages={4970--4980}
	    }

Example 7. Uppercase

	      @ARTICLE{Putnam1992,
	      AUTHOR="Putnam, C. D.
	      and Pikaard, C. S.",
	      TITLE="Cooperative binding of the Xenopus
	      RNA polymerase I transcription factor xUBF
	      to repetitive ribosomal gene enhancers",
	      JOURNAL="Mol Cell Biol",
	      YEAR="1992",
	      MONTH="Nov",
	      VOLUME="12",
	      NUMBER="11",
	      PAGES="4970--4980"
	      }