URLs canônicas

As URLs canônicas dizem aos mecanismos de busca qual endereço é autoritativo para uma página, o que é importante quando o mesmo conteúdo pode ser acessado por URLs ligeiramente diferentes. O Chinaski trata canonicals em três níveis: a URL do seu site, valores automáticos por página e sobrescritas escolhidas manualmente. Esta página explica cada um.

A URL do seu site vem primeiro

Tudo o que é canônico começa com a configuração URL do Site. O Chinaski constrói cada endereço canônico a partir dela, então acertar aqui é o passo um: defina uma vez (por exemplo https://example.com) e escolha sua grafia preferida, incluindo se deve usar www..

Para sites multilíngues, a base efetiva se adapta ao seu modo de URL por idioma. No modo subdomínio (es.example.com), as URLs canônicas de cada idioma são reescritas automaticamente para o subdomínio daquele idioma.

Sem uma URL de Site definida, nenhuma URL canônica é emitida: nada absoluto é inventado.

Canonicals automáticos em cada página

Quando uma página não tem uma URL canônica personalizada, o Chinaski calcula uma automaticamente:

Páginas recebem seu próprio endereço público (incluindo qualquer caminho de página pai).
Posts recebem seu endereço completo de blog (incluindo o prefixo do blog, como /blog/).
Listagens de blog e categorias recebem canonicals por página: a página 2 do blog aponta para o endereço da página 2, não para a primeira página do blog, para que páginas paginadas não concorram entre si na busca.
O índice de documentos canonicaliza para o endereço da sua própria seção.
URLs antigas que têm redirecionamentos também carregam uma tag canônica apontando para o destino, que é como os mecanismos de busca tratam corretamente a página movida.

Cada página renderizada então emite a canônica duas vezes em suas meta tags: como a tag <link rel="canonical"> e como a propriedade OpenGraph og:url usada pelas plataformas sociais.

Sobrescrevendo a canônica de uma página

Se você sindica conteúdo, publica uma versão espelhada ou, por outro motivo, precisa que uma página credite outro endereço, preencha o campo URL Canônica na seção de SEO do editor de página ou post. O que você inserir ali prevalece: o builder usa seu valor literalmente em vez do calculado automaticamente. Deixe em branco em circunstâncias normais, pois o valor automático já está correto.

Impondo um único host de domínio

As tags canônicas dizem aos mecanismos de busca o que você prefere; os redirecionamentos forçam isso. A cada build, o Chinaski escreve uma regra no arquivo de redirecionamentos do site que envia a grafia não canônica do seu host para a canônica (www.example.com → example.com, ou o inverso, dependendo da configuração da URL do Site), de forma permanente (301) e preservando o caminho solicitado. A regra é reescrita de forma limpa a cada build, para nunca acumular duplicatas, e o log do build informa sempre que o bloco de imposição foi escrito.

Uma ressalva de hospedagem: essa regra de domínio é escrita no arquivo _redirects no formato Netlify, que hosts e gateways que leem esse formato podem impor no servidor. O arquivo de exportação no formato Caddy não a inclui. Nessas configurações a imposição fica no nível das tags da página e, se você quiser um redirecionamento rígido, adiciona uma regra de host ao seu próprio Caddyfile.

Orientação prática

Defina a URL do Site uma vez, cedo. Tudo que é absoluto (canonicals, URLs sociais, endereços do sitemap) deriva dela.
Não sobrescreva canonicals por impulso. O valor automático está correto para todas as páginas comuns; use o campo de sobrescrita apenas quando o conteúdo genuinamente existe em outra URL (sindicação, agregadores).
Um quadro de referência: uma canônica aponta páginas para fora, para outros sites ou entre domínios seus; para páginas que nunca saíram do seu site, deixe o campo em branco e deixe a canônica automática fazer o trabalho.