@intlayer/docs 5.5.8

package/pt/intlayer_cli.md

@@ -0,0 +1,274 @@
+# Intlayer CLI
+
+## Instalar Pacote
+
+Instale os pacotes necessários usando npm:
+
+```bash packageManager="npm"
+npm install intlayer-cli -g
+```
+
+```bash packageManager="yarn"
+yarn add intlayer-cli -g
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer-cli -g
+```
+
+> Se o pacote `intlayer` já estiver instalado, o CLI será automaticamente instalado. Você pode pular esta etapa.
+
+## Pacote intlayer-cli
+
+O pacote `intlayer-cli` tem como objetivo transpilar suas [declarações intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/pt/dictionary/get_started.md) 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](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer/README.md).
+
+Para interpretar dicionários intlayer, você pode usar interpretadores, como [react-intlayer](https://www.npmjs.com/package/react-intlayer) ou [next-intlayer](https://www.npmjs.com/package/next-intlayer).
+
+## Suporte a Arquivo de Configuração
+
+O Intlayer aceita múltiplos formatos de arquivo de configuração:
+
+- `intlayer.config.ts`
+- `intlayer.config.js`
+- `intlayer.config.json`
+- `intlayer.config.cjs`
+- `intlayer.config.mjs`
+- `.intlayerrc`
+
+Para ver como configurar os locais disponíveis ou outros parâmetros, consulte a [documentação de configuração aqui](https://github.com/aymericzip/intlayer/blob/main/docs/pt/configuration.md).
+
+## Executar comandos intlayer
+
+### Construir dicionários
+
+Para construir seus dicionários, você pode executar os comandos:
+
+```bash
+npx intlayer dictionaries build
+```
+
+ou no modo de observação
+
+```bash
+npx intlayer dictionaries 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
+
+```bash
+npx intlayer dictionary push
+```
+
+Se o [editor intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/pt/intlayer_visual_editor.md) estiver instalado, você também pode enviar dicionários para o editor. Este comando permitirá tornar os dicionários disponíveis para [o editor](https://intlayer.org/dashboard). 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`: Ignora a pergunta sobre excluir o diretório de localização após o envio do dicionário e exclui. Por padrão, se o dicionário estiver definido localmente, ele sobrescreve o conteúdo do dicionário remoto.
+  > Exemplo: `npx intlayer dictionary push -r`
+- `-k`, `--keepLocaleDictionary`: Ignora a pergunta sobre excluir o diretório de localização após o envio do dicionário e mantém. Por padrão, se o dicionário estiver definido localmente, ele sobrescreve o conteúdo do dicionário remoto.
+  > Exemplo: `npx intlayer dictionary push -k`
+- `--env`: Especifica o ambiente (ex: `development`, `production`).
+- `--env-file`: Fornece um arquivo de ambiente personalizado para carregar variáveis.
+- `--base-dir`: Especifica o diretório base do projeto.
+- `--verbose`: Ativa o registro detalhado para depuração.
+- `--git-diff`: Executa apenas dicionários com alterações não enviadas no repositório git.
+- `--git-diff-base`: Especifica a referência base para o git diff.
+- `--git-diff-current`: Especifica a referência atual para o git diff.
+- `--uncommitted`: Inclui alterações não commitadas.
+- `--unpushed`: Inclui alterações não enviadas.
+- `--untracked`: Inclui arquivos não rastreados.
+
+### Obter Dicionários Remotos
+
+```bash
+npx intlayer dictionary pull
+```
+
+Se você tiver o [Editor Visual do Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/pt/intlayer_visual_editor.md) instalado, você também pode obter dicionários do editor. Isso permite sobrescrever o conteúdo dos dicionários de acordo com as necessidades da sua aplicação.
+
+##### Argumentos:
+
+- `-d, --dictionaries`: IDs dos dicionários a serem obtidos. Se não especificado, todos os dicionários serão obtidos.
+  > Exemplo: `npx intlayer dictionary pull -d my-dictionary-id my-other-dictionary-id`
+- `--newDictionariesPath`: Caminho do diretório onde os novos dicionários serão armazenados. Se não especificado, os novos dicionários serão armazenados no diretório `./intlayer-dictionaries` do projeto. Se o conteúdo do dicionário tiver um campo `filePath` especificado, o dicionário será armazenado no diretório `filePath` especificado, ignorando este argumento.
+- `--env`: Especifica o ambiente (ex: `development`, `production`).
+- `--env-file`: Fornece um arquivo de ambiente personalizado para carregar variáveis.
+- `--base-dir`: Especifica o diretório base do projeto.
+- `--verbose`: Ativa o registro detalhado para depuração.
+
+##### Exemplo:
+
+```bash
+npx intlayer dictionary pull --newDictionariesPath ./my-dictionaries-dir/
+```
+
+### Auditoria de Dicionários
+
+```bash
+npx intlayer audit
+```
+
+Este comando analisa os arquivos de declaração de conteúdo para encontrar problemas potenciais, como traduções ausentes, inconsistências estruturais ou incompatibilidades de tipo. Se problemas forem encontrados, o **intlayer audit** sugere ou aplica atualizações para manter os dicionários consistentes e completos.
+
+##### Argumentos:
+
+- **`-f, --files [files...]`**  
+  Lista de arquivos de declaração de conteúdo específicos para auditar. Se não fornecido, todos os arquivos `*.content.{ts,js,mjs,cjs,tsx,jsx,json}` encontrados serão auditados.
+
+- **`--exclude [excludedGlobs...]`**  
+  Padrões glob para excluir da auditoria (ex: `--exclude "src/test/**"`).
+
+- **`--source-locale [sourceLocale]`**  
+  Local de origem para tradução. Se não especificado, o local padrão da configuração será usado.
+
+- **`--output-locales [outputLocales...]`**  
+  Locais de destino para tradução. Se não especificado, todos os locais da configuração, exceto o local de origem, serão usados.
+
+- **`--mode [mode]`**  
+  Modo de tradução: 'complete', 'review', ou 'missing-only'. O padrão é 'missing-only'.
+
+- **`--git-diff`**  
+  Executa apenas dicionários com alterações não enviadas no repositório git.
+
+- **`--git-diff-base`**  
+  Especifica a referência base para o git diff.
+
+- **`--git-diff-current`**  
+  Especifica a referência atual para o git diff.
+
+- **`--uncommitted`**  
+  Inclui alterações não commitadas.
+
+- **`--unpushed`**  
+  Inclui alterações não enviadas.
+
+- **`--untracked`**  
+  Inclui arquivos não rastreados.
+
+- **`--keys [keys...]`**  
+  Filtra dicionários com base em chaves específicas.
+
+- **`--excluded-keys [excludedKeys...]`**  
+  Exclui dicionários com base em chaves específicas.
+
+- **`--path-filter [pathFilters...]`**  
+  Filtra dicionários com base em padrões glob de caminho de arquivo.
+
+- **`--model [model]`**  
+  Modelo de IA a ser usado para tradução (ex: `gpt-3.5-turbo`).
+
+- **`--provider [provider]`**  
+  Provedor de IA a ser usado para tradução.
+
+- **`--temperature [temperature]`**  
+  Configuração de temperatura para o modelo de IA.
+
+- **`--api-key [apiKey]`**  
+  Fornece sua própria chave de API para o serviço de IA.
+
+- **`--custom-prompt [prompt]`**  
+  Fornece um prompt personalizado para instruções de tradução.
+
+- **`--application-context [applicationContext]`**  
+  Fornece contexto adicional para tradução de IA.
+
+- **`--env`**  
+  Especifica o ambiente (ex: `development`, `production`).
+
+- **`--env-file [envFile]`**  
+  Fornece um arquivo de ambiente personalizado para carregar variáveis.
+
+- **`--base-dir`**  
+  Especifica o diretório base do projeto.
+
+- **`--verbose`**  
+  Ativa o registro detalhado para depuração.
+
+##### Exemplo:
+
+```bash
+npx intlayer fill --file src/home/*.content.ts --source-locale en --output-locales fr es --model gpt-3.5-turbo
+```
+
+Este comando traduz o conteúdo de todos os arquivos de declaração de conteúdo no diretório `src/home/` do inglês para francês e espanhol usando o modelo GPT-3.5 Turbo.
+
+### Gerenciamento de Configuração
+
+#### Obter Configuração
+
+O comando `get configuration` obtém a configuração atual do Intlayer, especialmente as configurações de local. Isso é útil para verificar a configuração.
+
+```bash
+npx intlayer config get
+```
+
+##### Argumentos:
+
+- **`--env`**: Especifica o ambiente (ex: `development`, `production`).
+- **`--env-file`**: Fornece um arquivo de ambiente personalizado para carregar variáveis.
+- **`--base-dir`**: Especifica o diretório base do projeto.
+- **`--verbose`**: Ativa o registro detalhado para depuração.
+
+#### Enviar Configuração
+
+O comando `push configuration` faz upload da configuração para o CMS e Editor do Intlayer. Esta etapa é necessária para usar dicionários remotos no Editor Visual do Intlayer.
+
+```bash
+npx intlayer config push
+```
+
+##### Argumentos:
+
+- **`--env`**: Especifica o ambiente (ex: `development`, `production`).
+- **`--env-file`**: Fornece um arquivo de ambiente personalizado para carregar variáveis.
+- **`--base-dir`**: Especifica o diretório base do projeto.
+- **`--verbose`**: Ativa o registro detalhado para depuração.
+
+Ao enviar a configuração, seu projeto fica totalmente integrado ao CMS do Intlayer, permitindo um gerenciamento perfeito de dicionários entre equipes.
+
+## Usando Comandos intlayer no `package.json`
+
+```json fileName="package.json"
+"scripts": {
+  "intlayer:build": "npx intlayer dictionaries build",
+  "intlayer:watch": "npx intlayer dictionaries build --watch",
+  "intlayer:push": "npx intlayer dictionary push",
+  "intlayer:pull": "npx intlayer dictionary pull",
+  "intlayer:audit": "npx intlayer audit"
+}
+```
+
+## Depurar o comando intlayer
+
+### 1. **Certifique-se de usar a versão mais recente**
+
+Execute:
+
+```bash
+npx intlayer --version                  # versão local atual do intlayer
+npx intlayer@latest --version          # versão mais recente do intlayer
+```
+
+### 2. **Verifique se o comando está registrado**
+
+Você pode verificar com:
+
+```bash
+npx intlayer --help      # Mostra uma lista de comandos disponíveis e informações de uso
+```
+
+### 3. **Reinicie seu terminal**
+
+Às vezes, é necessário reiniciar o terminal para reconhecer novos comandos.
+
+### 4. **Limpe o cache do npx (se estiver preso em uma versão anterior)**
+
+```bash
+npx clear-npx-cache
+```

package/pt/intlayer_visual_editor.md

@@ -0,0 +1,210 @@
+# Documentação do Editor Visual Intlayer
+
+<iframe title="Visual Editor + CMS for Your Web App: Intlayer Explained" class="m-auto aspect-[16/9] w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/UDDTnirwi_4?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
+
+O Editor Visual Intlayer é uma ferramenta que envolverá seu site para interagir com seus arquivos de declaração de conteúdo usando um editor visual.
+
+![Interface do Editor Visual Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/assets/visual_editor.gif)
+
+O pacote `intlayer-editor` é baseado no Intlayer e está disponível para aplicações JavaScript, como React (Create React App), Vite + React e Next.js.
+
+## Editor visual vs CMS
+
+O Editor Visual Intlayer é uma ferramenta que permite gerenciar seu conteúdo em um editor visual para dicionários locais. Uma vez feita uma alteração, o conteúdo será substituído na base de código. Isso significa que a aplicação será reconstruída e a página será recarregada para exibir o novo conteúdo.
+
+Em contraste, o [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/pt/intlayer_CMS.md) é uma ferramenta que permite gerenciar seu conteúdo em um editor visual para dicionários remotos. Uma vez feita uma alteração, o conteúdo **não** impactará sua base de código. E o site exibirá automaticamente o conteúdo alterado.
+
+## Integrar o Intlayer na sua aplicação
+
+Para mais detalhes sobre como integrar o Intlayer, consulte a seção relevante abaixo:
+
+### Integração com Next.js
+
+Para integração com Next.js, consulte o [guia de configuração](https://github.com/aymericzip/intlayer/blob/main/docs/pt/intlayer_with_nextjs_15.md).
+
+### Integração com Create React App
+
+Para integração com Create React App, consulte o [guia de configuração](https://github.com/aymericzip/intlayer/blob/main/docs/pt/intlayer_with_create_react_app.md).
+
+### Integração com Vite + React
+
+Para integração com Vite + React, consulte o [guia de configuração](https://github.com/aymericzip/intlayer/blob/main/docs/pt/intlayer_with_vite+react.md).
+
+## Como o Editor Intlayer Funciona
+
+O editor visual em uma aplicação inclui duas coisas:
+
+- Uma aplicação frontend que exibirá seu site em um iframe. Se seu site usa o Intlayer, o editor visual detectará automaticamente seu conteúdo e permitirá que você interaja com ele. Uma vez feita uma modificação, você poderá baixar suas alterações.
+
+- Após clicar no botão de download, o editor visual enviará uma solicitação ao servidor para substituir seus arquivos de declaração de conteúdo pelo novo conteúdo (onde quer que esses arquivos estejam declarados em seu projeto).
+
+> Observe que, por enquanto, o Editor Intlayer gravará seus arquivos de declaração de conteúdo como arquivos JSON.
+
+## Instalação
+
+Depois que o Intlayer estiver configurado em seu projeto, basta instalar o `intlayer-editor` como uma dependência de desenvolvimento:
+
+```bash packageManager="npm"
+npm install intlayer-editor --save-dev
+```
+
+```bash packageManager="yarn"
+yarn add intlayer-editor --save-dev
+```
+
+```bash packageManager="pnpm"
+pnpm add intlayer-editor --save-dev
+```
+
+## Configuração
+
+No arquivo de configuração do Intlayer, você pode personalizar as configurações do editor:
+
+```typescript fileName="intlayer.config.ts" codeFormat="typescript"
+import type { IntlayerConfig } from "intlayer";
+
+const config: IntlayerConfig = {
+  // ... outras configurações
+  editor: {
+    /**
+     * Obrigatório
+     * A URL da aplicação.
+     * Esta é a URL alvo do editor visual.
+     * Exemplo: 'http://localhost:3000'
+     */
+    applicationURL: process.env.INTLAYER_APPLICATION_URL,
+    /**
+     * Opcional
+     * Padrão como `true`. Se `false`, o editor está inativo e não pode ser acessado.
+     * Pode ser usado para desativar o editor em ambientes específicos por razões de segurança, como produção.
+     */
+    enabled: process.env.INTLAYER_ENABLED,
+    /**
+     * Opcional
+     * Padrão como `8000`.
+     * A porta do servidor do editor.
+     */
+    port: process.env.INTLAYER_PORT,
+    /**
+     * Opcional
+     * Padrão como "http://localhost:8000"
+     * A URL do servidor do editor.
+     */
+    editorURL: process.env.INTLAYER_EDITOR_URL,
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.mjs" codeFormat="esm"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  // ... outras configurações
+  editor: {
+    /**
+     * Obrigatório
+     * A URL da aplicação.
+     * Esta é a URL alvo do editor visual.
+     * Exemplo: 'http://localhost:3000'
+     */
+    applicationURL: process.env.INTLAYER_APPLICATION_URL,
+    /**
+     * Opcional
+     * Padrão como `true`. Se `false`, o editor está inativo e não pode ser acessado.
+     * Pode ser usado para desativar o editor em ambientes específicos por razões de segurança, como produção.
+     */
+    enabled: process.env.INTLAYER_ENABLED,
+    /**
+     * Opcional
+     * Padrão como `8000`.
+     * A porta usada pelo servidor do editor visual.
+     */
+    port: process.env.INTLAYER_PORT,
+    /**
+     * Opcional
+     * Padrão como "http://localhost:8000"
+     * A URL do servidor do editor para acessar a partir da aplicação. Usado para restringir as origens que podem interagir com a aplicação por razões de segurança. Se definido como `'*'`, o editor é acessível de qualquer origem. Deve ser configurado se a porta for alterada ou se o editor estiver hospedado em um domínio diferente.
+     */
+    editorURL: process.env.INTLAYER_EDITOR_URL,
+  },
+};
+
+export default config;
+```
+
+```javascript fileName="intlayer.config.cjs" codeFormat="commonjs"
+/** @type {import('intlayer').IntlayerConfig} */
+const config = {
+  // ... outras configurações
+  editor: {
+    /**
+     * Obrigatório
+     * A URL da aplicação.
+     * Esta é a URL alvo do editor visual.
+     */
+    applicationURL: process.env.INTLAYER_APPLICATION_URL,
+    /**
+     * Opcional
+     * Padrão como `8000`.
+     * A porta do servidor do editor.
+     */
+    port: process.env.INTLAYER_PORT,
+    /**
+     * Opcional
+     * Padrão como "http://localhost:8000"
+     * A URL do servidor do editor.
+     */
+    editorURL: process.env.INTLAYER_EDITOR_URL,
+    /**
+     * Opcional
+     * Padrão como `true`. Se `false`, o editor está inativo e não pode ser acessado.
+     * Pode ser usado para desativar o editor em ambientes específicos por razões de segurança, como produção.
+     */
+    enabled: process.env.INTLAYER_ENABLED,
+  },
+};
+
+module.exports = config;
+```
+
+> Para ver todos os parâmetros disponíveis, consulte a [documentação de configuração](https://github.com/aymericzip/intlayer/blob/main/docs/pt/configuration.md).
+
+## Usando o Editor
+
+1. Quando o editor estiver instalado, você pode iniciá-lo usando o seguinte comando:
+
+   ```bash packageManager="npm"
+   npx intlayer-editor start
+   ```
+
+   ```bash packageManager="yarn"
+   yarn intlayer-editor start
+   ```
+
+   ```bash packageManager="pnpm"
+   pnpm intlayer-editor start
+   ```
+
+   > **Observe que você deve executar sua aplicação em paralelo.** A URL da aplicação deve corresponder à que você configurou no editor (`applicationURL`).
+
+2. Em seguida, abra a URL fornecida. Por padrão `http://localhost:8000`.
+
+   Você pode visualizar cada campo indexado pelo Intlayer passando o cursor sobre seu conteúdo.
+
+   ![Passando o cursor sobre o conteúdo](https://github.com/aymericzip/intlayer/blob/main/docs/assets/intlayer_editor_hover_content.png)
+
+3. Se o seu conteúdo estiver destacado, você pode pressioná-lo por um longo tempo para exibir a gaveta de edição.
+
+## Depuração
+
+Se você encontrar problemas com o editor visual, verifique o seguinte:
+
+- O editor visual e a aplicação estão em execução.
+
+- As configurações do [`editor`](https://intlayer.org/doc/concept/configuration#editor-configuration) estão corretamente definidas no arquivo de configuração do Intlayer.
+
+  - Campos obrigatórios:
+    - A URL da aplicação deve corresponder à que você configurou no editor (`applicationURL`).
+
+- O editor visual usa um iframe para exibir seu site. Certifique-se de que a Política de Segurança de Conteúdo (CSP) do seu site permite a URL do CMS como `frame-ancestors` ('http://localhost:8000' por padrão). Verifique o console do editor para quaisquer erros.

package/pt/intlayer_with_angular.md

@@ -0,0 +1,3 @@
+this doc will be automatically generated translated from the english doc
+
+see /docs/en/intlayer_with_vite+preact.md