帮助
GitPress 是什么?
GitPress 是一个博客后台。你像用 WordPress 一样登录、写文章;正文存在你自己的 GitHub 仓库里;保存后自动编成静态网页,挂在 GitHub Pages 上。gitpress.net 只是遥控器,读者打开的不是我们的服务器。
它不是又一个静态站点生成器。Hugo、VitePress 那样的工具是你自己安装、自己在命令行里编站;GitPress 把「写」放进网页后台,把「编」放进你的 GitHub Actions。
只想开一个站? 从创建我的博客开始。想搞清稿子会不会被平台扣住,往下看。
适合谁
- 想写个人博客,不想每年续服务器、迁数据库、给域名重新解析。
- 不想把稿子存在某个平台的库里,哪天走还得「申请导出」。
- 能有一个 GitHub 账号就行,不必自己搭 Hugo 或 VitePress。
和别的工具差在哪
- WordPress:后台手感接近。差别是稿子和读者看到的网页都不住在我们服务器上,而在你的 GitHub。
- Hugo / VitePress:都是把 Markdown 编成静态站。它们是你本机或 CI 里跑的生成器;GitPress 是给你一个网页后台,生成器跑在你仓库的 Actions 里。
- 常见博客平台:走的时候带走的是仓库,不是申请一份导出。平台关了,少的是这个后台,不是文章。
这个项目为什么会出现
我之前有一个 WordPress 个人博客,大概用了五六年。每年都要重新买服务器(新购服务器在价格上会便宜很多)、做迁移、再给域名做解析。 累,而且会一再发生。
有一次忘了续服务器、也没做迁移。几年博客的数据全部遗失。如果没有更一劳永逸的办法,这种又累、又可能再来一次的事还会发生。于是我去找相关项目。
Hugo 以及一系列 SSG(静态站点生成器)都能编出网站,但使用上的心智成本和操作成本都不低。
后来遇到 Gridea。数据保存在电脑上,必须坐在电脑前写,不能随时随地写,就弃用了。它后来出了网页版,但又收费、又有限制,还不如本地版。本质没变:文章数据依然不够安全。
为了解决这个史诗级大难题——而现在市面上的开源工具已经够撑起这样一套——我开始做架构。用了单博客双仓库等设计。还有很多架构上的设计此处不展开细说,如果有需要可以把源码仓库 fork 下来让 AI 帮助你了解。
首版用 Fable 5 写。仅第一次让 AI 跑 plan 就花了 200 元。有一说一,Fable 5 是真贵。后面又多轮加功能、改问题,才有现在这版。
所以现在你每天用的是后台。真正撑起站点的,是你 GitHub 上的两个仓库,再加上源码公开的后台、以及 MIT 开源的主题和构建工具。后台只是遥控器。
三块分别管什么
对应三件事:稿子在哪、长什么样、点保存之后谁在编。不用先去读仓库 README。
主仓库 · 你每天点的网站
tap6/GitPress.net
WordPress 式后台:登录、建仓、写稿、点保存。我们替你调 GitHub API,Postgres 里没有正文。源码公开(PolyForm Shield),可自用。关停了,你少的是这个后台,不是文章。
在 GitHub 打开 →
博客长什么样
tap6/gitpress
内置主题、文章 Markdown 怎么写、gitpress.json 是什么意思。换主题或自己做主题,都认这份约定。数据仓模板也在这里。
在 GitHub 打开 →
点保存之后谁在干活
tap6/build-action
从你的私有数据仓读内容,编成静态站,推进公开网站仓。跑在 GitHub 上,不跑在 gitpress.net 的机器上。
在 GitHub 打开 →
关停了怎么办
不是「导出再搬家」。正文、图片、草稿从来没进我们的库,本来就在你的私有数据仓;读者看到的 HTML 在你的公开网站仓。用同一份 gitpress 主题和 build-action,在 GitHub 上继续编即可。平台没了,少的是遥控器,不是稿子。