hd-garden 0.10.0 → 0.10.2

package/app/components/SeriesEdgeNav.tsx

@@ -0,0 +1,119 @@
+"use client";
+
+import Link from "next/link";
+import {
+  useCallback,
+  useEffect,
+  useId,
+  useRef,
+  useState,
+  type KeyboardEvent as ReactKeyboardEvent,
+} from "react";
+
+export type SeriesEdgeItem = {
+  path: string;
+  href: string;
+  title: string;
+  current?: boolean;
+};
+
+/**
+ * Left-edge Raschka ticks for column articles.
+ * Flyout is the article list only (no column chrome).
+ * Opens on hover or click; stays open until click-outside or Escape.
+ */
+export function SeriesEdgeNav({
+  columnTitle,
+  items,
+}: {
+  columnTitle: string;
+  items: SeriesEdgeItem[];
+  /** @deprecated kept optional so callers can pass it; not shown in the flyout */
+  statusLabel?: string;
+  lang?: string;
+}) {
+  const panelId = useId();
+  const rootRef = useRef<HTMLElement>(null);
+  const [open, setOpen] = useState(false);
+  const currentIndex = Math.max(0, items.findIndex((item) => item.current));
+
+  const close = useCallback(() => setOpen(false), []);
+
+  useEffect(() => {
+    if (!open) return;
+    const onPointerDown = (event: PointerEvent) => {
+      const root = rootRef.current;
+      if (!root) return;
+      if (event.target instanceof Node && root.contains(event.target)) return;
+      close();
+    };
+    const onKeyDown = (event: KeyboardEvent) => {
+      if (event.key === "Escape") close();
+    };
+    document.addEventListener("pointerdown", onPointerDown);
+    document.addEventListener("keydown", onKeyDown);
+    return () => {
+      document.removeEventListener("pointerdown", onPointerDown);
+      document.removeEventListener("keydown", onKeyDown);
+    };
+  }, [close, open]);
+
+  const onTicksKeyDown = (event: ReactKeyboardEvent<HTMLButtonElement>) => {
+    if (event.key === "Enter" || event.key === " ") {
+      event.preventDefault();
+      setOpen((value) => !value);
+    } else if (event.key === "Escape") {
+      close();
+    }
+  };
+
+  return (
+    <nav
+      ref={rootRef}
+      className="series-edge"
+      aria-label={columnTitle}
+      data-open={open ? "true" : "false"}
+    >
+      <button
+        type="button"
+        className="series-edge-ticks"
+        aria-controls={panelId}
+        aria-expanded={open}
+        aria-label={columnTitle}
+        onPointerEnter={() => setOpen(true)}
+        onFocus={() => setOpen(true)}
+        onClick={() => setOpen(true)}
+        onKeyDown={onTicksKeyDown}
+      >
+        {items.map((item, index) => (
+          <i
+            key={item.path}
+            className={index === currentIndex ? "hot" : undefined}
+            aria-hidden="true"
+          />
+        ))}
+      </button>
+      {/* Hit bridge so the pointer can cross ticks → panel without a dead zone. */}
+      <div
+        className="series-edge-bridge"
+        aria-hidden="true"
+        onPointerEnter={() => setOpen(true)}
+      />
+      <div
+        className="series-edge-fly"
+        id={panelId}
+        onPointerEnter={() => setOpen(true)}
+      >
+        <ol className="series-edge-list">
+          {items.map((item) => (
+            <li key={item.path} className={item.current ? "cur" : undefined}>
+              <Link href={item.href} aria-current={item.current ? "page" : undefined}>
+                {item.title}
+              </Link>
+            </li>
+          ))}
+        </ol>
+      </div>
+    </nav>
+  );
+}

package/app/layout.tsx

@@ -49,9 +49,9 @@ export async function generateMetadata(): Promise<Metadata> {
       images: [
         {
           url: "/og.png",
-          width: 1731,
-          height: 909,
-          alt: `${siteConfig.name} · ${siteConfig.pages.home.title.replace("\n", "")}`,
+          width: 1200,
+          height: 630,
+          alt: `${siteConfig.name} · ${siteConfig.tagline} · ${siteConfig.pages.home.title.replace("\n", "")}`,
         },
       ],
     },

package/app/lib/i18n.ts

@@ -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: [
     "一名工程师。平时写代码，也把想清楚的问题记下来。",
@@ -424,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",
@@ -453,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.",
@@ -478,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.",

package/app/lib/remark-link-card.mjs

@@ -11,7 +11,8 @@ import { toString } from "mdast-util-to-string";
  *   paragraph (inside the same list item or quote).
  *
  * Cards are `garden-linkcard` elements carrying `data-url`, `data-text` and,
- * for the standalone form, `data-standalone`.
+ * for the standalone form, `data-standalone`. Every http(s) jump link that
+ * asks for a card uses this same path — same-site and external alike.
  */
 
 const MARKER = "{card}";
@@ -32,7 +33,7 @@ const meaningful = (children) =>
   children.filter((child) => !(child.type === "text" && !child.value.trim()) && child.type !== "break");
 
 /** Take the markers out of one parent's inline children; return the marked links. */
-function takeMarkers(parent, source, sameSite) {
+function takeMarkers(parent, source) {
   const marked = [];
   const children = parent.children ?? [];
   for (let index = 0; index < children.length - 1; index += 1) {
@@ -41,14 +42,13 @@ function takeMarkers(parent, source, sameSite) {
     if (link.type !== "link" || next.type !== "text" || !next.value.startsWith(MARKER)) continue;
     if (!isHttp(link.url) || !writtenAsLink(link, source)) continue;
     next.value = next.value.slice(MARKER.length);
-    // A link back to this site is an ordinary internal link: the marker goes, no card.
-    if (!sameSite(link.url)) marked.push(link);
+    marked.push(link);
   }
   parent.children = children.filter((child) => !(child.type === "text" && child.value === ""));
   return marked;
 }
 
-function walk(parent, source, sameSite) {
+function walk(parent, source) {
   const children = parent.children ?? [];
   for (let index = 0; index < children.length; index += 1) {
     const node = children[index];
@@ -56,14 +56,14 @@ function walk(parent, source, sameSite) {
     if (node.type !== "paragraph") {
       if (node.children) {
         // Headings, table cells and the like: drop the marker, no card.
-        if (node.type === "heading" || node.type === "tableCell") takeMarkers(node, source, sameSite);
-        walk(node, source, sameSite);
+        if (node.type === "heading" || node.type === "tableCell") takeMarkers(node, source);
+        walk(node, source);
       }
       continue;
     }
     // Links nested in emphasis count too.
-    const marked = takeMarkers(node, source, sameSite);
-    for (const child of node.children) if (child.children && child.type !== "link") marked.push(...takeMarkers(child, source, sameSite));
+    const marked = takeMarkers(node, source);
+    for (const child of node.children) if (child.children && child.type !== "link") marked.push(...takeMarkers(child, source));
     if (!marked.length) continue;
     const rest = meaningful(node.children);
     if (marked.length === 1 && rest.length === 1 && rest[0] === marked[0]) {
@@ -97,11 +97,10 @@ function markSources(parent, source) {
   parent.children = children.filter((child) => !(child.type === "text" && child.value === ""));
 }
 
-export function remarkLinkCard(options = {}) {
-  const sameSite = typeof options?.sameSite === "function" ? options.sameSite : () => null;
+export function remarkLinkCard() {
   return (tree, file) => {
     const source = typeof file?.value === "string" ? file.value : String(file?.value ?? "");
     markSources(tree, source);
-    walk(tree, source, sameSite);
+    walk(tree, source);
   };
 }

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/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/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/components/link-card.md

@@ -1,12 +1,12 @@
 ---
-title: 外部链接卡片
+title: 链接卡片
 navTitle: 链接卡片
-description: 把一条外部链接渲染成带网站名、标题和简介的卡片。
+description: 把一条跳转链接渲染成带网站名、标题和简介的卡片。
 section: components
 order: 43
 ---
 
-单独占一段的网址，或链接末尾紧跟 `{card}`，会渲染成链接卡片。正文里的普通外部链接不会变成卡片，例如 [Typora](https://typora.io/)：只在文字前加站点 Favicon，右上角标 `↗`，图标与第一个字留在同一行。
+单独占一段的网址，或链接末尾紧跟 `{card}`，会渲染成链接卡片（同站与外站同一套逻辑）。正文里带标题的普通链接不会变成卡片，例如 [Typora](https://typora.io/)：外站只在文字前加站点 Favicon，右上角标 `↗`，图标与第一个字留在同一行；同站标题链接仍在站内跳转。
 
 - **什么时候用**：希望读者点开之前先看到网站名、标题和简介。
 - **什么时候不用**：句子里只要标出出处时用[来源胶囊](/garden/components/source)；要自己写几条要点时用[知识卡片](/garden/components/card)。
@@ -41,9 +41,9 @@ https://spec.commonmark.org/
 
 [KaTeX 支持的函数](https://katex.org/docs/supported.html){card}
 
-`{card}` 写在代码里会原样显示，例如 `[文字](https://example.com){card}`。标记和 `)` 之间有空格时也不会变成卡片。指向本站的链接会去掉标记，仍是站内链接。
+`{card}` 写在代码里会原样显示，例如 `[文字](https://example.com){card}`。标记和 `)` 之间有空格时也不会变成卡片。同站与外站的跳链共用同一套卡片路径。
 
-构建时读取正文里的 `{card}` 链接，把对方页面的标题、简介和封面记入 `link-assets.json`。单独一行的网址同样变成卡片，标题和简介用同一份记录；这个网址没有以 `{card}` 出现过时，卡片上显示网址本身。抓取失败就沿用上次的结果，构建不会因此中断。只刷新这些信息时运行 `npx garden links`。离线构建时把 `GARDEN_OFFLINE` 设为 `1` 会跳过拉取。
+构建时读取正文里的 `{card}` 链接，以及单独成段的网址，把对方页面的标题、简介和封面记入 `link-assets.json`（同站与外站同一套抓取；HTML meta refresh 会跟着跳到目标页再读 OG）。抓取失败就沿用上次的结果，构建不会因此中断。只刷新这些信息时运行 `npx garden links`。离线构建时把 `GARDEN_OFFLINE` 设为 `1` 会跳过拉取。
 
 随想 Front Matter 里的 `type: link` 用你写的 `title`、`description` 和 `image`，字段见[写文章与随想](/garden/writing)。
 

package/docs/handbook/en/components/link-card.md

@@ -1,12 +1,12 @@
 ---
-title: External Link Card
+title: Link Card
 navTitle: Link card
-description: Render an external URL as a card with the site name, title, and summary.
+description: Render a jump URL as a card with the site name, title, and summary.
 section: components
 order: 43
 ---
 
-A URL on its own paragraph, or a link followed immediately by `{card}`, renders as a link card. An ordinary external link in prose stays a link, such as [Typora](https://typora.io/): it shows the site favicon before the text and a `↗` at the upper right, and the icon stays on the same line as the first word.
+A URL on its own paragraph, or a link followed immediately by `{card}`, renders as a link card (same-site and external share one path). An ordinary titled link in prose stays a link, such as [Typora](https://typora.io/): an external one shows the site favicon before the text and a `↗` at the upper right; a titled same-site link still navigates in place.
 
 - **When to use**: The reader should see the site name, title, and summary before opening the page.
 - **When to skip**: Use a [source chip](/garden/en/components/source) to cite a site inside a sentence, or a [reference card](/garden/en/components/card) when you are writing the takeaways yourself.
@@ -41,9 +41,9 @@ When the paragraph is only the marked link, that line becomes the card:
 
 [Supported KaTeX functions](https://katex.org/docs/supported.html){card}
 
-`{card}` inside code stays as written, for example `[text](https://example.com){card}`. A space between `)` and the marker also leaves an ordinary link. A link back to this site drops the marker and stays an internal link.
+`{card}` inside code stays as written, for example `[text](https://example.com){card}`. A space between `)` and the marker also leaves an ordinary link. Same-site and external jump links share one card path.
 
-At build time, Garden reads `{card}` links in the body and stores the page title, summary, and image in `link-assets.json`. A URL on its own line becomes a card too, using that same record; when the URL has never appeared as `{card}`, the card shows the URL itself. A failed fetch keeps the previous record, and the build continues. Run `npx garden links` to refresh just these records. Set `GARDEN_OFFLINE` to `1` to skip the fetch during an offline build.
+At build time, Garden reads `{card}` links and URLs that stand alone as a paragraph, and stores the page title, summary, and image in `link-assets.json` (same-site and external share one fetch path; HTML meta refresh is followed to the target before reading OG). A failed fetch keeps the previous record, and the build continues. Run `npx garden links` to refresh just these records. Set `GARDEN_OFFLINE` to `1` to skip the fetch during an offline build.
 
 A thought can also carry an external link in Front Matter with `type: link`, using the `title`, `description`, and `image` you write. Those fields are in [Writing Posts & Thoughts](/garden/en/writing).
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hd-garden",
-  "version": "0.10.0",
+  "version": "0.10.2",
   "private": false,
   "description": "用 Markdown 写作、用 GitHub Pages 发布的个人博客引擎。",
   "license": "MIT",

package/scripts/build-content.mjs

@@ -12,7 +12,7 @@ import { referenceDomain } from "../ui/garden/references.mjs";
 import { linkAssetsForRender } from "./link-assets.mjs";
 import { cardUrls } from "../ui/garden/markdown-links.mjs";
 import { formatInlineLink, replaceInlineLinks } from "../ui/garden/markdown-destination.mjs";
-import { configuredSiteAddress, sameSiteMatcher } from "../ui/garden/same-site.mjs";
+import { configuredSiteAddress } from "../ui/garden/same-site.mjs";
 import { resolveBrand } from "./brand.mjs";
 import { imageSources, readImageCache, sizeFromBytes } from "./image-sizes.mjs";
 import { buildFullIndex, buildSearchIndex } from "../ui/garden/search-index.mjs";
@@ -74,7 +74,6 @@ const publicBaseUrl = basePath && !siteUrl.endsWith(basePath)
   : siteUrl;
 // Full URLs to this address are internal links: no new tab, no card.
 const siteAddress = configuredSiteAddress(siteConfig, process.env);
-const sameSite = sameSiteMatcher(siteAddress, basePath);
 const siteName = process.env.SITE_NAME ?? siteConfig.name;
 const siteDescription = process.env.SITE_DESCRIPTION ?? siteConfig.description;
 const siteLang = /^en/iu.test(String(siteConfig.locale ?? "")) ? "en" : "zh";
@@ -997,7 +996,7 @@ const sitemapEntries = [
 // Card URLs in published entries: the only pages the link-card Worker may read.
 fs.writeFileSync(
   path.join(publicRoot, "link-allowlist.json"),
-  `${JSON.stringify({ urls: [...new Set([...posts, ...columns, ...thoughts].flatMap((entry) => cardUrls(entry.content)).filter((url) => !sameSite(url)))].sort() }, null, 2)}\n`,
+  `${JSON.stringify({ urls: [...new Set([...posts, ...columns, ...thoughts].flatMap((entry) => cardUrls(entry.content)))].sort() }, null, 2)}\n`,
 );
 fs.writeFileSync(path.join(publicRoot, "sitemap.xml"), `<?xml version="1.0" encoding="UTF-8" ?>
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">${sitemapEntries.map((entry) => `

package/scripts/link-assets.mjs

@@ -16,7 +16,7 @@ import { isIP } from "node:net";
 import path from "node:path";
 import { pathToFileURL } from "node:url";
 import matter from "gray-matter";
-import { fetchFavicon, fetchImage, fetchPageMeta, isPublicUrl, linkHost } from "./link-meta-core.mjs";
+import { fetchFavicon, fetchImage, fetchPageMeta, isPublicUrl, isSiteBrandOgImage, linkHost } from "./link-meta-core.mjs";
 import { parse as parseYaml } from "yaml";
 import { markdownLinks } from "../ui/garden/markdown-links.mjs";
 import { gardenSourceUrls } from "../ui/garden/source-icon.mjs";
@@ -60,10 +60,11 @@ function readSiteConfig(siteRoot) {
   }
 }
 
-/** External links across every post: the sites (for favicons) and the URLs. */
+/** Jump links across every post: the sites (for favicons) and the URLs. */
 export function collectSiteLinks(siteRoot, env = process.env) {
   const config = readSiteConfig(siteRoot);
-  // Links back to this site are internal: no favicon, no card.
+  // Ordinary same-site prose links need no favicon fetch. Card URLs — same-site
+  // or external — share one OG/link-assets path.
   const sameSite = sameSiteMatcher(configuredSiteAddress(config, env), env.NEXT_PUBLIC_BASE_PATH ?? "");
   const hosts = new Map();
   const cards = new Set();
@@ -71,7 +72,8 @@ export function collectSiteLinks(siteRoot, env = process.env) {
   for (const file of markdownFiles(path.join(siteRoot, "content"))) {
     const { content } = matter(fs.readFileSync(file, "utf8"));
     for (const { url, card } of markdownLinks(content)) {
-      if (!isPublicUrl(url) || sameSite(url)) continue;
+      if (!isPublicUrl(url)) continue;
+      if (sameSite(url) && !card) continue;
       urls.add(url);
       if (card) cards.add(url);
       const host = linkHost(url);
@@ -184,7 +186,7 @@ export async function refreshLinkAssets({
       const meta = await fetchPageMeta(url, { fetch: fetchImpl, timeoutMs });
       if (!meta.title) return keepCachedCard(url);
       let image;
-      if (meta.image) {
+      if (meta.image && !isSiteBrandOgImage(meta.image)) {
         try {
           const picture = await shrinkImage(await fetchImage(meta.image, { fetch: fetchImpl, timeoutMs: timeoutMs * 2 }));
           const name = `${digest(Buffer.from(url))}-${digest(picture.bytes)}.${picture.ext}`;