tangero / praha12.pirati.cz

praha12.pirati.cz

Naklonovaný web pirati.cz.

Editujte branch gh-pages, jejíž obsah se po commitu automaticky přegeneruje na github.io. Po zkontrolování, že vše funguje, udělejte pull request do branch master.

Pokud byste z tohoto našeho chtěli vyjít pro tvorbu webu svého místního sdružení, změňte následující:

• v souboru _config.yml změňte hodnoty v horní části (title, description, url)
• v souboru _data/links.yaml změňte hodnoty proměnných, aby se místo pražských věcí zobrazovaly vaše místní
• obrázek assets/img/header/background.jpg změňte na nějaký váš lokální
• v adresáři _people odstraňte naše lidi a místo toho založte vlastní
• v adresáři assets/img/people dejte fotky vašich lidí. Pokud nemáte fotku, používejte assets/img/people/ppp.jpg
• v adresáři _posts odstraňte naše blogové příspěvky a dávejte vlastní
• v adresáři assets/img/posts odstraňte naše fotky pro blogové příspěvky a dávejte vlastní
• smažte adresáře _vystavba, vystavba a assets/img/vystavba a odstraňte tuto sekci i z _data/main-menu.yml a _config.yml

Jekyll se dá rozběhat nejen na Linuxu, jak se píše níže, ale docela snadno i na macOS a s trochou úsilí i na Windows 10, kde doporučujeme řídit se oficiálním návodem a instalovat pomocí RubyInstalleru.

Níže následuje obsah copypastovaný z centrální verze.

Lokální spuštění

Instalace na Fedora 25: dnf install rubygem-jekyll

Instalace Ubuntu 16.04:

sudo apt-get install ruby-dev gcc make libghc-zlib-dev
gem install rubygems-update
gem install jekyll bundler
bundle

Repozitář můžeme naklonovat do jakékoliv složky (nemusí být ve /var/www/).

jekyll serve, což stránku zkompiluje, spustí a ještě je stránka přístupná skrz localhost: http://127.0.0.1:4000

Popřípadě můžeme spustit jen: jekyll build, což do složky _site připraví kompletní web (ten můžeme otevřít z prohlíže pomocí klavesové zkratky ctrl+o).

Struktura

Samotné stránky jsou v markdownu nebo v html (složitější struktura, např. vícesloupců apod)

Kolekce jsou markdown soubory s yaml frontend v přísliušné složce, na webu jsou použity 4:

• posts (články)
• people (lidé)
• program
• teams (týmy)

Některé údaje jsou uvedeny v složce _data. Jsou zde ve formátu yaml nebo json.

CSS je ve složce _sass a je automaticky kompilováno a minifikován do jednoho souboru main.css.

JavaScript je ve složce _include/js. Knihovny jsou linkovány skrze CDN v minifikované podobě. Další JS je v spojen do jednoho scriptu bez minifikace (zatím).

Jekyll má velmi podrobnou dokumentaci. A při vývoji též doporučuji cheat sheet