react-cheminfo 0.35.0 → 0.36.0

package/lib/seo/vite/prerender.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prerender.d.ts","sourceRoot":"","sources":["../../../src/seo/vite/prerender.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,KAAK,EAAU,MAAM,EAAE,MAAM,MAAM,CAAC;AAE3C,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAMnD,kEAAkE;AAClE,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC;IAC1B,qEAAqE;IACrE,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IAC7B;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,KAAK,GAAG,aAAa,CAAC,MAAM,GAAG,cAAc,CAAC,CAAC;IACxD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC1B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,YAAY,CAAC;CACnC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CA6EnE"}
+{"version":3,"file":"prerender.d.ts","sourceRoot":"","sources":["../../../src/seo/vite/prerender.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,KAAK,EAAU,MAAM,EAAE,MAAM,MAAM,CAAC;AAE3C,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAMnD,kEAAkE;AAClE,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC;IAC1B,qEAAqE;IACrE,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IAC7B;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,KAAK,GAAG,aAAa,CAAC,MAAM,GAAG,cAAc,CAAC,CAAC;IACxD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC1B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,YAAY,CAAC;IAClC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,WAAW,GAAG,SAAS,CAAC;CACzD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CA4EnE"}

package/lib/seo/vite/prerender.js

@@ -37,12 +37,12 @@ export function cheminfoPrerender(options) {
     const { site, routes, origin, robots = [] } = options;
     assertRoutes(routes);
     const structuredData = structuredDataOf(options);
-    const crawlPath = crawlPathOf(options);
     let out = 'dist';
     let serve = false;
     let logger = null;
-    const page = (template, url) => {
-        const head = fill(template, PAGE_HEAD_MARKER, `${pageHeadTags({ site, routes, origin, url })}${structuredData}`);
+    const page = (template, route) => {
+        const head = fill(template, PAGE_HEAD_MARKER, `${pageHeadTags({ site, routes, origin, url: route.path })}${structuredData}`);
+        const crawlPath = crawlPathOf(options, route);
         return crawlPath === '' ? head : fill(head, PAGE_BODY_MARKER, crawlPath);
     };
     return {
@@ -56,22 +56,22 @@ export function cheminfoPrerender(options) {
         // from the home route rather than shipped with its markers showing.
         transformIndexHtml: {
             order: 'post',
-            handler: (html) => serve ? page(html, homeRoute(routes).path) : html,
+            handler: (html) => (serve ? page(html, homeRoute(routes)) : html),
         },
         closeBundle() {
             if (serve)
                 return;
             const template = readFileSync(join(out, 'index.html'), 'utf8');
-            const write = (url, file) => {
+            const write = (route, file) => {
                 mkdirSync(dirname(file), { recursive: true });
-                writeFileSync(file, page(template, url));
+                writeFileSync(file, page(template, route));
             };
             let root = false;
             for (const route of routes) {
                 const address = trimTrailingSlash(route.path);
                 if (address === '/')
                     root = true;
-                write(route.path, address === '/'
+                write(route, address === '/'
                     ? join(out, 'index.html')
                     : join(out, address.slice(1), 'index.html'));
             }
@@ -79,7 +79,7 @@ export function cheminfoPrerender(options) {
             // no root would otherwise leave the template vite built, and ship a site
             // whose front page carries its markers instead of a head.
             if (!root)
-                write(homeRoute(routes).path, join(out, 'index.html'));
+                write(homeRoute(routes), join(out, 'index.html'));
             writeFileSync(join(out, 'sitemap.xml'), sitemapXml({ site, routes, origin }));
             if (robots !== false) {
                 writeFileSync(join(out, 'robots.txt'), robotsTxt({ site, routes, origin }, robots));
@@ -105,11 +105,18 @@ function structuredDataOf(options) {
         currency,
     })}`;
 }
-function crawlPathOf(options) {
+function crawlPathOf(options, route) {
     const { site, routes, origin, noscript = true } = options;
     if (noscript === false)
         return '';
+    const content = options.content?.(route);
     const { routes: listed, ...prose } = noscript === true ? {} : noscript;
-    return noscriptIndex({ site, origin, ...prose, routes: listed ?? routes });
+    return noscriptIndex({
+        site,
+        origin,
+        ...prose,
+        routes: listed ?? routes,
+        content,
+    });
 }
 //# sourceMappingURL=prerender.js.map

package/lib/seo/vite/prerender.js.map

@@ -1 +1 @@
-{"version":3,"file":"prerender.js","sourceRoot":"","sources":["../../../src/seo/vite/prerender.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"prerender.js","sourceRoot":"","sources":["../../../src/seo/vite/prerender.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAwE/E;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAyB;IACzD,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IACtD,YAAY,CAAC,MAAM,CAAC,CAAC;IACrB,MAAM,cAAc,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAEjD,IAAI,GAAG,GAAG,MAAM,CAAC;IACjB,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,MAAM,GAAkB,IAAI,CAAC;IAEjC,MAAM,IAAI,GAAG,CAAC,QAAgB,EAAE,KAAgB,EAAE,EAAE;QAClD,MAAM,IAAI,GAAG,IAAI,CACf,QAAQ,EACR,gBAAgB,EAChB,GAAG,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,cAAc,EAAE,CAC9E,CAAC;QACF,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC9C,OAAO,SAAS,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,EAAE,SAAS,CAAC,CAAC;IAC3E,CAAC,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,oBAAoB;QAE1B,cAAc,CAAC,MAAM;YACnB,KAAK,GAAG,MAAM,CAAC,OAAO,KAAK,OAAO,CAAC;YACnC,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAChD,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QACzB,CAAC;QAED,yEAAyE;QACzE,oEAAoE;QACpE,kBAAkB,EAAE;YAClB,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;SAC1E;QAED,WAAW;YACT,IAAI,KAAK;gBAAE,OAAO;YAClB,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC;YAE/D,MAAM,KAAK,GAAG,CAAC,KAAgB,EAAE,IAAY,EAAE,EAAE;gBAC/C,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC9C,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;YAC7C,CAAC,CAAC;YAEF,IAAI,IAAI,GAAG,KAAK,CAAC;YACjB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC9C,IAAI,OAAO,KAAK,GAAG;oBAAE,IAAI,GAAG,IAAI,CAAC;gBACjC,KAAK,CACH,KAAK,EACL,OAAO,KAAK,GAAG;oBACb,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC;oBACzB,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAC9C,CAAC;YACJ,CAAC;YACD,0EAA0E;YAC1E,yEAAyE;YACzE,0DAA0D;YAC1D,IAAI,CAAC,IAAI;gBAAE,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC;YAE7D,aAAa,CACX,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,EACxB,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CACrC,CAAC;YACF,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;gBACrB,aAAa,CACX,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,EACvB,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,CAC5C,CAAC;YACJ,CAAC;YAED,MAAM,EAAE,IAAI,CACV,GAAG,MAAM,CAAC,MAAM,+CAA+C,CAChE,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAyB;IACjD,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IACtC,IAAI,QAAQ,KAAK,KAAK;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACtC,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE,mBAAmB,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAC7E,OAAO,KAAK,oBAAoB,CAAC;QAC/B,IAAI;QACJ,MAAM;QACN,MAAM;QACN,QAAQ;QACR,eAAe;QACf,WAAW;QACX,mBAAmB;QACnB,QAAQ;KACT,CAAC,EAAE,CAAC;AACP,CAAC;AAED,SAAS,WAAW,CAAC,OAAyB,EAAE,KAAgB;IAC9D,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAC1D,IAAI,QAAQ,KAAK,KAAK;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,GAAG,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;IACvE,OAAO,aAAa,CAAC;QACnB,IAAI;QACJ,MAAM;QACN,GAAG,KAAK;QACR,MAAM,EAAE,MAAM,IAAI,MAAM;QACxB,OAAO;KACR,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-cheminfo",
-  "version": "0.35.0",
+  "version": "0.36.0",
   "license": "MIT",
   "description": "React components, hooks and framework-free helpers shared by the cheminfo sites: site chrome, citations, sharing, routing, pedagogy, charts, and the structure, orbital and 3D molecule viewers",
   "author": "Luc Patiny",
@@ -33,6 +33,7 @@
   "bin": {
     "cheminfo-check-deploy": "bin/check-deploy.mjs",
     "cheminfo-check-messages": "bin/check-messages.mjs",
+    "cheminfo-check-seo": "bin/check-seo.mjs",
     "cheminfo-check-tokens": "bin/check-tokens.mjs"
   },
   "files": [

package/src/language/core/index.ts

@@ -1,4 +1,6 @@
 export { languageName } from './languageName.ts';
+export type { LanguagePath } from './languagePath.ts';
+export { readLanguagePath, withLanguagePath } from './languagePath.ts';
 export {
   LANGUAGE_PARAM,
   isLanguageTag,

package/src/language/core/languagePath.ts

@@ -0,0 +1,78 @@
+/**
+ * The language a translated site routes by: a prefix on its own addresses.
+ *
+ * `/fr/tutorial` is the French tutorial, and English is written with no prefix
+ * at all, so every link already handed out in a course stays alive and the site
+ * does not acquire a second spelling of its own front page.
+ *
+ * This is the half of the design that makes a translation *findable*. A site
+ * that keeps its language in a query parameter, in the hash or in
+ * `localStorage` serves five languages at one address: a crawler sees one page,
+ * indexes one language, and the other four may as well not have been written.
+ * The parameter stays — it is how the language travels to a sibling that may
+ * not speak it (`./languageParam.ts`) — but it is not how a translated site
+ * routes.
+ *
+ * The prefix sits between the mount and the route, so a tool served as one of
+ * several on a shared host reads `/surge/fr/exercises`: the mount comes off
+ * first (`router/core/basePath.ts`), then the language, then the table is read.
+ */
+
+import type { Language } from '../../i18n/core/languages.ts';
+import { DEFAULT_LANGUAGE } from '../../i18n/core/languages.ts';
+import { trimTrailingSlash } from '../../router/core/address.ts';
+
+/** An address split into the language it names and the page it opens. */
+export interface LanguagePath {
+  /** The language named, or the default one when the address names none. */
+  language: Language;
+  /** The address from the site's own root, with the prefix taken off. */
+  path: string;
+}
+
+/**
+ * Read the language prefix off one of the site's own addresses.
+ *
+ * Only a language the site actually speaks is read as a prefix: on a site with
+ * no Italian, `/it` is whatever page is called `it`, not an empty Italian front
+ * page. So the list is the site's, never the family's.
+ * @param path - An address from the site's own root, the mount already off,
+ * e.g. `/fr/tutorial`.
+ * @param languages - The languages this site is written in, the default one
+ * included.
+ * @returns The language it names and the page it opens.
+ */
+export function readLanguagePath(
+  path: string,
+  languages: readonly Language[],
+): LanguagePath {
+  const opened = path.startsWith('/') ? path : `/${path}`;
+  const cut = opened.indexOf('/', 1);
+  const first = cut === -1 ? opened.slice(1) : opened.slice(1, cut);
+
+  for (const language of languages) {
+    if (language === DEFAULT_LANGUAGE || language !== first) continue;
+    const rest = cut === -1 ? '/' : opened.slice(cut);
+    return { language, path: trimTrailingSlash(rest) || '/' };
+  }
+  return {
+    language: DEFAULT_LANGUAGE,
+    path: trimTrailingSlash(opened) || '/',
+  };
+}
+
+/**
+ * Write one of the site's own addresses in a language.
+ *
+ * The default language is written with no prefix: an address naming no language
+ * is English, which is what keeps every link handed out before the site was
+ * translated pointing at the same page.
+ * @param language - The language to write it in.
+ * @param path - The address from the site's own root, e.g. `/tutorial`.
+ * @returns The address under that language, e.g. `/fr/tutorial`.
+ */
+export function withLanguagePath(language: Language, path: string): string {
+  const opened = path.startsWith('/') ? path : `/${path}`;
+  if (language === DEFAULT_LANGUAGE) return opened;
+  return opened === '/' ? `/${language}` : `/${language}${opened}`;
+}

package/src/seo/core/alternates.ts

@@ -0,0 +1,65 @@
+/**
+ * The tags that tell a search engine five addresses are one page written five
+ * times.
+ *
+ * Without them a translated site is read as five sites that happen to look
+ * alike: the French tutorial competes with the English one instead of being
+ * offered to a French reader, and a search engine picks one of them to keep.
+ * With them each address is served to the audience it was written for, and the
+ * four it was not stop diluting it.
+ *
+ * Every page names **every** language including itself — a set that does not
+ * list the page it is on is ignored whole — plus `x-default`, which is where a
+ * reader whose language we do not speak is sent.
+ */
+
+import type { Language } from '../../i18n/core/languages.ts';
+import { DEFAULT_LANGUAGE } from '../../i18n/core/languages.ts';
+import { withLanguagePath } from '../../language/core/languagePath.ts';
+import { escapeAttribute } from '../../share/core/escape.ts';
+
+/** Which page, in which languages, served from where. */
+export interface AlternateOptions {
+  /**
+   * Where the site is served, mount path included and no trailing slash, e.g.
+   * `https://3d.cheminfo.org`.
+   */
+  origin: string;
+  /**
+   * The page, from the site's own root and with no language prefix on it, e.g.
+   * `/tutorial`.
+   */
+  path: string;
+  /**
+   * Every language the site is written in. One language alone means there is
+   * nothing to point at, and no tag is written.
+   */
+  languages: readonly Language[];
+}
+
+/**
+ * The `rel="alternate"` block for one page of a translated site.
+ * @param options - The page, its languages and where the site is served.
+ * @returns The tags, one per line, or `''` when the site speaks one language.
+ */
+export function alternateLinkTags(options: AlternateOptions): string {
+  const { origin, path, languages } = options;
+  if (languages.length < 2) return '';
+
+  const tags: string[] = [];
+  for (const language of languages) {
+    tags.push(linkTag(language, address(origin, language, path)));
+  }
+  // A reader we have no language for gets the unprefixed address, which is the
+  // one every link handed out before the site was translated already points at.
+  tags.push(linkTag('x-default', address(origin, DEFAULT_LANGUAGE, path)));
+  return tags.join('\n');
+}
+
+function address(origin: string, language: Language, path: string): string {
+  return `${origin}${withLanguagePath(language, path)}`;
+}
+
+function linkTag(hreflang: string, href: string): string {
+  return `<link rel="alternate" hreflang="${escapeAttribute(hreflang)}" href="${escapeAttribute(href)}" />`;
+}

package/src/seo/core/index.ts

@@ -10,10 +10,13 @@ export type {
 export { noscriptIndex } from './noscript.ts';
 export type { PageMetaOptions } from './pageMeta.ts';
 export { injectPageMeta, pageDocumentMeta, pageHeadTags } from './pageMeta.ts';
+export type { PageContent, PageSection, PageTable } from './pageProse.ts';
+export { pageProseHtml } from './pageProse.ts';
 export type { PlainDescriptionOptions } from './plainDescription.ts';
 export { plainDescription, plainProse } from './plainDescription.ts';
 export type { RobotsDisallow } from './robots.ts';
 export { robotsTxt } from './robots.ts';
+export { routeProblems, withheldPhrase } from './routeProblems.ts';
 export type { RouteMeta } from './routes.ts';
 export { assertRoutes, homeRoute, pageMetaFor, routeFor } from './routes.ts';
 export type { SiteFilesOptions } from './siteFiles.ts';

package/src/seo/core/noscript.ts

@@ -12,6 +12,8 @@ import { ECOSYSTEM_SITES, siteUrl } from '../../ecosystem/core/sites.ts';
 import { joinBasePath } from '../../router/core/basePath.ts';
 import { escapeAttribute, escapeText } from '../../share/core/escape.ts';
 
+import type { PageContent } from './pageProse.ts';
+import { pageProseHtml } from './pageProse.ts';
 import type { RouteMeta } from './routes.ts';
 import type { SiteFilesOptions } from './siteFiles.ts';
 import { mountPathOf, resolveSite } from './siteFiles.ts';
@@ -93,6 +95,14 @@ export interface NoscriptOptions
   extends Omit<SiteFilesOptions, 'routes'>, Omit<NoscriptText, 'routes'> {
   /** The addresses it links, each with the label it is linked under. */
   routes: readonly NoscriptRoute[];
+  /**
+   * What the page being written says, above the crawl path. The block is the
+   * only text a crawler is handed before anything runs, so a page with nothing
+   * of its own here is indexed on its title and on this site's menu — which
+   * every other page of the site carries too.
+   * @default undefined — the block is the menu alone
+   */
+  content?: PageContent;
 }
 
 /**
@@ -111,14 +121,20 @@ export function noscriptIndex(options: NoscriptOptions): string {
   const site = resolveSite(options.site);
   const hrefs = options.hrefs ?? 'absolute';
   const mount = hrefs === 'absolute' ? mountPathOf(options) : '';
-  const heading = escapeText(options.heading ?? siteDisplayName(site));
+  const content = options.content;
+  // The page's own name answers the title it is indexed under, so it wins over
+  // a heading the site writes for every one of its pages at once.
+  const heading = escapeText(
+    content?.heading ?? options.heading ?? siteDisplayName(site),
+  );
   const intro = escapeText(
     options.intro ??
       `${site.tagline} This tool needs JavaScript; these are the pages it offers:`,
   );
+  const prose = content === undefined ? '' : pageProseHtml(content, '  ');
 
   return `<noscript>
-  <h1>${heading}</h1>
+  <h1>${heading}</h1>${prose}
   <p>${intro}</p>${pageList(options.routes, mount, hrefs, '  ')}${familyList(site.id, options.ecosystem)}
 </noscript>`;
 }

package/src/seo/core/pageMeta.ts

@@ -14,14 +14,26 @@
 
 import { siteDisplayName } from '../../ecosystem/core/lookup.ts';
 import type { SiteId, SiteRecord } from '../../ecosystem/core/sites.ts';
+import type { Language } from '../../i18n/core/languages.ts';
+import { DEFAULT_LANGUAGE } from '../../i18n/core/languages.ts';
+import {
+  readLanguagePath,
+  withLanguagePath,
+} from '../../language/core/languagePath.ts';
+import { withoutQueryOrFragment } from '../../router/core/address.ts';
+import { stripBasePath } from '../../router/core/basePath.ts';
 import { escapeAttribute, escapeText } from '../../share/core/escape.ts';
 
+import { alternateLinkTags } from './alternates.ts';
 import type { DocumentMeta } from './documentMeta.ts';
 import type { RouteMeta } from './routes.ts';
 import { pageMetaFor } from './routes.ts';
 import { mountPathOf, originOf, resolveSite } from './siteFiles.ts';
 import { PAGE_HEAD_MARKER, fill } from './template.ts';
 
+// A scheme and an authority: what `location.href` hands out.
+const ABSOLUTE_URL = /^[a-z][\d+.a-z-]*:\/\//i;
+
 /** Which site is being served, and what it answers. */
 export interface PageMetaOptions {
   /** The site, named or passed. */
@@ -48,6 +60,17 @@ export interface PageMetaOptions {
    * @default '/og.png'
    */
   image?: string;
+  /**
+   * Every language the site is written in, the default one included.
+   *
+   * The language is read off the address — `/fr/tutorial` is the French
+   * tutorial — so the canonical, the card and the `hreflang` set are written
+   * for the page actually being served, and the routes passed are the table in
+   * that language. A site writing one language leaves this out and nothing
+   * about its head changes.
+   * @default [the default language]
+   */
+  languages?: readonly Language[];
 }
 
 /**
@@ -74,12 +97,27 @@ export function injectPageMeta(html: string, options: PageMetaOptions): string {
  */
 export function pageHeadTags(options: PageMetaOptions): string {
   const name = siteDisplayName(resolveSite(options.site));
-  const description = routeMetaOf(options).description;
+  const route = routeMetaOf(options);
+  const description = route.description;
   const origin = originOf(options);
   const { title, canonical } = pageDocumentMeta(options);
   const image = absolute(options.image ?? '/og.png', origin);
+  const alternates = alternateLinkTags({
+    origin,
+    path: route.path,
+    languages: languagesOf(options),
+  });
+
+  // A maintenance screen says so on the page itself. `robots.txt` cannot: it
+  // stops the crawl, and an address nobody crawled is still listed from
+  // whatever links to it, with no description to show for it.
+  const robots =
+    route.indexed === false
+      ? ['<meta name="robots" content="noindex, nofollow" />']
+      : [];
 
   return [
+    ...robots,
     `<title>${escapeText(title)}</title>`,
     `<meta name="description" content="${escapeAttribute(description)}" />`,
     `<link rel="canonical" href="${escapeAttribute(canonical)}" />`,
@@ -90,6 +128,7 @@ export function pageHeadTags(options: PageMetaOptions): string {
     `<meta property="og:url" content="${escapeAttribute(canonical)}" />`,
     `<meta property="og:image" content="${escapeAttribute(image)}" />`,
     '<meta name="twitter:card" content="summary_large_image" />',
+    ...(alternates === '' ? [] : [alternates]),
   ].join('\n');
 }
 
@@ -112,15 +151,47 @@ export function pageDocumentMeta(
   return {
     title: `${meta.title} — ${siteDisplayName(site)}`,
     description: meta.description,
-    canonical: `${originOf(options)}${meta.path}`,
+    canonical: `${originOf(options)}${withLanguagePath(pageLanguage(options), meta.path)}`,
   };
 }
 
+/**
+ * The language an address is being served in.
+ *
+ * Read off the address itself rather than passed beside it, so the catalog a
+ * server picks and the canonical it writes cannot disagree.
+ * @param options - Which site, which address, and the languages it speaks.
+ * @returns The language named by the address, or the default one.
+ * @throws {Error} When the deployment names an origin that is not an absolute
+ * address.
+ */
+export function pageLanguage(options: PageMetaOptions): Language {
+  return readLanguagePath(ownPath(options), languagesOf(options)).language;
+}
+
 // A server behind a mount is handed the address the browser asked for, and the
 // route table is written from the site's own root, so the mount the origin
 // carries is taken off it before the table is read.
 function routeMetaOf(options: PageMetaOptions): RouteMeta {
-  return pageMetaFor(options.routes, options.url, mountPathOf(options));
+  const { path } = readLanguagePath(ownPath(options), languagesOf(options));
+  return pageMetaFor(options.routes, path);
+}
+
+// The address from the site's own root, the mount taken off, with the query
+// string and the fragment gone: what the language prefix is read off. An app
+// handing over `location.href` is answered too, so the one reading serves a
+// server, a build and a click alike.
+function ownPath(options: PageMetaOptions): string {
+  const url = options.url;
+  const path =
+    ABSOLUTE_URL.test(url) && URL.canParse(url)
+      ? new URL(url).pathname
+      : withoutQueryOrFragment(url);
+  return stripBasePath(mountPathOf(options), path);
+}
+
+function languagesOf(options: PageMetaOptions): readonly Language[] {
+  return options.languages ?? [DEFAULT_LANGUAGE];
 }
 
 function absolute(target: string, origin: string): string {

package/src/seo/core/pageProse.ts

@@ -0,0 +1,146 @@
+/**
+ * The text a page is indexed on, written into the HTML before anything runs.
+ *
+ * A prerendered site writes one file per address, and each of them carried the
+ * same body: the site's crawl path, and nothing else. A search engine clusters
+ * pages by the text it is handed, so a hundred and eighteen element pages
+ * differing only in their title are a hundred and seventeen duplicates — and
+ * which one it keeps is not ours to choose. A page heavy enough that the
+ * renderer never gets to it is indexed on that body alone.
+ *
+ * So what a site writes here is the text its running app already shows, drawn
+ * from the same data: the prose is not written twice, it is written where the
+ * build can reach it. Text only, and escaped — the addresses a reader follows
+ * are the crawl path's business.
+ */
+
+import { escapeText } from '../../share/core/escape.ts';
+
+/** A table of facts under the prose: the rows a page would show anyway. */
+export interface PageTable {
+  /** Header cells, left to right. */
+  columns: readonly string[];
+  /** Body rows, each as many cells as there are columns. */
+  rows: ReadonlyArray<readonly string[]>;
+  /**
+   * The sentence under the table, saying where the numbers come from.
+   * @default undefined — the table stands on its own
+   */
+  caption?: string;
+}
+
+/** One run of the page's text: a heading, prose, and the facts under it. */
+export interface PageSection {
+  /**
+   * The heading it opens with, as an `h2`.
+   * @default undefined — the run carries no heading
+   */
+  heading?: string;
+  /**
+   * The paragraphs under it, each taken as written.
+   * @default undefined — no prose
+   */
+  paragraphs?: readonly string[];
+  /**
+   * A list under the prose, one item per line.
+   * @default undefined — no list
+   */
+  list?: readonly string[];
+  /**
+   * A table under the prose.
+   * @default undefined — no table
+   */
+  table?: PageTable;
+}
+
+/** The whole of one page's text, as the page itself would say it. */
+export interface PageContent extends PageSection {
+  /**
+   * The page's own name, written as its `h1`. It answers the title the page is
+   * indexed under, so a reader who searched for it reads the same words again.
+   */
+  heading: string;
+  /**
+   * The runs under the opening prose, in reading order.
+   * @default undefined — the page is its opening prose
+   */
+  sections?: readonly PageSection[];
+}
+
+/**
+ * The page's text as HTML, everything below its heading.
+ *
+ * The heading itself is left to the caller, which already writes the one `h1`
+ * the page carries — `noscriptIndex` does.
+ * @param content - What the page says.
+ * @param indent - The indentation every line is written at.
+ * @default '  '
+ * @returns The HTML, opening with a newline, or `''` when the page says nothing
+ * below its heading.
+ */
+export function pageProseHtml(content: PageContent, indent = '  '): string {
+  // The page's own heading is the caller's `h1`; what is left of its opening run
+  // is prose like any section's.
+  const opening: PageSection = {
+    paragraphs: content.paragraphs,
+    list: content.list,
+    table: content.table,
+  };
+  const parts = [
+    sectionHtml(opening, indent),
+    ...(content.sections ?? []).map((section) => sectionHtml(section, indent)),
+  ];
+  return parts.join('');
+}
+
+function sectionHtml(section: PageSection, indent: string): string {
+  const lines: string[] = [];
+  if (section.heading !== undefined && section.heading.trim() !== '') {
+    lines.push(`${indent}<h2>${escapeText(section.heading)}</h2>`);
+  }
+  for (const paragraph of section.paragraphs ?? []) {
+    if (paragraph.trim() === '') continue;
+    lines.push(`${indent}<p>${escapeText(paragraph)}</p>`);
+  }
+  const list = listHtml(section.list, indent);
+  if (list !== '') lines.push(list);
+  const table = tableHtml(section.table, indent);
+  if (table !== '') lines.push(table);
+  return lines.length === 0 ? '' : `\n${lines.join('\n')}`;
+}
+
+function listHtml(list: readonly string[] | undefined, indent: string): string {
+  // A list with no item is not a list: `<ul>` holds at least one `<li>`.
+  if (list === undefined || list.length === 0) return '';
+  const items = list
+    .map((item) => `${indent}  <li>${escapeText(item)}</li>`)
+    .join('\n');
+  return `${indent}<ul>\n${items}\n${indent}</ul>`;
+}
+
+function tableHtml(table: PageTable | undefined, indent: string): string {
+  // A table with no row says nothing, and an empty `<tbody>` is not markup a
+  // crawler is owed.
+  if (table === undefined || table.rows.length === 0) return '';
+  const caption =
+    table.caption === undefined || table.caption.trim() === ''
+      ? ''
+      : `\n${indent}  <caption>${escapeText(table.caption)}</caption>`;
+  const head = table.columns
+    .map((column) => `<th>${escapeText(column)}</th>`)
+    .join('');
+  const body = table.rows
+    .map(
+      (row) =>
+        `${indent}    <tr>${row.map((cell) => `<td>${escapeText(cell)}</td>`).join('')}</tr>`,
+    )
+    .join('\n');
+  return `${indent}<table>${caption}
+${indent}  <thead>
+${indent}    <tr>${head}</tr>
+${indent}  </thead>
+${indent}  <tbody>
+${body}
+${indent}  </tbody>
+${indent}</table>`;
+}