底稿、草稿和已发布

三种状态

本地底稿

编辑器自动写在这台浏览器里。没点保存之前,不上 GitHub,也不触发构建。换电脑或清掉站点数据就会没。

草稿 · 不公开

点「保存到仓库」后,文章进私有数据仓 content/posts/,frontmatter 带 draft: true。构建会跑,主题会把这篇滤掉,公开站点、RSS、导航里都没有。

已发布

同样写入私有仓并触发构建。日期已到的文章会出现在公开网站。日期还在未来的,构建时仍会排除。比较的是世界上的某一个瞬间(保存时带上你所在时区的偏移),公开页按站点时区显示。

控制台预览

草稿和还没出现在公开站上的文章,可以在文章列表或编辑页点「预览」。那是登录后的阅读页,看起来像一篇网站文章,但不会套用当前 Astro 主题,路人也打不开。已发布且公开地址可用时,预览顶栏另有「打开公开页」。

点保存之后发生了什么

1. 后台把 Markdown 提交到你的私有数据仓库。
2. 这次 push 触发 GitHub Actions 构建。
3. 主题只收录「已发布且日期已到」的文章,编进公开网站仓库。
4. GitHub Pages(或你接的托管)更新公开站点。

定时发布

默认关着。关着时不能把文章日期选到现在之后。要预约上线,到设置 → 定时发布打开检查。能接受粗一点的延迟就选更长的间隔,更省 Actions;单站多数情况建议每 2 小时。同一个 GitHub 帐户下的多个站共用免费时长,叠得太满时保存前会请你确认。

• 保存文章会立刻构建一次;没到日期时,公开站点仍看不到这篇。
• 打开后,GitHub 按你选的间隔自己再构建。某一轮跑的时候日期已经过了,文章才会出现。
• 这是检查间隔,不是对准文章上的那一分钟。到点后最多再等一个间隔;GitHub 忙时还可能再偏一会儿。设置里有各档占用图,也可以按每月大概保存几次估一下还剩多少给点保存。打字不耗 Actions。
• 改期只改文章日期,不用再改设置。
• 关掉之前,要先处理还没到日期的已发布稿(改成现在、改成草稿,或等它们上线)。

页面没有草稿

About 这类独立页保存后就会出现在公开站点。想先写后发,先写在文章里当草稿,或先不链进菜单。