papis/papis v0.13

VERSION 0.13

on GitHub

Features

New: Special papis_id key (#449)

In order to make plugin writing easier we have decided to introduce a
papis_id key in the document's info files. This key essentially functions as
a UUID for the document. Many commands have gained support for this, e.g.

papis list --id query
papis open papis_id:someid

For more information see the documentation.

Important: This change requires updating the database backend. This can be
done by simply clearing the cache using papis --cc.

New: papis doctor command (#421)

A new papis doctor command was introduced that can be used to check that
document information is correct, up to date, or is nicely linted. The command
also supports fixing incorrect information for many cases!

It can be used as

papis doctor --checks files --explain query

There are several useful checks implemented already (non-exhaustive list):

• files: checks that the document files actually exist in the file system.
• keys-exist: checks that the provided keys exist in the document.
• bibtex-type: checks that the document type is a valid BibTeX type.
• refs: checks that the document ref exists and does not contain invalid characters.

For more information see the documentation.

New: papis citations command (#451)

A new papis citations command was added to handle retrieving citation
information for a document. This includes both papers cited by the document
and those which cite the document itself.

For more information see the documentation.

New: Add DBLP support (#489)

Add support for the DBLP database. The database can now be explored
using

papis explore dblp -q query pick

and documents can be imported directly using the DBLP key or URL

papis add --from dblp 'conf/iccg/EncarnacaoAFFGM93'

Major improvements to the web application (#424)

The Papis web application, which can be accessed with papis serve, has seen
major development since the last version. It now has support for

• editing of info.yaml file of a document (requires ace.js).
• viewing document PDF files directly in the browser (requires pdfjs).
• viewing LaTeX in titles, abstracts and others (requires KaTeX).
• exporting the document to BibTeX.
• showing citations for the document.
• showing errors from papis doctor.
• showing a timeline for queried documents.

And many other general interface and robustness improvements.

Other noteworthy features

• A major overhaul of the README (#415).
• Consistent use of ANSI colors (#462).
• Better notes handling in
  papis update (#404),
  papis edit (#391) and
  the papis picker (#319).
• Improvements to BiBTeX export (
  #412
  #444
  #443
  #468).
• Support NO_COLOR
  (#437).
• Major overhaul of the papis config command, which can now show defaults
  and select specific sections (#454).
• Fix shell completion on bash, zsh, and fish
  (#478).
• Update the logging format (#465).
• Updated multiple downloaders to support the latest version of the website
  and for better data extraction (
  #441
  #447).
• Avoid downloading files on papis add in certain scenarios
  (#505).
• Recognize DjVu files correctly (#522).
• Add USENIX downloader (#523).
• Support remote URLs in papis addto (#541).
• Add sort-reverse configuration option (#543).

Bug fixes

• Properly detach processes on papis open (#476).
• Fix link extraction in crossref (#480).
• Do not generate refs in downloaders (#483).
• Fix empty config file handling (#497).
• Fix database query for jinja2 (#499).
• Fix crash on trying to add a duplicate document (#510).
• Fix many typos (#540).