# 资源编辑器

编辑 JSON 和 YAML 字段、列表或源码，再保存为草稿。

## 打开资源文件

从资源类型的 Collection 打开条目。JSON 和 YAML 文件使用资源编辑器：选择可视化模式，通过字段和列表修改数据；选择代码模式，编辑完整源码。

## 编辑字段与列表

文字、数字、布尔值和 null 各有相应的编辑控件。展开对象可以编辑其中的字段，展开数组可以编辑列表项。你可以添加或删除字段和列表项，也可以通过列表控件将条目上移、下移。

受支持的内容集合 schema 会提供字段类型、名称、必填标记和校验提示。缺少的可选字段会保持不存在，选择设置字段后才会添加；必填字段不能删除。请让字段值与声明的类型保持一致。

## 资源文件示例

```yaml
title: 开始使用
featured: true
links:
  - label: 安装
    href: /docs/install/
  - label: 配置
    href: /docs/configuration/
```

在可视化模式中，`title` 是文字字段，`featured` 是布尔值，`links` 是由对象组成的列表。在代码模式中，可以直接修改这份 YAML。JSON 的编辑流程相同。

## 何时使用代码模式

文件有语法错误、包含暂不支持的值，或者结构过大、嵌套过深时，可能无法使用可视化模式。请在代码模式中修改。保存前需要解决语法错误和字段校验问题。

## 媒体与日期

支持的图片、音频和视频字段可以打开媒体选择器，嵌套对象和媒体列表也可以提供这些控件。明确声明的媒体字段类型优先于根据内容推断的结构。空媒体列表在选择文件前会保持为空。插入或替换后，请检查路径、尺寸、图注和替代文字。

日期字段支持日期和受支持的 ISO 时间戳。文本框会显示完整原值，包括时区偏移；旁边的日历按钮用于打开选择器。仅打开字段不会转换时区。

## schema 的支持范围

Prosefly 读取受支持的静态 schema，或根据内容样本推断字段，不执行导入的 schema 工厂、转换函数，也不覆盖所有嵌套校验规则。网站自身的校验与构建仍然必要。

切换可视化和代码模式不会保存或发布，尚未编辑时会保留原始源码。修改 YAML 后，部分格式可能会被规范化。资源源码的 UTF-8 大小上限为 250 kB。

资源中的字符串引用不会自动将尚未发布的 [Public 图片](/docs/zh-cn/public-files/)带入审阅。请先发布图片，再审阅使用它们的资源文件。

## 保存与发布

修改完成后点击**保存草稿**。资源文件不会自动保存，也不会在保存时写入 Git。打开发布审阅前，请先保存最新修改。

如果已保存的资源被其他操作更新，可以先下载本地副本，再载入最新版本继续编辑。资源编辑器没有文档编辑器中的实时光标协作功能。