Installer l’environnement :

Ruby

sudo apt-get install ruby-full

Jekyll

gem install jekyll

Créer le premier site :

Se placer dans le dossier où le créer

cd Documents/jekyll/

Créer le site "CV" :

jekyll new CV
cd CV

Lancer le serveur intégré pour voir le résultat (et tous les changements grâce à -w)

jekyll serve -w

Résultat visible à cette adresse

http://127.0.0.1:4000/

Le fichier _config contient la configuration générale du blog, le dossier _layout contient les templates qui serviront à générer les pages. Le dossier _post contient les articles et le dossier _site contient le blog généré. C’est ce dernier dossier qu’il faudra placer sur votre serveur si vous souhaitez publier votre blog. (http://www.toam.fr/20-05-2013-guide-demarrage-jekyll/)

Versionner le site :

Installer git :

sudo apt-get install git-core

Créer le dépôt (dans le répertoire du site) :

git init
git config user.name "cybermonde.org"
git config user.email "webmaster@cybermonde.org"
git add .
git commit -m "Version initiale"

Installer l'éditeur Atom :

Télécharger :

https://atom.io/

Installer (via Logithèque ou autre)

Installer la documentation (pour la consulter hors connexion) :

gem install jekyll-docs

Nécessaire :

gem install jekyll-feed
gem install jekyll-redirect-from
gem install jemoji
gem install pygments.rb

Lancer :

jekyll docs

Pour éviter le conflit avec le port du serveur de test, vous lancerez dans le dossier du projet :

jekyll serve -w --port 4444

Votre projet sera visible à :

http://127.0.0.1:4444/

Et la documentation à :

http://127.0.0.1:4000/

Configuration globale :

Quelques paramètres peuvent être ajustés dans _config.yml pour l'ensemble des posts, ici l'auteur :

defaults:
  -
    scope:
      path: ""
      type: "posts"
    values:
      author: "cybermonde.org"

En savoir plus : https://jekyllrb.com/docs/configuration/

Template :

Pour construire les pages, il faudra utiliser un langage de template, Liquid, dont voici les commandes :
https://github.com/Shopify/liquid/wiki/Liquid-for-Designers

Aller plus loin :