app/lib/publications/coins.mjs

Functions

Imports

It imports app/lib/publications/entities.mjs, app/lib/publications/exports.mjs. Imported by app/routes/publications.tsx.

Source

1// COinS: Zotero and its relatives scan for .Z3988 and read only the title attribute, so the span stays
2// empty. Index only: a list page cannot carry per-paper citation_* tags, and paper pages already do.
3
4import { canonicalAuthor } from "./exports.mjs";
5import { decodeEntities } from "./entities.mjs";
6
7const GENRE = {
8  article: "article",
9  review: "article",
10  abstract: "conference",
11  chapter: "bookitem",
12  "teaching-resource": "document",
13};
14
15/**
16 * Key order is fixed so the output is a pure function of the values; check:machine-readable compares bytes.
17 *
18 * @param {any} paper
19 * @returns {string}
20 */
21export function coinsTitle(paper) {
22  /** @type {[string, string][]} */
23  const pairs = [
24    ["ctx_ver", "Z39.88-2004"],
25    ["rft_val_fmt", "info:ofi/fmt:kev:mtx:journal"],
26    ["rft.genre", GENRE[/** @type {keyof typeof GENRE} */ (paper.type)] ?? "article"],
27    ["rft.atitle", decodeEntities(paper.title)],
28  ];
29  if (paper.journal) pairs.push(["rft.jtitle", decodeEntities(paper.journal)]);
30  if (paper.year) pairs.push(["rft.date", String(paper.year)]);
31  if (paper.volume) pairs.push(["rft.volume", String(paper.volume)]);
32  if (paper.issue) pairs.push(["rft.issue", String(paper.issue)]);
33  if (paper.firstPage) pairs.push(["rft.spage", paper.firstPage]);
34  if (paper.lastPage) pairs.push(["rft.epage", paper.lastPage]);
35  // One rft.au per author: a joined string reads as one author with a very long name.
36  for (const name of paper.authors ?? []) {
37    pairs.push(["rft.au", canonicalAuthor(name)]);
38  }
39  if (paper.doi) {
40    // info:doi/ is the form OpenURL specifies; a bare DOI in rft_id is not.
41    pairs.push(["rft_id", `info:doi/${paper.doi}`]);
42  }
43
44  // encodeURIComponent, not URLSearchParams, which encodes a space as +, a literal plus here.
45  return pairs
46    .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`)
47    .join("&");
48}