Intlayer CLI
Instalar Pacote
Instale os pacotes necessários usando npm:
npm install intlayer-cli
Se o pacote intlayer já estiver instalado, o cli é instalado automaticamente. Você pode pular esta etapa.
pacote intlayer-cli
O pacote intlayer-cli visa transpilar suas declarações intlayer em dicionários.
Este pacote transpilará todos os arquivos intlayer, como src/**/*.content.{ts|js|mjs|cjs|json}. Veja como declarar seus arquivos de declaração Intlayer.
Para interpretar dicionários intlayer, você pode usar interpretadores, como react-intlayer, ou next-intlayer
Suporte a Arquivos de Configuração
Intlayer aceita múltiplos formatos de arquivos de configuração:
- intlayer.config.ts
- intlayer.config.js
- intlayer.config.json
- intlayer.config.cjs
- intlayer.config.mjs
- .intlayerrc
Para ver como configurar locais disponíveis ou outros parâmetros, consulte a documentação de configuração aqui.
Executar comandos intlayer
Construir dicionários
Para construir seus dicionários, você pode executar os comandos:
npx intlayer build
ou no modo de observação
npx intlayer build --watch
Este comando encontrará seus arquivos de conteúdo de declaração como padrão em ./src/**/*.content.{ts|js|mjs|cjs|json|tsx|jsx}. E construirá os dicionários no diretório .intlayer.
Enviar dicionários
npx intlayer dictionary push
Se o editor intlayer estiver instalado, você também pode enviar dicionários para o editor. Este comando permitirá disponibilizar os dicionários para o editor. Dessa forma, você pode compartilhar seus dicionários com sua equipe e editar seu conteúdo sem editar o código de sua aplicação.
Argumentos:
- -d, --dictionaries: ids dos dicionários a serem enviados. Se não especificado, todos os dicionários serão enviados. > Exemplo: npx intlayer dictionary push -d my-dictionary-id my-other-dictionary-id
- -r, --deleteLocaleDictionary: Ignorar a pergunta que pergunta se deseja excluir os diretórios de locais uma vez que os dicionários sejam enviados e removê-los. Por padrão, se o dicionário for definido localmente, ele substituirá o conteúdo dos dicionários remotos. > Exemplo: npx intlayer dictionary push -r
- -k, --keepLocaleDictionary: Ignorar a pergunta que pergunta se deseja excluir os diretórios de locais uma vez que os dicionários sejam enviados e mantê-los. Por padrão, se o dicionário for definido localmente, ele substituirá o conteúdo dos dicionários remotos. > Exemplo: npx intlayer dictionary push -k
Puxar dicionários remotos
npx intlayer dictionary pull
Se o editor intlayer estiver instalado, você também pode puxar dicionários do editor. Dessa forma, você pode substituir o conteúdo de seus dicionários para a necessidade de sua aplicação.
Argumentos:
- -d, --dictionaries: Ids dos dicionários a serem puxados. Se não especificado, todos os dicionários serão puxados. > Exemplo: npx intlayer dictionary pull -d my-dictionary-id my-other-dictionary-id
- --newDictionariesPath : Caminho para o diretório onde os novos dicionários serão salvos. Se não especificado, os novos dicionários serão salvos no diretório ./intlayer-dictionaries do projeto. Se um campo filePath for especificado no conteúdo do seu dicionário, os dicionários não considerarão este argumento e serão salvos no diretório filePath especificado.
Exemplo:
npx intlayer dictionary pull --newDictionariesPath ./my-dictionaries-dir/
Auditar dicionários
npx intlayer audit
Este comando analisa seus arquivos de declaração de conteúdo para possíveis problemas, como traduções faltando, inconsistências estruturais ou incompatibilidades de tipo. Se encontrar algum problema, intlayer audit proporá ou aplicará atualizações para manter seus dicionários consistentes e completos.
Argumentos:
-f, --files [files...]
Uma lista de arquivos de declaração de conteúdo específicos a serem auditados. Se não fornecido, todos os arquivos *.content.{ts,js,mjs,cjs,tsx,jsx,json} descobertos serão auditados.--exclude [excludedGlobs...]
Padrão de globs a ser excluído da auditoria (por exemplo, --exclude "src/test/**").-m, --model [model]
O modelo ChatGPT a ser usado para a auditoria (por exemplo, gpt-3.5-turbo).-p, --custom-prompt [prompt]
Fornecer um prompt personalizado para suas instruções de auditoria.-l, --async-limit [asyncLimit]
Número máximo de arquivos a serem processados simultaneamente.-k, --open-ai-api-key [openAiApiKey]
Fornecer sua própria chave de API OpenAI para contornar a autenticação OAuth2.
Exemplo:
npx intlayer audit --exclude "tests/**" --model gpt-3.5-turbo
Este comando ignorará quaisquer arquivos sob tests/** e usará o modelo gpt-3.5-turbo para auditar os arquivos de declaração de conteúdo descobertos. Se algum problema for encontrado — como traduções faltando — eles serão corrigidos no local, preservando a estrutura do arquivo original.
Usar comandos intlayer em seu package.json
"scripts": { "intlayer:build": "npx intlayer build", "intlayer:watch": "npx intlayer build --watch", "intlayer:push": "npx intlayer dictionary push", "intlayer:pull": "npx intlayer dictionary pull", "intlayer:audit": "npx intlayer audit"}
Se 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ção