Dokki Docs logo

公開網站

公開網站會將選定的 Dokki 資源轉換為可瀏覽的網站。可用於產品文件、公開指南、知識庫、報告及其他已核准的資訊。

建立網站

  • 開啟 工作區 → 擴充功能 → 發佈

  • 選擇網站地址並開啟網站。

  • 發佈訪客應能開啟的資源。

  • 在登出視窗中開啟公開地址並檢視網站。

組織訪客體驗

使用 外觀 選擇首頁行為並新增標籤式導覽。使用 內容 控制哪些資源可用。使用 網站設定 進行地址、列表、語言和自訂域名的設定。

已列出和未列出的網站

  • 已列出的網站可以出現在支援的探索表面(例如網站的網站地圖)中。

  • 未列出的網站仍可由擁有其直接連結的人開啟,但會被排除在正常的探索和搜尋索引訊號之外。

當存取必須限制於指定人員時,請使用工作區或資源共用,而非未列出的公開網站。

保持網站最新

當已發佈的資源變更時,其狀態會變為 已更新。檢閱變更並提交新的公開版本。如果狀態為 未知,請在發佈前重試,以免依據不完整的資訊行動。

語言與域名

網站設定可以提供其他公開語言並連接自訂域名。請先設定預設網站,然後新增這些選項,並從訪客的角度進行驗證。

將已發佈的 Markdown 鏡像到 GitHub

網站設定 → GitHub 同步 中,連接 GitHub,選擇存放庫、分支,
以及可選的基礎路徑,然後在選擇 立即同步 前儲存。工作區的
編輯者和管理員可以在工作區方案允許 Sites 時執行同步。
也可以啟用自動同步,以供日後發佈的更新使用。

Dokki 會產生一個 README.md 索引,以及每個目前已
發佈資源的 Markdown 檔案。這些檔案遵循已發佈的資源樹,並包含
規範來源中繼資料及 generated_by: Dokki。同步會更新變更的
產出檔案,保持相同的檔案不變,且僅在過時的 Markdown 帶有該產生標記時才將其移除;不相關的存放庫檔案不屬於清理範圍。

GitHub 存放庫是已凍結的已發佈內容的鏡像,而非編輯
來源。請在 Dokki 中編輯和發佈,然後再次同步。對產生的
Markdown 的直接編輯可能會在後續同步時被覆寫。

分享網站之前

  • 檢查每個導覽項目和重要連結。

  • 在桌面和窄螢幕上檢視網站。

  • 確認未包含私人名稱、註解、憑證或草稿內容。

  • 每次重要更新後再次檢查公開頁面。