@citation-js/plugin-ris

Plugin for RIS formats for Citation.js.

Install

npm install @citation-js/plugin-ris

Usage

Register by importing the package:

require('@citation-js/plugin-ris')

Formats

Formats and other features added by this plugin.

Output

This plugin adds output support for the RIS format (ris).

(2024-09-23)

Bug Fixes

• plugin-bibtex: correctly escape syntax in output (ef9aaff), closes #232
• plugin-ris: account for CSL with numeric ids (43267df), closes #238

0.7.15 (2024-08-11)

Bug Fixes

• plugin-wikidata: replace deprecated wikidata-sdk (32d1527)

0.7.14 (2024-06-12)

Bug Fixes

• core: fix regression in 4ae7fbc (c2dcb6a), closes #229

0.7.13 (2024-06-06)

Bug Fixes

• core: handle errors in user agent determination (4ae7fbc), closes #227
• core: only use node-fetch until node 16 is dropped (4b29a5d)

0.7.12 (2024-05-07)

Features

• plugin-bibtex: add option to force use of label (d5631e2)

0.7.11 (2024-04-17)

Bug Fixes

• plugin-ris: fall back to default type (a3d0391), closes #225

Features

• core: normalize non-lowercase type values (1ab0d2f), closes #225
• plugin-csl: add option to hyperlink URLs and DOIs (4c15804)

0.7.10 (2024-03-27)

Bug Fixes

• plugin-ris: handle output of literal dates (6f6b85a)

Features

• plugin-wikidata: update type mappings (e9493d1)

0.7.9 (2024-03-05)

Bug Fixes

• plugin-bibtex: allow list delimiters in text in environments (da0c64b)

Features

• core: normalize ORCIDs on authors (e91b580)
• plugin-bibtex: implement data annotations (68a8ec6)
• plugin-bibtex: map ORCIDs to data annotations (5c3951a)

0.7.8 (2024-01-22)

Bug Fixes

• plugin-bibtex: do not case-protect commands in output (50333d1)
• plugin-bibtex: fix math-mode unicode escapes (f05e45c), closes #192
• plugin-bibtex: remove lone diacritics (49e9100)
• plugin-wikidata: handle no/unkown value claims (673e35c), closes #217

Features

• plugin-bibtex: add config to keep all unicode (cd018f9), closes #177
• plugin-doi: parse DOIs with square, angle brackets (5434d5a), closes #182

0.7.7 (2024-01-20)

Features

• plugin-wikidata: meaningful errors for 404s (280274a), closes #221

0.7.6 (2024-01-17)

Bug Fixes

• plugin-doi: map non-standard dissertation type (5f75243), closes #220

0.7.5 (2023-12-31)

Features

• plugin-bibtex: add mappings for plainnat fields (208bd96), closes #204

0.7.4 (2023-11-01)

Bug Fixes

• plugin-ris: fix output of certain date fields (796dce3)
• plugin-ris: parse year numbers on certain items (d300c33)

0.7.3 (2023-11-01)

Bug Fixes

• plugin-ris: always set PY in RIS output (2979ae2), closes #213

0.7.2 (2023-10-14)

Bug Fixes

• plugin-bibtex: do not map "howpublished" url to publisher (d4e3296)

0.7.1 (2023-09-23)

Bug Fixes

• update peer dependency statements (95ea6bb)

0.7.0 (2023-09-23)

Bug Fixes

• plugin-bibjson: expand recognition of bibjson (c80b9b9)
• plugin-bibjson: make parsing more resilient (4f615f4)
• plugin-csl: fix citation data object in entry (6527db6)

0.6.9 (2023-09-20)

Bug Fixes

• plugin-wikidata: do not use 'subject named as' for authors (b6efe22)

Features

• plugin-wikidata: use Q5 to recognize literal names (541d54c), closes #199

0.6.8 (2023-05-10)

Bug Fixes

• plugin-bibtex: map addendum field to note (e6d19c5), closes #198
• plugin-bibtex: map langid field to language (ff00ea2), closes #197

0.6.7 (2023-02-14)

Bug Fixes

• plugin-csl: fix citationsPre, citationsPost (bfb9db8), closes #141 #190

0.6.6 (2023-01-31)

Bug Fixes

• plugin-bibtex: support mixed case "and" in lists (8e262db), closes #188

Features

• plugin-doi: support URLs without scheme (e84f7d8)

0.6.5 (2022-12-31)

Bug Fixes

• plugin-ris: update priority of fields (636b8e2), closes #185

0.6.4 (2022-07-19)

Bug Fixes

• plugin-csl: fix typo (dc92fb5)
• plugin-csl: handle unknown cs:style default-locale (974ea05), closes #166
• plugin-wikidata: add missing mappings (abdc0f3)
• plugin-wikidata: fix mappings (3f33e5b)

Features

• plugin-wikidata: add software fields (beb5dd9)

0.6.3 (2022-06-23)

Bug Fixes

• plugin-csl: respect cs:style attribute default-locale (8189854), closes #166

0.6.2 (2022-06-02)

Bug Fixes

• plugin-ris: fix type constraints of mappings (9be8f3b)

0.6.1 (2022-06-02)

Bug Fixes

• plugin-bibtex: do not output empty s2id field (ca58949)

Features

• plugin-wikidata: include additional version information (7b870b8)

0.6.0 (2022-05-30)

Bug Fixes

• core: avoid flatMap for Node 10 support (8a65094)
• plugin-bibjson: set correct generic type (ec7de7f)
• plugin-bibtex: consider entries with no type (a55fe60)
• plugin-bibtex: fix biblatex handling of mastersthesis (6196adf)
• plugin-bibtex: fix handling of bookpagination (7f41e30)
• plugin-bibtex: fix typo in crossref code (3c377e4)
• plugin-bibtex: map biblatex eid to number (0eb15af), closes #140
• plugin-bibtex: set default CSL type correctly (94a402e)
• plugin-bibtex: set default CSL type correctly (bcd11b3)
• plugin-bibtex: use CSL 1.0.2 'custom' field (986f80b)
• plugin-ris: fix ISSN regex (76402c1)
• plugin-ris: fix name parsing (4382f31)
• plugin-wikidata: fall back to original-author (1af1249), closes #106

• chore!: drop Node 10, 12 support (37ea76b)

Features

• core: output CSL 1.0.2 by default (5acec19)
• core: remove custom _ fields when cleaning (c974ebc)
• core: update internal format to CSL 1.0.2 (7249425)
• plugin-bibjson: update mapping to CSL 1.0.2 (d04aacf)
• plugin-bibtex: add Semantic Scholar s2id mapping (#159) (f116cde)
• plugin-bibtex: implement crossref properly (f9cdf5b), closes #115
• plugin-bibtex: update mapping to CSL 1.0.2 (6c68aff)
• plugin-csl: adapt to CSL 1.0.2 input (4090164)
• plugin-csl: update styles and locales (1ede64b)
• plugin-ris: update mapping to CSL 1.0.2 (b59bd12)
• plugin-wikidata: import issue/vol/etc. from qualifiers (dc7e270)
• plugin-wikidata: update mapping to CSL 1.0.2 (09f2e2d), closes #142

BREAKING CHANGES

• use Node.js 14 or above
• core: to get CSL 1.0.1 output, use the 'version' option
• plugin-csl: output of updated styles and locales may differ
• core: use the 'custom' object instead of fields starting with an underscore.

0.5.7 (2022-04-17)

Bug Fixes

• core: do not use process variable in browser (d779267), closes #156

0.5.6 (2022-02-12)

Bug Fixes

• plugin-bibtex: fix handling of literal dates (701526d)

0.5.5 (2021-12-31)

Bug Fixes

• plugin-bibtex: ignore empty fields (6badc93)
• plugin-csl: error for unknown output format (b9a2b7d)
• plugin-ris: add non-standard issue mapping (fb6ae32)
• plugin-ris: map publisher-place (89cb3f2)

0.5.4 (2021-12-11)

Bug Fixes

• core: do not convert string id to numbers (6490200)
• plugin-bibtex: fix numeric id in bibtex label (6291843)
• plugin-bibtex: replace use of moo.keywords (efb9586)

0.5.3 (2021-11-24)

Bug Fixes

• plugin-csl: handle missing entries (93400d6)
• plugin-doi: handle crossref preprints (0927f43)
• remove named imports of JSON files (9b8315b)

• chore!: drop Node 8, add Node 14 (a5ceb07)

Features

• core: throw more descriptive errors in Translator (c35b40f)
• plugin-csl: allow citation context options (c5c3e8c)
• plugin-csl: allow cite-items (48fb79c)

BREAKING CHANGES

• drops Node 8 support

0.5.2 (2021-09-21)

Bug Fixes

• plugin-csl: check for non-normalised language codes (3928f70)

Features

• plugin-bibtex: allow non-standard day field (96f8d43), closes #134

0.5.1 (2021-05-11)

0.5.0 (2021-04-01)

Bug Fixes

• plugin-bibtex: remove CSL 1.0.2 types (365fe1c)
• plugin-bibtex: remove lookbehind regex (fe20199)

Features

• plugin-bibtex: allow URL in howpublished (3884e08)
• plugin-ris: add formatting 'spec' option (ec0bbad)

0.5.0-alpha.10 (2021-01-28)

Bug Fixes

• core: clean type as regular string (6982ae6)
• core: do not snapshot initial Cite() state (19afac7)
• core: reset Grammar log on each run (68d8a2a)
• core: reset Grammar state on each run (834f679)
• plugin-bibtex: apply upstream changes (f5a1514)
• plugin-bibtex: apply various fixes (861cb36)
• plugin-bibtex: apply various fixes (86e55df)
• plugin-bibtex: do not escape verbatim value (a90f4a5)
• plugin-bibtex: do not ignore month after day (4914797)
• plugin-bibtex: escape more unicode in output (1647734)
• plugin-bibtex: fix howpublished/url mapping (b655bec)
• plugin-bibtex: fix mapping bugs (a644b3a)
• plugin-bibtex: output w/ case protection (07f99b5)
• plugin-bibtex: remove unicode from label (81d657d)
• plugin-bibtex: update BibTeX mappings (db79896)

Features

• core: add mainRule param to Grammar (e8679d5)
• core: move DOI corrections to core (03b804b)
• plugin-bibtex: add -subtitle, -titleaddon (eef0e6c), closes #116
• plugin-bibtex: add 'strict' parser option (64f0c38)
• plugin-bibtex: add BibLaTex mappings (84655a4)
• plugin-bibtex: rename sentenceCase option (35943d2)
• plugin-bibtex: update BibTeX mappings (987b75c)
• plugin-bibtex: update BibTeX parser (9df7558)
• plugin-csl: add 'asEntryArray' option to bibliography (8039967)
• plugin-csl: add 'entry' option to bibliography (298819b)

BREAKING CHANGES

• core: Constructing a Cite instance no longer automatically creates a snapshot. You can do this manually instead.
• plugin-bibtex: - The @bibtex input type prefix has been changed to @biblatex
  • The @bibtex input type prefix is now used for parsing as pure @bibtex. These types have no type parser so are not automatically used.
  • The bibtex output format now outputs valid BibTeX, use the biblatex output format for BibLaTeX output.
  • The output option generateLabel has been replaced by the config option format.useIdAsLabel
• plugin-bibtex: Although the file parsing has been tested extensively, the mapping has not. In addition, since the mapping has been created from scratch according to the BibLaTeX documentation behaviour might change. Please report any problems at https://github.com/citation-js/citation-js/issues

0.5.0-alpha.9 (2020-10-20)

0.5.0-alpha.8 (2020-10-20)

Bug Fixes

• plugin-bibtex: fix closing tag behavior (466d5b1)
• plugin-csl: fix disambig error (35ec98d)

0.5.0-alpha.7 (2020-08-29)

Bug Fixes

• cli: fix check for prefixed options (4b7fe6b)
• plugin-bibtex: avoid error on non-utf-8 webpages (c09a9e4)
• plugin-csl: remove entry caching (efa648b)

0.5.0-alpha.6 (2020-07-04)

Bug Fixes

• plugin-bibtex: fix combining tilde (cc9fd8b)
• plugin-bibtex: normalize strings (447b0b4)
• plugin-bibtex: support all 10 escaped characters (#75) (da016b4)
• plugin-ris: format literal names (893d144), closes #87

Features

• plugin-bibtex: improve BibTeX mappings (#76) (214e77b)
• plugin-csl: update apa to 7th edition (#89) (2b5f2c5)

BREAKING CHANGES

• plugin-csl: default APA style is now 7th edition

0.5.0-alpha.5 (2019-10-28)

Bug Fixes

• core: do not use User-Agent in CORS (047847d)
• plugin-bibtex: ignore braces for grouping command (#64) (20763dc)
• plugin-ris: allow string for keyword component (#70) (0294999), closes #67
• plugin-ris: normalize DOIs (#68) (eb97fa5)
• plugin-ris: trim lines in parse function (#71) (f81b845), closes #66

0.5.0-alpha.4 (2019-10-15)

Bug Fixes

• core: fix normalising headers code for the browser (d4693a7)
• plugin-bibtex: do not try to format raw dates (b28eca8)
• plugin-bibtex: warn for umatched entry braces (7905667)

0.5.0-alpha.3 (2019-10-07)

Bug Fixes

• plugin-bibtex: remove nocase from diacritics (7f7e52f)
• plugin-bibtex: replace trimEnd() with trim() (b59da57)
• plugin-ris: fix handling of multiline values (eba2bfe)
• plugin-ris: handle \r\n line endings (f0a3b29)

Features

• bibtex: add new BibTeX parser (3c3588e)
• core: add Grammar class to utils (052754f)

0.5.0-alpha.2 (2019-09-10)

Bug Fixes

• core: fix date value null check (f6a3ab2)

0.5.0-alpha.1 (2019-09-10)

Bug Fixes

• core: fix cleaning 'null' date values (c927f81), closes /github.com/larsgw/citation.js/issues/190#issuecomment-529917382
• core: fix cleaning 'null' name values (2d59a32)

0.5.0-alpha.0 (2019-09-07)

Bug Fixes

• core: do not return empty name lists when cleaning (d31ca8a)
• core: fix Cite#sort handling of multi-value props (3a7751c)
• core: fix handling of generic best guesses (c8e8c78)
• core: fix util.fetchId (7850e75)
• core: improve date handling when cleaning (08da3e7)
• core: only overwrite individual headers in fetchFile (8d47684)
• core: pass around bestGuessConversions (50fa283)
• core: pass checkContentType in fetchFile (e415f76)
• core: set userAgent properly in fetchFile (a91fd7b)
• plugin-bibtex: fix label for incomplete author (352ca4f), closes #56

• chore!: drop Node 6 support (f27d812), closes #55

Features

• core: complete input option validation (d9be626)
• core: support has() & list() on plugins.config (fe7f59f)

BREAKING CHANGES

• drops Node 6 support

0.4.10 (2019-08-27)

Bug Fixes

• plugin-csl: use global symbol registry (dd8e839)

0.4.9 (2019-08-27)

Bug Fixes

• core: cap sync-rpc version (2157335), closes #54
• core: remove Object.entries call (c38e3b9)
• core: remove use of object spread (d82342a), closes #53
• plugin-csl: defer error to citeproc-js (0f76fcb)
• plugin-csl: only proxy @bibliography/style once (a372012)
• plugin-csl: pass 'this' in getWrapperProxy (c3e670a)
• plugin-csl: return proxy in getWrapperProxy (39e57a3)
• plugin-ris: fix legacy EP tag (d7c6ea5)

Features

• core: add match=none to propertyConstraint (9bafb58)
• core: add Translator to utils (0dd4963)
• plugin-ris: add RIS input support (1c49bcb)

0.4.8 (2019-07-06)

Bug Fixes

• core: do not attempt to clone non-standard objects (5309d08), closes #52
• plugin-wikidata: properly collect id from fetched items (710a276)

Features

• core: use central User-Agent in fetchFile (3fa8863), closes #39

0.4.7 (2019-06-29)

Bug Fixes

• core: make fetchFile checkResponse optional (a51a185)
• plugin-doi: use new checkContentType option (92df863)

0.4.6 (2019-06-28)

Bug Fixes

• core: check if fetchFile response matches request (e9f9132), closes #36
• core: fix getBody in fetchFile (e4247da)
• core: remove console.log call (e0b1790)
• plugin-wikidata: fix typo (8916446)

Features

• core: support POST in fetchFile (ece8a2d)

0.4.5 (2019-06-12)

Bug Fixes

• plugin-bibtex: fix parsing of name lists (11d7dd7)
• plugin-bibtex: fix safe labels for unicode names (8167958)
• plugin-bibtex: safe author name (a232fe7)
• plugin-bibtex: strip unknown commands in input (5b3508e)
• plugin-wikidata: exclude emoji flags as country names (73b0e84)
• plugin-wikidata: fix cache fetching (63a4f0d), closes #41
• plugin-wikidata: fix country name check (90d1c07)

Features

• cli: add --plugins option (229c95c), closes #40
• cli: plugin config & format options (8bd2a4a)
• cli: support for input options (87d8eb5)
• plugin-bibtex: add generateLabel option (d10631c)

BREAKING CHANGES

• plugin-bibtex: strips unkown commands entirely instead of replacing the braces with no-case tags

0.4.4 (2019-05-24)

Features

• plugin-wikidata: additional mappings (01be936), closes #18

0.4.3 (2019-05-11)

0.4.3-alpha.0 (2019-05-02)

0.4.2 (2019-04-26)

Bug Fixes

• plugin-bibtex: fix label creation (c7cde40), closes #35
• plugin-wikidata: support imprecise dates (c898db7), closes #33

Features

• plugin-wikidata: support more URL properties (#34) (d489843)

0.4.1 (2019-04-14)

Bug Fixes

• plugin-wikidata: fix getting label if no title exists (#32) (69243c5)

0.4.0 (2019-04-11)

Bug Fixes

• plugin-bibtex: always output fields with braces (c31e199), closes #27
• plugin-bibtex: use booktitle for inproceedings (149a49c), closes #28

Features

• plugin-bibtex: add date ranges (042b4e0)

0.4.0-rc.4 (2019-03-17)

Bug Fixes

• plugin-wikidata: await promise (3cde76f), closes #25
• plugin-wikidata: fix fetchApiAsync (def471d)
• plugin-wikidata: label first value (45087ee), closes #23
• plugin-wikidata: pass all values (a5acb75), closes #22
• plugin-wikidata: support novalue & somevalue (3ff9039)

Features

• core: clearer parsing error message (d296909)

Reverts

• Revert "test(core): fix incorrect match" (499e5ab)

0.4.0-rc.3 (2019-03-16)

Bug Fixes

• core: fix 'generateGraph' (60106db)
• core: fix html dict (8a06ce1)
• core: fix post-processing with 'target' set (ec3100b)
• core: remove Object.entries for Node 6 (47b3d9f)
• core: remove overwritten input formats (4f52124)
• core: set default input options (4843b40)
• plugin-bibtex: fix invalid output labels (5624eaf)
• plugin-bibtex: in-field whitespace (3f081bc), closes larsgw/citation-js#158
• plugin-bibtex: preserve nbsp (e1974c3)
• plugin-common: handle non-JSON (539bb6c)
• plugin-common: improve output json (49e0d45)
• plugin-wikidata: fallback for no labels (9dc3640)
• plugin-wikidata: fix langs support (aec2e72)
• plugin-wikidata: node 6 support (fdf4127)
• plugin-wikidata: update type index (d74dc21), closes /github.com/larsgw/citation.js/issues/166#issuecomment-472323555

Features

• actually throw errors (f025426), closes #14
• cli: add --log-level option (bdd718b)
• core: add 'strict' option (ad158b3), closes #14
• core: add 'target' option (89b9e8b)
• core: add method to get input format info (3d9493c)
• core: input format 'outputs' option (57645a2)
• logger: add log level support (83bdb4b), closes #10
• plugin-common: throw errors (3a67db4)
• plugin-wikidata: langs option (aaeb28d), closes #7

BREAKING CHANGES

• core: Aformentioned functions might throw errors

0.4.0-rc.2 (2019-02-26)

Bug Fixes

• core: keep custom props when normalizing (7b33982), closes #8
• core: pass options from Cite.async (663c6c1)
• core: support node 6 (a1ebf08)
• plugin-bibtex: support node 6 (8f6839b)
• plugin-wikidata: support more than 50 WD IDs (#11) (79ae40c)

Features

• cli: add --pipe option (a2993cc)
• cli: error on invalid options for pipe (0f6839d)
• core: include complete graph (2c82e48), closes larsgw/citation.js#165
• plugin-common: support NDJSON (e68afe1), closes larsgw/citation.js#163
• plugin-wikidata: allow subclass types (#5) (fc8aa7d), closes larsgw/citation.js#166
• plugin-wikidata: support namedAs qualifier (664644b), closes larsgw/citation.js#163

0.4.0-rc.1 (2018-12-27)

0.4.0-rc.0 (2018-12-06)

Bug Fixes

• plugin-ris: output year always string (88aabc9)