配置
配置文件用来定义 主题设置 区域中的设置项,并存储它们的值。
主题设置是放置通用设置(比如字体和颜色选项)的好地方。你可以通过 settings 对象 访问这些主题设置。
提示
你也可以为 sections 和 blocks 创建设置。这些设置会作为父级 section 或 block 对象的一部分定义,并会在主题编辑器中显示在对应对象下。
位置
配置文件位于主题的 config
目录中:
└── theme
...
├── config
| ├── settings_data.json
| └── settings_schema.json
└── locales
子类型
有两个配置文件,它们各自有不同的 schema 和内容:
类型 | 描述 | 是否必需 |
---|---|---|
settings_schema.json | 控制主题编辑器中 主题设置 区域的组织结构和内容。 | 是 |
settings_data.json | 包含从 settings_schema.json 中设置项保存下来的值。 |
是 |
用法
在使用配置文件时,你需要了解以下内容:
设置类型
设置分为两大类:
类别 | 描述 |
---|---|
输入设置 | 可以保存值的设置项,用户可以在应用中配置这些设置。 |
侧边栏设置 | 不能保存值,用户也不能配置的设置项。这些是用来为输入设置提供更多细节和说明的信息性元素。 |
访问设置
你可以通过 settings 对象 访问主题设置。想了解更多语法和注意事项,请参考 访问设置。
主题元数据
你可以在主题编辑器的 主题操作 菜单中添加主题元数据。这些信息可以包括主题名称、版本、主题文档位置以及主题开发者的联系方式。要了解如何在主题中添加这些信息,请参考 添加主题元数据。