@intlayer/docs 8.9.4-canary.0 → 8.9.5

package/docs/it/dictionary/content_file.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-02-07
-updatedAt: 2026-01-28
+updatedAt: 2026-05-12
 title: File di Contenuto
 description: Scopri come personalizzare le estensioni per i tuoi file di dichiarazione dei contenuti. Segui questa documentazione per implementare condizioni in modo efficiente nel tuo progetto.
 keywords:
@@ -12,6 +12,9 @@ slugs:
   - concept
   - content
 history:
+  - version: 8.9.0
+    date: 2026-05-12
+    changes: "Aggiungi il tipo di nodo di contenuto `plural`"
   - version: 8.0.0
     date: 2026-01-28
     changes: "Aggiunto tipo di nodo contenuto `html`"
@@ -63,6 +66,7 @@ import { type ReactNode } from "react";
 import {
   t,
   enu,
+  plural,
   cond,
   nest,
   md,
@@ -82,6 +86,7 @@ interface Content {
   };
   multilingualContent: string;
   quantityContent: string;
+  pluralContent: string;
   conditionalContent: string;
   markdownContent: never;
   htmlContent: never;
@@ -118,6 +123,10 @@ export default {
       ">5": "Alcune macchine",
       ">19": "Molte macchine",
     }),
+    pluralContent: plural({
+      one: "One car",
+      other: "{{count}} cars",
+    }),
     conditionalContent: cond({
       true: "La validazione è abilitata",
       false: "La validazione è disabilitata",
@@ -172,6 +181,13 @@ export default {
         ">5": "Alcune auto",
         ">19": "Molte auto",
       },
+      "pluralContent": {
+        "nodeType": "plural",
+        "plural": {
+          "one": "One car",
+          "other": "{{count}} cars",
+        },
+      },
     },
     "conditionalContent": {
       "nodeType": "condizione",
@@ -219,6 +235,7 @@ I nodi di contenuto sono i mattoni fondamentali del contenuto del dizionario. Po
 - **Valori primitivi**: stringhe, numeri, booleani, null, undefined
 - **Nodi tipizzati**: Tipi di contenuto speciali come traduzioni, condizioni, markdown, ecc.
 - **Funzioni**: Contenuto dinamico che può essere valutato a runtime [vedi Recupero Funzioni](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/function_fetching.md)
+- **Contenuto Plurale**: Vedere Contenuto Plurale [Vedere Contenuto Plurale](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/plural.md)
 - **Contenuto annidato**: Riferimenti ad altri dizionari
 
 #### Tipi di Contenuto
@@ -544,6 +561,8 @@ multilingualContent: t({
 });
 ```
 
+> Vedere [Contenuto di Traduzione (`t`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/translation.md) per ulteriori informazioni.
+
 ### Contenuto Condizionale (`cond`)
 
 Contenuto che cambia in base a condizioni booleane:
@@ -557,6 +576,8 @@ conditionalContent: cond({
 });
 ```
 
+> Vedere [Contenuto Condizionale (`cond`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/condition.md) per ulteriori informazioni.
+
 ### Contenuto Enumerato (`enu`)
 
 Contenuto che varia in base a valori enumerati:
@@ -571,6 +592,23 @@ statusContent: enu({
 });
 ```
 
+> Vedere [Contenuto Enumerato (`enu`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/enumeration.md) per ulteriori informazioni.
+
+### Contenuto Plurale (`plural`)
+
+Contenuto che varia in base alle regole del plurale:
+
+```typescript
+import { plural } from "intlayer";
+
+pluralContent: plural({
+  one: "One car",
+  other: "{{count}} cars",
+});
+```
+
+> Vedere [Contenuto Plurale Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/plural.md) per ulteriori informazioni.
+
 ### Contenuto di Inserimento (`insert`)
 
 Contenuto che può essere inserito in altri contenuti:
@@ -581,6 +619,8 @@ import { insert } from "intlayer";
 insertionContent: insert("Questo testo può essere inserito ovunque");
 ```
 
+> Vedere [Contenuto di Inserimento (`insert`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/insertion.md) per ulteriori informazioni.
+
 ### Contenuto Nidificato (`nest`)
 
 Riferimenti ad altri dizionari:
@@ -591,6 +631,8 @@ import { nest } from "intlayer";
 nestedContent: nest("about-page");
 ```
 
+> Vedere [Contenuto Nidificato (`nest`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/nesting.md) per ulteriori informazioni.
+
 ### Contenuto Markdown (`md`)
 
 Contenuto di testo ricco in formato Markdown:
@@ -603,6 +645,8 @@ markdownContent: md(
 );
 ```
 
+> Vedere [Contenuto Markdown (`md`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/markdown.md) per ulteriori informazioni.
+
 ### Contenuto HTML (`html`)
 
 Contenuto HTML ricco che può usare tag standard o componenti personalizzati:
@@ -620,6 +664,8 @@ localizedHtmlContent: t({
 });
 ```
 
+> Vedere [Contenuto HTML (`html`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/html.md) per ulteriori informazioni.
+
 ### Contenuto per Genere (`gender`)
 
 Contenuto che varia in base al genere:
@@ -634,6 +680,8 @@ genderContent: gender({
 });
 ```
 
+> Vedere [Contenuto per Genere (`gender`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/gender.md) per ulteriori informazioni.
+
 ### Contenuto da File (`file`)
 
 Riferimenti a file esterni:
@@ -644,6 +692,8 @@ import { file } from "intlayer";
 fileContent: file("./path/to/content.txt");
 ```
 
+> Vedere [Contenuto da File (`file`) Doc](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/dictionary/file.md) per ulteriori informazioni.
+
 ## Creazione di File di Contenuto
 
 ### Struttura Base di un File di Contenuto

package/docs/it/mcp_server.md

@@ -23,7 +23,7 @@ history:
     changes: "Aggiunta configurazione di Claude Desktop"
   - version: 5.5.12
     date: 2025-07-10
-    changes: "Aggiunto trasporto SSE e server remoto"
+    changes: "Aggiunto trasporto Streamable HTTP e server remoto"
   - version: 5.5.10
     date: 2025-06-29
     changes: "Inizializzazione della cronologia"
@@ -51,12 +51,12 @@ Abilitando il Server MCP di Intlayer nel tuo IDE, sblocchi:
 
   > Visualizza l'elenco completo dei comandi e delle opzioni nella [documentazione CLI di Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/index.md).
 
-## Server locale (stdio) vs Server remoto (SSE)
+## Server locale (stdio) vs Server remoto (Streamable HTTP)
 
 Il server MCP può essere utilizzato in due modi:
 
 - Server locale (stdio)
-- Server remoto (SSE)
+- Server remoto (Streamable HTTP)
 
 ### Server locale (stdio) (consigliato)
 
@@ -64,7 +64,7 @@ Intlayer fornisce un pacchetto NPM che può essere installato localmente sulla t
 
 Questo server è il modo consigliato per utilizzare il server MCP, in quanto integra tutte le funzionalità del server MCP, inclusi gli strumenti CLI.
 
-### Server remoto (SSE)
+### Server remoto (Streamable HTTP)
 
 Il server MCP può essere utilizzato anche da remoto, utilizzando il metodo di trasporto SSE. Questo server è ospitato da Intlayer ed è disponibile all'indirizzo https://mcp.intlayer.org. Questo server è accessibile pubblicamente, senza alcuna autenticazione, ed è gratuito.
 
@@ -97,7 +97,7 @@ bun x intlayer init mcp
 Questo comando permetterà di:
 
 1. Chiederti quale piattaforma stai utilizzando (Cursor, VS Code, Claude Desktop, ecc.).
-2. Chiederti quale metodo di trasporto vuoi utilizzare (Server locale (stdio) o Server remoto (SSE)).
+2. Chiederti quale metodo di trasporto vuoi utilizzare (Server locale (stdio) o Server remoto (Streamable HTTP)).
 3. Aggiornare automaticamente il tuo file di configurazione (ad esempio, `.cursor/mcp.json`, `.vscode/mcp.json` o la configurazione globale di Claude Desktop).
 
 ---
@@ -107,7 +107,7 @@ Questo comando permetterà di:
 1. Apri la tavolozza dei comandi (Ctrl+Shift+P o Cmd+Shift+P).
 2. Digita `Intlayer: Setup AI Agent Skills`
 3. Scegli la piattaforma che utilizzi (es. `VS Code`, `Cursor`, `Windsurf`, `OpenCode`, `Claude Code`, `GitHub Copilot Workspace`, ecc.).
-4. Scegli l'MCP da installare (stdio, SSE)
+4. Scegli l'MCP da installare (stdio, Streamable HTTP)
 5. Premi Invio.
 
 ---
@@ -131,16 +131,16 @@ Nella radice del tuo progetto, aggiungi il seguente file di configurazione `.cur
 }
 ```
 
-### Server remoto (SSE)
+### Server remoto (Streamable HTTP)
 
-Per connettersi a un server MCP Intlayer remoto utilizzando Server-Sent Events (SSE), puoi configurare il tuo client MCP per connettersi al servizio ospitato.
+Per connettersi a un server MCP Intlayer remoto utilizzando Server-Sent Events (Streamable HTTP), puoi configurare il tuo client MCP per connettersi al servizio ospitato.
 
 ```json fileName=".cursor/mcp.json"
 {
   "mcpServers": {
-    "intlayer": {
-      "url": "https://mcp.intlayer.org",
-      "transport": "sse"
+    "intlayer-sse": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote@latest", "https://mcp.intlayer.org"]
     }
   }
 }
@@ -172,16 +172,16 @@ Crea un file `.vscode/mcp.json` nella radice del tuo progetto:
 }
 ```
 
-### Server remoto (SSE)
+### Server remoto (Streamable HTTP)
 
-Per connettersi a un server MCP Intlayer remoto utilizzando Server-Sent Events (SSE), puoi configurare il tuo client MCP per connettersi al servizio ospitato.
+Per connettersi a un server MCP Intlayer remoto utilizzando Server-Sent Events (Streamable HTTP), puoi configurare il tuo client MCP per connettersi al servizio ospitato.
 
 ```json fileName=".vscode/mcp.json"
 {
   "servers": {
-    "intlayer": {
-      "url": "https://mcp.intlayer.org",
-      "type": "sse"
+    "intlayer-sse": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote@latest", "https://mcp.intlayer.org"]
     }
   }
 }
@@ -191,7 +191,7 @@ Per connettersi a un server MCP Intlayer remoto utilizzando Server-Sent Events (
 
 ## Configurazione in ChatGPT
 
-### Server remoto (SSE)
+### Server remoto (Streamable HTTP)
 
 Segui la [documentazione ufficiale](https://platform.openai.com/docs/mcp#test-and-connect-your-mcp-server) per configurare il server MCP in ChatGPT.
 
@@ -232,6 +232,19 @@ Percorso del file di configurazione:
 }
 ```
 
+### Server remoto (Streamable HTTP)
+
+```json fileName="claude_desktop_config.json"
+{
+  "mcpServers": {
+    "intlayer-sse": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote@latest", "https://mcp.intlayer.org"]
+    }
+  }
+}
+```
+
 ---
 
 ## Utilizzo del Server MCP tramite CLI

package/docs/it/plugins/sync-po.md

@@ -0,0 +1,333 @@
+---
+createdAt: 2026-05-10
+updatedAt: 2026-05-10
+title: Plugin Sync PO
+description: Sincronizza i dizionari Intlayer con i file Gettext PO. Mantieni la tua i18n esistente utilizzando Intlayer per gestire, tradurre e testare i tuoi messaggi.
+keywords:
+  - Intlayer
+  - Sync PO
+  - Gettext
+  - i18n
+  - traduzioni
+slugs:
+  - doc
+  - plugin
+  - sync-po
+youtubeVideo: https://www.youtube.com/watch?v=MpGMxniDHNg
+history:
+  - version: 8.9.4
+    date: 2026-05-10
+    changes: "Documentazione iniziale del plugin Sync PO"
+---
+
+# Sync PO (ponti i18n) - Sync PO con supporto ICU / i18next
+
+Usa Intlayer come componente aggiuntivo per il tuo stack i18n esistente. Questo plugin mantiene i tuoi messaggi Gettext PO sincronizzati con i dizionari Intlayer in modo da poter:
+
+- Mantenere il tuo attuale workflow di traduzione basato su PO.
+- Gestire e tradurre i tuoi messaggi con Intlayer (CLI, CI, provider, CMS), senza rifattorizzare la tua app.
+- Distribuire tutorial e contenuti SEO mirati a ciascun ecosistema, suggerendo Intlayer come livello di gestione PO.
+
+Note e ambito attuale:
+
+- L'esternalizzazione al CMS funziona per le traduzioni e il testo classico.
+- Non c'è ancora supporto per inserimenti, plurali/ICU o funzionalità avanzate di runtime di altre librerie all'interno delle voci PO stesse.
+- L'editor visuale non è ancora supportato per gli output i18n di terze parti.
+
+### Quando usare questo plugin
+
+- Usi già i file Gettext PO per le tue traduzioni.
+- Desideri il riempimento assistito da IA, i test in CI e le operazioni sui contenuti senza modificare il runtime di rendering.
+
+## Installazione
+
+```bash
+pnpm add -D @intlayer/sync-po-plugin
+# oppure
+npm i -D @intlayer/sync-po-plugin
+```
+
+## Plugin
+
+Questo pacchetto fornisce due plugin:
+
+- `loadPO`: Carica i file PO nei dizionari Intlayer.
+  - Questo plugin viene utilizzato per caricare file PO da una sorgente e verranno inseriti nei dizionari Intlayer. Può scansionare l'intera base di codice e cercare file PO specifici.
+    Questo plugin può essere utilizzato:
+    - se utilizzi una libreria i18n che impone una posizione specifica per il caricamento dei tuoi file PO, ma vuoi posizionare la tua dichiarazione di contenuto dove preferisci nella tua base di codice.
+    - Può essere utilizzato anche se vuoi recuperare i tuoi messaggi da una sorgente remota (es: un CMS, un'API, ecc.) e memorizzare i tuoi messaggi in file PO.
+
+  > Sotto il cofano, questo plugin scansionerà tutta la base di codice, cercherà file PO specifici e li caricherà nei dizionari Intlayer.
+  > Nota che questo plugin non scriverà l'output e le traduzioni nei file PO.
+
+- `syncPO`: Sincronizza i file PO con i dizionari Intlayer.
+  - Questo plugin viene utilizzato per sincronizzare i file PO con i dizionari Intlayer. Può scansionare la posizione specificata e caricare i PO che corrispondono al pattern per file PO specifici. Questo plugin è utile se vuoi ottenere i vantaggi di Intlayer utilizzando un'altra libreria i18n.
+
+## Utilizzo di entrambi i plugin
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadPO, syncPO } from "@intlayer/sync-po-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+
+  // Mantieni i tuoi attuali file PO sincronizzati con i dizionari Intlayer
+  plugins: [
+    /**
+     * Caricherà tutti i file PO in src che corrispondono al pattern {key}.i18n.po
+     */
+    loadPO({
+      source: ({ key }) => `./src/**/${key}.i18n.po`,
+      locale: Locales.ENGLISH,
+      priority: 1, // Assicura che questi file PO abbiano la precedenza sui file in `./locales/en/${key}.po`
+    }),
+    /**
+     * Caricherà e scriverà l'output e le traduzioni nei file PO nella directory locales
+     */
+    syncPO({
+      source: ({ key, locale }) => `./locales/${locale}/${key}.po`,
+      priority: 0,
+    }),
+  ],
+};
+
+export default config;
+```
+
+## Plugin `syncPO`
+
+### Avvio rapido
+
+Aggiungi il plugin al tuo `intlayer.config.ts` e puntalo alla tua struttura PO esistente.
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { syncPO } from "@intlayer/sync-po-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+
+  // Mantieni i tuoi attuali file PO sincronizzati con i dizionari Intlayer
+  plugins: [
+    syncPO({
+      // Layout per lingua e per namespace
+      source: ({ key, locale }) => `./locales/${locale}/${key}.po`,
+    }),
+  ],
+};
+
+export default config;
+```
+
+Alternativa: file singolo per lingua:
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { syncPO } from "@intlayer/sync-po-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  plugins: [
+    syncPO({
+      source: ({ locale }) => `./locales/${locale}.po`,
+    }),
+  ],
+};
+
+export default config;
+```
+
+#### Come funziona
+
+- Lettura: il plugin scopre i file PO dal tuo costruttore `source` e li carica come dizionari Intlayer.
+- Scrittura: dopo le build e i riempimenti, scrive i PO localizzati negli stessi percorsi (con gli header Gettext appropriati).
+- Riempimento automatico: il plugin dichiara un percorso `autoFill` per ogni dizionario. L'esecuzione di `intlayer fill` aggiorna per impostazione predefinita solo le traduzioni mancanti nei tuoi file PO.
+
+API:
+
+```ts
+syncPO({
+  source: ({ key, locale }) => string, // richiesto
+  location?: string, // etichetta opzionale, default: "sync-po::path/to/source"
+  priority?: number, // priorità opzionale per la risoluzione dei conflitti, default: 0
+});
+```
+
+### Sorgenti PO multiple e priorità
+
+Puoi aggiungere più plugin `syncPO` per sincronizzare diverse sorgenti PO. Questo è utile quando hai più sorgenti di traduzione o diverse strutture PO nel tuo progetto.
+
+#### Sistema di priorità
+
+Quando più plugin puntano alla stessa chiave del dizionario, il parametro `priority` determina quale plugin ha la precedenza:
+
+- I numeri di priorità più alti vincono su quelli più bassi
+- La priorità predefinita dei file `.content` è `0`
+- La priorità predefinita dei plugin è `0`
+- I plugin con la stessa priorità vengono elaborati nell'ordine in cui appaiono nella configurazione
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { syncPO } from "@intlayer/sync-po-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+
+  plugins: [
+    // Sorgente PO primaria (priorità massima)
+    syncPO({
+      source: ({ key, locale }) => `./locales/${locale}/${key}.po`,
+      location: "main-translations",
+      priority: 10,
+    }),
+
+    // Sorgente PO di fallback (priorità inferiore)
+    syncPO({
+      source: ({ locale }) => `./fallback-locales/${locale}.po`,
+      location: "fallback-translations",
+      priority: 5,
+    }),
+
+    // Sorgente PO legacy (priorità minima)
+    syncPO({
+      source: ({ locale }) => `/my/other/app/legacy/${locale}/messages.po`,
+      location: "legacy-translations",
+      priority: 1,
+    }),
+  ],
+};
+
+export default config;
+```
+
+## Plugin Load PO
+
+### Avvio rapido
+
+Aggiungi il plugin al tuo `intlayer.config.ts` per ingerire file PO esistenti come dizionari Intlayer. Questo plugin è di sola lettura (nessuna scrittura su disco):
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadPO } from "@intlayer/sync-po-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+
+  plugins: [
+    // Ingerisci i messaggi PO situati ovunque nel tuo albero dei sorgenti
+    loadPO({
+      source: ({ key }) => `./src/**/${key}.i18n.po`,
+      // Carica una singola lingua per istanza di plugin (impostata di default sulla defaultLocale della configurazione)
+      locale: Locales.ENGLISH,
+      priority: 0,
+    }),
+  ],
+};
+
+export default config;
+```
+
+Alternativa: layout per lingua, ancora di sola lettura (viene caricata solo la lingua selezionata):
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { loadPO } from "@intlayer/sync-po-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  plugins: [
+    loadPO({
+      // Solo i file per Locales.FRENCH verranno caricati da questo pattern
+      source: ({ key, locale }) => `./locales/${locale}/${key}.po`,
+      locale: Locales.FRENCH,
+    }),
+  ],
+};
+
+export default config;
+```
+
+### Come funziona
+
+- Scoperta: costruisce un glob dal tuo costruttore `source` e raccoglie i file PO corrispondenti.
+- Ingestione: carica ogni file PO come dizionario Intlayer con la `locale` fornita.
+- Sola lettura: non scrive né formatta i file di output; usa `syncPO` se hai bisogno della sincronizzazione round-trip.
+- Pronto per il riempimento automatico: definisce un percorso `fill` in modo che `intlayer content fill` possa popolare le chiavi mancanti.
+
+### API
+
+```ts
+loadPO({
+  // Costruisce i percorsi per i tuoi PO. `locale` è opzionale se la tua struttura non ha un segmento per la lingua
+  source: ({ key, locale }) => string,
+
+  // Lingua di destinazione per i dizionari caricati da questa istanza di plugin
+  // Di default configuration.internationalization.defaultLocale
+  locale?: Locale,
+
+  // Etichetta opzionale per identificare la sorgente
+  location?: string, // default: "plugin"
+
+  // Priorità utilizzata per la risoluzione dei conflitti con altre sorgenti
+  priority?: number, // default: 0
+});
+```
+
+### Comportamento e convenzioni
+
+- Se la tua maschera `source` include un segnaposto per la lingua, vengono ingeriti solo i file per la `locale` selezionata.
+- Se non c'è un segmento `{key}` nella tua maschera, la chiave del dizionario è "index".
+- Le chiavi sono derivate dai percorsi dei file sostituendo il segnaposto `{key}` nel tuo costruttore `source`.
+- Il plugin utilizza solo i file scoperti e non fabbrica lingue o chiavi mancanti.
+- Il percorso `fill` è dedotto dalla tua `source` e utilizzato per aggiornare i valori mancanti tramite CLI quando acconsenti.
+
+## Risoluzione dei conflitti
+
+Quando la stessa chiave di traduzione esiste in più sorgenti PO:
+
+1. Il plugin con la priorità più alta determina il valore finale
+2. Le sorgenti con priorità inferiore vengono utilizzate come fallback per le chiavi mancanti
+3. Questo ti consente di mantenere le traduzioni legacy mentre migri gradualmente verso nuove strutture
+
+## CLI
+
+I file PO sincronizzati saranno considerati come gli altri file `.content`. Ciò significa che tutti i comandi intlayer saranno disponibili per i file PO sincronizzati. Inclusi:
+
+- `intlayer content test` per testare se mancano traduzioni
+- `intlayer content list` per elencare i file PO sincronizzati
+- `intlayer content fill` per riempire le traduzioni mancanti
+- `intlayer content push` per inviare i file PO sincronizzati
+- `intlayer content pull` per recuperare i file PO sincronizzati
+
+Vedi [Intlayer CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/cli/index.md) per maggiori dettagli.
+
+## Limitazioni (attuali)
+
+- Nessun supporto per inserimenti o plurali/ICU quando si puntano librerie di terze parti.
+- L'editor visuale non è ancora disponibile per runtime diversi da Intlayer.
+- Solo sincronizzazione PO; i formati di catalogo non-PO non sono supportati.
+
+## Perché è importante
+
+- Possiamo raccomandare soluzioni i18n consolidate e posizionare Intlayer come componente aggiuntivo.
+- Sfruttiamo la loro SEO/parole chiave con tutorial che terminano suggerendo Intlayer per gestire i PO.
+- Espande il pubblico potenziale dai "nuovi progetti" a "qualsiasi team che utilizzi già i18n".

package/docs/ja/benchmark/index.md

@@ -25,8 +25,8 @@ Benchmark Bloom は、複数の React フレームワークとロード戦略に
 
 各フレームワークの詳細レポートと技術ドキュメントは次のとおりです。
 
-- [**Next.js Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/nextjs.md)
-- [**TanStack Start Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/tanstack.md)
-- [**Vue Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/vue.md)
-- [**Solid Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/solid.md)
-- [**Svelte Benchmark Report**](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/benchmark/svelte.md)
+- [**Next.js ベンチマークレポート**](./nextjs.md)
+- [**TanStack Start ベンチマークレポート**](./tanstack.md)
+- [**Vue ベンチマークレポート**](./vue.md)
+- [**Solid ベンチマークレポート**](./solid.md)
+- [**Svelte ベンチマークレポート**](./svelte.md)