處理內容

本頁內容

使用 EmDash 管理後台將條目從初稿推進到已發布頁面。編輯器將 草稿變更與訪客可見的版本分開儲存,因此儲存與發布是兩個 不同的操作。

開啟集合

開啟站點上的 /_emdash/admin 並登入。在側邊欄中選擇集合,例如 Posts 或 Pages。

集合頁面列出其條目。在此你可以:

  • 選擇 Add New 建立條目;
  • 按條目標題、slug 以及標記為 searchable 的欄位搜尋;
  • 按發布狀態、作者、署名、日期與地區設定篩選;
  • 選擇條目以大量發布、退回草稿或移至回收筒;以及
  • 開啟 Trash 以還原或永久刪除條目。

編輯器中可用的欄位與發布功能取決於集合的內容模型。 例如,集合可能支援修訂、預覽、分類法或搜尋。

建立並發布條目

  1. 在集合頁面上選擇 Add New。

  2. 填寫必填欄位。若集合有標題欄位,EmDash 會用它建議 slug。你可以在發布前編輯 slug。

  3. 新增正文以及任何輔助欄位,例如摘要、特色圖片、署名、分類 或標籤。

  4. 選擇 Save。首次儲存會將條目建立為草稿,並開啟其永久編輯器 URL。

  5. 審閱草稿。若集合支援預覽,選擇 Preview 以在發布前查看 轉譯後的頁面。

  6. 選擇 Publish now,然後確認。已儲存的草稿成為公開內容查詢回傳的 線上版本。

條目具有穩定的內容 ID 與單獨的 slug。若 slug 變更,ID 仍識別同一條目。 範本通常使用 getEmDashCollection() 回傳的面向 URL 的識別碼; 查詢內容指南 解釋這兩個值。

撰寫富文字

Portable Text 欄位提供區塊編輯器,用於標題、段落、引用、列表、連結、 圖片、圖庫、程式碼區塊、表格、HTML 區塊與可重用分區。已安裝的外掛可 新增更多區塊。

使用工具列格式化所選文字。要插入區塊,請選擇段落旁的新增區塊控制項, 或輸入 / 並按名稱搜尋區塊。圖片與圖庫區塊開啟與圖片欄位相同的媒體 選擇器。

選擇圖片區塊時,其設定可讓你取代或移除該圖片的此次使用,並設定 顯示尺寸、對齊、替代文字、說明與可選工具提示。Edit asset 開啟 底層媒體庫項目,在那裡變更或取代資源可能影響使用它的其他條目。 見媒體庫了解該區別。

儲存草稿變更

首次儲存後,編輯器會在你停止輸入兩秒後自動儲存變更。Save 按鈕 會經過 Saving… 變為 Saved,以便你確認伺服器已接受 草稿。自動儲存會取代目前自動儲存修訂,而不是為每次停頓在修訂歷史中填入 檢查點。

當你希望編輯序列中的某一時刻保留在修訂歷史中時,選擇 Save。若 儲存失敗,編輯器會保留未儲存的欄位並顯示錯誤。在按鈕回到 Saved 或你已將未儲存的工作複製到別處之前,請勿離開頁面。

對於已發布的條目,儲存變更僅更新其草稿。訪客仍會收到 先前的線上修訂。使用 Preview draft 檢查待定版本,使用 Live View 檢查 公開版本,並在草稿準備好取代它時使用 Publish changes。

變更已發布條目的 slug 遵循相同的草稿流程。公開 URL 在你 發布草稿時變更,而不是在自動儲存執行時。

與另一位編輯者協作

開啟條目會為該條目與地區設定取得編輯鎖定。若另一人已將其 開啟,EmDash 會識別鎖定持有者並提供兩個選擇:

  • Open read-only 顯示條目但不接受編輯,因此你不會輸入將被 丟棄的工作。
  • Take over 將鎖定交給你。對方保留已輸入內容,但在兩分鐘內 其編輯器會報告你持有該條目。對方的下一次儲存會被拒絕。

鎖定在條目開啟期間會續期,並在你離開編輯器或關閉分頁時釋放。 若瀏覽器或電腦在未釋放的情況下關閉,鎖定會在其最後一次續期後 七分鐘過期。

每個地區設定的鎖定是獨立的,因此兩人可以編輯同一條目的不同翻譯。 指令碼或 API 用戶端在另一位編輯者持有鎖定時也會被拒絕,除非使用 已記錄的覆寫。完整 API 行為見條目編輯鎖定。

管理員可在 Content Types、然後該集合、然後 Edit locking 下關閉集合的鎖定。

發布或排程變更

發布與排程使用分開的控制項:

  • Publish now 在確認後使新草稿上線。
  • Publish changes 在確認後使已發布條目的待定變更上線。
  • Schedule 設定新條目或待定變更何時上線。
  • Change schedule 更新現有排程。
  • Remove schedule 取消現有排程。
  • Unpublish 從公開查詢中移除線上修訂,取消任何排程,並保留 可編輯草稿。

要排程條目,請先儲存,在發布摘要下方選擇 Schedule,並選擇將來的 日期與時間。編輯器顯示用於排程的時區。在該時間之前, 目前線上修訂保持公開;對於新條目,尚未有任何公開內容。

Node.js 部署會自動執行排程發布掃描。Cloudflare Workers 需要 Cron Trigger。Cloudflare 入門範本包含它;現有部署可遵循 排程發布 以驗證觸發器。

還原修訂

支援修訂的集合在設定面板中顯示 Revisions。展開它以查看已儲存的 版本以及它們之間變更的欄位。選擇一個修訂以檢查其內容,然後 若要再次使用該版本,選擇 Restore。

還原會建立包含所選內容的新修訂。它不會擦除之前的修訂, 因此之後仍可檢查完整序列。

翻譯條目

當啟用國際化時,Translations 面板 顯示目前條目的已設定地區設定。

  1. 開啟來源條目,並在設定面板中找到 Translations。

  2. 對尚無條目的地區設定選擇 Translate。

  3. 編輯已複製的標題、slug、正文及其他可翻譯欄位。

  4. 選擇 Save,並在準備好時發布或排程該翻譯。

每個翻譯都有自己的 slug、發布狀態、排程與修訂歷史。使用集合頁面上的 地區設定選擇器一次查看一種語言。

將內容移至回收筒

開啟條目的操作,或在集合頁面上選擇一列或多列,然後選擇 Move to Trash。已移入回收筒的條目不再出現在普通內容查詢中,但仍可在集合的 Trash 分頁中使用。

在 Trash 中選擇 Restore 以將條目返回集合。還原的條目會以 無排程的草稿返回。發布它以使其公開。

自動化內容工作

REST API 與 EmDash CLI 支援相同的草稿與發布工作流程。集合欄位屬於 請求的 data 物件。更新會儲存草稿修訂;發布是單獨的操作。 在更新或發布時傳遞最新的 _rev 值,以便伺服器拒絕過時寫入,而不是 取代較新的工作。

使用內容生命週期參考了解狀態轉換、 權限、衝突與 hooks。REST API 參考定義請求與 回應主體,CLI 參考涵蓋等效的終端機 命令。

繼續閱讀查詢內容以在 Astro 站點中轉譯已發布條目, 或媒體庫以新增並管理可重用檔案。