Package: paperstack
Paperstack is a powerful, lightweight, universal bibliography management tool written in Python.GitHub repositoryTable of ContentsInstallationUsageContributingLicenseInstallationPaperstack can be installed from PyPI with the following command:python3-mpipinstallpaperstackTo build directly from source, run:gitclonehttps://github.com/williamroque/Paperstack.gitcdPaperstack
python3setup.pyinstallAfterwards, run the following command to test the installation and explore CLI options.paperstack--helpUsageInterfaceRunpaperstackby itself to open the interactive text-based interface. There, the left panel lists the records in your library (use arrow keys to navigate) and the right panel shows record details. Below, the footer displays key map hints and other messages.There is also a command-line interface, which can be useful for batch actions and integration with other programs. For example, run the commandpaperstackaddarticle'author: Albert Einstein; title: Die Grundlage der allgemeinen Relativitätstheorie; journal: AdP; year: 1916'to add a new paper. Note the syntax for entries (key1: value1; key2: value2). Then runpaperstacklistto list all added records in the library. A slightly less trivial use case might be to scrape multiple articles at once. The following script reads a list of bibcodes from a text file and uses Paperstack to add them to your library.forlinein$(catbibcodes.txt);dopaperstackscrapeads"bibcode:$line"--adddoneConfiguration for Paperstack goes in$HOME/.paperstack.cfg. The config file follows a standard similar to Windows.inifiles. Sections are labeled with[section name]and settings are written askey = value. Check the documentation for the different settings you can customize. Below is an example configuration.[paths]data=~/Documents/Paperstack/[article]id-format=author@2-title@15-year@4[ads]key=<YOUR-API-KEY>timeout=10[arxiv]timeout=10[keys]vim-bindings=yes[editor]command=vimextension=mdNote that to scrape ADS, a valid API key has to be specified in the config file.Find a presentation containing a few use cases and general informationhere.ExportingPaperstack supports exporting to both BibTeX and a variety of citation standards. In order to maintain a small installation size, however, only the Harvard citation style is enabled by default. To add more, visitCSL Styles | GitHuband download the.cslfile corresponding to your preferred style. Then, save that file to thecsldirectory within the data directory specified in your configuration.A few common styles you can download include:APA 6 | GitHubMLA | GitHubChicago | GitHubContributingAll contributions are welcome. Reporting issues on the GitHub repository is greatly appreciated, but pull requests are preferred. In particular, help is needed to:Improve documentation;Test on different platforms;Add support for new databases;Add support for new record types (books, websites, etc.);Any other goals or roadmap items listed in theProject Notes.Note that contributions should follow PEP 8 as closely as possible (though not strictly enforced), docstrings should follow theNumpy format, and that, in general, simple, flat, and scalable code is strongly encouraged.A special thanks toDr. Mosenkovfor conceiving and co-creating this project.LicenseThis program is licensed under the GNU General Public License.