You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
46 lines
1.2 KiB
46 lines
1.2 KiB
# Pubs
|
|
|
|
Pubs brings your bibliography to the command line.
|
|
|
|
Pubs organizes your bibliographic documents together with the bibliographic data associated to them and provides command line access to basic and advanced manipulation of your library.
|
|
|
|
Pubs is built with the following principles in mind:
|
|
|
|
- all papers are referenced using unique citation keys,
|
|
- bibliographic data (i.e. pure bibtex information) is kept separated from metadata (including links to pdf or tags),
|
|
- everything is stored in plain text so it can be manually edited or version controlled.
|
|
|
|
|
|
**Notice:** papers is still in early development and cannot be considered as stable
|
|
|
|
|
|
Getting started
|
|
---------------
|
|
Create your library (by default, goes to '~/.papers/').
|
|
|
|
pubs init
|
|
|
|
Import existing data from bibtex (papers will try to automatically copy documents defined as 'file' in bibtex):
|
|
|
|
pubs import path/to/collection.bib
|
|
|
|
or for bibtex containing a single file:
|
|
|
|
pubs add --bibfile article.bib --docfile article.pdf
|
|
|
|
|
|
Requirements
|
|
------------
|
|
- python >= 2.6
|
|
- [dateutil](http://labix.org/python-dateutil)
|
|
- [pyYaml](http://pyyaml.org)
|
|
- [bibtexparser](https://github.com/sciunto/python-bibtexparser)
|
|
|
|
|
|
Authors
|
|
-------
|
|
|
|
- Fabien Benureau
|
|
- Olivier Mangin
|
|
- Jonathan Grizou
|