Gerenciamento de 404

Quando seu site estático tem links quebrados, o Chinaski pode registrar cada ocorrência de 404, mostrar os caminhos mais acessados e transformar esses caminhos em redirecionamentos com alguns cliques.

Onde você encontra os 404s

Abra Saúde na área administrativa e vá para a aba 404s. Ela mostra os 500 principais caminhos de 404 registrados, classificados por contagem de acessos, de modo que os links quebrados mais movimentados fiquem no topo.

Para cada caminho você pode ver:

o caminho que deu 404
quantas vezes foi acessado
a última vez que foi visto
a URL de referência, se conhecida

Você pode buscar caminhos por palavra-chave e filtrar por período: todo o tempo, últimos 7, 30 ou 90 dias. As entradas do log de 404 são podadas automaticamente após 90 dias, e você pode limpar o log inteiro com o botão Limpar Log (será pedido que você confirme).

Como os 404s são registrados

O Chinaski não captura 404s por si mesmo: o processador de access-log do seu host estático ou servidor web os registra enviando cada falha à API de log de 404 do Chinaski com uma chave de API que tenha permissão de escrita. Os caminhos são registrados com sua URL de referência e user agent, e visitas repetidas ao mesmo caminho são contadas como uma entrada com contagem de acessos incrementada.

Criando redirecionamentos a partir de 404s

Duas formas de agir sobre a lista:

Um por vez: cada linha tem um link Criar redirecionamento. O caminho antigo é pré-preenchido com os prefixos de idioma e blog já removidos, na tela habitual de criação de redirecionamento.
Em massa: marque as caixas de seleção de vários caminhos, e você recebe uma tabela onde, para cada caminho, preenche o slug de destino, o idioma (padrão “en”) e se o redirecionamento é de página ou post. Ativo vem marcado por padrão. Um redirecionamento que aponta para si mesmo é rejeitado.

Como os redirecionamentos se comportam

Os redirecionamentos são por idioma: cada redirecionamento se aplica a caminhos antigos de um único idioma.
Um redirecionamento só entra em vigor quando o caminho antigo não é uma página ou post publicado atualmente. Se o slug antigo ainda está vivo, o redirecionamento é pulado; o Chinaski avisa você disso ao criá-lo.
Se o destino não existe como conteúdo ativo nem como alvo de outro redirecionamento, você recebe um aviso.
Redirecionamentos não podem apontar para si mesmos, e loops entre redirecionamentos são recusados. Se o seu destino já está ele mesmo redirecionado, a cadeia é seguida até seu verdadeiro fim e seu redirecionamento é criado apontando diretamente para lá (“cadeia colapsada”).
Na tela de criação de redirecionamento há um botão Testar Redirecionamento: preencha o slug antigo, o slug novo e o idioma para pré-visualizar a cadeia de redirecionamentos, se ela forma loop, onde ela finalmente aterrissa e se o destino existe.

Redirecionamentos com padrão

A opção Redirecionamento com Padrão permite que um redirecionamento cubra muitos caminhos: use * no final do slug antigo para corresponder a qualquer sufixo, e $1 no slug novo para substituí-lo. Por exemplo, antigo products/* → novo solutions/$1 envia products/amplifier para solutions/amplifier.

Redirecionamentos com padrão são servidos como páginas HTML de redirecionamento (meta-refresh); eles não são incluídos na configuração de redirecionamentos gerada para o servidor, onde redirecionamentos simples usam códigos HTTP 301, 302 ou 307. O código HTTP que você escolhe se aplica apenas a essa configuração de servidor; as páginas de fallback HTML que vão com a saída estática sempre usam meta-refresh.

Gerenciando redirecionamentos em massa

Na página de Redirecionamentos você pode excluir, ativar ou desativar vários redirecionamentos de uma vez (essas ações acionam um build do site). Você também pode importá-los ou exportá-los como dados:

Exportar: baixa todos os redirecionamentos como redirects.json, ordenados por idioma e depois por slug antigo.
Importar: faz upload de um CSV com as colunas old_slug,new_slug,language,type,active,notes,is_pattern,http_code. Os arquivos são limitados a 4 MiB e 5.000 linhas por importação. O tipo tem página como padrão, ativo tem ligado como padrão, e o código HTTP tem 301 como padrão. Apenas letras minúsculas, dígitos e - são permitidos nos slugs (além de * para slugs de padrão antigos e $// para destinos); linhas inválidas são puladas em vez de falhar a importação inteira.

O que acontece quando o 404 vem de uma página ainda viva

Nada: se um caminho pertence a uma página ou post publicado, nenhum redirecionamento é gerado para ele, mesmo que apareça no log de 404.