app/lib/publications/paths.mjs

Functions

Imports

It imports app/lib/media/classify.mjs. Imported by app/lib/cache-purge.server.ts, app/lib/carrel/publication-handler.server.ts, app/lib/cv/entries.mjs, app/lib/llms/save.server.ts, app/lib/nav.ts, app/lib/publications/compile.mjs, app/lib/publications/export-response.mjs, app/lib/publications/record.mjs, app/lib/publications/search-inputs.mjs, app/lib/publications/validate.mjs, app/lib/search/ask.server.ts, app/lib/seo.ts, app/lib/site-urls.server.ts, app/routes/publications.$slug.tsx, app/routes/publications.$slug[.md].ts, app/routes/publications.tsx.

Source

1// The trailing slash is load-bearing: Scholar requires citation_pdf_url in the same subdirectory as the
2// abstract page, which only /research/publications/<slug>/ satisfies. The slug derives from the DOI, never the
3// curated id, so it cannot be re-decided after Scholar has indexed it.
4
5import { ASSET_PREFIX } from "../media/classify.mjs";
6
7/**
8 * Casefolded: DOIs are case-insensitive and some are deposited mixed case. The collapse is lossy, so
9 * check:machine-readable asserts uniqueness.
10 *
11 * @param {string} doi as deposited
12 * @returns {string}
13 */
14export function doiSlug(doi) {
15  return String(doi ?? "")
16    .trim()
17    .toLowerCase()
18    .replace(/[^a-z0-9]+/g, "-")
19    .replace(/^-+|-+$/g, "");
20}
21
22export const PUBLICATIONS_PATH = "/research/publications";
23
24/** Every publication response carries it (the index, the pages, the exports, the twins); a save purges it. */
25export const PUBLICATIONS_CACHE_TAG = "publications";
26
27/**
28 * @param {string} slug from `doiSlug`
29 */
30export function paperPath(slug) {
31  return `${PUBLICATIONS_PATH}/${slug}/`;
32}
33
34/**
35 * Named for the slug, not the curated filename, so one string decides both the directory and the file.
36 *
37 * @param {string} slug from `doiSlug`
38 */
39export function paperPdfPath(slug) {
40  return `${PUBLICATIONS_PATH}/${slug}/${ASSET_PREFIX}${slug}.pdf`;
41}
42
43/**
44 * @param {string} slug from `doiSlug`
45 */
46export function paperMarkdownPath(slug) {
47  return `${PUBLICATIONS_PATH}/${slug}.md`;
48}
49
50/**
51 * A link to /search, so it works without script. Only the quoted title: the classic index ANDs its terms,
52 * so extra words return nothing. check:machine-readable asserts no title contains a quotation mark.
53 *
54 * @param {string} title DECODED, the way a reader sees it
55 */
56export function paperAskUrl(title) {
57  return `/search?q=${encodeURIComponent(`"${title}"`)}`;
58}
59
60/**
61 * @param {string} slug from `doiSlug`
62 */
63export function paperPdfDiskPath(slug) {
64  return `public/research/publications/${slug}/${ASSET_PREFIX}${slug}.pdf`;
65}