@intlayer/docs 7.5.9 → 7.5.11

package/docs/it/intlayer_with_fastify.md

@@ -0,0 +1,445 @@
+---
+createdAt: 2025-12-30
+updatedAt: 2025-12-30
+title: Come tradurre il tuo backend Fastify – Guida i18n 2026
+description: Scopri come rendere il tuo backend Fastify multilingue. Segui la documentazione per internazionalizzare (i18n) e tradurlo.
+keywords:
+  - Internazionalizzazione
+  - Documentazione
+  - Intlayer
+  - Fastify
+  - JavaScript
+  - Backend
+slugs:
+  - doc
+  - environment
+  - fastify
+applicationTemplate: https://github.com/aymericzip/intlayer-fastify-template
+history:
+  - version: 7.6.0
+    date: 2025-12-31
+    changes: Add init command
+  - version: 7.6.0
+    date: 2025-12-31
+    changes: Init history
+---
+
+# Traduci il tuo backend Fastify utilizzando Intlayer | Internazionalizzazione (i18n)
+
+`fastify-intlayer` è un plugin di internazionalizzazione (i18n) potente per le applicazioni Fastify, progettato per rendere i tuoi servizi backend accessibili a livello globale fornendo risposte localizzate in base alle preferenze del client.
+
+### Casi d'uso pratici
+
+- **Mostrare gli errori del backend nella lingua dell'utente**: Quando si verifica un errore, mostrare i messaggi nella lingua nativa dell'utente migliora la comprensione e riduce la frustrazione. Questo è particolarmente utile per i messaggi di errore dinamici che potrebbero essere mostrati in componenti front-end come toast o modal.
+- **Recuperare contenuti multilingue**: Per applicazioni che estraggono contenuti da un database, l'internazionalizzazione garantisce la possibilità di servire tali contenuti in più lingue. Questo è fondamentale per piattaforme come siti di e-commerce o sistemi di gestione dei contenuti che devono mostrare descrizioni di prodotti, articoli e altri contenuti nella lingua preferita dall'utente.
+- **Invio di email multilingue**: Sia che si tratti di email transazionali, campagne di marketing o notifiche, inviare le email nella lingua del destinatario può aumentare significativamente il coinvolgimento e l'efficacia.
+- **Notifiche push multilingue**: Per le applicazioni mobili, inviare notifiche push nella lingua preferita dall'utente può migliorare l'interazione e la retention. Questo tocco personale può rendere le notifiche più rilevanti e facilmente azionabili.
+- **Altre comunicazioni**: Qualsiasi forma di comunicazione dal backend, come SMS, avvisi di sistema o aggiornamenti dell'interfaccia utente, trae vantaggio dall'essere nella lingua dell'utente, garantendo chiarezza e migliorando l'esperienza utente complessiva.
+
+Internationalizzando il backend, la tua applicazione non solo rispetta le differenze culturali ma si allinea anche meglio alle esigenze dei mercati globali, diventando così un passaggio chiave per scalare i tuoi servizi a livello mondiale.
+
+## Per iniziare
+
+### Installazione
+
+Per iniziare a utilizzare `fastify-intlayer`, installa il pacchetto usando npm:
+
+```bash packageManager="npm"
+npm install intlayer fastify-intlayer
+npx intlayer init
+
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer fastify-intlayer
+pnpm intlayer init
+
+```
+
+```bash packageManager="yarn"
+yarn add intlayer fastify-intlayer
+yarn intlayer init
+
+```
+
+```bash packageManager="bun"
+bun add intlayer fastify-intlayer
+bunx intlayer init
+
+```
+
+### Configurazione
+
+Configura le impostazioni di internazionalizzazione creando un file `intlayer.config.ts` nella root del tuo progetto:
+
+```typescript fileName="intlayer.config.ts"  codeFormat="typescript"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [
+      Locales.ENGLISH,
+      Locales.FRENCH,
+      Locales.SPANISH_MEXICO,
+      Locales.SPANISH_SPAIN,
+    ],
+    defaultLocale: Locales.ENGLISH,
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.mjs" codeFormat="esm"
+import { Locales } from "intlayer";
+
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  internationalization: {
+    locales: [
+      Locales.ENGLISH,
+      Locales.FRENCH,
+      Locales.SPANISH_MEXICO,
+      Locales.SPANISH_SPAIN,
+    ],
+    defaultLocale: Locales.ENGLISH,
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.cjs" codeFormat="commonjs"
+const { Locales } = require("intlayer");
+
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  internationalization: {
+    locales: [
+      Locales.ENGLISH,
+      Locales.FRENCH,
+      Locales.SPANISH_MEXICO,
+      Locales.SPANISH_SPAIN,
+    ],
+    defaultLocale: Locales.ENGLISH,
+  },
+};
+
+module.exports = config;
+```
+
+### Dichiarare il contenuto
+
+Crea e gestisci le dichiarazioni di contenuto per memorizzare le traduzioni:
+
+```typescript fileName="src/index.content.ts" contentDeclarationFormat="typescript"
+import { t, type Dictionary } from "intlayer";
+
+const indexContent = {
+  key: "index",
+  content: {
+    exampleOfContent: t({
+      it: "Esempio di contenuto restituito in italiano",
+      en: "Example of returned content in English",
+      fr: "Exemple de contenu renvoyé en français",
+      "es-ES": "Ejemplo de contenido devuelto en español (España)",
+      "es-MX": "Ejemplo de contenido devuelto en español (México)",
+    }),
+  },
+} satisfies Dictionary;
+
+export default indexContent;
+```
+
+```javascript fileName="src/index.content.mjs" contentDeclarationFormat="esm"
+import { t } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const indexContent = {
+  key: "index",
+  content: {
+    exampleOfContent: t({
+      it: "Esempio di contenuto restituito in italiano",
+      en: "Example of returned content in English",
+      fr: "Exemple de contenu renvoyé en français",
+      "es-ES": "Ejemplo de contenido devuelto en español (España)",
+      "es-MX": "Ejemplo de contenido devuelto en español (México)",
+    }),
+  },
+};
+
+export default indexContent;
+```
+
+```javascript fileName="src/index.content.cjs" contentDeclarationFormat="commonjs"
+const { t } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const indexContent = {
+  key: "index",
+  content: {
+    exampleOfContent: t({
+      it: "Esempio di contenuto restituito in italiano",
+      en: "Example of returned content in English",
+      fr: "Exemple de contenu renvoyé en français",
+      "es-ES": "Ejemplo de contenido devuelto en español (España)",
+      "es-MX": "Ejemplo de contenido devuelto en español (México)",
+    }),
+  },
+};
+
+module.exports = indexContent;
+```
+
+```json fileName="src/index.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "index",
+  "content": {
+    "exampleOfContent": {
+      "nodeType": "translation",
+      "translation": {
+        "it": "Esempio di contenuto restituito in italiano",
+        "en": "Example of returned content in English",
+        "fr": "Exemple de contenu renvoyé en français",
+        "es-ES": "Ejemplo de contenido devuelto en español (España)",
+        "es-MX": "Ejemplo de contenido devuelto en español (México)"
+      }
+    }
+  }
+}
+```
+
+> Le tue dichiarazioni di contenuto possono essere definite ovunque nella tua applicazione purché siano incluse nella directory `contentDir` (per impostazione predefinita, `./src`). E corrispondano all'estensione dei file di dichiarazione del contenuto (per impostazione predefinita, `.content.{json,ts,tsx,js,jsx,mjs,mjx,cjs,cjx}`).
+
+> Per maggiori dettagli, consulta la [documentazione sulle dichiarazioni di contenuto](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/content_file.md).
+
+### Impostazione dell'applicazione Fastify
+
+Configura la tua applicazione Fastify per usare `fastify-intlayer`:
+
+```typescript fileName="src/index.ts" codeFormat="typescript"
+import Fastify from "fastify";
+import { intlayer, t, getDictionary, getIntlayer } from "fastify-intlayer";
+import dictionaryExample from "./index.content";
+
+const fastify = Fastify({ logger: true });
+
+// Carica il plugin di internazionalizzazione
+await fastify.register(intlayer);
+
+// Rotte
+fastify.get("/t_example", async (_req, reply) => {
+  return t({
+    it: "Esempio di contenuto restituito in italiano",
+    en: "Example of returned content in English",
+    fr: "Exemple de contenu renvoyé en français",
+    "es-ES": "Ejemplo de contenido devuelto en español (España)",
+    "es-MX": "Ejemplo de contenido devuelto en español (México)",
+  });
+});
+
+fastify.get("/getIntlayer_example", async (_req, reply) => {
+  return getIntlayer("index").exampleOfContent;
+});
+
+fastify.get("/getDictionary_example", async (_req, reply) => {
+  return getDictionary(dictionaryExample).exampleOfContent;
+});
+
+// Avvia il server
+const start = async () => {
+  try {
+    await fastify.listen({ port: 3000 });
+  } catch (err) {
+    fastify.log.error(err);
+    process.exit(1);
+  }
+};
+
+start();
+```
+
+```javascript fileName="src/index.mjs" codeFormat="esm"
+import Fastify from "fastify";
+import { intlayer, t, getDictionary, getIntlayer } from "fastify-intlayer";
+import dictionaryExample from "./index.content";
+
+const fastify = Fastify({ logger: true });
+
+// Carica il plugin di internazionalizzazione
+await fastify.register(intlayer);
+
+// Rotte
+fastify.get("/t_example", async (_req, reply) => {
+  return t({
+    it: "Esempio di contenuto restituito in italiano",
+    en: "Example of returned content in English",
+    fr: "Exemple de contenu renvoyé en français",
+    "es-ES": "Ejemplo de contenido devuelto en español (España)",
+    "es-MX": "Ejemplo de contenido devuelto en español (México)",
+  });
+});
+
+fastify.get("/getIntlayer_example", async (_req, reply) => {
+  return getIntlayer("index").exampleOfContent;
+});
+
+fastify.get("/getDictionary_example", async (_req, reply) => {
+  return getDictionary(dictionaryExample).exampleOfContent;
+});
+
+// Avvia il server
+const start = async () => {
+  try {
+    await fastify.listen({ port: 3000 });
+  } catch (err) {
+    fastify.log.error(err);
+    process.exit(1);
+  }
+};
+
+start();
+```
+
+```javascript fileName="src/index.cjs" codeFormat="commonjs"
+const Fastify = require("fastify");
+const { intlayer, t, getDictionary, getIntlayer } = require("fastify-intlayer");
+const dictionaryExample = require("./index.content");
+
+const fastify = Fastify({ logger: true });
+
+// Wrapper per l'avvio del server con async/await
+const start = async () => {
+  try {
+    // Carica il plugin di internazionalizzazione
+    await fastify.register(intlayer);
+
+    // Rotte
+    fastify.get("/t_example", async (_req, reply) => {
+      return t({
+        it: "Esempio di contenuto restituito in italiano",
+        en: "Example of returned content in English",
+        fr: "Exemple de contenu renvoyé en français",
+        "es-ES": "Ejemplo de contenido devuelto en español (España)",
+        "es-MX": "Ejemplo de contenido devuelto en español (México)",
+      });
+    });
+
+    fastify.get("/getIntlayer_example", async (_req, reply) => {
+      return getIntlayer("index").exampleOfContent;
+    });
+
+    fastify.get("/getDictionary_example", async (_req, reply) => {
+      return getDictionary(dictionaryExample).exampleOfContent;
+    });
+
+    await fastify.listen({ port: 3000 });
+  } catch (err) {
+    fastify.log.error(err);
+    process.exit(1);
+  }
+};
+
+start();
+```
+
+### Compatibilità
+
+`fastify-intlayer` è completamente compatibile con:
+
+- [`react-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/react-intlayer/index.md) per applicazioni React
+- [`next-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/next-intlayer/index.md) per applicazioni Next.js
+- [`vite-intlayer`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/packages/vite-intlayer/index.md) per applicazioni Vite
+
+Funziona anche perfettamente con qualsiasi soluzione di internazionalizzazione in diversi ambienti, inclusi browser e richieste API. Puoi personalizzare il middleware per rilevare la locale tramite header o cookie:
+
+```typescript fileName="intlayer.config.ts" codeFormat="typescript"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  // ... Altre opzioni di configurazione
+  middleware: {
+    headerName: "my-locale-header",
+    cookieName: "my-locale-cookie",
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.mjs" codeFormat="esm"
+import { Locales } from "intlayer";
+
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  // ... Altre opzioni di configurazione
+  middleware: {
+    headerName: "my-locale-header",
+    cookieName: "my-locale-cookie",
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.cjs" codeFormat="commonjs"
+const { Locales } = require("intlayer");
+
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  // ... Altre opzioni di configurazione
+  middleware: {
+    headerName: "my-locale-header",
+    cookieName: "my-locale-cookie",
+  },
+};
+
+module.exports = config;
+```
+
+Per impostazione predefinita, `fastify-intlayer` interpreterà l'intestazione `Accept-Language` per determinare la lingua preferita del client.
+
+> Per ulteriori informazioni sulla configurazione e argomenti avanzati, visita la nostra [documentazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/configuration.md).
+
+### Configurare TypeScript
+
+`fastify-intlayer` sfrutta le robuste capacità di TypeScript per migliorare il processo di internazionalizzazione. Il typing statico di TypeScript garantisce che ogni chiave di traduzione sia conteggiata, riducendo il rischio di traduzioni mancanti e migliorando la manutenibilità.
+
+Assicurati che i tipi autogenerati (per impostazione predefinita in ./types/intlayer.d.ts) siano inclusi nel tuo file tsconfig.json.
+
+```json5 fileName="tsconfig.json"
+{
+  // ... Le tue configurazioni TypeScript esistenti
+  "include": [
+    // ... Le tue configurazioni TypeScript esistenti
+    ".intlayer/**/*.ts", // Includi i tipi auto-generati
+  ],
+}
+```
+
+### Estensione per VS Code
+
+Per migliorare la tua esperienza di sviluppo con Intlayer, puoi installare l'**Estensione Intlayer per VS Code** ufficiale.
+
+[Installa dal VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=intlayer.intlayer-vs-code-extension)
+
+Questa estensione offre:
+
+- **Completamento automatico** per le chiavi di traduzione.
+- **Rilevamento degli errori in tempo reale** per traduzioni mancanti.
+- **Anteprime inline** dei contenuti tradotti.
+- **Azioni rapide** per creare e aggiornare facilmente le traduzioni.
+
+Per maggiori dettagli su come usare l'estensione, consulta la [documentazione dell'Estensione Intlayer per VS Code](https://intlayer.org/doc/vs-code-extension).
+
+### Configurazione Git
+
+È consigliabile ignorare i file generati da Intlayer. Questo ti permette di evitare di commetterli nel tuo repository Git.
+
+Per farlo, puoi aggiungere le seguenti istruzioni al file `.gitignore`:
+
+```plaintext fileName=".gitignore"
+# Ignora i file generati da Intlayer
+.intlayer
+```

package/docs/it/readme.md

@@ -50,7 +50,7 @@ Con **file di contenuto per ogni locale**, **autocompletamento TypeScript**, **d
 | Caratteristica                                                                                                                                      | Descrizione                                                                                                                                                                                                                                                                                                                                                                                                                                        |
 | --------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true" alt="Feature" width="700">                          | **Supporto Cross-Framework**<br><br>Intlayer è compatibile con tutti i principali framework e librerie, inclusi Next.js, React, Vite, Vue.js, Nuxt, Preact, Express e altri ancora.                                                                                                                                                                                                                                                                |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.png?raw=true" alt="Feature" width="700">       | **Gestione dei Contenuti con JavaScript**<br><br>Sfrutta la flessibilità di JavaScript per definire e gestire i tuoi contenuti in modo efficiente. <br><br> - [Dichiarazione dei contenuti](https://intlayer.org/doc/concept/content)                                                                                                                                                                                                              |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.jpg?raw=true" alt="Feature" width="700">       | **Gestione dei Contenuti con JavaScript**<br><br>Sfrutta la flessibilità di JavaScript per definire e gestire i tuoi contenuti in modo efficiente. <br><br> - [Dichiarazione dei contenuti](https://intlayer.org/doc/concept/content)                                                                                                                                                                                                              |
 | <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true" alt="Feature" width="700"> | **File di Dichiarazione dei Contenuti per Locale**<br><br>Accelera il tuo sviluppo dichiarando i contenuti una sola volta, prima della generazione automatica.<br><br> - [File di Dichiarazione dei Contenuti per Locale](https://intlayer.org/doc/concept/per-locale-file)                                                                                                                                                                        |
 | <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true" alt="Feature" width="700">                      | **Ambiente Type-Safe**<br><br>Sfrutta TypeScript per garantire che le definizioni dei tuoi contenuti e il codice siano privi di errori, beneficiando anche dell'autocompletamento nell'IDE.<br><br> - [Configurazione di TypeScript](https://intlayer.org/doc/environment/vite-and-react#configure-typescript)                                                                                                                                     |
 | <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/config_file.png?raw=true" alt="Feature" width="700">                         | **Configurazione Semplificata**<br><br>Avvia rapidamente con una configurazione minima. Regola facilmente le impostazioni per l'internazionalizzazione, il routing, l'IA, la build e la gestione dei contenuti.<br><br> - [Esplora l'integrazione con Next.js](https://intlayer.org/doc/environment/nextjs)                                                                                                                                        |

package/docs/ja/cli/ci.md

@@ -0,0 +1,137 @@
+---
+createdAt: 2026-01-06
+updatedAt: 2026-01-06
+title: CIコマンド
+description: CI/CDパイプラインとモノレポで自動注入された認証情報を使用してIntlayerコマンドを実行する方法を学びます。
+keywords:
+  - CI
+  - CI/CD
+  - 自動化
+  - モノレポ
+  - 認証情報
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - ci
+history:
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: CIコマンドを追加
+---
+
+# CIコマンド
+
+```bash
+npx intlayer ci <command...>
+```
+
+CIコマンドは、自動化とCI/CDパイプライン用に設計されています。`INTLAYER_PROJECT_CREDENTIALS`環境変数から認証情報を自動的に注入し、モノレポ内の複数のプロジェクトでIntlayerコマンドを実行できます。
+
+## 動作方法
+
+CIコマンドは2つのモードで動作します：
+
+1. **単一プロジェクトモード**: 現在の作業ディレクトリが`INTLAYER_PROJECT_CREDENTIALS`内のプロジェクトパスのいずれかと一致する場合、その特定のプロジェクトに対してのみコマンドを実行します。
+
+2. **反復モード**: 特定のプロジェクトコンテキストが検出されない場合、すべての設定済みプロジェクトを反復処理し、それぞれに対してコマンドを実行します。
+
+## 環境変数
+
+コマンドには`INTLAYER_PROJECT_CREDENTIALS`環境変数の設定が必要です。この変数には、プロジェクトパスを認証情報にマッピングするJSONオブジェクトが含まれている必要があります：
+
+```json
+{
+  "packages/app": {
+    "clientId": "your-client-id-1",
+    "clientSecret": "your-client-secret-1"
+  },
+  "packages/admin": {
+    "clientId": "your-client-id-2",
+    "clientSecret": "your-client-secret-2"
+  }
+}
+```
+
+## パッケージマネージャーの検出
+
+CIコマンドは、`npm_config_user_agent`環境変数に基づいて使用されているパッケージマネージャー（npm、yarn、pnpm、またはbun）を自動的に検出し、Intlayerを実行するために適切なコマンドを使用します。
+
+## 引数
+
+- **`<command...>`**: 実行するIntlayerコマンド（例：`fill`、`push`、`build`）。任意のIntlayerコマンドとその引数を渡すことができます。
+
+  > 例: `npx intlayer ci fill --verbose`
+  >
+  > 例: `npx intlayer ci push`
+  >
+  > 例: `npx intlayer ci build`
+
+## 例
+
+### 単一プロジェクトモードでコマンドを実行
+
+`INTLAYER_PROJECT_CREDENTIALS`内のパスのいずれかと一致するプロジェクトディレクトリにいる場合：
+
+```bash
+cd packages/app
+npx intlayer ci fill
+```
+
+これにより、`packages/app`プロジェクトの認証情報が自動的に注入されて`fill`コマンドが実行されます。
+
+### すべてのプロジェクトでコマンドを実行
+
+プロジェクトパスと一致しないディレクトリにいる場合、コマンドはすべての設定済みプロジェクトを反復処理します：
+
+```bash
+cd /path/to/monorepo
+npx intlayer ci push
+```
+
+これにより、`INTLAYER_PROJECT_CREDENTIALS`で設定された各プロジェクトに対して`push`コマンドが実行されます。
+
+### 追加のフラグを渡す
+
+基になるIntlayerコマンドに任意のフラグを渡すことができます：
+
+```bash
+npx intlayer ci fill --verbose --mode complete
+```
+
+### CI/CDパイプラインで使用
+
+CI/CD設定（例：GitHub Actions、GitLab CI）で、`INTLAYER_PROJECT_CREDENTIALS`をシークレットとして設定します：
+
+```yaml
+# GitHub Actionsの例
+env:
+  INTLAYER_PROJECT_CREDENTIALS: ${{ secrets.INTLAYER_PROJECT_CREDENTIALS }}
+
+steps:
+  - name: 辞書を埋める
+    run: npx intlayer ci fill
+```
+
+## エラーハンドリング
+
+- `INTLAYER_PROJECT_CREDENTIALS`が設定されていない場合、コマンドはエラーで終了します。
+- `INTLAYER_PROJECT_CREDENTIALS`が有効なJSONでない場合、コマンドはエラーで終了します。
+- プロジェクトパスが存在しない場合、警告とともにスキップされます。
+- いずれかのプロジェクトが失敗した場合、コマンドは非ゼロのステータスコードで終了します。
+
+## 使用例
+
+- **モノレポの自動化**: モノレポ内の複数のプロジェクトでIntlayerコマンドを実行
+- **CI/CDパイプライン**: 継続的インテグレーションワークフローでの辞書管理の自動化
+- **一括操作**: 複数のIntlayerプロジェクトに対して同じ操作を一度に実行
+- **シークレット管理**: 環境変数を使用して複数のプロジェクトの認証情報を安全に管理
+
+## セキュリティのベストプラクティス
+
+- CI/CDプラットフォームで`INTLAYER_PROJECT_CREDENTIALS`を暗号化されたシークレットとして保存
+- 認証情報をバージョン管理にコミットしない
+- 異なるデプロイ環境に対して環境固有の認証情報を使用
+- 定期的に認証情報をローテーション

package/docs/ja/cli/index.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-12-30
+updatedAt: 2026-01-06
 title: CLI
 description: Intlayer CLIを使用して多言語ウェブサイトを管理する方法を紹介します。このオンラインドキュメントの手順に従って、数分でプロジェクトをセットアップしましょう。
 keywords:
@@ -17,6 +17,9 @@ slugs:
   - concept
   - cli
 history:
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: projects listコマンドを追加
   - version: 7.5.9
     date: 2025-12-30
     changes: initコマンドを追加
@@ -119,6 +122,7 @@ Intlayer は複数の設定ファイル形式をサポートしています：
 - **[辞書のビルド](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/build.md)** - コンテンツ宣言ファイルから辞書をビルドします
 - **[辞書の監視](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/watch.md)** - 変更を監視し、自動的に辞書をビルドします
 - **[CLI バージョンの確認](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/version.md)** - インストールされている Intlayer CLI のバージョンを確認します
+- **[プロジェクトの一覧表示](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/cli/list_projects.md)** - ディレクトリまたはgitリポジトリ内のすべてのIntlayerプロジェクトを一覧表示します
 
 ### 辞書管理
 
@@ -166,6 +170,7 @@ Intlayer は複数の設定ファイル形式をサポートしています：
   "intlayer:list": "npx intlayer content list",
   "intlayer:test": "npx intlayer content test",
   "intlayer:transform": "npx intlayer transform",
+  "intlayer:projects": "npx intlayer projects list",
   "intlayer:doc:translate": "npx intlayer doc translate",
   "intlayer:doc:review": "npx intlayer doc review"
 }
@@ -175,3 +180,4 @@ Intlayer は複数の設定ファイル形式をサポートしています：
 >
 > - `npx intlayer list` は `npx intlayer content list` の代わりに使用可能
 > - `npx intlayer test` は `npx intlayer content test` の代わりに使用可能
+> - `npx intlayer projects-list` または `npx intlayer pl` は `npx intlayer projects list` の代わりに使用可能