Man Linux: Main Page and Category List

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