Personalização de Extensão de Conteúdo

Extensões de Arquivos de Conteúdo

O Intlayer permite que você personalize as extensões para seus arquivos de declaração de conteúdo. Essa personalização oferece flexibilidade no gerenciamento de projetos em grande escala e ajuda a evitar conflitos com outros módulos.

Extensões Padrão

Por padrão, o Intlayer monitora todos os arquivos com as seguintes extensões para declarações de conteúdo:

• .content.json
• .content.ts
• .content.tsx
• .content.js
• .content.jsx
• .content.mjs
• .content.mjx
• .content.cjs
• .content.cjx

Essas extensões padrão são adequadas para a maioria das aplicações. No entanto, quando você tem necessidades específicas, pode definir extensões personalizadas para otimizar o processo de build e reduzir o risco de conflitos com outros componentes.

Personalizando Extensões de Conteúdo

Para personalizar as extensões de arquivo que o Intlayer usa para identificar arquivos de declaração de conteúdo, você pode especificá-las no arquivo de configuração do Intlayer. Essa abordagem é benéfica para projetos em grande escala, onde limitar o escopo do processo de monitoramento melhora o desempenho da compilação.

Aqui está um exemplo de como definir extensões de conteúdo personalizadas na sua configuração:

import type { IntlayerConfig } from "intlayer";const config: IntlayerConfig = {  content: {    fileExtensions: [".my_content.ts", ".my_content.tsx"], // Suas extensões personalizadas  },};export default config;

Neste exemplo, a configuração especifica duas extensões personalizadas: .my_content.ts e .my_content.tsx. O Intlayer irá monitorar apenas arquivos com essas extensões para construir os dicionários.

Benefícios das Extensões Personalizadas

• Desempenho da Compilação: Reduzir o escopo dos arquivos monitorados pode melhorar significativamente o desempenho da compilação em projetos grandes.
• Evitar Conflitos: Extensões personalizadas ajudam a prevenir conflitos com outros arquivos JavaScript ou TypeScript no seu projeto.
• Organização: Extensões personalizadas permitem organizar seus arquivos de declaração de conteúdo conforme as necessidades do seu projeto.

Diretrizes para Extensões Personalizadas

Ao personalizar as extensões dos arquivos de conteúdo, mantenha as seguintes diretrizes em mente:

• Unicidade: Escolha extensões que sejam únicas dentro do seu projeto para evitar conflitos.
• Nomeação Consistente: Use convenções de nomenclatura consistentes para melhor legibilidade e manutenção do código.
• Evitar Extensões Comuns: Evite usar extensões comuns como .ts ou .js para prevenir conflitos com outros módulos ou bibliotecas.

Conclusão

Personalizar as extensões dos arquivos de conteúdo no Intlayer é um recurso valioso para otimizar o desempenho e evitar conflitos em aplicações de grande escala. Seguindo as diretrizes descritas nesta documentação, você pode gerenciar efetivamente suas declarações de conteúdo e garantir uma integração suave com outras partes do seu projeto.

Histórico da Documentação

• 5.5.10 - 2025-06-29: Histórico inicial