Echora

内容保存后怎样更新网站#

flowchart LR
  A[Pages CMS 保存] --> B[内容仓 main 提交]
  B --> C[Actions 请求构建]
  C --> D[Cloudflare 读取代码和内容]
  D --> E[构建成功，更新博客]

CMS 是 GitHub 文件的编辑界面，没有另建文章数据库。内容仓的工作流请求 Cloudflare 重建，构建时读取内容仓 main 的最新版本。代码仓修改也会触发构建。

保存成功不等于已经发布成功。先看内容仓 Actions 是否成功发出请求，再看 Cloudflare 的部署是否成功。耗时取决于排队和构建；失败时通常继续提供上一次成功版本。短时间连续保存可能触发多次构建。

发布和修改文章#

在 Pages CMS 选择内容仓 echora-blog-content，分支保持 main，打开「文章」。

1. 点击 Add an entry，填写标题、发布日期、摘要、分类和标签。
2. Filename 使用简短英文和连字符，例如 cloudflare-notes.md。文章发布后尽量不改文件名，它决定文章链接。
3. 在正文框粘贴 Markdown。标题等信息已有表单字段，正文不需要再粘贴顶部的 --- 元信息。
4. 写作期间保持「草稿」开启。准备发布时关闭它，再点 Save。
5. 更新已有文章时，打开列表中的文章，修改后 Save。

正文采用 Markdown 文本输入，以保留主题的代码块、视频和其他扩展语法。系列先在「文章系列」创建，文章的「所属系列」填写系列文件名对应的 slug，例如 cloudflare-notes。

直接上传 Markdown 的模板#

在内容仓的 content/posts/ 新增 .md 文件，使用下面的标题头。修改日期、标题和摘要后写正文；草稿开启时不会出现在博客。

1
---
2
title: 在这里填写标题
3
published: 2026-10-05
4
description: 简短说明这篇文章写了什么
5
tags: [实践记录]
6
category: 实践记录
7
lang: zh_CN
8
draft: true
9
pinned: false
10
encrypted: false
11
hideHomeContent: true
12
---

updated 可在实际更新时添加；没有更新日期时省略。series、seriesOrder、封面 image 等按需增加。模板目录还保留普通和加密文章模板。

设置文章密码#

文章表单中开启「加密文章」，填写「文章密码」，建议保持「隐藏加密文章的正文预览」开启。密码提示是公开信息，不要把真实密码写进提示。

直接编辑 Markdown 时增加：

1
encrypted: true
2
password: "替换成你自己的密码"
3
passwordHint: "可选的提示，不包含密码"
4
hideHomeContent: true

开启加密却没有密码会使构建失败。取消加密需要同时清空密码并关闭开关；直接编辑文件时可删除 password、passwordHint，并设 encrypted: false。

源文件中的正文和密码仍然由私有内容仓保存；浏览器获得的是构建后的加密正文。标题、摘要、封面和图片链接不会因此加密，已上传图片也仍可能直接访问。自己的浏览器可能保留本次解锁状态，检查密码入口时可使用无痕窗口。

添加友链和修改个人信息#

打开「友链」，用 Add an item 添加条目，填写唯一整数编号、名称、完整网站地址、头像地址、简介和标签。头像可粘贴图床直链，也可使用 /uploads/文件名；拖动条目调整顺序，最后 Save。

友链页面已开启，以后可在「站点基本设置 → 页面开关 → 友链」显示或隐藏。原有主题参考条目保留，按需替换。

「站点基本设置」管理站名、横幅、头像、简介、公告和页面开关。「项目」「游戏」「书架」「站点罗盘」「本地曲目」分别管理对应列表；「动态」「关于页」「文章系列」管理 Markdown 内容。启用音乐还需检查代码仓的播放器开关。

设备、番剧、技能和时间线的现有数据位于内容仓 data/。这些文件目前没有专用 CMS 表单，可以通过 GitHub 文件编辑或本机编辑维护；文件顶部的类型说明和现有条目可作为模板。

图片与相册#

文章配图先上传到独立图床，建议放在 blog/posts/文章名 目录，复制图片直链，再写入正文：

1
![图片说明](https://你的图床/图片直链)

也可从 CMS 左侧「上传文件」选择本机图片，正文引用 /uploads/文件名.png。两种方式都需要保存引用图片的文章；单独上传图床文件不会自动生成文章。

相册的内容清单位于 public/images/albums/相册ID/info.json，现阶段在 GitHub 或本机维护。外链相册可引用图床目录中的图片，但图床新增图片暂时不会自动更新清单。目录自动同步和上传笔记时自动替换图片链接是后续计划。

本机编辑和回退#

本机编辑前先同步内容仓，避免覆盖 CMS 的新修改。只编辑正式内容目录中的文件，不编辑代码仓里构建生成的副本。

需要撤回内容修改时，在内容仓撤销相应提交，再等待重新部署。Cloudflare 的部署回退只能暂时恢复网站版本，不会改变仓库内容；后续构建还会读取 main。

GitHub、Cloudflare 和图床的访问密钥不能写进文章或仓库。读取私有内容仓的凭据会到期，需要届时更新 Cloudflare Secret；日常写文章不需要接触这些凭据。

参考#

• Pages CMS 内容与字段配置
• Cloudflare Pages 部署挂钩
• 图床上传 API