Mapeie páginas de documentos traduzidos pelo conteúdo e pela finalidade que compartilham e, em seguida, registre a URL exata de cada idioma. Slugs diferentes não são um problema. Este fluxo de trabalho para Mac ajuda um editor de documentos públicos a criar esse mapeamento e preparar links precisos para os idiomas e anotações de pesquisa.

Por que não é necessário que os slugs sejam iguais

Suponha que um documento em inglês explique como organizar uma grade de quadrados coloridos. Sua tradução para o francês explica a mesma tarefa, mas os dois endereços terminam de forma diferente. O Google permite explicitamente palavras localizadas nas URLs e recomenda URLs separadas para versões em diferentes idiomas. Não é necessário renomear as traduções para que seus caminhos correspondam. Gerenciar sites multirregionais e multilíngues.

Há duas perguntas distintas a responder: “Estas URLs são idênticas?” e “Estes documentos são traduções um do outro?” O padrão de URL WHATWG define a igualdade entre URLs pela comparação de URLs serializadas. Essa comparação não estabelece uma relação de tradução entre endereços diferentes. Neste fluxo de trabalho, determine a relação com base nos documentos e, em seguida, registre-a explicitamente. Padrão de URL, equivalência de URL.

Os exemplos abaixo são endereços fictícios de documentos públicos sob example.com; eles ilustram um mapeamento proposto, não páginas reais consultadas. A tarefa é conectar instruções equivalentes em inglês e francês, preservando o endereço existente de cada página.

Crie um registro de mapeamento no Mac

Comece com um par de documentos. Mantenha a página de origem e a tradução proposta abertas em abas separadas do Safari, junto com um documento de mapeamento local. Você precisa do texto completo de ambas as versões e, para a implementação futura, de acesso às configurações de publicação que controlam as relações entre idiomas ou os metadados das páginas.

Registre os endereços exatos

No Safari, pressione Command-L para selecionar o campo Busca Inteligente e, em seguida, Command-C para copiar o endereço. Repita para a tradução depois que ela terminar de carregar. A Apple documenta ambos os atalhos. Registrar o endereço alcançado após a navegação também permite perceber um destino inesperado. Atalhos de teclado e gestos no Safari para Mac.

Para uma coleção pequena, o TextEdit é suficiente. Crie um documento novo, escolha Formatar > Converter em Texto Simples e salve-o como translation-map.txt. Converter um documento existente de texto formatado remove sua formatação, então use um documento novo para este registro. Essas operações seguem as instruções da Apple para o TextEdit. Criar, abrir e converter documentos no TextEdit para Mac.

Use um identificador estável para o documento que descreva a tarefa subjacente. O exemplo a seguir é um registro ilustrativo completo, não um arquivo de configuração que um sistema de publicação lerá automaticamente:

ID do documento: tile-grid
Tarefa do leitor: Organizar uma grade de quatro colunas de quadrados coloridos
URL em inglês: https://example.com/en/docs/arrange-tiles
URL em francês: https://example.com/fr/guides/disposer-les-carres
Código do idioma inglês: en
Código do idioma francês: fr
Verificação do escopo: Mesmas instruções, diagrama e edição do documento
Decisão de mapeamento: Par de traduções

O identificador serve de referência quando os títulos ou slugs mudam. Mantenha os endereços em campos separados em vez de derivar um do outro. Substituir /en/ por /fr/ neste exemplo produziria um endereço não verificado e deixaria de corresponder ao caminho real da tradução.

Verifique se os documentos permitem concluir a mesma tarefa

Compare a introdução, as instruções, os rótulos do diagrama, os exemplos e a edição. Os títulos traduzidos não precisam se parecer palavra por palavra. Em vez disso, pergunte se um leitor que escolher o outro idioma receberá instruções equivalentes para a mesma atividade.

Use esta tabela de decisão antes de adicionar uma página ao mapa. Ela é um recurso editorial baseado na necessidade de identificar versões alternativas do mesmo conteúdo:

O que você encontra Decisão de mapeamento
Mesmas instruções para a grade e mesma edição, com texto traduzido Registrar como um par de traduções
Uma página aborda grades; a outra, a escolha de cores Manter como documentos separados
Uma tradução descreve uma edição anterior Resolver a diferença entre as edições antes de agrupar
Apenas a navegação está traduzida Não registrar o documento principal como totalmente traduzido
Não existe um documento correspondente Deixar esse idioma fora do mapa deste documento

Por exemplo, uma visão geral em francês que tenha links para várias atividades de desenho não substituiria as instruções específicas em inglês para a grade. Registre a tradução ausente como uma tarefa de conteúdo pendente. Um destino mais abrangente ainda pode ser útil para a navegação, mas não fornece o documento equivalente exigido por este mapeamento.

Conecte as páginas mapeadas para leitores e para o Google

Seu registro local é a fonte editorial da relação. As páginas publicadas também precisam de uma forma de expressá-la. Comece com links de idioma visíveis que levem os leitores diretamente à contraparte mapeada. O Google recomenda links entre versões em diferentes idiomas para que os leitores possam escolher e desaconselha redirecionar visitantes automaticamente com base no idioma presumido. Gerenciar sites multirregionais e multilíngues.

Para anotações de pesquisa, o Google oferece suporte a três métodos equivalentes: elementos HTML, cabeçalhos de resposta HTTP e sitemaps XML. Escolha um método fácil de manter. Cada versão no idioma deve identificar a si mesma e suas alternativas usando URLs completas, com links recíprocos. Informar ao Google sobre versões localizadas da sua página.

Para páginas HTML, prepare os links alternativos

O padrão HTML WHATWG define alternate com um valor diferente para hreflang como indicativo de uma tradução. Este é um fragmento de metadados HTML para o par fictício; ele deve ficar dentro do elemento head existente de cada página. Não é um documento HTML completo. Padrão HTML, tipo de link “alternate”.

<link rel="alternate" hreflang="en" href="https://example.com/en/docs/arrange-tiles">
<link rel="alternate" hreflang="fr" href="https://example.com/fr/guides/disposer-les-carres">

Inclua o mesmo par em ambas as páginas. Os URLs de destino continuam diferentes, inclusive nos slugs. A documentação do Google exige links de retorno e aceita códigos apenas de idioma, como en e fr. Informar ao Google sobre versões localizadas da sua página.

Para PDFs, use um método de publicação compatível

Não é possível inserir o fragmento acima em um head HTML de um PDF. O Google documenta cabeçalhos de resposta HTTP Link para arquivos que não são HTML. Para um par fictício de PDFs, o campo de cabeçalho completo seria: Informar ao Google sobre versões localizadas da sua página.

Link: <https://example.com/en/files/tile-grid.pdf>; rel="alternate"; hreflang="en", <https://example.com/fr/fichiers/grille-de-carres.pdf>; rel="alternate"; hreflang="fr"

Configure esse campo na resposta de cada PDF. A RFC 8288 define a sintaxe de links HTTP, incluindo o destino entre sinais de menor e maior e o parâmetro hreflang. Essas são configurações de resposta; digitar o cabeçalho no texto visível do PDF não as configura. RFC 8288: Links da Web.

Se o sistema de publicação não puder editar metadados HTML nem cabeçalhos de resposta, o Google também aceita um sitemap com anotações de idioma. Cada entrada de URL lista todas as versões, inclusive a própria. Use a estrutura de sitemap documentada por meio do sistema de publicação ou de seu responsável. Um arquivo de mapeamento local, por si só, não implementa nenhum desses métodos. Informar ao Google sobre versões localizadas da sua página.

Mantenha as relações de tradução separadas de redirecionamentos e URLs canônicos

Uma alternativa de idioma, uma URL duplicada preferencial e uma página movida representam relações diferentes. Fazer essa distinção evita que uma alteração de mapeamento bem-intencionada afaste os leitores do documento que escolheram.

Mecanismo Finalidade documentada Aplicação a esta tarefa
rel="alternate" com hreflang Identificar alternativas de idioma Conectar as traduções mapeadas
rel="canonical" Indicar uma URL preferencial entre páginas duplicadas ou muito semelhantes Tratar endereços duplicados no idioma apropriado
Location em uma resposta de redirecionamento Identificar o destino do redirecionamento Tratar um endereço que foi movido
Content-Language Descrever o público-alvo do idioma da representação Identificar o público da resposta
Content-Location Identificar o recurso correspondente à representação incluída Descrever a localização da representação

O Google recomenda um URL canônico no mesmo idioma ao usar hreflang, ou o melhor substituto caso não exista um. Para estes documentos traduzidos distintos, uma implementação simples é usar, em cada URL de idioma preferencial, um URL canônico que aponte para si mesmo. Evite apontar o URL canônico em francês para o inglês só porque o inglês foi escrito primeiro. Como especificar um URL canônico com rel="canonical" e outros métodos.

A RFC 9110 define separadamente Location em respostas de redirecionamento, Content-Language e Content-Location. Este último é metadado da representação, não um substituto para a URL de destino. Nenhum desses campos, por si só, enumera o par de traduções deste documento; mantenha os links alternativos para essa relação. RFC 9110: Semântica HTTP.

Verifique cada direção e mantenha o mapeamento

Antes de encaminhar o mapeamento para implementação, faça as verificações a seguir. Repita-as no conteúdo público após qualquer alteração de publicação; um registro correto e metadados publicados corretos são coisas distintas.

  1. Abra os dois endereços registrados e compare o conteúdo real dos documentos.
  2. Siga o link de idioma visível do inglês para o francês e depois volte. Verifique se cada destino é a contraparte específica.
  3. Compare os URLs alternativos configurados com o registro de mapeamento, caractere por caractere.
  4. Confirme que ambas as versões identificam o mesmo conjunto de traduções, inclusive elas próprias.
  5. Verifique separadamente as configurações de URL canônico de cada idioma.
  6. Se um endereço mudar, atualize o mapa e todas as referências a esse endereço no par.

Tenha cuidado ao padronizar URLs. A RFC 9110 define o esquema e o host como insensíveis a maiúsculas e minúsculas, enquanto os outros componentes são comparados distinguindo maiúsculas de minúsculas, de acordo com suas regras de normalização. Não converta um caminho para minúsculas nem remova uma barra final apenas para que dois registros pareçam consistentes; mantenha o destino verificado. RFC 9110, normalização e comparação de HTTP(S).

Para o par fictício, o resultado útil é um registro estável de tile-grid que conecte dois endereços exatos, com conteúdo equivalente e links funcionais em ambas as direções. Mantenha esse registro junto às notas de manutenção do documento para que uma futura tradução ou alteração de slug permita atualizar a relação de forma deliberada.

Fontes