官方文件

EmDash 官方文件。

Agent Skills

安裝 EmDash Agent Skills,讓 AI 程式設計助理在建置網站、撰寫外掛和移植 WordPress 專案時使用最新的 EmDash API。

管理面板

編輯者、管理員與開發者如何使用 EmDash 管理面板。

架構

Astro 網站、EmDash、管理面板和資料儲存如何協同運作。

集合和欄位

選擇集合行為和欄位類型,並了解後續變更如何影響內容。

內容模型

集合、欄位、條目、產生的型別和種子檔案如何描述站台內容。

選擇資料庫

為 EmDash 選擇並設定 SQLite、D1、Hyperdrive、PostgreSQL 或 libSQL。

部署到 Node.js

將 EmDash 部署到帶有持久資料服務的長期執行 Node.js 伺服器。

設定物件快取

在 Cloudflare KV 或記憶體中快取查詢結果,無需每次請求都查詢資料庫即可提供讀取服務。

設定外掛沙箱

在 Cloudflare Workers 或 Node.js 上執行沙箱化外掛,了解各沙箱運行器的繫結、資源限制和故障模式。

管理金鑰與機密

每個 EmDash 機密存放何處、如何提供,以及輪替或遺失時會發生什麼。

更新 EmDash

將現有站台遷移到新的 EmDash 發佈版本,從閱讀發佈條目到驗證已部署的站台。

EmDash 文件 MCP

將你的 AI 編碼助手連接到 EmDash 文件,使其能夠回答問題並從真實文件中找到正確的模式。

AI 工具

將 Claude、ChatGPT 及其他 AI 助手連接到你的 EmDash 網站。

Atmosphere 登入

使用 Atmosphere 帳戶登入 EmDash — Bluesky 及更廣泛的 AT Protocol 生態系統背後的開放網路身分。

身分驗證

以通行密鑰優先、可外掛的 GitHub、Google、Microsoft 與 Atmosphere 登入提供方。

備份與復原

匯出選定的站點資料,建立可還原的資料庫與媒體備份,並復原 D1 或 SQLite 部署。

使用區塊建構頁面

定義具版本的區塊類型,新增 blocks 欄位,並使用 Astro 元件算繪已儲存的頁面組合。

建立部落格

使用 EmDash 建構一個包含文章、分類和標籤的完整部落格。

深色模式

跟隨訪客的配色方案,讓編輯者為圖片選擇深色變體,並使用 Image 元件算繪正確的那一張。

電子郵件設定

為魔法連結、邀請和帳戶復原設定電子郵件傳送 — 在開發和生產環境中。

國際化 (i18n)

使用逐區域發布、slug 和自動回退功能將內容翻譯成多種語言。

媒體庫

在 EmDash 中上傳、整理、選取、編輯、追蹤並安全刪除媒體。

導覽選單

在管理面板中建立選單,並在 Astro 佈局中算繪語言感知的導覽。

頁面版面

透過範本欄位讓編輯者為個別頁面選擇不同版面。

預覽模式

在發佈前啟用草稿內容的安全預覽。

查詢內容

在伺服器轉譯的 Astro 頁面中查詢、排序、分頁並轉譯 EmDash 內容。

關聯

用關聯與參照欄位跨內容類型連結條目,在編輯器中挑選條目,並在範本中讀取連結。

Sections

建立可重複使用的 Portable Text 區塊,並將獨立的副本插入內容中。

內建 SEO 功能

EmDash 提供的搜尋引擎最佳化(SEO)功能、每項功能的輸出內容,以及如何啟用它們。

站台設定

在 Astro 範本中讀取站台身分、顯示、社群與 SEO 設定。

站台轉移

將完整的 EmDash 站台匯出為站台套件,匯入到新建的空站台,並以匯入回條驗證結果。

分類法

對內容分類、查詢具有語言環境意識的術語,並建置分類法封存頁。

小工具區域

向側邊欄、頁尾和其他範本區域新增動態內容區塊。

處理內容

在 EmDash 管理後台中建立、編輯、發布、排程並安全刪除內容。

x402 Payments

為伺服器端算繪的 Astro 路由要求 x402 支付。

內容匯入

從 WordPress 和其他來源將內容匯入 EmDash。

頁面片段

將受信任的腳本或 HTML 新增到公開頁面的插入點。

Portable Text 渲染元件

提供 Astro 元件,用於在公開網站上渲染外掛程式定義的 Portable Text 區塊類型。

React 管理擴充

為原生外掛新增產生的設定、React 頁面與小工具、編輯器面板以及內容清單欄。

API 路由

從沙箱化外掛公開 REST 端點,供管理後台 UI 和外部整合使用。

Block Kit

用於外掛頁面、小工具和已儲存條目擴充的宣告式 UI 區塊。

能力與安全

宣告外掛需要什麼,並了解沙箱會強制執行什麼。

選擇外掛格式

在開始寫程式碼之前,在沙箱與原生外掛之間做出選擇。

勾點

回應內容、媒體、生命週期與頁面轉譯事件執行程式碼。

外掛程式清單

emdash-plugin.jsonc 的身分、存取權限、儲存、管理介面與登錄庫欄位參考。

打包與發佈

將沙箱外掛程式打包並發佈到 EmDash 外掛程式註冊表。

設定

儲存加密的沙箱外掛設定,並透過 Block Kit 頁面進行編輯。

Storage

使用索引查詢將外掛程式資料持久化到文件集合中。

測試沙箱外掛

在 Vitest 中透過 EmDash 的生產沙箱邊界執行外掛 hooks 與路由。

Field Kit

透過 seed 選項配置的 JSON 欄位的可組合欄位小工具。

安裝外掛

從 EmDash 註冊表安裝沙箱化外掛,或註冊來自 npm 的外掛。

外掛程式

透過鉤子、儲存、設定、管理頁面和 API 路由擴充 EmDash。

外掛註冊表

從 EmDash 註冊表探索、審查和安裝沙盒外掛。

查詢註冊表

使用 @emdash-cms/registry-client 針對註冊表的公開探索 API 建置外掛目錄、搜尋頁或發布動態。

升級網站外掛

Breaking changes for sites that install EmDash plugins, and how to adapt your project.

Hook 參考

用於擴充 EmDash 功能的外掛 Hook。

REST API 參考

公開 HTTP 契約、認證規則以及完整的 OpenAPI 操作清單。

建立主題

建構可重複使用的 EmDash Astro 範本,包含伺服器端渲染路由與初始 seed。

主題

以帶種子檔案的 Astro 範本形式安裝或建立 EmDash 主題。

Seed 檔案

EmDash seed 格式、驗證、參照與套用行為的參考。

升級到 EmDash 1.0

EmDash 0.x 與 1.0 之間的破壞性變更,以及如何更新你的站台。