处理内容

本页内容

使用 EmDash 管理后台将条目从初稿推进到已发布页面。编辑器将 草稿更改与访客可见的版本分开保存,因此保存与发布是两个 不同的操作。

打开集合

打开站点上的 /_emdash/admin 并登录。在侧边栏中选择集合,例如 Posts 或 Pages。

集合页面列出其条目。在此你可以:

  • 选择 Add New 创建条目;
  • 按条目标题、slug 以及标记为 searchable 的字段搜索;
  • 按发布状态、作者、署名、日期与区域设置筛选;
  • 选择条目以批量发布、退回草稿或移至回收站;以及
  • 打开 Trash 以恢复或永久删除条目。

编辑器中可用的字段与发布功能取决于集合的内容模型。 例如,集合可能支持修订、预览、分类法或搜索。

创建并发布条目

  1. 在集合页面上选择 Add New。

  2. 填写必填字段。若集合有标题字段,EmDash 会用它建议 slug。你可以在发布前编辑 slug。

  3. 添加正文以及任何辅助字段,例如摘要、特色图片、署名、分类 或标签。

  4. 选择 Save。首次保存会将条目创建为草稿,并打开其永久编辑器 URL。

  5. 审阅草稿。若集合支持预览,选择 Preview 以在发布前查看 渲染后的页面。

  6. 选择 Publish now,然后确认。已保存的草稿成为公开内容查询返回的 线上版本。

条目具有稳定的内容 ID 与单独的 slug。若 slug 更改,ID 仍标识同一条目。 模板通常使用 getEmDashCollection() 返回的面向 URL 的标识符; 查询内容指南 解释这两个值。

撰写富文本

Portable Text 字段提供块编辑器,用于标题、段落、引用、列表、链接、 图片、图库、代码块、表格、HTML 块与可复用分区。已安装的插件可 添加更多块。

使用工具栏格式化所选文本。要插入块,请选择段落旁的添加块控件, 或输入 / 并按名称搜索块。图片与图库块打开与图片字段相同的媒体 选择器。

选择图片块时,其设置可让你替换或移除该图片的此次使用,并设置 显示尺寸、对齐、替代文本、说明与可选工具提示。Edit asset 打开 底层媒体库项目,在那里更改或替换资源可能影响使用它的其他条目。 见媒体库了解该区别。

保存草稿更改

首次保存后,编辑器会在你停止输入两秒后自动保存更改。Save 按钮 会经过 Saving… 变为 Saved,以便你确认服务器已接受 草稿。自动保存会替换当前自动保存修订,而不是为每次停顿在修订历史中填入 检查点。

当你希望编辑序列中的某一时刻保留在修订历史中时,选择 Save。若 保存失败,编辑器会保留未保存的字段并显示错误。在按钮回到 Saved 或你已将未保存的工作复制到别处之前,请勿离开页面。

对于已发布的条目,保存更改仅更新其草稿。访客仍会收到 先前的线上修订。使用 Preview draft 检查待定版本,使用 Live View 检查 公开版本,并在草稿准备好替换它时使用 Publish changes。

更改已发布条目的 slug 遵循相同的草稿流程。公开 URL 在你 发布草稿时更改,而不是在自动保存运行时。

与另一位编辑者协作

打开条目会为该条目与区域设置获取编辑锁。若另一人已将其 打开,EmDash 会标识锁持有者并提供两个选择:

  • Open read-only 显示条目但不接受编辑,因此你不会输入将被 丢弃的工作。
  • Take over 将锁交给你。对方保留已输入内容,但在两分钟内 其编辑器会报告你持有该条目。对方的下一次保存会被拒绝。

锁在条目打开期间会续期,并在你离开编辑器或关闭标签页时释放。 若浏览器或计算机在未释放的情况下关闭,锁会在其最后一次续期后 七分钟过期。

每个区域设置的锁是独立的,因此两人可以编辑同一条目的不同翻译。 脚本或 API 客户端在另一位编辑者持有锁时也会被拒绝,除非使用 已记录的覆盖。完整 API 行为见条目编辑锁。

管理员可在 Content Types、然后该集合、然后 Edit locking 下关闭集合的锁定。

发布或定时更改

发布与定时使用分开的控件:

  • Publish now 在确认后使新草稿上线。
  • Publish changes 在确认后使已发布条目的待定更改上线。
  • Schedule 设定新条目或待定更改何时上线。
  • Change schedule 更新现有定时。
  • Remove schedule 取消现有定时。
  • Unpublish 从公开查询中移除线上修订,取消任何定时,并保留 可编辑草稿。

要定时条目,请先保存,在发布摘要下方选择 Schedule,并选择将来的 日期与时间。编辑器显示用于定时的时区。在该时间之前, 当前线上修订保持公开;对于新条目,尚未有任何公开内容。

Node.js 部署会自动运行定时发布扫描。Cloudflare Workers 需要 Cron Trigger。Cloudflare 入门模板包含它;现有部署可遵循 定时发布 以验证触发器。

恢复修订

支持修订的集合在设置面板中显示 Revisions。展开它以查看已保存的 版本以及它们之间更改的字段。选择一个修订以检查其内容,然后 若要再次使用该版本,选择 Restore。

恢复会创建包含所选内容的新修订。它不会擦除之前的修订, 因此之后仍可检查完整序列。

翻译条目

当启用国际化时,Translations 面板 显示当前条目的已配置区域设置。

  1. 打开源条目,并在设置面板中找到 Translations。

  2. 对尚无条目的区域设置选择 Translate。

  3. 编辑已复制的标题、slug、正文及其他可翻译字段。

  4. 选择 Save,并在准备好时发布或定时该翻译。

每个翻译都有自己的 slug、发布状态、定时与修订历史。使用集合页面上的 区域设置选择器一次查看一种语言。

将内容移至回收站

打开条目的操作,或在集合页面上选择一行或多行,然后选择 Move to Trash。已移入回收站的条目不再出现在普通内容查询中,但仍可在集合的 Trash 标签中使用。

在 Trash 中选择 Restore 以将条目返回集合。恢复的条目会以 无定时的草稿返回。发布它以使其公开。

自动化内容工作

REST API 与 EmDash CLI 支持相同的草稿与发布工作流。集合字段属于 请求的 data 对象。更新会保存草稿修订;发布是单独的操作。 在更新或发布时传递最新的 _rev 值,以便服务器拒绝过时写入,而不是 替换较新的工作。

使用内容生命周期参考了解状态转换、 权限、冲突与 hooks。REST API 参考定义请求与 响应体,CLI 参考涵盖等效的终端 命令。

继续阅读查询内容以在 Astro 站点中渲染已发布条目, 或媒体库以添加并管理可复用文件。