@windcoder/astro-theme-orchid 0.2.1 → 0.4.0

package/src/routes/bangumi.astro

@@ -0,0 +1,110 @@
+---
+import BaseLayout from "virtual:theme/components/BaseLayout.astro";
+import config from "virtual:theme/config";
+import { t } from "../i18n/index.js";
+
+/* 番组追番页（§4.93）：构建期从 bgm.tv v0 API 拉取用户「在看」动画收藏，
+   渲染为静态页。外部依赖 fail-soft：请求失败不中断构建，页面照常生成并提示。 */
+
+interface BgmSubject {
+	id: number;
+	name: string;
+	name_cn?: string;
+	score?: number;
+	eps?: number;
+	images?: { common?: string; medium?: string; large?: string };
+}
+interface BgmCollection {
+	updated_at?: string;
+	subject: BgmSubject;
+	ep_status?: number;
+	rate?: number;
+}
+
+const LIMIT = 50;
+/* 50 * 20 = 1000 条安全上限：防止分页异常（total 失真）导致构建挂死 */
+const MAX_PAGES = 20;
+const UA =
+	"astro-theme-orchid (+https://github.com/iwinder/qy-astro-theme-orchid)";
+
+let items: BgmCollection[] = [];
+let failed = false;
+
+try {
+	const headers = { "User-Agent": UA, Accept: "application/json" };
+	for (let offset = 0; offset < LIMIT * MAX_PAGES; offset += LIMIT) {
+		const url = `https://api.bgm.tv/v0/users/${config.bangumi.userId}/collections?subject_type=2&type=3&limit=${LIMIT}&offset=${offset}`;
+		const res = await fetch(url, {
+			headers,
+			signal: AbortSignal.timeout(10_000),
+		});
+		if (!res.ok) throw new Error(`bgm.tv responded ${res.status}`);
+		const page = (await res.json()) as { data?: BgmCollection[] };
+		const batch = page.data ?? [];
+		items = items.concat(batch);
+		if (batch.length < LIMIT) break;
+	}
+	/* 最近在看优先：按收藏更新时间倒序 */
+	items.sort((a, b) => (b.updated_at ?? "").localeCompare(a.updated_at ?? ""));
+} catch {
+	failed = true;
+}
+
+/* 进度文案：eps 有值时 clamp 到总集数并显示 x/y，否则只显示已看集数 */
+function progress(item: BgmCollection): string {
+	const eps = item.subject.eps ?? 0;
+	const watched = item.ep_status ?? 0;
+	return eps > 0
+		? t("epProgress", {
+				n: Math.min(watched, eps),
+				total: eps,
+			})
+		: t("epProgressOpen", { n: watched });
+}
+---
+
+<BaseLayout title={config.bangumi.title} description={config.bangumi.description} page="bangumi">
+  <header class="archive-head reveal">
+    <h1 class="page-title">{config.bangumi.title}</h1>
+    {
+      config.bangumi.description && (
+        <p class="page-sub">{config.bangumi.description}</p>
+      )
+    }
+  </header>
+
+  {
+    items.length > 0 ? (
+      <div class="bangumi-grid reveal">
+        {items.map((item) => {
+          const s = item.subject;
+          const cover = s.images?.common ?? s.images?.medium ?? s.images?.large;
+          return (
+            <a
+              class="bangumi-card card"
+              href={`https://bgm.tv/subject/${s.id}`}
+              target="_blank"
+              rel="noopener nofollow"
+            >
+              <div class="bangumi-cover">
+                {cover && <img src={cover} alt={s.name_cn || s.name} loading="lazy" decoding="async" />}
+                {typeof s.score === "number" && s.score > 0 && (
+                  <span class="bangumi-score">{s.score.toFixed(1)}</span>
+                )}
+              </div>
+              <div class="bangumi-title">{s.name_cn || s.name}</div>
+              <div class="bangumi-meta">
+                <span class="bangumi-progress">{progress(item)}</span>
+                {typeof item.rate === "number" && item.rate > 0 && (
+                  <span class="bangumi-rate">{t("myRate", { n: item.rate })}</span>
+                )}
+              </div>
+            </a>
+          );
+        })}
+      </div>
+    ) : (
+      <p class="tag-empty reveal">{failed ? t("bangumiFail") : t("bangumiEmpty")}</p>
+    )
+  }
+</BaseLayout>

package/src/routes/friends.astro

@@ -3,6 +3,7 @@ import { getEntry, render } from "astro:content";
 import BaseLayout from "virtual:theme/components/BaseLayout.astro";
 import config from "virtual:theme/config";
 import { t } from "../i18n/index.js";
+import { resolveSiteImage } from "../utils/image.js";
 
 // 数据源 = themeConfig.friends.list（决策 8：与侧栏友链 widget 同源）
 const friends = config.friends.list
@@ -13,6 +14,13 @@ const friends = config.friends.list
 			: b.weight - a.weight,
 	);
 
+// 友链头像三格式解析（§4.97）：空串跳过（留空用字头像）
+const friendImgs = await Promise.all(
+	friends.map((f) =>
+		f.image ? resolveSiteImage(f.image) : Promise.resolve(""),
+	),
+);
+
 // 可选 spec 正文（src/content/spec/friends.md），渲染在卡片列表上方
 const entry = await getEntry("spec", "friends").catch(() => null);
 const { Content } = entry ? await render(entry) : { Content: null };
@@ -37,11 +45,11 @@ const apply = config.friends.apply;
   {
     friends.length > 0 ? (
       <div class="friend-grid reveal">
-        {friends.map((f) => (
+        {friends.map((f, i) => (
           <a class="friend-card card" href={f.site} target="_blank" rel="noopener">
             <div class="friend-avatar">
               {f.image ? (
-                <img src={f.image} alt={t('avatarAlt', { name: f.title })} loading="lazy" />
+                <img src={friendImgs[i]} alt={t('avatarAlt', { name: f.title })} loading="lazy" />
               ) : (
                 <span class="avatar-fallback">{f.title.slice(0, 1)}</span>
               )}

package/src/routes/manifest.webmanifest.ts

@@ -0,0 +1,33 @@
+import config from "virtual:theme/config";
+import type { APIRoute } from "astro";
+
+/**
+ * PWA manifest（§4.95）：构建期产出 /manifest.webmanifest。
+ * - scope/start_url 由 site 根路径派生（主题假定部署在站点根路径）；
+ * - name/description 留空回落站点 title/description，short_name 留空回落 name；
+ * - icons 按 pwa.icons 全字段映射（可安装性至少需要 192x192 + 512x512 各一张）；
+ * - enabled=false 时本端点根本不注入（index.ts 门控）。
+ */
+export const GET: APIRoute = ({ site }) => {
+	const base = new URL("/", site ?? new URL("https://blog.example.com"))
+		.pathname;
+	const manifest = {
+		name: config.pwa.name || config.title,
+		short_name: config.pwa.shortName || config.pwa.name || config.title,
+		description: config.pwa.description || config.description,
+		start_url: base,
+		scope: base,
+		display: config.pwa.display,
+		background_color: config.pwa.backgroundColor,
+		theme_color: config.pwa.themeColor,
+		icons: config.pwa.icons.map((icon) => ({
+			src: icon.src,
+			sizes: icon.sizes,
+			type: icon.type,
+			purpose: icon.purpose,
+		})),
+	};
+	return new Response(JSON.stringify(manifest, null, 2), {
+		headers: { "Content-Type": "application/manifest+json; charset=utf-8" },
+	});
+};

package/src/routes/page/[page].astro

@@ -1,6 +1,7 @@
 ---
 import { getCollection } from "astro:content";
 import BaseLayout from "virtual:theme/components/BaseLayout.astro";
+import CategoryBar from "virtual:theme/components/CategoryBar.astro";
 import Pagination from "virtual:theme/components/Pagination.astro";
 import PostCard from "virtual:theme/components/PostCard.astro";
 import Sidebar from "virtual:theme/components/Sidebar.astro";
@@ -45,6 +46,8 @@ const pagePosts = await hydratePosts(
       data-default-layout={config.postList.defaultLayout}
       data-grid-col={config.postList.gridColumnWidth}
     >
+      {/* 分类导航栏：与首页一致，分页页保留入口 */}
+      <CategoryBar />
       {pagePosts.map((post) => <PostCard post={post} featured={post.data.pinned} />)}
       <Pagination page={page} total={total} basePath="/" />
     </div>

package/src/routes/search.astro

@@ -0,0 +1,24 @@
+---
+// 独立搜索页（§4.104）：静态外壳，查询与分页全部在客户端完成（app.ts「独立搜索页」段）。
+// 结果来自 Pagefind 构建期索引；URL 携带 ?q= 关键词与 ?page= 页码，可直接到达与分享。
+// 整页 pagefindIgnore：搜索页自身不进索引，避免搜出无内容空壳页。
+import BaseLayout from "virtual:theme/components/BaseLayout.astro";
+import { t } from "../i18n/index.js";
+---
+
+<BaseLayout title={t('search')} page="search" pagefindIgnore>
+  <header class="archive-head reveal">
+    <h1 class="page-title">{t('search')}</h1>
+  </header>
+  <div class="search-page reveal">
+    <div class="search-page-bar">
+      <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="11" cy="11" r="8"/><path d="m21 21-4.3-4.3"/></svg>
+      <input id="searchPageInput" type="search" placeholder={t('search')} autocomplete="off" enterkeyhint="search" aria-label={t('search')} />
+    </div>
+    {/* 初始文案由 SSR 输出，客户端按查询状态改写（加载中/结果数/无结果/索引不可用） */}
+    <p class="search-page-meta" id="searchPageMeta">{t('searchTypeSomething')}</p>
+    <div class="search-page-results" id="searchPageResults"></div>
+    {/* 分页条复用列表页 .pagination 样式，内容由客户端按结果总数渲染 */}
+    <nav class="pagination" id="searchPagePager" aria-label={t('pagination')} hidden></nav>
+  </div>
+</BaseLayout>

package/src/routes/sponsor.astro

@@ -2,10 +2,23 @@
 import BaseLayout from "virtual:theme/components/BaseLayout.astro";
 import config from "virtual:theme/config";
 import { t } from "../i18n/index.js";
+import { resolveSiteImage } from "../utils/image.js";
 
 const cfg = config.sponsor;
 const methods = cfg.methods.filter((m) => m.enabled);
 const sponsors = cfg.sponsors;
+
+// 收款码/打赏者头像三格式解析（§4.97）：空串跳过
+const methodImgs = await Promise.all(
+	methods.map((m) =>
+		m.image ? resolveSiteImage(m.image) : Promise.resolve(""),
+	),
+);
+const sponsorAvatars = await Promise.all(
+	sponsors.map((s) =>
+		s.avatar ? resolveSiteImage(s.avatar) : Promise.resolve(""),
+	),
+);
 ---
 
 <BaseLayout title={cfg.title} page="sponsor">
@@ -25,7 +38,7 @@ const sponsors = cfg.sponsors;
   {
     methods.length > 0 && (
       <div class="sponsor-grid reveal">
-        {methods.map((m) => (
+        {methods.map((m, i) => (
           <div class="sponsor-method card">
             <div class="sm-name">
               {m.icon && <span class="sm-icon">{m.icon}</span>}
@@ -33,7 +46,7 @@ const sponsors = cfg.sponsors;
             </div>
             {m.description && <p class="sm-desc">{m.description}</p>}
             {m.image ? (
-              <img class="sponsor-qr" src={m.image} alt={t('qrAlt', { name: m.name })} loading="lazy" />
+              <img class="sponsor-qr" src={methodImgs[i]} alt={t('qrAlt', { name: m.name })} loading="lazy" />
             ) : m.link ? (
               <a class="btn sm-link" href={m.link} target="_blank" rel="noopener">
                 {t('goSponsor')}
@@ -58,10 +71,10 @@ const sponsors = cfg.sponsors;
         </h3>
         {sponsors.length > 0 ? (
           <div class="sponsor-list">
-            {sponsors.map((s) => (
+            {sponsors.map((s, i) => (
               <div class="sponsor-item">
                 {s.avatar ? (
-                  <img class="sponsor-item-avatar" src={s.avatar} alt={s.name} loading="lazy" />
+                  <img class="sponsor-item-avatar" src={sponsorAvatars[i]} alt={s.name} loading="lazy" />
                 ) : (
                   <span class="sponsor-item-avatar avatar-fallback">{s.name.slice(0, 1)}</span>
                 )}

package/src/routes/sw.js.ts

@@ -0,0 +1,127 @@
+import type { APIRoute } from "astro";
+
+/**
+ * PWA Service Worker（§4.95）：构建期生成 /sw.js 文本，手写、零客户端运行时依赖。
+ * - 缓存名带构建号（DEV 固定 "dev"）：新构建上线后旧缓存整体作废，activate 全清；
+ * - 三条策略：① 导航请求 network-first，成功回填缓存，离线回落自身缓存、再兜底
+ *   预缓存的首页；② /_astro/ 产物带内容哈希，cache-first；③ 其余同源 GET 走
+ *   stale-while-revalidate，缓存桶超 60 条删最早一条防膨胀；
+ * - 非 GET、跨域、/api/（随机数据端点）、/og/（分享图 PNG 较大）一律直连不缓存；
+ * - install 预缓存首页作离线兜底（不另造 offline 页），skipWaiting 即刻接管；
+ *   activate 清全部旧缓存并 clients.claim()。
+ * SW 文本内不使用模板字符串（避免与本文件 TS 模板嵌套转义），常量经 JSON.stringify 注入。
+ */
+export const GET: APIRoute = ({ site }) => {
+	const base = new URL("/", site ?? new URL("https://blog.example.com"))
+		.pathname;
+	const cacheName =
+		"orchid-pwa-" + (import.meta.env.DEV ? "dev" : Date.now().toString(36));
+	const sw = `// 由 astro-theme-orchid 构建期生成（§4.95），请勿手改
+const CACHE = ${JSON.stringify(cacheName)};
+const BASE = ${JSON.stringify(base)};
+const SCOPE_MAX = 60;
+
+self.addEventListener("install", function (event) {
+  event.waitUntil(
+    caches
+      .open(CACHE)
+      .then(function (cache) {
+        return cache.add(new Request(BASE, { cache: "reload" }));
+      })
+      .then(function () {
+        return self.skipWaiting();
+      })
+  );
+});
+
+self.addEventListener("activate", function (event) {
+  event.waitUntil(
+    caches
+      .keys()
+      .then(function (keys) {
+        return Promise.all(
+          keys
+            .filter(function (key) {
+              return key !== CACHE;
+            })
+            .map(function (key) {
+              return caches.delete(key);
+            })
+        );
+      })
+      .then(function () {
+        return self.clients.claim();
+      })
+  );
+});
+
+self.addEventListener("fetch", function (event) {
+  var req = event.request;
+  if (req.method !== "GET") return;
+  var url = new URL(req.url);
+  if (url.origin !== self.location.origin) return;
+  var path = url.pathname;
+  if (path.indexOf(BASE + "api/") === 0 || path.indexOf(BASE + "og/") === 0) return;
+
+  if (req.mode === "navigate") {
+    event.respondWith(
+      fetch(req)
+        .then(function (res) {
+          var copy = res.clone();
+          caches.open(CACHE).then(function (cache) {
+            cache.put(req, copy);
+          });
+          return res;
+        })
+        .catch(function () {
+          return caches.match(req).then(function (hit) {
+            return hit || caches.match(BASE);
+          });
+        })
+    );
+    return;
+  }
+
+  if (path.indexOf(BASE + "_astro/") === 0) {
+    event.respondWith(
+      caches.match(req).then(function (hit) {
+        return hit || fetch(req);
+      })
+    );
+    return;
+  }
+
+  event.respondWith(
+    caches.match(req).then(function (hit) {
+      var network = fetch(req)
+        .then(function (res) {
+          if (res && res.ok) {
+            var copy = res.clone();
+            caches.open(CACHE).then(function (cache) {
+              cache.put(req, copy).then(function () {
+                caches.open(CACHE).then(function (bucket) {
+                  bucket.keys().then(function (keys) {
+                    if (keys.length > SCOPE_MAX) bucket.delete(keys[0]);
+                  });
+                });
+              });
+            });
+          }
+          return res;
+        })
+        .catch(function () {
+          return hit;
+        });
+      if (hit) {
+        event.waitUntil(network);
+        return hit;
+      }
+      return network;
+    })
+  );
+});
+`;
+	return new Response(sw, {
+		headers: { "Content-Type": "text/javascript; charset=utf-8" },
+	});
+};