From a6f0b7c6d105a8bd41998a8a3b066d5e60fc7edb Mon Sep 17 00:00:00 2001 From: hanyixuanten Date: Sun, 25 Oct 2026 11:37:28 +0000 Subject: [PATCH] docs: use native [[ ]] wiki links for cross-page references --- CMS-Bot.md | 2 +- Content-Format.md | 2 +- Deployment.md | 6 +++--- Home.md | 14 +++++++------- Quick-Start.md | 2 +- _Sidebar.md | 14 +++++++------- 6 files changed, 20 insertions(+), 20 deletions(-) diff --git a/CMS-Bot.md b/CMS-Bot.md index 1983e1f..0bfd8e3 100644 --- a/CMS-Bot.md +++ b/CMS-Bot.md @@ -52,7 +52,7 @@ Pages 项目 → Settings → Variables and Secrets（Production 与 Preview 都 | `GITHUB_OWNER` | 仓库所有者（用户名或组织名） | | `GITHUB_REPO` | 仓库名 | -可选覆盖项见 [部署](https://github.com/Vb-Lg/class-history-template/wiki/Deployment) 的环境变量总表。 +可选覆盖项见 [[Deployment]] 的环境变量总表。 ## 四、验证 diff --git a/Content-Format.md b/Content-Format.md index 8dc955a..314b874 100644 --- a/Content-Format.md +++ b/Content-Format.md @@ -51,4 +51,4 @@ cover: /pages/static/sports-day.png 文章引用的图片、音视频放 `public/pages/static/`，正文以 `/pages/static/文件名` 引用。投稿表单上传的封面图也会由后端提交到该目录。 -以上三类内容也都可以不经过表单、直接改文件提交——投稿表单只是给同学用的便捷入口（见 [cms-bot 使用教程](https://github.com/Vb-Lg/class-history-template/wiki/CMS-Bot)）。 +以上三类内容也都可以不经过表单、直接改文件提交——投稿表单只是给同学用的便捷入口（见 [[CMS-Bot]]）。 diff --git a/Deployment.md b/Deployment.md index aef7ccd..1fdea13 100644 --- a/Deployment.md +++ b/Deployment.md @@ -17,8 +17,8 @@ Cloudflare Dashboard → Workers & Pages → Create → Pages → Connect to Git `functions/` 目录会被自动部署为 Pages Functions，无需额外配置： -- `POST /api/submit` —— 投稿 → GitHub PR（需配置 [cms-bot](https://github.com/Vb-Lg/class-history-template/wiki/CMS-Bot)） -- `GET/POST /api/messages` —— 留言墙（需绑定 D1，见 [留言墙](https://github.com/Vb-Lg/class-history-template/wiki/Message-Board)） +- `POST /api/submit` —— 投稿 → GitHub PR（需配置 [[CMS-Bot]]） +- `GET/POST /api/messages` —— 留言墙（需绑定 D1，见 [[Message-Board]]） ## 4. 环境变量总表 @@ -37,7 +37,7 @@ Cloudflare Dashboard → Workers & Pages → Create → Pages → Connect to Git | `MEDIA_DIR` | | 上传文件目录，默认 `public/pages/static` | | `MEDIA_URL_PREFIX` | | 上传文件 URL 前缀，默认 `/pages/static` | | `SONGS_DIR` | | 歌曲目录，默认 `src/songs` | -| `TURNSTILE_SECRET_KEY` | | Turnstile 私钥，见 [Turnstile](https://github.com/Vb-Lg/class-history-template/wiki/Turnstile) | +| `TURNSTILE_SECRET_KEY` | | Turnstile 私钥，见 [[Turnstile]] | | `PUBLIC_TURNSTILE_SITE_KEY` | | Turnstile 站点 key（**构建时**变量，需加入构建环境） | 不配置 GitHub 相关变量时：站点正常浏览，仅投稿功能不可用。 diff --git a/Home.md b/Home.md index d046167..769bf6b 100644 --- a/Home.md +++ b/Home.md @@ -8,18 +8,18 @@ - 📖 **班史列表 / 文章页**：`src/content/*.md` 自动生成，按日期升序排列，支持封面、摘要、上下篇导航 - 🎵 **班级歌单**：`src/songs/*.json` 自动生成，支持每日随机排序、随机抽歌 - 💬 **留言墙**：Cloudflare D1 数据库存储 -- 📝 **在线投稿**：班史 / 音乐两种表单，提交后由 [cms-bot](https://github.com/Vb-Lg/class-history-template/wiki/CMS-Bot) 自动建分支并发 PR，管理员审核合并后自动发布 +- 📝 **在线投稿**：班史 / 音乐两种表单，提交后由 [[CMS-Bot]] 自动建分支并发 PR，管理员审核合并后自动发布 ## 文档导航 | 页面 | 内容 | | --- | --- | -| [快速开始与定制](https://github.com/Vb-Lg/class-history-template/wiki/Quick-Start) | 本地开发、班级信息定制、删除示例内容 | -| [内容格式](https://github.com/Vb-Lg/class-history-template/wiki/Content-Format) | 班史文章 / 歌曲的文件格式与字段说明 | -| [部署到 Cloudflare Pages](https://github.com/Vb-Lg/class-history-template/wiki/Deployment) | 构建配置、环境变量总表 | -| [cms-bot 使用教程](https://github.com/Vb-Lg/class-history-template/wiki/CMS-Bot) | 投稿机器人的创建、安装与配置 | -| [留言墙（D1）](https://github.com/Vb-Lg/class-history-template/wiki/Message-Board) | D1 数据库建表与绑定 | -| [Turnstile 人机验证](https://github.com/Vb-Lg/class-history-template/wiki/Turnstile) | 投稿表单人机验证（可选） | +| [[Quick-Start]] | 本地开发、班级信息定制、删除示例内容 | +| [[Content-Format]] | 班史文章 / 歌曲的文件格式与字段说明 | +| [[Deployment]] | 构建配置、环境变量总表 | +| [[CMS-Bot]] | 投稿机器人的创建、安装与配置 | +| [[Message-Board]] | D1 数据库建表与绑定 | +| [[Turnstile]] | 投稿表单人机验证（可选） | ## 相关链接 diff --git a/Quick-Start.md b/Quick-Start.md index 3ec4641..1d90d8e 100644 --- a/Quick-Start.md +++ b/Quick-Start.md @@ -28,4 +28,4 @@ npm run dev # http://localhost:4321 - `src/songs/20250101-example.json` —— 示例歌曲 - `public/pages/static/cover-placeholder.svg` —— 占位封面（可保留备用） -正式写内容请看 [内容格式](https://github.com/Vb-Lg/class-history-template/wiki/Content-Format)。 +正式写内容请看 [[Content-Format]]。 diff --git a/_Sidebar.md b/_Sidebar.md index 6746083..6ec1ccf 100644 --- a/_Sidebar.md +++ b/_Sidebar.md @@ -1,12 +1,12 @@ **班史模板 · 文档** -- [首页](https://github.com/Vb-Lg/class-history-template/wiki) -- [快速开始与定制](https://github.com/Vb-Lg/class-history-template/wiki/Quick-Start) -- [内容格式](https://github.com/Vb-Lg/class-history-template/wiki/Content-Format) -- [部署到 Cloudflare Pages](https://github.com/Vb-Lg/class-history-template/wiki/Deployment) -- [cms-bot 使用教程](https://github.com/Vb-Lg/class-history-template/wiki/CMS-Bot) -- [留言墙（D1）](https://github.com/Vb-Lg/class-history-template/wiki/Message-Board) -- [Turnstile 人机验证](https://github.com/Vb-Lg/class-history-template/wiki/Turnstile) +- [[Home]] +- [[Quick-Start]] +- [[Content-Format]] +- [[Deployment]] +- [[CMS-Bot]] +- [[Message-Board]] +- [[Turnstile]] ---