Receba notificações sobre os próximos lançamentos de Intlayer
    Criação:2025-03-13Última atualização:2025-06-29

    Conteúdo de Arquivo / Incorporando Arquivos no Intlayer

    Como Funciona a Incorporação de Arquivos

    No Intlayer, a função file permite incorporar o conteúdo de arquivos externos em um dicionário. Essa abordagem garante que o Intlayer reconheça o arquivo de origem, possibilitando uma integração perfeita com o Editor Visual do Intlayer e o CMS. Diferentemente dos métodos diretos de leitura de arquivos como import, require ou fs, o uso de file associa o arquivo ao dicionário, permitindo que o Intlayer acompanhe e atualize o conteúdo dinamicamente quando o arquivo for editado.

    Configurando o Conteúdo do Arquivo

    Para incorporar o conteúdo de um arquivo no seu projeto Intlayer, utilize a função file em um módulo de conteúdo. Abaixo estão exemplos demonstrando diferentes implementações.

    **/*.content.ts
    import { file, type Dictionary } from "intlayer";const myFileContent = {  key: "my_key",  content: {    myFile: file("./path/to/file.txt"),  },} satisfies Dictionary;export default myFileContent;

    Usando Conteúdo de Arquivo no React Intlayer

    Para usar conteúdo de arquivo incorporado em um componente React, importe e utilize o hook useIntlayer do pacote react-intlayer. Isso recupera o conteúdo da chave especificada e permite que ele seja exibido dinamicamente.

    **/*.tsx
    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;

    Exemplo de Markdown Multilíngue

    Para suportar arquivos Markdown editáveis multilíngues, você pode usar file em combinação com t() e md() para definir diferentes versões de idioma de um arquivo de conteúdo Markdown.

    **/*.content.ts
    import { file, t, md, type Dictionary } from "intlayer";const myMultilingualContent = {  key: "my_multilingual_key",  content: {    myContent: md(      t({        pt: file("src/components/test.pt.md"),        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;

    Esta configuração permite que o conteúdo seja recuperado dinamicamente com base na preferência de idioma do usuário. Quando usado no Editor Visual Intlayer ou CMS, o sistema reconhecerá que o conteúdo vem dos arquivos Markdown especificados e garantirá que eles permaneçam editáveis.

    Como o Intlayer Trata o Conteúdo de Arquivos

    A função file é baseada no módulo fs do Node.js para ler o conteúdo do arquivo especificado e inseri-lo no dicionário. Quando usada em conjunto com o Editor Visual Intlayer ou CMS, o Intlayer pode rastrear a relação entre o dicionário e o arquivo. Isso permite que o Intlayer:

    • Reconheça que o conteúdo se origina de um arquivo específico.
    • Atualize automaticamente o conteúdo do dicionário quando o arquivo vinculado for editado.
    • Garantir a sincronização entre o arquivo e o dicionário, preservando a integridade do conteúdo.

    Recursos Adicionais

    Para mais detalhes sobre a configuração e uso da incorporação de arquivos no Intlayer, consulte os seguintes recursos:

    Estes recursos fornecem mais informações sobre incorporação de arquivos, gerenciamento de conteúdo e a integração do Intlayer com vários frameworks.

    Histórico do Documento

    • 5.5.10 - 2025-06-29: Histórico inicial
    Receba notificações sobre os próximos lançamentos de Intlayer