Corrigir erros de position no schema de breadcrumb

Por que o erro de position aparece

Cada ListItem de um BreadcrumbList precisa de uma position, um número inteiro que indica o lugar dele na trilha. O erro geralmente significa uma destas situações:

• A chave position está ausente em um ou mais itens.
• As posições foram escritas como texto ou deixadas vazias.
• Os números se repetem, como dois itens na posição 2.
• Os números pulam, como 1, 2, 4.
• Etapas foram acrescentadas ao markup à mão ou por um template e o contador não foi atualizado.

O que a ferramenta faz de diferente

O gerador nunca pede uma posição. Ele lê as suas linhas de cima para baixo e atribui 1, 2, 3 e assim por diante às linhas que têm nome e URL. Uma linha ignorada não deixa um buraco, então a numeração é sempre consecutiva.

Exemplo de lista com erro e de lista refeita

Entrada com erro para um validador: itens nas posições 1, 2 e 4, com o terceiro faltando.

Refeita com a ferramenta:

Início | https://example.com/
Documentação | https://example.com/docs/
Configuração | https://example.com/docs/configuracao/

Posições na saída: 1, 2, 3.

Depois de substituir o markup

1. Remova o bloco script antigo por completo, para que a página não carregue duas listas em conflito.
2. Cole o novo bloco.
3. Teste a URL publicada novamente.

Se o erro continuar

Procure um segundo BreadcrumbList vindo de um tema, de um plugin ou de um template que você esqueceu. A ferramenta só cria o bloco que você copia dela, então um resíduo gerado por outra coisa precisa ser removido na origem. Confirme também que todas as URLs estão completas e que nenhum nome está vazio.

Autoverificação rápida de qualquer markup de breadcrumb

Antes de testar de novo, examine o bloco em busca de quatro coisas: todo ListItem tem position, as posições seguem 1, 2, 3 sem repetição, todo ListItem tem name e todo ListItem tem URL. Se as quatro condições forem atendidas, o erro de position não deve mais aparecer. Gerar o bloco a partir de uma lista simples é a forma mais rápida de garantir isso, porque um erro de numeração não pode mais ser digitado à mão.