Návod na práci s webem

Nejprve je nutné se zaregistrovat na https://github.com/ a požádát Máru o přístup do projektu https://github.com/czechultimate/web.

Je dobré vědět, že všechny změny jsou archivované. Takže pokud se něco nepovede, je vždycky cesta zpátky :)

Většina stránek je buď přímo v HTML nebo v markdown formátu (ten si můžete zkoušet zde).

Kdo umí aspoň trochu s gitem, může si jednoduše repozitář stáhnout k sobě do počítače a tam soubory upravovat trochu jednodušeji než tady na webu. Na Windows, Mac i Linux existuje dostatek tůlů pro práci s gitem.

Obecně

Jak tvořit obsah

• Předem předpokládám, že budeme psát bez pravopisných a stylistických chyb! I sebelepší web/design/foto to pak už nezachrání.
• Nadpisy článků pišme zajímavě. Tak aby uživatel měl důvod kliknout a číst dál. Saša dával na školení s médii příklad, že když proběhne valná hromada, tak nemáme psát titulek typu "Proběhla valná hromada 2020", ale spíš vypíchnout nějakou zajímavou informaci. Například "Končí dlouholetý předseda".
• Zvažme použití letopočtu v titulku článku. Někdy stačí datum zveřejnění článku, aby každý pochopil kontext.

Jak vytvořit nový soubor

Jak editovat již existující soubor

Jak potvrdit změny

POZOR! Pro aktivaci změn je nutné pod editací kliknout na tlačítko Commit changes a mít zaškrtnutou první možnost. Změny na webu se pak projeví maximálně do několika minut.

Když se web po změně nepodaří sestavit (typicky kvůli chybě v hlavičce článku), zůstane na webu předchozí verze a chybu uvidíte v záložce Actions (červený křížek). Křížek u commitu, po kterém hned přišel další commit, nevadí. Rozhoduje výsledek toho posledního.

Kam nahrávat obrázky/soubory

Všechny obrázky ke článkům se nahrávají do assets/img/posts/year. Ve složce assets/img/posts/uzitecne jsou obrázky, které se můžou občas hodit k nekterým článkům, pokud nebudeme mít k dispozici lepší foto. Dokumenty se nahrávají do assets/files.

Nahrávejte obrázky s minimální šířkou 550px! Větší fotky není potřeba zmenšovat ručně. Obrázky přes 2000 px nebo 1 MB se do minuty po nahrání zmenší automaticky a zároveň se z nich odstraní metadata včetně GPS polohy. V historii se to objeví jako commit „Optimize uploaded images“ od github-actions.

• Názvy obrázků pište bez diakritiky a mezer (ssl-finale-2026.jpg, ne SŠL finále.jpg).
• Když obrázek měníte, nahrajte ho pod novým názvem a ten dejte do článku. Web drží soubory 10 minut v cache, takže přepsaný obrázek se ještě chvíli může ukazovat ve staré verzi.

Jak odkazovat na jiné stránky webu

Vždycky můžete použít celou adresu, kterou zkopírujete z prohlížeče, ale lepší je použít pouze část adresy. Link pak bude fungovat i když web změní doménu nebo se různě bude v budoucnu měnit.

Takhle NE:

[Jak začít hrát](https://www.czechultimate.cz/jak-zacit)

Takhle ANO:

[Jak začít hrát](/jak-zacit)

Lomítko na začátku je důležité. Bez něj (jak-zacit) odkaz funguje jen na hlavních stránkách webu, z článků vede na neexistující adresu.

Linky mimo web samozřejmě musíte uvádět celé, včetně https na začátku.

Prakticky

Jak přidat článek

Ve složce _posts/2026 (analogicky pro jiný rok) najdete všechny články. Stačí vytvořit nový soubor ve formátu YYYY-MM-DD-volitelny-popisek.md. Datum v názvu je datum článku, zobrazí se u něj a je součástí jeho adresy. Článek s budoucím datem se na webu objeví automaticky brzy ráno v den svého data, protože web se každou noc znovu sestaví. Nezapomeňte, že obsah se píše pomocí markdownu.

Pár pravidel:

• Název souboru pište bez diakritiky a mezer, ve tvaru YYYY-MM-DD-nazev.md (např. 2026-06-23-mcr-mixed.md).
• Složku pro nový rok vytvoříte ve webovém rozhraní tak, že ve složce _posts napíšete do pole s názvem souboru 2027/2027-01-15-nazev.md. Lomítko složku založí.
• Titulek, který obsahuje dvojtečku, musí být v uvozovkách: title: "Beach MČR: výsledky". Jinak se web nesestaví.
• Tagy pište jako seznam v hranatých závorkách: tags: [turnaje, ssl]. Články s tagem ssl nebo reprezentace se ukážou v boxu Související na stránce Středoškolské ligy, resp. Reprezentace.

Hned na prvním řádku souboru musí začínat speciální struktura, která nastavuje některá metadata článku. Například kategorii nebo tagy. Povinný je layout (vždy post) a title. Doporučuju uvést autora a vložit cestu k úvodnímu obrázku (obrázky k článkům nahrávejte do assets/img/posts/rok). Úvodní obrázek se použije i jako náhled při sdílení odkazu na sociálních sítích.

---
layout: post
category: rozvoj
tags: [ucitele, skoleni]
title: Vzdělávání trenérů v roce 2026
image: assets/img/posts/2026/repre_team.jpg
author: Jan Novák
---

Obsah článku...

** Nezapomeňte po změně zkontrolovat, zda se článek zobrazuje na webu tak, jak jste chtěli. Často se stane, že obrázek je příliš malý a nevyplňuje celý prostor stránky. Nebo nesedí úrovně nadpisů – to je obzvlášť důelžité pro dobře napasaný text.**

Nakonec se zamysleme, zda by nebylo vhodné článek sdílet na sociálních sítích.

Jak upravit konkrétní stránku na webu

Většina stránek je ve složce _includes/content. Všechny stránky se editují v markdownu.

Jak přidat soubor ke stažení, odkaz nebo kontakt na stránku

V souboru _data/documents.yml najdete strukturu, který mapuje cesty k souborům. První část se věnuje dokumentům na zvláštní stránce. Druhá část zobrazuje soubory na jednotlivých stránkách.

Do kolonky link můžete uvést odkaz nebo cestu k souboru.

Odkazy a kontakty se podobně vkládají sem: _data/links.yml, resp. _data/contacts.yml.

Jak přidat/editovat seznam oddílů

K tomu slouží soubor _data/oddily.yml. Web přidávejte bez http a www, pouze doménu. Facebook naopak pouze cestu za prvním lomítkem. Např. pro https://www.facebook.com/chlupatazaba uložíte pouze chlupatazaba. Příklad:

web: frisbee.cz/chlupata-zaba
fb: chlupatazaba

Development

Docs:

• https://jekyllrb.com/docs/
• https://learn.cloudcannon.com/jekyll-cheat-sheet/

Prerequisites

Install Docker (with Docker Compose).

How to run

Run docker compose up and open http://localhost:4000 in your favourite web browser.

How to build

Only if you need that. It's not necessary to run it.

docker run --rm -it --volume="$PWD:/srv/jekyll" --env JEKYLL_ENV=production jekyll/jekyll:pages jekyll build

How to add dependency

GitHub Pages builds the site with its own fixed set of gems, so only plugins supported by GitHub Pages work. Add the plugin to plugins in _config.yml and restart docker compose up.

Fomantic UI

The site uses Fomantic UI with the default theme and Open Sans hosted locally. Only the build output is committed in assets/fomantic/. The theme settings live in _fomantic/ (site/globals/site.variables for fonts, semantic.json for the list of components).

To rebuild after changing the settings or the version in _fomantic/build.sh, run (requires Docker):

./_fomantic/build.sh