@riebeckite/honox 0.0.16 → 0.0.17

package/dist/index.js

@@ -490,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");
@@ -517,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" },
@@ -615,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",
@@ -803,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",
@@ -869,6 +876,8 @@ var starter = {
     codeEnhance,
     search,
     backlinks,
+    breadcrumbs,
+    navigationStarter,
     relatedPosts,
     recentPosts,
     responsiveImage,
@@ -896,6 +905,8 @@ var showcase = {
     codeEnhance,
     search,
     backlinks,
+    breadcrumbs,
+    navigationShowcase,
     relatedPosts,
     share,
     changelog,
@@ -912,6 +923,7 @@ var showcase = {
     shortcodes,
     series,
     taxonomy,
+    folderPages,
     autoCardLink,
     richEmbed,
     gallery,
@@ -2141,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";
@@ -2258,6 +2262,12 @@ function style(preset) {
     imports.push('@import "./.riebeckite/theme-styles.css";');
   }
   const blocks = [
+    "",
+    "*,",
+    "*::before,",
+    "*::after {",
+    "  box-sizing: border-box;",
+    "}",
     "",
     "body {",
     "  margin: 0;",
@@ -2265,21 +2275,39 @@ 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;",
+      "  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;",
+      "  margin-right: auto;",
       "  color: var(--rb-color-ink);",
       "  font-weight: 700;",
       "  text-decoration: none;",
@@ -2292,7 +2320,7 @@ function style(preset) {
       ".rb-nav__list {",
       "  display: flex;",
       "  align-items: center;",
-      "  gap: 0.75rem;",
+      "  gap: var(--rb-space-3, 1.5rem);",
       "  margin: 0;",
       "  padding: 0;",
       "  list-style: none;",
@@ -2325,7 +2353,7 @@ function style(preset) {
       "  top: 100%;",
       "  left: 0;",
       "  min-width: max-content;",
-      "  padding: 0.5rem;",
+      "  padding: var(--rb-space-2, 1rem);",
       "  background: var(--rb-color-surface);",
       "  border: 1px solid var(--rb-color-border);",
       "}",
@@ -2342,13 +2370,16 @@ function style(preset) {
       "}",
       "",
       ".rb-site-footer {",
-      "  width: min(100% - 2rem, 48rem);",
-      "  margin: 1rem auto 0;",
-      "  padding-block: 1rem;",
+      "  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;",
       "  }",
@@ -2358,22 +2389,39 @@ function style(preset) {
       "  }",
       "",
       "  .rb-nav__mobile {",
+      "    position: relative;",
       "    display: block;",
       "  }",
       "",
-      "  .rb-nav__mobile .rb-nav__list {",
-      "    flex-direction: column;",
-      "    align-items: flex-start;",
-      "    padding-top: 0.75rem;",
+      "  .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;",
-      "    position: static;",
       "    flex-direction: column;",
       "    align-items: flex-start;",
-      "    gap: 0.5rem;",
-      "    margin-top: 0.5rem;",
+      "    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;",
       "  }",
@@ -2391,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;",
       "}",
@@ -2412,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;",
       "  }",
@@ -2461,12 +2514,18 @@ function style(preset) {
   return [...imports, ...blocks].join("\n");
 }
 function siteHeader() {
-  return `import type { NavigationItem } from "@riebeckite/core";
+  return `import type { NavigationItem } from "@riebeckite/plugin-navigation";
 import { ColorModeToggle } from "@riebeckite/plugin-color-mode";
 import { config } from "../config";
 
-export function SiteHeader({ path }: { path: string }) {
-  const navigation = (config.navigation?.header ?? []).filter((item) => item.href !== "/");
+export function SiteHeader({
+  path,
+  items,
+}: {
+  path: string;
+  items: readonly NavigationItem[];
+}) {
+  const navigation = items.filter((item) => item.href !== "/");
 
   return (
     <header class="site-header rb-site-header">
@@ -2494,13 +2553,18 @@ export function SiteHeader({ path }: { path: string }) {
   );
 }
 
-export function SiteFooter({ path }: { path: string }) {
-  const footerNavigation = config.navigation?.footer ?? [];
-  if (footerNavigation.length === 0) return null;
+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={footerNavigation} path={path} />
+      <SiteNavigation items={items} path={path} />
     </footer>
   );
 }
@@ -2531,18 +2595,22 @@ function NavigationItems({
   return (
     <ul class={isChildList ? "site-navigation__list rb-nav__list rb-nav__children" : "site-navigation__list rb-nav__list"}>
       {items.map((item) => {
-        const active = isActive(item.href, path);
+        const active = item.href ? isActive(item.href, path) : false;
         return (
           <li class="site-navigation__item rb-nav__item">
-            <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>
+            {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}
@@ -2567,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;
@@ -2594,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>
@@ -2660,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 { resolveSiteNavigation } from "@riebeckite/plugin-navigation";
 ` : ""}${hasHeader ? `import { SiteFooter, SiteHeader } from "../components/site-header";
+` : ""}${hasHeader ? `import { content } from "../content";
 ` : ""}import { config } from "../config";
 
 function themeAttributes() {
@@ -2679,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}
@@ -2698,10 +2751,10 @@ ${hasColorMode ? `        <ColorModeScript />
         <Script src="/app/client.ts" async />
       </head>
       <body class="riebeckite-page rb-site">
- ${hasHeader ? `        <SiteHeader path={c.req.path} />
+ ${hasHeader ? `        <SiteHeader path={c.req.path} items={navigation.primary} />
 ` : ""}${hasSearch ? `        <SearchBar />
 ` : ""}        {children}
-${hasHeader ? `        <SiteFooter path={c.req.path} />
+${hasHeader ? `        <SiteFooter path={c.req.path} items={navigation.secondary} />
 ` : ""}      </body>
     </html>
   );
@@ -2750,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"
@@ -2762,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";'
@@ -2791,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) {
@@ -2809,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} />}'
@@ -2829,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")}
 ` : "";
@@ -2853,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 ?? []);
   }
 
@@ -2863,7 +2888,7 @@ ${dataBlock}
 ${propLines.join("\n")}
     />,
   );
-});${titleHelper}`;
+});`;
 }
 function staticIndexRoute() {
   return `import { createRoute } from "honox/factory";
@@ -2881,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";'
@@ -2916,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")}
 ` : "";
@@ -2986,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 }} />,
       );
@@ -2993,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(
@@ -3003,7 +2976,7 @@ ${propLines.join("\n")}
       />,
     );
   },
-);${titleHelper}`;
+);`;
 }
 
 // src/scaffold/localized-content.ts
@@ -3057,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",
@@ -4745,7 +4718,7 @@ function referenceThemesContent(preset) {
 }
 
 // src/scaffold/version.ts
-var RIEBECKITE_VERSION = "^0.0.16";
+var RIEBECKITE_VERSION = "^0.0.17";
 
 // src/scaffold/templates.ts
 function siteTemplateFiles(preset, variables, options = {}) {
@@ -4890,11 +4863,11 @@ 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",');
   lines.push("  },");
-  for (const line of navigationConfig(preset)) lines.push(line);
   if (preset.theme) {
     const theme = preset.theme;
     lines.push(
@@ -4910,25 +4883,6 @@ function riebeckiteConfig(preset, variables) {
   return `${lines.join("\n")}
 `;
 }
-function navigationConfig(preset) {
-  if (preset.name === "starter") {
-    return [
-      "  navigation: {",
-      '    header: [{ label: "Guide", href: "/guide" }, { label: "Examples", href: "/examples" }, { label: "Notes", href: "/notes/planning", children: [{ label: "Planning", href: "/notes/planning" }, { label: "Writing", href: "/notes/writing" }] }],',
-      '    footer: [{ label: "Guide", href: "/guide" }, { label: "Examples", href: "/examples" }],',
-      "  },"
-    ];
-  }
-  if (preset.name === "showcase") {
-    return [
-      "  navigation: {",
-      '    header: [{ label: "Guide", href: "/guide" }, { label: "Examples", href: "/examples" }, { label: "Framework", href: "/framework/plugins", children: [{ label: "Plugins", href: "/framework/plugins" }, { label: "Themes", href: "/framework/themes" }] }],',
-      '    footer: [{ label: "Guide", href: "/guide" }, { label: "Examples", href: "/examples" }],',
-      "  },"
-    ];
-  }
-  return [];
-}
 var OPTION_DEPTH = {
   empty: 0,
   minimal: 0,
@@ -5155,6 +5109,9 @@ function readmeEn(preset, variables) {
       ""
     );
   }
+  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"));
@@ -5213,6 +5170,9 @@ function readmeJa(preset, variables) {
       ""
     );
   }
+  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"));
@@ -5228,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)
@@ -5740,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) {
@@ -5786,14 +5775,29 @@ function formatScaffoldNextSteps(relativeDirectory, options = {}) {
     lines.push(`  ${options.editFile}`);
     lines.push("");
     lines.push("Common first settings:");
-    lines.push("  riebeckite.config.ts: site.title, site.baseUrl, content.directory");
+    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(
+      "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");
 }

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,6 +5,7 @@ export type SiteTemplateVariables = {
     readonly description: string;
     readonly baseUrl: string;
     readonly locale: string;
+    readonly externalContent?: boolean;
 };
 export type SiteTemplateOptions = {
     readonly cloudflareWorkers?: boolean;

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

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

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.16",
+  "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.16"
+    "@riebeckite/core": "0.0.17"
+  },
+  "devDependencies": {
+    "tsx": "^4.22.4",
+    "@riebeckite/test": "0.0.17"
   },
   "publishConfig": {
     "access": "public"