Bureaucrat, sudo, administrator
417
edits
Changes
m
Bibliographic record -> CSL-Processor -> Citation
CSL-Processors are available processors have been written in different a variety of programming languages. The most complete implementation of CSL 1.0 at present is the Javascript implementation, [http://bitbucket.org/fbennett/citeproc-js/wiki/Home citeproc-js], which runs in Firefox and other Gecko-based browsers, Google Chrome, Safari, IE6 and above, and in Rhino and spidermonkey/tracemonkey for server-side deployments.
== Getting started ==
If you use Zotero or Mendeley, you already use CSL under the hood. If you want to dig your hands into code, have a look at citeproc-js, which is currently undergoing integration in these two projects:
hg clone http://bitbucket.org/fbennett/citeproc-js
A [http://gsl-nagoya-u.net/http/pub/citeproc-doc.html formatted version of the processor manual] is available online, and a [http://gsl-nagoya-u.net/http/pub/citeproc-demo/demo.html demo that runs the processor in a browser] is also available. The citeproc-js source archive contains a large suite of test cases, and the test framework offers a lightweight platform for exploring the behavior of the processor.
== Bibliographic record format ==
Of course you cannot throw just any bibliographic record format into a CSL-Processor but processor; you must use the [http://citationstyles.org/downloads/specification.html#appendices field names defined in the CSL 1.0 specification]. Some Fields are of the three types: plain text, date fields are repeatable , and name fields. The latter two have an interal internal structure [http://gsl-nagoya-u.net/http/pub/citeproc-doc.html#data-input as described here]. The As a guide to the field assignments for particular types of content, the CSL mappings used in the Zotero reference manager [http://gsl-nagoya-u.net/http/pub/csl-fields/index.html are described here].
=== CSL record format ===
Derived from the CSL 1.0 specification and the citeproc-js documentation , a CSL record can be defined as a follows , in incomplete Backus-Naur-Form and additional descriptionform, with supplementary descriptions:
A record is a JSON object with unique keys of three kinds (VAR, NAME, DATE, and TYPE):
== Embedding CSL records in twitter annotations ==
On the Code4lib mailing list it has been discussed to embed bibliographic data in twitter annotations. If this annotations contain CSL records then you could display a bibliographic reference in the citation style of your choice, delegating the formatting task to the client application.
A twitter annotation is a JSON object with up to 512 bytes (later more):
