hd-garden 0.9.4 → 0.10.0

package/app/components/SiteChrome.tsx

@@ -5,14 +5,7 @@ import { inAppPath, isHandbookPath, routeLang, ui } from "../lib/i18n";
 import { SiteFooter } from "./SiteFooter";
 import { SiteHeader } from "./SiteHeader";
 
-export function SiteChrome({
-  children,
-  bookshelfSite = false,
-}: {
-  children: React.ReactNode;
-  /** True when the site has content/bookshelf.yaml. The package demo stays chrome-less. */
-  bookshelfSite?: boolean;
-}) {
+export function SiteChrome({ children }: { children: React.ReactNode }) {
   const pathname = usePathname();
   const lang = routeLang(pathname);
   // The skip link follows the route language too (/garden/en/ is English).
@@ -21,19 +14,12 @@ export function SiteChrome({
       {ui(lang).skipToContent}
     </a>
   );
-  // The package demo (no content/bookshelf.yaml) is the approved chrome-less viewport.
-  // A site shelf is a normal page, so it keeps the header and footer.
-  // Static export serves /bookshelf/ ; an exact "/bookshelf" check would miss it.
-  const path = inAppPath(pathname);
-  const shelfDemo = !bookshelfSite && (path === "/bookshelf" || path.startsWith("/bookshelf/"));
-  if (path.startsWith("/admin") || shelfDemo) {
-    return <>{skip}{children}</>;
-  }
+  if (inAppPath(pathname).startsWith("/admin")) return <>{skip}{children}</>;
 
   return (
     <>
       {skip}
-      <SiteHeader shelf={bookshelfSite} />
+      <SiteHeader />
       <div id="main-content">{children}</div>
       <SiteFooter docs={isHandbookPath(pathname)} lang={lang} />
     </>

package/app/components/SiteHeader.tsx

@@ -16,7 +16,7 @@ import { brand, searchFull, searchIndexUrl } from "@garden/site-config";
 import { createSearch } from "../../ui/garden/search-match.mjs";
 import { cropMatchedText, highlightParts } from "../../ui/garden/search-preview.mjs";
 import { resolveDark, themeSwitchProps } from "../../ui/garden/theme.mjs";
-import { siteNav, isCurrentNav } from "../../ui/garden/site-nav.mjs";
+import { SITE_NAV, isCurrentNav } from "../../ui/garden/site-nav.mjs";
 import { isHandbookPath, routeLang, ui } from "../lib/i18n";
 import { HandbookLangSwitch } from "./HandbookLangSwitch";
 import { createIdbStore, loadFullIndex, saveDataOn, whenIdleAfterLoad } from "../../ui/garden/search-full.mjs";
@@ -89,6 +89,7 @@ function loadSearchEngine() {
   return engineLoad;
 }
 
+const nav = SITE_NAV.map((item) => ({ ...item, key: item.href, href: siteHref(item.href) }));
 
 function rangesFor(
   matches: readonly SearchMatch[] | undefined,
@@ -139,8 +140,7 @@ function searchPreview(
   return { prefix: "", text: item.description, suffix: "", ranges: [] };
 }
 
-export function SiteHeader({ shelf = false }: { shelf?: boolean }) {
-  const nav = siteNav({ shelf }).map((item) => ({ ...item, key: item.href, href: siteHref(item.href) }));
+export function SiteHeader() {
   const pathname = usePathname() || "/";
   const t = ui(routeLang(pathname));
   const [menuOpen, setMenuOpen] = useState(false);

package/app/garden-modules.d.ts

@@ -103,9 +103,3 @@ declare module "@garden/site-config" {
   };
   export const githubUrl: string;
 }
-
-declare module "@garden/bookshelf" {
-  import type { BookshelfMount } from "./components/bookshelf/catalog";
-  /** Site shelf from content/bookshelf.yaml, or null when that file is absent. */
-  export const bookshelf: BookshelfMount | null;
-}

package/app/layout.tsx

@@ -4,7 +4,6 @@ import "./globals.css";
 import "./styles/tokens.css";
 import "./styles/a2.css";
 import "./styles/shell.css";
-import { bookshelf } from "@garden/bookshelf";
 import { SiteChrome } from "./components/SiteChrome";
 import {
   getSiteUrl,
@@ -95,7 +94,7 @@ export default function RootLayout({
         )}
       </head>
       <body>
-        <SiteChrome bookshelfSite={bookshelf != null}>{children}</SiteChrome>
+        <SiteChrome>{children}</SiteChrome>
       </body>
     </html>
   );

package/app/lib/i18n.ts

@@ -131,7 +131,7 @@ const zh = {
   fuzzy: "支持模糊匹配",
   escToClose: "关闭",
   noResults: (q: string) => (q ? `没有找到和「${q}」相关的文章` : "还没有可以搜索的内容"),
-  navLabels: { "/blog/": "文章", "/thoughts/": "随想", "/columns/": "专栏", "/tags/": "标签", "/bookshelf/": "书架", "/about/": "关于" } as Record<string, string>,
+  navLabels: { "/blog/": "文章", "/thoughts/": "随想", "/columns/": "专栏", "/tags/": "标签", "/about/": "关于" } as Record<string, string>,
   // Home page
   homeLatestBadge: "最新文章",
   homeRecentHeading: "最近更新",
@@ -299,11 +299,6 @@ const zh = {
   adminTitlePreview: "草稿预览",
   a2IndexTitle: "A2 对照",
   a2IndexDeck: "对照参考文章的版式。正文没有改字。",
-  bookHubCurrent: "本书",
-  bookHubNotes: "我的笔记",
-  bookHubOverview: "总览",
-  bookHubExcerpt: "摘抄",
-  bookHubPdfNote: "（仅分享，侵权删）",
 };
 
 const en: typeof zh = {
@@ -419,7 +414,7 @@ const en: typeof zh = {
   fuzzy: "Fuzzy matching",
   escToClose: "to close",
   noResults: (q: string) => (q ? `No posts match “${q}”` : "Nothing to search yet"),
-  navLabels: { "/blog/": "Posts", "/thoughts/": "Thoughts", "/columns/": "Columns", "/tags/": "Tags", "/bookshelf/": "Shelf", "/about/": "About" },
+  navLabels: { "/blog/": "Posts", "/thoughts/": "Thoughts", "/columns/": "Columns", "/tags/": "Tags", "/about/": "About" },
   // Home page
   homeLatestBadge: "Latest post",
   homeRecentHeading: "Recent updates",
@@ -587,11 +582,6 @@ const en: typeof zh = {
   adminTitlePreview: "Draft Preview",
   a2IndexTitle: "A2 Parity",
   a2IndexDeck: "Layout comparison against reference articles. Body text is unchanged.",
-  bookHubCurrent: "This book",
-  bookHubNotes: "My notes",
-  bookHubOverview: "Overview",
-  bookHubExcerpt: "Excerpt",
-  bookHubPdfNote: "(shared only — removed if it infringes)",
 };
 
 export const UI_STRINGS = { zh, en } as const;

package/app/sitemap.ts

@@ -1,10 +1,8 @@
 import type { MetadataRoute } from "next";
-import { bookshelf } from "@garden/bookshelf";
 import { columnHref, columns, postHref, posts, thoughtHref } from "./lib/content";
 import { absoluteUrl, getSiteUrl } from "./lib/site";
 import { getPublishedThoughts } from "./lib/public-thoughts";
 import { siteHref } from "./lib/site-href";
-import type { BookshelfBook, BookshelfShelf } from "./components/bookshelf/types";
 
 export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
   const baseUrl = await getSiteUrl();
@@ -16,15 +14,6 @@ export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
     { path: "/columns", priority: 0.8, changeFrequency: "weekly" as const },
     { path: "/about", priority: 0.5, changeFrequency: "monthly" as const },
     { path: "/garden", priority: 0.4, changeFrequency: "monthly" as const },
-    // Only a real shelf is a page. The package demo stays out of the sitemap.
-    ...(bookshelf ? [{ path: "/bookshelf", priority: 0.6, changeFrequency: "weekly" as const }] : []),
-    ...(bookshelf
-      ? bookshelf.catalog.flatMap((row: BookshelfShelf) =>
-          row.books
-            .filter((book: BookshelfBook) => typeof book.hub === "string")
-            .map((book: BookshelfBook) => ({ path: book.hub ?? "/bookshelf", priority: 0.55, changeFrequency: "weekly" as const })),
-        )
-      : []),
   ].map((route) => ({
     url: absoluteUrl(siteHref(route.path), baseUrl),
     changeFrequency: route.changeFrequency,

package/app/styles/shell.css

@@ -434,43 +434,6 @@ html[data-theme="dark"] .sh-repos > li.sk::after{background:linear-gradient(90de
   .sh-series.no-cover h2,.sh-series.no-cover .count{grid-column:1 / -1;grid-row:auto}
 }
 
-/* Book hub (本书), locked to tip book-multi-20261029c. Width is fixed; height follows the jacket. */
-.book-hub{width:min(100%,740px);padding:40px 0 72px}
-.book-hub-crumb{margin:0 0 28px;font-size:12px;color:var(--faint,#a09b91);letter-spacing:.06em}
-.book-hub-crumb a{color:inherit;text-decoration:none}
-.book-hub-crumb a:hover{color:var(--ink)}
-.book-hub-crumb [aria-current="page"]{color:var(--faint,#a09b91)}
-.book-hub-card{display:flex;gap:28px;align-items:flex-start;margin:0 0 40px}
-.book-hub-cover{width:148px;flex-shrink:0;height:auto;min-height:0;aspect-ratio:auto;border-radius:0;overflow:visible;background:none;box-shadow:none;line-height:0;padding:0}
-.book-hub-cover img{display:block;width:148px;max-width:none;height:auto;aspect-ratio:auto;object-fit:unset;background:none;border-radius:4px;box-shadow:0 10px 24px rgba(40,30,20,.10)}
-.book-hub-meta{flex:1;min-width:0;padding-top:4px}
-.book-hub-meta h1{margin:0 0 10px;font-family:var(--serif);font-size:clamp(26px,4vw,34px);font-weight:600;line-height:1.25;letter-spacing:-.01em;color:var(--ink)}
-.book-hub-author{margin:0 0 18px;font-size:14px;color:var(--muted)}
-.book-hub-sources{display:flex;flex-wrap:wrap;align-items:center;gap:8px}
-.book-hub-source{display:inline-flex;align-items:center;gap:2px}
-.book-hub-chip{display:inline-flex;align-items:center;gap:4px;padding:4px 10px;border-radius:999px;background:#f3efe6;color:var(--muted);font-size:12px;line-height:1.4;text-decoration:none;border:1px solid transparent}
-html[data-theme="dark"] .book-hub-chip{background:var(--chip)}
-.book-hub-chip:hover{color:var(--ink);border-color:var(--rule)}
-.book-hub-chip .ext{font-size:11px;opacity:.7}
-.book-hub-source-note{font-size:11px;color:var(--faint,#a09b91);letter-spacing:.02em;line-height:1.4}
-.book-hub-notes-head{margin:0 0 14px;font:400 12px/1.4 var(--sans);color:var(--faint,#a09b91);letter-spacing:.12em}
-.book-hub-notes{display:flex;flex-direction:column;gap:12px;margin:0;padding:0;list-style:none}
-.book-hub-note{display:block;width:100%;text-align:left;padding:18px 20px;background:#fffcf7;border:1px solid var(--rule);border-radius:10px;text-decoration:none;color:inherit}
-html[data-theme="dark"] .book-hub-note{background:var(--card)}
-@media (hover:hover){
-  .book-hub-note:hover{border-color:#d5d0c4;box-shadow:0 6px 16px rgba(40,30,20,.05)}
-  html[data-theme="dark"] .book-hub-note:hover{border-color:var(--rule-strong);box-shadow:none}
-}
-.book-hub-note-label{margin:0 0 6px;font-size:11px;color:var(--faint,#a09b91);letter-spacing:.08em}
-.book-hub-note h3{margin:0 0 8px;font:500 16px/1.45 var(--sans);color:var(--ink)}
-.book-hub-note-sum{margin:0 0 12px;font-size:13px;line-height:1.65;color:var(--muted)}
-.book-hub-note-meta{margin:0;font-size:12px;color:var(--faint,#a09b91)}
-@media (max-width:560px){
-  .book-hub{padding:28px 0 64px}
-  .book-hub-card{flex-direction:column;gap:18px}
-  .book-hub-cover,.book-hub-cover img{width:120px}
-}
-
 .sh-row .incol{grid-column:2;justify-self:start;position:relative;z-index:1;margin-top:4px;font-size:var(--fs-meta);line-height:1.6;color:var(--muted);text-decoration:none}
 @media (hover:hover){.sh-row .incol:hover{color:var(--blue);text-decoration:underline;text-underline-offset:3px}}
 .is-compact .sh-row .incol{display:none}

package/docs/handbook/config.md

@@ -1,12 +1,12 @@
 ---
 title: 站点与专栏配置
 navTitle: 站点与专栏配置
-description: 配置 site.config.yaml 中的站点信息、各页标题、自定义品牌图标、content/columns.yaml 专栏与 content/bookshelf.yaml 书架。
+description: 配置 site.config.yaml 中的站点信息、各页标题、自定义品牌图标与 content/columns.yaml 专栏。
 section: getting-started
 order: 3
 ---
 
-站点的全局文字与外观信息集中在根目录的 `site.config.yaml`，专栏目录集中在 `content/columns.yaml`，读书笔记书架集中在 `content/bookshelf.yaml`。修改后运行 `npx garden sync`（或直接 `make dev`）即可生效。
+站点的全局文字与外观信息集中在根目录的 `site.config.yaml`，专栏目录集中在 `content/columns.yaml`。修改后运行 `npx garden sync`（或直接 `make dev`）即可生效。
 
 ## 1. `site.config.yaml` 完整结构
 
@@ -125,60 +125,3 @@ columns:
 | `status` | 否 | 状态标识：`default`（或不写，显示为「持续更新」）、`ongoing`（「连载中」）、`completed`（「已完结」）；旧写法 `持续更新`、`连载中`、`已完结` 仍可识别，其他文字按原样显示 |
 | `cover` | 否 | 专栏封面图路径（相对 `content/covers/`） |
 | `posts` | 是 | 按阅读顺序排列的文章路径列表（相对于 `content/posts/`，不带 `.md` 后缀） |
-
-## 3. 配置读书笔记书架（`content/bookshelf.yaml`）
-
-`/bookshelf` 在站点写了 `content/bookshelf.yaml` 时渲染这里的书，并带上站点顶栏，和其他页面一样可以被索引。没有这个文件时，`/bookshelf` 只在引擎包内的中文验收里显示内置 demo（无顶栏、不收录）；正式站要真书目，就放下这份文件。
-
-架上每一条 `books` 是一本书。`post: note/ddia` 是只有一篇笔记时的简写。一本书有多篇笔记时写 `posts`，点书脊播放抽书动画，落到 `/bookshelf/<id>`（本书），不打开第一篇。从本书页回到书架播放合上动画。本书页左边是书衣（宽 148，高度跟图片走），右边是书名、作者，以及豆瓣和 PDF 两枚出处胶囊；PDF 后面有一行「（仅分享，侵权删）」。下面是「我的笔记」，点进去才是文章，这一步没有飞页。单篇笔记仍走原来的抽书和合上。
-
-`cover` 是书衣，只给书架、抽书飞页和本书页用。文件放在 `content/covers/`，构建时会复制到 `/media/covers/`，即使没有任何博文的 front matter 引用这个文件名。豆瓣封面四周的白边在放进 `content/covers/` 之前裁好，构建不会再改像素。笔记页的横幅仍是各篇 front matter 的 `cover`，不要把那张图填进书衣。yaml 不写 `cover` 时，书衣才沿用第一篇的封面。`color`（`#rgb` 或 `#rrggbb`）画书脊和单篇打开后的纸页。
-
-```yaml
-title: 读书笔记
-description: 读过的书，和留下的笔记。
-eyebrow: 花园
-shelves:
-  - id: recent
-    name: 最近在读
-    books:
-      - id: ddia
-        title: 数据密集型应用系统设计
-        author: Martin Kleppmann
-        cover: ddia.jpg
-        color: "#8b3a2f"
-        post: note/ddia
-      - id: unit-testing
-        title: Unit Testing
-        cover: unit-testing.jpg
-        color: "#1a2744"
-        sources:
-          - label: 豆瓣
-            href: https://book.douban.com/subject/00000000/
-          - label: PDF
-            href: https://example.com/unit-testing.pdf
-        posts:
-          - path: note/note-unit-testing
-            kind: overview
-          - path: note/note-unit-testing-excerpt
-            kind: excerpt
-```
-
-| 字段 | 必填 | 说明 |
-| :--- | :--- | :--- |
-| `title` | 是 | 书架页标题 |
-| `description` | 否 | 页面简介 |
-| `eyebrow` | 否 | 架面眉题。不写时用站点名 |
-| `shelves` | 是 | 非空数组。每一层要有 `id`、`name`，以及非空的 `books` |
-| `books[].id` | 是 | 整架唯一 |
-| `books[].title` | 是 | 书名，显示在左页和笔记页 |
-| `books[].author` | 否 | 作者 |
-| `books[].spine` | 否 | 书脊文字，默认同 `title` |
-| `books[].size` | 否 | `thin`、`s-short`、`s-mid`、`s-tall`。普通书默认 `s-mid`，占位薄册默认 `thin` |
-| `books[].cover` | 否 | 书衣。文件名或完整 URL。写了就只用它 |
-| `books[].color` | 否 | 书脊和单篇打开后的纸色 |
-| `books[].filler` | 否 | `true`、`sand` 或 `cream`，占位薄册，不能打开 |
-| `books[].post` | 否 | 单篇笔记的简写 |
-| `books[].posts` | 否 | 同一本书下的笔记。`kind` 为 `overview`（总览）或 `excerpt`（摘抄）。两篇及以上打开本书页 |
-| `books[].sources` | 否 | 出处。本书页只显示「豆瓣」和「PDF」 |
-| `books[].note` | 否 | 没有笔记路径时直接写的 Markdown |

package/docs/handbook/en/config.md

@@ -1,12 +1,12 @@
 ---
 title: Site & Column Config
 navTitle: Site & Column Config
-description: Configure site metadata, page headings, and brand icons in site.config.yaml, series in content/columns.yaml, and the bookshelf in content/bookshelf.yaml.
+description: Configure site metadata, page headings, and brand icons in site.config.yaml, and organize series in content/columns.yaml.
 section: getting-started
 order: 3
 ---
 
-Global site copy and appearance settings live in `site.config.yaml` at the repository root, series definitions live in `content/columns.yaml`, and the reading-note shelf lives in `content/bookshelf.yaml`. Run `npx garden sync` (or `make dev`) after editing to apply changes.
+Global site copy and appearance settings live in `site.config.yaml` at the repository root, while series definitions live in `content/columns.yaml`. Run `npx garden sync` (or `make dev`) after editing to apply changes.
 
 ## 1. Full `site.config.yaml` Structure
 
@@ -125,60 +125,3 @@ columns:
 | `status` | No | Status value: `default` (or omitted, shown as "Active"), `ongoing` ("Ongoing"), or `completed` ("Completed"). Legacy Chinese values are still accepted, and any other text is shown verbatim |
 | `cover` | No | Cover image path relative to `content/covers/` |
 | `posts` | Yes | Ordered array of post paths relative to `content/posts/`, without the `.md` extension |
-
-## 3. Configuring the bookshelf (`content/bookshelf.yaml`)
-
-When a site has `content/bookshelf.yaml`, `/bookshelf` renders those books inside the site header and is indexed with the other pages. Without that file, `/bookshelf` is only the package's built-in demo (Chinese click-test, no header, not indexed). A production site supplies the file.
-
-Each `books` entry is one volume. `post: note/ddia` is the one-note shorthand. Several notes use `posts`. Clicking that spine plays the extract animation and lands on `/bookshelf/<id>`. It does not open the first note. Returning from that page to the shelf plays the close animation. The book page shows a 148px-wide jacket (height follows the image), the title, the author, and only the Douban and PDF chips. The PDF chip is followed by a short sharing note. My notes lists the notes; each card is a normal link to the article and does not play the flyer. A single note still uses the extract and return animation.
-
-`cover` is the jacket for the shelf, the flyer, and the book page. The file lives in `content/covers/` and the build copies it to `/media/covers/`, even when no post front matter names that file. Crop a Douban scan's white margin before committing the file; the build does not change pixels. A note's hero stays that post's front matter `cover`. Omit the jacket and it falls back to the first note's cover. `color` (`#rgb` or `#rrggbb`) is the spine and the single-note open page.
-
-```yaml
-title: Reading notes
-description: Books I have read, and the notes I kept.
-eyebrow: Library
-shelves:
-  - id: recent
-    name: Recent
-    books:
-      - id: ddia
-        title: Designing Data-Intensive Applications
-        author: Martin Kleppmann
-        cover: ddia.jpg
-        color: "#8b3a2f"
-        post: note/ddia
-      - id: unit-testing
-        title: Unit Testing
-        cover: unit-testing.jpg
-        color: "#1a2744"
-        sources:
-          - label: Douban
-            href: https://book.douban.com/subject/00000000/
-          - label: PDF
-            href: https://example.com/unit-testing.pdf
-        posts:
-          - path: note/note-unit-testing
-            kind: overview
-          - path: note/note-unit-testing-excerpt
-            kind: excerpt
-```
-
-| Field | Required | Description |
-| :--- | :--- | :--- |
-| `title` | Yes | Page title |
-| `description` | No | Page summary |
-| `eyebrow` | No | Small line above the title. Falls back to the site name |
-| `shelves` | Yes | Non-empty list. Each shelf needs `id`, `name`, and a non-empty `books` list |
-| `books[].id` | Yes | Unique across the shelf |
-| `books[].title` | Yes | Title on the left page and the note view |
-| `books[].author` | No | Author |
-| `books[].spine` | No | Spine label. Defaults to `title` |
-| `books[].size` | No | `thin`, `s-short`, `s-mid`, or `s-tall`. Real books default to `s-mid`; filler spines default to `thin` |
-| `books[].cover` | No | Jacket. File name or full URL. When set, it is the only jacket |
-| `books[].color` | No | Spine and single-note open-page color |
-| `books[].filler` | No | `true`, `sand`, or `cream`. A thin spacer that does not open |
-| `books[].post` | No | Shorthand for one note |
-| `books[].posts` | No | Notes on this volume. `kind` is `overview` or `excerpt`. Two or more open the book page |
-| `books[].sources` | No | Sources. The book page shows Douban and PDF only |
-| `books[].note` | No | Markdown used only when the book names no posts |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hd-garden",
-  "version": "0.9.4",
+  "version": "0.10.0",
   "private": false,
   "description": "用 Markdown 写作、用 GitHub Pages 发布的个人博客引擎。",
   "license": "MIT",
@@ -31,7 +31,6 @@
     "public/apple-touch-icon.png",
     "public/og.png",
     "public/images",
-    "public/covers",
     "scripts",
     "templates",
     "ui",

package/scripts/build-content.mjs

@@ -1,7 +1,7 @@
 import crypto from "node:crypto";
 import fs from "node:fs";
 import path from "node:path";
-import { fileURLToPath, pathToFileURL } from "node:url";
+import { fileURLToPath } from "node:url";
 import matter from "gray-matter";
 import { marked } from "marked";
 import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
@@ -994,36 +994,6 @@ const sitemapEntries = [
     ...thoughts.map((entry) => `/thoughts/${entry.slug}/`),
   ].map(pageAddress)),
 ];
-// A site shelf is a public page. The package demo (no content/bookshelf.yaml) is not.
-// The app imports this module instead of reading the yaml at request time, so the
-// worker preview and the static export both see the same shelf.
-// Forked script copies (pipeline tests) do not ship app/bookshelf; a missing loader
-// means there is no site shelf, same as a package without the file.
-const bookshelfLoaderPath = path.join(gardenPackageRoot, "app", "bookshelf", "load.mjs");
-const loadBookshelf = fs.existsSync(bookshelfLoaderPath)
-  ? (await import(pathToFileURL(bookshelfLoaderPath).href)).loadBookshelf
-  : () => null;
-const bookshelf = loadBookshelf(root, posts);
-fs.mkdirSync(gardenDir, { recursive: true });
-fs.writeFileSync(
-  path.join(gardenDir, "bookshelf.ts"),
-  `// Generated by garden sync. Edit content/bookshelf.yaml instead.\nexport const bookshelf = ${JSON.stringify(bookshelf)} as const;\n`,
-);
-if (bookshelf) {
-  sitemapEntries.push(pageAddress("/bookshelf/"));
-  for (const row of bookshelf.catalog ?? []) {
-    for (const book of row.books ?? []) {
-      if (typeof book.hub === "string" && book.hub.startsWith("/")) sitemapEntries.push(pageAddress(book.hub));
-    }
-  }
-  const { publishBookshelfJackets } = await import(pathToFileURL(path.join(gardenPackageRoot, "scripts", "bookshelf-covers.mjs")).href);
-  const { parseBookshelfConfig } = await import(pathToFileURL(path.join(gardenPackageRoot, "app", "components", "bookshelf", "schema.mjs")).href);
-  const coverConfig = parseBookshelfConfig(parseYaml(fs.readFileSync(path.join(contentRoot, "bookshelf.yaml"), "utf8")));
-  publishBookshelfJackets(coverConfig, {
-    coversDir: path.join(contentRoot, "covers"),
-    mediaDir: path.join(generatedMediaRoot, "covers"),
-  });
-}
 // Card URLs in published entries: the only pages the link-card Worker may read.
 fs.writeFileSync(
   path.join(publicRoot, "link-allowlist.json"),

package/scripts/handbook-facts.mjs

@@ -743,14 +743,13 @@ export function checkFileFacts(filePath, content, facts, root = ROOT) {
       const isWorkflow =
         /\b(?:runs-on|steps|jobs|workflow_dispatch|actions\/checkout)\b/u.test(bodyText);
       const isColumnsYaml = /^columns:\s*$/mu.test(bodyText) && /^\s*-\s+slug:/mu.test(bodyText);
-      const isBookshelfYaml = /^shelves:\s*$/mu.test(bodyText) && /^\s*-\s+id:/mu.test(bodyText) && /\bbooks:/u.test(bodyText);
       const isFrontmatter = /^\s*---\s*$/mu.test(bodyText) || (/\bdraft:/u.test(bodyText) && /\btags:/u.test(bodyText));
 
       if (isWorkflow) {
         checkWorkflowRunLines(fence, relFile, facts, issues);
       }
 
-      if (!isWorkflow && !isColumnsYaml && !isBookshelfYaml && !isFrontmatter) {
+      if (!isWorkflow && !isColumnsYaml && !isFrontmatter) {
         try {
           const parsed = parseYaml(bodyText);
           if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {

package/ui/garden/site-nav.mjs

@@ -11,18 +11,6 @@ export const SITE_NAV = [
   { href: "/about/", label: "关于" },
 ];
 
-/**
- * Header links. A site with `content/bookshelf.yaml` gains 书架; the package
- * demo (no file) does not advertise a page it only click-tests.
- */
-export function siteNav({ shelf = false } = {}) {
-  if (!shelf) return SITE_NAV;
-  const entry = { href: "/bookshelf/", label: "书架" };
-  const about = SITE_NAV.findIndex((item) => item.href === "/about/");
-  if (about < 0) return [...SITE_NAV, entry];
-  return [...SITE_NAV.slice(0, about), entry, ...SITE_NAV.slice(about)];
-}
-
 const trim = (value) => (value.length > 1 ? value.replace(/\/+$/u, "") : value);
 
 /**

package/vite.config.ts

@@ -14,11 +14,9 @@ const { d1, r2 } = hostingConfig;
 const siteRoot = gardenSiteRoot();
 const generatedContent = path.join(siteRoot, ".garden", "generated-content.ts");
 const generatedSiteConfig = path.join(siteRoot, ".garden", "site-config.ts");
-const generatedBookshelf = path.join(siteRoot, ".garden", "bookshelf.ts");
 const generatedAliases = {
   "@garden/generated-content": generatedContent,
   "@garden/site-config": generatedSiteConfig,
-  "@garden/bookshelf": generatedBookshelf,
 };
 
 // macOS Seatbelt blocks FSEvents, so Codex previews need polling for HMR.
@@ -69,11 +67,10 @@ function gardenContent() {
       const normalized = id.split("?")[0];
       if (normalized === "@garden/generated-content") return generatedContent;
       if (normalized === "@garden/site-config") return generatedSiteConfig;
-      if (normalized === "@garden/bookshelf") return generatedBookshelf;
       return undefined;
     },
     buildStart() {
-      if (!fs.existsSync(generatedContent) || !fs.existsSync(generatedSiteConfig) || !fs.existsSync(generatedBookshelf)) {
+      if (!fs.existsSync(generatedContent) || !fs.existsSync(generatedSiteConfig)) {
         sync();
       }
     },
@@ -81,19 +78,13 @@ function gardenContent() {
       const contentDir = path.join(siteRoot, "content");
       const configFile = path.join(siteRoot, "site.config.yaml");
       server.watcher.add([contentDir, configFile]);
-      const resyncContent = (file: string) => {
+      server.watcher.on("change", (file) => {
         if (file.startsWith(contentDir) || file === configFile) {
           // While editing, a broken ui block shows as an error card instead of stopping the server.
           sync("preview");
           server.ws.send({ type: "full-reload" });
         }
-      };
-      server.watcher.on("change", resyncContent);
-      // A new or removed bookshelf.yaml is not a "change". Sync so /bookshelf
-      // switches between the site shelf and the package demo without a restart.
-      const isBookshelf = (file: string) => file.endsWith(`${path.sep}bookshelf.yaml`) || file.endsWith("/bookshelf.yaml");
-      server.watcher.on("add", (file) => { if (isBookshelf(file)) resyncContent(file); });
-      server.watcher.on("unlink", (file) => { if (isBookshelf(file)) resyncContent(file); });
+      });
     },
   };
 }

package/app/bookshelf/[bookId]/page.tsx

@@ -1,72 +0,0 @@
-import type { Metadata } from "next";
-import { notFound } from "next/navigation";
-import { bookshelf } from "@garden/bookshelf";
-import { Bookshelf } from "../../components/bookshelf";
-import { pageAlternates } from "../../lib/page-alternates";
-import { siteConfig } from "../../site.config";
-import { isStaticPlaceholder, STATIC_PLACEHOLDER, staticParams } from "../../../ui/garden/static-params.mjs";
-import type { BookshelfBook } from "../../components/bookshelf/types";
-
-function hubBooks(): { shelfTitle: string; book: BookshelfBook }[] {
-  if (!bookshelf) return [];
-  const found: { shelfTitle: string; book: BookshelfBook }[] = [];
-  for (const row of bookshelf.catalog) {
-    for (const book of row.books) {
-      if ((book.posts?.length ?? 0) > 1) found.push({ shelfTitle: bookshelf.title, book });
-    }
-  }
-  return found;
-}
-
-export function generateStaticParams() {
-  return staticParams(
-    hubBooks().map(({ book }) => ({ bookId: book.id })),
-    { bookId: STATIC_PLACEHOLDER },
-  );
-}
-
-export async function generateMetadata({
-  params,
-}: {
-  params: Promise<{ bookId: string }>;
-}): Promise<Metadata> {
-  const { bookId } = await params;
-  const found = hubBooks().find((item) => item.book.id === bookId);
-  if (!found) return {};
-  return {
-    title: found.book.title,
-    description: found.book.posts?.find((post) => post.summary)?.summary,
-    alternates: pageAlternates(`/bookshelf/${found.book.id}`),
-  };
-}
-
-/** `/bookshelf/<id>` — one multi-note volume. Single-note books stay on the shelf. */
-export default async function BookHubPage({
-  params,
-}: {
-  params: Promise<{ bookId: string }>;
-}) {
-  const { bookId } = await params;
-  const found = hubBooks().find((item) => item.book.id === bookId);
-  if (!found || !bookshelf) {
-    if (isStaticPlaceholder(bookId)) return null;
-    notFound();
-  }
-  return (
-    <main className="sh-main bookshelf-page" id="content">
-      <header className="sh-head">
-        {bookshelf.eyebrow ? <p className="sh-kicker">{bookshelf.eyebrow}</p> : null}
-        <h1 id="sh-title">{bookshelf.title}</h1>
-        {bookshelf.description ? <p className="sh-deck">{bookshelf.description}</p> : null}
-      </header>
-      <Bookshelf
-        embedded
-        catalog={bookshelf.catalog}
-        notes={bookshelf.notes}
-        title={bookshelf.title}
-        eyebrow={bookshelf.eyebrow ?? siteConfig.name}
-        initialHub={found.book.id}
-      />
-    </main>
-  );
-}