
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.
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.
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
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
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
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
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
- translation-review.txtBaixar este arquivo
- public/en/index.htmlBaixar este arquivo
- public/tr/index.htmlBaixar este arquivo
- worksheet.htmlBaixar este arquivo
- reference/assignment-walkthrough.txtBaixar este arquivo
- reference/public/en/index.htmlBaixar este arquivo
- reference/public/tr/index.htmlBaixar este arquivo
- reference/public/project.htmlBaixar este arquivo
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.
Erro comum
Medir a conclusão da tradução pelo número de textos preenchidos.
Esta lição foi útil?
Deixe uma curtida ou compartilhe com alguém que possa aproveitar.
Continue aprendendo
- Como criar seu primeiro site pessoal
- Como publicar seu site pelo GitHub
- Como conectar um domínio próprio ao seu site
- Como configurar e-mail no seu próprio domínio
- Como tornar seu site utilizável em celulares
- Como acelerar o carregamento das imagens do seu site
- Como receber os comentários do seu site na sua caixa de entrada
- Como adicionar assinaturas por e-mail ao seu site
- Como enviar e-mails automáticos pelo seu site
- Como salvar envios de formulário em um banco de dados
- Como permitir que as pessoas entrem no seu site
- Como manter uma página privada
- Como permitir que usuários editem as informações do perfil
- Como permitir que usuários enviem imagens
- Como manter chaves de API fora do frontend
- Como mostrar dados de uma API externa no seu site
- Como adicionar um chatbot de IA ao seu site
- Como fazer um chatbot responder com base no seu conteúdo
- Como adicionar um blog ao seu site
- Como adicionar busca ao seu site
- Como ajudar o Google a encontrar seu site
- Como corrigir a prévia do seu site ao compartilhar um link
- Como medir visitas e ações úteis no seu site
- Como permitir que visitantes agendem um horário
- Como aceitar um pagamento no seu site
- Como visualizar mudanças do site antes de publicar
- Como desfazer uma implantação com falha do seu site
- Como fazer backup e restaurar os dados do seu site
- Como encontrar e corrigir erros no seu site no ar