Package: bibliography-organizer-sebastian-achim-mueller
Helps you to organize and search your local bibliography.biborgis not invasive, it does not touch your cited documents or bibtex-files.biborgonly offers suggestions to organize your files, as well as a full-text-search.biborgacts in the filesystem. Its interface is motivated by the version-control-toolgit.CommandsA set of command-line-tools to help you managing your bibliography. The interface is similar togit.bib statusPrints a list of errors and warnings when your entries are not structrured as expected, or when entries are missing crucial parts.bib updateTries to update the optical-character-recognitionocr, theicon.jpgin each entry. Finally updates the search-index in your bibliography directory.
When new originals were added, they are read and added to theocr. Likewiseocr-records will be ignored when the corresponding original does not longer exist.
Theicon.jpgis extracted from the primary original.bib searchSearches for your search-PHRASEin the search-index. Results are printed to the command-line. The search-PHRASEmay contain logical operators such asAND,OR,NOT,ANDNOT,ANDMAYBE,(, and). See documnetation ofWhoosh.StructureThebibliography_organizer, orbiborgfor short, acts in your bibliography directorybib_dir.
Thebib_dircan be any directory in your filesystem.biborg’s command-line-interface expects the current working directory to be abib_dir.bib_dir
|-- citekey_A
|   |-- original
|   |   |-- citekey_A.pdf
|   |   |-- comments.ps
|   |   |-- preprint.pdf
|   |
|   |-- reference.bib
|
|-- citekey_B                       <-- you
|   |-- original                    <-- you
|   |   |-- citekey_B.html          <-- you
|   |
|   |-- reference.bib               <-- you
|   |
|   |-- ocr                         <-- biborg
|   |   |-- citekey_B.html.tar      <-- biborg
|   |
|   |-- icon.jpg                    <-- biborg
|
|-- .bibliography_organizer         <-- biborg
    |-- full_text_search_indexTerminologycitekeyThecitekeyis a string to identify your reference, e.g. ‘darwin1859origin’. In LaTex you use\cite{citekey}.bib_dirThe base directory of your local bibliography. Here, you create and collect your entries inentry_dir``s.``biborgwill create a hidden cache in here named.bibliography_organizer.entry_dirAnentry_diris directory inside yourbib_dir. Anentry_dirhas the name of thecitekey. Theentry_dircontains the original files and a bibtex reference. You create, and populate theentry_dir``sin your ``bib_dir.originalIn everyentry_diris the original directory. It contains the original files to be cited. Usually, there is only one original-file corresponding to onecitekey. But sometimes the original might be a collection of files like a web-page or such. You create the original directory and populate it with your originals.reference.bibA bibtex-file in theentry_dirthat you create. It contains exactly one bibtex-entry. Thecitekeyin the bibtex-entry is expected to match theentry_dir.ocrTheocrdirectory is created and updated bybiborg. Theocrdirectory contains the extracted text from the original files. The text is extracted using optical character recognition. Each original file has one archive in theocrdirectory. The archive contains the text of the individual pages from the original.
This is used to fill the search-index.iconTheicon.jpgis a small image rendered from the first page of the primary original-file. Theicon.jpgis created bybiborg.
The primary original file has thecitekeyas its basename.full_text_search_indexThis is a hidden directory inbib_dir/.bibliography_organizer/full_text_search_index. It is a cache for the search created and updated bybiborg.To use optical character recognitionsudo apt-get install tesseract-ocr
sudo apt-get install imagemagig