NAME
cb2bib - software to extract bibliographic references from various
sources
SYNOPSIS
cb2bib
cb2bib [--conf [filename.conf]] [action] [filename1 [filename2 ... ]]
c2bimport <imported reference file>
c2bciter [space-separated list of BibTeX files or directories]
DESCRIPTION
cb2bib is a software to extract bibliographic references from
unformatted and non standard sources, like, for example 1) email
alerts; 2) journal Web pages; 3) PDF files.
Captured references are provided to the user for inspection in a
graphical form. Once validated, the references are transformed into
BibTeX records which might be appended to a user-defined BibTeX bib
file.
The software allows to peruse a BibTeX file and to send to the
clipboard a citation of all the records currently selected. A pipe is
also setup with the LyX LaTeX editor.
When invoked with the -h | --help option, cb2bib lists all the options
that are available on the command line.
VARIANTS
cb2bib is the main program.
c2bimport is equivalent to using cb2bib --import (this variant takes
only one file name as parameter).
c2bciter is equivalent to using cb2bib --citer.
OPTION
--conf [filename.conf] Use configuration file
ACTIONS
--configure [filename.conf] Edit configuration
--bibedit [filename1.bib [filename2.bib ... ]] Edit/browse BibTeX
files
--citer [filename1.bib [filename2.bib ... ]] Start cb2Bib citer
--import <tmp_reference_filename> Imports reference,
usually from ad hoc websites
--doc2bib fn1.doc [fn2.doc ... ] reference.bib Extract reference
from document file
--txt2bib fn1.txt [fn2.txt ... ] reference.bib Extract reference
from text file
--html-annote filename.tex Convert annote file
to HTML
--view-annote filename.tex Convert and visualize
annote file
--view-annote filename.tex.html Visualize annote file
KEY SHORTCUTS
Key: Description
Alt A: Open cb2Bib Annote
Alt B: Edit Bookmarks
Alt C: Preparses cb2Bib’s clipboard
Alt D: Deletes temporary BibTeX output file
Alt E: Edit Regular Expressions
Alt F: Select File source filename
Alt I: Insert Regular Expression
Alt J: Edit Journal Abbreviations
Alt O: Open File Document
Alt P: Postprocess BibTeX
Alt R: Restarts automatic recognition
Esc: Quits cb2Bib popup menu
Right: Click Editor popup menu
EXAMPLES
cb2bib Starts cb2Bib extraction
program
cb2bib --import tmp_reference_filename Imports a reference from
a file
cb2bib --bibedit filename.bib Edits BibTeX filename.bib
cb2bib --conf Starts cb2Bib in USB mode
cb2bib --doc2bib *.pdf references.bib Extracts references from
PDF title pages
NOTES
The file cb2bib.conf must be readable and writable. If it does not
exist, the cb2Bib will create one based on predefined defaults.
Use switch --conf to particularize specific settings for specific
actions.
If starting the cb2Bib from a removable media use the command ’cb2bib
--conf’ without configuration filename. Settings will be read from and
written to /cb2bib/full/path/cb2bib.conf, being therefore independent
of the mounting address that the host computer will provide.
To import references from a browser select when asked c2bimport, which
expands to ’cb2bib --import %f’. The browser will provide the temporary
reference filename. The temporary file is deleted once imported.
A number of factors influence the reliability of automatic extractions.
Consider writing customized regular expressions and network queries,
and use metadata when available.
Important
The commands --doc2bib and --txt2bib do not append the references to
the references.bib. They create a new file, or silently overwrites it
if already exists.
The website http://www.molspaces.com/d_cb2bib-overview.php has detailed
instructions corresponding to different use cases.
BIBLIOGRAPHICAL REFERENCES TO BE CITED
P. Constans (2009) "A simple extraction procedure for bibliographical
author field", arXiv:0902.0755.
P. Constans (2007) "Approximate textual retrieval", arXiv:0705.0751.
SEE ALSO
bib2pdf(1), med2bib(1), isi2bib(1), ris2bib(1)
AUTHORS
Pere Constans <constans@molspaces.com>
Program author.
Filippo Rusconi <rusconi-debian@laposte.net>
Man-page author for the Debian distribution.
COPYRIGHT
Copyright © 2004-2008 Pere Constans
Copyright © 2009 Filippo Rusconi
This manual page was written for the Debian system by Filippo Rusconi
<rusconi-debian@laposte.net>. Permission is granted to copy, distribute
and/or modify this document under the terms of the GNU General Public
License, Version 3, published by the Free Software Foundation.
On a Debian system the complete text of the GNU General Public License
version 3 can be found in the file ‘/usr/share/common-licenses/GPL-3’.
September 2009