Faça sua pergunta e obtenha um resumo do documento referenciando esta página e o provedor AI de sua escolha
Histórico de versões
- "Adicionar opção --no-gitignore"v8.6.431/03/2026
- "Adicionar comando init"v7.5.930/12/2025
O conteúdo desta página foi traduzido com uma IA.
Veja a última versão do conteúdo original em inglêsSe você tiver uma ideia para melhorar esta documentação, sinta-se à vontade para contribuir enviando uma pull request no GitHub.
Link do GitHub para a documentaçãoCopiar o Markdown do documento para a área de transferência
Inicializar Intlayer
Copiar o código para a área de transferência
npx intlayer initO comando init configura automaticamente o Intlayer no seu projeto através da configuração dos ficheiros e definições necessários. É a forma recomendada de começar com o Intlayer.
Aliases:
npx intlayer init
Argumentos:
--project-root [projectRoot]- Opcional. Especifique o diretório raiz do projeto. Se não for fornecido, o comando procurará a raiz do projeto a partir do diretório de trabalho atual.--no-gitignore- Opcional. Salta a atualização automática do ficheiro.gitignore. Se esta flag for utilizada, o diretório.intlayernão será adicionado ao.gitignore.
O que faz:
O comando init executa as seguintes tarefas de configuração:
- Valida a estrutura do projeto - Garante que está num diretório de projeto válido com um ficheiro
package.json. - Atualiza o
.gitignore- Adiciona.intlayerao seu ficheiro.gitignorepara excluir os ficheiros gerados do controlo de versões (pode ser saltado com--no-gitignore). - Configura o TypeScript - Atualiza todos os ficheiros
tsconfig.jsonpara incluir as definições de tipos do Intlayer (.intlayer/**/*.ts). - Cria ficheiro de configuração - Gera um
intlayer.config.ts(para projetos TypeScript) ouintlayer.config.mjs(para projetos JavaScript) com definições padrão. - Atualiza a config do Vite - Se for detetado um ficheiro de configuração do Vite, adiciona a importação do plugin
vite-intlayer. - Atualiza a config do Next.js - Se for detetado um ficheiro de configuração do Next.js, adiciona a importação do plugin
next-intlayer.
Exemplos:
Inicialização básica:
Copiar o código para a área de transferência
npx intlayer initIsto inicializará o Intlayer no diretório atual, detetando automaticamente a raiz do projeto.
Inicializar com raiz de projeto personalizada:
Copiar o código para a área de transferência
npx intlayer init --project-root ./meu-projetoIsto inicializará o Intlayer no diretório especificado.
Inicializar sem atualizar o .gitignore:
Copiar o código para a área de transferência
npx intlayer init --no-gitignoreIsto configurará todos os ficheiros de configuração mas não modificará o seu .gitignore.
Exemplo de saída:
Copiar o código para a área de transferência
npx intlayer initChecking Intlayer configuration...✓ Added .intlayer to .gitignore✓ Updated tsconfig.json to include intlayer types✓ Created intlayer.config.ts✓ Injected import into vite.config.ts✓ Intlayer init setup complete.Notas:
- O comando é idempotente - pode executá-lo várias vezes com segurança. Ele saltará as etapas que já estão configuradas.
- Se um ficheiro de configuração já existir, não será substituído.
- Os ficheiros de config TypeScript sem um array
include(por exemplo, configurações de estilo de solução com referências) são saltados. - O comando terminará com um erro se nenhum
package.jsonfor encontrado na raiz do projeto.