Přeskočit na obsah

npm run verify:jsonld — JSON-LD postaveného webu

JSON-LD postaveného webu: Post-build kontrola strukturovaných dat emitovaných šablonou. npm skript, kontrola výstupů.

npm skript kontrola výstupů shodí běh pipeline: build

Volání

npm run verify:jsonld

Spustí node scripts/dossier/verify-jsonld.mjs (čteno z package.json při buildu)

Zdroj: scripts/dossier/verify-jsonld.mjs

Post-build kontrola strukturovaných dat emitovaných šablonou. Pět úloh: platnost JSON, zákaz markupu soudícího pravdivost, pokrytí a tvar uzlů, identita citací a pokrytí stránek.

Kdy ho spustit

Až po zola build. Volitelně nad libovolným postaveným stromem přes --dir.

Co shodí běh

  • Blok application/ld+json, který neparsuje jako JSON.
  • Jakýkoli ClaimReview, Rating/AggregateRating nebo klíč reviewRating/ratingValue — mechanická podoba redakčních pravidel 3 a 7: statusy webu popisují zdrojování, ne rozsouzenou pravdu.
  • Stránka tvrzení bez Claim uzlu s neprázdným appearance; hlavní stránka entitního dossieru bez právě jednoho Person uzlu; Person na agregátním dossieru; chybějící povinná pole podle @type.
  • appearance tvrzení, které neodpovídá přesně zdrojům deklarovaným tímtéž tvrzením uvnitř jeho vlastního dossieru — cizí záznam je chyba.
  • Postavená stránka bez jediného JSON-LD bloku (jedinou výjimkou jsou alias přesměrování).

Co je potřeba vědět

  • Úloha 5 slibuje, že každá stránka je strojově čitelná JAKO STRÁNKA — ne že každý typ záznamu má uzel popisující ZÁZNAM. Strojová podoba kauz, mezer, vztahů a entit žije v /data/*.jsonld exportech.
  • Úloha 4 vznikla proto, že úloha 3 nestačila: tvrzení citující SRC-01 kdysi posbíralo SRC-01 všech dossierů — 17 606 vložených citací, z toho jen 1 114 vlastních.

Vstupy a výstupy

Čte

  • public/**/*.html
  • data/dossiers/** (compiled model)

Popis vychází z hlavičkového komentáře zdrojového souboru. Volání, zařazení do pipeline i členství v pre-commit hooku se dopočítávají při každém buildu ze samotného repozitáře.