Statický obsah (stránky pod odkazem Informace) je psaný v Markdownu a je v adresáři /content/pages.

Stránky můžete editovat přímo ve webovém prohlížeči na GitHubu. Otevřete si příslušný soubor a pomocí tužky v toolbaru se přepnete do režimu editace. Pomocí Preview changes se můžete podívat, jak přibližně bude obsah vypadat – ale zobrazuje se to v rámci GitHubu, takže nebudou fungovat např. vložené obrázky.

Změny připravíte k publikování pomocí Commit changes. Vyplňte prosím alespoň první řádek s popisem změn (ten s placeholderem Update <jméno souboru>). Dole zvolte variantu Create a new branch for this commit and start a pull request. Tím se změny nepropíšou hned na ostrý web, ale místo toho se vytvoří dočasná adresa (viz níže), na které je možné změny zkontrolovat. Teprve pak někdo s právem merge propíše změny do hlavního repository a tím se publíkují na web.

Pokud u Commit changes ponecháte výchozí volbu Commit directly to the master branch, změny se okamžitě propagují na ostrý web. Publikování trvá cca 30 sekund. Že byla změna publikována lze ověřit v seznamu změn. Poslední změna je úplně nahoře a kliknutím na její popis se dostanete na stránku s detailem změny. Pokud už proběhlo publikování, bude tam zpráva od robota now, která vypadá takhle nějak:

now [bot] replied 1 minute ago

Successfully deployed to following URLs:

• https://damerouskycz-60idy71ig.now.sh
• https://damerouskycz.ceskodigital.now.sh
• https://damerouskycz-git-master.ceskodigital.now.sh

Pokud by tam byla od robota now chybová zpráva, je problém s publikováním webu, dejte vědět na Slacku v kanálu #p-damerousky.

Předpokládá se, že máte základní zkušenosti s Gitem a GitHubem a že máte účet na GitHubu. Repository se zdroji webu je zde: GitHub.com/cesko-digital/damerousky.cz. Změny se do repository promítají pomocí pul requestů – buď z branche (viz Creating a pull request), pokud máte právo zápisu do hlavního repository, nebo z vašeho forku (viz Creating a pull request from a fork), pokud právo zápisu do hlavního repository nemáte.

Dočasná adresa s náhledem nové verze webu se objeví v komentáři ke commitu od robota now. Seznam otevřených pull requestů je zde: Pull requests. Komentář od robota bude vypadat takhle nějak:

now [bot] replied 1 minute ago

Successfully deployed to following URLs:

• https://damerouskycz-60idy71ig.now.sh
• https://damerouskycz.ceskodigital.now.sh
• https://damerouskycz-git-master.ceskodigital.now.sh

První adresa (s kódem skládajícím se z číslic a písmen) je dočasná adresa webu, na které je možné novou verzi otestovat.

Web používá generátor statických webů Gridsome založený na Vue. Pro provoz webu se používá Zeit.

1. Je potřeba mít nainstalováno Node.js.
2. Nainstalovat Gridsome
3. Naklonovat rpository z GitHubu git clone [email protected]:cesko-digital/damerousky.cz.git
4. Přejít do adresáře se zdrojáky webu cd damerousky.cz
5. Spustit lokální server gridsome develop. Lokální web poběží na http://localhost:8080
6. Happy coding 🎉🙌