文章
| 标题 | 分类 | 日期 | 状态 | 操作 |
|---|---|---|---|---|
| 加载中… | ||||
页面
| 标题 | 日期 | 状态 | 操作 |
|---|---|---|---|
| 加载中… | |||
编辑
媒体库
图片上传到仓库 content/media/年/月/ 目录。上传后可用「插入编辑器」把图片写入正在编辑的文章;「链接」复制本站地址(部署后自动读取当前域名),「删除」移除文件。
加载中…
站点设置
站点主题(配色)
主题 = themes/<名称>/ 目录: theme.json(信息/配色)、style.css(样式)、layout.tmpl(页面骨架)、home/post/page.tmpl(内容模板)。按文件名自动归类上传到当前选中的主题;缺文件时用内置默认。
模板语法: {{变量}} 转义输出、{{{变量}}} 原样输出、{{#posts}}…{{/posts}} 循环。
layout.tmpl 中可用 <div id="theme-head">…</div> 添加 <head> 内容(如字体 CDN)。
Giscus 评论(所有文章/页面自动生效)
需先在 GitHub 仓库启用 Discussions,并安装 Giscus App。点此打开 giscus.app 生成配置(Mapping 请选择 Specific,term 由系统自动传入)。
basePath(子目录部署)提示
站点部署在域名根路径时无需设置。若部署在子目录(如 https://域名/blog/),通过以下方式之一设置 BASE_PATH:
# 方式1: 直接改 config.js 的 basePath basePath: "/blog" # 方式2: 部署脚本用环境变量自动注入(不会改到本地文件) BASE_PATH=/blog node scripts/deploy.mjs github
⚠️ 注意: 该文件是公开的浏览器端配置,不要把 GitHub Token 等密钥写入。Token 仅保存在浏览器 localStorage。
一键部署
一键部署 → Cloudflare Pages
- 打开 deploy.html 部署向导,创建 GitHub 仓库并推送本项目。
- 登录 Cloudflare → Workers & Pages → 创建 → Pages → 连接你的 GitHub 仓库。
- 框架预设: None;构建命令: 留空;构建输出目录: /(根目录)。保存并部署。
- 部署完成后即可访问站点,文章编辑发布 = 推送到 GitHub = 自动上线。
Giscus 评论配置
1. GitHub 仓库 → Settings → Discussions 启用;
2. 安装 Giscus App;
3. 打开 giscus.app,选择仓库与分类,复制 repoId / categoryId 填入上方「设置」。