[pmwiki-users] PublishPDF library: support for citations and bibliographies

[John Rankin]

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