@riebeckite/honox 0.0.8 → 0.0.10

package/dist/index.js

@@ -1,6 +1,5 @@
 // src/config_loader.ts
 import fs2 from "node:fs/promises";
-import os from "node:os";
 import path2 from "node:path";
 import { build as buildWithEsbuild } from "esbuild";
 
@@ -112,7 +111,7 @@ function escapeRegExp(value) {
 async function loadRiebeckiteConfig(options) {
   const configFile = options.configFile ?? "riebeckite.config.ts";
   const temporaryDirectory = await fs2.mkdtemp(
-    path2.join(os.tmpdir(), "riebeckite-config-")
+    path2.join(options.configRoot, ".riebeckite-config-")
   );
   const outputFile = path2.join(temporaryDirectory, "config.mjs");
   try {
@@ -133,7 +132,10 @@ async function loadRiebeckiteConfig(options) {
       banner: {
         js: 'import { createRequire as __riebeckiteCreateRequire } from "node:module"; const require = __riebeckiteCreateRequire(import.meta.url);'
       },
-      plugins: options.workspaceRoot ? [workspacePackageResolver(options.workspaceRoot)] : []
+      plugins: [
+        externalizeBareModuleImports(),
+        ...options.workspaceRoot ? [workspacePackageResolver(options.workspaceRoot)] : []
+      ]
     });
     const module = await import(`${pathToFileUrl(outputFile)}?t=${Date.now()}`);
     return module.default;
@@ -151,6 +153,17 @@ function resolveHonoxConfig(config, appRoot) {
     }
   };
 }
+function externalizeBareModuleImports() {
+  return {
+    name: "externalize-bare-module-imports",
+    setup(buildApi) {
+      buildApi.onResolve({ filter: /^[^./]|^\.[^./]|^\.\.$/ }, (args) => {
+        if (path2.isAbsolute(args.path)) return null;
+        return { path: args.path, external: true };
+      });
+    }
+  };
+}
 function pathToFileUrl(filePath) {
   return `file:///${filePath.replace(/\\/g, "/").replace(/^([A-Za-z]):/, "$1:")}`;
 }
@@ -1337,139 +1350,833 @@ function riebeckiteSsrExternals(externals) {
   };
 }
 
-// src/scaffold/localized-content.ts
-var HELPERS = {
-  en: "https://github.com/Rerurate514/riebeckite/blob/main/docs/en/README.md",
-  ja: "https://github.com/Rerurate514/riebeckite/blob/main/docs/ja/README.md"
+// src/scaffold/app-templates.ts
+function server() {
+  return `import { mountRiebeckiteEndpoints } from "@riebeckite/honox/server";
+import { createApp } from "honox/server";
+import { config } from "./config";
+import { content } from "./content";
+
+const app = createApp({
+  init: (app) => {
+    mountRiebeckiteEndpoints(app, { config, content });
+  },
+});
+
+export default app;
+export { config, content };
+`;
+}
+function client() {
+  return `import { initRiebeckiteClient } from "virtual:riebeckite/client";
+import { createClient } from "honox/client";
+
+createClient();
+
+if (document.readyState === "loading") {
+  document.addEventListener("DOMContentLoaded", initPage, { once: true });
+} else {
+  initPage();
+}
+
+function initPage() {
+  initRiebeckiteClient();
+}
+`;
+}
+function appConfig() {
+  return `import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { resolveConfigModule } from "@riebeckite/core";
+import * as rawConfigModule from "../riebeckite.config";
+
+const appRoot =
+  process.env.RIEBECKITE_APP_ROOT ??
+  fileURLToPath(new URL("../", import.meta.url));
+const resolvedConfig = resolveConfigModule(rawConfigModule);
+
+export const config = {
+  ...resolvedConfig,
+  buildDirectory: path.join(appRoot, ".riebeckite"),
+  content: {
+    ...resolvedConfig.content,
+    directory: path.resolve(appRoot, resolvedConfig.content.directory),
+  },
 };
-var PLUGIN_INDEX_URL = "https://github.com/Rerurate514/riebeckite/tree/main/packages/plugins";
-var THEMES_INDEX_URL = "https://github.com/Rerurate514/riebeckite/tree/main/packages/themes";
-function pluginReadmeUrl(slug) {
-  return `https://github.com/Rerurate514/riebeckite/blob/main/packages/plugins/${slug}/README.md`;
+`;
 }
-function themeReadmeUrl(slug) {
-  return `https://github.com/Rerurate514/riebeckite/blob/main/packages/themes/${slug}/README.md`;
+function appContent() {
+  return `import { ContentManager } from "@riebeckite/core";
+import { config } from "./config";
+import { CONTENT_DIR } from "./constants/paths";
+
+export const content = new ContentManager(
+  CONTENT_DIR,
+  config.content.exclude,
+  {
+    config,
+    plugins: config.plugins,
+  },
+);
+`;
 }
-function localizedContentFiles(variables, preset) {
-  const defaultLang = defaultLanguageForLocale(variables.locale);
-  const files = [];
-  const localized = preset.languages.length > 1;
-  const pushLocalized = (basePath, build2) => {
-    if (!localized) {
-      files.push({
-        path: `content/${basePath}.md`,
-        content: build2(defaultLang)
-      });
-      return;
-    }
-    for (const language of SCAFFOLD_LANGUAGES) {
-      const suffix = language === defaultLang ? "" : `.${language}`;
-      files.push({
-        path: `content/${basePath}${suffix}.md`,
-        content: build2(language)
-      });
-    }
-  };
-  const pushEnglishOnly = (basePath, build2) => {
-    const suffix = defaultLang === "en" ? "" : ".en";
-    files.push({
-      path: `content/${basePath}${suffix}.md`,
-      content: build2()
-    });
-  };
-  for (const page of preset.contentPages) {
-    if (page === "index") {
-      pushLocalized("index", (language) => indexContent(variables, language));
-    } else if (page === "framework/plugins") {
-      pushLocalized(
-        "framework/plugins",
-        (language) => pluginsContent(language)
-      );
-    } else if (page === "framework/themes") {
-      pushLocalized("framework/themes", (language) => themesContent(language));
-    } else if (page === "guide") {
-      pushEnglishOnly("guide", guideContent);
-    } else if (page === "examples") {
-      pushLocalized(
-        "examples",
-        (language) => examplesContent(preset, language)
-      );
-    } else if (page === "reference/plugins") {
-      pushEnglishOnly(
-        "reference/plugins",
-        () => referencePluginsContent(preset, variables)
-      );
-    } else if (page === "reference/themes") {
-      pushEnglishOnly("reference/themes", referenceThemesContent);
-    }
+function paths() {
+  return `import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { config } from "../config";
+
+const appRoot =
+  process.env.RIEBECKITE_APP_ROOT ??
+  fileURLToPath(new URL("../../", import.meta.url));
+
+export const CONTENT_DIR = path.resolve(appRoot, config.content.directory);
+export const ASSETS_ROOT = "public/";
+`;
+}
+function globalDeclarations() {
+  return `import type { PluginHeadTag } from "@riebeckite/core";
+
+declare module "virtual:riebeckite/client" {
+  export function initRiebeckiteClient(): void;
+}
+
+declare module "hono" {
+  interface Env {
+    Variables: {
+      headTags?: readonly PluginHeadTag[];
+      htmlLanguage?: string;
+    };
+    Bindings: Record<string, never>;
   }
-  return files;
 }
-function read(text, language) {
-  return text[language];
+`;
 }
-function frontmatter() {
-  return ["---", "publish: true", "---", ""].join("\n");
+function style(preset) {
+  const imports = [];
+  if (preset.plugins.length > 0) {
+    imports.push('@import "./.riebeckite/plugin-styles.css";');
+  }
+  if (preset.theme) {
+    imports.push('@import "./.riebeckite/theme-styles.css";');
+  }
+  const blocks = [
+    "",
+    "body {",
+    "  margin: 0;",
+    "  font-family: system-ui, sans-serif;",
+    "}",
+    ""
+  ];
+  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;",
+      "}",
+      "",
+      ".site-header__home {",
+      "  color: #111827;",
+      "  font-weight: 700;",
+      "  text-decoration: none;",
+      "}",
+      ""
+    );
+  }
+  if (preset.appFiles.includes("article")) {
+    blocks.push(
+      ".site-article {",
+      "  display: block;",
+      "  max-width: 48rem;",
+      "  padding: 2rem 1rem;",
+      "  margin: 0 auto;",
+      "}",
+      ""
+    );
+  }
+  if (!preset.theme) {
+    blocks.push(
+      ".riebeckite-empty {",
+      "  max-width: 48rem;",
+      "  padding: 4rem 1rem;",
+      "  margin: 0 auto;",
+      "}",
+      ""
+    );
+  }
+  return [...imports, ...blocks].join("\n");
 }
-function heading(level, text) {
-  return `${"#".repeat(level)} ${text}`;
+function siteHeader() {
+  return `import { ColorModeToggle } from "@riebeckite/plugin-color-mode";
+import { config } from "../config";
+
+export function SiteHeader() {
+  return (
+    <header class="site-header">
+      <a href="/" class="site-header__home">
+        {config.site.title}
+      </a>
+      <ColorModeToggle />
+    </header>
+  );
 }
-function codeBlock(language, code) {
-  return `\`\`\`${language}
-${code}
-\`\`\`
 `;
 }
-var INDEX = {
-  lead: {
-    en: "Welcome to your Riebeckite site.",
-    ja: "あなたの Riebeckite サイトへようこそ。",
-    "zh-CN": "欢迎来到你的 Riebeckite 站点。",
-    es: "Bienvenido a tu sitio Riebeckite.",
-    de: "Willkommen auf deiner Riebeckite-Seite.",
-    fr: "Bienvenue sur votre site Riebeckite.",
-    ko: "Riebeckite 사이트에 오신 것을 환영합니다."
-  },
-  translatedNote: {
-    en: "Every page of this starter is available in seven languages. Switch with the selector below the page title.",
-    ja: "このスターターのすべてのページは 7 言語で利用できます。ページタイトル下のセレクターで切り替えられます。",
-    "zh-CN": "本模板的每个页面均提供七种语言版本，可用页面标题下方的选择器切换。",
-    es: "Cada página de este starter está disponible en siete idiomas. Cámbialos con el selector bajo el título.",
-    de: "Jede Seite dieses Starters ist in sieben Sprachen verfügbar. Wechsel mit dem Auswahlfeld unter dem Seitentitel.",
-    fr: "Chaque page de ce starter est disponible en sept langues. Changez avec le sélecteur sous le titre.",
-    ko: "이 스타터의 모든 페이지는 7개 언어로 제공됩니다. 페이지 제목 아래 선택기로 전환하세요."
+function article() {
+  return `import type { PostContent } from "@riebeckite/core";
+import { Article, ArticleContent, ArticleLayout } from "@riebeckite/honox/ui";
+
+export function SiteArticle({
+  post,
+  afterMeta,
+}: {
+  post: PostContent;
+  afterMeta?: string;
+}) {
+  return (
+    <Article class="site-article">
+      <ArticleLayout>
+        <ArticleContent>
+          {afterMeta ? (
+            <div
+              class="site-article__after-meta"
+              dangerouslySetInnerHTML={{ __html: afterMeta }}
+            />
+          ) : null}
+          <div dangerouslySetInnerHTML={{ __html: post.html ?? "" }} />
+        </ArticleContent>
+      </ArticleLayout>
+    </Article>
+  );
+}
+`;
+}
+function renderer(preset) {
+  if (!preset.theme) return bareRenderer();
+  const hasHeader = preset.appFiles.includes("header");
+  const hasColorMode = preset.plugins.some(
+    (plugin) => plugin.package === "@riebeckite/plugin-color-mode"
+  );
+  return `import type { PluginHeadTag } from "@riebeckite/core";
+import { jsxRenderer } from "hono/jsx-renderer";
+import { Link, Script } from "honox/server";
+${hasColorMode ? `import { ColorModeScript } from "@riebeckite/plugin-color-mode";
+` : ""}${hasHeader ? `import { SiteHeader } from "../components/site-header";
+` : ""}import { config } from "../config";
+
+function themeAttributes() {
+  const { theme } = config;
+
+  return {
+    ...theme.attributes,
+    "data-theme": theme.colorMode === "system" ? undefined : theme.colorMode,
+    "data-theme-name": theme.name,
+    "data-typography": theme.typography,
+    "data-article-layout": theme.articleLayout,
+  };
+}
+
+export default jsxRenderer(({ children }, c) => {
+  const headTags: readonly PluginHeadTag[] = c.get("headTags") ?? [];
+
+  return (
+    <html
+      lang={c.get("htmlLanguage") ?? config.site.locale}
+      {...themeAttributes()}
+    >
+      <head>
+        <meta charset="utf-8" />
+        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+        <title>{config.site.title}</title>
+${hasColorMode ? `        <ColorModeScript />
+` : ""}        <Link href="/app/style.css" rel="stylesheet" />
+        {headTags.map(renderHeadTag)}
+        <Script src="/app/client.ts" async />
+      </head>
+      <body class="riebeckite-page">
+${hasHeader ? `        <SiteHeader />
+` : ""}        {children}
+      </body>
+    </html>
+  );
+});
+
+function renderHeadTag(tag: PluginHeadTag, index: number) {
+  const key = \`\${tag.tag}-\${index}\`;
+  if (tag.tag === "meta") return <meta {...tag.attrs} key={key} />;
+  if (tag.tag === "link") return <link {...tag.attrs} key={key} />;
+  return (
+    <script
+      {...tag.attrs}
+      key={key}
+      dangerouslySetInnerHTML={
+        tag.children ? { __html: tag.children } : undefined
+      }
+    />
+  );
+}
+`;
+}
+function bareRenderer() {
+  return `import { jsxRenderer } from "hono/jsx-renderer";
+import { Link, Script } from "honox/server";
+import { config } from "../config";
+
+export default jsxRenderer(({ children }, c) => (
+  <html lang={c.get("htmlLanguage") ?? config.site.locale}>
+    <head>
+      <meta charset="utf-8" />
+      <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+      <title>{config.site.title}</title>
+      <Link href="/app/style.css" rel="stylesheet" />
+      <Script src="/app/client.ts" async />
+    </head>
+    <body class="riebeckite-page">{children}</body>
+  </html>
+));
+`;
+}
+function indexRoute(preset) {
+  if (!preset.appFiles.includes("article")) return staticIndexRoute();
+  return `import { isPublished } from "@riebeckite/core";
+import { createRoute } from "honox/factory";
+import { SiteArticle } from "../components/article";
+import { config } from "../config";
+import { content } from "../content";
+
+export default createRoute(async (c) => {
+  const manifest = await content.getManifest();
+  const indexEntry = manifest.bySlug.get("index");
+  if (indexEntry && indexEntry.permalink !== "/") {
+    return c.redirect(indexEntry.permalink, 308);
+  }
+
+  const post = await content.getProcessedContent("index");
+  if (!isPublished(config, post.frontmatter)) {
+    return c.notFound();
+  }
+
+  if (indexEntry) {
+    c.set("htmlLanguage", indexEntry.publicLocation.metadata?.["l10n.lang"]);
+    c.set("headTags", indexEntry.headTags ?? []);
+  }
+
+  return c.render(
+    <SiteArticle
+      post={post}
+      afterMeta={indexEntry?.bodySlots?.["article.after-meta"]}
+    />,
+  );
+});
+`;
+}
+function staticIndexRoute() {
+  return `import { createRoute } from "honox/factory";
+import { config } from "../config";
+
+export default createRoute((c) =>
+  c.render(
+    <main class="riebeckite-empty">
+      <h1>{config.site.title}</h1>
+      <p>This is a blank Riebeckite site. Add Markdown files under content/ to get started.</p>
+    </main>,
+  ),
+);
+`;
+}
+function slugRoute() {
+  return `import { isPublished } from "@riebeckite/core";
+import {
+  contentRouteSsgParams,
+  resolveContentRoute,
+} from "@riebeckite/honox/server";
+import { createRoute } from "honox/factory";
+import { SiteArticle } from "../components/article";
+import { config } from "../config";
+import { content } from "../content";
+
+export default createRoute(
+  contentRouteSsgParams("/:slug{.+}", async () => {
+    const manifest = await content.getManifest();
+    return manifest.entries
+      .filter((entry) => isPublished(config, entry.frontmatter))
+      .filter((entry) => entry.permalink !== "/")
+      .map((entry) => ({ slug: entry.permalink.replace(/^\\/+/, "") }));
+  }),
+  async (c) => {
+    const requestedSlug = c.req.param("slug");
+    if (!requestedSlug) return c.notFound();
+    if (/\\.[a-zA-Z0-9]+$/.test(requestedSlug)) return c.notFound();
+
+    const manifest = await content.getManifest();
+    const route = resolveContentRoute(manifest, c.req.path);
+    if (!route) return c.notFound();
+    if (route.kind === "redirect")
+      return c.redirect(route.location, route.status);
+
+    const post = await content.getProcessedContent(route.entry.slug);
+    if (!isPublished(config, post.frontmatter)) {
+      return c.notFound();
+    }
+
+    c.set("htmlLanguage", route.entry.publicLocation.metadata?.["l10n.lang"]);
+    c.set("headTags", route.entry.headTags ?? []);
+
+    return c.render(
+      <SiteArticle
+        post={post}
+        afterMeta={route.entry.bodySlots?.["article.after-meta"]}
+      />,
+    );
   },
-  whatHeading: {
-    en: "What is Riebeckite?",
-    ja: "Riebeckite とは",
-    "zh-CN": "什么是 Riebeckite？",
-    es: "¿Qué es Riebeckite?",
-    de: "Was ist Riebeckite?",
-    fr: "Qu'est-ce que Riebeckite ?",
-    ko: "Riebeckite란?"
+);
+`;
+}
+
+// src/scaffold/localized-content.ts
+var HELPERS = {
+  en: "https://github.com/Rerurate514/riebeckite/blob/main/docs/en/README.md",
+  ja: "https://github.com/Rerurate514/riebeckite/blob/main/docs/ja/README.md"
+};
+var PLUGIN_INDEX_URL = "https://github.com/Rerurate514/riebeckite/tree/main/packages/plugins";
+var THEMES_INDEX_URL = "https://github.com/Rerurate514/riebeckite/tree/main/packages/themes";
+var GALLERY_PACKAGE = "@riebeckite/plugin-gallery";
+var PLUGIN_MARKDOWN_GUIDES = {
+  "@riebeckite/plugin-color-mode": {
+    summary: "Adds the light/dark/system color-mode control to the app shell. Markdown does not need special syntax; every page inherits the toggle.",
+    markdown: "Write any page normally. Use the color-mode control in the header to see the same Markdown under light and dark tokens."
   },
-  whatBody: {
-    en: "Riebeckite is an extensible, content-first framework that builds fast static sites from plain Markdown — the same notes you keep in Obsidian. The ecosystem includes 50+ plugins and six themes, and this site demos both.",
-    ja: "Riebeckite は、プレーンな Markdown（Obsidian で管理しているのと同じノート）から高速な静的サイトを生成する、拡張性のあるコンテンツファーストのフレームワークです。エコシステムには 50 以上のプラグインと 6 つのテーマがあり、このサイトはその両方をデモしています。",
-    "zh-CN": "Riebeckite 是一个可扩展、内容优先的框架，可从纯 Markdown（即你在 Obsidian 中保存的笔记）构建快速的静态站点。生态包含 50+ 插件与六个主题，本站点同时演示两者。",
-    es: "Riebeckite es un framework extensible y orientado al contenido que construye sitios estáticos rápidos desde Markdown simple — las mismas notas que guardas en Obsidian. El ecosistema incluye más de 50 plugins y seis temas; este sitio demuestra ambos.",
-    de: "Riebeckite ist ein erweiterbares, inhaltsorientiertes Framework, das schnelle statische Seiten aus einfachem Markdown baut — denselben Notizen, die du in Obsidian führst. Das Ökosystem umfasst 50+ Plugins und sechs Themes; diese Seite demonstriert beides.",
-    fr: "Riebeckite est un framework extensible et centré sur le contenu qui construit des sites statiques rapides à partir de Markdown simple — les mêmes notes que vous gardez dans Obsidian. L'écosystème inclut plus de 50 plugins et six thèmes ; ce site en démontre les deux.",
-    ko: "Riebeckite는 일반 Markdown(Obsidian에서 관리하는 노트)에서 빠른 정적 사이트를 만드는 확장 가능한 콘텐츠 우선 프레임워크입니다. 생태계에는 50개 이상의 플러그인과 6개 테마가 있으며, 이 사이트가 그 두 가지를 보여줍니다."
+  "@riebeckite/plugin-l10n": {
+    summary: "Routes translated Markdown files by language suffix and keeps the default-language file unsuffixed.",
+    markdown: fence(
+      "text",
+      [
+        "content/about.md       # default language",
+        "content/about.ja.md    # Japanese version served under /ja/about/",
+        "content/about.fr.md    # French version served under /fr/about/"
+      ].join("\n")
+    )
   },
-  exploreHeading: {
-    en: "Explore",
-    ja: "さらに深く",
-    "zh-CN": "继续探索",
-    es: "Explorar",
-    de: "Weiter erkunden",
-    fr: "Explorer",
-    ko: "더 살펴보기"
+  "@riebeckite/plugin-seo": {
+    summary: "Turns Markdown frontmatter and site config into metadata, feeds, sitemap, and robots output.",
+    markdown: [
+      "---",
+      "title: Search-friendly title",
+      "description: Page-specific summary used for meta tags and cards.",
+      "image: /ogp/page.png",
+      "date: 2026-09-30",
+      "publish: true",
+      "---",
+      "",
+      "# Search-friendly title"
+    ].join("\n")
   },
-  explorePlugins: {
-    en: "Plugins — representative packages grouped by capability",
-    ja: "プラグイン — 機能別の代表的なパッケージ",
-    "zh-CN": "插件 — 按能力分组的代表性包",
+  "@riebeckite/plugin-toc": {
+    summary: "Builds a table of contents from Markdown headings.",
+    markdown: [
+      "# Page",
+      "",
+      "## First section",
+      "",
+      "### Nested section",
+      "",
+      "## Second section"
+    ].join("\n")
+  },
+  "@riebeckite/plugin-properties": {
+    summary: 'Renders selected frontmatter properties near the article when configured with `render: "slot"`.',
+    markdown: [
+      "---",
+      "created: 2026-09-30",
+      "modified: 2026-09-30",
+      "tags: [riebeckite, demo]",
+      "status: active",
+      "---"
+    ].join("\n")
+  },
+  "@riebeckite/plugin-alias": {
+    summary: "Creates redirects from old Markdown paths declared in frontmatter.",
+    markdown: [
+      "---",
+      "aliases:",
+      "  - /old-page/",
+      "  - /notes/previous-name/",
+      "---"
+    ].join("\n")
+  },
+  "@riebeckite/plugin-search": {
+    summary: "Indexes published Markdown pages for client-side search. No special syntax is required; searchable text comes from each page body and metadata.",
+    markdown: "# Indexed page\n\nThis body text becomes searchable after the site is built."
+  },
+  "@riebeckite/plugin-backlinks": {
+    summary: "Shows pages that link to the current page. Use normal Markdown links or Obsidian wikilinks.",
+    markdown: "Mention another page with [[guide]] or [the guide](/guide/). The target page can show this page as a backlink."
+  },
+  "@riebeckite/plugin-related-posts": {
+    summary: "Finds related pages from tags and backlink relationships.",
+    markdown: [
+      "---",
+      "tags: [typescript, static-site]",
+      "---",
+      "",
+      "Link to [[another-note]] to strengthen the relationship."
+    ].join("\n")
+  },
+  "@riebeckite/plugin-share": {
+    summary: "Adds share links to rendered pages. Markdown does not need special syntax; page title and URL are used automatically.",
+    markdown: [
+      "---",
+      "title: Shareable article",
+      "---",
+      "",
+      "# Shareable article"
+    ].join("\n")
+  },
+  "@riebeckite/plugin-changelog": {
+    summary: "Surfaces recent or per-note update information from Markdown metadata.",
+    markdown: [
+      "---",
+      "title: Updated article",
+      "modified: 2026-09-30",
+      "---"
+    ].join("\n")
+  },
+  "@riebeckite/plugin-webmention": {
+    summary: "Displays webmentions for the page URL when data is available. Markdown controls the canonical page metadata.",
+    markdown: [
+      "---",
+      "title: Mentionable page",
+      "canonical: https://example.com/mentionable-page/",
+      "---"
+    ].join("\n")
+  },
+  "@riebeckite/plugin-recent-posts": {
+    summary: "Builds recent-post lists from dated Markdown entries.",
+    markdown: [
+      "---",
+      "title: New post",
+      "date: 2026-09-30",
+      "publish: true",
+      "---"
+    ].join("\n")
+  },
+  "@riebeckite/plugin-attachment": {
+    summary: "Enhances links to downloadable assets, including size display when enabled.",
+    markdown: "Download the handout: [slides.pdf](/attachments/slides.pdf)"
+  },
+  "@riebeckite/plugin-pdf": {
+    summary: "Embeds linked PDFs with a viewer/fallback UI.",
+    markdown: "![Project brief](./attachments/project-brief.pdf)"
+  },
+  "@riebeckite/plugin-media": {
+    summary: "Enhances Markdown audio/video embeds with lazy loading and captions.",
+    markdown: "![Demo video](./media/demo.mp4)\n\n![Episode audio](./media/episode.mp3)"
+  },
+  "@riebeckite/plugin-responsive-image": {
+    summary: "Rewrites Markdown image embeds into responsive images with configured widths and formats.",
+    markdown: "![A responsive landscape](./images/landscape.jpg)"
+  },
+  "@riebeckite/plugin-lightbox": {
+    summary: "Makes image links open in a lightbox when the configured trigger class is present.",
+    markdown: "[![Open in lightbox](./images/photo.jpg)](./images/photo.jpg){.rr-lightbox-trigger}"
+  },
+  "@riebeckite/plugin-highlight": {
+    summary: "Highlights marked inline text.",
+    markdown: "This sentence contains ==highlighted text== inside normal Markdown."
+  },
+  "@riebeckite/plugin-code-annotations": {
+    summary: "Adds callouts/annotations to code fences.",
+    markdown: [
+      "```ts",
+      "const answer = 42 // [!code focus]",
+      "console.log(answer)",
+      "```"
+    ].join("\n")
+  },
+  "@riebeckite/plugin-shortcodes": {
+    summary: "Expands built-in shortcode syntax inside Markdown.",
+    markdown: '{{< youtube dQw4w9WgXcQ >}}\n\n{{< figure src="/images/demo.png" caption="Demo image" >}}'
+  },
+  "@riebeckite/plugin-series": {
+    summary: "Groups Markdown pages into a reading series using frontmatter.",
+    markdown: [
+      "---",
+      "series: riebeckite-guide",
+      "series_title: Riebeckite Guide",
+      "series_order: 2",
+      "---"
+    ].join("\n")
+  },
+  "@riebeckite/plugin-taxonomy": {
+    summary: "Builds tag/folder taxonomy pages from Markdown metadata and content location.",
+    markdown: ["---", "tags: [design, notes]", "---", "", "# Tagged note"].join(
+      "\n"
+    )
+  },
+  "@riebeckite/plugin-autocardlink": {
+    summary: "Turns suitable standalone links into rich card links.",
+    markdown: "https://example.com/articles/riebeckite-introduction"
+  },
+  "@riebeckite/plugin-plantuml": {
+    summary: "A `plantuml` fence is rendered to SVG through the configured PlantUML server.",
+    markdown: fence(
+      "plantuml",
+      ["@startuml", "Alice -> Bob: Hello", "Bob --> Alice: Hi", "@enduml"].join(
+        "\n"
+      )
+    )
+  },
+  "@riebeckite/plugin-discord-embed": {
+    summary: "Renders Discord-style rich embed metadata from frontmatter or embed blocks.",
+    markdown: [
+      "---",
+      "title: Discord preview",
+      "description: A page with rich metadata for card rendering.",
+      "image: /images/card.png",
+      "---"
+    ].join("\n")
+  },
+  "@riebeckite/plugin-excalidraw": {
+    summary: "Embeds Excalidraw drawings referenced from Markdown.",
+    markdown: "![[Architecture.excalidraw]]\n\n![Sketch](./drawings/sketch.excalidraw)"
+  },
+  "@riebeckite/plugin-excalibrain": {
+    summary: "Builds an Excalibrain-style local graph from links, tags, headings, and inferred relationships.",
+    markdown: "# Concept\n\nLinks to [[Parent idea]], [[Sibling idea]], and [[Related idea]] become graph relationships."
+  },
+  "@riebeckite/plugin-canvas": {
+    summary: "Embeds Obsidian Canvas JSON as a rendered canvas/fallback.",
+    markdown: '```canvas\n{ "nodes": [], "edges": [] }\n```'
+  },
+  "@riebeckite/plugin-flashcards": {
+    summary: "Turns Q/A style Markdown into flashcards.",
+    markdown: [
+      "# Flashcards",
+      "",
+      "Q: What is Riebeckite?",
+      "A: A content-first static site framework.",
+      "",
+      "---",
+      "",
+      "What does SSG mean?::Static Site Generation"
+    ].join("\n")
+  },
+  "@riebeckite/plugin-local-graph": {
+    summary: "Shows nearby notes based on Markdown links and wikilinks.",
+    markdown: "# Local graph source\n\nConnect this page to [[guide]], [[examples]], and [[reference/plugins]]."
+  },
+  "@riebeckite/plugin-hover-preview": {
+    summary: "Shows previews when hovering internal links generated from Markdown.",
+    markdown: "Hover this internal link: [Guide](/guide/) or this wikilink: [[guide]]."
+  },
+  "@riebeckite/plugin-garden-explorer": {
+    summary: "Adds garden navigation/explorer UI from the content tree. Markdown files and folders become the source data.",
+    markdown: fence(
+      "text",
+      [
+        "content/",
+        "  notes/",
+        "    ideas.md",
+        "    projects.md",
+        "  reference/",
+        "    plugins.md"
+      ].join("\n")
+    )
+  },
+  "@riebeckite/plugin-ux": {
+    summary: "Adds reading UX such as progress, back-to-top, scroll spy, and copy buttons. Markdown headings and code blocks provide the anchors.",
+    markdown: [
+      "## Long section",
+      "",
+      "```ts",
+      "console.log('copy me')",
+      "```"
+    ].join("\n")
+  },
+  "@riebeckite/plugin-daily-notes": {
+    summary: "Extracts daily-note summaries/snippets from dated Markdown files.",
+    markdown: [
+      "---",
+      "daily-summary: Shipped the plugin reference page.",
+      "---",
+      "",
+      "```daily-snippet",
+      "Fixed the ultra preset examples.",
+      "```"
+    ].join("\n")
+  },
+  "@riebeckite/plugin-rename": {
+    summary: "Creates redirects when Markdown entries declare previous paths or when rename data is available.",
+    markdown: [
+      "---",
+      "previousPaths:",
+      "  - /old-slug/",
+      "  - /notes/old-title/",
+      "---"
+    ].join("\n")
+  },
+  "@riebeckite/plugin-text-fragment": {
+    summary: "Adds text-fragment friendly copy/open behavior for selected Markdown text.",
+    markdown: "Select this sentence in the rendered page and copy a text-fragment link to it."
+  },
+  "@riebeckite/plugin-quality": {
+    summary: "Reports accessibility/content quality diagnostics from rendered Markdown output.",
+    markdown: "![Missing alt text example](./images/needs-alt.png)\n\nUse headings in order: #, then ##, then ###."
+  },
+  "@riebeckite/plugin-deploy": {
+    summary: "Adds deployment integration for the generated site. Markdown does not need syntax; published pages become deployable output.",
+    markdown: [
+      "---",
+      "publish: true",
+      "---",
+      "",
+      "# This page is included in the deployed site"
+    ].join("\n")
+  },
+  "@riebeckite/plugin-diagnostics": {
+    summary: "Reports diagnostics such as missing required frontmatter, orphan pages, and unused assets.",
+    markdown: [
+      "---",
+      "title: Required title",
+      "publish: true",
+      "---",
+      "",
+      "Link orphan pages from another note to clear orphan diagnostics."
+    ].join("\n")
+  }
+};
+function pluginReadmeUrl(slug) {
+  return `https://github.com/Rerurate514/riebeckite/blob/main/packages/plugins/${slug}/README.md`;
+}
+function themeReadmeUrl(slug) {
+  return `https://github.com/Rerurate514/riebeckite/blob/main/packages/themes/${slug}/README.md`;
+}
+function localizedContentFiles(variables, preset) {
+  const defaultLang = defaultLanguageForLocale(variables.locale);
+  const files = [];
+  const localized = preset.languages.length > 1;
+  const pushLocalized = (basePath, build2) => {
+    if (!localized) {
+      files.push({
+        path: `content/${basePath}.md`,
+        content: build2(defaultLang)
+      });
+      return;
+    }
+    for (const language of SCAFFOLD_LANGUAGES) {
+      const suffix = language === defaultLang ? "" : `.${language}`;
+      files.push({
+        path: `content/${basePath}${suffix}.md`,
+        content: build2(language)
+      });
+    }
+  };
+  const pushEnglishOnly = (basePath, build2) => {
+    const suffix = defaultLang === "en" ? "" : ".en";
+    files.push({
+      path: `content/${basePath}${suffix}.md`,
+      content: build2()
+    });
+  };
+  for (const page of preset.contentPages) {
+    if (page === "index") {
+      pushLocalized("index", (language) => indexContent(variables, language));
+    } else if (page === "framework/plugins") {
+      pushLocalized(
+        "framework/plugins",
+        (language) => pluginsContent(language)
+      );
+    } else if (page === "framework/themes") {
+      pushLocalized(
+        "framework/themes",
+        (language) => themesContent(language, preset)
+      );
+    } else if (page === "guide") {
+      pushEnglishOnly("guide", guideContent);
+    } else if (page === "examples") {
+      pushLocalized(
+        "examples",
+        (language) => examplesContent(preset, language)
+      );
+    } else if (page === "reference/plugins") {
+      pushEnglishOnly(
+        "reference/plugins",
+        () => referencePluginsContent(preset, variables)
+      );
+    } else if (page === "reference/themes") {
+      pushEnglishOnly("reference/themes", () => referenceThemesContent(preset));
+    }
+  }
+  return files;
+}
+function read(text, language) {
+  return text[language];
+}
+function frontmatter() {
+  return ["---", "publish: true", "---", ""].join("\n");
+}
+function heading(level, text) {
+  return `${"#".repeat(level)} ${text}`;
+}
+function codeBlock(language, code) {
+  return `\`\`\`${language}
+${code}
+\`\`\`
+`;
+}
+var INDEX = {
+  lead: {
+    en: "Welcome to your Riebeckite site.",
+    ja: "あなたの Riebeckite サイトへようこそ。",
+    "zh-CN": "欢迎来到你的 Riebeckite 站点。",
+    es: "Bienvenido a tu sitio Riebeckite.",
+    de: "Willkommen auf deiner Riebeckite-Seite.",
+    fr: "Bienvenue sur votre site Riebeckite.",
+    ko: "Riebeckite 사이트에 오신 것을 환영합니다."
+  },
+  translatedNote: {
+    en: "Every page of this starter is available in seven languages. Switch with the selector below the page title.",
+    ja: "このスターターのすべてのページは 7 言語で利用できます。ページタイトル下のセレクターで切り替えられます。",
+    "zh-CN": "本模板的每个页面均提供七种语言版本，可用页面标题下方的选择器切换。",
+    es: "Cada página de este starter está disponible en siete idiomas. Cámbialos con el selector bajo el título.",
+    de: "Jede Seite dieses Starters ist in sieben Sprachen verfügbar. Wechsel mit dem Auswahlfeld unter dem Seitentitel.",
+    fr: "Chaque page de ce starter est disponible en sept langues. Changez avec le sélecteur sous le titre.",
+    ko: "이 스타터의 모든 페이지는 7개 언어로 제공됩니다. 페이지 제목 아래 선택기로 전환하세요."
+  },
+  whatHeading: {
+    en: "What is Riebeckite?",
+    ja: "Riebeckite とは",
+    "zh-CN": "什么是 Riebeckite？",
+    es: "¿Qué es Riebeckite?",
+    de: "Was ist Riebeckite?",
+    fr: "Qu'est-ce que Riebeckite ?",
+    ko: "Riebeckite란?"
+  },
+  whatBody: {
+    en: "Riebeckite is an extensible, content-first framework that builds fast static sites from plain Markdown — the same notes you keep in Obsidian. The ecosystem includes 50+ plugins and six themes, and this site demos both.",
+    ja: "Riebeckite は、プレーンな Markdown（Obsidian で管理しているのと同じノート）から高速な静的サイトを生成する、拡張性のあるコンテンツファーストのフレームワークです。エコシステムには 50 以上のプラグインと 6 つのテーマがあり、このサイトはその両方をデモしています。",
+    "zh-CN": "Riebeckite 是一个可扩展、内容优先的框架，可从纯 Markdown（即你在 Obsidian 中保存的笔记）构建快速的静态站点。生态包含 50+ 插件与六个主题，本站点同时演示两者。",
+    es: "Riebeckite es un framework extensible y orientado al contenido que construye sitios estáticos rápidos desde Markdown simple — las mismas notas que guardas en Obsidian. El ecosistema incluye más de 50 plugins y seis temas; este sitio demuestra ambos.",
+    de: "Riebeckite ist ein erweiterbares, inhaltsorientiertes Framework, das schnelle statische Seiten aus einfachem Markdown baut — denselben Notizen, die du in Obsidian führst. Das Ökosystem umfasst 50+ Plugins und sechs Themes; diese Seite demonstriert beides.",
+    fr: "Riebeckite est un framework extensible et centré sur le contenu qui construit des sites statiques rapides à partir de Markdown simple — les mêmes notes que vous gardez dans Obsidian. L'écosystème inclut plus de 50 plugins et six thèmes ; ce site en démontre les deux.",
+    ko: "Riebeckite는 일반 Markdown(Obsidian에서 관리하는 노트)에서 빠른 정적 사이트를 만드는 확장 가능한 콘텐츠 우선 프레임워크입니다. 생태계에는 50개 이상의 플러그인과 6개 테마가 있으며, 이 사이트가 그 두 가지를 보여줍니다."
+  },
+  exploreHeading: {
+    en: "Explore",
+    ja: "さらに深く",
+    "zh-CN": "继续探索",
+    es: "Explorar",
+    de: "Weiter erkunden",
+    fr: "Explorer",
+    ko: "더 살펴보기"
+  },
+  explorePlugins: {
+    en: "Plugins — representative packages grouped by capability",
+    ja: "プラグイン — 機能別の代表的なパッケージ",
+    "zh-CN": "插件 — 按能力分组的代表性包",
     es: "Plugins — paquetes representativos por capacidad",
     de: "Plugins — repräsentative Pakete nach Fähigkeit",
     fr: "Plugins — paquets représentatifs par capacité",
@@ -1549,6 +2256,15 @@ var THEMES_COPY = {
     fr: "Un thème change tout l'aspect d'un site — couleurs, typographie, mise en page — sans toucher au contenu ni aux routes. Riebeckite fournit six thèmes ; installez un paquet et changez une ligne.",
     ko: "테마를 바꾸면 색상·타이포그래피·레이아웃 등 사이트 전체 분위기가 달라집니다. 콘텐츠나 라우트는 건드릴 필요가 없습니다. Riebeckite는 6개 테마를 제공하며 패키지 설치 후 한 줄만 바꾸면 전환됩니다."
   },
+  galleryHeading: {
+    en: "Theme gallery",
+    ja: "テーマギャラリー",
+    "zh-CN": "主题画廊",
+    es: "Galería de temas",
+    de: "Theme-Galerie",
+    fr: "Galerie des thèmes",
+    ko: "테마 갤러리"
+  },
   switchHeading: {
     en: "Switching themes",
     ja: "テーマの切り替え",
@@ -1702,11 +2418,37 @@ var THEMES = [
     }
   }
 ];
-function themesContent(language) {
+var THEME_LABELS = {
+  default: "Default",
+  minimal: "Minimal",
+  sakura: "Sakura",
+  gruvbox: "Gruvbox",
+  tokyonight: "Tokyo Night",
+  rerurate: "Rerurate"
+};
+function themeGalleryFence(description) {
+  const items = ["columns: 3", "items:"];
+  for (const theme of THEMES) {
+    const label = THEME_LABELS[theme.slug] ?? theme.slug;
+    items.push(`  - title: ${JSON.stringify(label)}`);
+    items.push(`    description: ${JSON.stringify(description(theme))}`);
+    items.push(`    meta: ${JSON.stringify(theme.factory)}`);
+    items.push(`    href: ${JSON.stringify(themeReadmeUrl(theme.slug))}`);
+  }
+  return fence("gallery", items.join("\n"));
+}
+function themesContent(language, preset) {
   const copy = THEMES_COPY;
   const lines = [frontmatter()];
   lines.push(heading(1, read(copy.title, language)), "");
   lines.push(read(copy.intro, language), "");
+  if (hasPlugin(preset, GALLERY_PACKAGE)) {
+    lines.push(heading(2, read(copy.galleryHeading, language)), "");
+    lines.push(
+      themeGalleryFence((theme) => read(theme.desc, language)),
+      ""
+    );
+  }
   lines.push(heading(2, read(copy.switchHeading, language)), "");
   lines.push(read(copy.switchCurrent, language), "");
   lines.push(read(copy.switchStep1, language), "");
@@ -2326,9 +3068,9 @@ function guideContent() {
     codeBlock(
       "sh",
       [
-        "npm install",
-        "npm exec riebeckite dev",
-        "npm exec riebeckite build"
+        "pnpm install",
+        "pnpm exec riebeckite dev",
+        "pnpm exec riebeckite build"
       ].join("\n")
     ),
     "",
@@ -2397,11 +3139,47 @@ function referencePluginsContent(preset, variables) {
     );
   }
   lines.push("");
+  lines.push(heading(2, "Markdown behavior"), "");
+  lines.push(
+    "Every registered plugin is listed below with the Markdown that triggers it,",
+    "or with the Markdown/frontmatter/content shape it reads when the plugin is",
+    "site-wide rather than block-based. Paste the examples into files under",
+    "`content/` and run `pnpm exec riebeckite dev` to inspect the rendered result.",
+    ""
+  );
+  for (const plugin of preset.plugins) {
+    const demoKeys = README_DEMO_ORDER.filter(
+      (key) => demoPackage(key) === plugin.package
+    );
+    const guide = PLUGIN_MARKDOWN_GUIDES[plugin.package];
+    const slug = plugin.package.replace(/^@riebeckite\/plugin-/, "");
+    lines.push(heading(3, plugin.package), "");
+    lines.push(
+      `Factory: \`${plugin.factory}\` · [README](${pluginReadmeUrl(slug)})`,
+      ""
+    );
+    if (guide) {
+      lines.push(guide.summary, "");
+      lines.push(guide.markdown, "");
+    }
+    for (const key of demoKeys) {
+      const demo = README_DEMOS[key];
+      lines.push(heading(4, demo.title.en), "");
+      lines.push(demo.intro.en, "");
+      lines.push(demo.markdown, "");
+    }
+    if (!guide && demoKeys.length === 0) {
+      lines.push(
+        "This plugin has no Markdown-specific demo in the scaffold yet. See its package README for the exact behavior and options.",
+        ""
+      );
+    }
+  }
   lines.push(`[Riebeckite plugins on GitHub](${PLUGIN_INDEX_URL})`, "");
   lines.push("");
   return lines.join("\n");
 }
-function referenceThemesContent() {
+function referenceThemesContent(preset) {
   const lines = [frontmatter()];
   lines.push(heading(1, "Theme reference"), "");
   lines.push(
@@ -2409,6 +3187,13 @@ function referenceThemesContent() {
     "`theme` factory in `riebeckite.config.ts`.",
     ""
   );
+  if (hasPlugin(preset, GALLERY_PACKAGE)) {
+    lines.push(heading(2, "Theme gallery"), "");
+    lines.push(
+      themeGalleryFence((theme) => theme.desc.en),
+      ""
+    );
+  }
   lines.push("| Theme | Factory | Description |");
   lines.push("| --- | --- | --- |");
   for (const theme of THEMES) {
@@ -2424,7 +3209,7 @@ function referenceThemesContent() {
 }
 
 // src/scaffold/version.ts
-var RIEBECKITE_VERSION = "^0.0.8";
+var RIEBECKITE_VERSION = "^0.0.10";
 
 // src/scaffold/templates.ts
 function siteTemplateFiles(preset, variables) {
@@ -2738,7 +3523,7 @@ var README_WORDS = {
     demoPages: "Try the demos",
     demoPagesBody: "The generated site ships content pages that exercise these features:",
     copyDemos: "Copy-paste demos",
-    copyDemosBody: "Paste any of these snippets into a Markdown file under `content/` and run `npm exec riebeckite dev`. Each one renders through a plugin this preset registers."
+    copyDemosBody: "Paste any of these snippets into a Markdown file under `content/` and run `pnpm exec riebeckite dev`. Each one renders through a plugin this preset registers."
   },
   ja: {
     included: "含まれているもの",
@@ -2762,7 +3547,7 @@ var README_WORDS = {
     demoPages: "デモを試す",
     demoPagesBody: "生成されたサイトには、各機能を体験できるコンテンツページが含まれています:",
     copyDemos: "コピーして使えるデモ",
-    copyDemosBody: "以下のスニペットを `content/` 配下の Markdown ファイルに貼り付けて `npm exec riebeckite dev` を実行してください。それぞれ、このプリセットが登録しているプラグインでレンダリングされます。"
+    copyDemosBody: "以下のスニペットを `content/` 配下の Markdown ファイルに貼り付けて `pnpm exec riebeckite dev` を実行してください。それぞれ、このプリセットが登録しているプラグインでレンダリングされます。"
   }
 };
 function readme(preset, variables) {
@@ -2795,10 +3580,10 @@ function readmeEn(preset, variables) {
   lines.push(`## ${words.commands}`, "");
   lines.push(
     "```sh",
-    "npm install",
-    "npm exec riebeckite check",
-    "npm exec riebeckite dev",
-    "npm exec riebeckite build",
+    "pnpm install",
+    "pnpm exec riebeckite check",
+    "pnpm exec riebeckite dev",
+    "pnpm exec riebeckite build",
     "```",
     ""
   );
@@ -2843,10 +3628,10 @@ function readmeJa(preset, variables) {
   lines.push(`## ${words.commands}`, "");
   lines.push(
     "```sh",
-    "npm install",
-    "npm exec riebeckite check",
-    "npm exec riebeckite dev",
-    "npm exec riebeckite build",
+    "pnpm install",
+    "pnpm exec riebeckite check",
+    "pnpm exec riebeckite dev",
+    "pnpm exec riebeckite build",
     "```",
     ""
   );
@@ -3188,505 +3973,121 @@ var README_DEMOS = {
         "- [ ] Draft the release notes",
         "- [ ] Link to [[index]]",
         "",
-        "## Done",
-        "",
-        "- [x] Publish the fixture"
-      ].join("\n")
-    )
-  }
-};
-var README_PAGE_LINKS = {
-  "framework/plugins": { en: "Plugin tour", ja: "プラグインツアー" },
-  "framework/themes": { en: "Theme tour", ja: "テーマツアー" },
-  guide: { en: "Getting-started guide", ja: "はじめにガイド" },
-  examples: { en: "Examples", ja: "サンプル集" },
-  "reference/plugins": { en: "Plugin reference", ja: "プラグインリファレンス" },
-  "reference/themes": { en: "Theme reference", ja: "テーマリファレンス" }
-};
-var ENGLISH_ONLY_PAGES = /* @__PURE__ */ new Set([
-  "guide",
-  "reference/plugins",
-  "reference/themes"
-]);
-function fence(language, body) {
-  const tick = "```";
-  return `${tick}${language}
-${body}
-${tick}`;
-}
-function hasPlugin(preset, packageName) {
-  return preset.plugins.some((plugin) => plugin.package === packageName);
-}
-function demoPackage(key) {
-  return key.split("/", 2).join("/");
-}
-function readmePluginOptions(variables, preset, plugin) {
-  return renderOptions(plugin.options, optionContext(preset, variables));
-}
-function configurationReferenceLines(preset, variables, words) {
-  const lines = [
-    `## ${words.configReference}`,
-    "",
-    words.configReferenceBody,
-    ""
-  ];
-  if (preset.theme) {
-    const themeCall = preset.theme.options ? `${preset.theme.factory}(${preset.theme.options})` : `${preset.theme.factory}()`;
-    lines.push(`- **${words.theme}**: \`${themeCall}\``, "");
-  }
-  lines.push(
-    `| Package | ${words.factory} | ${words.options} |`,
-    "| --- | --- | --- |"
-  );
-  for (const plugin of preset.plugins) {
-    const options = readmePluginOptions(variables, preset, plugin);
-    const cell = options === null ? words.emDash : `\`${options}\``;
-    lines.push(`| \`${plugin.package}\` | \`${plugin.factory}\` | ${cell} |`);
-  }
-  lines.push("");
-  return lines;
-}
-function demoPagesLines(preset, variables, words, language) {
-  const lines = [
-    `## ${words.demoPages}`,
-    "",
-    words.demoPagesBody,
-    ""
-  ];
-  const defaultLang = defaultLanguageForLocale(variables.locale);
-  const pages = preset.contentPages.filter((page) => page !== "index");
-  for (const page of pages) {
-    const label = README_PAGE_LINKS[page]?.[language] ?? `/${page}/`;
-    const suffix = ENGLISH_ONLY_PAGES.has(page) && defaultLang !== "en" ? ".en" : "";
-    const source = `content/${page}${suffix}.md`;
-    const url = `/${page}/`;
-    lines.push(`- [**${label}**](${source}) — live at [\`${url}\`](${url})`);
-  }
-  lines.push("");
-  return lines;
-}
-var README_DEMO_ORDER = [
-  "@riebeckite/plugin-obsidian-markdown/callout",
-  "@riebeckite/plugin-obsidian-markdown/wikilinks",
-  "@riebeckite/plugin-code-enhance",
-  "@riebeckite/plugin-code-tabs",
-  "@riebeckite/plugin-mermaid",
-  "@riebeckite/plugin-d2",
-  "@riebeckite/plugin-graphviz",
-  "@riebeckite/plugin-chartjs",
-  "@riebeckite/plugin-vega-lite",
-  "@riebeckite/plugin-wavedrom",
-  "@riebeckite/plugin-markmap",
-  "@riebeckite/plugin-map",
-  "@riebeckite/plugin-marp",
-  "@riebeckite/plugin-qr-code",
-  "@riebeckite/plugin-rich-embed",
-  "@riebeckite/plugin-gallery",
-  "@riebeckite/plugin-dataview",
-  "@riebeckite/plugin-query",
-  "@riebeckite/plugin-bases",
-  "@riebeckite/plugin-kanban"
-];
-function copyPasteDemoLines(preset, words, language) {
-  const lines = [
-    `## ${words.copyDemos}`,
-    "",
-    words.copyDemosBody,
-    ""
-  ];
-  for (const key of README_DEMO_ORDER) {
-    const packageName = demoPackage(key);
-    if (!hasPlugin(preset, packageName)) continue;
-    const demo = README_DEMOS[key];
-    lines.push(`### ${demo.title[language]}`, "");
-    lines.push(demo.intro[language], "");
-    lines.push(demo.markdown, "");
-  }
-  return lines;
-}
-function server() {
-  return `import { mountRiebeckiteEndpoints } from "@riebeckite/honox/server";
-import { createApp } from "honox/server";
-import { config } from "./config";
-import { content } from "./content";
-
-const app = createApp({
-  init: (app) => {
-    mountRiebeckiteEndpoints(app, { config, content });
-  },
-});
-
-export default app;
-export { config, content };
-`;
-}
-function client() {
-  return `import { initRiebeckiteClient } from "virtual:riebeckite/client";
-import { createClient } from "honox/client";
-
-createClient();
-
-if (document.readyState === "loading") {
-  document.addEventListener("DOMContentLoaded", initPage, { once: true });
-} else {
-  initPage();
-}
-
-function initPage() {
-  initRiebeckiteClient();
-}
-`;
-}
-function appConfig() {
-  return `import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { resolveConfigModule } from "@riebeckite/core";
-import * as rawConfigModule from "../riebeckite.config";
-
-const appRoot =
-  process.env.RIEBECKITE_APP_ROOT ??
-  fileURLToPath(new URL("../", import.meta.url));
-const resolvedConfig = resolveConfigModule(rawConfigModule);
-
-export const config = {
-  ...resolvedConfig,
-  buildDirectory: path.join(appRoot, ".riebeckite"),
-  content: {
-    ...resolvedConfig.content,
-    directory: path.resolve(appRoot, resolvedConfig.content.directory),
-  },
-};
-`;
-}
-function appContent() {
-  return `import { ContentManager } from "@riebeckite/core";
-import { config } from "./config";
-import { CONTENT_DIR } from "./constants/paths";
-
-export const content = new ContentManager(
-  CONTENT_DIR,
-  config.content.exclude,
-  {
-    config,
-    plugins: config.plugins,
-  },
-);
-`;
-}
-function paths() {
-  return `import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { config } from "../config";
-
-const appRoot =
-  process.env.RIEBECKITE_APP_ROOT ??
-  fileURLToPath(new URL("../../", import.meta.url));
-
-export const CONTENT_DIR = path.resolve(appRoot, config.content.directory);
-export const ASSETS_ROOT = "public/";
-`;
-}
-function globalDeclarations() {
-  return `import type { PluginHeadTag } from "@riebeckite/core";
-
-declare module "virtual:riebeckite/client" {
-  export function initRiebeckiteClient(): void;
-}
-
-declare module "hono" {
-  interface Env {
-    Variables: {
-      headTags?: readonly PluginHeadTag[];
-      htmlLanguage?: string;
-    };
-    Bindings: Record<string, never>;
-  }
-}
-`;
-}
-function style(preset) {
-  const imports = [];
-  if (preset.plugins.length > 0) {
-    imports.push('@import "./.riebeckite/plugin-styles.css";');
-  }
-  if (preset.theme) {
-    imports.push('@import "./.riebeckite/theme-styles.css";');
-  }
-  const blocks = [
-    "",
-    "body {",
-    "  margin: 0;",
-    "  font-family: system-ui, sans-serif;",
-    "}",
-    ""
-  ];
-  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;",
-      "}",
-      "",
-      ".site-header__home {",
-      "  color: #111827;",
-      "  font-weight: 700;",
-      "  text-decoration: none;",
-      "}",
-      ""
-    );
-  }
-  if (preset.appFiles.includes("article")) {
-    blocks.push(
-      ".site-article {",
-      "  display: block;",
-      "  max-width: 48rem;",
-      "  padding: 2rem 1rem;",
-      "  margin: 0 auto;",
-      "}",
-      ""
-    );
-  }
-  if (!preset.theme) {
-    blocks.push(
-      ".riebeckite-empty {",
-      "  max-width: 48rem;",
-      "  padding: 4rem 1rem;",
-      "  margin: 0 auto;",
-      "}",
-      ""
-    );
-  }
-  return [...imports, ...blocks].join("\n");
-}
-function siteHeader() {
-  return `import { ColorModeToggle } from "@riebeckite/plugin-color-mode";
-import { config } from "../config";
-
-export function SiteHeader() {
-  return (
-    <header class="site-header">
-      <a href="/" class="site-header__home">
-        {config.site.title}
-      </a>
-      <ColorModeToggle />
-    </header>
-  );
-}
-`;
-}
-function article() {
-  return `import type { PostContent } from "@riebeckite/core";
-import { Article, ArticleContent, ArticleLayout } from "@riebeckite/honox/ui";
-
-export function SiteArticle({
-  post,
-  afterMeta,
-}: {
-  post: PostContent;
-  afterMeta?: string;
-}) {
-  return (
-    <Article class="site-article">
-      <ArticleLayout>
-        <ArticleContent>
-          {afterMeta ? (
-            <div
-              class="site-article__after-meta"
-              dangerouslySetInnerHTML={{ __html: afterMeta }}
-            />
-          ) : null}
-          <div dangerouslySetInnerHTML={{ __html: post.html ?? "" }} />
-        </ArticleContent>
-      </ArticleLayout>
-    </Article>
-  );
-}
-`;
-}
-function renderer(preset) {
-  if (!preset.theme) return bareRenderer();
-  const hasHeader = preset.appFiles.includes("header");
-  const hasColorMode = preset.plugins.some(
-    (plugin) => plugin.package === "@riebeckite/plugin-color-mode"
-  );
-  return `import type { PluginHeadTag } from "@riebeckite/core";
-import { jsxRenderer } from "hono/jsx-renderer";
-import { Link, Script } from "honox/server";
-${hasColorMode ? `import { ColorModeScript } from "@riebeckite/plugin-color-mode";
-` : ""}${hasHeader ? `import { SiteHeader } from "../components/site-header";
-` : ""}import { config } from "../config";
-
-function themeAttributes() {
-  const { theme } = config;
-
-  return {
-    ...theme.attributes,
-    "data-theme": theme.colorMode === "system" ? undefined : theme.colorMode,
-    "data-theme-name": theme.name,
-    "data-typography": theme.typography,
-    "data-article-layout": theme.articleLayout,
-  };
+        "## Done",
+        "",
+        "- [x] Publish the fixture"
+      ].join("\n")
+    )
+  }
+};
+var README_PAGE_LINKS = {
+  "framework/plugins": { en: "Plugin tour", ja: "プラグインツアー" },
+  "framework/themes": { en: "Theme tour", ja: "テーマツアー" },
+  guide: { en: "Getting-started guide", ja: "はじめにガイド" },
+  examples: { en: "Examples", ja: "サンプル集" },
+  "reference/plugins": { en: "Plugin reference", ja: "プラグインリファレンス" },
+  "reference/themes": { en: "Theme reference", ja: "テーマリファレンス" }
+};
+var ENGLISH_ONLY_PAGES = /* @__PURE__ */ new Set([
+  "guide",
+  "reference/plugins",
+  "reference/themes"
+]);
+function fence(language, body) {
+  const tick = "```";
+  return `${tick}${language}
+${body}
+${tick}`;
 }
-
-export default jsxRenderer(({ children }, c) => {
-  const headTags: readonly PluginHeadTag[] = c.get("headTags") ?? [];
-
-  return (
-    <html
-      lang={c.get("htmlLanguage") ?? config.site.locale}
-      {...themeAttributes()}
-    >
-      <head>
-        <meta charset="utf-8" />
-        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-        <title>{config.site.title}</title>
-${hasColorMode ? `        <ColorModeScript />
-` : ""}        <Link href="/app/style.css" rel="stylesheet" />
-        {headTags.map(renderHeadTag)}
-        <Script src="/app/client.ts" async />
-      </head>
-      <body class="riebeckite-page">
-${hasHeader ? `        <SiteHeader />
-` : ""}        {children}
-      </body>
-    </html>
-  );
-});
-
-function renderHeadTag(tag: PluginHeadTag, index: number) {
-  const key = \`\${tag.tag}-\${index}\`;
-  if (tag.tag === "meta") return <meta {...tag.attrs} key={key} />;
-  if (tag.tag === "link") return <link {...tag.attrs} key={key} />;
-  return (
-    <script
-      {...tag.attrs}
-      key={key}
-      dangerouslySetInnerHTML={
-        tag.children ? { __html: tag.children } : undefined
-      }
-    />
-  );
+function hasPlugin(preset, packageName) {
+  return preset.plugins.some((plugin) => plugin.package === packageName);
 }
-`;
+function demoPackage(key) {
+  return key.split("/", 2).join("/");
 }
-function bareRenderer() {
-  return `import { jsxRenderer } from "hono/jsx-renderer";
-import { Link, Script } from "honox/server";
-import { config } from "../config";
-
-export default jsxRenderer(({ children }, c) => (
-  <html lang={c.get("htmlLanguage") ?? config.site.locale}>
-    <head>
-      <meta charset="utf-8" />
-      <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-      <title>{config.site.title}</title>
-      <Link href="/app/style.css" rel="stylesheet" />
-      <Script src="/app/client.ts" async />
-    </head>
-    <body class="riebeckite-page">{children}</body>
-  </html>
-));
-`;
+function readmePluginOptions(variables, preset, plugin) {
+  return renderOptions(plugin.options, optionContext(preset, variables));
 }
-function indexRoute(preset) {
-  if (!preset.appFiles.includes("article")) return staticIndexRoute();
-  return `import { isPublished } from "@riebeckite/core";
-import { createRoute } from "honox/factory";
-import { SiteArticle } from "../components/article";
-import { config } from "../config";
-import { content } from "../content";
-
-export default createRoute(async (c) => {
-  const manifest = await content.getManifest();
-  const indexEntry = manifest.bySlug.get("index");
-  if (indexEntry && indexEntry.permalink !== "/") {
-    return c.redirect(indexEntry.permalink, 308);
-  }
-
-  const post = await content.getProcessedContent("index");
-  if (!isPublished(config, post.frontmatter)) {
-    return c.notFound();
-  }
-
-  if (indexEntry) {
-    c.set("htmlLanguage", indexEntry.publicLocation.metadata?.["l10n.lang"]);
-    c.set("headTags", indexEntry.headTags ?? []);
+function configurationReferenceLines(preset, variables, words) {
+  const lines = [
+    `## ${words.configReference}`,
+    "",
+    words.configReferenceBody,
+    ""
+  ];
+  if (preset.theme) {
+    const themeCall = preset.theme.options ? `${preset.theme.factory}(${preset.theme.options})` : `${preset.theme.factory}()`;
+    lines.push(`- **${words.theme}**: \`${themeCall}\``, "");
   }
-
-  return c.render(
-    <SiteArticle
-      post={post}
-      afterMeta={indexEntry?.bodySlots?.["article.after-meta"]}
-    />,
+  lines.push(
+    `| Package | ${words.factory} | ${words.options} |`,
+    "| --- | --- | --- |"
   );
-});
-`;
+  for (const plugin of preset.plugins) {
+    const options = readmePluginOptions(variables, preset, plugin);
+    const cell = options === null ? words.emDash : `\`${options}\``;
+    lines.push(`| \`${plugin.package}\` | \`${plugin.factory}\` | ${cell} |`);
+  }
+  lines.push("");
+  return lines;
 }
-function staticIndexRoute() {
-  return `import { createRoute } from "honox/factory";
-import { config } from "../config";
-
-export default createRoute((c) =>
-  c.render(
-    <main class="riebeckite-empty">
-      <h1>{config.site.title}</h1>
-      <p>This is a blank Riebeckite site. Add Markdown files under content/ to get started.</p>
-    </main>,
-  ),
-);
-`;
+function demoPagesLines(preset, variables, words, language) {
+  const lines = [
+    `## ${words.demoPages}`,
+    "",
+    words.demoPagesBody,
+    ""
+  ];
+  const defaultLang = defaultLanguageForLocale(variables.locale);
+  const pages = preset.contentPages.filter((page) => page !== "index");
+  for (const page of pages) {
+    const label = README_PAGE_LINKS[page]?.[language] ?? `/${page}/`;
+    const suffix = ENGLISH_ONLY_PAGES.has(page) && defaultLang !== "en" ? ".en" : "";
+    const source = `content/${page}${suffix}.md`;
+    const url = `/${page}/`;
+    lines.push(`- [**${label}**](${source}) — live at [\`${url}\`](${url})`);
+  }
+  lines.push("");
+  return lines;
 }
-function slugRoute() {
-  return `import { isPublished } from "@riebeckite/core";
-import {
-  contentRouteSsgParams,
-  resolveContentRoute,
-} from "@riebeckite/honox/server";
-import { createRoute } from "honox/factory";
-import { SiteArticle } from "../components/article";
-import { config } from "../config";
-import { content } from "../content";
-
-export default createRoute(
-  contentRouteSsgParams("/:slug{.+}", async () => {
-    const manifest = await content.getManifest();
-    return manifest.entries
-      .filter((entry) => isPublished(config, entry.frontmatter))
-      .filter((entry) => entry.permalink !== "/")
-      .map((entry) => ({ slug: entry.permalink.replace(/^\\/+/, "") }));
-  }),
-  async (c) => {
-    const requestedSlug = c.req.param("slug");
-    if (!requestedSlug) return c.notFound();
-    if (/\\.[a-zA-Z0-9]+$/.test(requestedSlug)) return c.notFound();
-
-    const manifest = await content.getManifest();
-    const route = resolveContentRoute(manifest, c.req.path);
-    if (!route) return c.notFound();
-    if (route.kind === "redirect")
-      return c.redirect(route.location, route.status);
-
-    const post = await content.getProcessedContent(route.entry.slug);
-    if (!isPublished(config, post.frontmatter)) {
-      return c.notFound();
-    }
-
-    c.set("htmlLanguage", route.entry.publicLocation.metadata?.["l10n.lang"]);
-    c.set("headTags", route.entry.headTags ?? []);
-
-    return c.render(
-      <SiteArticle
-        post={post}
-        afterMeta={route.entry.bodySlots?.["article.after-meta"]}
-      />,
-    );
-  },
-);
-`;
+var README_DEMO_ORDER = [
+  "@riebeckite/plugin-obsidian-markdown/callout",
+  "@riebeckite/plugin-obsidian-markdown/wikilinks",
+  "@riebeckite/plugin-code-enhance",
+  "@riebeckite/plugin-code-tabs",
+  "@riebeckite/plugin-mermaid",
+  "@riebeckite/plugin-d2",
+  "@riebeckite/plugin-graphviz",
+  "@riebeckite/plugin-chartjs",
+  "@riebeckite/plugin-vega-lite",
+  "@riebeckite/plugin-wavedrom",
+  "@riebeckite/plugin-markmap",
+  "@riebeckite/plugin-map",
+  "@riebeckite/plugin-marp",
+  "@riebeckite/plugin-qr-code",
+  "@riebeckite/plugin-rich-embed",
+  "@riebeckite/plugin-gallery",
+  "@riebeckite/plugin-dataview",
+  "@riebeckite/plugin-query",
+  "@riebeckite/plugin-bases",
+  "@riebeckite/plugin-kanban"
+];
+function copyPasteDemoLines(preset, words, language) {
+  const lines = [
+    `## ${words.copyDemos}`,
+    "",
+    words.copyDemosBody,
+    ""
+  ];
+  for (const key of README_DEMO_ORDER) {
+    const packageName = demoPackage(key);
+    if (!hasPlugin(preset, packageName)) continue;
+    const demo = README_DEMOS[key];
+    lines.push(`### ${demo.title[language]}`, "");
+    lines.push(demo.intro[language], "");
+    lines.push(demo.markdown, "");
+  }
+  return lines;
 }
 
 // src/scaffold/index.ts
@@ -3760,10 +4161,10 @@ function formatScaffoldNextSteps(relativeDirectory) {
   if (relativeDirectory !== ".") {
     lines.push(`  cd ${relativeDirectory}`);
   }
-  lines.push("  npm install");
-  lines.push("  npm exec riebeckite check");
-  lines.push("  npm exec riebeckite dev");
-  lines.push("  npm exec riebeckite build");
+  lines.push("  pnpm install");
+  lines.push("  pnpm exec riebeckite check");
+  lines.push("  pnpm exec riebeckite dev");
+  lines.push("  pnpm exec riebeckite build");
   return lines.join("\n");
 }
 export {