配置

配置文件用来定义 主题设置 区域中的设置项,并存储它们的值。

主题设置是放置通用设置(比如字体和颜色选项)的好地方。你可以通过 settings 对象 访问这些主题设置。

提示

你也可以为 sectionsblocks 创建设置。这些设置会作为父级 section 或 block 对象的一部分定义,并会在主题编辑器中显示在对应对象下。

位置

配置文件位于主题的 config 目录中:

  1. └── theme
  2. ...
  3. ├── config
  4. | ├── settings_data.json
  5. | └── settings_schema.json
  6. └── locales

子类型

有两个配置文件,它们各自有不同的 schema 和内容:

类型 描述 是否必需
settings_schema.json 控制主题编辑器中 主题设置 区域的组织结构和内容。
settings_data.json 包含从 settings_schema.json 中设置项保存下来的值。

用法

在使用配置文件时,你需要了解以下内容:

设置类型

设置分为两大类:

类别 描述
输入设置 可以保存值的设置项,用户可以在应用中配置这些设置。
侧边栏设置 不能保存值,用户也不能配置的设置项。这些是用来为输入设置提供更多细节和说明的信息性元素。

访问设置

你可以通过 settings 对象 访问主题设置。想了解更多语法和注意事项,请参考 访问设置

主题元数据

你可以在主题编辑器的 主题操作 菜单中添加主题元数据。这些信息可以包括主题名称、版本、主题文档位置以及主题开发者的联系方式。要了解如何在主题中添加这些信息,请参考 添加主题元数据