[pmwiki-users] PublishPDF library: support for citations and bibliographies
John Rankin
john.rankin at affinity.co.nz
Tue Jul 3 23:36:14 CDT 2007
The latest release of the PublishPDF library is available at
http://www.pmwiki.org/wiki/Cookbook/PublishPDF
This fixes a few minor issues associated with the support for
citations and bibliographies added in the previous release.
It lets authors insert scholarly citations, using either
Author (year) or (Author, year) or numeric references.
It provides 2 pieces of markup:
cite(key) creates a reference to the citation identified by 'key'
and listed in a bib block:
(:bib:)
* key1 : text of citation 1
* key2 : text of citation 2
...
(:bibend:)
There is a demonstration page (based on a real example) at:
http://www.wikipublisher.org/wiki/index.php?n=Bibliographies.Advocacy
Look at the page source to see how the markup is used:
http://www.wikipublisher.org/wiki/index.php?n=Bibliographies.Advocacy?action=source
If authors use keys of the form Author1:Author2:year it will
generate (in Author-Year mode) links of the form
Author1 and Author2 (year).
It supports prefixes: cite("see" key)
And suffixes: cite(key "p.42")
And apostrophes: cite(Author:year)'s --> Author's (year)
You can list citations on one page and cite them on other
pages, like this:
(:bib page=SomePage:)
(:bibend:)
gets the citations from SomePage.
By default, it uses Author-Year mode -- this can be
changed on a site-wide basis or per page:
(:bib fmt=num:) generates numbered references.
The pdf generation works too.
For more information, there is a user guide at:
http://www.wikipublisher.org/wiki/index.php?n=Bibliographies.UserGuide
Many thanks go to Pm for early discussions on markup options
and to Christian Ridderström for suggestions and testing.
There is a live site where this is used extensively at:
http://www.oarinz.ac.nz/oarinzwiki/index.php?n=OARiNZ.HomePage
Questions welcome.
--
JR
--
John Rankin
\_
\)
\,\__/7
/ /
( c'
\ /
/, /_/
| & * Wellington
) /
/ /,
/ (
| /
\__/
V
More information about the pmwiki-users
mailing list