@intlayer/docs 5.5.8

package/pt/per_locale_file.md

@@ -0,0 +1,298 @@
+# Intlayer suporta duas maneiras de declarar conteúdo multilíngue:
+
+- Arquivo único com todas as traduções
+- Um arquivo por localidade (formato por localidade)
+
+Essa flexibilidade permite:
+
+- Migração fácil de outras ferramentas de i18n
+- Suporte para fluxos de trabalho de tradução automatizados
+- Organização clara das traduções em arquivos separados e específicos por localidade
+
+## Arquivo Único com Múltiplas Traduções
+
+Este formato é ideal para:
+
+- Iteração rápida no código.
+- Integração perfeita com o CMS.
+
+Esta é a abordagem recomendada para a maioria dos casos de uso. Centraliza as traduções, facilitando a iteração e integração com o CMS.
+
+```tsx fileName="hello-world.content.ts" contentDeclarationFormat="typescript"
+import { t, type Dictionary } from "intlayer";
+
+const helloWorldContent = {
+  key: "hello-world",
+  content: {
+    multilingualContent: t({
+      pt: "Título do meu componente",
+      en: "Title of my component",
+      es: "Título de mi componente",
+    }),
+  },
+} satisfies Dictionary;
+
+export default helloWorldContent;
+```
+
+```js fileName="hello-world.content.mjs" contentDeclarationFormat="esm"
+import { t } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const helloWorldContent = {
+  key: "hello-world",
+  content: {
+    multilingualContent: t({
+      pt: "Título do meu componente",
+      en: "Title of my component",
+      es: "Título de mi componente",
+    }),
+  },
+};
+
+export default helloWorldContent;
+```
+
+```js fileName="hello-world.content.cjs" contentDeclarationFormat="json"
+const { t } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const helloWorldContent = {
+  key: "hello-world",
+  content: {
+    multilingualContent: t({
+      pt: "Título do meu componente",
+      en: "Title of my component",
+      es: "Título de mi componente",
+    }),
+  },
+};
+
+module.exports = helloWorldContent;
+```
+
+```json fileName="hello-world.content.ts" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "content": {
+    "multilingualContent": {
+      "nodeType": "translation",
+      "translation": {
+        "pt": "Título do meu componente",
+        "en": "Title of my component",
+        "es": "Título de mi componente"
+      }
+    }
+  }
+}
+```
+
+> Recomendado: Este formato é o melhor ao usar o editor visual do Intlayer ou ao gerenciar traduções diretamente no código.
+
+## Formato Por Localidade
+
+Este formato é útil quando:
+
+- Você deseja versionar ou substituir traduções de forma independente.
+- Está integrando fluxos de trabalho de tradução automática ou humana.
+
+Você também pode dividir as traduções em arquivos individuais por localidade especificando o campo de localidade:
+
+```tsx fileName="hello-world.en.content.ts" contentDeclarationFormat="typescript"
+import { t, Locales, type Dictionary } from "intlayer";
+
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.ENGLISH, // Importante
+  content: { multilingualContent: "Title of my component" },
+} satisfies Dictionary;
+
+export default helloWorldContent;
+```
+
+```tsx fileName="hello-world.es.content.ts" contentDeclarationFormat="typescript"
+import { t, Locales, type Dictionary } from "intlayer";
+
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.SPANISH, // Importante
+  content: { multilingualContent: "Título de mi componente" },
+};
+```
+
+```js fileName="hello-world.en.content.mjs" contentDeclarationFormat="esm"
+import { t, Locales } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.ENGLISH, // Importante
+  content: { multilingualContent: "Title of my component" },
+};
+
+export default helloWorldContent;
+```
+
+```tsx fileName="hello-world.es.content.mjs" contentDeclarationFormat="esm"
+import { t, Locales } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.SPANISH, // Importante
+  content: { multilingualContent: "Título de mi componente" },
+};
+
+export default helloWorldContent;
+```
+
+```js fileName="hello-world.en.content.cjs" contentDeclarationFormat="commonjs"
+const { t, Locales } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.ENGLISH, // Importante
+  content: {
+    multilingualContent: "Title of my component",
+  },
+};
+
+module.exports = helloWorldContent;
+```
+
+```tsx fileName="hello-world.es.content.cjs" contentDeclarationFormat="commonjs"
+const { t, Locales } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.SPANISH, // Importante
+  content: {
+    multilingualContent: "Título de mi componente",
+  },
+};
+
+module.exports = helloWorldContent;
+```
+
+```json5 fileName="hello-world.en.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "locale": "en", // Importante
+  "content": {
+    "multilingualContent": "Title of my component",
+  },
+}
+```
+
+```json5 fileName="hello-world.es.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "locale": "es", // Importante
+  "content": {
+    "multilingualContent": "Título de mi componente",
+  },
+}
+```
+
+> Importante: Certifique-se de que o campo de localidade esteja definido. Ele informa ao Intlayer qual idioma o arquivo representa.
+
+> Nota: Em ambos os casos, o arquivo de declaração de conteúdo deve seguir o padrão de nomenclatura `*.content.{ts,tsx,js,jsx,mjs,cjs,json}` para ser reconhecido pelo Intlayer. O sufixo `.[locale]` é opcional e usado apenas como convenção de nomenclatura.
+
+## Misturando Formatos
+
+Você pode misturar ambas as abordagens para a mesma chave de conteúdo. Por exemplo:
+
+Declare conteúdo padrão ou base de forma estática (por exemplo, `index.content.ts`)
+
+Adicione ou substitua conteúdo específico por localidade em `index.content.json`, `index.fr.content.ts`, etc.
+
+Isso é especialmente útil quando:
+
+- Você deseja declarar seu conteúdo base de forma estática no código e preencher automaticamente com traduções no CMS.
+
+```bash codeFormat="typescript"
+.
+└── Components
+    └── MyComponent
+        ├── index.content.ts
+        ├── index.content.json
+        └── index.ts
+```
+
+### Exemplo
+
+Aqui está um arquivo de declaração de conteúdo multilíngue:
+
+```tsx fileName="Components/MyComponent/index.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+const helloWorldContent = {
+  key: "hello-world",
+  locale: Locales.ENGLISH,
+  content: {
+    multilingualContent: "Title of my component",
+    projectName: "My project",
+  },
+} satisfies Dictionary;
+
+export default helloWorldContent;
+```
+
+```json fileName="Components/MyComponent/index.content.json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "hello-world",
+  "content": {
+    "multilingualContent": {
+      "nodeType": "translation",
+      "translation": {
+        "pt": "Título do meu componente",
+        "fr": "Titre de mon composant",
+        "es": "Título de mi componente"
+      }
+    }
+  }
+}
+```
+
+O Intlayer mescla automaticamente arquivos multilíngues e por localidade.
+
+```tsx fileName="Components/MyComponent/index.ts"
+import { getIntlayer, Locales } from "intlayer";
+
+const intlayer = getIntlayer("hello-world"); // O idioma padrão é INGLÊS, então retornará o conteúdo em INGLÊS
+
+console.log(JSON.stringify(intlayer, null, 2));
+// Resultado:
+// {
+//  "multilingualContent": "Title of my component",
+//  "projectName": "My project"
+// }
+
+const intlayer = getIntlayer("hello-world", Locales.SPANISH);
+
+console.log(JSON.stringify(intlayer, null, 2));
+// Resultado:
+// {
+//  "multilingualContent": "Título de mi componente",
+//  "projectName": "My project"
+// }
+
+const intlayer = getIntlayer("hello-world", Locales.FRENCH);
+
+console.log(JSON.stringify(intlayer, null, 2));
+// Resultado:
+// {
+//  "multilingualContent": "Titre de mon composant",
+//  "projectName": "My project"
+// }
+```
+
+### Geração Automática de Traduções
+
+Use o [CLI do Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/pt/intlayer_cli.md) para preencher automaticamente traduções ausentes com base nos seus serviços preferidos.

package/pt/privacy_notice.md

@@ -0,0 +1,61 @@
+# Aviso de Privacidade
+
+## Introdução
+
+No Intlayer, levamos a privacidade a sério. Este aviso explica como lidamos com as informações coletadas através do nosso site e CMS.
+
+## Contato
+
+Se você tiver alguma dúvida ou preocupação sobre privacidade, entre em contato conosco no seguinte endereço: [contact@intlayer.org](mailto:contact@intlayer.org).
+
+## Uso de Cookies e Tecnologias de Rastreamento
+
+Utilizamos **Google Analytics** e o **Meta (Facebook) Pixel** para analisar o uso do nosso site e melhorar nossos serviços. Essas ferramentas geram estatísticas e outras informações sobre o site usando cookies armazenados nos dispositivos dos usuários.
+
+Para mais informações:
+
+- [Política de privacidade do Google](https://policies.google.com/privacy)
+- [Política de privacidade da Meta](https://www.facebook.com/privacy/policy)
+
+## Autenticação e Dados do Usuário
+
+O acesso ao CMS do Intlayer requer autenticação do usuário. Oferecemos autenticação por email/senha e login de terceiros via **Google** e **GitHub**.
+
+Durante o processo de autenticação, coletamos:
+
+- Endereço de email
+- Nome de exibição (ou nome escolhido)
+
+Os usuários também podem acessar o CMS por meio de tokens de acesso vinculados à sua conta. Esses tokens estão associados aos mesmos dados de autenticação.
+
+## Armazenamento e Segurança de Dados
+
+Os dados de autenticação dos usuários são armazenados em um **banco de dados MongoDB** hospedado em **cloud.mongodb.com**:
+
+- **Região:** AWS / Oregon (us-west-2)
+- **Tipo:** Replica Set (3 nós)
+- **Segurança de Senhas:** Todas as senhas são criptografadas usando práticas padrão da indústria.
+
+Não armazenamos nenhum dado pessoal desnecessário além do que é necessário para autenticação e acesso seguro ao CMS.
+
+## Compartilhamento de Dados com Terceiros
+
+Nós **não** vendemos ou compartilhamos seus dados pessoais com terceiros, exceto conforme necessário para análises (Google Analytics, Facebook Pixel) ou como parte do processo de autenticação (login via Google ou GitHub).
+
+## Direitos dos Usuários
+
+Como usuário, você tem o direito de:
+
+- Acessar os dados pessoais que possuímos sobre você
+- Solicitar correção ou exclusão dos seus dados
+- Revogar o acesso ou excluir sua conta
+
+Para qualquer solicitação relacionada aos seus dados, entre em contato conosco em [contact@intlayer.org](mailto:contact@intlayer.org).
+
+## Alterações neste Aviso
+
+Podemos atualizar este aviso de privacidade de tempos em tempos. Os usuários são aconselhados a verificar regularmente esta página para se manterem informados sobre quaisquer alterações.
+
+---
+
+Deixe-nos saber se você gostaria de um tom mais formal, adicionar menções ao GDPR/CCPA ou adaptá-lo para uma página legal no seu site.

package/pt/roadmap.md

@@ -0,0 +1,206 @@
+# Intlayer: Visão Geral de Recursos e Roteiro
+
+Intlayer é uma solução de gerenciamento de conteúdo e internacionalização projetada para simplificar como você declara, gerencia e atualiza conteúdo em suas aplicações. Ele oferece recursos poderosos, como declaração de conteúdo centralizada ou distribuída, amplas opções de internacionalização, suporte a Markdown, renderização condicional, integração com TypeScript/JavaScript/JSON e muito mais. Abaixo está uma visão geral abrangente do que o Intlayer atualmente fornece, seguida pelos recursos futuros no roteiro.
+
+---
+
+## Recursos Atuais
+
+### 1. Declaração de Conteúdo
+
+#### Centralizada ou Distribuída
+
+- **Centralizada**: Declare todo o seu conteúdo em um único arquivo grande na base da sua aplicação, semelhante ao i18next, para que você possa gerenciar tudo em um só lugar.
+- **Distribuída**: Alternativamente, divida seu conteúdo em arquivos separados no nível do componente ou recurso para melhor manutenção. Isso mantém seu conteúdo próximo ao código relevante (componentes, testes, Storybook, etc.). Remover um componente garante que qualquer conteúdo associado também seja removido, evitando dados residuais que possam sobrecarregar sua base de código.
+
+> Recursos:
+
+> - [Declaração de Conteúdo](https://github.com/aymericzip/intlayer/blob/main/docs/pt/dictionary/get_started.md)
+
+### 2. Internacionalização
+
+- Suporte para **230 idiomas e locais** (incluindo variantes regionais como Francês (França), Inglês (Canadá), Inglês (Reino Unido), Português (Portugal), etc.).
+- Gerencie facilmente traduções para todos esses locais em um único lugar.
+
+> Recursos:
+
+> - [Internacionalização](https://github.com/aymericzip/intlayer/blob/main/docs/pt/dictionary/translation.md)
+
+### 3. Suporte a Markdown
+
+- Declare conteúdo usando **Markdown**, permitindo que você formate automaticamente o texto com parágrafos, cabeçalhos, links e muito mais.
+- Ideal para postagens de blog, artigos, páginas de documentação ou qualquer cenário onde seja necessário formatação de texto rica.
+
+> Recursos:
+
+> - [Markdown](https://github.com/aymericzip/intlayer/blob/main/docs/pt/dictionary/markdown.md)
+
+### 4. Renderização Condicional
+
+- Defina conteúdo que se adapta com base em condições específicas, como idioma do usuário, status de login do usuário ou qualquer outra variável relacionada ao contexto.
+- Ajuda a personalizar experiências sem duplicar conteúdo em vários arquivos.
+
+> Recursos:
+
+> - [Renderização Condicional](https://github.com/aymericzip/intlayer/blob/main/docs/pt/dictionary/condition.md)
+
+### 5. Formatos de Declaração de Conteúdo
+
+O Intlayer suporta **TypeScript** (também JavaScript) e **JSON** para declarar conteúdo.
+
+- **TypeScript**:
+
+  - Garante que a estrutura do seu conteúdo esteja correta e que nenhuma tradução esteja faltando.
+  - Oferece modos de validação rigorosos ou mais flexíveis.
+  - Permite a busca dinâmica de dados a partir de variáveis, funções ou APIs externas.
+
+- **JSON**:
+
+  - Facilita a integração com ferramentas externas (como editores visuais) devido ao seu formato padronizado.
+
+  > Recursos:
+  >
+  > - [Formatos de Declaração de Conteúdo](https://github.com/aymericzip/intlayer/blob/main/docs/pt/dictionary/content_extention_customization.md)
+
+---
+
+## Integração com Frameworks e Ambientes
+
+### 1. Next.js
+
+#### a. Componentes do Servidor e Cliente
+
+- Fornece uma **abordagem unificada de gerenciamento de conteúdo** para componentes do servidor e cliente.
+- Oferece um contexto integrado para componentes do servidor, simplificando a implementação em comparação com outras soluções.
+
+#### b. Metadados, Sitemaps e robots.txt
+
+- Busque e injete conteúdo dinamicamente para gerar metadados, sitemaps ou arquivos `robots.txt`.
+
+#### c. Middleware
+
+- Adicione um middleware para **redirecionar usuários** para o conteúdo com base no idioma preferido.
+
+#### d. Compatibilidade com Turbopack e Webpack
+
+- Totalmente compatível com o novo Turbopack do Next.js, bem como com o Webpack tradicional.
+
+> Recursos:
+
+> - [Next.js](https://github.com/aymericzip/intlayer/blob/main/docs/pt/intlayer_with_nextjs_15.md)
+
+### 2. Vite
+
+- Semelhante ao Next.js, você pode integrar o Intlayer com o Vite e usar um **middleware** para redirecionar usuários para o conteúdo com base no idioma preferido.
+
+> Recursos:
+
+> - [Vite](https://github.com/aymericzip/intlayer/blob/main/docs/pt/intlayer_with_vite+react.md)
+
+### 3. Express
+
+- Gerencie conteúdo e internacionalize serviços de backend construídos no Express.
+- Personalize e-mails, mensagens de erro, notificações push e muito mais com texto localizado.
+
+> Recursos:
+
+> - [Express](https://github.com/aymericzip/intlayer/blob/main/docs/pt/intlayer_with_express.md)
+
+---
+
+## Editores Visuais e CMS
+
+### 1. Editor Visual Local
+
+- Um **editor visual local gratuito** que permite editar o conteúdo da sua aplicação selecionando diretamente os elementos na página.
+- Integra recursos de IA para ajudar:
+  - Gerar ou corrigir traduções
+  - Verificar sintaxe e ortografia
+  - Sugerir melhorias
+- Pode ser hospedado localmente ou implantado em um servidor remoto.
+
+> Recursos:
+
+> - [Editor Visual](https://github.com/aymericzip/intlayer/blob/main/docs/pt/intlayer_visual_editor.md)
+
+### 2. Intlayer CMS (Remoto)
+
+- Uma solução de **CMS hospedado** que permite gerenciar o conteúdo da aplicação online, sem tocar na base de código.
+- Fornece recursos assistidos por IA para declarar conteúdo, gerenciar traduções e corrigir erros de sintaxe ou ortografia.
+- Interaja com seu conteúdo por meio da interface ao vivo da sua aplicação.
+
+> Recursos:
+
+> - [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/pt/intlayer_CMS.md)
+
+---
+
+## Intlayer CLI
+
+- **Auditoria e Geração de Traduções**: Execute auditorias nos arquivos de conteúdo para gerar traduções ausentes ou identificar traduções não utilizadas.
+- **Interação Remota**: Publique seu conteúdo local no CMS remoto ou busque conteúdo remoto para integrar na sua aplicação local.
+- Útil para **pipelines CI/CD**, garantindo que seu conteúdo esteja sempre sincronizado com seu código.
+
+> Recursos:
+
+> - [CLI](https://github.com/aymericzip/intlayer/blob/main/docs/pt/intlayer_cli.md)
+
+---
+
+## Ambientes
+
+- Use **variáveis de ambiente** para configurar o Intlayer de forma diferente em ambientes de produção, teste e local.
+- Defina qual editor visual ou projeto CMS remoto direcionar dependendo do seu ambiente.
+
+---
+
+## Atualizações de Conteúdo em Tempo Real
+
+- Ao usar dicionários remotos e o Intlayer CMS, você pode **atualizar o conteúdo da sua aplicação em tempo real**, sem necessidade de reimplantação.
+
+> Recursos:
+
+> - [CMS](https://github.com/aymericzip/intlayer/blob/main/docs/pt/intlayer_CMS.md)
+
+---
+
+## Roteiro: Recursos Futuros
+
+### 1. Testes A/B e Personalização
+
+- **Testes Multivariados**: Teste diferentes versões de um determinado conteúdo para ver qual tem melhor desempenho (por exemplo, maior taxa de cliques).
+- **Personalização Baseada em Dados**: Exiba conteúdo diferente com base em dados demográficos do usuário (gênero, idade, localização, etc.) ou outros padrões de comportamento.
+- **Iteração Automatizada**: Permita que a IA teste automaticamente várias versões e escolha a de melhor desempenho ou recomende opções para aprovação do administrador.
+
+### 2. Controle de Versões
+
+- Restaure versões anteriores do seu conteúdo com **controle de versões de conteúdo**.
+- Acompanhe mudanças ao longo do tempo e reverta para estados anteriores, se necessário.
+
+### 3. Tradução Automática
+
+- Para usuários do CMS remoto, **geração de tradução com um clique** para qualquer idioma suportado.
+- O sistema geraria traduções em segundo plano e, em seguida, solicitaria validação ou edições.
+
+### 4. Melhorias de SEO
+
+- Ferramentas para **analisar palavras-chave**, intenção de busca do usuário e tendências emergentes.
+- Sugira melhorias no conteúdo para melhores classificações e acompanhe o desempenho a longo prazo.
+
+### 5. Compatibilidade com Mais Frameworks
+
+- Esforços estão em andamento para suportar **Vue, Solid, Svelte, Angular** e mais.
+- Objetivo de tornar o Intlayer compatível com **qualquer aplicação baseada em JavaScript**.
+
+### 6. Extensões para IDEs
+
+- Extensões para principais IDEs para fornecer uma **interface gráfica** para gerenciar traduções locais e remotas.
+- Recursos podem incluir geração automática de arquivos de declaração de conteúdo para componentes, integração direta com o Intlayer CMS e validação em tempo real.
+
+---
+
+## Conclusão
+
+O Intlayer tem como objetivo ser uma solução completa para gerenciamento de conteúdo e internacionalização. Ele se concentra em flexibilidade (arquivos centralizados ou distribuídos), amplo suporte a idiomas, fácil integração com frameworks e empacotadores modernos, e recursos poderosos impulsionados por IA. À medida que novas capacidades, como testes A/B, controle de versões e traduções automatizadas, se tornarem disponíveis, o Intlayer continuará simplificando fluxos de trabalho de conteúdo e elevando experiências de usuário em diferentes plataformas.
+
+Fique atento aos próximos lançamentos e sinta-se à vontade para explorar os recursos existentes para ver como o Intlayer pode ajudar a centralizar e otimizar seus processos de gerenciamento de conteúdo hoje!

package/pt/terms_of_service.md

@@ -0,0 +1,33 @@
+# Termos de Serviço
+
+## 1. Aceitação dos Termos
+
+Ao usar o Intlayer, você concorda em estar vinculado a estes termos de uso. Se você não aceitar estes termos, por favor, não utilize a ferramenta.
+
+## 2. Licença
+
+O Intlayer é distribuído sob a **licença Apache 2.0**, que permite o uso, modificação e distribuição do código para projetos de código aberto e comerciais. Os usuários podem modificar o código-fonte e enviar contribuições via pull requests de acordo com as diretrizes estabelecidas em nosso [guia de contribuição](https://github.com/aymericzip/intlayer/blob/main/CONTRIBUTING.md). O roubo de código para uso comercial é estritamente proibido.
+
+## 3. Uso Comercial
+
+Você tem permissão para usar o Intlayer em projetos comerciais. No entanto, reutilizar o código para criar ferramentas concorrentes diretas baseadas no Intlayer sem transformação significativa ou adição substancial de valor é proibido.
+
+## 4. Responsabilidade
+
+Os mantenedores do Intlayer se esforçam para corrigir bugs e problemas de segurança assim que são descobertos. No entanto, eles se isentam de qualquer responsabilidade por danos resultantes de tais problemas nas infraestruturas dos usuários. Incentivamos os usuários a relatar problemas através do nosso [sistema de rastreamento de problemas](https://github.com/aymericzip/intlayer/issues).
+
+## 5. Privacidade
+
+O Intlayer não coleta nem armazena quaisquer dados pessoais dos usuários.
+
+## 6. Contribuições
+
+Os usuários são incentivados a contribuir com o Intlayer seguindo as diretrizes fornecidas em nosso guia de contribuição. Qualquer código enviado deve aderir aos padrões de qualidade estabelecidos e será revisado pelos mantenedores antes da integração.
+
+## 7. Atribuição
+
+Qualquer ferramenta desenvolvida para estender ou utilizar o código do Intlayer deve claramente creditar o Intlayer como a base do código. Essa atribuição deve ser visível no código-fonte, bem como em qualquer documentação de usuário ou promocional.
+
+## 8. Modificação dos Termos
+
+Estes termos de uso podem ser modificados a qualquer momento. Os usuários serão informados de quaisquer mudanças significativas nos termos de uso e devem aceitar as alterações para continuar utilizando o Intlayer.