O Gerador de Hreflang da Screpy cria etiquetas HTML, fragmentos de sitemap XML ou declarações HTTP Link para um grupo de páginas equivalentes em diferentes idiomas. Introduza 2–50 códigos suportados com as respetivas URL, escolha um formato e copie ou descarregue o resultado de cada página. O gerador prepara as anotações a partir dos valores fornecidos; não visita as URL, instala o código ou confirma as ligações de retorno entre páginas publicadas.
Prepare um grupo de páginas equivalentes
Use cada geração para versões da mesma página: o mesmo produto, artigo ou serviço em idiomas ou mercados diferentes. Uma página inicial francesa e uma página de produto inglesa não são equivalentes apenas por partilharem o domínio. Repita o processo para o conteúdo seguinte, em vez de reunir todas as URL traduzidas do site num único grupo.
Para um produto ilustrativo com versões inglesa e turca, prepare estes valores:
| Campo | Valor | Finalidade |
|---|---|---|
| Idioma e URL | en — https://example.com/en/blue-shirt/ |
Página de produto inglesa |
| Idioma e URL | tr — https://example.com/tr/mavi-gomlek/ |
Página de produto turca equivalente |
| URL x-default opcional | https://example.com/choose-language/ |
Destino adequado para selecionar o idioma |
Os caminhos traduzidos podem ser diferentes. Copie cada URL pública pretendida em vez de a construir trocando a pasta do idioma. Inclua o endereço HTTP ou HTTPS completo e mantenha o domínio, caminho e barra final coerentes com o destino a publicar. Não são aceites credenciais nas URL. O formulário remove fragmentos como #details; use endereços de páginas em vez de ligações para secções.
Escolha códigos de idioma suportados
Este gerador aceita um idioma de duas letras, como en, tr ou de, seguido opcionalmente de uma região suportada de duas letras, como en-GB ou pt-BR. Use en quando a página serve leitores de inglês em geral; use um código regional quando mantém realmente essa versão regional. Um país isolado, como GB, não designa um idioma.
Cada linha normal precisa de um código diferente. en-US e en-us contam como a mesma entrada; alterar as maiúsculas não cria outra versão. Os códigos gerados usam minúsculas no idioma e maiúsculas na região. Reveja os valores antes de copiar, sobretudo a diferença entre o idioma uk e a região GB para o Reino Unido.
O formulário suporta apenas códigos de idioma e idioma-região. Não aceita combinações de escrita como zh-Hant, embora a Google suporte anotações de escrita nos casos adequados. Se a sua implementação precisar delas, prepare-as fora deste gerador. Um código aceite também não confirma que o texto real da página corresponde a esse idioma.
Decida se deve adicionar x-default
Uma URL x-default identifica um destino para utilizadores cujo idioma ou região não está abrangido pelas outras opções. Pode ser um seletor de idioma ou uma página existente escolhida como predefinida. A explicação da Google sobre x-default descreve ambas as opções. Escolha um destino útil para este grupo; não envie os visitantes de cada produto para uma página sem relação apenas para preencher o campo.
O campo é opcional. Deixá-lo vazio não acrescenta uma anotação predefinida. Introduzir uma URL acrescenta hreflang="x-default" a cada conjunto gerado, sem criar um redirecionamento do navegador ou uma interface de seleção de idioma.
Ao adicionar o seletor às duas linhas do exemplo, obtém dois blocos de saída com três alternativas cada: en, tr e x-default. Não é criado um terceiro bloco para o seletor. Se o destino predefinido for uma página separada, configure as respetivas anotações por sua conta. Se já for uma das URL das linhas normais, essa página já tem um bloco gerado. Confirme esta diferença antes de assumir que todos os destinos têm código de instalação.
Selecione a saída HTML ou HTTP Link
Escolha o formato que consegue manter onde as páginas do grupo são servidas. Não precisa de gerar os três apenas por estarem disponíveis.
| Formato | Local de instalação | Resultado recebido |
|---|---|---|
| HTML | O <head> de cada página |
Um conjunto de elementos <link> |
| HTTP Link | A resposta HTTP de cada página | Uma declaração de cabeçalho Link: |
| XML | Um sitemap com alternativas de idioma | Um fragmento <url> por página normal |
Para HTML, o grupo ilustrativo produz este conjunto, que pertence ao head das duas páginas de produto:
<link rel="alternate" hreflang="en" href="https://example.com/en/blue-shirt/" />
<link rel="alternate" hreflang="tr" href="https://example.com/tr/mavi-gomlek/" />
<link rel="alternate" hreflang="x-default" href="https://example.com/choose-language/" />
A página inglesa inclui a própria página e a turca; a página turca recebe o mesmo conjunto. Num CMS, use o modelo ou campo que controla o head. Colar as etiquetas no corpo visível de um artigo não é a instalação prevista.
A saída HTTP Link pertence aos cabeçalhos de resposta, configurados no sistema de publicação ou servidor. É útil para documentos como PDF sem head HTML. Copie a declaração inteira, não apenas uma URL, e inspecione a resposta real após a instalação. Descarregar um ficheiro de texto não altera uma resposta por si só. Preserve as declarações de cabeçalho existentes que não estejam relacionadas com estas alternativas.
Transforme os fragmentos XML num sitemap
O download XML é um fragmento de página, não um sitemap completo pronto para enviar. Cada bloco fornece um <loc> para a página da sua linha normal e repete as alternativas em elementos <xhtml:link>. Adicione os blocos a um sitemap com os espaços de nomes sitemap e XHTML.
Para o exemplo no mesmo domínio, um ficheiro completo com duas páginas seria assim:
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
xmlns:xhtml="http://www.w3.org/1999/xhtml">
<url>
<loc>https://example.com/en/blue-shirt/</loc>
<xhtml:link rel="alternate" hreflang="en" href="https://example.com/en/blue-shirt/" />
<xhtml:link rel="alternate" hreflang="tr" href="https://example.com/tr/mavi-gomlek/" />
<xhtml:link rel="alternate" hreflang="x-default" href="https://example.com/choose-language/" />
</url>
<url>
<loc>https://example.com/tr/mavi-gomlek/</loc>
<xhtml:link rel="alternate" hreflang="en" href="https://example.com/en/blue-shirt/" />
<xhtml:link rel="alternate" hreflang="tr" href="https://example.com/tr/mavi-gomlek/" />
<xhtml:link rel="alternate" hreflang="x-default" href="https://example.com/choose-language/" />
</url>
</urlset>
Os dois valores <loc> são diferentes; os conjuntos de alternativas coincidem. Ao adicionar fragmentos a um ficheiro existente, mantenha um único <urlset> exterior em vez de encaixar documentos completos. Substitua as URL de exemplo pelas suas e preserve escapes XML como & nos parâmetros de consulta. Publique o ficheiro numa localização que abranja as páginas enumeradas; este exemplo é adequado a um sitemap na raiz de example.com.
Consulte as instruções da Google sobre hreflang em sitemaps para os requisitos de espaços de nomes e alojamento. Os downloads separados do gerador não montam, alojam ou enviam o sitemap por si.
Verifique as anotações instaladas
Um resultado gerado mostra o que os valores fornecidos produzem, não o que visitantes ou rastreadores recebem. Após a instalação, compare as páginas publicadas com o grupo previsto:
- Verifique se cada endereço alternativo abre a página no idioma pretendido, e não um erro, uma URL antiga ou um destino sem relação.
- Para HTML ou cabeçalhos, inspecione as anotações reais de cada página normal, incluindo a autorreferência e as ligações de retorno às outras versões.
- Para XML, inspecione o sitemap publicado: a estrutura exterior, cada
<loc>e o conjunto completo de alternativas. - Reveja as etiquetas canonical juntamente com as alternativas. As orientações da Google sobre canonical recomendam uma página canónica no mesmo idioma quando disponível. Não aponte automaticamente o canonical de todas as traduções para a página inglesa.
Use Hreflang Tags Tester para inspecionar as declarações HTML e HTTP publicadas. Este verificador não valida anotações de sitemap ou etiquetas renderizadas por JavaScript. Se as URL preferidas não coincidirem com o grupo, examine-as com Canonical Tag Checker.
Quando uma tradução mudar de endereço ou desaparecer, atualize o grupo em todos os locais onde o instalou. Gerar um conjunto novo sem substituir as anotações publicadas mantém a relação anterior. Hreflang ajuda a descrever versões equivalentes; não traduz conteúdo nem garante indexação, posições ou que a Google apresente sempre uma URL específica.