E EmDash CMS Everything Guides, use cases, plugins, templates
繁體中文

官方文件

EmDash 官方文件。

在 Claude 中開啟 在 ChatGPT 中開啟
分享至 X 分享至 LinkedIn 分享至 Reddit

管理面板

編輯器、管理員和開發者如何使用 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 生態系統背後的開放網路身分。

身分驗證

以 Passkey 為主的身分驗證，搭配可插拔的 GitHub、Google 和 Atmosphere 提供者。

備份與復原

匯出選定的站台資料、建立可還原的資料庫和媒體備份，以及復原 D1 或 SQLite 部署。

建立部落格

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

深色模式

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

國際化 (i18n)

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

媒體庫

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

導覽選單

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

頁面佈局

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

預覽模式

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

查詢內容

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

Sections

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

網站設定

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

分類法

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

小工具區域

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

內容操作

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

x402 Payments

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

EmDash

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

內容匯入

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

頁面片段

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

Portable Text 渲染元件

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

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 中，並透過 Block Kit 頁面進行編輯。

Storage

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

Field Kit

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

安裝外掛

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

外掛程式

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

外掛註冊表

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.

升級網站外掛

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

主題概述

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