Idiomas

O Sensedia Docs suporta documentação multilíngue, permitindo que você alcance um público mais amplo.

📋 Índice

1. Introdução
2. Criando Versões de Idiomas
3. Publicando Traduções
4. Boas Práticas

Introdução

O Sensedia Docs permite criar e gerenciar documentação em vários idiomas. Isso é essencial para alcançar um público global e garantir que seu conteúdo seja acessível aos usuários em seu idioma preferido.

Criando Versões de Idiomas

Estrutura Básica

Para criar uma nova versão da documentação em outro idioma, siga estes passos:

1. Crie um Novo Diretório: Para cada idioma, crie um novo diretório em example/docs/en/. Por exemplo, para espanhol, crie example/docs/es/.
2. Copie os Arquivos Existentes: Copie os arquivos Markdown do diretório em inglês para o novo diretório do idioma.
3. Traduza o Conteúdo: Traduza o conteúdo de cada arquivo Markdown para o idioma desejado.

Exemplo de Estrutura de Diretórios

Publicando Traduções

O processo de build é gerenciado pelo Sensedia Docs CLI, que detecta automaticamente os diretórios de idiomas e os publica conforme necessário. Certifique-se de manter o nome dos arquivos igual em todos os idiomas. É importante manter os mesmos nomes de arquivos nos diferentes diretórios de idiomas para garantir o correto funcionamento dos links e da navegação.

Boas Práticas

1. Estrutura Consistente: Mantenha uma estrutura de diretórios consistente em todas as versões de idiomas para facilitar a navegação e o gerenciamento.
2. Atualizações Regulares: Mantenha todas as versões de idiomas atualizadas com as últimas alterações de conteúdo para proporcionar uma experiência uniforme a todos os usuários.
3. Use Códigos de Idioma: Utilize códigos de idioma padrão (por exemplo, en, es, pt-BR) para nomear os diretórios, garantindo clareza e consistência.

FAQ