Zrcadlení statického webu ztratí změnu ve skriptu, který má každá stránka ve vlastní kopii
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Nová stránka má po nasazení při načtení bílé menu na světlém pozadí, dokud návštěvník nezačne rolovat. V předloze je hlavička čitelná hned. Kontroly parity jsou zelené a chybu nahlásí až autor předlohy s dvojicí snímků.
Root cause
Sekce “Root cause”Předloha je statický build, takže „společný“ skript hlavičky je fyzicky vložený do každého HTML souboru. Skript obsahuje seznam cest, na kterých má být hlavička plná od načtení:
var solidPaths = ["/a", "/b", "/c"];Autor přidal novou cestu jen do kopie skriptu na té jedné nové stránce; ostatní stránky mají seznam starý. V jeho statické kopii to stačí, protože každá stránka čte svůj vlastní skript.
Převod ale společné části držel v jedné sdílené komponentě s ručně udržovaným seznamem cest a ze stránek přebíral jen obsah. Úprava v jedné kopii se tak nikam nepropsala. Navíc:
- generátor uměl rozpoznat jen jiný zápis téhož záměru (
alwaysSolid = true), změnu pole neviděl, - paritní skript celý skript hlavičky přeskakoval kvůli starší záměrné odchylce, takže rozdíl nehlásil.
Fix
Sekce “Fix”Pravidlo se už neudržuje ručně. Generátor pro každou stránku přečte její kopii skriptu, vyhodnotí pravidlo pro adresu té stránky a výsledek uloží do dat stránky; šablona ho vypíše jako atribut a skript se řídí atributem:
<header id="site-header" data-solid="true">Paritní kontrola stejné pravidlo vyhodnotí z předlohy i z buildu a porovná výsledek pro všechny stránky. Plošná výjimka pro „skript hlavičky“ zůstala jen pro samotný text skriptu, ne pro jeho účinek.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: u statické předlohy spočítat otisk každého „společného“ bloku (skript hlavičky, patička, lišta) přes všechny stránky. Víc než jeden otisk znamená, že autor upravil jen některé kopie, a je třeba zjistit proč.
- Anti-pattern: výjimka v paritě ve tvaru „tento skript neporovnávej“. Skryje i budoucí změny, které s původním důvodem výjimky nesouvisí.
- Lepší přístup: porovnávat účinek místo textu (jaký stav má hlavička na dané stránce) a stavové přepínače vzhledu odvozovat z dat předlohy, ne ze seznamu ve vlastním kódu.
Sister bugs / související
Sekce “Sister bugs / související”- Regenerace Tailwindu oživí třídy, které byly ve zmrazeném CSS mrtvé (stejná kategorie): druhý případ, kdy textová a strukturální parita nestačila.
- Hromadná náhrada překladových párů ve sdílených komponentách (ai-agents): opačný směr téže chyby, změna určená jedné jazykové verzi se propsala všem.