公開網站會將選定的 Dokki 資源轉換為可瀏覽的網站。可用於產品文件、公開指南、知識庫、報告及其他已核准的資訊。
建立網站
開啟 工作區 → 擴充功能 → 發佈。
選擇網站地址並開啟網站。
發佈訪客應能開啟的資源。
在登出視窗中開啟公開地址並檢視網站。
組織訪客體驗
使用 外觀 選擇首頁行為並新增標籤式導覽。使用 內容 控制哪些資源可用。使用 網站設定 進行地址、列表、語言和自訂域名的設定。
已列出和未列出的網站
已列出的網站可以出現在支援的探索表面(例如網站的網站地圖)中。
未列出的網站仍可由擁有其直接連結的人開啟,但會被排除在正常的探索和搜尋索引訊號之外。
當存取必須限制於指定人員時,請使用工作區或資源共用,而非未列出的公開網站。
保持網站最新
當已發佈的資源變更時,其狀態會變為 已更新。檢閱變更並提交新的公開版本。如果狀態為 未知,請在發佈前重試,以免依據不完整的資訊行動。
語言與域名
網站設定可以提供其他公開語言並連接自訂域名。請先設定預設網站,然後新增這些選項,並從訪客的角度進行驗證。
將已發佈的 Markdown 鏡像到 GitHub
在 網站設定 → GitHub 同步 中,連接 GitHub,選擇存放庫、分支,
以及可選的基礎路徑,然後在選擇 立即同步 前儲存。工作區的
編輯者和管理員可以在工作區方案允許 Sites 時執行同步。
也可以啟用自動同步,以供日後發佈的更新使用。
Dokki 會產生一個 README.md 索引,以及每個目前已
發佈資源的 Markdown 檔案。這些檔案遵循已發佈的資源樹,並包含
規範來源中繼資料及 generated_by: Dokki。同步會更新變更的
產出檔案,保持相同的檔案不變,且僅在過時的 Markdown 帶有該產生標記時才將其移除;不相關的存放庫檔案不屬於清理範圍。
GitHub 存放庫是已凍結的已發佈內容的鏡像,而非編輯
來源。請在 Dokki 中編輯和發佈,然後再次同步。對產生的
Markdown 的直接編輯可能會在後續同步時被覆寫。
分享網站之前
檢查每個導覽項目和重要連結。
在桌面和窄螢幕上檢視網站。
確認未包含私人名稱、註解、憑證或草稿內容。
每次重要更新後再次檢查公開頁面。
