@riebeckite/honox 0.0.15 → 0.0.17

package/dist/index.d.ts

@@ -1,10 +1,12 @@
 export { loadRiebeckiteConfig, resolveHonoxConfig, } from "./src/config_loader.js";
 export { replaceHonoxIslandDependencyPlugin } from "./src/honox_islands.js";
+export { assertGitHubRepository, deploymentTemplateFiles, type ScaffoldDeploymentOptions, } from "./src/scaffold/deployment.js";
 export type { ScaffoldSiteOptions, ScaffoldSiteResult, } from "./src/scaffold/index.js";
 export { ScaffoldSiteError, scaffoldRiebeckiteSite, } from "./src/scaffold/index.js";
 export { formatScaffoldNextSteps, type ScaffoldNextStepsOptions, } from "./src/scaffold/next-steps.js";
 export type { ScaffoldAppFileKey, ScaffoldPageKey, ScaffoldPluginSpec, ScaffoldPreset, ScaffoldPresetName, ScaffoldReadmeLevel, ScaffoldThemeSpec, } from "./src/scaffold/presets.js";
 export { empty, isScaffoldPresetName, minimal, resolveScaffoldPreset, SCAFFOLD_DEFAULT_PRESET, SCAFFOLD_PRESET_NAMES, scaffoldPresets, showcase, starter, } from "./src/scaffold/presets.js";
+export { buildDefaultWranglerConfig, DEFAULT_WORKER_NAME, GITHUB_ACTIONS_SECRETS, PACKAGE_MANAGER, WORKER_NAME_MAX_LENGTH, WRANGLER_DEFAULTS, WRANGLER_VERSION, type WranglerDefaults, workerNameFromDirectory, } from "./src/scaffold/wrangler-defaults.js";
 export { createRiebeckiteSsg, defaultSsgEntry, riebeckiteSsgExtensionMap, } from "./src/ssg.js";
 export type { RiebeckiteSsgOptions } from "./src/ssg_plugin.js";
 export { riebeckiteSsg } from "./src/ssg_plugin.js";

package/dist/index.js

@@ -254,10 +254,6 @@ function isJavaScriptModule(filePath) {
   return /\.[cm]?[jt]sx?$/.test(filePath);
 }
 
-// src/scaffold/index.ts
-import fs8 from "node:fs/promises";
-import path9 from "node:path";
-
 // src/scaffold/wrangler-defaults.ts
 var WRANGLER_DEFAULTS = {
   /** JSON schema for IDE support and validation */
@@ -271,6 +267,18 @@ var WRANGLER_DEFAULTS = {
   /** Static assets directory - Riebeckite builds to ./dist */
   assets: { directory: "./dist" }
 };
+var WRANGLER_VERSION = "^4.83.0";
+var DEFAULT_WORKER_NAME = "riebeckite-site";
+var WORKER_NAME_MAX_LENGTH = 63;
+function workerNameFromDirectory(directoryName) {
+  const normalized = directoryName.trim().toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/-+/g, "-").replace(/^-+|-+$/g, "");
+  const name = normalized.slice(0, WORKER_NAME_MAX_LENGTH).replace(/-+$/g, "");
+  return name.length > 0 ? name : DEFAULT_WORKER_NAME;
+}
+function buildDefaultWranglerConfig(workerName) {
+  return `${JSON.stringify({ ...WRANGLER_DEFAULTS, name: workerName }, null, 2)}
+`;
+}
 var GITHUB_ACTIONS_SECRETS = {
   /** Cloudflare API token with Workers Scripts: Edit permission */
   CLOUDFLARE_API_TOKEN: "CLOUDFLARE_API_TOKEN",
@@ -281,6 +289,7 @@ var GITHUB_ACTIONS_SECRETS = {
   /** Optional: Token for site repo to read content repo */
   RIEBECKITE_CONTENT_READ_TOKEN: "RIEBECKITE_CONTENT_READ_TOKEN"
 };
+var PACKAGE_MANAGER = "npm";
 
 // src/scaffold/deployment.ts
 var GITHUB_REPOSITORY_PATTERN = /^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/;
@@ -324,9 +333,14 @@ function deploymentTemplateFiles(options) {
     ] : []
   ];
 }
+function wranglerJsoncFile(workerName) {
+  return {
+    path: "wrangler.jsonc",
+    content: buildDefaultWranglerConfig(workerName)
+  };
+}
 function wranglerConfig() {
-  return `${JSON.stringify(WRANGLER_DEFAULTS, null, 2)}
-`;
+  return buildDefaultWranglerConfig(WRANGLER_DEFAULTS.name);
 }
 function deployWorkflow(contentRepository) {
   const contentCheckout = contentRepository === void 0 ? "" : `
@@ -428,6 +442,10 @@ jobs:
 `;
 }
 
+// src/scaffold/index.ts
+import fs8 from "node:fs/promises";
+import path9 from "node:path";
+
 // src/scaffold/presets.ts
 var SCAFFOLD_LANGUAGES = [
   "en",
@@ -472,13 +490,8 @@ var l10n = np("@riebeckite/plugin-l10n", "l10n", (context) => {
   return `{ defaultLang: ${JSON.stringify(defaultLang)}, languages: ${JSON.stringify(context.languages)} }`;
 });
 var seo = np("@riebeckite/plugin-seo", "seo", {
-  siteName: {
-    depth: 1,
-    value: (context) => JSON.stringify(context.variables.title)
-  },
   sitemap: { depth: 1, value: "true" },
   robots: { depth: 2, value: "true" },
-  defaultImage: { depth: 3, value: '"/ogp.png"' },
   feed: { depth: 3, value: "{ rss: true, atom: true, json: true }" }
 });
 var toc = np("@riebeckite/plugin-toc", "tocPlugin");
@@ -499,6 +512,17 @@ var codeEnhance = np("@riebeckite/plugin-code-enhance", "codeEnhance", {
 });
 var search = np("@riebeckite/plugin-search", "searchPlugin");
 var backlinks = np("@riebeckite/plugin-backlinks", "backlinksPlugin");
+var breadcrumbs = np("@riebeckite/plugin-breadcrumbs", "breadcrumbsPlugin");
+var navigationStarter = np(
+  "@riebeckite/plugin-navigation",
+  "navigation",
+  `{ items: [{ label: "Guide", href: "/guide" }, { label: "Examples", href: "/examples" }, { label: "Notes", href: "/notes/planning", children: [{ label: "Planning", href: "/notes/planning" }, { label: "Writing", href: "/notes/writing" }] }], secondary: [{ label: "Guide", href: "/guide" }, { label: "Examples", href: "/examples" }] }`
+);
+var navigationShowcase = np(
+  "@riebeckite/plugin-navigation",
+  "navigation",
+  `{ items: [{ label: "Guide", href: "/guide" }, { label: "Examples", href: "/examples" }, { label: "Framework", href: "/framework/plugins", children: [{ label: "Plugins", href: "/framework/plugins" }, { label: "Themes", href: "/framework/themes" }] }], secondary: [{ label: "Guide", href: "/guide" }, { label: "Examples", href: "/examples" }] }`
+);
 var relatedPosts = np("@riebeckite/plugin-related-posts", "relatedPosts", {
   limit: { depth: 2, value: "5" },
   useTags: { depth: 2, value: "true" },
@@ -597,6 +621,7 @@ var taxonomy = np("@riebeckite/plugin-taxonomy", "taxonomy", {
   feeds: { depth: 3, value: "{ rss: true, atom: true, json: true }" },
   relatedLimit: { depth: 3, value: "8" }
 });
+var folderPages = np("@riebeckite/plugin-folder-pages", "folderPagesPlugin");
 var autoCardLink = np(
   "@riebeckite/plugin-autocardlink",
   "autoCardLinkPlugin",
@@ -785,7 +810,7 @@ var quality = np(
 var deploy = np(
   "@riebeckite/plugin-deploy",
   "deployPlugin",
-  (context) => `{ provider: "cloudflare-pages", baseUrl: ${JSON.stringify(context.variables.baseUrl)} }`
+  `{ provider: "cloudflare-pages" }`
 );
 var diagnostics = np(
   "@riebeckite/plugin-diagnostics",
@@ -851,6 +876,8 @@ var starter = {
     codeEnhance,
     search,
     backlinks,
+    breadcrumbs,
+    navigationStarter,
     relatedPosts,
     recentPosts,
     responsiveImage,
@@ -878,6 +905,8 @@ var showcase = {
     codeEnhance,
     search,
     backlinks,
+    breadcrumbs,
+    navigationShowcase,
     relatedPosts,
     share,
     changelog,
@@ -894,6 +923,7 @@ var showcase = {
     shortcodes,
     series,
     taxonomy,
+    folderPages,
     autoCardLink,
     richEmbed,
     gallery,
@@ -1951,22 +1981,38 @@ async function findWorkspaceRoot(configRoot) {
   }
 }
 async function startHonoxDevServer(options) {
-  const server2 = await createServer2({ root: options.root });
-  await server2.listen();
-  server2.printUrls();
-  await waitForShutdown(server2);
+  const root = path7.resolve(options.root);
+  await withWorkingDirectory(root, async () => {
+    const server2 = await createServer2({ root });
+    await server2.listen();
+    server2.printUrls();
+    await waitForShutdown(server2);
+  });
 }
 async function buildHonoxApplication(options) {
-  await runTraced(
-    options.tracer,
-    "integration.honox.client_build",
-    () => build({ root: options.root, mode: "client" })
-  );
-  await runTraced(
-    options.tracer,
-    "integration.honox.server_build",
-    () => build({ root: options.root })
-  );
+  const root = path7.resolve(options.root);
+  await withWorkingDirectory(root, async () => {
+    await runTraced(
+      options.tracer,
+      "integration.honox.client_build",
+      () => build({ root, mode: "client" })
+    );
+    await runTraced(
+      options.tracer,
+      "integration.honox.server_build",
+      () => build({ root })
+    );
+  });
+}
+async function withWorkingDirectory(root, task) {
+  const previousDirectory = process.cwd();
+  if (previousDirectory === root) return await task();
+  process.chdir(root);
+  try {
+    return await task();
+  } finally {
+    process.chdir(previousDirectory);
+  }
 }
 async function runTraced(tracer, name, buildTask) {
   return tracer ? await tracer.span(name, {}, buildTask) : await buildTask();
@@ -2107,14 +2153,6 @@ function riebeckiteSsrExternals(externals) {
 function hasScaffoldPlugin(preset, packageName) {
   return preset.plugins.some((plugin) => plugin.package === packageName);
 }
-function articleTitleHelper() {
-  return `
-function getArticleTitle(slug: string, title: unknown): string {
-  if (typeof title === "string" && title.trim().length > 0) return title;
-  return slug.split("/").at(-1) ?? slug;
-}
-`;
-}
 function server() {
   return `import { mountRiebeckiteEndpoints } from "@riebeckite/honox/server";
 import { createApp } from "honox/server";
@@ -2224,6 +2262,12 @@ function style(preset) {
     imports.push('@import "./.riebeckite/theme-styles.css";');
   }
   const blocks = [
+    "",
+    "*,",
+    "*::before,",
+    "*::after {",
+    "  box-sizing: border-box;",
+    "}",
     "",
     "body {",
     "  margin: 0;",
@@ -2231,26 +2275,158 @@ function style(preset) {
     "}",
     ""
   ];
+  if (preset.appFiles.includes("header") || preset.appFiles.includes("article")) {
+    blocks.push(
+      ".riebeckite-page {",
+      "  display: flex;",
+      "  min-height: 100vh;",
+      "  width: 100%;",
+      "  flex-direction: column;",
+      "  align-items: center;",
+      "  padding-block: var(--rb-space-8, 4rem);",
+      "}",
+      ""
+    );
+  }
   if (preset.appFiles.includes("header")) {
     blocks.push(
       ".site-header {",
       "  display: flex;",
       "  align-items: center;",
-      "  justify-content: space-between;",
-      "  gap: 1rem;",
-      "  padding: 1rem;",
-      "  border-bottom: 1px solid #d1d5db;",
+      "  gap: var(--rb-space-3, 1.5rem);",
+      "  padding-block: var(--rb-space-3, 1.5rem);",
+      "  border-bottom: 1px solid var(--rb-color-border);",
+      "}",
+      "",
+      ".site-header,",
+      ".rb-site-footer {",
+      "  width: min(100% - 2rem, var(--rb-layout-article-max, 48rem));",
       "}",
       "",
       ".site-header__home {",
       "  display: inline-flex;",
       "  align-items: center;",
       "  gap: 0.5rem;",
-      "  color: #111827;",
+      "  margin-right: auto;",
+      "  color: var(--rb-color-ink);",
       "  font-weight: 700;",
       "  text-decoration: none;",
       "}",
       "",
+      ".rb-nav {",
+      "  color: var(--rb-color-ink);",
+      "}",
+      "",
+      ".rb-nav__list {",
+      "  display: flex;",
+      "  align-items: center;",
+      "  gap: var(--rb-space-3, 1.5rem);",
+      "  margin: 0;",
+      "  padding: 0;",
+      "  list-style: none;",
+      "}",
+      "",
+      ".rb-nav__item {",
+      "  position: relative;",
+      "}",
+      "",
+      ".rb-nav__link {",
+      "  color: inherit;",
+      "  text-decoration: none;",
+      "}",
+      "",
+      ".rb-nav__link:hover,",
+      ".rb-nav__link:focus-visible,",
+      ".rb-nav__link--active {",
+      "  color: var(--rb-color-accent);",
+      "}",
+      "",
+      ".rb-nav__link:focus-visible,",
+      ".rb-nav__toggle:focus-visible {",
+      "  outline: 2px solid var(--rb-color-accent);",
+      "  outline-offset: 2px;",
+      "}",
+      "",
+      ".rb-nav__children {",
+      "  display: none;",
+      "  position: absolute;",
+      "  top: 100%;",
+      "  left: 0;",
+      "  min-width: max-content;",
+      "  padding: var(--rb-space-2, 1rem);",
+      "  background: var(--rb-color-surface);",
+      "  border: 1px solid var(--rb-color-border);",
+      "}",
+      "",
+      ".rb-nav__item:hover > .rb-nav__children,",
+      ".rb-nav__item:focus-within > .rb-nav__children {",
+      "  display: flex;",
+      "  flex-direction: column;",
+      "  align-items: stretch;",
+      "}",
+      "",
+      ".rb-nav__mobile {",
+      "  display: none;",
+      "}",
+      "",
+      ".rb-site-footer {",
+      "  margin-top: 1rem;",
+      "  padding-block: var(--rb-space-4, 2rem);",
+      "  border-top: 1px solid var(--rb-color-border);",
+      "}",
+      "",
+      "@media (max-width: 48rem) {",
+      "  .riebeckite-page {",
+      "    padding-block: var(--rb-space-3, 1.5rem);",
+      "  }",
+      "",
+      "  .rb-site-header {",
+      "    flex-wrap: wrap;",
+      "  }",
+      "",
+      "  .rb-site-header > .rb-nav {",
+      "    display: none;",
+      "  }",
+      "",
+      "  .rb-nav__mobile {",
+      "    position: relative;",
+      "    display: block;",
+      "  }",
+      "",
+      "  .rb-nav__mobile > .rb-nav {",
+      "    position: absolute;",
+      "    z-index: 10;",
+      "    top: calc(100% + var(--rb-space-2, 1rem));",
+      "    right: 0;",
+      "    min-width: 12rem;",
+      "    padding: var(--rb-space-3, 1.5rem);",
+      "    background: var(--rb-color-surface);",
+      "    border: 1px solid var(--rb-color-border);",
+      "    box-shadow: 0 4px 12px",
+      "      color-mix(in oklab, var(--rb-color-ink) 14%, transparent);",
+      "  }",
+      "",
+      "  .rb-nav__mobile .rb-nav__list,",
+      "  .rb-nav__mobile .rb-nav__children {",
+      "    display: flex;",
+      "    flex-direction: column;",
+      "    align-items: flex-start;",
+      "    gap: var(--rb-space-2, 1rem);",
+      "  }",
+      "",
+      "  .rb-nav__mobile .rb-nav__list {",
+      "    padding: 0;",
+      "  }",
+      "",
+      "  .rb-nav__mobile .rb-nav__children {",
+      "    position: static;",
+      "    margin-top: var(--rb-space-2, 1rem);",
+      "    padding: 0;",
+      "    background: transparent;",
+      "    border: 0;",
+      "  }",
+      "}",
+      "",
       ".site-header__logo {",
       "  width: 1.75rem;",
       "  height: 1.75rem;",
@@ -2263,18 +2439,23 @@ function style(preset) {
     blocks.push(
       ".site-article {",
       "  display: block;",
-      "  max-width: 48rem;",
-      "  padding: 2rem 1rem;",
+      "  width: min(100% - 2rem, var(--rb-layout-article-max, 48rem));",
+      "  padding-block: 2rem;",
       "  margin: 0 auto;",
       "}",
       "",
-      ".article-shell__layout {",
+      ".rb-article-layout {",
       "  display: grid;",
-      "  grid-template-columns: minmax(0, 1fr);",
+      "  grid-template-columns: minmax(0, var(--rb-layout-article-max, 48rem));",
       "  justify-content: center;",
       "  gap: var(--rb-layout-gap, 2rem);",
       "}",
       "",
+      ".rb-article-body {",
+      "  min-width: 0;",
+      "  padding-inline: var(--rb-space-2, 1rem);",
+      "}",
+      "",
       ".site-article__aside {",
       "  display: none;",
       "}",
@@ -2284,12 +2465,12 @@ function style(preset) {
       "}",
       "",
       "@media (min-width: 88rem) {",
-      '  :is(:root, .rb-theme-root)[data-article-layout="article"] .article-shell__layout {',
+      '  :is(:root, .rb-theme-root)[data-article-layout="article"] .rb-article-layout {',
       "    grid-template-columns: minmax(0, var(--rb-layout-article-max, 48rem));",
       "    position: relative;",
       "  }",
       "",
-      '  :is(:root, .rb-theme-root)[data-article-layout="article"] .article-shell__body {',
+      '  :is(:root, .rb-theme-root)[data-article-layout="article"] .rb-article-body {',
       "    grid-column: 1;",
       "    grid-row: 1;",
       "  }",
@@ -2333,13 +2514,22 @@ function style(preset) {
   return [...imports, ...blocks].join("\n");
 }
 function siteHeader() {
-  return `import { ColorModeToggle } from "@riebeckite/plugin-color-mode";
+  return `import type { NavigationItem } from "@riebeckite/plugin-navigation";
+import { ColorModeToggle } from "@riebeckite/plugin-color-mode";
 import { config } from "../config";
 
-export function SiteHeader() {
+export function SiteHeader({
+  path,
+  items,
+}: {
+  path: string;
+  items: readonly NavigationItem[];
+}) {
+  const navigation = items.filter((item) => item.href !== "/");
+
   return (
-    <header class="site-header">
-      <a href="/" class="site-header__home">
+    <header class="site-header rb-site-header">
+      <a href="/" class="site-header__home rb-site-header__home">
         <img
           src="/riebeckite-logo.png"
           alt=""
@@ -2349,10 +2539,94 @@ export function SiteHeader() {
         />
         {config.site.title}
       </a>
+      {navigation.length > 0 ? (
+        <>
+          <SiteNavigation items={navigation} path={path} />
+          <details class="site-navigation__mobile rb-nav__mobile">
+            <summary class="rb-nav__toggle">Menu</summary>
+            <SiteNavigation items={navigation} path={path} />
+          </details>
+        </>
+      ) : null}
       <ColorModeToggle />
     </header>
   );
 }
+
+export function SiteFooter({
+  path,
+  items,
+}: {
+  path: string;
+  items: readonly NavigationItem[];
+}) {
+  if (items.length === 0) return null;
+
+  return (
+    <footer class="site-footer rb-site-footer">
+      <SiteNavigation items={items} path={path} />
+    </footer>
+  );
+}
+
+function SiteNavigation({
+  items,
+  path,
+}: {
+  items: readonly NavigationItem[];
+  path: string;
+}) {
+  return (
+    <nav class="site-navigation rb-nav" aria-label="Site navigation">
+      <NavigationItems items={items} path={path} />
+    </nav>
+  );
+}
+
+function NavigationItems({
+  items,
+  path,
+  isChildList = false,
+}: {
+  items: readonly NavigationItem[];
+  path: string;
+  isChildList?: boolean;
+}) {
+  return (
+    <ul class={isChildList ? "site-navigation__list rb-nav__list rb-nav__children" : "site-navigation__list rb-nav__list"}>
+      {items.map((item) => {
+        const active = item.href ? isActive(item.href, path) : false;
+        return (
+          <li class="site-navigation__item rb-nav__item">
+            {item.href ? (
+              <a
+                href={item.href}
+                class={active ? "site-navigation__link rb-nav__link rb-nav__link--active is-active" : "site-navigation__link rb-nav__link"}
+                aria-current={active ? "page" : undefined}
+                target={item.external ? "_blank" : undefined}
+                rel={item.external ? "noreferrer" : undefined}
+              >
+                {item.label}
+              </a>
+            ) : (
+              <span class="site-navigation__label rb-nav__label">{item.label}</span>
+            )}
+            {item.children && item.children.length > 0 ? (
+              <NavigationItems items={item.children} path={path} isChildList />
+            ) : null}
+          </li>
+        );
+      })}
+    </ul>
+  );
+}
+
+function isActive(href: string, path: string): boolean {
+  if (!href.startsWith("/")) return false;
+  const target = href.replace(/\\/+$/, "") || "/";
+  const current = path.replace(/^\\/[a-z]{2}(?:-[A-Z]{2})?(?=\\/|$)/, "").replace(/\\/+$/, "") || "/";
+  return target === "/" ? current === target : current === target || current.startsWith(\`\${target}/\`);
+}
 `;
 }
 function article() {
@@ -2361,25 +2635,13 @@ import { Article, ArticleContent, ArticleLayout } from "@riebeckite/honox/ui";
 
 export function SiteArticle({
   post,
-  propertiesHtml,
-  afterHeaderHtml,
-  afterMetaHtml,
-  beforeContentHtml,
-  afterContentHtml,
-  asideHtml,
-  footerHtml,
+  bodySlots,
   asideContent,
   afterContent,
   footerContent,
 }: {
   post: PostContent;
-  propertiesHtml?: string;
-  afterHeaderHtml?: string;
-  afterMetaHtml?: string;
-  beforeContentHtml?: string;
-  afterContentHtml?: string;
-  asideHtml?: string;
-  footerHtml?: string;
+  bodySlots?: Readonly<Record<string, string>>;
   asideContent?: unknown;
   afterContent?: unknown;
   footerContent?: unknown;
@@ -2388,50 +2650,44 @@ export function SiteArticle({
     <Article class="site-article">
       <ArticleLayout>
         {asideContent}
-        {asideHtml ? (
+        {bodySlots?.["article.aside"] ? (
           <div
             class="site-article__aside"
-            dangerouslySetInnerHTML={{ __html: asideHtml }}
+            dangerouslySetInnerHTML={{ __html: bodySlots["article.aside"] }}
           />
         ) : null}
         <ArticleContent>
-          {afterHeaderHtml ? (
-            <div
-              class="site-article__after-header"
-              dangerouslySetInnerHTML={{ __html: afterHeaderHtml }}
-            />
-          ) : null}
-          {propertiesHtml ? (
+          {bodySlots?.["article.header"] ? (
             <div
-              class="article-properties"
-              dangerouslySetInnerHTML={{ __html: propertiesHtml }}
+              class="site-article__header"
+              dangerouslySetInnerHTML={{ __html: bodySlots["article.header"] }}
             />
           ) : null}
-          {afterMetaHtml ? (
+          {bodySlots?.["article.metadata"] ? (
             <div
-              class="site-article__after-meta"
-              dangerouslySetInnerHTML={{ __html: afterMetaHtml }}
+              class="site-article__metadata"
+              dangerouslySetInnerHTML={{ __html: bodySlots["article.metadata"] }}
             />
           ) : null}
-          {beforeContentHtml ? (
+          {bodySlots?.["article.before-content"] ? (
             <div
               class="site-article__before-content"
-              dangerouslySetInnerHTML={{ __html: beforeContentHtml }}
+              dangerouslySetInnerHTML={{ __html: bodySlots["article.before-content"] }}
             />
           ) : null}
           <div dangerouslySetInnerHTML={{ __html: post.html ?? "" }} />
           {afterContent}
-          {afterContentHtml ? (
+          {bodySlots?.["article.after-content"] ? (
             <div
               class="site-article__after-content"
-              dangerouslySetInnerHTML={{ __html: afterContentHtml }}
+              dangerouslySetInnerHTML={{ __html: bodySlots["article.after-content"] }}
             />
           ) : null}
         </ArticleContent>
-        {footerHtml || footerContent ? (
+        {bodySlots?.["article.footer"] || footerContent ? (
           <div class="site-article__footer">
-            {footerHtml ? (
-              <div dangerouslySetInnerHTML={{ __html: footerHtml }} />
+            {bodySlots?.["article.footer"] ? (
+              <div dangerouslySetInnerHTML={{ __html: bodySlots["article.footer"] }} />
             ) : null}
             {footerContent}
           </div>
@@ -2454,7 +2710,9 @@ import { jsxRenderer } from "hono/jsx-renderer";
 import { Link, Script } from "honox/server";
 ${hasColorMode ? `import { ColorModeScript } from "@riebeckite/plugin-color-mode";
 ` : ""}${hasSearch ? `import { SearchBar } from "@riebeckite/plugin-search";
-` : ""}${hasHeader ? `import { SiteHeader } from "../components/site-header";
+` : ""}${hasHeader ? `import { resolveSiteNavigation } from "@riebeckite/plugin-navigation";
+` : ""}${hasHeader ? `import { SiteFooter, SiteHeader } from "../components/site-header";
+` : ""}${hasHeader ? `import { content } from "../content";
 ` : ""}import { config } from "../config";
 
 function themeAttributes() {
@@ -2473,9 +2731,10 @@ function themeAttributes() {
 // an island component.
 export const __importing_islands = true;
 
-export default jsxRenderer(({ children }, c) => {
+export default jsxRenderer(async ({ children }, c) => {
   const headTags: readonly PluginHeadTag[] = c.get("headTags") ?? [];
-
+${hasHeader ? `  const navigation = resolveSiteNavigation(config, await content.getManifest(), c.get("htmlLanguage")) ?? { primary: [], secondary: [] };
+` : ""}
   return (
     <html
       lang={c.get("htmlLanguage") ?? config.site.locale}
@@ -2491,11 +2750,12 @@ ${hasColorMode ? `        <ColorModeScript />
         {headTags.map(renderHeadTag)}
         <Script src="/app/client.ts" async />
       </head>
-      <body class="riebeckite-page">
-${hasHeader ? `        <SiteHeader />
+      <body class="riebeckite-page rb-site">
+ ${hasHeader ? `        <SiteHeader path={c.req.path} items={navigation.primary} />
 ` : ""}${hasSearch ? `        <SearchBar />
 ` : ""}        {children}
-      </body>
+${hasHeader ? `        <SiteFooter path={c.req.path} items={navigation.secondary} />
+` : ""}      </body>
     </html>
   );
 });
@@ -2535,7 +2795,7 @@ export default jsxRenderer(({ children }, c) => (
       <Link href="/app/style.css" rel="stylesheet" />
       <Script src="/app/client.ts" async />
     </head>
-    <body class="riebeckite-page">{children}</body>
+    <body class="riebeckite-page rb-site">{children}</body>
   </html>
 ));
 `;
@@ -2543,10 +2803,6 @@ export default jsxRenderer(({ children }, c) => (
 function indexRoute(preset) {
   if (!preset.appFiles.includes("article")) return staticIndexRoute();
   const hasToc = hasScaffoldPlugin(preset, "@riebeckite/plugin-toc");
-  const hasBacklinks = hasScaffoldPlugin(
-    preset,
-    "@riebeckite/plugin-backlinks"
-  );
   const hasRecentPosts = hasScaffoldPlugin(
     preset,
     "@riebeckite/plugin-recent-posts"
@@ -2555,16 +2811,11 @@ function indexRoute(preset) {
     preset,
     "@riebeckite/plugin-daily-notes"
   );
-  const needsTitle = hasBacklinks || hasRecentPosts;
-  const needsConfig = hasBacklinks || hasRecentPosts || hasDailyNotes;
+  const needsConfig = hasRecentPosts || hasDailyNotes;
   const importLines = [
+    'import { getEntryLanguage } from "@riebeckite/core";',
     'import { createRoute } from "honox/factory";'
   ];
-  if (hasBacklinks) {
-    importLines.push(
-      'import { Backlinks, getPublishedBacklinks } from "@riebeckite/plugin-backlinks";'
-    );
-  }
   if (hasDailyNotes) {
     importLines.push(
       'import { DailyNotes, getDailyNotes } from "@riebeckite/plugin-daily-notes";'
@@ -2584,14 +2835,9 @@ function indexRoute(preset) {
   if (needsConfig) importLines.push('import { config } from "../config";');
   importLines.push('import { content } from "../content";');
   const dataLines = [];
-  if (hasBacklinks) {
-    dataLines.push(
-      '  const backlinks = getPublishedBacklinks({ manifest, config, slug: "index", resolveTitle: getArticleTitle });'
-    );
-  }
   if (hasRecentPosts) {
     dataLines.push(
-      "  const recentPosts = await getRecentPosts({ posts: manifest.discoverableEntries, config, getProcessedContent: (slug) => content.getProcessedContent(slug), resolveTitle: getArticleTitle });"
+      '  const recentPosts = await getRecentPosts({ posts: manifest.discoverableEntries, config, getProcessedContent: (slug) => content.getProcessedContent(slug), resolveTitle: (slug, title) => typeof title === "string" && title.trim() ? title : slug.split("/").at(-1) ?? slug });'
     );
   }
   if (hasDailyNotes) {
@@ -2602,15 +2848,7 @@ function indexRoute(preset) {
       '  const tableOfContents = extractTableOfContents(post.html ?? "");'
     );
   }
-  const propLines = [
-    "        propertiesHtml={indexEntry?.bodySlots?.properties}",
-    '        afterHeaderHtml={indexEntry?.bodySlots?.["article.after-header"]}',
-    '        afterMetaHtml={indexEntry?.bodySlots?.["article.after-meta"]}',
-    '        beforeContentHtml={indexEntry?.bodySlots?.["article.before-content"]}',
-    '        afterContentHtml={indexEntry?.bodySlots?.["article.after-content"]}',
-    '        asideHtml={indexEntry?.bodySlots?.["article.aside"]}',
-    '        footerHtml={indexEntry?.bodySlots?.["article.footer"]}'
-  ];
+  const propLines = ["        bodySlots={indexEntry?.bodySlots}"];
   if (hasToc) {
     propLines.push(
       '        asideContent={<TableOfContents className="table-of-contents--desktop" items={tableOfContents} />}'
@@ -2622,12 +2860,6 @@ function indexRoute(preset) {
   if (afterChildren.length > 0) {
     propLines.push(`        afterContent={<>${afterChildren.join("")}</>}`);
   }
-  if (hasBacklinks) {
-    propLines.push(
-      "        footerContent={<Backlinks backlinks={backlinks} />}"
-    );
-  }
-  const titleHelper = needsTitle ? articleTitleHelper() : "";
   const dataBlock = dataLines.length > 0 ? `
 ${dataLines.join("\n")}
 ` : "";
@@ -2646,7 +2878,7 @@ export default createRoute(async (c) => {
   }
 ${dataBlock}
   if (indexEntry) {
-    c.set("htmlLanguage", indexEntry.publicLocation.metadata?.["l10n.lang"]);
+    c.set("htmlLanguage", getEntryLanguage(indexEntry));
     c.set("headTags", indexEntry.headTags ?? []);
   }
 
@@ -2656,7 +2888,7 @@ ${dataBlock}
 ${propLines.join("\n")}
     />,
   );
-});${titleHelper}`;
+});`;
 }
 function staticIndexRoute() {
   return `import { createRoute } from "honox/factory";
@@ -2674,34 +2906,14 @@ export default createRoute((c) =>
 }
 function slugRoute(preset) {
   const hasToc = hasScaffoldPlugin(preset, "@riebeckite/plugin-toc");
-  const hasBacklinks = hasScaffoldPlugin(
-    preset,
-    "@riebeckite/plugin-backlinks"
-  );
-  const hasLocalGraph = hasScaffoldPlugin(
-    preset,
-    "@riebeckite/plugin-local-graph"
-  );
-  const needsTitle = hasBacklinks || hasLocalGraph;
-  const needsConfig = hasBacklinks || hasLocalGraph;
-  const needsManifest = hasBacklinks || hasLocalGraph;
   const importLines = [
+    'import { getEntryLanguage } from "@riebeckite/core";',
     "import {",
     "  contentRouteSsgParams,",
     "  pluginPageSsgParams,",
     "  resolveRiebeckiteRoute,",
     '} from "@riebeckite/honox/server";'
   ];
-  if (hasBacklinks) {
-    importLines.push(
-      'import { Backlinks, getPublishedBacklinks } from "@riebeckite/plugin-backlinks";'
-    );
-  }
-  if (hasLocalGraph) {
-    importLines.push(
-      'import { LocalGraph, getLocalGraph } from "@riebeckite/plugin-local-graph";'
-    );
-  }
   if (hasToc) {
     importLines.push(
       'import { extractTableOfContents, TableOfContents } from "@riebeckite/plugin-toc";'
@@ -2709,52 +2921,19 @@ function slugRoute(preset) {
   }
   importLines.push('import { createRoute } from "honox/factory";');
   importLines.push('import { SiteArticle } from "../components/article";');
-  if (needsConfig) importLines.push('import { config } from "../config";');
   importLines.push('import { content } from "../content";');
   const dataLines = [];
-  if (needsManifest) {
-    dataLines.push("    const manifest = await content.getManifest();");
-  }
-  if (hasBacklinks) {
-    dataLines.push(
-      "    const backlinks = getPublishedBacklinks({ manifest, config, slug: route.entry.slug, resolveTitle: getArticleTitle });"
-    );
-  }
-  if (hasLocalGraph) {
-    dataLines.push(
-      "    const localGraph = getLocalGraph({ manifest, config, slug: route.entry.slug, resolveTitle: getArticleTitle });"
-    );
-  }
   if (hasToc) {
     dataLines.push(
       '    const tableOfContents = extractTableOfContents(post.html ?? "");'
     );
   }
-  const propLines = [
-    "        propertiesHtml={route.entry.bodySlots?.properties}",
-    '        afterHeaderHtml={route.entry.bodySlots?.["article.after-header"]}',
-    '        afterMetaHtml={route.entry.bodySlots?.["article.after-meta"]}',
-    '        beforeContentHtml={route.entry.bodySlots?.["article.before-content"]}',
-    '        afterContentHtml={route.entry.bodySlots?.["article.after-content"]}',
-    '        asideHtml={route.entry.bodySlots?.["article.aside"]}',
-    '        footerHtml={route.entry.bodySlots?.["article.footer"]}'
-  ];
+  const propLines = ["        bodySlots={route.entry.bodySlots}"];
   if (hasToc) {
     propLines.push(
       '        asideContent={<TableOfContents className="table-of-contents--desktop" items={tableOfContents} />}'
     );
   }
-  const footerChildren = [];
-  if (hasLocalGraph) {
-    footerChildren.push("{localGraph && <LocalGraph graph={localGraph} />}");
-  }
-  if (hasBacklinks) {
-    footerChildren.push("<Backlinks backlinks={backlinks} />");
-  }
-  if (footerChildren.length > 0) {
-    propLines.push(`        footerContent={<>${footerChildren.join("")}</>}`);
-  }
-  const titleHelper = needsTitle ? articleTitleHelper() : "";
   const dataBlock = dataLines.length > 0 ? `
 ${dataLines.join("\n")}
 ` : "";
@@ -2779,6 +2958,7 @@ export default createRoute(
       return c.redirect(route.location, route.status);
     if (route.kind === "page") {
       c.set("headTags", route.page.headTags ?? []);
+      c.set("htmlLanguage", route.page.language);
       return c.render(
         <div dangerouslySetInnerHTML={{ __html: route.page.body }} />,
       );
@@ -2786,7 +2966,7 @@ export default createRoute(
 
     const post = await content.getProcessedContent(route.entry.slug);
 ${dataBlock}
-    c.set("htmlLanguage", route.entry.publicLocation.metadata?.["l10n.lang"]);
+    c.set("htmlLanguage", getEntryLanguage(route.entry));
     c.set("headTags", route.entry.headTags ?? []);
 
     return c.render(
@@ -2796,7 +2976,7 @@ ${propLines.join("\n")}
       />,
     );
   },
-);${titleHelper}`;
+);`;
 }
 
 // src/scaffold/localized-content.ts
@@ -2850,7 +3030,7 @@ var PLUGIN_MARKDOWN_GUIDES = {
     ].join("\n")
   },
   "@riebeckite/plugin-properties": {
-    summary: 'Renders selected frontmatter properties near the article when configured with `render: "slot"`.',
+    summary: "Renders selected frontmatter properties in the article metadata slot.",
     markdown: [
       "---",
       "created: 2026-09-30",
@@ -4538,12 +4718,12 @@ function referenceThemesContent(preset) {
 }
 
 // src/scaffold/version.ts
-var RIEBECKITE_VERSION = "^0.0.15";
+var RIEBECKITE_VERSION = "^0.0.17";
 
 // src/scaffold/templates.ts
-function siteTemplateFiles(preset, variables) {
+function siteTemplateFiles(preset, variables, options = {}) {
   return [
-    { path: "package.json", content: packageJson(preset, variables) },
+    { path: "package.json", content: packageJson(preset, variables, options) },
     {
       path: "riebeckite.config.ts",
       content: riebeckiteConfig(preset, variables)
@@ -4624,7 +4804,7 @@ function appFiles(preset) {
     ...has("article") ? [{ path: "app/components/article.tsx", content: get("article") }] : []
   ];
 }
-function packageJson(preset, variables) {
+function packageJson(preset, variables, options) {
   const dependencies = {
     "@riebeckite/core": RIEBECKITE_VERSION,
     "@riebeckite/honox": RIEBECKITE_VERSION,
@@ -4656,7 +4836,8 @@ function packageJson(preset, variables) {
         "@riebeckite/cli": RIEBECKITE_VERSION,
         "@types/node": "^24.5.2",
         typescript: "^5.0.0",
-        vite: "^8.0.9"
+        vite: "^8.0.9",
+        ...options.cloudflareWorkers ? { wrangler: WRANGLER_VERSION } : {}
       }
     },
     null,
@@ -4682,6 +4863,7 @@ function riebeckiteConfig(preset, variables) {
   lines.push(`    description: ${JSON.stringify(description)},`);
   lines.push(`    baseUrl: ${JSON.stringify(baseUrl)},`);
   lines.push(`    locale: ${JSON.stringify(locale)},`);
+  lines.push('    defaultOgImage: "/ogp.png",');
   lines.push("  },");
   lines.push("  content: {");
   lines.push('    directory: "content",');
@@ -4917,6 +5099,19 @@ function readmeEn(preset, variables) {
     "```",
     ""
   );
+  if (preset.name !== "empty") {
+    lines.push(
+      "## First edits",
+      "",
+      "- `content/index.md`: the first published page.",
+      "- `riebeckite.config.ts`: set `site.title`, `site.baseUrl`, and `content.directory`.",
+      "- `public/favicon.ico`: replace the site icon when you are ready.",
+      ""
+    );
+  }
+  if (variables.externalContent === true) {
+    lines.push(...deploymentSecretLines("en"));
+  }
   if (preset.readme === "rich") {
     lines.push(...demoPagesLines(preset, variables, words, "en"));
     lines.push(...copyPasteDemoLines(preset, words, "en"));
@@ -4965,6 +5160,19 @@ function readmeJa(preset, variables) {
     "```",
     ""
   );
+  if (preset.name !== "empty") {
+    lines.push(
+      "## 最初に編集する場所",
+      "",
+      "- `content/index.md`: 最初に公開されるページです。",
+      "- `riebeckite.config.ts`: `site.title`、`site.baseUrl`、`content.directory` を設定します。",
+      "- `public/favicon.ico`: 必要になったらサイトアイコンを置き換えます。",
+      ""
+    );
+  }
+  if (variables.externalContent === true) {
+    lines.push(...deploymentSecretLines("ja"));
+  }
   if (preset.readme === "rich") {
     lines.push(...demoPagesLines(preset, variables, words, "ja"));
     lines.push(...copyPasteDemoLines(preset, words, "ja"));
@@ -4980,6 +5188,34 @@ function readmeJa(preset, variables) {
   }
   return lines.join("\n");
 }
+function deploymentSecretLines(language) {
+  if (language === "ja") {
+    return [
+      "## デプロイ用 Secret",
+      "",
+      "GitHub Actions のデプロイは content repository を読み、Cloudflare へ配信します。初回実行の前に、次の repository secret を登録してください。",
+      "",
+      "- `RIEBECKITE_CONTENT_READ_TOKEN` — **この Site Repository** に登録します。content repository が private / internal のときだけ必要です。content repository に限定した fine-grained token を作成し、**Contents: read** を付与します。",
+      "- `SITE_DISPATCH_TOKEN` — **content repository** に登録します。content repository の `notify-site.yml` からこの Site へ更新を通知するために使います。この Site Repository に限定した fine-grained token を作成し、**Contents: read and write** を付与します。",
+      "- `CLOUDFLARE_API_TOKEN` と `CLOUDFLARE_ACCOUNT_ID` — **この Site Repository** に登録し、Cloudflare へのデプロイに使います。",
+      "",
+      `workflow はこれらの secret 名を参照するだけで、値は含みません。値は絶対に commit しないでください。全体の手順は [別 Content Repository のガイド](${REPO}/blob/main/docs/ja/docs/guides/deployment/separate-content-repository.md) を参照してください。`,
+      ""
+    ];
+  }
+  return [
+    "## Deployment secrets",
+    "",
+    "The GitHub Actions deployment reads the content repository and deploys to Cloudflare. Add these repository secrets before the first run:",
+    "",
+    "- `RIEBECKITE_CONTENT_READ_TOKEN` — in **this site repository**. Required only when the content repository is private or internal. Use a fine-grained token scoped to the content repository with **Contents: read**.",
+    "- `SITE_DISPATCH_TOKEN` — in the **content repository**. Lets its `notify-site.yml` dispatch updates to this site. Use a fine-grained token scoped to this site repository with **Contents: read and write**.",
+    "- `CLOUDFLARE_API_TOKEN` and `CLOUDFLARE_ACCOUNT_ID` — in **this site repository** for the Cloudflare deploy.",
+    "",
+    `The workflows reference these secret names and never contain their values. Never commit the values. See the [separate content repository guide](${REPO}/blob/main/docs/en/docs/guides/deployment/separate-content-repository.md) for the full setup.`,
+    ""
+  ];
+}
 function languagesLabel(preset, words) {
   if (preset.languages.length === 0) return words.none;
   if (preset.languages.length === 1)
@@ -5432,8 +5668,14 @@ async function scaffoldRiebeckiteSite(options) {
   const preset = resolveScaffoldPreset(options.preset);
   validateDeploymentOptions(options);
   const files = [
-    ...siteTemplateFiles(preset, templateVariables(options, targetDirectory)),
-    ...options.githubActions ? deploymentTemplateFiles(deploymentOptions(options)) : []
+    ...siteTemplateFiles(preset, templateVariables(options, targetDirectory), {
+      cloudflareWorkers: options.cloudflareWorkers
+    }),
+    ...options.githubActions ? deploymentTemplateFiles(deploymentOptions(options)) : options.cloudflareWorkers ? [
+      wranglerJsoncFile(
+        workerNameFromDirectory(path9.basename(targetDirectory))
+      )
+    ] : []
   ];
   await assertTargetWritable(
     targetDirectory,
@@ -5486,7 +5728,8 @@ function templateVariables(options, targetDirectory) {
     title: options.siteTitle ?? name,
     description: options.description ?? "",
     baseUrl: options.baseUrl ?? "",
-    locale: options.locale ?? "en"
+    locale: options.locale ?? "en",
+    externalContent: options.contentRepository !== void 0
   };
 }
 async function assertTargetWritable(targetDirectory, files, overwrite) {
@@ -5530,23 +5773,51 @@ function formatScaffoldNextSteps(relativeDirectory, options = {}) {
     lines.push("");
     lines.push("Then edit:");
     lines.push(`  ${options.editFile}`);
+    lines.push("");
+    lines.push("Common first settings:");
+    lines.push(
+      "  riebeckite.config.ts: site.title, site.baseUrl, content.directory"
+    );
   }
   if (options.externalContent === true) {
     lines.push("");
+    lines.push(
+      "Operational content lives in the content repository. CI checks it out to content/."
+    );
     lines.push(
       "Copy github/notify-site.yml to the content repository as .github/workflows/notify-site.yml."
     );
+    lines.push("");
+    lines.push("Required GitHub Actions repository secrets:");
+    lines.push(
+      "  RIEBECKITE_CONTENT_READ_TOKEN: site repository; only when the content repository is private or internal (Contents: read)"
+    );
+    lines.push(
+      "  SITE_DISPATCH_TOKEN: content repository (fine-grained token for the site repository, Contents: read and write)"
+    );
+    lines.push(
+      "  CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID: site repository"
+    );
   }
   return lines.join("\n");
 }
 export {
+  DEFAULT_WORKER_NAME,
+  GITHUB_ACTIONS_SECRETS,
+  PACKAGE_MANAGER,
   SCAFFOLD_DEFAULT_PRESET,
   SCAFFOLD_PRESET_NAMES,
   ScaffoldSiteError,
+  WORKER_NAME_MAX_LENGTH,
+  WRANGLER_DEFAULTS,
+  WRANGLER_VERSION,
+  assertGitHubRepository,
+  buildDefaultWranglerConfig,
   buildHonoxApplication,
   createRiebeckiteSsg,
   defaultSsgEntry,
   defaultSsrExternals,
+  deploymentTemplateFiles,
   empty,
   formatScaffoldNextSteps,
   isScaffoldPresetName,
@@ -5565,5 +5836,6 @@ export {
   scaffoldRiebeckiteSite,
   showcase,
   startHonoxDevServer,
-  starter
+  starter,
+  workerNameFromDirectory
 };

package/dist/server.js

@@ -17,6 +17,7 @@ async function riebeckiteSsgParams(content, parameter = "slug") {
   if (changeSet.fullRegenerationRequired || process.env.RIEBECKITE_SSG_FULL_REGENERATION === "1") {
     return [
       ...manifest.publicEntries.filter((entry) => entry.permalink !== "/").map((entry) => ({ [parameter]: entry.permalink.replace(/^\/+/, "") })),
+      ...[...manifest.publicRedirects.keys()].filter((path) => path !== "/").map((path) => ({ [parameter]: path.replace(/^\/+/, "") })),
       ...await pluginPageSsgParams(content, parameter)
     ];
   }
@@ -24,16 +25,19 @@ async function riebeckiteSsgParams(content, parameter = "slug") {
     changeSet.affected.filter((output) => output.kind !== "generated").map((output) => output.path)
   );
   const contentParams = manifest.publicEntries.filter((entry) => affected.has(routeOutputPath(entry.permalink))).map((entry) => ({ [parameter]: entry.permalink.replace(/^\/+/, "") }));
+  const redirectParams = [...manifest.publicRedirects.keys()].filter((path) => affected.has(routeOutputPath(path))).filter((path) => path !== "/").map((path) => ({ [parameter]: path.replace(/^\/+/, "") }));
   const pluginPageParams = (await content.getPagePaths()).filter((path) => affected.has(routeOutputPath(path))).filter((path) => path !== "/").map((path) => ({ [parameter]: path.replace(/^\/+/, "") }));
-  return [...contentParams, ...pluginPageParams];
+  return [...contentParams, ...redirectParams, ...pluginPageParams];
 }
 function resolveContentRoute(manifest, pathname) {
   const path = normalizeRequestPath(pathname);
   const entry = manifest.byRoutablePermalink.get(path);
   if (entry) return { kind: "content", entry };
-  const redirect = manifest.redirects.get(path);
+  const redirect = manifest.publicRedirects.get(path);
   if (!redirect) return null;
-  const target = manifest.bySlug.get(redirect.slug);
+  const target = manifest.byRoutablePermalink.get(
+    manifest.bySlug.get(redirect.slug)?.permalink ?? ""
+  );
   if (!target) return null;
   return {
     kind: "redirect",

package/dist/src/scaffold/deployment.d.ts

@@ -5,3 +5,4 @@ export type ScaffoldDeploymentOptions = {
 };
 export declare function assertGitHubRepository(value: string, option: string): void;
 export declare function deploymentTemplateFiles(options: ScaffoldDeploymentOptions): readonly SiteTemplateFile[];
+export declare function wranglerJsoncFile(workerName: string): SiteTemplateFile;

package/dist/src/scaffold/index.d.ts

@@ -10,6 +10,7 @@ export type ScaffoldSiteOptions = {
     readonly overwrite?: boolean;
     /** Generate the Cloudflare Workers GitHub Actions workflow. */
     readonly githubActions?: boolean;
+    readonly cloudflareWorkers?: boolean;
     /** Read content from this separate GitHub repository during deployment. */
     readonly contentRepository?: string;
     /** Site repository to notify from the generated content workflow. */

package/dist/src/scaffold/presets.js

@@ -42,13 +42,8 @@ var l10n = np("@riebeckite/plugin-l10n", "l10n", (context) => {
   return `{ defaultLang: ${JSON.stringify(defaultLang)}, languages: ${JSON.stringify(context.languages)} }`;
 });
 var seo = np("@riebeckite/plugin-seo", "seo", {
-  siteName: {
-    depth: 1,
-    value: (context) => JSON.stringify(context.variables.title)
-  },
   sitemap: { depth: 1, value: "true" },
   robots: { depth: 2, value: "true" },
-  defaultImage: { depth: 3, value: '"/ogp.png"' },
   feed: { depth: 3, value: "{ rss: true, atom: true, json: true }" }
 });
 var toc = np("@riebeckite/plugin-toc", "tocPlugin");
@@ -69,6 +64,17 @@ var codeEnhance = np("@riebeckite/plugin-code-enhance", "codeEnhance", {
 });
 var search = np("@riebeckite/plugin-search", "searchPlugin");
 var backlinks = np("@riebeckite/plugin-backlinks", "backlinksPlugin");
+var breadcrumbs = np("@riebeckite/plugin-breadcrumbs", "breadcrumbsPlugin");
+var navigationStarter = np(
+  "@riebeckite/plugin-navigation",
+  "navigation",
+  `{ items: [{ label: "Guide", href: "/guide" }, { label: "Examples", href: "/examples" }, { label: "Notes", href: "/notes/planning", children: [{ label: "Planning", href: "/notes/planning" }, { label: "Writing", href: "/notes/writing" }] }], secondary: [{ label: "Guide", href: "/guide" }, { label: "Examples", href: "/examples" }] }`
+);
+var navigationShowcase = np(
+  "@riebeckite/plugin-navigation",
+  "navigation",
+  `{ items: [{ label: "Guide", href: "/guide" }, { label: "Examples", href: "/examples" }, { label: "Framework", href: "/framework/plugins", children: [{ label: "Plugins", href: "/framework/plugins" }, { label: "Themes", href: "/framework/themes" }] }], secondary: [{ label: "Guide", href: "/guide" }, { label: "Examples", href: "/examples" }] }`
+);
 var relatedPosts = np("@riebeckite/plugin-related-posts", "relatedPosts", {
   limit: { depth: 2, value: "5" },
   useTags: { depth: 2, value: "true" },
@@ -167,6 +173,7 @@ var taxonomy = np("@riebeckite/plugin-taxonomy", "taxonomy", {
   feeds: { depth: 3, value: "{ rss: true, atom: true, json: true }" },
   relatedLimit: { depth: 3, value: "8" }
 });
+var folderPages = np("@riebeckite/plugin-folder-pages", "folderPagesPlugin");
 var autoCardLink = np(
   "@riebeckite/plugin-autocardlink",
   "autoCardLinkPlugin",
@@ -355,7 +362,7 @@ var quality = np(
 var deploy = np(
   "@riebeckite/plugin-deploy",
   "deployPlugin",
-  (context) => `{ provider: "cloudflare-pages", baseUrl: ${JSON.stringify(context.variables.baseUrl)} }`
+  `{ provider: "cloudflare-pages" }`
 );
 var diagnostics = np(
   "@riebeckite/plugin-diagnostics",
@@ -421,6 +428,8 @@ var starter = {
     codeEnhance,
     search,
     backlinks,
+    breadcrumbs,
+    navigationStarter,
     relatedPosts,
     recentPosts,
     responsiveImage,
@@ -448,6 +457,8 @@ var showcase = {
     codeEnhance,
     search,
     backlinks,
+    breadcrumbs,
+    navigationShowcase,
     relatedPosts,
     share,
     changelog,
@@ -464,6 +475,7 @@ var showcase = {
     shortcodes,
     series,
     taxonomy,
+    folderPages,
     autoCardLink,
     richEmbed,
     gallery,

package/dist/src/scaffold/templates.d.ts

@@ -5,12 +5,16 @@ export type SiteTemplateVariables = {
     readonly description: string;
     readonly baseUrl: string;
     readonly locale: string;
+    readonly externalContent?: boolean;
+};
+export type SiteTemplateOptions = {
+    readonly cloudflareWorkers?: boolean;
 };
 export type SiteTemplateFile = {
     readonly path: string;
     readonly content: string | Uint8Array;
 };
-export declare function siteTemplateFiles(preset: ScaffoldPreset, variables: SiteTemplateVariables): readonly SiteTemplateFile[];
+export declare function siteTemplateFiles(preset: ScaffoldPreset, variables: SiteTemplateVariables, options?: SiteTemplateOptions): readonly SiteTemplateFile[];
 /**
  * Resolve a plugin's options literal for the preset's depth, or `null` when
  * the plugin takes no options at that depth (and should be called bare).

package/dist/src/scaffold/version.d.ts

@@ -1 +1 @@
-export declare const RIEBECKITE_VERSION = "^0.0.15";
+export declare const RIEBECKITE_VERSION = "^0.0.17";

package/dist/src/scaffold/wrangler-defaults.d.ts

@@ -27,6 +27,11 @@ export declare const WRANGLER_DEFAULTS: {
 };
 /** Type for the wrangler config object */
 export type WranglerDefaults = typeof WRANGLER_DEFAULTS;
+export declare const WRANGLER_VERSION = "^4.83.0";
+export declare const DEFAULT_WORKER_NAME = "riebeckite-site";
+export declare const WORKER_NAME_MAX_LENGTH = 63;
+export declare function workerNameFromDirectory(directoryName: string): string;
+export declare function buildDefaultWranglerConfig(workerName: string): string;
 /** Expected secret names in GitHub Actions workflow */
 export declare const GITHUB_ACTIONS_SECRETS: {
     /** Cloudflare API token with Workers Scripts: Edit permission */

package/dist/src/ui/primitives.js

@@ -4,11 +4,7 @@ function Article(props) {
   return /* @__PURE__ */ jsx(
     "article",
     {
-      class: joinClassNames(
-        "article-shell rb-article",
-        props.class,
-        props.className
-      ),
+      class: joinClassNames("rb-article", props.class, props.className),
       "data-slot": props["data-slot"] ?? "article",
       children: props.children
     }
@@ -18,11 +14,7 @@ function ArticleLayout(props) {
   return /* @__PURE__ */ jsxs(
     "div",
     {
-      class: joinClassNames(
-        "article-shell__layout rb-article-layout",
-        props.class,
-        props.className
-      ),
+      class: joinClassNames("rb-article-layout", props.class, props.className),
       children: [
         props.children,
         props.aside
@@ -32,7 +24,7 @@ function ArticleLayout(props) {
 }
 function ArticleHeader(props) {
   const className = joinClassNames(
-    "article-shell__lead rb-article-header",
+    "rb-article-header",
     props.class,
     props.className
   );
@@ -51,11 +43,7 @@ function ArticleMeta(props) {
   return /* @__PURE__ */ jsx(
     "aside",
     {
-      class: joinClassNames(
-        "article-frontmatter rb-article-meta",
-        props.class,
-        props.className
-      ),
+      class: joinClassNames("rb-article-meta", props.class, props.className),
       "aria-label": props.label ?? "Article metadata",
       children: props.children
     }
@@ -63,7 +51,7 @@ function ArticleMeta(props) {
 }
 function ArticleContent(props) {
   const className = joinClassNames(
-    "article-shell__body rb-article-body",
+    "rb-article-body",
     props.class,
     props.className
   );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riebeckite/honox",
-  "version": "0.0.15",
+  "version": "0.0.17",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",
@@ -36,7 +36,11 @@
     "esbuild": "^0.28.2",
     "hono": "^4.12.25",
     "vite": "^8.0.9",
-    "@riebeckite/core": "0.0.15"
+    "@riebeckite/core": "0.0.17"
+  },
+  "devDependencies": {
+    "tsx": "^4.22.4",
+    "@riebeckite/test": "0.0.17"
   },
   "publishConfig": {
     "access": "public"