hd-garden 0.9.4 → 0.10.1

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: "最近更新",
@@ -141,6 +141,7 @@ const zh = {
   homeColumnCountStatus: (count: number, status: string) => `${count} 篇，${status}`,
   columnDefaultStatus: "持续更新",
   // Blog archive
+  blogEyebrow: "BLOG / 文章",
   blogHeading: "文章",
   blogDeck: (n: number) => `阶段性的完整沉淀，关于工程、架构与技术思考。共 ${n} 篇，按年份归档。`,
   unknownYear: "未知",
@@ -170,6 +171,7 @@ const zh = {
   seriesEyebrow: "主题专栏",
   seriesCountStatus: (count: number, status: string) => `${count} 篇 · ${status}`,
   // Columns index
+  columnsEyebrow: "COLUMNS / 专栏",
   columnsFallbackTitle: "专栏",
   columnsMeta: (count: number, status: string) => `阅读清单，${count} 篇，${status}`,
   columnsFallbackDesc: "按顺序组织的专题文章系列。",
@@ -195,7 +197,7 @@ const zh = {
   audioFallback: "你的浏览器不支持音频播放。",
   thoughtPermalinkShort: "永久链接",
   // About & GitHub profile
-  aboutEyebrow: "关于",
+  aboutEyebrow: "ABOUT / 关于",
   aboutFallbackHeading: "关于",
   aboutFallbackParagraphs: [
     "一名工程师。平时写代码，也把想清楚的问题记下来。",
@@ -299,11 +301,6 @@ const zh = {
   adminTitlePreview: "草稿预览",
   a2IndexTitle: "A2 对照",
   a2IndexDeck: "对照参考文章的版式。正文没有改字。",
-  bookHubCurrent: "本书",
-  bookHubNotes: "我的笔记",
-  bookHubOverview: "总览",
-  bookHubExcerpt: "摘抄",
-  bookHubPdfNote: "（仅分享，侵权删）",
 };
 
 const en: typeof zh = {
@@ -419,7 +416,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",
@@ -429,6 +426,7 @@ const en: typeof zh = {
   homeColumnCountStatus: (count: number, status: string) => `${count} ${count === 1 ? "post" : "posts"}, ${status}`,
   columnDefaultStatus: "Ongoing",
   // Blog archive
+  blogEyebrow: "BLOG",
   blogHeading: "Posts",
   blogDeck: (n: number) => `Essays on engineering, architecture, and systems thinking. ${n} ${n === 1 ? "post" : "posts"}, archived by year.`,
   unknownYear: "Unknown",
@@ -458,6 +456,7 @@ const en: typeof zh = {
   seriesEyebrow: "Column",
   seriesCountStatus: (count: number, status: string) => `${count} ${count === 1 ? "post" : "posts"} · ${status}`,
   // Columns index
+  columnsEyebrow: "COLUMNS",
   columnsFallbackTitle: "Columns",
   columnsMeta: (count: number, status: string) => `Reading list · ${count} ${count === 1 ? "post" : "posts"} · ${status}`,
   columnsFallbackDesc: "A series of posts organized in reading order.",
@@ -483,7 +482,7 @@ const en: typeof zh = {
   audioFallback: "Your browser does not support audio playback.",
   thoughtPermalinkShort: "Permalink",
   // About & GitHub profile
-  aboutEyebrow: "About",
+  aboutEyebrow: "ABOUT",
   aboutFallbackHeading: "About",
   aboutFallbackParagraphs: [
     "An engineer who writes code and writes down problems once they are clear.",
@@ -587,11 +586,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/page.tsx

@@ -43,7 +43,9 @@ export default function Home() {
     <main className="sh-main" id="content">
       <section className="sh-intro">
         <h1>{siteConfig.pages.home.title}</h1>
-        <p>{siteConfig.pages.home.subtitle || siteConfig.description}</p>
+        {siteConfig.pages.home.subtitle?.trim() ? (
+          <p>{siteConfig.pages.home.subtitle}</p>
+        ) : null}
         <div className="links">
           <Link href={siteHref("/about")}>{t.homeAbout}</Link>
           <a href={githubUrl} rel="me">GitHub</a>

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/a2.css

@@ -2636,3 +2636,207 @@ html[data-theme="dark"] .ref-demo { --rd-s: #262624; --rd-p: #1f1e1d; --rd-i: #e
   .ref-demo[data-name="figure"] .ref-pane[data-p="v"] { grid-column: 1; grid-row: 1; }
   .ref-demo[data-name="figure"] .ref-pane[data-p="c"] { grid-column: 1; grid-row: 2; background: var(--rd-s); border-top: 1px solid var(--rd-r); }
 }
+
+/* ===== v0.10.1 tip keep (after git checkout of a2.css from 9a80f7e5) ===== */
+
+/* List pages: PageIntro rides on .sh-head; keep eyebrow in the same vertical rhythm. */
+.page-intro.sh-head {
+  padding: 72px 0 36px;
+  max-width: var(--list);
+  width: 100%;
+}
+
+.page-intro.sh-head .eyebrow {
+  margin: 0 0 14px;
+  color: var(--muted);
+  font: 600 11px / 1.4 var(--sans);
+  letter-spacing: 0.12em;
+  text-transform: uppercase;
+}
+
+.page-intro.sh-head h1 {
+  margin: 0;
+  font: 700 var(--fs-display) / 1.2 var(--sans);
+  color: var(--ink);
+  letter-spacing: 0;
+  text-wrap: balance;
+}
+
+.page-intro.sh-head .sh-deck {
+  margin: 14px 0 0;
+}
+
+.page-intro.sh-head .page-intro-actions {
+  margin-top: 22px;
+}
+
+.thoughts-page,
+.about-page {
+  width: auto;
+  max-width: none;
+}
+
+.about-page {
+  padding-bottom: 120px;
+}
+
+/* Keep PageIntro at --list; focus card sticks to the right edge. */
+.about-page .about-grid {
+  width: 100%;
+  max-width: none;
+  display: grid;
+  grid-template-columns: minmax(0, var(--list)) minmax(12rem, 17rem);
+  column-gap: 48px;
+  row-gap: 36px;
+  justify-content: space-between;
+  align-items: start;
+}
+
+@media (max-width: 900px) {
+  .about-page .about-grid {
+    grid-template-columns: 1fr;
+  }
+}
+
+/* SeriesEdgeNav: fixed to viewport left on column posts that share PostReadingView.
+   post-reading-page already lays out article + TOC; ticks are position:fixed so
+   they do not need a grid track. */
+.post-reading-page > .series-edge {
+  --edge-window-inset: 12px;
+  position: fixed;
+  top: calc(var(--hdr) + 12px);
+  bottom: 16px;
+  left: max(var(--edge-window-inset), env(safe-area-inset-left, 0px));
+  z-index: 15;
+  display: flex;
+  align-items: center;
+  pointer-events: none;
+  transform: none;
+  margin: 0;
+  padding: 0;
+}
+
+.series-edge-ticks {
+  pointer-events: auto;
+  appearance: none;
+  border: 0;
+  background: transparent;
+  box-shadow: none;
+  display: flex;
+  flex-direction: column;
+  justify-content: center;
+  align-items: center;
+  gap: 8px;
+  padding: 12px 6px;
+  margin: 0;
+  cursor: pointer;
+  color: inherit;
+  font: inherit;
+  border-radius: 0;
+}
+
+.series-edge-ticks i {
+  display: block;
+  width: 11px;
+  height: 1.5px;
+  border-radius: 1px;
+  background: color-mix(in srgb, var(--ink) 32%, transparent);
+  transition: background 0.15s ease, width 0.15s ease;
+}
+
+.series-edge-ticks i.hot {
+  width: 15px;
+  background: color-mix(in srgb, var(--ink) 70%, transparent);
+}
+
+.series-edge[data-open="true"] .series-edge-ticks i,
+.series-edge:focus-within .series-edge-ticks i {
+  background: color-mix(in srgb, var(--ink) 52%, transparent);
+}
+
+.series-edge[data-open="true"] .series-edge-ticks i.hot,
+.series-edge:focus-within .series-edge-ticks i.hot {
+  background: var(--ink);
+}
+
+.series-edge-bridge {
+  pointer-events: auto;
+  position: absolute;
+  top: 0;
+  bottom: 0;
+  left: 100%;
+  width: 28px;
+}
+
+.series-edge-fly {
+  pointer-events: none;
+  position: absolute;
+  top: 50%;
+  left: calc(100% + 4px);
+  transform: translate(0, -50%);
+  width: 16rem;
+  max-height: min(72vh, calc(100vh - var(--hdr) - 40px));
+  margin: 0;
+  padding: 0.7rem 0.85rem 0.75rem;
+  border: 0;
+  border-radius: 10px;
+  background: var(--paper);
+  box-shadow:
+    0 1px 2px color-mix(in srgb, var(--ink) 6%, transparent),
+    0 10px 28px color-mix(in srgb, var(--ink) 10%, transparent);
+  opacity: 0;
+  visibility: hidden;
+  overflow: auto;
+  transition: opacity 0.16s ease, visibility 0.16s ease;
+}
+
+.series-edge[data-open="true"],
+.series-edge:focus-within {
+  z-index: 28;
+}
+
+.series-edge[data-open="true"] .series-edge-fly,
+.series-edge:focus-within .series-edge-fly {
+  pointer-events: auto;
+  opacity: 1;
+  visibility: visible;
+}
+
+.series-edge-list {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+}
+
+.series-edge-list a {
+  display: block;
+  padding: 0.4rem 0.35rem;
+  margin: 0 -0.35rem;
+  border-radius: 7px;
+  color: var(--soft);
+  font-size: 13px;
+  line-height: 1.35;
+  text-decoration: none;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+.series-edge-list a:hover {
+  background: color-mix(in srgb, var(--ink) 4%, transparent);
+  color: var(--ink);
+}
+
+.series-edge-list li.cur a {
+  background: color-mix(in srgb, var(--ink) 6%, transparent);
+  color: var(--ink);
+  font-weight: 600;
+}
+
+@media (max-width: 900px) {
+  /* The desktop rule is `.post-reading-page > .series-edge { display: flex }`.
+     Match that specificity so the rail stays off small screens. */
+  .post-reading-page > .series-edge {
+    display: none;
+  }
+}

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/app/thoughts/page/[n]/page.tsx

@@ -36,7 +36,7 @@ export default async function ThoughtsPage({ params }: { params: Promise<{ n: st
     notFound();
   }
   return (
-    <main className="page-shell thoughts-page">
+    <main className="sh-main thoughts-page" id="content">
       <PageIntro eyebrow={ui().thoughtsEyebrow} title={siteConfig.pages.thoughts.title} subtitle={siteConfig.pages.thoughts.subtitle} />
       <ThoughtFeed page={page} />
     </main>

package/app/thoughts/page.tsx

@@ -16,7 +16,7 @@ export default function ThoughtsPage() {
   const thoughts = getPublishedThoughts();
 
   return (
-    <main className="page-shell thoughts-page">
+    <main className="sh-main thoughts-page" id="content">
       <PageIntro
         eyebrow={ui().thoughtsEyebrow}
         title={siteConfig.pages.thoughts.title}

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.1",
   "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",