官方文件

EmDash 官方文件。

管理面板

EmDash 管理面板為編輯者、管理員和開發者提供的功能。

架構

使用 EmDash 建構的思維模型 — 一個具有即時可編輯內容模型的 Astro 整合。

集合與欄位

使用集合和欄位定義內容類型——支援的欄位類型、驗證和關係。

內容模型

如何在 EmDash 中塑造和演進你的內容模型 — 集合、欄位、執行階段變更、型別和種子檔案。

資料庫選項

使用 D1、PostgreSQL、libSQL 或 SQLite 設定 EmDash。

物件快取

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

外掛沙箱

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

金鑰與金鑰管理

EmDash 每個金鑰的儲存位置、提供方式,以及輪換或遺失時的影響。

儲存選項

使用 R2、S3 或本機檔案系統設定媒體儲存。

更新 EmDash

將現有網站遷移到新的 EmDash 版本,從閱讀發布說明到驗證已部署的網站。

EmDash Docs MCP

將您的 AI 編碼助手連接到 EmDash 文件,以便它可以回答問題並從真實文件中找到正確的模式。

快速開始

在 5 分鐘內建立您的第一個 EmDash 網站。

AI 工具

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

Atmosphere Login

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

驗證

通行密鑰優先的驗證方式,提供 GitHub、Google 和 Atmosphere 的可插拔提供商。

備份

下載網站備份,排程自動備份到儲存,以及使用 D1 Time Travel 還原。

建立部落格

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

深色模式

跟隨訪客的配色方案,讓編輯為圖片選擇深色變體,並使用 Image 元件渲染正確的版本。

國際化 (i18n)

透過按地區設定發布、自訂 slug 和自動回退將內容翻譯成多種語言。

媒體庫

在 EmDash 中上傳和管理圖片和檔案。

導航選單

為頁眉、頁腳和側邊欄建立和管理導航選單。

頁面佈局

讓編輯者使用範本欄位為個別頁面選擇不同的佈局。

預覽模式

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

查詢內容

使用 getEmDashCollection 和 getEmDashEntry 在模板中擷取內容。

Sections

在整個網站中建立和使用可重複使用的內容區塊。

網站設定

設定全域設定,如網站標題、標誌和社群連結。

分類法

使用分類、標籤和自訂分類法整理內容。

小工具區域

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

內容操作

在 EmDash 管理面板中建立、編輯和管理內容。

x402 Payments

使用 x402 支付協定實現內容變現 — 向機器人收費,而非人類。

EmDash

Astro 原生的 CMS。具有型別安全內容、外掛可擴充性和可攜式部署的 WordPress 現代繼任者。

EmDash 介紹

了解 EmDash 是什麼、它如何運作以及它是否適合您的專案。

內容匯入

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

管理後台 UI

為 EmDash 管理後台新增自訂頁面和儀表板小工具。

外掛 API 路由

從你的外掛中暴露 REST 端點,用於後台 UI 和外部整合。

Block Kit

適用於沙盒外掛管理後臺頁面與小工具的宣告式 UI 區塊。

頁面片段

向渲染的公開頁面注入腳本、樣式表或 HTML — 僅限原生外掛程式。

Portable Text 渲染元件

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

建立外掛

使用鉤子、儲存、設定和後台 UI 建置 EmDash 外掛。

API 路由

從沙盒外掛暴露 REST 端點,供管理 UI 和外部整合使用。

Block Kit

用於沙箱外掛程式管理頁面和小工具的宣告式 UI 區塊。

功能與安全

宣告外掛所需的功能,了解沙盒的強制機制。

emdash-plugin CLI

init、build、dev、bundle、validate、設定檔設定和發佈。

鉤子

回應內容、媒體、生命週期和頁面渲染事件執行程式碼。

外掛清單

Reference for emdash-plugin.jsonc — identity, trust contract, profile fields, and publisher pinning.

遷移到外掛 CLI

Breaking changes for sandboxed-plugin authors, and how to update your plugin.

打包和發佈

Bundle a sandboxed plugin and publish it to the EmDash plugin registry.

設定

透過 KV 儲存進行插件配置,在管理 UI 中以 Block Kit 頁面的形式公開。

Storage

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

Field Kit

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

外掛 Hooks

接入內容、媒體與外掛生命週期事件。

安裝外掛

Install plugins from the EmDash Marketplace or add them from code.

外掛程式

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

發佈外掛

打包並將你的 EmDash 外掛發佈到 Marketplace。

外掛註冊表

Install plugins from the experimental, federated EmDash plugin registry, and query it from your own site.

查詢註冊表

Build a plugin directory, search page, or release feed against the registry's public discovery API with @emdash-cms/registry-client.

外掛沙箱

EmDash 如何在 Cloudflare Workers 與 Node.js 部署中隔離不受信任的外掛。

外掛設定

使用設定 schema 與 KV 儲存來設定外掛。

外掛 Storage

在具索引查詢的文件集合中持久化外掛資料。

升級網站外掛

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

主題概述

了解 EmDash 主題的工作原理以及如何引導新站點。