Description
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.