app/lib/series-path.mjs

Functions

Imports

It imports no other module of this repo. Imported by app/components/admin/title-slug-row.tsx, app/components/post-series-nav.tsx, app/db/posts.ts, app/lib/feed-response.ts, app/lib/nav.ts, app/lib/site-urls.server.ts, app/routes/blog.series.$series.tsx.

Source

1/**
2 * A series is FREE TEXT, unlike a tag, so it is normalised here and nowhere else; the archive
3 * builds and resolves its URL through this one function so the two cannot drift.
4 */
5
6/**
7 * Empty for a name with no alphanumerics; the caller decides what that means.
8 *
9 * @param {string} name
10 * @returns {string}
11 */
12export function seriesSlug(name) {
13  return name
14    .toLowerCase()
15    .replace(/[^a-z0-9]+/g, "-")
16    .replace(/^-+|-+$/g, "");
17}
18
19/**
20 * Takes the NAME, so no caller can forget to slugify and put two spellings of one URL on the site.
21 *
22 * @param {string} name
23 * @returns {string} a site-absolute path
24 */
25export function seriesPath(name) {
26  return `/writing/series/${encodeURIComponent(seriesSlug(name))}`;
27}