# 主题 locale 文件概述

> Locale 文件如何为 Shoplazza 主题保存翻译字符串、在主题中放在哪个目录，以及商家怎样在 Shoplazza 语言编辑器里修改它们。

Locale 文件是 JSON 文件，包含 theme 中使用的一组文本字符串翻译。

Locale 文件不仅为商家提供了集中管理 theme 中重复出现词汇和短语的地方，还允许您将店面内容翻译为多种语言，以满足国际化商家和客户的需求。

## 位置

Locale 文件位于 theme 的 `locales` 目录下：

```text title="目录"
└── theme
    ...
    └── locales
```

## 子类型

共有一种 locale 文件类型：

| 类型                                        | 描述                                                                                                                                                                                                                                   |
| :------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [店面](./storefront-locale-files)       | 店面 locale 文件扩展名为 `.json`，用于控制 theme 中店面内容的翻译。商家可以通过 [Shoplazza 语言编辑器](https://sso.shoplazza.com/login)编辑这些翻译内容。                                                                               |

## Schema

Locale 文件需要遵循特定的命名规范，同时遵循以下基本组织结构：

* **分类（Category）**：翻译的顶级分类。
* **分组（Group）**：分类内翻译的二级分组。
* **描述（Description）**：第三级，代表具体的翻译条目。

```json title="示例"
{
  "my_category": {
    "my_group": {
      "my_description": "翻译文本",
      ...
    },
    ...
  },
  ...
}
```

### Locale 文件命名

Locale 文件命名必须遵循标准的 [IOS 语言代码命名规范](http://www.lingoes.net/en/translator/langcode.htm)，其中第一个小写字母代码表示语言，第二个大写字母代码表示地区。

例如：

| 语言                    | 店面         |
| :---------------------- | :----------- |
| 阿拉伯语 - 沙特阿拉伯   | `ar-SA.json` |
| 德语 - 德国             | `de-DE.json` |
| 英语 - 美国             | `en-US.json` |

## 使用说明

使用 locale 文件时，您应该熟悉如何引用 locale 文件。引用方式因所引用的是[店面 locale 文件](./storefront-locale-files)而有所不同。