app/routes/kb-library[.md].ts

Functions

Imports

It imports app/db/procedures.ts, app/kb/libraries.mjs, app/kb/procedures/route.ts, app/lib/context.ts, app/lib/markdown-twin.ts, app/lib/seo.ts. No module of this repo imports it.

Source

1import { listPublishedRecordsOfProfile } from "~/db/procedures";
2import { getEnv } from "~/lib/context";
3import { canonicalLink } from "~/lib/markdown-twin";
4import { PROCEDURES_CACHE_TAG } from "~/kb/procedures/route";
5import { baseAtLibrary, baseCitation, baseItems, baseMarkdown } from "~/kb/libraries.mjs";
6import { SHARED_CACHE_CONTROL, SITE, SITE_ORIGIN } from "~/lib/seo";
7
8import type { Route } from "./+types/kb-library[.md]";
9
10const notFound = () => new Response("Not found\n", { status: 404, headers: { "content-type": "text/plain; charset=utf-8" } });
11
12/**
13 * A knowledge base's library as markdown: the table of every published entry, drawn from the same rows as the page, and
14 * how to download and cite it. Like the page, it is not there until the base has a published entry.
15 */
16export async function loader({ request, context }: Route.LoaderArgs) {
17  const base = baseAtLibrary(new URL(request.url).pathname.replace(/\.md$/, ""));
18  if (!base) return notFound();
19  const items = baseItems(base, await listPublishedRecordsOfProfile(getEnv(context), base.profile));
20  if (items.length === 0) return notFound();
21  const citation = baseCitation(base, { name: SITE.name, affiliation: SITE.affiliation, origin: SITE_ORIGIN });
22  const body = [
23    `# ${base.name}`,
24    "",
25    `## All ${base.name.toLowerCase()}`,
26    "",
27    baseMarkdown(base, items, SITE_ORIGIN),
28    "",
29    "## Download and cite",
30    "",
31    `- [CSV](${SITE_ORIGIN}${base.library}.csv): every entry with every fact the table shows; a filtered address gives the filtered rows`,
32    `- [JSON](${SITE_ORIGIN}${base.library}.json): the same rows`,
33    `- [Markdown](${SITE_ORIGIN}${base.library}.md): this page`,
34    "",
35    citation.library,
36    "",
37    citation.access,
38    "",
39    citation.protocol,
40    "",
41  ].join("\n");
42  return new Response(body, {
43    headers: {
44      "content-type": "text/markdown; charset=utf-8",
45      "cache-control": SHARED_CACHE_CONTROL,
46      "cache-tag": PROCEDURES_CACHE_TAG,
47      "x-robots-tag": "noindex",
48      link: canonicalLink(base.library),
49    },
50  });
51}