Pose una domanda e ottieni un riassunto del documento facendo riferimento a questa pagina e al provider AI di tua scelta
Integrando il server MCP Intlayer al tuo assistente AI, puoi recuperare tutti i documenti direttamente da ChatGPT, DeepSeek, Cursor, VSCode, ecc.
Vedi la documentazione del server MCPIl contenuto di questa pagina è stato tradotto con un'IA.
Vedi l'ultima versione del contenuto originale in ingleseSe hai un’idea per migliorare questa documentazione, non esitare a contribuire inviando una pull request su GitHub.
Collegamento GitHub alla documentazioneCopia il Markdown del documento nella porta-documenti
Contenuto File / Incorporare File in Intlayer
Come Funziona l'Incorporamento dei File
In Intlayer, la funzione file permette di incorporare il contenuto di file esterni in un dizionario. Questo approccio garantisce che Intlayer riconosca il file sorgente, consentendo un'integrazione fluida con l'Intlayer Visual Editor e il CMS. A differenza dei metodi diretti come import, require o la lettura di file con fs, l'uso di file associa il file al dizionario, permettendo a Intlayer di tracciare e aggiornare dinamicamente il contenuto quando il file viene modificato.
Configurare il Contenuto del File
Per incorporare il contenuto di un file nel tuo progetto Intlayer, utilizza la funzione file in un modulo di contenuto. Di seguito sono riportati esempi che mostrano diverse implementazioni.
Copiare il codice nella clipboard
import { file, type Dictionary } from "intlayer";const myFileContent = { key: "my_key", content: { myFile: file("./path/to/file.txt"), },} satisfies Dictionary;export default myFileContent;
Utilizzo del Contenuto del File in React Intlayer
Per utilizzare il contenuto del file incorporato in un componente React, importa e usa l'hook useIntlayer dal pacchetto react-intlayer. Questo recupera il contenuto dalla chiave specificata e permette di visualizzarlo dinamicamente.
Copiare il codice nella clipboard
import type { FC } from "react";import { useIntlayer } from "react-intlayer";const FileComponent: FC = () => { const { myFile } = useIntlayer("my_key"); return ( <div> <pre>{myFile}</pre> </div> );};export default FileComponent;
Esempio di Markdown Multilingue
Per supportare file Markdown modificabili multilingue, puoi usare file in combinazione con t() e md() per definire diverse versioni linguistiche di un file di contenuto Markdown.
Copiare il codice nella clipboard
import { file, t, md, type Dictionary } from "intlayer";const myMultilingualContent = { key: "my_multilingual_key", content: { myContent: md( t({ en: file("src/components/test.en.md"), fr: file("src/components/test.fr.md"), es: file("src/components/test.es.md"), }) ), },} satisfies Dictionary;export default myMultilingualContent;
Questa configurazione consente di recuperare dinamicamente il contenuto in base alla preferenza linguistica dell'utente. Quando viene utilizzata nell'Intlayer Visual Editor o nel CMS, il sistema riconosce che il contenuto proviene dai file Markdown specificati e garantisce che rimangano modificabili.
Come Intlayer Gestisce il Contenuto dei File
La funzione file si basa sul modulo fs di Node.js per leggere il contenuto del file specificato e inserirlo nel dizionario. Quando viene utilizzata in combinazione con l'Intlayer Visual Editor o il CMS, Intlayer può tracciare la relazione tra il dizionario e il file. Questo permette a Intlayer di:
- Riconoscere che il contenuto ha origine da un file specifico.
- Aggiornare automaticamente il contenuto del dizionario quando il file collegato viene modificato.
- Garantire la sincronizzazione tra il file e il dizionario, preservando l'integrità del contenuto.
Risorse Aggiuntive
Per maggiori dettagli sulla configurazione e l'uso dell'incorporamento di file in Intlayer, fare riferimento alle seguenti risorse:
- Documentazione CLI di Intlayer
- Documentazione React Intlayer
- Documentazione Next Intlayer
- Documentazione Contenuto Markdown
- Documentazione sul Contenuto di Traduzione
Queste risorse offrono ulteriori approfondimenti sull'incorporamento di file, la gestione dei contenuti e l'integrazione di Intlayer con vari framework.
Cronologia del Documento
- 5.5.10 - 2025-06-29: Inizio cronologia