# 言語ファイル（ロケール）

### **学べること**

* ロケールファイルとは何か、そしてテーマ内のどこに置かれているか
* ストアフロント全体のテキストラベルをカスタマイズする方法
* 新しい言語を追加して翻訳を管理する方法

***

### 🧩 ロケールファイルとは？

ロケールファイルは、Shopifyテーマ内の翻訳可能なすべてのテキストを管理します。これらは `.json` というファイルとしてテーマの `locales` フォルダ内に保存されます。各ファイルは1つの言語を表します（例： `en.default.json` は英語用）。

次のような項目の翻訳が見られます：

* ボタンラベル（例：「カートに追加」）
* セクション見出し
* システムメッセージ（例：「商品が見つかりません」）

***

### 📁 テーマ内のファイルの場所

```plaintext
plain-jane-theme
  └── locales
        ├── en.default.json
        ├── fr.default.json
        └── es.default.json
```

各ファイルは一連の **キーと値のペア**を含んでおり、キーが識別子、値が翻訳可能なテキストです。

例：

```json
"products": {
  "product": {
    "add_to_cart": "カートに追加"
  }
}
```

***

### ✏️ テキストラベルの編集方法

1. あなたの管理画面から **Shopify 管理画面**に移動し、 **オンラインストア > テーマ**
2. クリック： **テキストの** 現在のテーマの隣にある
3. テーマエディタで、 **三点リーダーメニュー（⋯）** > **デフォルトのテーマコンテンツを編集**
4. 検索バーを使って更新したいテキストを見つけます（例：「売り切れ」）
5. 値を変更して、クリックします **保存**

> 💡 これはコードに触れずに「今すぐ購入」や「詳しくはこちら」などのボタン名を変更する最も簡単な方法です。

***

### 🌍 複数言語の追加または管理

ストアを複数の言語で提供するには：

1. 移動先： **設定 > 言語** 管理画面で
2. サポートしたい言語を追加します
3. Shopify は自動的に新しい `.json` ロケールファイルをテーマ内に生成します
4. その後、次の方法でコンテンツを翻訳できます：
   * Shopify の管理画面の UI
   * 翻訳アプリ（Weglot や Langify など）
   * 手動での編集（開発者レベル） `.json` ファイル

> ⚠️ メタフィールドやカスタムコンテンツを使用している場合は、各言語についても必ず更新してください。

***

### 🧠 開発者向けノート

Liquid では次の `t` フィルタを使ってロケール文字列にアクセスできます：

```liquid
{{ 'products.product.add_to_cart' | t }}
```

テーマを構築または拡張する場合、ロケールキーはセクションやコンテキストごとに構成しておくと整理しやすくなります（例： `header`, `footer`, `cart`など）。

### **ヘルプが必要ですか？**

* 💬 **Discordでコミュニティに参加：** <https://discord.gg/hcc2GvgZc6>
* 📧 **メールでお問い合わせ：** <support@openspaces.design>
* 💻 **ライブチャット：** 月〜金、現地時間午前10時〜午後6時（EST）に当社ウェブサイトで直接対応


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.openspaces.design/english-ja/readme-1/theme-settings/languages-and-seo/language-files-locales.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.