パンくずリストSchemaのpositionエラーを修正する

1 行につき 1 項目: 名前 | URL

テストツールで、パンくずのマークアップにpositionフィールドの値が必要だと表示されることがあります。最も簡単な対処は、すべてのListItemに連続したpositionを付けてリストを作り直すことです。下に経路を入力すれば、番号はジェネレーターが付けます。

正しい位置でリストを作り直す

  1. 1

    古いマークアップから階層を写す

    問題のあるブロックから各名前とURLを取り出し、順番どおりに「名前 | URL」の行として書きます。

  2. 2

    不完全な行を取り除く

    すべての行に名前とURLの両方があることを確認します。足りない行はツールが無視します。

  3. 3

    生成する

    結果画面へ進みます。位置は1から始まり、階層ごとに1ずつ増えます。

  4. 4

    古いブロックを置き換える

    問題のあるscriptをページから削除し、新しいブロックを貼り付けて、もう一度テストします。

positionエラーが出る理由

BreadcrumbListの各ListItemには、経路の中での位置を示す整数の position が必要です。エラーは、たいてい次のいずれかです。

  • 1つ以上の項目に position キーがない。
  • positionが文字列になっている、または空である。
  • 2つの項目が両方とも2のように、番号が重複している。
  • 1、2、4のように番号が飛んでいる。
  • 手作業やテンプレートで階層を足したときに、カウンターを更新していない。

ツールの違い

ジェネレーターは位置の入力を求めません。行を上から順に読み、名前とURLの両方がある行に1、2、3と割り当てます。飛ばした行があっても穴は空かず、番号は常に連続します。

壊れたリストと作り直したリストの例

バリデーターに渡した問題のある入力:位置が1、2、4で、3が欠けている項目。

ツールで作り直す入力:

ホーム | https://example.com/
ドキュメント | https://example.com/docs/
セットアップ | https://example.com/docs/setup/

出力の位置は1、2、3です。

マークアップを置き換えた後に

  1. 競合する2つのリストがページに残らないよう、古いscriptブロックを完全に削除します。
  2. 新しいブロックを貼り付けます。
  3. 公開中のURLをもう一度テストします。

エラーが残る場合

テーマ、プラグイン、またはテンプレートが出している、忘れていた2つ目のBreadcrumbListがないか確認してください。このツールが作るのはコピーしたブロックだけなので、ほかの仕組みが生成した残りは、その元で取り除く必要があります。また、すべてのURLが完全で、名前が空でないことも確認してください。

どのパンくずマークアップにも使える簡単な自己点検

再テストの前に、ブロックで次の4点を確認します。すべてのListItemにpositionがある。positionが重複なく1、2、3と並んでいる。すべてのListItemにnameがある。すべてのListItemにURLがある。4点がそろえば、positionのエラーは出なくなるはずです。普通の一覧からブロックを生成するのが最も確実です。番号の間違いを手で入力する余地がなくなるからです。

よくある質問

標準の並びは1から始まり、このツールもそのように書き出します。

名前とURLの両方がない行は飛ばされます。足りない側を、パイプ記号の前または後に加えてください。

いいえ。入力した経路での階層の順序を示すだけです。

安全ではありません。バリデーターはこのフィールドを必須として扱うので、必ず含めてください。ツールは自動で付けます。

関連ツール

このツールは他の言語でも利用できます

使い方ガイドと活用例