Co potřebujete: Node (verzi drží .tool-versions) a Zola. Žádnou databázi, žádný backend.
Celý postup
git clone <repozitář>
cd vomaste.cz
npm ci # nainstaluje závislosti a zapojí git hooky
npm run dev # web na http://127.0.0.1:1111
# … úprava …
npm run data:validate # rychlá kontrola kanonických dat
npm run data:build # přegeneruje modely a adaptéry
npm run build # KANONICKÁ BRÁNA — musí skončit s kódem 0
npm run test:e2e # prohlížečové testy nad hotovým webem (volitelně)
Pak větev, commit a pull request. Automatizace pustí tutéž bránu; při úspěchu se web nasazuje z hlavní větve.
Úplný katalog příkazů je generovaný z repozitáře: /dokumentace/prikazy/.
Bezpečné první úkoly
- oprava překlepu v ručně psané stránce,
- rozbitý vnitřní odkaz,
- zlepšení hlášky validátoru, aby říkala i jak to opravit,
- doplnění testu k existujícímu validátoru,
- přístupnostní vylepšení nalezené prohlížečovými testy,
- nesoulad mezi dokumentací a skutečným chováním.
Dvě věci, které překvapí
Generované soubory se needitují. Stránky dossierů a entit jsou adaptéry; ruční změna se při dalším sestavení tiše přepíše. Zdroj je data/dossiers/**.
Commit na hlavní větvi nasazuje. Mezi commitem a produkcí prakticky není pauza — potvrzení se získává před commitem.