Minilição · Português

Como adicionar outro idioma ao seu site

Dê a um assistente texto equivalente para um segundo idioma e verifique se a troca preserva todo o significado da página e os links úteis.

Começar a aula interativaLer as notas da aula

Para quem é esta lição?

Para quem quer que os visitantes usem o mesmo site em outro idioma. Você fornece ou revisa o texto; um assistente de programação edita as páginas fornecidas. Não é preciso conhecer HTML.

Antes de começar

O site de prática fornecido em inglês e turco e um assistente de programação para abrir uma visualização HTTP. Use os dados de projeto fornecidos; não precisa de portfólio pessoal para começar. Peça a um leitor competente para verificar o significado no idioma quando possível.

Tempo estimado: 19–31 min

Estimativas com os arquivos iniciais e as contas e ferramentas necessárias já prontas. Configuração, filas de publicação e esperas de e-mail ou DNS exigem tempo adicional. A revisão da tradução é separada do roteamento. Não publique traduções automáticas sem revisão.

O que você vai aprender

  • Mantenha os mesmos fatos e ações nos dois idiomas.
  • Abra cada idioma diretamente e alterne para sua página equivalente.
  • Encontre conteúdo não traduzido ou contraditório.

Arquivos da oficina

Etapa 1

Compare a mesma página em dois idiomas

Só traduzir o menu não traduz a experiência.

Abra as páginas fornecidas em inglês e turco. Atualmente elas apresentam o site e oferecem contato; a seção de projeto é o que você vai adicionar. Use o projeto fictício Neighbourhood library, sem inventar seu próprio histórico.

Os dois idiomas precisam descrever o mesmo projeto, seu estado e o destino do link. Em qualquer versão, o visitante deve entender sua função e encontrar o mesmo contato.

Um exemplo concreto

Inglês: “Neighbourhood library — A simple page that makes opening hours and the address easy to find.” Turco: “Mahalle kütüphanesi — Çalışma saatlerini ve adresi kolayca bulmayı sağlayan sade bir sayfa.” Os dois descrevem o exemplo fictício fornecido, não uma realização pessoal lançada.

Use o site bilíngue e os dados de projeto fornecidos. Adicione seções equivalentes de projetos em inglês e turco preservando estado, links e significado do contato. Cuide do código de idioma da página e roteamento para mim. Mostre as duas URLs diretas e ajude a testar a troca de idioma, o texto completo e a tarefa de contato. Não altere fatos para a tradução parecer mais impressionante.

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Acrescente outro idioma sem mudar a proposta do site

Traduza uma tarefa completa do visitante, não apenas os textos de navegação.

Um site multilíngue precisa de conteúdo útil equivalente. Se a página em turco tem apenas um título traduzido enquanto o artigo e as instruções continuam em inglês, os visitantes não receberam uma experiência em turco.

Este site de prática tem páginas /en/ e /tr/ com o mesmo objetivo e a mesma ação de contato. A lição original está em inglês. Mantemos o exemplo pequeno o suficiente para revisar cada elemento traduzido.

Exemplo resolvido

O convite em inglês propõe ver os trabalhos e encontrar informações de contato. A versão em turco faz a mesma proposta; ela não apresenta um serviço ausente na página em inglês.

Extra implementation exercise

O seletor de idioma muda o menu, mas deixa as instruções principais inalteradas. O que está incompleto?

Mostrar uma solução comentada

Traduza também as instruções, os metadados e os textos das ações. Depois teste a mesma tarefa nos dois idiomas; apenas ter menus equivalentes não basta.

  • Inclui o conteúdo do corpo e os textos das ações no escopo da tradução.
  • Preserva a mesma tarefa do visitante e o mesmo significado.

Etapa 2

Abra cada idioma diretamente

Respeite a escolha explícita de idioma do visitante.

Peça ao assistente que sirva a pasta public por HTTP e mostre os endereços diretos /en/ e /tr/. Abra cada um em uma nova janela e use Türkçe ou English para chegar à página correspondente.

O endereço escolhido deve determinar o idioma. O site fornecido não redireciona por país; adicionar uma suposição de localização não deve tirar alguém da página inglesa escolhida pela URL.

Um exemplo concreto

Começar em /en/ mostra “A small website, clearly explained”; escolher Türkçe abre /tr/ e “Küçük bir site, açık bir anlatım”. English leva de volta a /en/.

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Dê a cada idioma um endereço confiável

Um link compartilhado deve abrir o idioma especificado na URL.

Sirva as pastas fornecidas e abra diretamente a URL de cada idioma. O atributo lang do HTML descreve o idioma real da página e ajuda as ferramentas assistivas a usar a pronúncia adequada.

O seletor de idioma visível é um link normal para a página equivalente. Em um sistema maior, a URL explícita deve ter prioridade sobre uma preferência salva ou uma suposição de país. Padrões automáticos podem ajudar na entrada sem prefixo, mas não devem desviar um visitante de /en/ do link em inglês que ele escolheu.

Exemplo resolvido

Um visitante em Türkiye que abre /en/ continua recebendo inglês. O país pode indicar um padrão, mas não tem mais peso que uma escolha explícita.

<html lang="tr">
<a href="../en/" lang="en" hreflang="en">English</a>

Extra implementation exercise

Uma URL em inglês deve redirecionar para turco só porque o país do visitante é Türkiye?

Mostrar uma solução comentada

Não. Sirva inglês em /en/. Aplique um padrão de país ou navegador apenas quando o visitante ainda não tiver selecionado um idioma.

  • Mantém a prioridade da escolha explícita de URL.
  • Distingue padrões de mudanças de idioma forçadas.

Etapa 3

Peça uma revisão completa de idioma

Deixe o assistente atualizar a seção inteira, não apenas o título.

Entregue ao assistente as duas descrições da biblioteca. Peça para adicionar a seção inteira nas duas páginas, manter o rótulo fictício e ligar ambas ao destino de prática fornecido. Deixe os arquivos e caminhos de links com o assistente.

Compare título, descrição, estado e texto do link nos dois idiomas. Mantenha um nome próprio sem tradução apenas quando for intencional; não deixe uma descrição comum sem traduzir.

Um exemplo concreto

Um título turco acima de “A simple page that makes opening hours and the address easy to find” é uma tradução incompleta. O corpo também deve usar a frase equivalente em turco fornecida.

Google: versões localizadas de páginas

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Conecte páginas equivalentes para os mecanismos de busca

Use alternativas de idioma corretas e a URL canônica própria de cada página.

Examine os links canônicos e alternativos nas duas páginas. Substitua a origem reservada YOUR-SITE.example antes de uma implantação real. As duas páginas listam as mesmas alternativas em inglês e turco.

Cada página de idioma tem seu próprio endereço canônico. Apontar o canônico em turco para o inglês enviaria um sinal contraditório sobre qual conteúdo deve ser indexado. Os metadados de idioma ajudam na descoberta; eles não garantem indexação nem posicionamento.

Somente as páginas de conteúdo /en/ e /tr/ deste exemplo têm links canônicos e alternativos; a raiz é uma página de escolha de idioma. Cada página de conteúdo lista as duas alternativas, incluindo ela mesma. Antes da implantação, substitua a origem de exemplo nos dois arquivos e verifique os quatro destinos alternativos e os dois canônicos que apontam para a própria página.

Exemplo resolvido

A página /tr/ aponta seu canônico para /tr/ e sua alternativa em inglês para /en/. Deixar um canônico em inglês copiado no arquivo em turco é um erro comum que passa despercebido.

Google: versões localizadas de páginas

Extra implementation exercise

O que precisa mudar ao copiar a página em inglês para criar a versão em turco?

Mostrar uma solução comentada

Traduza o texto visível e o título, defina lang=tr e o canônico em turco e confira se as duas versões apontam para o mesmo par correspondente de URLs alternativas.

  • Atualiza o texto real, lang, o título e o canônico.
  • Mantém corretas as alternativas recíprocas de idioma.

Etapa 4

Conclua o mesmo percurso de visitante duas vezes

Guarde um registro breve de significado e navegação.

Conclua as duas seções. Em cada página direta, abra o projeto de prática e volte pelo link English ou Türkçe. Depois teste o e-mail sob Contact ou İletişim.

hello@example.com é um marcador. Na prática, você pode conferir que as duas páginas usam o mesmo destino; antes de compartilhar seu site, troque pelo contato público escolhido. Abrir o aplicativo de e-mail não envia uma mensagem.

Um exemplo concreto

Um registro útil separa significado e comportamento: as descrições concordam; os dois links chegam a project.html; os contatos usam o mesmo endereço. A revisão por um leitor fluente é outra verificação.

Arquivos desta etapa

Start hereArquivos da oficina

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Sua tarefa: traduzir uma segunda seção

Revise o significado e a navegação realizando a mesma tarefa nas duas versões.

Acrescente uma seção curta de projeto às duas páginas. Nomeie o projeto, descreva o mesmo resultado e forneça o mesmo link de destino. Peça a uma pessoa com domínio do idioma que revise a naturalidade do texto, em vez de comparar palavras mecanicamente.

Abra cada URL direta em um novo contexto do navegador, siga o link de idioma e realize a tarefa de contato. Registre qualquer texto ausente ou contraditório. Não acrescente mais idiomas antes de esse par estar coerente.

Exemplo resolvido

Um projeto descrito como protótipo em inglês não pode virar um produto lançado em turco. A qualidade da tradução inclui consistência dos fatos.

O roteiro completo de referência está em reference/assignment-walkthrough.txt. Compare as etapas com seu resultado; preencha o registro de teste com observações do seu próprio projeto.

Extra implementation exercise

Acrescente seções de projeto equivalentes e conclua a revisão do significado e da navegação.

Mostrar uma solução comentada

Acrescente o mesmo projeto às duas páginas de conteúdo: EN 'Neighbourhood library — A simple page that makes opening hours and the address easy to find.' TR 'Mahalle kütüphanesi — Çalışma saatlerini ve adresi kolayca bulmayı sağlayan sade bir sayfa.' O texto em inglês significa “Biblioteca do bairro: uma página simples que facilita encontrar o horário de funcionamento e o endereço”. Mantenha o mesmo estado do projeto e o mesmo destino.

Revise as duas páginas completas de referência. O atributo lang, o título, o corpo, o texto de contato, o canônico próprio e as alternativas recíprocas correspondem a cada idioma. Substitua a origem reservada nos dois arquivos antes de uma implantação real.

Abra /en/ diretamente e depois /tr/ diretamente; nenhuma delas pode ser substituída por uma suposição de localização. Alterne usando os links visíveis para as páginas equivalentes e realize a tarefa de contato em cada idioma.

  • Os dois idiomas comunicam o mesmo estado correto do projeto.
  • As URLs diretas e os links de idioma entre páginas equivalentes permanecem estáveis.

Esta lição foi útil?

Deixe uma curtida ou compartilhe com alguém que possa aproveitar.

Continue aprendendo

Explore as outras lições