[{"value":"位置","id":"位置","hLevel":2,"level":1},{"value":"架构","id":"架构","hLevel":2,"level":1,"children":[{"value":"文件命名","id":"文件命名","hLevel":3,"level":2},{"value":"内容","id":"content","hLevel":3,"level":2}]},{"value":"使用","id":"使用","hLevel":2,"level":1}]

Schema 本地化文件

Schema 多语言文件是以 .schema.json 结尾的 JSON 文件。文件保存着 schema 设置属性的多语言文案，用于切换店铺语言的时候自动进行替换。

位置

Schema 的本地化文件被放在主题代码的 locales目录下：

└── theme
    ...
    ├── config
    └── locales
      ├── es.schema.json
      ...

架构

Schema 本地化文件包含如下的名称结构，它们也遵循一个基本的组织结构：

类别：翻译的顶级类别
组：类别中翻译的第二级分组
描述：代表各个翻译的第三级

{
  "my_category": {
    "my_group": {
      "my_description": "translation text",
      ...
    },
    ...
  },
  ...
}

提示

在命名翻译描述时，尽量描述性足以给出翻译上下文。例如：blogs.article_comment.submit_button_text 提供了比 blogs.article_comment.submit 更多的上下文信息。

文件命名

本地化文件命名必须遵循标准的 IETF 语言标记命名法，其中第一个小写字母代码表示语言，后面以 .schema.json结尾。例如：

语言	名称格式
English	`en.schema.json`
Spanish	`es.schema.json`
French	`fr.schema.json`

比较例外的是中文-简体、中文-繁体，它们分别是：

语言	名称格式
中文-简体	`zh-hans-cn.schema.json`
中文-繁体	`zh-hant-tw.schema.json`

内容

Schema 本地化文件允许你创建以下设置属性的翻译：

Parent	Attribute
All settings	`info` `label`
`settings_schema.json` `block` Section schema	`name`
`select`	`group`
`text` `textarea` `video_url` `handlebars`	`placeholder`
`range`	`unit`
`presets`	`name` `category`

使用

可以使用如下的代码格式访问 schema 翻译：

t:translation_category.translation_group.translation_name

使用 blog 举例，我们有如下的 locales/en.schema.json本地化文件：

{
  "sections": {
    "blog": {
      "name": "Blog"
    }
  }
}

下面是 sections/blog.html的 section 文件：

{{#schema}}
{
  "name": "t:sections.blog.name",
  ...
}
{{/schema}}

下面是一个比较综合的例子：

{
  "sections": {
    "blog": {
      "name": "Blog",
      "presets": {
        "presets__0": {
          "category": "Content display",
          "name": "Blog"
        }
      },
      "settings": {
        "title": {
          "label": "Title"
        },
        "color_scheme": {
          "label": "Color",
          "info": "Adjust blog color scheme",
          "options__0": {
            "label": "None"
          },
          "options__1": {
            "label": "Color 1"
          }
        }
      }
    }
  }
}

{{#schema}}
{
  "name": "t:sections.blog.name",
  "settings": [
    {
      "type": "text",
      "id": "title",
      "label": "t:sections.blog.settings.title.label",
      "default": "Blog"
    },
    {
      "type": "select",
      "id": "color_scheme",
      "label": "t:sections.blog.settings.color_scheme.label",
      "default": "none",
      "options": [
        {
          "value": "none",
          "label": "t:sections.blog.settings.color_scheme.options__0.label",
        },
        {
          "value": "1",
          "label": "t:sections.blog.settings.color_scheme.options__1.label",
        }
      ]
    }
  ],
  "presets": [
    {
      "name": "t:sections.blog.presets.presets__0.name",
      "category": "t:sections.blog.presets.presets__0.category"
    }
  ]
}
{{/schema}}