mirror of
https://github.com/Vb-Lg/class-history-template.git
synced 2026-11-03 17:36:47 +00:00
docs: use full canonical wiki URLs for all cross-page links
1 parent
537ac58b6e
commit
09dee9ebcd
6 files changed
+20
-20
No files matched your search
+1
-1
@@ -52,7 +52,7 @@ Pages 项目 → Settings → Variables and Secrets(Production 与 Preview 都
|
||||
| `GITHUB_OWNER` | 仓库所有者(用户名或组织名) |
|
||||
| `GITHUB_REPO` | 仓库名 |
|
||||
|
||||
可选覆盖项见 [部署](/Vb-Lg/class-history-template/wiki/Deployment) 的环境变量总表。
|
||||
可选覆盖项见 [部署](https://github.com/Vb-Lg/class-history-template/wiki/Deployment) 的环境变量总表。
|
||||
|
||||
## 四、验证
|
||||
|
||||
|
||||
+1
-1
@@ -51,4 +51,4 @@ cover: /pages/static/sports-day.png
|
||||
|
||||
文章引用的图片、音视频放 `public/pages/static/`,正文以 `/pages/static/文件名` 引用。投稿表单上传的封面图也会由后端提交到该目录。
|
||||
|
||||
以上三类内容也都可以不经过表单、直接改文件提交——投稿表单只是给同学用的便捷入口(见 [cms-bot 使用教程](/Vb-Lg/class-history-template/wiki/CMS-Bot))。
|
||||
以上三类内容也都可以不经过表单、直接改文件提交——投稿表单只是给同学用的便捷入口(见 [cms-bot 使用教程](https://github.com/Vb-Lg/class-history-template/wiki/CMS-Bot))。
|
||||
+3
-3
@@ -17,8 +17,8 @@ Cloudflare Dashboard → Workers & Pages → Create → Pages → Connect to Git
|
||||
|
||||
`functions/` 目录会被自动部署为 Pages Functions,无需额外配置:
|
||||
|
||||
- `POST /api/submit` —— 投稿 → GitHub PR(需配置 [cms-bot](/Vb-Lg/class-history-template/wiki/CMS-Bot))
|
||||
- `GET/POST /api/messages` —— 留言墙(需绑定 D1,见 [留言墙](/Vb-Lg/class-history-template/wiki/Message-Board))
|
||||
- `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))
|
||||
|
||||
## 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](/Vb-Lg/class-history-template/wiki/Turnstile) |
|
||||
| `TURNSTILE_SECRET_KEY` | | Turnstile 私钥,见 [Turnstile](https://github.com/Vb-Lg/class-history-template/wiki/Turnstile) |
|
||||
| `PUBLIC_TURNSTILE_SITE_KEY` | | Turnstile 站点 key(**构建时**变量,需加入构建环境) |
|
||||
|
||||
不配置 GitHub 相关变量时:站点正常浏览,仅投稿功能不可用。
|
||||
|
||||
+7
-7
@@ -8,18 +8,18 @@
|
||||
- 📖 **班史列表 / 文章页**:`src/content/*.md` 自动生成,按日期升序排列,支持封面、摘要、上下篇导航
|
||||
- 🎵 **班级歌单**:`src/songs/*.json` 自动生成,支持每日随机排序、随机抽歌
|
||||
- 💬 **留言墙**:Cloudflare D1 数据库存储
|
||||
- 📝 **在线投稿**:班史 / 音乐两种表单,提交后由 [cms-bot](/Vb-Lg/class-history-template/wiki/CMS-Bot) 自动建分支并发 PR,管理员审核合并后自动发布
|
||||
- 📝 **在线投稿**:班史 / 音乐两种表单,提交后由 [cms-bot](https://github.com/Vb-Lg/class-history-template/wiki/CMS-Bot) 自动建分支并发 PR,管理员审核合并后自动发布
|
||||
|
||||
## 文档导航
|
||||
|
||||
| 页面 | 内容 |
|
||||
| --- | --- |
|
||||
| [快速开始与定制](/Vb-Lg/class-history-template/wiki/Quick-Start) | 本地开发、班级信息定制、删除示例内容 |
|
||||
| [内容格式](/Vb-Lg/class-history-template/wiki/Content-Format) | 班史文章 / 歌曲的文件格式与字段说明 |
|
||||
| [部署到 Cloudflare Pages](/Vb-Lg/class-history-template/wiki/Deployment) | 构建配置、环境变量总表 |
|
||||
| [cms-bot 使用教程](/Vb-Lg/class-history-template/wiki/CMS-Bot) | 投稿机器人的创建、安装与配置 |
|
||||
| [留言墙(D1)](/Vb-Lg/class-history-template/wiki/Message-Board) | D1 数据库建表与绑定 |
|
||||
| [Turnstile 人机验证](/Vb-Lg/class-history-template/wiki/Turnstile) | 投稿表单人机验证(可选) |
|
||||
| [快速开始与定制](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) | 投稿表单人机验证(可选) |
|
||||
|
||||
## 相关链接
|
||||
|
||||
|
||||
+1
-1
@@ -28,4 +28,4 @@ npm run dev # http://localhost:4321
|
||||
- `src/songs/20250101-example.json` —— 示例歌曲
|
||||
- `public/pages/static/cover-placeholder.svg` —— 占位封面(可保留备用)
|
||||
|
||||
正式写内容请看 [内容格式](/Vb-Lg/class-history-template/wiki/Content-Format)。
|
||||
正式写内容请看 [内容格式](https://github.com/Vb-Lg/class-history-template/wiki/Content-Format)。
|
||||
+7
-7
@@ -1,12 +1,12 @@
|
||||
**班史模板 · 文档**
|
||||
|
||||
- [首页](/Vb-Lg/class-history-template/wiki/Home)
|
||||
- [快速开始与定制](/Vb-Lg/class-history-template/wiki/Quick-Start)
|
||||
- [内容格式](/Vb-Lg/class-history-template/wiki/Content-Format)
|
||||
- [部署到 Cloudflare Pages](/Vb-Lg/class-history-template/wiki/Deployment)
|
||||
- [cms-bot 使用教程](/Vb-Lg/class-history-template/wiki/CMS-Bot)
|
||||
- [留言墙(D1)](/Vb-Lg/class-history-template/wiki/Message-Board)
|
||||
- [Turnstile 人机验证](/Vb-Lg/class-history-template/wiki/Turnstile)
|
||||
- [首页](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)
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in new issue
Block a user