@intlayer/docs 5.5.8

package/ja/per_locale_file.md

@@ -0,0 +1,298 @@
+# Intlayerは多言語コンテンツを宣言するために2つの方法をサポートしています：
+
+- すべての翻訳を含む単一ファイル
+- ロケールごとのファイル（ロケールごとの形式）
+
+この柔軟性により以下が可能になります：
+
+- 他のi18nツールからの簡単な移行
+- 自動翻訳ワークフローのサポート
+- 翻訳を別々のロケール固有のファイルに明確に整理
+
+## 複数翻訳を含む単一ファイル
+
+この形式は以下の場合に理想的です：
+
+- コード内での迅速な反復。
+- CMSとのシームレスな統合。
+
+ほとんどのユースケースで推奨されるアプローチです。翻訳を一元化し、反復やCMSとの統合を容易にします。
+
+```tsx fileName="hello-world.content.ts" contentDeclarationFormat="typescript"
+import { t, type Dictionary } from "intlayer";
+
+const helloWorldContent = {
+  key: "hello-world",
+  content: {
+    multilingualContent: t({
+      ja: "私のコンポーネントのタイトル",
+      en: "Title of my component",
+      es: "Título de mi componente",
+    }),
+  },
+} satisfies Dictionary;
+
+export default helloWorldContent;
+```
+
+```js fileName="hello-world.content.mjs" contentDeclarationFormat="esm"
+import { t } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const helloWorldContent = {
+  key: "hello-world",
+  content: {
+    multilingualContent: t({
+      ja: "私のコンポーネントのタイトル",
+      en: "Title of my component",
+      es: "Título de mi componente",
+    }),
+  },
+};
+
+export default helloWorldContent;
+```
+
+```js fileName="hello-world.content.cjs" contentDeclarationFormat="json"
+const { t } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const helloWorldContent = {
+  key: "hello-world",
+  content: {
+    multilingualContent: t({
+      ja: "私のコンポーネントのタイトル",
+      en: "Title of my component",
+      es: "Título de mi componente",
+    }),
+  },
+};
+
+module.exports = helloWorldContent;
+```
+
+```json fileName="hello-world.content.ts" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "content": {
+    "multilingualContent": {
+      "nodeType": "translation",
+      "translation": {
+        "ja": "私のコンポーネントのタイトル",
+        "en": "Title of my component",
+        "es": "Título de mi componente"
+      }
+    }
+  }
+}
+```
+
+> 推奨: この形式は、Intlayerのビジュアルエディタを使用する場合や、コード内で直接翻訳を管理する場合に最適です。
+
+## ロケールごとの形式
+
+この形式は以下の場合に便利です：
+
+- 翻訳を独立してバージョン管理または上書きしたい場合。
+- 機械翻訳または人間による翻訳ワークフローを統合する場合。
+
+ロケールフィールドを指定することで、翻訳を個別のロケールファイルに分割することもできます：
+
+```tsx fileName="hello-world.en.content.ts" contentDeclarationFormat="typescript"
+import { t, Locales, type Dictionary } from "intlayer";
+
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.ENGLISH, // 重要
+  content: { multilingualContent: "Title of my component" },
+} satisfies Dictionary;
+
+export default helloWorldContent;
+```
+
+```tsx fileName="hello-world.es.content.ts" contentDeclarationFormat="typescript"
+import { t, Locales, type Dictionary } from "intlayer";
+
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.SPANISH, // 重要
+  content: { multilingualContent: "Título de mi componente" },
+};
+```
+
+```js fileName="hello-world.en.content.mjs" contentDeclarationFormat="esm"
+import { t, Locales } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.ENGLISH, // 重要
+  content: { multilingualContent: "Title of my component" },
+};
+
+export default helloWorldContent;
+```
+
+```tsx fileName="hello-world.es.content.mjs" contentDeclarationFormat="esm"
+import { t, Locales } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.SPANISH, // 重要
+  content: { multilingualContent: "Título de mi componente" },
+};
+
+export default helloWorldContent;
+```
+
+```js fileName="hello-world.en.content.cjs" contentDeclarationFormat="commonjs"
+const { t, Locales } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.ENGLISH, // 重要
+  content: {
+    multilingualContent: "Title of my component",
+  },
+};
+
+module.exports = helloWorldContent;
+```
+
+```tsx fileName="hello-world.es.content.cjs" contentDeclarationFormat="commonjs"
+const { t, Locales } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.SPANISH, // 重要
+  content: {
+    multilingualContent: "Título de mi componente",
+  },
+};
+
+module.exports = helloWorldContent;
+```
+
+```json5 fileName="hello-world.en.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "locale": "en", // 重要
+  "content": {
+    "multilingualContent": "Title of my component",
+  },
+}
+```
+
+```json5 fileName="hello-world.es.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "locale": "es", // 重要
+  "content": {
+    "multilingualContent": "Título de mi componente",
+  },
+}
+```
+
+> 重要: ロケールフィールドが定義されていることを確認してください。このフィールドは、ファイルがどの言語を表しているかをIntlayerに伝えます。
+
+> 注意: どちらの場合でも、コンテンツ宣言ファイルはIntlayerによって認識されるために`*.content.{ts,tsx,js,jsx,mjs,cjs,json}`という命名パターンに従う必要があります。`.[locale]`サフィックスはオプションであり、命名規則としてのみ使用されます。
+
+## フォーマットの混在
+
+同じコンテンツキーに対して両方のアプローチを混在させることができます。例えば：
+
+デフォルトまたはベースコンテンツを静的に宣言する（例: `index.content.ts`）
+
+ロケール固有のコンテンツを`index.content.json`、`index.fr.content.ts`などで追加または上書きする。
+
+これは特に以下の場合に便利です：
+
+- ベースコンテンツをコードベースで静的に宣言し、CMSで自動的に翻訳を埋めたい場合。
+
+```bash codeFormat="typescript"
+.
+└── Components
+    └── MyComponent
+        ├── index.content.ts
+        ├── index.content.json
+        └── index.ts
+```
+
+### 例
+
+以下は多言語コンテンツ宣言ファイルの例です：
+
+```tsx fileName="Components/MyComponent/index.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.ENGLISH,
+  content: {
+    multilingualContent: "Title of my component",
+    projectName: "My project",
+  },
+} satisfies Dictionary;
+
+export default helloWorldContent;
+```
+
+```json fileName="Components/MyComponent/index.content.json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "content": {
+    "multilingualContent": {
+      "nodeType": "translation",
+      "translation": {
+        "ja": "私のコンポーネントのタイトル",
+        "fr": "Titre de mon composant",
+        "es": "Título de mi componente"
+      }
+    }
+  }
+}
+```
+
+Intlayerは多言語およびロケールごとのファイルを自動的にマージします。
+
+```tsx fileName="Components/MyComponent/index.ts"
+import { getIntlayer, Locales } from "intlayer";
+
+const intlayer = getIntlayer("hello-world"); // デフォルトロケールはENGLISHなので、ENGLISHのコンテンツが返されます
+
+console.log(JSON.stringify(intlayer, null, 2));
+// 結果:
+// {
+//  "multilingualContent": "Title of my component",
+//  "projectName": "My project"
+// }
+
+const intlayer = getIntlayer("hello-world", Locales.SPANISH);
+
+console.log(JSON.stringify(intlayer, null, 2));
+// 結果:
+// {
+//  "multilingualContent": "Título de mi componente",
+//  "projectName": "My project"
+// }
+
+const intlayer = getIntlayer("hello-world", Locales.FRENCH);
+
+console.log(JSON.stringify(intlayer, null, 2));
+// 結果:
+// {
+//  "multilingualContent": "Titre de mon composant",
+//  "projectName": "My project"
+// }
+```
+
+### 自動翻訳生成
+
+[インレイヤーCLI](https://github.com/aymericzip/intlayer/blob/main/docs/ja/intlayer_cli.md)を使用して、好みのサービスに基づいて不足している翻訳を自動的に埋めることができます。

package/ja/privacy_notice.md

@@ -0,0 +1,57 @@
+# プライバシー通知
+
+## はじめに
+
+Intlayerでは、プライバシーを重要視しています。この通知では、当ウェブサイトおよびCMSを通じて収集された情報の取り扱い方法について説明します。
+
+## お問い合わせ
+
+プライバシーに関するご質問やご懸念がある場合は、以下のアドレスまでご連絡ください：[contact@intlayer.org](mailto:contact@intlayer.org)。
+
+## クッキーおよびトラッキング技術の使用
+
+当社は、ウェブサイトの利用状況を分析し、サービスを向上させるために、**Google Analytics** および **Meta (Facebook) Pixel** を使用しています。これらのツールは、ユーザーのデバイスに保存されたクッキーを使用して、ウェブサイトに関する統計やその他の情報を生成します。
+
+詳細については以下をご覧ください：
+
+- [Googleのプライバシーポリシー](https://policies.google.com/privacy)
+- [Metaのプライバシーポリシー](https://www.facebook.com/privacy/policy)
+
+## 認証とユーザーデータ
+
+Intlayer CMSへのアクセスにはユーザー認証が必要です。当社は、メールアドレス/パスワード認証と、**Google** および **GitHub** を介したサードパーティサインインの両方を提供しています。
+
+認証プロセス中に収集される情報：
+
+- メールアドレス
+- 表示名（または選択した名前）
+
+また、ユーザーはアカウントにリンクされたアクセストークンを使用してCMSにアクセスすることもできます。これらのトークンは、同じ認証データに関連付けられています。
+
+## データの保存とセキュリティ
+
+ユーザー認証データは、**cloud.mongodb.com** 上の **MongoDBデータベース** に保存されます：
+
+- **リージョン:** AWS / Oregon (us-west-2)
+- **タイプ:** レプリカセット (3ノード)
+- **パスワードセキュリティ:** すべてのパスワードは業界標準の方法でハッシュ化されています。
+
+認証および安全なCMSアクセスに必要な範囲を超える個人データは保存しません。
+
+## 第三者とのデータ共有
+
+当社は、分析（Google Analytics、Facebook Pixel）や認証プロセス（GoogleまたはGitHubサインイン）の一環として必要な場合を除き、個人データを第三者に販売または共有することはありません。
+
+## ユーザーの権利
+
+ユーザーとして、以下の権利があります：
+
+- 当社が保持している個人データへのアクセス
+- データの修正または削除の要求
+- アクセスの取り消しまたはアカウントの削除
+
+データに関するリクエストは、[contact@intlayer.org](mailto:contact@intlayer.org) までご連絡ください。
+
+## 本通知の変更
+
+このプライバシー通知は随時更新される場合があります。変更内容を把握するために、このページを定期的に確認することをお勧めします。

package/ja/roadmap.md

@@ -0,0 +1,206 @@
+# Intlayer: 機能概要とロードマップ
+
+Intlayerは、アプリケーション全体でコンテンツを宣言、管理、更新する方法を効率化するために設計されたコンテンツ管理および国際化ソリューションです。集中型または分散型のコンテンツ宣言、広範な国際化オプション、Markdownサポート、条件付きレンダリング、TypeScript/JavaScript/JSON統合などの強力な機能を提供します。以下は、Intlayerが現在提供している機能の包括的な概要と、今後のロードマップ機能です。
+
+---
+
+## 現在の機能
+
+### 1. コンテンツ宣言
+
+#### 集中型または分散型
+
+- **集中型**: i18nextのように、アプリケーションの基盤で単一の大きなファイルにすべてのコンテンツを宣言し、一元管理を可能にします。
+- **分散型**: 代わりに、コンポーネントや機能レベルでコンテンツを個別のファイルに分割して、保守性を向上させます。これにより、関連するコード（コンポーネント、テスト、Storybookなど）にコンテンツを近づけることができます。コンポーネントを削除すると、関連するコンテンツも削除され、コードベースに不要なデータが残るのを防ぎます。
+
+> リソース:
+
+> - [コンテンツ宣言](https://github.com/aymericzip/intlayer/blob/main/docs/ja/dictionary/get_started.md)
+
+### 2. 国際化
+
+- **230の言語とロケール**（フランス語（フランス）、英語（カナダ）、英語（イギリス）、ポルトガル語（ポルトガル）などの地域バリエーションを含む）をサポート。
+- これらすべてのロケールの翻訳を一元管理。
+
+> リソース:
+
+> - [国際化](https://github.com/aymericzip/intlayer/blob/main/docs/ja/dictionary/translation.md)
+
+### 3. Markdownサポート
+
+- **Markdown**を使用してコンテンツを宣言し、段落、見出し、リンクなどで自動的にテキストをフォーマット可能。
+- ブログ記事、ドキュメントページ、またはリッチテキストフォーマットが必要なシナリオに最適。
+
+> リソース:
+
+> - [Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/ja/dictionary/markdown.md)
+
+### 4. 条件付きレンダリング
+
+- ユーザーの言語、ログイン状態、その他のコンテキスト関連の変数に基づいて適応するコンテンツを定義。
+- 複数のファイルにコンテンツを複製することなく、パーソナライズされた体験を提供。
+
+> リソース:
+
+> - [条件付きレンダリング](https://github.com/aymericzip/intlayer/blob/main/docs/ja/dictionary/condition.md)
+
+### 5. コンテンツ宣言フォーマット
+
+Intlayerは、コンテンツ宣言に**TypeScript**（およびJavaScript）と**JSON**をサポートします。
+
+- **TypeScript**:
+
+  - コンテンツ構造が正しいこと、翻訳が欠けていないことを保証。
+  - 厳密または柔軟な検証モードを提供。
+  - 変数、関数、外部APIから動的データを取得可能。
+
+- **JSON**:
+
+  - 標準化されたフォーマットのため、外部ツール（ビジュアルエディタなど）との統合が容易。
+
+  > リソース:
+  >
+  > - [コンテンツ宣言フォーマット](https://github.com/aymericzip/intlayer/blob/main/docs/ja/dictionary/content_extention_customization.md)
+
+---
+
+## フレームワークと環境との統合
+
+### 1. Next.js
+
+#### a. サーバーおよびクライアントコンポーネント
+
+- サーバーおよびクライアントコンポーネントのための**統一されたコンテンツ管理アプローチ**を提供。
+- サーバーコンポーネントの組み込みコンテキストを提供し、他のソリューションと比較して実装を簡素化。
+
+#### b. メタデータ、サイトマップ、robots.txt
+
+- コンテンツを動的に取得して、メタデータ、サイトマップ、または`robots.txt`ファイルを生成。
+
+#### c. ミドルウェア
+
+- **ユーザーをリダイレクト**して、好みの言語に基づいたコンテンツを提供するミドルウェアを追加。
+
+#### d. TurbopackおよびWebpack互換性
+
+- 新しいNext.js Turbopackおよび従来のWebpackと完全互換。
+
+> リソース:
+
+> - [Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/ja/intlayer_with_nextjs_15.md)
+
+### 2. Vite
+
+- Next.jsと同様に、IntlayerをViteと統合し、**ミドルウェア**を使用してユーザーを好みの言語に基づいたコンテンツにリダイレクト可能。
+
+> リソース:
+
+> - [Vite](https://github.com/aymericzip/intlayer/blob/main/docs/ja/intlayer_with_vite+react.md)
+
+### 3. Express
+
+- Expressで構築されたバックエンドサービスのコンテンツを管理し、国際化を実現。
+- ローカライズされたテキストでメール、エラーメッセージ、プッシュ通知などをパーソナライズ。
+
+> リソース:
+
+> - [Express](https://github.com/aymericzip/intlayer/blob/main/docs/ja/intlayer_with_express.md)
+
+---
+
+## ビジュアルエディタとCMS
+
+### 1. ローカルビジュアルエディタ
+
+- ページ上の要素を直接選択してアプリケーションコンテンツを編集できる**無料のローカルビジュアルエディタ**。
+- AI機能を統合して以下を支援:
+  - 翻訳の生成または修正
+  - 構文とスペルのチェック
+  - 改善案の提案
+- ローカルでホストするか、リモートサーバーにデプロイ可能。
+
+> リソース:
+
+> - [ビジュアルエディタ](https://github.com/aymericzip/intlayer/blob/main/docs/ja/intlayer_visual_editor.md)
+
+### 2. Intlayer CMS（リモート）
+
+- コードベースに触れることなく、オンラインでアプリケーションコンテンツを管理できる**ホスト型CMS**ソリューション。
+- コンテンツ宣言、翻訳管理、構文やスペルエラーの修正を支援するAI機能を提供。
+- ライブアプリケーションインターフェースを介してコンテンツと対話。
+
+> リソース:
+
+> - [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/ja/intlayer_CMS.md)
+
+---
+
+## Intlayer CLI
+
+- **監査と翻訳生成**: コンテンツファイルを監査して、欠けている翻訳を生成したり、未使用のものを特定。
+- **リモート操作**: ローカルコンテンツをリモートCMSに公開したり、リモートコンテンツを取得してローカルアプリケーションに統合。
+- **CI/CDパイプライン**に役立ち、コンテンツが常にコードと同期していることを保証。
+
+> リソース:
+
+> - [CLI](https://github.com/aymericzip/intlayer/blob/main/docs/ja/intlayer_cli.md)
+
+---
+
+## 環境
+
+- **環境変数**を使用して、Intlayerを本番、テスト、ローカル環境で異なる設定に構成。
+- 環境に応じてターゲットとするビジュアルエディタまたはリモートCMSプロジェクトを定義。
+
+---
+
+## ホットコンテンツ更新
+
+- リモート辞書とIntlayer CMSを使用する場合、アプリケーションのコンテンツを**即座に更新**可能で、再デプロイは不要。
+
+> リソース:
+
+> - [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/ja/intlayer_CMS.md)
+
+---
+
+## ロードマップ: 今後の機能
+
+### 1. A/Bテストとパーソナライズ
+
+- **多変量テスト**: 特定のコンテンツの異なるバージョンをテストして、最も効果的なものを確認（例: クリック率が高いもの）。
+- **データ駆動型パーソナライズ**: ユーザーの属性（性別、年齢、場所など）や行動パターンに基づいて異なるコンテンツを表示。
+- **自動化された反復**: AIが複数のバージョンを自動的にテストし、最適なものを選択または管理者に推奨。
+
+### 2. バージョン管理
+
+- **コンテンツのバージョン管理**で以前のバージョンを復元。
+- 時間経過に伴う変更を追跡し、必要に応じて以前の状態に戻す。
+
+### 3. 自動翻訳
+
+- リモートCMSユーザー向けに、**ワンクリックで翻訳を生成**。
+- システムがバックグラウンドで翻訳を生成し、検証や編集を促す。
+
+### 4. SEO強化
+
+- **キーワード分析**、ユーザー検索意図、トレンドの分析ツール。
+- ランキング向上のために改善されたコンテンツを提案し、長期的なパフォーマンスを追跡。
+
+### 5. さらなるフレームワークとの互換性
+
+- **Vite、Angular、React Native**などのサポートを進行中。
+- **JavaScriptを使用するすべてのアプリケーション**との互換性を目指す。
+
+### 6. IDE拡張機能
+
+- 主要なIDE向けに拡張機能を提供し、ローカルおよびリモート翻訳を管理するための**グラフィカルインターフェース**を提供。
+- コンポーネント用のコンテンツ宣言ファイルを自動生成、Intlayer CMSとの直接統合、リアルタイム検証などの機能を含む可能性。
+
+---
+
+## 結論
+
+Intlayerは、コンテンツ管理と国際化のためのワンストップソリューションを目指しています。集中型または分散型ファイル、広範な言語サポート、最新のフレームワークやバンドラーとの簡単な統合、強力なAI駆動機能に焦点を当てています。A/Bテスト、バージョン管理、自動翻訳などの新機能が利用可能になるにつれ、Intlayerはコンテンツワークフローを簡素化し、さまざまなプラットフォームでのユーザー体験を向上させ続けます。
+
+今後のリリースにご期待ください。既存の機能を探索して、Intlayerがどのようにコンテンツ管理プロセスを中央集約化し、最適化できるかをご確認ください！

package/ja/terms_of_service.md

@@ -0,0 +1,33 @@
+# Intlayer 利用規約
+
+## 1. 利用規約の承諾
+
+Intlayer を使用することで、これらの利用規約に同意したものとみなされます。これらの規約に同意しない場合は、ツールを使用しないでください。
+
+## 2. ライセンス
+
+Intlayer は **Apache 2.0 ライセンス** の下で配布されており、オープンソースおよび商業プロジェクトのためにコードを使用、変更、配布することが許可されています。ユーザーはソースコードを変更し、[貢献ガイド](https://github.com/aymericzip/intlayer/blob/main/CONTRIBUTING.md) に従ってプルリクエストを通じて貢献を提出することができます。商業利用のためのコードの盗用は厳しく禁止されています。
+
+## 3. 商業利用
+
+Intlayer を商業プロジェクトに使用することは許可されています。ただし、Intlayer を基にした直接的な競合ツールを、重要な変革や実質的な価値の追加なしに再利用することは禁止されています。
+
+## 4. 責任
+
+Intlayer のメンテナーは、バグやセキュリティ問題が発見され次第、修正に努めます。しかし、ユーザーのインフラストラクチャにおけるこれらの問題による損害について責任を負いません。ユーザーには、[問題追跡システム](https://github.com/aymericzip/intlayer/issues) を通じて問題を報告することを推奨します。
+
+## 5. プライバシー
+
+Intlayer はユーザーの個人データを収集または保存しません。
+
+## 6. 貢献
+
+ユーザーは、貢献ガイドに従って Intlayer に貢献することを奨励されています。提出されたコードは、確立された品質基準に従う必要があり、統合前にメンテナーによるレビューを受けます。
+
+## 7. 帰属
+
+Intlayer のコードを拡張または利用するために開発されたツールは、Intlayer をコードの基盤として明確にクレジットする必要があります。この帰属は、ソースコード内およびユーザーまたはプロモーション用のドキュメント内で明示されなければなりません。
+
+## 8. 規約の変更
+
+これらの利用規約はいつでも変更される可能性があります。利用規約の重要な変更についてはユーザーに通知され、変更を受け入れることで Intlayer の使用を継続することができます。