stanley89/pirati.cz

Homepage Pirátské strany

pirati.cz

Lokální spuštění

Instalacee na Fedora 25+: dnf install cmake gcc npm ruby ruby-devel rubygem-jekyll rubygem-bundler rubygem-nokogiri libffi zlib

Instalace Ubuntu 16.04 LTS (funguje též pro ubuntu podsystém ve Windows 10):

sudo apt-get install ruby2.3-dev gcc make libghc-zlib-dev libffi-dev npm
gem install rubygems-update
gem install jekyll bundler
sudo npm install -g bower
sudo npm install --global gulp-cli

Společné

Přejděte do složky s vyklonovaným projektem:

npm install                             # Nainstaluje gulp apod
bundle install                          # Nainstaluje lokálně potřebné gemy (např. jekyll, jekyll-paginate apod)
./node_modules/bower/bin/bower install  # Nainstaluje front-endové knihovny (Foundation, Jquery, ...)
./node_modules/gulp/bin/gulp.js         # Minifikuje JS 

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

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

V případě puštění v kontejneru při selhání konverze scss zkontrolujte nastavení locale. Mělo by být nastaveno utf-8. Je-li POSIX, doinstalujte např. balíček: sudo apt-get install locales

A potom dpkg-reconfigure locales - zde vyberte třeba 92. cs_CZ.UTF-8 UTF-8
A vložte do ~/.bashrc

export LC_ALL=cs_CZ.UTF-8
export LANG=cs_CZ.UTF-8
export LANGUAGE=cs_CZ.UTF-8

Popřípadě můžeme spustit jen: bundle exec 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 hlavičkou v příslušné složce, na webu jsou použity 4:

• posts (články), foto 1300x744
• people (lidé), foto 165x220
• 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 definovány v bower.json a produkční soubor je tvořen gulpem.

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