36
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Multilingual Zotero The Legal Citation Management Experience 2 July 2014 The Legal Citation Management Experience Multilingual Zotero

Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

  • Upload
    others

  • View
    8

  • Download
    0

Embed Size (px)

Citation preview

Page 1: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

.

. Multilingual Zotero

The Legal Citation Management Experience

2 July 2014

The Legal Citation Management Experience Multilingual Zotero

Page 2: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

(1) Helping researchers to help themselves

The Legal Citation Management Experience Multilingual Zotero

Page 3: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

(2) Helping researchers to help themselves

The Legal Citation Management Experience Multilingual Zotero

Page 4: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

(3) Helping researchers to help themselves

The Legal Citation Management Experience Multilingual Zotero

Page 5: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

Helping researchers to help themselves

The Legal Citation Management Experience Multilingual Zotero

Page 6: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

(4) Helping researchers to help themselves

The Legal Citation Management Experience Multilingual Zotero

Page 7: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

(5) Tools and terminology

Citation Style Language ( CSL ) An XML schema for definingcitation and bibliography formats.

CSL-M A private fork of CSL , extended to support legalreferencing.

citeproc-js A JavaScript implementation of CSL , with optionalsupport for CSL-M .

Zotero A reference manager maintained by the Center forHistory and New Media (George Mason University);runs citeproc-js in standard CSL mode.

Multilingual Zotero ( MLZ ) A private fork of Zotero withsupport for legal and multilingual referencing; runsciteproc-js in CSL-M mode.

The Legal Citation Management Experience Multilingual Zotero

Page 8: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

(6) MLZ : required scope of coverage

General Discourse Well covered by mainstream referencemanagers, including Zotero .

Local legal citation Mediocre coverage of some jurisdictions insome general-purpose reference managers (goodcoverage in law-specific tools only).

Extra-jurisdictional citation Must adapt citation forms toarbitrary jurisdictions. Not covered before MLZ .

Cross-language citation Must store and render translated andtransliterated field variants. Not covered beforeMLZ .

The Legal Citation Management Experience Multilingual Zotero

Page 9: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

(7) Processor input in CSL-M

CSL JSON⇓

citeproc-js

The Legal Citation Management Experience Multilingual Zotero

Page 10: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

(8) CSL JSON sample

1 {2 ”id”: 3972,3 ”system_id”: ”0_8JT2JQWM”,4 ”type”: ”legal_case”,5 ”title”: ”Walt Disney Productions v. Air Pirates”,6 ”container-title”: ”F.2d”,7 ”page”: ”751”,8 ”volume”: ”581”,9 ”URL”: ”http://scholar.google.com/scholar_case?case=12985824547460808287&scilh=0”,

10 ”jurisdiction”: ”us;federal;9-cir”,11 ”issued”: {12 ”date-parts”: [[”1978”]]13 },14 ”accessed”: {15 ”date-parts”: [[”2014”,6,22]]16 },17 ”multi”: {18 ”main”: {},19 ”_keys”: {}20 }21 }

The Legal Citation Management Experience Multilingual Zotero

Page 11: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

(9) CSL JSON design

Driven by requirements for rendering printed citations.Minimal set of item types.Minimal set of general-purpose fields.Atomic reference data—closer to BibTEX than to RDF.CSL-M adds item types and fields needed for legal citations.

The Legal Citation Management Experience Multilingual Zotero

Page 12: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

(10) MLZ item types

The Legal Citation Management Experience Multilingual Zotero

Page 13: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

(11) MLZ item types

The Legal Citation Management Experience Multilingual Zotero

Page 14: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

(12) MLZ item types

The Legal Citation Management Experience Multilingual Zotero

Page 15: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

(13) bill =⇒ bill

The Legal Citation Management Experience Multilingual Zotero

Page 16: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

(14) case =⇒ legal_case

The Legal Citation Management Experience Multilingual Zotero

Page 17: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

(15) gazette =⇒ gazette

The Legal Citation Management Experience Multilingual Zotero

Page 18: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

(16) hearing =⇒ hearing

The Legal Citation Management Experience Multilingual Zotero

Page 19: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

(17) newspaperArticle =⇒ article-newspaper

The Legal Citation Management Experience Multilingual Zotero

Page 20: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

(18) patent =⇒ patent

The Legal Citation Management Experience Multilingual Zotero

Page 21: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

(19) regulation =⇒ regulation

The Legal Citation Management Experience Multilingual Zotero

Page 22: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

(20) report =⇒ report

The Legal Citation Management Experience Multilingual Zotero

Page 23: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

(21) statute =⇒ legislation

The Legal Citation Management Experience Multilingual Zotero

Page 24: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

(22) treaty =⇒ treaty

The Legal Citation Management Experience Multilingual Zotero

Page 25: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

(23) Problematic item types

article-newspaper A hybrid reference:In form, a citation to a secondary resource,governed by the generic rules of the local style(Chicago, MLA, Bluebook etc); yetMust contain sufficient additional information toidentify the court decision (party names, date ofdecision, court).

gazette Use cases are unclear:Amending acts and original legislation typicallypublished officially in an official gazette; butOfficial gazettes can contain a variety of otherentries that lack a discrete type.

The Legal Citation Management Experience Multilingual Zotero

Page 26: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

(24) Fields of note: jurisdiction

Mimics “jurisdiction” portion of URN:LEX.MLZ user interface sets this value from a controlled list.

Where a specfic sub-jurisdiction code is not available, user can addsupplementary information in the Court field (authority).The fuzzy border between jurisdiction and Court (authority)on the legal_case type is not ideal, but it allows users to covernovel cases without waiting for an update to the jurisdictionlist.

The Legal Citation Management Experience Multilingual Zotero

Page 27: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

(25) Fields of note: authority

The various MLZ fields delivered as authority are handled asinstitutional names.In CSL-M , institutional names consist of multiple parts, delimitedby a field separator:

Supreme Court | First Petty Bench

Full court names (or well-specified jurisdiction codes) can beconverted into court codes for “neutral” citation forms.

The Legal Citation Management Experience Multilingual Zotero

Page 28: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

(26) Fields of note: committee + authority

On the hearing type, official Zotero stores the committee nameand the authority (legislativeBody) in separate fields.

In CSL-M (in contrast to CSL ) these values are best handled asa single institutional name consisting of multiple parts.The solution is to implicitly catenate the committee andauthority fields when both are used.With luck, Zotero will eventually adopt institutional namerendering, and the two fields can be merged in user data and in theuser interface.

The Legal Citation Management Experience Multilingual Zotero

Page 29: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

(27) Fields of note: collection-number (yearAsVolume)

The yearAsVolume field maps to the collection-numbervariable in the legal_case type.The yearAsVolume field is used for the publication year of lawreports divided into yearly “volumes” that may consist of multiplephysical volumes, as in the cite:

Hedley Byrne v Heller, [1963] 2 All ER 575 (HL).

Where yearAsVolume is provided, but no reporter name(container-title) is given, styles will render a “neutral”citation, deriving the court code from the court name:

R v Jones, [2006] UKHL 16.

The Legal Citation Management Experience Multilingual Zotero

Page 30: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

(28) Fields of note: section

MLZ and Zotero items consist of two parts: (1) a static Itemrepresenting the resource with a locally unique internal id; and (2)user-supplied pinpoint details.In printed citation formatting, a code or regulation is (logically) a singleItem, and the section number a supplementary pinpoint:

17 U.S.C. 106 (1976).Id. § 107.

However, for note-taking purposes, each provision must be a separatedatabase Item.In MLZ , the processor applies a workaround, deriving the id oflegislation and regulation types from content, ignoring anysection variable on the static Item. For citation purposes, a code orregulation is treated as a single resource for printed citation purposes.

The Legal Citation Management Experience Multilingual Zotero

Page 31: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

(29) One Last Thing: The Abbreviation Filter

The Legal Citation Management Experience Multilingual Zotero

Page 32: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

(30) One Last Thing: The Abbreviation Filter

The Legal Citation Management Experience Multilingual Zotero

Page 33: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

(31) Links

CSL project site

http://citationstyles.org

MLZ project site

http://citationstylist.org

MLZ / CSL-M field/variable mappings

http://fbennett.github.io/z2csl/diffMap.html

MLZ jurisdictions (JSON source)

https://github.com/fbennett/mlz-jurisdictions

The Legal Citation Management Experience Multilingual Zotero

Page 34: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

( 0゚゚)

よろしく!

CitationStylisthttp://citationstylist.org

( 。_ 。)

The Legal Citation Management Experience Multilingual Zotero

Page 35: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

The Legal Citation Management Experience Multilingual Zotero

Page 36: Multilingual Zotero - OASISGeneral Discourse Well covered by mainstream reference managers, including Zotero . Local legal citation Mediocre coverage of some jurisdictions in some

..........

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

.....

.....

......

.....

......

.....

.....

.

Postscript: A Genealogy of input-side projects

Free Law Project maintains an important database ofparsing data for U.S. case reporters.Free Law Ferret is a Firefox plugin that takes an HTML orplain text document as input, and converts Bluebook casecitations that it contains to MLZ database items. The Ferretrelies on FLP journal abbreviation data.Walverine is a node.js module that takes a plain textdocument as input, and converts Bluebook case citations thatit contains to a set of feature bundles (metadata objects).Walverine is derived from the Ferret.Citation is a module by Eric Mill for the @unitedstatesProject. Citation embeds elements of Walverine.

The Legal Citation Management Experience Multilingual Zotero