diff options
author | Karl Berry <karl@freefriends.org> | 2022-01-21 22:58:35 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2022-01-21 22:58:35 +0000 |
commit | 39207a02179eab0fca34dfb7bb8dbbb6215fdc7a (patch) | |
tree | 14f6a970d4a28da5523838a10debde16683f3fb9 /Master/texmf-dist/source/latex/citation-style-language | |
parent | 59ab26e4b8b11acdd61b232207d7a9ae578c63e4 (diff) |
citation-style-language (21jan22)
git-svn-id: svn://tug.org/texlive/trunk@61687 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/citation-style-language')
-rw-r--r-- | Master/texmf-dist/source/latex/citation-style-language/README.md | 68 |
1 files changed, 68 insertions, 0 deletions
diff --git a/Master/texmf-dist/source/latex/citation-style-language/README.md b/Master/texmf-dist/source/latex/citation-style-language/README.md new file mode 100644 index 00000000000..c89a928bcb3 --- /dev/null +++ b/Master/texmf-dist/source/latex/citation-style-language/README.md @@ -0,0 +1,68 @@ +# `citeproc-lua` + +## Create an engine instance +```lua +local citeproc = require("citeproc") +local engine = citeproc.new(sys, style) +``` + +The `sys` is a table which must contain `retrieveLocale()` and `retrieveItem()` functions. Thet are called to feed the engine with inputs. + + + +## `updateItems()` + +The `updateItems()` method refreshes the registry of the engine. +```lua +params, result = engine:updateItems(ids) +``` +The `ids` is just a list of `id`s. +```lua +ids = {"ITEM-1", "ITEM-2"} +``` + + +## `makeCitationCluster()` + +The `makeCitationCluster()` method is called to generate a citation of (possibly) multiple items. + +```lua +params, result = engine:makeCitationCluster(cite_items) +``` + +The `cite_items` is a list of tables which contain the `id` and other options (not implemented). + +```lua +cite_items = { + { id = "ITEM-1" }, + { id = "ITEM-2" } +} +``` + +Returns: +```lua +"(D’Arcus, 2005; Bennett, 2009)" +``` + +The more complicated method `processCitationCluster()` is not implemented yet. + +## `makeBibliography()` + +The `makeBibliography()` method produces the bibliography and parameters required for formatting. +```lua +result = engine:makeBibliography() +``` + +Returns: +```lua +result = { + { + hangingindent = false, + ["second-field-align"] = false, + }, + { + '<div class="csl-entry">B. D’Arcus, <i>Boundaries of Dissent: Protest and State Power in the Media Age</i>, Routledge, 2005.</div>', + '<div class="csl-entry">F.G. Bennett Jr., “Getting Property Right: ‘Informal’ Mortgages in the Japanese Courts,” <i>Pac. Rim L. & Pol’y J.</i>, vol. 18, Aug. 2009, pp. 463–509.</div>' + } +} +``` |