@intlayer/docs 5.5.9 → 5.5.11

package/docs/it/roadmap.md

@@ -0,0 +1,337 @@
+---
+createdAt: 2025-03-01
+updatedAt: 2025-06-29
+title: Roadmap
+description: Scopri la roadmap di Intlayer. Visualizza tutte le funzionalità che Intlayer ha implementato e che prevede di implementare.
+keywords:
+  - Roadmap
+  - Intlayer
+  - Internazionalizzazione
+  - CMS
+  - Sistema di Gestione dei Contenuti
+  - Editor Visivo
+slugs:
+  - doc
+  - roadmap
+---
+
+# Intlayer: Panoramica delle Funzionalità & Roadmap
+
+Intlayer è una soluzione per la gestione dei contenuti e l'internazionalizzazione progettata per semplificare il modo in cui dichiari, gestisci e aggiorni i contenuti nelle tue applicazioni. Offre funzionalità potenti come la dichiarazione dei contenuti centralizzata o distribuita, ampie opzioni di internazionalizzazione, supporto per Markdown, rendering condizionale, integrazione con TypeScript/JavaScript/JSON e altro ancora. Di seguito è riportata una panoramica completa di ciò che Intlayer offre attualmente, seguita dalle funzionalità previste nella roadmap.
+
+---
+
+## Funzionalità Attuali
+
+### 1. Dichiarazione dei Contenuti
+
+#### Centralizzata o Distribuita
+
+- **Centralizzata**: Dichiara tutti i tuoi contenuti in un unico grande file alla base della tua applicazione, simile a i18next, in modo da poter gestire tutto in un unico posto.
+- **Distribuita**: In alternativa, suddividi i tuoi contenuti in file separati a livello di componente o funzionalità per una migliore manutenibilità. Questo mantiene i tuoi contenuti vicini al codice pertinente (componenti, test, Storybook, ecc.). Rimuovendo un componente, si assicura che anche i contenuti associati vengano eliminati, evitando che dati residui ingombrino il tuo codice.
+
+> Risorse:
+>
+> - [Dichiarazione dei Contenuti](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/get_started.md)
+
+### 2. Internazionalizzazione
+
+- Supporto per **230 lingue e località** (inclusi varianti regionali come francese (Francia), inglese (Canada), inglese (Regno Unito), portoghese (Portogallo), ecc.).
+- Gestisci facilmente le traduzioni per tutte queste località da un unico posto.
+
+> Risorse:
+>
+> - [Internazionalizzazione](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/translation.md)
+
+### 3. Supporto Markdown
+
+- Dichiara contenuti usando **Markdown**, permettendoti di formattare automaticamente il testo con paragrafi, titoli, link e altro.
+- Ideale per post di blog, articoli, pagine di documentazione o qualsiasi scenario in cui sia necessaria una formattazione di testo ricca.
+
+> Risorse:
+>
+> - [Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/markdown.md)
+
+### 4. Supporto file esterni
+
+- Importa contenuti da file esterni in formato testo, come TXT, HTML, JSON, YAML o CSV.
+- Usa la funzione `file` in Intlayer per incorporare il contenuto di file esterni in un dizionario, garantendo un'integrazione senza soluzione di continuità con l'Editor Visuale e il CMS di Intlayer.
+- Supporta aggiornamenti dinamici dei contenuti, il che significa che quando il file sorgente viene modificato, il contenuto si aggiorna automaticamente all'interno di Intlayer.
+- Consente la gestione multilingue dei contenuti collegando dinamicamente file Markdown specifici per lingua.
+
+> Risorse:
+>
+> - [Incorporamento contenuti da file](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/file.md)
+
+### 5. Contenuto Dinamico e Recupero Funzioni
+
+Intlayer offre vari metodi per inserire e gestire contenuti dinamici, garantendo flessibilità e adattabilità nella distribuzione dei contenuti. Questo include funzioni per l'inserimento dinamico di contenuti, il rendering condizionale, l'enumerazione, l'annidamento e il recupero di funzioni.
+
+1. Inserimento di Contenuti Dinamici
+
+   Usa la funzione insert per definire contenuti con segnaposto ({{name}}, {{age}}, ecc.).
+
+   Consente contenuti simili a template che si adattano in base all'input dell'utente, alle risposte API o ad altre fonti di dati dinamici.
+
+   Funziona perfettamente con configurazioni TypeScript, ESM, CommonJS e JSON.
+
+   Si integra facilmente con React Intlayer e Next Intlayer utilizzando useIntlayer.
+
+2. Rendering Condizionale
+
+   Definisce contenuti che si adattano in base a condizioni specifiche dell'utente, come la lingua o lo stato di autenticazione.
+
+   Personalizza esperienze senza duplicare contenuti su più file.
+
+3. Enumerazione e Pluralizzazione
+
+   Usa la funzione enu per definire variazioni di contenuto basate su valori numerici, intervalli o chiavi personalizzate.
+
+   Garantisce la selezione automatica della frase corretta in base a un valore dato.
+
+   Supporta regole di ordinamento, assicurando un comportamento prevedibile.
+
+4. Annidamento e Riferimento a Sotto-Contenuti
+
+   Usa la funzione nest per fare riferimento e riutilizzare contenuti da un altro dizionario, riducendo la duplicazione.
+
+   Supporta una gestione dei contenuti strutturata e gerarchica per una migliore manutenibilità.
+
+5. Recupero tramite Funzioni
+
+   Intlayer consente di dichiarare i contenuti come funzioni, permettendo sia il recupero sincrono che asincrono dei contenuti.
+
+   Funzioni Sincrone: I contenuti vengono generati dinamicamente in fase di build.
+
+   Funzioni Asincrone: Recupera dati da fonti esterne (es. API, database) in modo dinamico.
+
+   Integrazione: Funziona con TypeScript, ESM e CommonJS ma non è supportato nei file JSON o nei file di contenuti remoti.
+
+### 6. Formati di Dichiarazione dei Contenuti
+
+Intlayer supporta **TypeScript** (e anche JavaScript) e **JSON** per dichiarare i contenuti.
+
+- **TypeScript**:
+
+  - Garantisce che la struttura del contenuto sia corretta e che non manchino traduzioni.
+  - Offre modalità di validazione rigorose o più flessibili.
+  - Permette il recupero dinamico dei dati da variabili, funzioni o API esterne.
+
+- **JSON**:
+
+  - Facilita l'integrazione con strumenti esterni (come editor visuali) grazie al suo formato standardizzato.
+
+  > Risorse:
+  >
+  > - [Formati di Dichiarazione del Contenuto](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/content_extention_customization.md)
+
+### 7. Pulizia, ottimizzazione del bundle e importazioni dinamiche
+
+- Intlayer integra i plugin `Babel` e `SWC` per ottimizzare il tuo bundle e migliorare le prestazioni. Sostituisce gli import, permettendo di importare solo i dizionari effettivamente utilizzati nel bundle.
+- Attivando l'opzione, Intlayer consente anche di importare dinamicamente il contenuto del dizionario solo per la locale corrente.
+
+> Risorse:
+>
+> - [Configurazione della Build](https://intlayer.org/doc/concept/configuration#build-configuration)
+
+---
+
+## Integrazione con Framework e Ambienti
+
+### 1. Next.js
+
+#### a. Componenti Server e Client
+
+- Fornisce un **approccio unificato alla gestione dei contenuti** sia per i componenti server che client.
+- Offre un contesto integrato per i componenti server, semplificando l'implementazione rispetto ad altre soluzioni.
+
+#### b. Metadata, Sitemap e robots.txt
+
+- Recupera e inietta contenuti dinamicamente per generare metadata, sitemap o file `robots.txt`.
+
+#### c. Middleware
+
+- Aggiunge un middleware per **reindirizzare gli utenti** ai contenuti basati sulla loro lingua preferita.
+
+#### d. Compatibilità Turbopack e Webpack
+
+- Completamente compatibile con il nuovo Turbopack di Next.js così come con il tradizionale Webpack.
+
+> Risorse:
+>
+> - [Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_with_nextjs_15.md)
+
+### 2. Vite
+
+- Simile a Next.js, puoi integrare Intlayer con Vite e utilizzare un **middleware** per reindirizzare gli utenti ai contenuti in base alla loro lingua preferita.
+
+> Risorse:
+>
+> - [Vite](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_with_vite+react.md)
+
+### 3. Express
+
+- Gestisci i contenuti e internazionalizza i servizi backend basati su Express.
+- Personalizza email, messaggi di errore, notifiche push e altro ancora con testi localizzati.
+
+> Risorse:
+>
+> - [Express](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_with_express.md)
+
+### 4. React Native
+
+- Integra Intlayer con React Native per gestire i contenuti e internazionalizzare le tue applicazioni mobili.
+- Supporta entrambe le piattaforme iOS e Android.
+
+> Risorse:
+>
+> - [React Native](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_with_react_native.md)
+
+### 5. Lynx
+
+- Integra Intlayer con Lynx per gestire i contenuti e internazionalizzare le tue applicazioni mobili.
+- Supporta entrambe le piattaforme iOS e Android.
+
+> Risorse:
+>
+> - [Lynx](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_with_lynx.md)
+
+### 6. Vue
+
+- Integra Intlayer con Vue per gestire i contenuti e internazionalizzare le tue applicazioni Vite / Vue.js.
+
+> Risorse:
+>
+> - [Vue](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_with_vue.md)
+
+### 7. Nuxt
+
+- Integra Intlayer con Nuxt per gestire i contenuti e internazionalizzare le tue applicazioni Nuxt / Vue.js.
+- Supporta sia componenti server che client.
+- Integra il routing e il middleware per reindirizzare gli utenti ai contenuti in base alla loro lingua preferita.
+
+> Risorse:
+>
+> - [Nuxt](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_with_nuxt.md)
+
+### 8. Preact
+
+- Integra Intlayer con Preact per gestire i contenuti e internazionalizzare le tue applicazioni Preact.
+
+> Risorse:
+>
+> - [Preact](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_with_preact.md)
+
+---
+
+## Editor Visuali e CMS
+
+### 1. Editor Visuale Locale
+
+- Un **editor visuale locale gratuito** che ti permette di modificare il contenuto della tua applicazione selezionando direttamente gli elementi sulla pagina.
+- Integra funzionalità di intelligenza artificiale per aiutarti a:
+  - Generare o correggere traduzioni
+  - Controllare sintassi e ortografia
+  - Suggerire miglioramenti
+- Può essere ospitato localmente o distribuito su un server remoto.
+
+> Risorse:
+>
+> - [Editor Visuale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_visual_editor.md)
+
+### 2. Intlayer CMS (Remoto)
+
+- Una soluzione **CMS ospitata** che ti consente di gestire il contenuto dell'applicazione online, senza modificare il codice.
+- Fornisce funzionalità assistite da AI per dichiarare contenuti, gestire traduzioni e correggere errori di sintassi o ortografia.
+- Interagisci con i tuoi contenuti tramite l'interfaccia della tua applicazione live.
+
+> Risorse:
+>
+> - [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_CMS.md)
+
+---
+
+## Estensioni IDE
+
+- Estensioni per i principali IDE che forniscono un'**interfaccia grafica** per gestire le traduzioni locali e remote.
+- Le funzionalità potrebbero includere la generazione automatica di file di dichiarazione dei contenuti per i componenti, l'integrazione diretta con l'Intlayer CMS e la validazione in tempo reale.
+
+---
+
+## Server MCP
+
+- Un **server MCP** che ti permette di gestire i tuoi contenuti e traduzioni utilizzando uno strumento integrato nel tuo IDE.
+
+---
+
+## Intlayer CLI
+
+- **Traduzione e generazione file**: Esegui audit sui tuoi file di contenuto per generare traduzioni mancanti e rivedere le incoerenze.
+- **Interazione remota**: Invia i tuoi contenuti locali al CMS remoto o scarica contenuti remoti per integrarli nella tua applicazione locale.
+- **Traduzione e revisione della documentazione**: Traduci e rivedi la tua documentazione / file ecc.
+
+> Risorse:
+>
+> - [CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_cli.md)
+
+---
+
+## Ambienti
+
+- Usa le **variabili d'ambiente** per configurare Intlayer in modo differente tra produzione, test e ambienti locali.
+- Definisci quale editor visuale o progetto CMS remoto utilizzare a seconda del tuo ambiente.
+
+---
+
+## Aggiornamenti Contenuti a Caldo
+
+- Quando usi dizionari remoti e il CMS Intlayer, puoi **aggiornare i contenuti della tua applicazione al volo**, senza bisogno di ridistribuire.
+
+> Risorse:
+>
+> - [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/intlayer_CMS.md)
+
+---
+
+## Funzionalità in Arrivo
+
+### 1. Test A/B e Personalizzazione
+
+- **Test multivariati**: Testa diverse versioni di un dato contenuto per vedere quale funziona meglio (ad esempio, con un tasso di clic più alto).
+- **Personalizzazione basata sui dati**: Mostra contenuti diversi in base a dati demografici dell’utente (genere, età, posizione, ecc.) o altri modelli di comportamento.
+- **Iterazione automatizzata**: Permetti all’IA di testare automaticamente più versioni e scegliere quella con le migliori prestazioni o raccomandare opzioni per l’approvazione dell’amministratore.
+
+### 2. Versionamento
+
+- Ripristina versioni precedenti dei tuoi contenuti con il **versionamento dei contenuti**.
+- Monitora le modifiche nel tempo e torna a stati precedenti se necessario.
+
+### 3. Traduzione automatica
+
+- Per gli utenti del CMS remoto, **generazione della traduzione con un clic** per qualsiasi lingua supportata.
+- Il sistema genererebbe traduzioni in background e poi ti chiederebbe di convalidarle o modificarle.
+
+### 4. Miglioramenti SEO
+
+- Strumenti per **analizzare le parole chiave**, l'intento di ricerca degli utenti e le tendenze emergenti.
+- Suggerire contenuti migliorati per un posizionamento migliore e monitorare le prestazioni a lungo termine.
+
+### 5. Compatibilità con più Framework
+
+- Sono in corso sforzi per supportare **Solid, Svelte, Angular** e altri.
+- L'obiettivo è rendere Intlayer compatibile con **qualsiasi applicazione basata su JavaScript**.
+
+---
+
+## Conclusione
+
+Intlayer mira a essere una soluzione completa per la gestione dei contenuti e l'internazionalizzazione. Si concentra sulla flessibilità (file centralizzati o distribuiti), sul supporto a un'ampia gamma di lingue, sull'integrazione semplice con framework e bundler moderni, e su potenti funzionalità basate sull'intelligenza artificiale. Man mano che nuove capacità, come i test A/B, il versioning e le traduzioni automatizzate, diventeranno disponibili, Intlayer continuerà a semplificare i flussi di lavoro dei contenuti e a migliorare l'esperienza utente su diverse piattaforme.
+
+Rimanete sintonizzati per i prossimi rilasci e sentitevi liberi di esplorare le funzionalità esistenti per vedere come Intlayer può aiutare a centralizzare e ottimizzare oggi i vostri processi di gestione dei contenuti!
+
+---
+
+## Cronologia del Documento
+
+- 5.5.10 - 2025-06-30: Aggiunto supporto per Preact e Nuxt, MCP Server, aggiornamento CLI
+- 5.5.10 - 2025-06-29: Inizializzazione della cronologia

package/docs/it/vs_code_extension.md

@@ -0,0 +1,153 @@
+---
+createdAt: 2025-03-17
+updatedAt: 2025-06-29
+title: Estensione Ufficiale per VS Code
+description: Scopri come utilizzare l'estensione Intlayer in VS Code per migliorare il tuo flusso di lavoro di sviluppo. Naviga rapidamente tra contenuti localizzati e gestisci i tuoi dizionari in modo efficiente.
+keywords:
+  - Estensione VS Code
+  - Intlayer
+  - Localizzazione
+  - Strumenti di Sviluppo
+  - React
+  - Next.js
+  - JavaScript
+  - TypeScript
+slugs:
+  - doc
+  - it
+  - vs-code-extension
+---
+
+# Estensione Ufficiale per VS Code
+
+## Panoramica
+
+[**Intlayer**](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension) è l'estensione ufficiale di Visual Studio Code per **Intlayer**, progettata per migliorare l'esperienza dello sviluppatore quando si lavora con contenuti localizzati nei tuoi progetti.
+
+![Estensione Intlayer per VS Code](https://github.com/aymericzip/intlayer/blob/main/docs/assets/vs_code_extension_demo.gif)
+
+Link all'estensione: [https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension](https://marketplace.visualstudio.com/items?itemName=Intlayer.intlayer-vs-code-extension)
+
+## Funzionalità
+
+### Navigazione Istantanea
+
+**Supporto Vai alla Definizione** – Usa `Cmd+Click` (Mac) o `Ctrl+Click` (Windows/Linux) su una chiave `useIntlayer` per aprire istantaneamente il file di contenuto corrispondente.  
+**Integrazione Perfetta** – Funziona senza sforzo con progetti **react-intlayer** e **next-intlayer**.  
+**Supporto Multilingue** – Supporta contenuti localizzati in diverse lingue.  
+**Integrazione con VS Code** – Si integra perfettamente con la navigazione e la palette dei comandi di VS Code.
+
+### Comandi per la Gestione dei Dizionari
+
+Gestisci i tuoi dizionari di contenuti direttamente da VS Code:
+
+- **Costruisci Dizionari** (`extension.buildDictionaries`) – Genera i file di contenuto basati sulla struttura del tuo progetto.
+- **Carica Dizionari** (`extension.pushDictionaries`) – Carica l'ultimo contenuto del dizionario nel tuo repository.
+- **Scarica Dizionari** (`extension.pullDictionaries`) – Sincronizza l'ultimo contenuto del dizionario dal tuo repository al tuo ambiente locale.
+
+### Generatore di Dichiarazioni di Contenuto
+
+Genera facilmente file di dizionari strutturati in diversi formati:
+
+- **TypeScript (`.ts`)** – `extension.createDictionaryFile.ts`
+- **ES Module (`.esm`)** – `extension.createDictionaryFile.esm`
+- **CommonJS (`.cjs`)** – `extension.createDictionaryFile.cjs`
+- **JSON (`.json`)** – `extension.createDictionaryFile.json`
+
+## Installazione
+
+Puoi installare **Intlayer** direttamente dal Marketplace di VS Code:
+
+1. Apri **VS Code**.
+2. Vai al **Marketplace delle Estensioni**.
+3. Cerca **"Intlayer"**.
+4. Clicca su **Installa**.
+
+In alternativa, installalo tramite la riga di comando:
+
+```sh
+code --install-extension intlayer
+```
+
+## Utilizzo
+
+### Navigazione Rapida
+
+1. Apri un progetto che utilizza **react-intlayer**.
+2. Individua una chiamata a `useIntlayer()`, come:
+
+   ```tsx
+   const content = useIntlayer("app");
+   ```
+
+3. **Command-click** (`⌘+Click` su macOS) o **Ctrl+Click** (su Windows/Linux) sulla chiave (es. `"app"`).
+4. VS Code aprirà automaticamente il file dizionario corrispondente, ad esempio `src/app.content.ts`.
+
+### Gestione dei Dizionari di Contenuto
+
+#### Costruire i Dizionari
+
+Genera tutti i file di contenuto dei dizionari con:
+
+```sh
+Cmd + Shift + P (macOS) / Ctrl + Shift + P (Windows/Linux)
+```
+
+Cerca **Build Dictionaries** ed esegui il comando.
+
+#### Caricare i Dizionari
+
+Carica l'ultimo contenuto dei dizionari:
+
+1. Apri la **Command Palette**.
+2. Cerca **Push Dictionaries**.
+3. Seleziona i dizionari da caricare e conferma.
+
+#### Scaricare i Dizionari
+
+Sincronizza l'ultimo contenuto dei dizionari:
+
+1. Apri la **Command Palette**.
+2. Cerca **Pull Dictionaries**.
+3. Scegli i dizionari da scaricare.
+
+## Sviluppo e Contributi
+
+Vuoi contribuire? Accogliamo con piacere i contributi della community!
+
+URL del repository: https://github.com/aymericzip/intlayer-vs-code-extension
+
+### Iniziare
+
+Clona il repository e installa le dipendenze:
+
+```sh
+git clone https://github.com/aymericzip/intlayer-vs-code-extension.git
+cd intlayer-vs-code-extension
+npm install
+```
+
+> Usa il package manager `npm` per la compatibilità con il pacchetto `vsce` per costruire e pubblicare l'estensione.
+
+### Eseguire in Modalità Sviluppo
+
+1. Apri il progetto in **VS Code**.
+2. Premi `F5` per avviare una nuova finestra **Extension Development Host**.
+
+### Inviare una Pull Request
+
+Se migliori l'estensione, invia una PR su [GitHub](https://github.com/aymericzip/intlayer-vs-code-extension).
+
+## Feedback e Problemi
+
+Hai trovato un bug o hai una richiesta di funzionalità? Apri un issue nel nostro **repository GitHub**:
+
+[GitHub Issues](https://github.com/aymericzip/intlayer-vs-code-extension/issues)
+
+## Licenza
+
+Intlayer è rilasciato sotto la **Licenza MIT**.
+
+## Cronologia della Documentazione
+
+- 5.5.10 - 2025-06-29: Storia iniziale

package/docs/ja/CI_CD.md

@@ -0,0 +1,172 @@
+---
+createdAt: 2025-05-20
+updatedAt: 2025-06-29
+title: CI/CD 統合
+description: Intlayer を CI/CD パイプラインに統合して、自動化されたコンテンツ管理とデプロイメントを実現する方法を学びます。
+keywords:
+  - CI/CD
+  - 継続的インテグレーション
+  - 継続的デプロイメント
+  - 自動化
+  - 国際化
+  - ドキュメンテーション
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - ci-cd
+---
+
+# CI/CD パイプラインでの翻訳の自動生成
+
+Intlayer は、コンテンツ宣言ファイルの翻訳を自動的に生成することを可能にします。ワークフローに応じて、これを実現する複数の方法があります。
+
+## CMS の利用
+
+Intlayer を使用すると、ローカルでは単一のロケールのみを宣言し、すべての翻訳を CMS を通じてリモートで管理するワークフローを採用できます。これにより、コンテンツと翻訳がコードベースから完全に切り離され、コンテンツ編集者にとってより柔軟性が高まり、ホットコンテンツリロード（変更を適用するためにアプリケーションを再ビルドする必要なし）が可能になります。
+
+### 設定例
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.SPANISH, Locales.FRENCH],
+    requiredLocales: [Locales.ENGLISH], // オプションのロケールはリモートで管理されます
+    defaultLocale: Locales.ENGLISH,
+  },
+  editor: {
+    dictionaryPriorityStrategy: "distant_first", // リモートコンテンツが優先されます
+
+    applicationURL: process.env.APPLICATION_URL, // CMSで使用されるアプリケーションのURL
+
+    clientId: process.env.INTLAYER_CLIENT_ID, // CMSの認証情報
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+  },
+  ai: {
+    applicationContext: "This is a test application", // 一貫した翻訳生成を支援します
+  },
+};
+
+export default config;
+```
+
+CMSの詳細については、[公式ドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_CMS.md)を参照してください。
+
+## Huskyの使用方法
+
+[Husky](https://typicode.github.io/husky/)を使用して、ローカルのGitワークフローに翻訳生成を統合できます。
+
+### 設定例
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.SPANISH, Locales.FRENCH],
+    requiredLocales: [Locales.ENGLISH], // オプションのロケールはリモートで処理されます
+    defaultLocale: Locales.ENGLISH,
+  },
+  editor: {
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+  },
+  ai: {
+    provider: "openai",
+    apiKey: process.env.OPENAI_API_KEY, // ご自身のAPIキーを使用してください
+
+    applicationContext: "これはテストアプリケーションです", // 一貫した翻訳生成を確保するのに役立ちます
+  },
+};
+
+export default config;
+```
+
+```bash fileName=".husky/pre-push"
+npx intlayer build                          # 辞書が最新であることを確認するため
+npx intlayer fill --unpushed --mode fill    # 欠落しているコンテンツのみを埋め、既存のものは更新しません
+```
+
+> IntlayerのCLIコマンドとその使用方法の詳細については、[CLIドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_cli.md)を参照してください。
+
+> リポジトリ内に複数のアプリがあり、それぞれ別のintlayerインスタンスを使用している場合は、次のように`--base-dir`引数を使用できます。
+
+```bash fileName=".husky/pre-push"
+# アプリ1
+npx intlayer build --base-dir ./app1
+npx intlayer fill --base-dir ./app1 --unpushed --mode fill
+
+# アプリ2
+npx intlayer build --base-dir ./app2
+npx intlayer fill --base-dir ./app2 --unpushed --mode fill
+```
+
+## GitHub Actionsの使用方法
+
+Intlayerは、辞書の内容を自動入力およびレビューするためのCLIコマンドを提供しています。これはGitHub Actionsを使用してCI/CDワークフローに統合することができます。
+
+```yaml fileName=".github/workflows/intlayer-translate.yml"
+name: Intlayer 自動入力
+on:
+  push:
+    branches: [ main ]
+    paths:
+      - 'src/**'
+  pull_request:
+    branches: [ main ]
+    paths:
+      - 'src/**'
+  workflow_dispatch: {}
+
+concurrency:
+  group: 'autofill-${{ github.ref }}'
+  cancel-in-progress: true
+
+jobs:
+  autofill:
+    runs-on: ubuntu-latest
+    env:
+      INTLAYER_CLIENT_ID: ${{ secrets.INTLAYER_CLIENT_ID }}
+      INTLAYER_CLIENT_SECRET: ${{ secrets.INTLAYER_CLIENT_SECRET }}
+      OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+
+    steps:
+      - name: ⬇️ リポジトリをチェックアウト
+        uses: actions/checkout@v3
+        with:
+          persist-credentials: true
+
+      - name: 🟢 Node.js のセットアップ
+        uses: actions/setup-node@v3
+        with:
+          node-version: 20
+
+      - name: 📦 依存関係のインストール
+        run: npm ci
+
+      - name: ⚙️ Intlayer プロジェクトのビルド
+        run: npx intlayer build
+
+      - name: 🤖 欠落している翻訳の自動補完
+        run: npx intlayer fill --git-diff --mode fill
+
+      - name: 📤 翻訳プルリクエストの作成または更新
+        uses: peter-evans/create-pull-request@v4
+        with:
+          commit-message: chore: auto-fill missing translations [skip ci]
+          branch: auto-translations
+          title: chore: update missing translations
+          labels: translation, automated
+```
+
+> Huskyの場合と同様に、モノレポの場合は `--base-dir` 引数を使用して各アプリを順次処理することができます。
+
+> デフォルトでは、`--git-diff` 引数はベース（デフォルトは `origin/main`）から現在のブランチ（デフォルトは `HEAD`）への変更を含む辞書をフィルタリングします。
+
+> Intlayer CLI コマンドとその使用方法の詳細については、[CLIドキュメント](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ja/intlayer_cli.md)を参照してください。
+
+## ドキュメント履歴
+
+- 5.5.10 - 2025-06-29: 履歴の初期化