jekyll

Générateur de sites web statique. Le plus souvent utilisé en combinaison avec GitHub#hébergement-pages. Voir aussi ruby, bundler...

Site officiel : https://jekyllrb.com/

Introduction

Doc officielle :

• http://jekyllrb.com/docs/quickstart/
• https://jekyllrb.com/docs/usage/
• https://jekyllrb.com/docs/structure/
• https://jekyllrb.com/docs/templates/
• https://jekyllrb.com/docs/configuration/
• https://jekyllrb.com/docs/migrations/
• https://jekyllrb.com/docs/permalinks/

Intro (pas super claire) par GitHub pour hébergement dans "pages" :

• "Using Jekyll with Pages" https://help.github.com/articles/using-jekyll-with-pages/ Tuto complémentaire ++
• https://www.smashingmagazine.com/2014/08/build-blog-jekyll-github-pages/

Installation

Utiliser directement la gemme de GitHub : https://github.com/github/pages-gem

• https://help.github.com/articles/using-jekyll-as-a-static-site-generator-with-github-pages/
• https://help.github.com/articles/setting-up-your-github-pages-site-locally-with-jekyll/
• https://help.github.com/articles/configuring-jekyll/
  • https://help.github.com/articles/repository-metadata-on-github-pages/
• http://jekyllrb.com/docs/github-pages/

sudo apt-get install libgmp3-dev
rvm install ruby-2.3.0
/bin/bash --login
rvm use ruby-2.3.0
gem install bundler --no-rdoc --no-ri
git clone xyz...

1ère install :

git checkout gh-pages
echo "source 'https://rubygems.org'" > Gemfile
echo "gem 'github-pages', group: :jekyll_plugins" >> Gemfile

Puis dans tous les cas :

bundle install
// not mandatory on GitHub, will do it itself
// but needed to preview site locally
bundle exec jekyll new . --force
bundle exec jekyll serve --host 0.0.0.0 --baseurl '' --incremental
rm -rf _site && bundle exec jekyll serve --host 0.0.0.0 --baseurl '' --incremental --verbose

then http://localhost:4000

plugins

• https://help.github.com/articles/configuring-jekyll-plugins/
• pligins available on GitHub pages https://pages.github.com/versions/

Dans config.xml:

gems:
   - jekyll-mentions
   - jemoji
   - jekyll-redirect-from
   - jekyll-sitemap # Create a sitemap using the official Jekyll sitemap gem
   - jekyll-feed # Create an Atom feed using the official Jekyll feed gem
   - jekyll-seo-tag # Search engine optimization

Keeping up to date:

bundle update

Doc officielle d'installation : https://jekyllrb.com/docs/installation/

Utilisation

dev

bundle exec jekyll build
bundle exec jekyll build --watch
bundle exec jekyll serve
bundle exec jekyll serve --detach
bundle exec jekyll serve --no-watch
ps aux | grep jekyll

404

https://help.github.com/categories/customizing-github-pages/

thèmes

http://jekyllthemes.org/

Bons thèmes :

• dev https://staticus.narro.co/
• ++ https://github.com/yous/whiteglass
• https://github.com/poole/hyde
• https://github.com/poole/lanyon
• https://github.com/mattvh/solar-theme-jekyll

Installer un thème :

• faire un diff...

 _includes
 _layouts

i18n

• https://github.com/untra/polyglot
• https://github.com/screeninteraction/jekyll-multiple-languages-plugin

Avancé

liquid

jekyll utilise un moteur de templating appelé "liquid" https://github.com/Shopify/liquid/wiki

• http://www.rubydoc.info/gems/liquid
• https://github.com/Shopify/liquid/wiki/Liquid-for-Programmers
• https://github.com/Shopify/liquid/wiki/Liquid-for-Designers

Problèmes rencontrés

• GitHub pages https://help.github.com/articles/troubleshooting-github-pages-builds/
• tout +++ https://help.github.com/categories/customizing-github-pages/