WordPress.org

Ready to get started?Download WordPress

Plugin Directory

!This plugin hasn't been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

Cite & List

Use BibTeX to cite articles in your posts and create publication lists.

Usage

Setup

Cite & List works out of the box. You may want to change the way its output looks, however. To that end, visit the option page in the Settings menu. You can control the following parameters:

  • Bibliography Key Format: Number will cause entries to number in order of citation. Else the keys provided in the respective sources are used.
  • Citation Key Format: Controls how a single entry is represented in citations. Use the same syntax as for templates (see below).
  • Citation Format: Specifies a container for citations. @keys@ is replaced with a comma-separated list of citations according to citation key format.
  • Bibliography/Publication List Template: Controls how bibliographies and publication lists look, respectively. See below for details.
  • Sanitisation Rules: BibTeX files might contain LaTeX syntax and other surprises. Here you can enter regexps to amend that.

Templates

Please read bib2tpl's documentation. You can use all features mentioned there. There is an additional tag; use @postid@ in cite key format and bibliography template as unique identifier for the current post or page.

Sources

The recommended way to add BibTeX to a post is using a custom field named bibtex. Additionally, you can specify (local and remote) files via shortcode bibsource, for example [bibsource file=http://myhp.org/example.bib].

In case of duplicate keys, files overwrite the custom field and later specified files overwrite earlier specified ones.

Note that you might have to avoid special characters in entry keys, for example if you want to use them as HTML IDs.

Citations

In order to cite entries use shortcode cite in your text, for instance [cite key="aaa,bbb,ccc"]. As you can see, you can cite multiple entries at once. The shortcode is replaced with a citation based on your settings. All keys cited in the current post are added to the bibliography which is automatically appended to the post if necessary.

Note that you can use keys from any source; it does not matter in which order cite and bibsource shortcodes appear.

Publication Lists

Shortcode [publications] creates a list of entries from all sources added so far and the bibtex custom field. For explanation of possible parameters group, order_groups, sort_by, order and lang see bib2tpl's documention; they behave exactly in the same way as the corresponding API parameters. Filtering is done by parameters only_xyz=abc which corresponds to an array entry 'xyz' => 'abc' in API parameter only. Note that you have to escape backslashes in regular expressions with another \ in filter parameter values.

Requires: 3.2.0 or higher
Compatible up to: 3.3.2
Last Updated: 2012-2-25
Downloads: 834

Ratings

2 stars
2.5 out of 5 stars

Support

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.