@windcoder/astro-theme-orchid 0.4.4 → 0.4.5

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@windcoder/astro-theme-orchid",
-	"version": "0.4.4",
+	"version": "0.4.5",
 	"description": "清新简约的 Astro 博客主题，以 Integration 形式提供，支持版本化升级与组件覆盖",
 	"type": "module",
 	"keywords": [

package/src/components/PostResources.astro

@@ -0,0 +1,75 @@
+---
+/**
+ * 文章资源区：frontmatter resources（name/url/password）在正文后渲染资源卡。
+ * 按 url 域名识别品牌图标（gitee/github），其余地址用通用外链图标；
+ * password 有值时展示提取码。新地址类型无需改组件，直接复用 name/url 展示。
+ */
+import { t } from "../i18n/index.js";
+
+interface ResourceItem {
+	name: string;
+	url: string;
+	password?: string;
+}
+
+interface Props {
+	resources?: ResourceItem[];
+}
+
+const { resources } = Astro.props;
+const items = (resources ?? []).filter((r) => r.url && r.url.trim() !== "");
+
+type IconKind = "gitee" | "github" | "link";
+function iconFor(url: string): IconKind {
+	let host = "";
+	try {
+		host = new URL(url).hostname.replace(/^www\./, "");
+	} catch {
+		return "link";
+	}
+	if (host === "gitee.com") return "gitee";
+	if (host === "github.com") return "github";
+	return "link";
+}
+---
+
+{
+  items.length > 0 && (
+    <section class="post-resources card reveal" aria-label={t("postResources")}>
+      <h2 class="post-resources-title">
+        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M21 8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16Z"/><path d="m3.3 7 8.7 5 8.7-5"/><path d="M12 22V12"/></svg>
+        {t("postResources")}
+      </h2>
+      <ul class="post-resources-list">
+        {items.map((r) => {
+          const kind = iconFor(r.url);
+          return (
+            <li class="post-resources-item">
+              <a href={r.url} target="_blank" rel="noopener">
+                <span class="post-resources-icon" aria-hidden="true">
+                  {kind === "gitee" && (
+                    <svg viewBox="0 0 1024 1024" fill="currentColor"><path d="M512 1024C229.222 1024 0 794.778 0 512S229.222 0 512 0s512 229.222 512 512-229.222 512-512 512zm259.149-568.883h-290.74a25.293 25.293 0 0 0-25.292 25.293l-0.081 63.206c0 13.952 11.315 25.293 25.267 25.293h177.024c13.978 0 25.293 11.315 25.293 25.267v12.646a75.853 75.853 0 0 1-75.853 75.853h-240.23a25.293 25.293 0 0 1-25.267-25.293V417.203a75.853 75.853 0 0 1 75.827-75.853h353.946a25.293 25.293 0 0 0 25.267-25.292l0.077-63.207a25.293 25.293 0 0 0-25.268-25.293H417.152a189.62 189.62 0 0 0-189.62 189.645V771.15c0 13.977 11.316 25.293 25.294 25.293h372.94a170.65 170.65 0 0 0 170.65-170.65V480.384a25.293 25.293 0 0 0-25.267-25.267z"/></svg>
+                  )}
+                  {kind === "github" && (
+                    <svg viewBox="0 0 16 16" fill="currentColor"><path d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27s1.36.09 2 .27c1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.01 8.01 0 0 0 16 8c0-4.42-3.58-8-8-8z"/></svg>
+                  )}
+                  {kind === "link" && (
+                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"/><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"/></svg>
+                  )}
+                </span>
+                <span class="post-resources-name">{r.name}</span>
+                {r.password && r.password.trim() !== "" && (
+                  <span class="post-resources-password">
+                    {t("resourcePassword")}
+                    <code>{r.password}</code>
+                  </span>
+                )}
+                <svg class="post-resources-ext" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M15 3h6v6"/><path d="M10 14 21 3"/><path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"/></svg>
+              </a>
+            </li>
+          );
+        })}
+      </ul>
+    </section>
+  )
+}

package/src/i18n/en.ts

@@ -146,6 +146,9 @@ const en: Record<UiKey, string> = {
 		"No series yet. Add a series field to a post's frontmatter to create one.",
 	seriesProgress: "{cur} / {total}",
 	seriesCatalog: "Series catalog",
+	/* Post resources: resource card rendered from frontmatter resources */
+	postResources: "Related resources",
+	resourcePassword: "Code",
 	/* Music player (§4.36) */
 	musicOpen: "Music player",
 	musicClose: "Collapse player",

package/src/i18n/ja.ts

@@ -150,6 +150,9 @@ const ja: Record<UiKey, string> = {
 		"シリーズがまだありません。記事の frontmatter に series を記入すると作成できます。",
 	seriesProgress: "{cur} / {total}",
 	seriesCatalog: "シリーズ目次",
+	/* 記事リソース：frontmatter resources から描画されるリソースカード */
+	postResources: "関連リソース",
+	resourcePassword: "パスワード",
 	/* 音楽プレイヤー */
 	musicOpen: "音楽プレイヤー",
 	musicClose: "プレイヤーを閉じる",

package/src/i18n/ko.ts

@@ -149,6 +149,9 @@ const ko: Record<UiKey, string> = {
 		"아직 시리즈가 없습니다. 글 frontmatter에 series를 입력하면 생성됩니다.",
 	seriesProgress: "{cur} / {total}",
 	seriesCatalog: "시리즈 목차",
+	/* 게시글 리소스: frontmatter resources 로 렌더링되는 리소스 카드 */
+	postResources: "관련 자료",
+	resourcePassword: "추출 코드",
 	/* 음악 플레이어 */
 	musicOpen: "음악 플레이어",
 	musicClose: "플레이어 접기",

package/src/i18n/ru.ts

@@ -150,6 +150,9 @@ const ru: Record<UiKey, string> = {
 		"Серий пока нет. Заполните поле series в frontmatter записи, чтобы создать.",
 	seriesProgress: "{cur} / {total}",
 	seriesCatalog: "Содержание серии",
+	/* Ресурсы статьи: карточка из frontmatter resources */
+	postResources: "Материалы",
+	resourcePassword: "Код доступа",
 	/* Музыкальный плеер */
 	musicOpen: "Музыкальный плеер",
 	musicClose: "Свернуть плеер",

package/src/i18n/zh-CN.ts

@@ -166,6 +166,9 @@ const zhCN = {
 	seriesEmpty: "还没有专题，在文章 frontmatter 中填写 series 字段即可创建。",
 	seriesProgress: "{cur} / {total}",
 	seriesCatalog: "专题目录",
+	/* 文章资源区：frontmatter resources 渲染的资源卡 */
+	postResources: "相关资源",
+	resourcePassword: "提取码",
 	/* 音乐播放器（§4.36）：data-labels 经组件 data-labels 属性带入客户端 */
 	musicOpen: "音乐播放器",
 	musicClose: "收起播放器",

package/src/i18n/zh-TW.ts

@@ -145,6 +145,9 @@ const zhTW: Record<UiKey, string> = {
 	seriesEmpty: "還沒有專題，在文章 frontmatter 中填寫 series 欄位即可建立。",
 	seriesProgress: "{cur} / {total}",
 	seriesCatalog: "專題目錄",
+	/* 文章資源區：frontmatter resources 渲染的資源卡 */
+	postResources: "相關資源",
+	resourcePassword: "提取碼",
 	/* 音樂播放器 */
 	musicOpen: "音樂播放器",
 	musicClose: "收起播放器",

package/src/routes/posts/[...slug].astro

@@ -10,6 +10,7 @@ import EncryptedContent from "virtual:theme/components/EncryptedContent.astro";
 import License from "virtual:theme/components/License.astro";
 import OutdatedCard from "virtual:theme/components/OutdatedCard.astro";
 import PostNav from "virtual:theme/components/PostNav.astro";
+import PostResources from "virtual:theme/components/PostResources.astro";
 import RecommendedPost from "virtual:theme/components/RecommendedPost.astro";
 import Sidebar from "virtual:theme/components/Sidebar.astro";
 import Toc from "virtual:theme/components/Toc.astro";
@@ -303,6 +304,8 @@ const jsonLd = {
     {/* 过时提醒（§4.11）：许可卡之前展示；加密文章不渲染 */}
     {!d.password && <OutdatedCard updated={d.updated ?? d.published} published={d.published} />}
     <License licenseName={d.licenseName} licenseUrl={d.licenseUrl} enabled={d.license} />
+    {/* 文章资源区：frontmatter resources 非空时渲染；加密文章随正文语义一并隐藏 */}
+    {!d.password && <PostResources resources={d.resources} />}
     <PostNav prev={prev ?? undefined} next={next ?? undefined} />
   {/* 支持卡（P2）：打赏入口 + 分享海报（share-poster.ts 仍按 #qy-share-btn 与 data-* 绑定） */}
   {

package/src/schema.ts

@@ -1639,6 +1639,20 @@ export function definePostSchema(extensions: z.ZodRawShape = {}) {
 			 * 组名直接来自本字段文本，无 i18n 参与。
 			 */
 			seriesGroup: z.string().optional(),
+			/**
+			 * 文章相关资源：正文后渲染资源卡区。name 展示名、url 跳转地址、
+			 * password 提取码（可空）。按 url 域名识别品牌图标（gitee/github），
+			 * 其余地址类型直接复用通用外链图标展示，无需再改 schema。
+			 */
+			resources: z
+				.array(
+					z.object({
+						name: z.string(),
+						url: z.string(),
+						password: z.string().optional(),
+					}),
+				)
+				.optional(),
 		})
 		.extend(extensions);
 }

package/src/scripts/share-poster.ts

@@ -451,6 +451,8 @@ export async function openSharePoster(btn: HTMLElement) {
 			img.src = poster;
 			img.hidden = false;
 		}
+		/* 生成完成：移除 loading（否则转圈常驻在海报上方） */
+		modal.querySelector<HTMLElement>(".poster-loading")?.remove();
 		if (saveBtn) {
 			saveBtn.disabled = false;
 			saveBtn.addEventListener("click", () => {

package/src/styles/global.css

@@ -3339,6 +3339,94 @@ html.dark .outdated-warning {
 	border-radius: var(--radius-sm);
 	background: var(--bg-soft);
 }
+/* 文章资源区：frontmatter resources 渲染的资源卡（License 之后、上下篇之前） */
+.post-resources {
+	margin-top: 28px;
+	padding: 16px 20px;
+}
+.post-resources-title {
+	display: flex;
+	align-items: center;
+	gap: 8px;
+	margin: 0 0 10px;
+	font-size: 15.5px;
+	font-weight: 700;
+	color: var(--ink);
+}
+.post-resources-title svg {
+	width: 16px;
+	height: 16px;
+	color: var(--accent);
+}
+.post-resources-list {
+	list-style: none;
+	margin: 0;
+	padding: 0;
+	display: grid;
+	gap: 4px;
+}
+.post-resources-item a {
+	display: flex;
+	align-items: center;
+	gap: 10px;
+	padding: 7px 8px;
+	border-radius: var(--radius-sm);
+	font-size: 14px;
+	color: var(--ink-2);
+	transition: background 0.15s ease, color 0.15s ease;
+}
+.post-resources-item a:hover {
+	background: var(--bg-soft);
+	color: var(--accent-deep);
+}
+.post-resources-icon {
+	flex: none;
+	display: inline-flex;
+	width: 18px;
+	height: 18px;
+	color: var(--muted);
+}
+.post-resources-item a:hover .post-resources-icon {
+	color: var(--accent);
+}
+.post-resources-icon svg {
+	width: 100%;
+	height: 100%;
+}
+.post-resources-name {
+	min-width: 0;
+	overflow: hidden;
+	text-overflow: ellipsis;
+	white-space: nowrap;
+}
+.post-resources-password {
+	flex: none;
+	display: inline-flex;
+	align-items: center;
+	gap: 4px;
+	margin-left: auto;
+	font-size: 12.5px;
+	color: var(--muted);
+}
+.post-resources-password code {
+	padding: 1px 6px;
+	border-radius: 4px;
+	border: 1px solid var(--border);
+	background: var(--bg-soft);
+	font-size: 12px;
+	color: var(--ink-2);
+}
+.post-resources-ext {
+	flex: none;
+	width: 14px;
+	height: 14px;
+	color: var(--muted);
+	opacity: 0.6;
+}
+.post-resources-item a:hover .post-resources-ext {
+	color: var(--accent);
+	opacity: 1;
+}
 .post-nav {
 	margin-top: 24px;
 	display: grid;
@@ -5592,6 +5680,10 @@ a[data-encoded-email] {
 	height: auto;
 	border-radius: var(--radius-sm);
 }
+/* display:block 会覆盖 [hidden] 的 UA 样式，显式声明防生成前空框露出 */
+.poster-img[hidden] {
+	display: none;
+}
 .poster-loading {
 	display: flex;
 	align-items: center;