@softure-ai/blog 0.1.8 → 0.1.10

package/dist/server/options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/server/options.ts"],"names":[],"mappings":"AACA,OAAO,EAAiD,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACrG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAoC,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,EAA0B,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAatF,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,WAAW,CAGjE;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,YAAY,CAGnE;AAED,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,UAAU,CAS/D;AAED,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAKhE;AAED,uGAAuG;AACvG,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CAGpE;AAED,kGAAkG;AAClG,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,eAAe,GAAG,IAAI,CAKhF"}
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/server/options.ts"],"names":[],"mappings":"AACA,OAAO,EAAiD,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACrG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAA8B,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAoC,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,EAA0B,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAatF,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,WAAW,CAGjE;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,YAAY,CAGnE;AAED,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,UAAU,CAS/D;AAED,MAAM,WAAW,cAAc;IAC7B,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,2GAA2G;AAC3G,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc,CAGvE;AAED,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAKhE;AAED,uGAAuG;AACvG,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CAGpE;AAED,kGAAkG;AAClG,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,eAAe,GAAG,IAAI,CAKhF"}

package/dist/server/options.js

@@ -1,5 +1,6 @@
 // The blog options, routes and copy of the running app, read from the configuration.
 import { getModule, getSiteUrls } from "@softure-ai/core";
+import { DEFAULT_OPEN_GRAPH_LOCALES } from "../options.js";
 import { getReservedSlugs, normalizeRoute } from "../pages/paths.js";
 import { resolveQualitySettings } from "../quality/settings.js";
 const MODULE_ID = "blog";
@@ -32,6 +33,11 @@ export function getBlogRoutes(config) {
     };
     return { index: read("index"), glossary: read("glossary"), method: read("method"), rss: read("rss") };
 }
+/** The app locale's language tags: the app's `locales` entry, else the bare code and `en_US` / `pl_PL`. */
+export function getBlogLocaleTags(config) {
+    const tags = getBlogOptions(config).locales[config.locale];
+    return { bcp47: tags?.bcp47 ?? config.locale, openGraph: tags?.openGraph ?? DEFAULT_OPEN_GRAPH_LOCALES[config.locale] };
+}
 /** The path of the cache refresh route (`refreshBlogCache`), outside the pages' routes. */
 export function getBlogRefreshPath(config) {
     const path = getBlogModule(config).routes.refresh;

package/dist/server/options.js.map

@@ -1 +1 @@
-{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/server/options.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,OAAO,EAAE,SAAS,EAAE,WAAW,EAA6C,MAAM,kBAAkB,CAAC;AAGrG,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAmB,MAAM,mBAAmB,CAAC;AACtF,OAAO,EAAE,sBAAsB,EAAwB,MAAM,wBAAwB,CAAC;AAEtF,MAAM,SAAS,GAAG,MAAM,CAAC;AAEzB,sGAAsG;AACtG,SAAS,aAAa,CAAC,MAAqB;IAC1C,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC5C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,yFAAyF,CAAC,CAAC;IAC7G,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAqB;IAClD,kEAAkE;IAClE,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC,OAAsB,CAAC;AACtD,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,eAAe,CAAC,MAAqB;IACnD,+EAA+E;IAC/E,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAiB,CAAC;AACvE,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,aAAa,CAAC,MAAqB;IACjD,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;IAC5C,MAAM,IAAI,GAAG,CAAC,IAAsB,EAAU,EAAE;QAC9C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1B,wFAAwF;QACxF,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,uCAAuC,CAAC,CAAC;QACjH,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;AACxG,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,kBAAkB,CAAC,MAAqB;IACtD,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;IAClD,sFAAsF;IACtF,IAAI,IAAI,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;IACjH,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,uGAAuG;AACvG,MAAM,UAAU,oBAAoB,CAAC,MAAqB;IACxD,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACvC,OAAO,gBAAgB,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;AAC1D,CAAC;AAED,kGAAkG;AAClG,MAAM,UAAU,kBAAkB,CAAC,MAAqB;IACtD,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACnD,IAAI,OAAO,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,IAAI,GAAG,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;IAC/I,OAAO,sBAAsB,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,IAAI,CAAC,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/server/options.ts"],"names":[],"mappings":"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"}

package/dist/ui/blog-listing.js

@@ -21,8 +21,8 @@ function ArticleCard({ article, context, timezone, isLead }) {
 export function BlogListingView({ context, groups, termCount, timezone, cta }) {
     const copy = context.messages.pages;
     return (_jsxs(BlogLayout, { context: context, title: copy.blogTitle, lead: copy.blogDescription, children: [groups.length === 0 ? (_jsx("p", { className: "blog-empty", children: copy.empty })) : (_jsx("div", { className: "blog-groups", children: groups.map((group) => {
-                    const id = group.cluster === null ? undefined : getClusterAnchor(group.cluster);
-                    const headingId = `${id ?? "cluster-other"}-heading`;
+                    const id = group.cluster === null ? undefined : getClusterAnchor(group.cluster, context.clusterAnchorPrefix);
+                    const headingId = `${id ?? getClusterAnchor("other", context.clusterAnchorPrefix)}-heading`;
                     return (_jsxs("section", { id: id, "aria-labelledby": headingId, className: "blog-group", children: [_jsx("h2", { id: headingId, className: "blog-group-title", children: group.label }), group.lead === null ? null : _jsx(ArticleCard, { article: group.lead, context: context, timezone: timezone, isLead: true }), group.rest.length === 0 ? null : (_jsx("ul", { className: "blog-cards", children: group.rest.map((article) => (_jsx("li", { children: _jsx(ArticleCard, { article: article, context: context, timezone: timezone, isLead: false }) }, article.id))) }))] }, group.cluster ?? ""));
                 }) })), cta === undefined ? null : _jsx("div", { className: "blog-slot", children: cta }), termCount > 0 ? (_jsxs("p", { className: "blog-glossary-teaser", children: [_jsx("a", { href: context.routes.glossary, children: copy.glossaryLink }), ": ", copy.glossaryTeaser] })) : null, _jsx(BlogFooterNote, { context: context })] }));
 }

package/dist/ui/blog-listing.js.map

@@ -1 +1 @@
-{"version":3,"file":"blog-listing.js","sourceRoot":"","sources":["../../src/ui/blog-listing.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"blog-listing.js","sourceRoot":"","sources":["../../src/ui/blog-listing.tsx"],"names":[],"mappings":"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"}

package/dist/ui/page-context.d.ts

@@ -11,5 +11,7 @@ export interface BlogPageContext {
     readonly brand: string | null;
     /** The note under every text in the locale; `null` without one. */
     readonly disclaimer: string | null;
+    /** The listing's cluster anchor prefix (`<prefix>-<cluster>`); `cluster` when left out. */
+    readonly clusterAnchorPrefix?: string;
 }
 //# sourceMappingURL=page-context.d.ts.map

package/dist/ui/page-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"page-context.d.ts","sourceRoot":"","sources":["../../src/ui/page-context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,gGAAgG;IAChG,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,mEAAmE;IACnE,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC"}
+{"version":3,"file":"page-context.d.ts","sourceRoot":"","sources":["../../src/ui/page-context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,gGAAgG;IAChG,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,mEAAmE;IACnE,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,2FAA2F;IAC3F,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CACvC"}

package/module.json

@@ -1,6 +1,6 @@
 {
   "id": "blog",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "dependsOn": { "seo": "^0.1.0?", "security": "^0.1.0?" },
   "dbSchema": "blog",
   "tables": ["articles", "slug_history"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softure-ai/blog",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "SOFTURE AI blog module: articles and glossary terms kept as Markdown files with a strict YAML frontmatter (extendable by the app's own fields), stored in the module's Postgres schema by the softure-blog publish command (dry run by default, all or nothing, content hash, slug history, one pillar per cluster), a server-side Markdown renderer (no raw HTML, safe links, glossary links, block plugins), a text quality gate (softure-blog check, run before every publish) with language rulesets and rule plugins, the blog's pages ready to mount in Next.js (listing, article, glossary, method page, OG image, JSON-LD) with a proxy piece for 301 and 410, an article writing skill (softure-blog skill install) generated from the gate's rules, and discovery: an RSS feed, read next, sitemap entries and an IndexNow submit on publish through the optional @softure-ai/seo, with a rate-limited cache refresh route the publish calls first (through the optional @softure-ai/security).",
   "license": "MIT",
   "type": "module",
@@ -70,7 +70,7 @@
     "build": "tsc -p tsconfig.build.json"
   },
   "dependencies": {
-    "@softure-ai/core": "^0.1.0",
+    "@softure-ai/core": "^0.1.7",
     "@softure-ai/db": "^0.1.0",
     "markdown-it": "^15.0.2",
     "markdown-it-footnote": "^4.0.0",

package/src/index.ts

@@ -29,7 +29,7 @@ export const BLOG_RATE_LIMIT_BUCKETS = {
 export const blog = defineModule({
   manifest: {
     id: MODULE_ID,
-    version: "0.1.8",
+    version: "0.1.10",
     // seo is optional: with it the sitemap lists the texts and a publish pings IndexNow. security is
     // optional too: only the cache refresh route needs it, for its rate limit.
     dependsOn: { seo: "^0.1.0?", security: "^0.1.0?" },

package/src/messages/en.ts

@@ -47,6 +47,8 @@ export const en = {
   },
   glossary: {
     title: "Glossary",
+    /** A glossary term's page title with the brand: `{title}` the term, `{brand}` the site. */
+    termTitleWithBrand: "{title} | {brand}",
     description: "Short definitions of the terms the texts use, each with the day it was checked and its sources.",
     empty: "The first definitions are on their way.",
     explainedIn: "Explained in these texts",

package/src/messages/pl.ts

@@ -42,6 +42,8 @@ export const pl = {
   },
   glossary: {
     title: "Słownik pojęć",
+    /** A glossary term's page title with the brand: `{title}` the term, `{brand}` the site. */
+    termTitleWithBrand: "{title} | {brand}",
     description: "Krótkie definicje pojęć, których używają teksty, każda z datą sprawdzenia i źródłami.",
     empty: "Pierwsze definicje są w drodze.",
     explainedIn: "Rozwijamy w tekstach",

package/src/next/body.ts

@@ -0,0 +1,33 @@
+// The body input of the blog's pages, bound to the config: the glossary from the published terms, the
+// routes, the blog options, the site's own origins and the copy. The ready-made pages render with it,
+// and an app with its own page components uses the same function, so its "explained in these texts"
+// list and its body links follow the same rule as the package's pages:
+//
+//   const articles = findArticlesLinkingTermFor(config, { articles: published, termSlug: term.slug, terms });
+//   const body = renderPageBody(term, getBodyOptions(config, terms));
+import { getSiteUrls, type SoftureConfig } from "@softure-ai/core";
+import type { BlogArticle } from "../contract.js";
+import { findArticlesLinkingTerm, type RenderPageBodyOptions } from "../pages/body.js";
+import { toGlossary } from "../render/glossary.js";
+import { getBlogOptions } from "../server/options.js";
+import type { BlogPageContext } from "../ui/page-context.js";
+import { getPageContext } from "./context.js";
+
+/** What `renderPageBody` and `findArticlesLinkingTerm` (`/server`) take, as the ready-made pages build it. */
+export function getBodyOptions(config: SoftureConfig, terms: readonly BlogArticle[], context: BlogPageContext = getPageContext(config)): RenderPageBodyOptions {
+  const origins = [config.appOrigin, getSiteUrls(config).origin];
+  return { glossary: toGlossary(terms), routes: context.routes, options: getBlogOptions(config), origins, messages: context.messages };
+}
+
+export interface ArticlesLinkingTermInput {
+  /** The published articles to look through, e.g. `getPublishedArticles(config)`. */
+  readonly articles: readonly BlogArticle[];
+  readonly termSlug: string;
+  /** The published terms, e.g. `getPublishedTerms(config)`: the glossary the bodies link. */
+  readonly terms: readonly BlogArticle[];
+}
+
+/** The published articles whose body links the term: the list under a glossary term's page. */
+export function findArticlesLinkingTermFor(config: SoftureConfig, input: ArticlesLinkingTermInput): BlogArticle[] {
+  return findArticlesLinkingTerm(input.articles, input.termSlug, getBodyOptions(config, input.terms));
+}

package/src/next/context.ts

@@ -26,5 +26,6 @@ export function getPageContext(config: SoftureConfig): BlogPageContext {
     methodPath: options.methodPage ? routes.method : null,
     brand: options.brand?.name ?? null,
     disclaimer: options.disclaimer === undefined ? null : (options.disclaimer[config.locale] ?? options.disclaimer.en),
+    clusterAnchorPrefix: options.anchors.cluster,
   };
 }

package/src/next/discovery.ts

@@ -7,7 +7,7 @@ import { errorLogLabel, formatMessage, getSiteUrls } from "@softure-ai/core";
 import { getSoftureConfig } from "@softure-ai/core/next";
 import { buildBlogRss } from "../discovery/rss.js";
 import { getClusterLabel } from "../pages/listing.js";
-import { getBlogOptions } from "../server/options.js";
+import { getBlogLocaleTags, getBlogOptions } from "../server/options.js";
 import { getPageContext } from "./context.js";
 import { getPublishedArticles, getPublishedTerms } from "./data.js";
 
@@ -34,7 +34,7 @@ export async function serveBlogRss(): Promise<Response> {
       channel: {
         title: context.brand === null ? copy.pages.blogTitle : formatMessage(copy.pages.titleWithBrand, { title: copy.pages.blogTitle, brand: context.brand }),
         description: copy.pages.blogDescription,
-        language: config.locale,
+        language: getBlogLocaleTags(config).bcp47,
       },
       getCategory: (text) => (text.kind === "term" ? copy.glossary.title : text.cluster === null ? null : getClusterLabel(text.cluster, clusters, config.locale)),
     });

package/src/next/index.ts

@@ -1,5 +1,6 @@
 // The Next.js adapter of @softure-ai/blog: the pages, their metadata, the article's OG image, the RSS
 // feed, the cache refresh route and the cached reads (docs/02-module-standard.md §8).
+export { findArticlesLinkingTermFor, getBodyOptions, type ArticlesLinkingTermInput } from "./body.js";
 export { getBlogContext, getPageContext } from "./context.js";
 export { serveBlogRss } from "./discovery.js";
 export { buildArticleJsonLd, buildGlossaryJsonLd, buildTermJsonLd, getCrumbLabels } from "./json-ld.js";

package/src/next/json-ld.ts

@@ -7,7 +7,7 @@ import { getSiteUrls, type SoftureConfig } from "@softure-ai/core";
 import type { BlogArticle } from "../contract.js";
 import { getArticleJsonLd, getGlossaryJsonLd, getTermJsonLd, serializeJsonLd, type JsonLdContext } from "../pages/json-ld.js";
 import { getArticleCrumbs, getClusterLabel, getTermCrumbs, sortTerms, type CrumbLabels } from "../pages/listing.js";
-import { getBlogOptions } from "../server/options.js";
+import { getBlogLocaleTags, getBlogOptions } from "../server/options.js";
 import type { BlogPageContext } from "../ui/page-context.js";
 import { getPageContext } from "./context.js";
 
@@ -22,13 +22,21 @@ export function getCrumbLabels(config: SoftureConfig, context: BlogPageContext =
 }
 
 function getJsonLdContext(config: SoftureConfig, context: BlogPageContext): JsonLdContext {
-  return { urls: getSiteUrls(config), routes: context.routes, locale: config.locale, timezone: config.timezone, brand: context.brand };
+  return {
+    urls: getSiteUrls(config),
+    routes: context.routes,
+    locale: config.locale,
+    language: getBlogLocaleTags(config).bcp47,
+    ids: getBlogOptions(config).jsonLd.ids,
+    timezone: config.timezone,
+    brand: context.brand,
+  };
 }
 
 /** An article's `BlogPosting`, breadcrumbs and FAQ, serialized. */
 export function buildArticleJsonLd(config: SoftureConfig, article: BlogArticle): string {
   const context = getPageContext(config);
-  const crumbs = getArticleCrumbs(article, context.routes, getCrumbLabels(config, context));
+  const crumbs = getArticleCrumbs(article, context.routes, getCrumbLabels(config, context), { clusterAnchorPrefix: context.clusterAnchorPrefix });
   return serializeJsonLd(getArticleJsonLd(article, crumbs, getJsonLdContext(config, context)));
 }
 

package/src/next/metadata.ts

@@ -16,6 +16,7 @@ import type { Metadata } from "next/types.js";
 import type { BlogArticle } from "../contract.js";
 import { getArticleDates } from "../pages/dates.js";
 import { getArticlePath, getTermPath } from "../pages/paths.js";
+import { getBlogLocaleTags } from "../server/options.js";
 import type { BlogPageContext } from "../ui/page-context.js";
 import { getPageContext } from "./context.js";
 
@@ -24,8 +25,9 @@ export interface ListingMetadataInput {
   readonly isEmpty: boolean;
 }
 
-function withBrand(title: string, context: BlogPageContext): string {
-  return context.brand === null ? title : formatMessage(context.messages.pages.titleWithBrand, { title, brand: context.brand });
+/** `pattern`: the page kind's title message (`pages.titleWithBrand`, or `glossary.termTitleWithBrand` for a term). */
+function withBrand(title: string, context: BlogPageContext, pattern: string = context.messages.pages.titleWithBrand): string {
+  return context.brand === null ? title : formatMessage(pattern, { title, brand: context.brand });
 }
 
 /** A page's canonical URL: seo's host and trailing-slash rule when the app lists seo, else on `appOrigin`. */
@@ -48,11 +50,11 @@ function getStaticMetadata(config: SoftureConfig, context: BlogPageContext, page
   };
 }
 
-function getTextMetadata(config: SoftureConfig, context: BlogPageContext, text: BlogArticle, path: string, options: { hasFeed?: boolean } = {}): Metadata {
+function getTextMetadata(config: SoftureConfig, context: BlogPageContext, text: BlogArticle, path: string, options: { hasFeed?: boolean; titlePattern?: string } = {}): Metadata {
   const dates = getArticleDates(text, config.timezone);
   const url = getCanonicalUrl(config, path);
   return {
-    title: withBrand(text.title, context),
+    title: withBrand(text.title, context, options.titlePattern),
     description: text.description,
     robots: { index: true, follow: true },
     alternates: { canonical: url, ...(options.hasFeed === true ? { types: getFeedAlternates(config, context) } : {}) },
@@ -61,7 +63,7 @@ function getTextMetadata(config: SoftureConfig, context: BlogPageContext, text:
       title: text.title,
       description: text.description,
       url,
-      locale: config.locale,
+      locale: getBlogLocaleTags(config).openGraph,
       publishedTime: dates.published,
       modifiedTime: dates.updated ?? dates.published,
       ...(context.brand === null ? {} : { siteName: context.brand }),
@@ -89,10 +91,10 @@ export function buildGlossaryIndexMetadata(config: SoftureConfig, { isEmpty }: L
   return getStaticMetadata(config, context, { title: copy.title, description: copy.description, path: context.routes.glossary, isEmpty });
 }
 
-/** A glossary term's metadata. The caller checks the text is a published term. */
+/** A glossary term's metadata, titled by `glossary.termTitleWithBrand`. The caller checks the text is a published term. */
 export function buildTermMetadata(config: SoftureConfig, term: BlogArticle): Metadata {
   const context = getPageContext(config);
-  return getTextMetadata(config, context, term, getTermPath(context.routes, term.slug));
+  return getTextMetadata(config, context, term, getTermPath(context.routes, term.slug), { titlePattern: context.messages.glossary.termTitleWithBrand });
 }
 
 /** The method page's metadata. */

package/src/next/pages.tsx

@@ -17,8 +17,8 @@
 //
 // An app with its own page components keeps the rest: `generate*Metadata` and `BlogArticleOgImage`
 // mount next to its own page, and `build*Metadata` (metadata.ts) and `build*JsonLd` (json-ld.ts) take
-// a text it already read.
-import { getSiteUrls, type SoftureConfig } from "@softure-ai/core";
+// a text it already read; `getBodyOptions` and `findArticlesLinkingTermFor` (body.ts) give the body
+// input and a term's "explained in these texts" list.
 import { getSoftureConfig } from "@softure-ai/core/next";
 // `next/types.js`, not `next`: the root entry adds Next's globals (a read-only NODE_ENV) to every
 // program that includes this file.
@@ -27,16 +27,14 @@ import { notFound } from "next/navigation";
 import type { ReactNode } from "react";
 import type { BlogArticle } from "../contract.js";
 import { getRelatedArticles } from "../discovery/related.js";
-import { findArticlesLinkingTerm, renderPageBody, type RenderPageBodyOptions } from "../pages/body.js";
+import { findArticlesLinkingTerm, renderPageBody } from "../pages/body.js";
 import { getArticleDates } from "../pages/dates.js";
 import { getArticleCrumbs, groupByCluster, getTermCrumbs, sortTerms } from "../pages/listing.js";
-import { toGlossary } from "../render/glossary.js";
-import { getBlogOptions } from "../server/options.js";
 import { BlogArticleView } from "../ui/blog-article.js";
 import { GlossaryIndexView, GlossaryTermView } from "../ui/blog-glossary.js";
 import { BlogListingView } from "../ui/blog-listing.js";
 import { BlogMethodView } from "../ui/blog-method.js";
-import type { BlogPageContext } from "../ui/page-context.js";
+import { getBodyOptions } from "./body.js";
 import { getPageContext } from "./context.js";
 import { getPublishedArticles, getPublishedTerms, getTextBySlug } from "./data.js";
 import { buildArticleJsonLd, buildGlossaryJsonLd, buildTermJsonLd, getCrumbLabels } from "./json-ld.js";
@@ -71,11 +69,6 @@ function isPublished(text: BlogArticle | null, kind: BlogArticle["kind"]): text
   return text !== null && text.status === "published" && text.kind === kind;
 }
 
-function getBodyOptions(config: SoftureConfig, context: BlogPageContext, terms: readonly BlogArticle[]): RenderPageBodyOptions {
-  const origins = [config.appOrigin, getSiteUrls(config).origin];
-  return { glossary: toGlossary(terms), routes: context.routes, options: getBlogOptions(config), origins, messages: context.messages };
-}
-
 export async function generateBlogIndexMetadata(): Promise<Metadata> {
   const config = getSoftureConfig();
   const articles = await getPublishedArticles(config);
@@ -107,8 +100,8 @@ export async function BlogArticlePage({ params, cta, afterArticle }: BlogArticle
   if (!isPublished(article, "article")) notFound();
   const context = getPageContext(config);
   const [terms, published] = await Promise.all([getPublishedTerms(config), getPublishedArticles(config)]);
-  const body = renderPageBody<ReactNode>(article, getBodyOptions(config, context, terms));
-  const crumbs = getArticleCrumbs(article, context.routes, getCrumbLabels(config, context));
+  const body = renderPageBody<ReactNode>(article, getBodyOptions(config, terms, context));
+  const crumbs = getArticleCrumbs(article, context.routes, getCrumbLabels(config, context), { clusterAnchorPrefix: context.clusterAnchorPrefix });
   const jsonLd = buildArticleJsonLd(config, article);
   return (
     <BlogArticleView
@@ -155,7 +148,7 @@ export async function GlossaryTermPage({ params, cta }: GlossaryTermPageProps) {
   if (!isPublished(term, "term")) notFound();
   const context = getPageContext(config);
   const [terms, articles] = await Promise.all([getPublishedTerms(config), getPublishedArticles(config)]);
-  const bodyOptions = getBodyOptions(config, context, terms);
+  const bodyOptions = getBodyOptions(config, terms, context);
   const crumbs = getTermCrumbs(term, context.routes, getCrumbLabels(config, context));
   const jsonLd = buildTermJsonLd(config, term);
   return (

package/src/options.ts

@@ -200,6 +200,42 @@ const imagePolicySchema = z.strictObject({
   dimensions: z.custom<ArticleImagePolicy["dimensions"]>((value) => typeof value === "function", "must be a function: (src) => ({ width, height }) or null"),
 });
 
+/** A URL fragment or HTML id part, without `#`: a JSON-LD node id or the cluster anchor prefix. */
+const fragmentSchema = z
+  .string()
+  .max(40)
+  .regex(/^[A-Za-z][A-Za-z0-9_-]*$/, "must be a letter followed by letters, digits, - or _, without #, e.g. article");
+
+const jsonLdSchema = z.strictObject({
+  /** The `@id` fragments of the nodes: `<url>#<article>`, `<url>#<term>`, `<glossary url>#<glossary>`. */
+  ids: z
+    .strictObject({ article: fragmentSchema.default("article"), term: fragmentSchema.default("term"), glossary: fragmentSchema.default("glossary") })
+    .default({ article: "article", term: "term", glossary: "glossary" }),
+});
+
+const anchorsSchema = z.strictObject({
+  /** A cluster's section on the listing is `<cluster>-<key>`, the breadcrumb of its articles points there. */
+  cluster: fragmentSchema.default("cluster"),
+});
+
+/** The Open Graph locale of a language when the app sets none: `og:locale` is `language_TERRITORY`. */
+export const DEFAULT_OPEN_GRAPH_LOCALES = { en: "en_US", pl: "pl_PL" } as const;
+
+const localeTagsSchema = z.strictObject({
+  /** The content's language as a BCP-47 tag: JSON-LD `inLanguage` and the feed's `<language>`; the bare code by default. */
+  bcp47: z
+    .string()
+    .regex(/^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$/, "must be a BCP-47 tag, e.g. pl-PL")
+    .optional(),
+  /** `og:locale` (`language_TERRITORY`); `en_US` or `pl_PL` by default. */
+  openGraph: z
+    .string()
+    .regex(/^[a-z]{2,3}_[A-Z]{2}$/, "must be an Open Graph locale (language_TERRITORY), e.g. pl_PL")
+    .optional(),
+});
+
+export type BlogLocaleTagsInput = z.output<typeof localeTagsSchema>;
+
 export const blogOptionsSchema = z
   .strictObject({
     /** The folder with the article files, relative to the app's root. */
@@ -232,6 +268,12 @@ export const blogOptionsSchema = z
      * quality gate; without it every image renders as its alt text and the gate refuses it.
      */
     images: imagePolicySchema.optional(),
+    /** The JSON-LD node ids; an app that already published other fragments keeps them here. */
+    jsonLd: jsonLdSchema.default({ ids: { article: "article", term: "term", glossary: "glossary" } }),
+    /** The anchors the pages write; an app whose listing already used another prefix keeps it here. */
+    anchors: anchorsSchema.default({ cluster: "cluster" }),
+    /** The language tags per app locale: BCP-47 for the content, Open Graph for `og:locale`. */
+    locales: z.strictObject({ en: localeTagsSchema.optional(), pl: localeTagsSchema.optional() }).default({}),
     /** The page a withdrawn text answers with (410): extra links, or the app's own body. */
     gonePage: gonePageSchema.default({ links: [] }),
     /** How long the listing and glossary cache their reads; keep it equal to the pages' `revalidate`. */

package/src/pages/dates.ts

@@ -1,6 +1,6 @@
 // The days a page shows for a text, in the app's time zone. JSON-LD takes the same days, so the dates
 // a search engine compares (`dateModified` against the visible update) cannot drift apart.
-import type { Locale } from "@softure-ai/core";
+import { toCalendarDay, type Locale } from "@softure-ai/core";
 import type { BlogArticle } from "../contract.js";
 
 export interface ArticleDates {
@@ -12,10 +12,9 @@ export interface ArticleDates {
   readonly currentAsOf: string;
 }
 
-/** The calendar day of a moment in a time zone, `YYYY-MM-DD`. */
+/** The calendar day of a moment in a time zone, `YYYY-MM-DD`: core's `toCalendarDay` under the name this module exports. */
 export function getDayInZone(moment: Date, timezone: string): string {
-  // `en-CA` formats a date as YYYY-MM-DD.
-  return new Intl.DateTimeFormat("en-CA", { timeZone: timezone, year: "numeric", month: "2-digit", day: "2-digit" }).format(moment);
+  return toCalendarDay(moment, timezone);
 }
 
 /**

package/src/pages/index.ts

@@ -2,8 +2,9 @@
 // 301/410 decisions. The components (`../ui/`) and the Next adapter (`../next/`) render what it returns.
 export { findArticlesLinkingTerm, renderPageBody, type RenderPageBodyOptions } from "./body.js";
 export { formatDay, getArticleDates, getDayInZone, type ArticleDates } from "./dates.js";
-export { getArticleImageUrl, getArticleJsonLd, getGlossaryJsonLd, getTermJsonLd, serializeJsonLd, type JsonLdContext } from "./json-ld.js";
+export { DEFAULT_JSON_LD_IDS, getArticleImageUrl, getArticleJsonLd, getGlossaryJsonLd, getTermJsonLd, serializeJsonLd, type JsonLdContext, type JsonLdIds } from "./json-ld.js";
 export {
+  DEFAULT_CLUSTER_ANCHOR_PREFIX,
   getArticleCrumbs,
   getClusterAnchor,
   getClusterLabel,
@@ -11,6 +12,7 @@ export {
   groupByCluster,
   sortTerms,
   splitClusterLead,
+  type ArticleCrumbOptions,
   type ClusterGroup,
   type Crumb,
   type CrumbLabels,

package/src/pages/json-ld.ts

@@ -12,13 +12,34 @@ export interface JsonLdContext {
   readonly urls: SiteUrls;
   readonly routes: BlogRoutes;
   readonly locale: Locale;
+  /** The BCP-47 tag written as `inLanguage` (`getBlogLocaleTags`); `locale` when left out. */
+  readonly language?: string;
+  /** The `@id` fragments; `article`, `term` and `glossary` when left out. */
+  readonly ids?: JsonLdIds;
   readonly timezone: string;
   /** The brand as author and publisher; `null` leaves them out. */
   readonly brand: string | null;
 }
 
+/** The fragments after `#` in the nodes' `@id`s. */
+export interface JsonLdIds {
+  readonly article: string;
+  readonly term: string;
+  readonly glossary: string;
+}
+
+export const DEFAULT_JSON_LD_IDS: JsonLdIds = { article: "article", term: "term", glossary: "glossary" };
+
 type JsonLd = Record<string, unknown>;
 
+function getIds(ctx: Pick<JsonLdContext, "ids">): JsonLdIds {
+  return ctx.ids ?? DEFAULT_JSON_LD_IDS;
+}
+
+function getLanguage(ctx: Pick<JsonLdContext, "language" | "locale">): string {
+  return ctx.language ?? ctx.locale;
+}
+
 /** JSON for a `<script type="application/ld+json">`: no text in it can close the tag. */
 export function serializeJsonLd(data: unknown): string {
   return JSON.stringify(data).replace(/</g, "\\u003c");
@@ -57,12 +78,12 @@ export function getArticleJsonLd(article: BlogArticle, crumbs: readonly Crumb[],
   const graph: JsonLd[] = [
     {
       "@type": "BlogPosting",
-      "@id": `${url}#article`,
+      "@id": `${url}#${getIds(ctx).article}`,
       mainEntityOfPage: url,
       url,
       headline: article.title,
       description: article.description,
-      inLanguage: ctx.locale,
+      inLanguage: getLanguage(ctx),
       datePublished: dates.published,
       dateModified: dates.updated ?? dates.published,
       ...(brand === null ? {} : { author: brand, publisher: brand }),
@@ -80,8 +101,8 @@ export function getArticleJsonLd(article: BlogArticle, crumbs: readonly Crumb[],
   return { "@context": "https://schema.org", "@graph": graph };
 }
 
-function getTermSetReference(ctx: Pick<JsonLdContext, "urls" | "routes">, glossaryTitle: string): JsonLd {
-  return { "@type": "DefinedTermSet", "@id": `${ctx.urls.getCanonicalUrl(ctx.routes.glossary)}#glossary`, name: glossaryTitle };
+function getTermSetReference(ctx: Pick<JsonLdContext, "urls" | "routes" | "ids">, glossaryTitle: string): JsonLd {
+  return { "@type": "DefinedTermSet", "@id": `${ctx.urls.getCanonicalUrl(ctx.routes.glossary)}#${getIds(ctx).glossary}`, name: glossaryTitle };
 }
 
 /** A term: `DefinedTerm` in the glossary's `DefinedTermSet`, and its `BreadcrumbList`. */
@@ -92,11 +113,11 @@ export function getTermJsonLd(term: BlogArticle, crumbs: readonly Crumb[], ctx:
     "@graph": [
       {
         "@type": "DefinedTerm",
-        "@id": `${url}#term`,
+        "@id": `${url}#${getIds(ctx).term}`,
         url,
         name: term.title,
         description: term.description,
-        inLanguage: ctx.locale,
+        inLanguage: getLanguage(ctx),
         ...(term.termForms.length > 0 ? { alternateName: term.termForms } : {}),
         inDefinedTermSet: getTermSetReference(ctx, glossaryTitle),
       },
@@ -111,10 +132,10 @@ export function getGlossaryJsonLd(terms: readonly BlogArticle[], ctx: JsonLdCont
     "@context": "https://schema.org",
     ...getTermSetReference(ctx, glossaryTitle),
     url: ctx.urls.getCanonicalUrl(ctx.routes.glossary),
-    inLanguage: ctx.locale,
+    inLanguage: getLanguage(ctx),
     hasDefinedTerm: terms.map((term) => {
       const url = ctx.urls.getCanonicalUrl(getTermPath(ctx.routes, term.slug));
-      return { "@type": "DefinedTerm", "@id": `${url}#term`, name: term.title, description: term.description, url };
+      return { "@type": "DefinedTerm", "@id": `${url}#${getIds(ctx).term}`, name: term.title, description: term.description, url };
     }),
   };
 }

package/src/pages/listing.ts

@@ -23,9 +23,12 @@ export function getClusterLabel(cluster: string, labels: Readonly<Record<string,
   return words.charAt(0).toUpperCase() + words.slice(1);
 }
 
-/** The anchor of a cluster's section on the listing: the target of the article's middle crumb. */
-export function getClusterAnchor(cluster: string): string {
-  return `cluster-${cluster}`;
+/** The cluster anchor prefix when the app sets none (`blog({ anchors: { cluster } })`). */
+export const DEFAULT_CLUSTER_ANCHOR_PREFIX = "cluster";
+
+/** The anchor of a cluster's section on the listing (`<prefix>-<cluster>`): the target of the article's middle crumb. */
+export function getClusterAnchor(cluster: string, prefix: string = DEFAULT_CLUSTER_ANCHOR_PREFIX): string {
+  return `${prefix}-${cluster}`;
 }
 
 /** The pillar leads its group; the rest keep their order. Without a pillar there is no lead. */
@@ -75,11 +78,21 @@ export interface CrumbLabels {
   readonly cluster: (cluster: string) => string;
 }
 
+export interface ArticleCrumbOptions {
+  /** The listing's cluster anchor prefix; `cluster` when left out. */
+  readonly clusterAnchorPrefix?: string;
+}
+
 /** Blog › cluster › title; without a cluster, Blog › title. */
-export function getArticleCrumbs(article: Pick<BlogArticle, "slug" | "title" | "cluster">, routes: BlogRoutes, labels: CrumbLabels): Crumb[] {
+export function getArticleCrumbs(
+  article: Pick<BlogArticle, "slug" | "title" | "cluster">,
+  routes: BlogRoutes,
+  labels: CrumbLabels,
+  options: ArticleCrumbOptions = {},
+): Crumb[] {
   const crumbs: Crumb[] = [{ name: labels.blog, path: routes.index }];
   if (article.cluster !== null) {
-    crumbs.push({ name: labels.cluster(article.cluster), path: `${routes.index}#${getClusterAnchor(article.cluster)}` });
+    crumbs.push({ name: labels.cluster(article.cluster), path: `${routes.index}#${getClusterAnchor(article.cluster, options.clusterAnchorPrefix)}` });
   }
   crumbs.push({ name: article.title, path: getArticlePath(routes, article.slug) });
   return crumbs;

package/src/quality/settings.ts

@@ -1,6 +1,6 @@
 // The gate's resolved settings: the parsed options plus what the app config adds (its origins and time
 // zone) and the blog's image policy, with the ruleset and voice patterns compiled once.
-import type { SoftureConfig } from "@softure-ai/core";
+import { toCalendarDay, type SoftureConfig } from "@softure-ai/core";
 import type { ArticleImagePolicy } from "../render/images.js";
 import type { QualitySeverity } from "./finding.js";
 import type { QualityOptions } from "./options.js";
@@ -63,9 +63,9 @@ export function resolveQualitySettings(
   return { options, ruleset, voicePatterns, ownOrigins: [...new Set(origins)], timeZone: config.timezone, images, paths };
 }
 
-/** `YYYY-MM-DD` of a moment in a time zone. */
+/** `YYYY-MM-DD` of a moment in a time zone: core's `toCalendarDay` under the name this module exports. */
 export function getLocalDate(moment: Date, timeZone: string): string {
-  return new Intl.DateTimeFormat("en-CA", { timeZone, year: "numeric", month: "2-digit", day: "2-digit" }).format(moment);
+  return toCalendarDay(moment, timeZone);
 }
 
 /** The severity a finding of `rule` gets: the override, else its own; `null` for "off". */

package/src/server/index.ts

@@ -23,7 +23,7 @@ export {
   type RunBlogPublishOptions,
 } from "../db/publish-run.js";
 export { checkArticlesTable } from "./health.js";
-export { getBlogMessages, getBlogOptions, getBlogRefreshPath, getBlogReservedSlugs, getBlogRoutes, getQualitySettings } from "./options.js";
+export { getBlogLocaleTags, getBlogMessages, getBlogOptions, getBlogRefreshPath, getBlogReservedSlugs, getBlogRoutes, getQualitySettings, type BlogLocaleTags } from "./options.js";
 export * from "../discovery/index.js";
 export * from "../pages/index.js";
 export * from "../quality/index.js";