Skip to Content
文件使用手冊靜態站發布

靜態站發布

文章寫完了,發到公衆號、知乎、掘金——但這些都是「租來的」地方。想不想讓內容有一個屬於自己的、可被長期存取的「家」?

TouGaoYa 的靜態站發布功能,讓這件事像點一個按鈕那麼簡單:連接倉庫,自動搭建網站,一鍵發布上線。

原理簡述

  • TouGaoYa 會基於 VitePress 範本自動搭建站點腳手架
  • 發布時透過 GitHub 提交內容,由 GitHub Actions 自動構建並部署到 GitHub Pages
  • 你不需要在本地安裝任何構建工具

創建站點

在 設定 → 站點發布 中創建站點目標:

  1. 選擇或創建一個 GitHub 倉庫
  2. 指定目標分支與站點主題(內置兩套主題可選)
  3. 保存後 TouGaoYa 自動初始化腳手架並開啓站點

站點發布設定

發布文章

  • 在編輯器「更多 → 發布到站點」中選擇目標站點
  • 也可以在「文章信息」面板中爲文章配置站點目標(如固定 slug、草稿狀態)
  • 發布後,GitHub Actions 自動構建,上線後在「歷史」面板可查看線上地址與構建進度

站點發布歷史

文章信息與站點映射

  • 每篇文章可以在「文章信息」中設定站點發布塊:slug、摘要、發布日期、草稿狀態
  • 摘要自動作爲站點頁面的描述,發布時間可指定
  • 標記爲草稿的文章不會被發布

常見問題

首次發布失敗,提示部署被拒絕?

TouGaoYa 會自動把站點分支加入 GitHub Pages 的部署分支策略;如果手動調整過倉庫設定導致拒絕,可在倉庫設定中檢查 GitHub Pages 的部署分支是否包含站點分支。

可以自訂站點外觀嗎?

可以。腳手架文件由 TouGaoYa 管理,但你的首頁與文章是自由的;也可以基於 VitePress 官方主題自行擴充。


關聯閱讀:雲同步與換機 — 站點配置也隨工作區同步。

最後更新於