PAPERCITE

To report bugs or request features, please go to https://github.com/digfish/papercite. Documentation can be found on http://papercite.readthedocs.org/en/latest/.

papercite format bibtex entries as HTML so they can be inserted in
WordPress pages and posts. The input data is a bibtex file (either local
or remote) and entries can be formatted by default using various
predefined styles. Bibtex source file and a link to the publication are
also available from the HTML.

Input: Sources files are BibTex files that can be:

• WordPress media files (since 0.5.6)
• Stored into a WordPress folder (with multi-site support);
• An URL (e.g., from citeulike.org and bibsonomy.org);
• A custom field when local to a post/page

Efficiency:

• Database backend to speed up the processing by caching the bibtex
  entries for big BibTeX files.
• Fast OsBiB-based parser

Filtering and grouping:

• Filtering on publication type and authors
• Regular expression filtering on any type
• Publications can be grouped and sorted in various ways

Output:

• Access the single bibtex entry source code to enable copy&paste
  (toggle-enabled visualization)
• Easy output customisation with the use of two templates: one for
  each entry, one for the list of entries
• Auto-detection of PDF files based on the BibTeX key (or on the PDF
  entry)
• Citation mode: use references in the text and print the citations at
  the end of a block, page or post
• Form to let the user dynamically filter the entries

Documentation can be found from within WordPress plugin list (click on
the documentation link). You can see the documentation of the plugin
as installed on my site here.

Contributors:

• B. Piwowarski (main developper)
• Jaroslav Vítků: Filtering by author and type; form to filter
  publications
• Michael Schreifels: auto-bibshow and no processing in post lists
  options
• Stefan Aiche: group by year option
• Łukasz Radliński: bug fixes & handling polish characters
• Max Harper: patch for having good URLs
• Martin Henze: option for highlighting name(s) of specific
  author(s)/editor(s)
• Some parts of the code come from bib2html (version 0.9.3) written by
  Sergio Andreozzi.
• Samuel Viana aka digfish (digitalfisherman on WordPress) : current mantainer

Where is the documentation?

The documentation is now bundled with the plug-in. Go to the plug-in
list page in the WordPress dashboard, and click on the documentation
link.

How can I edit my bibtex files?

If your file is local to the blog installation, you have two options:

• via FTP client with text editor
• via WordPress Admin interface: Manage->Files->Other Files

** use wp-content/papercite-data/bib/mybibfile.bib as a path

Alternatively, you can maintain your updated biblilography by using
systems such as citeulike.org and bibsonomy.org; specify the bib file
using as a URL (e.g., in citeulike, you should use
http://www.citeulike.org/bibtex/user/username)

How are the entries sorted?

Entries are sorted by year by default.

How can I personalize the HTML rendering?

The HTML rendering is isolated in two template files, located in the
subfolders tpl (citation list rendering) and format (entry rendering).

How do I use the new textual footnotes ?

Using the new shortcode [ppcnote]. For example:

In molecular biology, the term double helix [ppcnote]usually applies to DNA[\ppcnote]

will result in a footnote being generated after the post text. The numbering of the footnotes is separated from the one used in the citations.