本指南介绍如何通过 EmDash 管理后台创建、编辑和管理内容。
进入后台
在浏览器中打开网站的 /_emdash/admin。使用初始化时创建的账号登录。
后台会显示：
- 侧边栏 — 前往集合、媒体与设置
- 内容列表 — 当前集合中的条目
- 快捷操作 — 新建内容、批量操作
创建内容
-
在侧边栏点击集合名称（例如 文章）。
-
点击 新建文章（或与你集合对应的按钮）。
-
填写必填字段：
- 标题 — 内容的显示名称
- 别名（Slug） — URL 标识（可由标题自动生成，可编辑）
-
使用富文本编辑器撰写正文。
-
在侧边栏设置元数据：
- 状态 — 草稿、已发布或已归档
- 发布日期 — 何时发布
- 分类与标签 — 分类法关联
-
点击 保存。
内容状态
每条记录处于以下三种状态之一：
| 状态 | 可见范围 | 典型用途 |
|---|---|---|
| 草稿 | 仅后台 | 撰写中 |
| 已发布 | 公开 | 线上内容 |
| 已归档 | 仅后台 | 已下线内容 |
在编辑器侧边栏的下拉菜单中更改状态。
富文本编辑器
EmDash 编辑器支持：
- 标题 — H2 至 H6
- 格式 — 粗体、斜体、下划线、删除线
- 列表 — 有序与无序
- 链接 — 站内与外链
- 图片 — 从媒体库插入
- 代码块 — 语法高亮
- 嵌入 — YouTube、Vimeo、Twitter
- 区块 — 通过
/section命令插入可复用块
斜杠命令
输入 / 快速插入：
| 命令 | 作用 |
|---|---|
/section | 插入可复用区块 |
/image | 从媒体库插入图片 |
/code | 插入代码块 |
键盘快捷键
| 操作 | 快捷键 |
|---|---|
| 粗体 | Ctrl/Cmd + B |
| 斜体 | Ctrl/Cmd + I |
| 链接 | Ctrl/Cmd + K |
| 撤销 | Ctrl/Cmd + Z |
| 重做 | Ctrl/Cmd + Shift + Z |
| 保存 | Ctrl/Cmd + S |
插入图片
-
点击工具栏中的图片按钮。
-
从媒体库选择已有图片，或上传新图片。
-
填写替代文本（无障碍必填）。
-
调整对齐与尺寸。
-
点击 插入。
编辑内容
-
进入包含该内容的集合。
-
点击要编辑的条目。
-
修改内容。
-
点击 保存。
已发布内容的修改会立即在站点上生效，无需重新构建。
修订历史
EmDash 会记录变更。在编辑器侧边栏查看历史：
-
在侧边栏点击 修订。
-
查看带时间戳的历史版本列表。
-
点击某一修订进行预览。
-
点击 还原 回到该版本。
批量操作
可同时对多条记录操作：
-
在内容列表中用复选框选择条目。
-
打开 批量操作 下拉菜单。
-
选择操作：
- 发布 — 将选中项设为已发布
- 归档 — 将选中项归档
- 删除 — 永久删除选中项
-
确认操作。
搜索与筛选
搜索
使用搜索框按标题或正文查找。不区分大小写，支持部分匹配。
筛选
可按以下条件筛选列表：
- 状态 — 草稿、已发布、已归档
- 日期范围 — 创建或修改时间
- 作者 — 创建者
- 分类法 — 分类或标签
点击 清除筛选 重置。
定时发布
若要在未来某个时刻发布：
-
创建或编辑内容。
-
将状态设为 草稿。
-
将 发布日期 设为未来的日期与时间。
-
点击 保存。
到达设定时间后，内容会自动发布。
删除内容
可在编辑页或列表中删除：
在编辑页
-
打开要删除的内容。
-
在工具栏点击 删除。
-
确认删除。
在列表中
-
用复选框选择条目。
-
选择 批量操作 > 删除。
-
确认删除。
内容 API
若要以编程方式访问，请使用 EmDash 管理 API：
创建内容
POST /_emdash/api/content/posts
Content-Type: application/json
Authorization: Bearer YOUR_API_TOKEN
{
"title": "My New Post",
"slug": "my-new-post",
"content": "<p>Post content here</p>",
"status": "draft"
}更新内容
PUT /_emdash/api/content/posts/my-new-post
Content-Type: application/json
Authorization: Bearer YOUR_API_TOKEN
{
"title": "Updated Title",
"status": "published"
}删除内容
DELETE /_emdash/api/content/posts/my-new-post
Authorization: Bearer YOUR_API_TOKEN翻译内容
启用 i18n 后，可为任意内容条目创建翻译。
创建翻译
-
打开要翻译的条目。
-
在编辑器侧边栏找到 翻译 面板。
-
在目标语言旁点击 翻译。
-
编辑预填内容 — 按新语言调整标题、别名与正文。
-
点击 保存。
新翻译会与原文关联，并以草稿开始；可在准备好后单独发布。
在翻译间切换
翻译面板列出所有已配置语言。点击已有翻译旁的 编辑 可直接跳转。当前语言会以勾选标记显示。
语言筛选
在内容列表中，使用工具栏的语言下拉框按语言筛选。每条记录的语言显示在专用列中。
配置、查询与语言切换的完整说明见 国际化指南。
后续步骤
- Querying Content — 在模板中获取内容
- Media Library — 上传与管理文件
- Taxonomies — 用分类与标签组织内容
- Internationalization — 多语言内容与翻译