npm run data:metrics — Navigační metriky

Navigační metriky: Spočítá pojmenované agregované metriky z registru scripts/data/navigation-metrics.registry.mjs a zapíše deterministický manifest, ze kterého šablony berou počty do navigačních odznaků.. npm skript, generování.

npm skript generování pipeline: build pipeline: dev

Volání

npm run data:metrics

Spustí node scripts/data/build-navigation-metrics.mjs (čteno z package.json při buildu)

Zdroj: scripts/data/build-navigation-metrics.mjs

Spočítá pojmenované agregované metriky z registru scripts/data/navigation-metrics.registry.mjs a zapíše deterministický manifest, ze kterého šablony berou počty do navigačních odznaků.

Kdy ho spustit

V pipeline až PO build:jsonld-exports — metriky čtou kanonické exporty, které vyrábí právě ten krok.

Co vynucuje

Nic — tenhle příkaz reportuje nebo generuje, ale sám o sobě nic neshazuje. Co selže při chybě, hlídají brány, které za ním v pipeline běží.

Co je potřeba vědět

Počty patří do serverem vykresleného HTML, ne do JavaScriptu: číslo dopočítané po DOMContentLoaded by problikávalo, posouvalo layout a pro crawler by neexistovalo.
Manifest se zapisuje atomicky přes dočasný soubor a rename, aby zabitý build nenechal poloviční soubor, který by další validátor četl jako platný.

Vstupy a výstupy

Čte

scripts/data/navigation-metrics.registry.mjs
static/data/**

Zapisuje

data/generated/navigation-metrics.json

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.