@intlayer/docs 5.5.8

package/ja/dictionary/condition.md

@@ -0,0 +1,213 @@
+# 条件付きコンテンツ / Intlayerの条件
+
+## 条件の仕組み
+
+Intlayerでは、条件付きコンテンツは`cond`関数を使用して実現されます。この関数は特定の条件（通常はブール値）を対応するコンテンツにマッピングします。このアプローチにより、指定された条件に基づいて動的にコンテンツを選択することが可能になります。React IntlayerやNext Intlayerと統合することで、実行時に提供された条件に応じて適切なコンテンツが自動的に選択されます。
+
+## 条件付きコンテンツの設定
+
+Intlayerプロジェクトで条件付きコンテンツを設定するには、条件定義を含むコンテンツモジュールを作成します。以下に、さまざまな形式での例を示します。
+
+```typescript fileName="**/*.content.ts" contentDeclarationFormat="typescript"
+import { cond, type Dictionary } from "intlayer";
+
+const myConditionalContent = {
+  key: "my_key",
+  content: {
+    myCondition: cond({
+      true: "条件がtrueの場合のコンテンツ",
+      false: "条件がfalseの場合のコンテンツ",
+      fallback: "条件が失敗した場合のコンテンツ", // オプション
+    }),
+  },
+} satisfies Dictionary;
+
+export default myConditionalContent;
+```
+
+```javascript fileName="**/*.content.mjs" contentDeclarationFormat="esm"
+import { cond } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const myConditionalContent = {
+  key: "my_key",
+  content: {
+    myCondition: cond({
+      true: "条件がtrueの場合のコンテンツ",
+      false: "条件がfalseの場合のコンテンツ",
+      fallback: "条件が失敗した場合のコンテンツ", // オプション
+    }),
+  },
+};
+
+export default myConditionalContent;
+```
+
+```javascript fileName="**/*.content.cjs" contentDeclarationFormat="commonjs"
+const { cond } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const myConditionalContent = {
+  key: "my_key",
+  content: {
+    myCondition: cond({
+      true: "条件がtrueの場合のコンテンツ",
+      false: "条件がfalseの場合のコンテンツ",
+      fallback: "条件が失敗した場合のコンテンツ", // オプション
+    }),
+  },
+};
+
+module.exports = myConditionalContent;
+```
+
+```json5 fileName="**/*.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "my_key",
+  "content": {
+    "myCondition": {
+      "nodeType": "condition",
+      "condition": {
+        "true": "条件がtrueの場合のコンテンツ",
+        "false": "条件がfalseの場合のコンテンツ",
+        "fallback": "条件が失敗した場合のコンテンツ", // オプション
+      },
+    },
+  },
+}
+```
+
+> フォールバックが宣言されていない場合、条件が検証されない場合は最後に宣言されたキーがフォールバックとして使用されます。
+
+## React Intlayerでの条件付きコンテンツの使用
+
+Reactコンポーネント内で条件付きコンテンツを利用するには、`react-intlayer`パッケージから`useIntlayer`フックをインポートして使用します。このフックは指定されたキーのコンテンツを取得し、条件を渡して適切な出力を選択できるようにします。
+
+```tsx fileName="**/*.tsx" codeFormat="typescript"
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+const ConditionalComponent: FC = () => {
+  const { myCondition } = useIntlayer("my_key");
+
+  return (
+    <div>
+      <p>
+        {
+          /* 出力: 条件がtrueの場合のコンテンツ */
+          myCondition(true)
+        }
+      </p>
+      <p>
+        {
+          /* 出力: 条件がfalseの場合のコンテンツ */
+          myCondition(false)
+        }
+      </p>
+      <p>
+        {
+          /* 出力: 条件が失敗した場合のコンテンツ */
+          myCondition("")
+        }
+      </p>
+      <p>
+        {
+          /* 出力: 条件が失敗した場合のコンテンツ */
+          myCondition(undefined)
+        }
+      </p>
+    </div>
+  );
+};
+
+export default ConditionalComponent;
+```
+
+```javascript fileName="**/*.mjx" codeFormat="esm"
+import { useIntlayer } from "react-intlayer";
+
+const ConditionalComponent = () => {
+  const { myCondition } = useIntlayer("my_key");
+
+  return (
+    <div>
+      <p>
+        {
+          /* 出力: 条件がtrueの場合のコンテンツ */
+          myCondition(true)
+        }
+      </p>
+      <p>
+        {
+          /* 出力: 条件がfalseの場合のコンテンツ */
+          myCondition(false)
+        }
+      </p>
+      <p>
+        {
+          /* 出力: 条件が失敗した場合のコンテンツ */
+          myCondition("")
+        }
+      </p>
+      <p>
+        {
+          /* 出力: 条件が失敗した場合のコンテンツ */
+          myCondition(undefined)
+        }
+      </p>
+    </div>
+  );
+};
+
+export default ConditionalComponent;
+```
+
+```javascript fileName="**/*.cjs" codeFormat="commonjs"
+const { useIntlayer } = require("react-intlayer");
+
+const ConditionalComponent = () => {
+  const { myCondition } = useIntlayer("my_key");
+
+  return (
+    <div>
+      <p>
+        {
+          /* 出力: 条件がtrueの場合のコンテンツ */
+          myCondition(true)
+        }
+      </p>
+      <p>
+        {
+          /* 出力: 条件がfalseの場合のコンテンツ */
+          myCondition(false)
+        }
+      </p>
+      <p>
+        {
+          /* 出力: 条件が失敗した場合のコンテンツ */
+          myCondition("")
+        }
+      </p>
+      <p>
+        {
+          /* 出力: 条件が失敗した場合のコンテンツ */
+          myCondition(undefined)
+        }
+      </p>
+    </div>
+  );
+};
+
+module.exports = ConditionalComponent;
+```
+
+## 追加リソース
+
+設定と使用に関する詳細情報については、以下のリソースを参照してください：
+
+- [Intlayer CLI ドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/ja/intlayer_cli.md)
+- [React Intlayer ドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/ja/intlayer_with_create_react_app.md)
+- [Next Intlayer ドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/ja/intlayer_with_nextjs_15.md)
+
+これらのリソースは、さまざまな環境やフレームワークでのIntlayerの設定と使用に関するさらなる洞察を提供します。

package/ja/dictionary/content_extention_customization.md

@@ -0,0 +1,81 @@
+# コンテンツ拡張機能のカスタマイズ
+
+## コンテンツファイルの拡張子
+
+Intlayerは、コンテンツ宣言ファイルの拡張子をカスタマイズすることを可能にします。このカスタマイズにより、大規模プロジェクトの管理が柔軟になり、他のモジュールとの競合を回避するのに役立ちます。
+
+### デフォルトの拡張子
+
+デフォルトでは、Intlayerは以下の拡張子を持つすべてのファイルをコンテンツ宣言として監視します:
+
+- `.content.json`
+- `.content.ts`
+- `.content.tsx`
+- `.content.js`
+- `.content.jsx`
+- `.content.mjs`
+- `.content.mjx`
+- `.content.cjs`
+- `.content.cjx`
+
+これらのデフォルトの拡張子は、ほとんどのアプリケーションに適しています。ただし、特定のニーズがある場合は、カスタム拡張子を定義してビルドプロセスを効率化し、他のコンポーネントとの競合リスクを軽減することができます。
+
+### コンテンツ拡張子のカスタマイズ
+
+Intlayerがコンテンツ宣言ファイルを識別するために使用するファイル拡張子をカスタマイズするには、Intlayerの設定ファイルで指定できます。このアプローチは、監視プロセスの範囲を制限することでビルドパフォーマンスを向上させる大規模プロジェクトに有益です。
+
+以下は、設定でカスタムコンテンツ拡張子を定義する例です:
+
+```typescript fileName="intlayer.config.ts" codeFormat="typescript"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  content: {
+    fileExtensions: [".my_content.ts", ".my_content.tsx"], // カスタム拡張子
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.mjs" codeFormat="esm"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  content: {
+    fileExtensions: [".my_content.cjs", ".my_content.cjx"], // カスタム拡張子
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.cjs" codeFormat="commonjs"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  content: {
+    fileExtensions: [".my_content.mjs", ".my_content.mjx"], // カスタム拡張子
+  },
+};
+
+module.exports = config;
+```
+
+この例では、設定で2つのカスタム拡張子 `.my_content.ts` と `.my_content.tsx` を指定しています。Intlayerはこれらの拡張子を持つファイルのみを監視して辞書を構築します。
+
+### カスタム拡張子の利点
+
+- **ビルドパフォーマンス**: 監視対象ファイルの範囲を減らすことで、大規模プロジェクトでのビルドパフォーマンスが大幅に向上します。
+- **競合回避**: カスタム拡張子は、プロジェクト内の他のJavaScriptやTypeScriptファイルとの競合を防ぎます。
+- **整理整頓**: カスタム拡張子を使用することで、プロジェクトのニーズに応じてコンテンツ宣言ファイルを整理できます。
+
+### カスタム拡張子のガイドライン
+
+コンテンツファイルの拡張子をカスタマイズする際には、以下のガイドラインを考慮してください:
+
+- **一意性**: プロジェクト内で一意の拡張子を選択して競合を回避してください。
+- **一貫した命名**: コードの可読性と保守性を向上させるために、一貫した命名規則を使用してください。
+- **一般的な拡張子の回避**: `.ts` や `.js` のような一般的な拡張子の使用は避け、他のモジュールやライブラリとの競合を防ぎます。
+
+## 結論
+
+Intlayerでのコンテンツファイル拡張子のカスタマイズは、大規模アプリケーションでのパフォーマンス最適化や競合回避に役立つ貴重な機能です。このドキュメントで説明したガイドラインに従うことで、コンテンツ宣言を効果的に管理し、プロジェクトの他の部分とのスムーズな統合を確保できます。

package/ja/dictionary/enumeration.md

@@ -0,0 +1,221 @@
+# 列挙 / 複数形化
+
+## 列挙の仕組み
+
+Intlayerでは、`enu`関数を使用して特定のキーを対応するコンテンツにマッピングすることで列挙を実現します。これらのキーは数値、範囲、またはカスタム識別子を表すことができます。React IntlayerまたはNext Intlayerと組み合わせて使用する場合、アプリケーションのロケールと定義されたルールに基づいて適切なコンテンツが自動的に選択されます。
+
+## 列挙の設定
+
+Intlayerプロジェクトで列挙を設定するには、列挙定義を含むコンテンツモジュールを作成する必要があります。以下は車の数に関する簡単な列挙の例です：
+
+```typescript fileName="**/*.content.ts" contentDeclarationFormat="typescript"
+import { enu, type Dictionary } from "intlayer";
+
+const carEnumeration = {
+  key: "car_count",
+  content: {
+    numberOfCar: enu({
+      "<-1": "マイナス1台未満の車",
+      "-1": "マイナス1台の車",
+      "0": "車なし",
+      "1": "1台の車",
+      ">5": "いくつかの車",
+      ">19": "たくさんの車",
+      "fallback": "フォールバック値", // 任意
+    }),
+  },
+} satisfies Dictionary;
+
+export default carEnumeration;
+```
+
+```javascript fileName="**/*.content.mjs" contentDeclarationFormat="esm"
+import { enu } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const carEnumeration = {
+  key: "car_count",
+  content: {
+    numberOfCar: enu({
+      "<-1": "マイナス1台未満の車",
+      "-1": "マイナス1台の車",
+      "0": "車なし",
+      "1": "1台の車",
+      ">5": "いくつかの車",
+      ">19": "たくさんの車",
+      "fallback": "フォールバック値", // 任意
+    }),
+  },
+};
+
+export default carEnumeration;
+```
+
+```javascript fileName="**/*.content.cjs" contentDeclarationFormat="commonjs"
+const { enu } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const carEnumeration = {
+  key: "car_count",
+  content: {
+    numberOfCar: enu({
+      "<-1": "マイナス1台未満の車",
+      "-1": "マイナス1台の車",
+      "0": "車なし",
+      "1": "1台の車",
+      ">5": "いくつかの車",
+      ">19": "たくさんの車",
+      "fallback": "フォールバック値", // 任意
+    }),
+  },
+};
+
+module.exports = carEnumeration;
+```
+
+```json fileName="**/*.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "car_count",
+  "content": {
+    "numberOfCar": {
+      "nodeType": "enumeration",
+      "enumeration": {
+        "<-1": "マイナス1台未満の車",
+        "-1": "マイナス1台の車",
+        "0": "車なし",
+        "1": "1台の車",
+        ">5": "いくつかの車",
+        ">19": "たくさんの車",
+        "fallback": "フォールバック値" // 任意
+      }
+    }
+  }
+}
+```
+
+この例では、`enu`がさまざまな条件を特定のコンテンツにマッピングします。Reactコンポーネントで使用する場合、Intlayerは指定された変数に基づいて適切なコンテンツを自動的に選択します。
+
+> Intlayerの列挙では、宣言の順序が重要です。最初に有効な宣言が選択されます。複数の条件が適用される場合、予期しない動作を避けるために正しい順序で配置してください。
+
+> フォールバックが宣言されていない場合、キーが一致しない場合は関数が`undefined`を返します。
+
+## React Intlayerでの列挙の使用
+
+Reactコンポーネントで列挙を使用するには、`react-intlayer`パッケージの`useIntlayer`フックを活用できます。このフックは、指定されたIDに基づいて正しいコンテンツを取得します。以下はその使用例です：
+
+```tsx fileName="**/*.tsx" codeFormat="typescript"
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+const CarComponent: FC = () => {
+  const { numberOfCar } = useIntlayer("car_count");
+
+  return (
+    <div>
+      <p>
+        {
+          numberOfCar(0) // 出力: 車なし
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(6) // 出力: いくつかの車
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(20) // 出力: たくさんの車
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(0.01) // 出力: フォールバック値
+        }
+      </p>
+    </div>
+  );
+};
+```
+
+```javascript fileName="**/*.mjx" codeFormat="esm"
+import { useIntlayer } from "react-intlayer";
+
+const CarComponent = () => {
+  const { numberOfCar } = useIntlayer("car_count");
+
+  return (
+    <div>
+      <p>
+        {
+          numberOfCar(0) // 出力: 車なし
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(6) // 出力: いくつかの車
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(20) // 出力: たくさんの車
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(0.01) // 出力: フォールバック値
+        }
+      </p>
+    </div>
+  );
+};
+
+export default CarComponent;
+```
+
+```javascript fileName="**/*.cjs" codeFormat="commonjs"
+const { useIntlayer } = require("react-intlayer");
+
+const CarComponent = () => {
+  const { numberOfCar } = useIntlayer("car_count");
+
+  return (
+    <div>
+      <p>
+        {
+          numberOfCar(0) // 出力: 車なし
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(6) // 出力: いくつかの車
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(20) // 出力: たくさんの車
+        }
+      </p>
+      <p>
+        {
+          numberOfCar(0.01) // 出力: フォールバック値
+        }
+      </p>
+    </div>
+  );
+};
+
+module.exports = CarComponent;
+```
+
+この例では、コンポーネントが車の数に基づいて出力を動的に調整します。指定された範囲に応じて正しいコンテンツが自動的に選択されます。
+
+## 追加リソース
+
+設定や使用方法に関する詳細情報は、以下のリソースを参照してください：
+
+- [Intlayer CLI ドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/ja/intlayer_cli.md)
+- [React Intlayer ドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/ja/intlayer_with_create_react_app.md)
+- [Next Intlayer ドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/ja/intlayer_with_nextjs_15.md)
+
+これらのリソースは、さまざまな環境やフレームワークでのIntlayerのセットアップと使用に関するさらなる洞察を提供します。