Přechod formátu kurzu na KodimCMS verzi 1.0 lze provést ve třech krocích:
- Spustit tento transformační script
- Ručně nasadit novou ikonu kurzu
- Upravit adresu webhooku v GitHubu
Většinu nutné práce provede automaticky tato utilita. Je potřeba mít nainstalovaný NodeJS verze alespoň 16. Pak stačí ve složce kurzu spustit
npx kodim-upgrade
nebo kdekoliv jinde
npx kodim-upgrade <cesta ke slozce>
Skript provede následující změny:
- Cesty ke cvičením nově používají běžná lomítka. Místo
cvlekce>cviceni
se nyní píšecvlekce/cviceni
. - Řešení příkladů se místo
---solution
uzavírá do bloku:::solution :::
Ikona kurzu má teď předepsaný formát a barvu, aby zapadla do designu webu. Ikona musí být SVG soubor umístěný ve složce assets
v kořenové složce kurzu. V hlavním entry.yml
musí být uvedena celá cesta k ikoně, tedy například
image: assets/ikona.svg
Pokud zatím nemáte ikonu přímo pro kurz, můžete použít některou z ikon v tomto repozitáři ve složce icons
:
python.svg
- hodí se pro kurzy ohledně Pythonuconstruction.svg
- hodí se pro kurzy, které jsou ve výstavbě, nebo zatím nevíte, co tam dát za ikonu.
Adresa webhooku pro update při změně je nyní https://kodim.cz/cms/hooks/reindex
. Má nepovinný query parametr branch
, který je defaultně nastavený na hodnotu main
. Pokud tedy máte hlavní větev například pojmenovanou master
, je potřeba adresu upravit na https://kodim.cz/cms/hooks/reindex?branch=master
.