官方文档

EmDash 官方文档。

Agent Skills

安装 EmDash Agent Skills,让 AI 编程助手在构建站点、编写插件和移植 WordPress 项目时使用最新的 EmDash API。

管理面板

编辑者、管理员和开发者如何使用 EmDash 管理面板。

架构

Astro 站点、EmDash、管理面板和数据存储如何协同工作。

集合和字段

选择集合行为和字段类型,并了解后续更改如何影响内容。

内容模型

集合、字段、条目、生成的类型和种子文件如何描述站点内容。

翻译 EmDash

如何为 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 登录提供方。

备份与恢复

为 EmDash 支持的每种数据库创建并验证可恢复的数据库、媒体和密钥备份。

使用区块构建页面

定义带版本的区块类型,添加 blocks 字段,并使用 Astro 组件渲染已存储的页面组合。

迁移到新域名

使用 Change domain 对话框切换站点的公开地址,并在迁移后继续登录。

创建博客

使用 EmDash 构建一个包含文章、分类和标签的完整博客。

深色模式

跟随访客的配色方案,让编辑者为图片选择深色变体,并使用 Image 组件渲染正确的那一张。

电子邮件设置

为魔法链接、邀请和帐户恢复配置电子邮件传递 — 在开发和生产环境中。

国际化 (i18n)

使用逐区域发布、slug 和自动回退功能将内容翻译成多种语言。

媒体库

在 EmDash 中上传、整理、选择、编辑、追踪并安全删除媒体。

导航菜单

在管理面板中创建菜单,并在 Astro 布局中渲染语言感知的导航。

页面布局

通过模板字段让编辑者为单个页面选择不同布局。

预览模式

在发布前启用草稿内容的安全预览。

查询内容

在服务器渲染的 Astro 页面中查询、排序、分页并渲染 EmDash 内容。

关联

用关联与引用字段跨内容类型链接条目,在编辑器中挑选条目,并在模板中读取链接。

Sections

创建可复用的 Portable Text 区块,并将独立的副本插入内容中。

内置 SEO 功能

EmDash 提供的搜索引擎优化(SEO)功能、每项功能的输出内容,以及如何启用它们。

站点设置

在 Astro 模板中读取站点身份、显示、社交与 SEO 设置。

站点迁移

将完整的 EmDash 站点导出为站点包,导入到新建的空站点,并用导入回执验证结果。

分类法

对内容分类、查询具有语言环境意识的术语,并构建分类法归档页。

小工具区域

在 Astro 模板中放置由编辑管理的内容、菜单和内置小部件。

处理内容

在 EmDash 管理后台中创建、编辑、发布、排期并安全删除内容。

x402 Payments

为服务端渲染的 Astro 路由要求 x402 支付。

内容导入

了解 WordPress 导入源、转换行为、API 结构和重试边界。

移植 WordPress 插件

选择 EmDash 插件格式,并映射 WordPress 的 hooks、存储、路由与管理 UI。

页面片段

将受信任的脚本或 HTML 添加到公开页面的插入点。

React 管理扩展

为原生插件添加生成的设置、React 页面、仪表盘小部件、字段小部件、编辑器面板以及内容列表列。

API 路由

从沙箱化插件暴露 REST 端点,供管理后台 UI 和外部集成使用。

Block Kit

用于插件页面、小组件和已保存条目扩展的声明式 UI 块。

能力与安全

声明插件需要什么,并了解沙箱会强制执行什么。

选择插件格式

在开始写代码之前,在沙箱与原生插件之间做出选择。

钩子

响应内容、媒体、生命周期和页面渲染事件运行代码。

插件清单

emdash-plugin.jsonc 的身份、访问权限、存储、管理界面和注册表字段参考。

打包与发布

将沙箱插件打包并发布到 EmDash 插件注册表。

设置

存储加密的沙箱插件设置,并通过 Block Kit 页面进行编辑。

存储

使用索引查询将插件数据持久化到文档集合中。

测试沙箱插件

在 Vitest 中通过 EmDash 的生产沙箱边界运行插件 hooks 与路由。

Field Kit

通过 seed 选项配置的 JSON 字段的可组合字段小部件。

安装插件

从 EmDash 注册表安装沙箱化插件,或注册来自 npm 的插件。

插件

通过钩子、存储、设置、管理页面和 API 路由扩展 EmDash。

插件注册表

从 EmDash 注册表发现、审查和安装沙箱插件。

查询注册表

使用 @emdash-cms/registry-client 针对注册表的公开发现 API 构建插件目录、搜索页或发布动态。

升级站点插件

安装 EmDash 插件的站点的破坏性变更,以及如何调整您的项目。

Hook 参考

用于扩展 EmDash 功能的插件 Hook。

REST API 参考

公开 HTTP 契约、认证规则以及完整的 OpenAPI 操作清单。

创建主题

构建可复用的 EmDash Astro 模板,包含服务端渲染路由与初始 seed。

主题

以带种子文件的 Astro 模板形式安装或创建 EmDash 主题。

Seed 文件

EmDash seed 格式、校验、引用与应用行为的参考。

升级到 EmDash 1.0

EmDash 0.x 与 1.0 之间的破坏性变更,以及如何更新你的站点。