Atlas 如何運作
以一頁說明組織、網站、環境、網站合約、發布與內容傳遞。
本頁翻譯自英文。若內容有任何差異,以英文版為準。 閱讀英文版
| 概念 | 說明 |
|---|---|
| 組織 | 您的公司。組織擁有網站、成員及其方案。 |
| 網站 | 一個網站。內容、媒體、成員的存取權限與設定絕不會在網站之間互通。 |
| 環境 | 每個網站都有 Development 與 Production 兩個環境。您在 Development 中作業;Production 只提供已核准的發行版本。 |
| 網站合約 | 以 JSON 描述您的網站:其元件與具型別的欄位、頁面類型、集合、頁首/頁尾全域內容、媒體設定檔與設計代碼(design tokens)。 |
| 頁面 | 網站上的一個路由(例如 /about),由多個區塊組成。每個區塊是網站合約中的一個元件,並帶有其欄位值。 |
| 項目 | 集合中的一筆內容,例如一項產品或一篇新聞文章。 |
| 全域內容 | 在多個頁面之間共用的內容,例如網站的頁首與頁尾。 |
| 傳遞權杖 | 僅限伺服器端使用的權杖,供您的網站讀取某個環境中已發布的內容。 |
內容如何送達您的網站
Section titled “內容如何送達您的網站” Editor in Studio ──draft──▶ Atlas (Development) ──publish──▶ published revision │ your website server ◀── Delivery API (HTTPS, delivery token) │ your components render it ──▶ visitors- 您的開發人員在網站合約中描述網站。網站管理員在 Studio 中啟用它。
- 編輯者以草稿建立與修改頁面和項目。草稿絕不會出現在公開網站上。
- 編輯者在您實際的網站設計中預覽草稿,然後發布。每次發布都是不可變更的修訂版本,因此可以還原。
- 您的網站僅從伺服器端程式碼,使用傳遞權杖透過 Delivery API 讀取已發布的內容。
- 發布時,Atlas 會傳送已簽署的 Webhook,讓您的網站只重新整理受影響的頁面。
Development 與 Production
Section titled “Development 與 Production”- 每個新網站都從 Development 開始。內容在此編輯與發布。
- Production 預設為關閉,須在發行版本通過所有檢查、且具核准權限的人員核准後,由網站管理員開啟。
- Production 只提供其正式上線、已簽署的發行版本:即已核准內容的凍結快照。在下一個已核准的發行版本之前,編輯 Development 不會改變 Production。
- 在 Studio 中切換環境只會改變您目前檢視的對象,絕不會改變內容。
延伸閱讀:Development 與 Production。
您的網站必須做的事
Section titled “您的網站必須做的事”Atlas 不會在您的網站上執行。您的開發人員需要加入少量程式碼:
- 供 Delivery API 使用、僅限伺服器端的用戶端;
- 透過您現有的元件算繪各區塊;
- 備援內容:若 Atlas 無法連線,或某個頁面尚無已發布內容,網站會提供其內建內容;
- 草稿預覽路由、Webhook 接收端與建置回報。
連接指南會逐一說明這些項目。