静态站发布

文章写完了，发到公众号、知乎、掘金——但这些都是「租来的」地方。想不想让内容有一个属于自己的、可被长期访问的「家」？

TouGaoYa 的静态站发布功能，让这件事像点一个按钮那么简单：连接仓库，自动搭建网站，一键发布上线。

原理简述

• TouGaoYa 会基于 VitePress 模板自动搭建站点脚手架
• 发布时通过 GitHub 提交内容，由 GitHub Actions 自动构建并部署到 GitHub Pages
• 你不需要在本地安装任何构建工具

创建站点

在 设置 → 站点发布 中创建站点目标：

1. 选择或创建一个 GitHub 仓库
2. 指定目标分支与站点主题（内置两套主题可选）
3. 保存后 TouGaoYa 自动初始化脚手架并开启站点

发布文章

• 在编辑器「更多 → 发布到站点」中选择目标站点
• 也可以在「文章信息」面板中为文章配置站点目标（如固定 slug、草稿状态）
• 发布后，GitHub Actions 自动构建，上线后在「历史」面板可查看线上地址与构建进度

文章信息与站点映射

• 每篇文章可以在「文章信息」中设置站点发布块：slug、摘要、发布日期、草稿状态
• 摘要自动作为站点页面的描述，发布时间可指定
• 标记为草稿的文章不会被发布

常见问题

首次发布失败，提示部署被拒绝？

TouGaoYa 会自动把站点分支加入 GitHub Pages 的部署分支策略；如果手动调整过仓库设置导致拒绝，可在仓库设置中检查 GitHub Pages 的部署分支是否包含站点分支。

可以自定义站点外观吗？

可以。脚手架文件由 TouGaoYa 管理，但你的首页与文章是自由的；也可以基于 VitePress 官方主题自行扩展。

关联阅读：云同步与换机 — 站点配置也随工作区同步。