Samedi 8 décembre 2018 (Modifié le Samedi 8 décembre 2018)

Jekyll sur Linux Debian 9 Stretch

Installer Jekyll, le générateur de site statique à partir de la source ou du standard sur le référentiel Debian 9 Stretch.
Versions de systèmes d’exploitation et de logiciels

  • Système d’exploitation: - Debian 9 Stretch
  • Logiciels: - jekyll 3.4.3 (source) ou jekyll 3.1.6 (dépôt Debian)

L’accès privilégié à votre système Debian est nécessaire pour installer les paquets Jekyll ainsi que tous les “gems” préalables.

  • # - nécessite que la commande donnée soit exécutée avec les privilèges root soit directement en tant qu’utilisateur root, soit par l’utilisation de la commande sudo
  • $ - commande donnée à exécuter en tant qu’utilisateur régulier non privilégié

Installation Jekyll

Dépôt Debian

C’est de loin le moyen le plus simple d’installer Jekyll sur votre système Linux. L’inconvénient est qu’en fonction de vos exigences, vous risquez de vous retrouver avec une version Jekyll stable mais désuète.

# apt install jekyll

Confirmez l’installation de jekyll en demandant son numéro de version:

$ jekyll -v
jekyll 3.1.6

Installation source

Exécutez la commande suivante pour installer le dernier Jekyll à l’aide de gems:

# apt install build-essential ruby-full
# gem install bundler minima jekyll-feed

Confirmez l’installation de jekyll en demandant son numéro de version:

$ jekyll -v
jekyll 3.4.3

Créer un nouveau projet

Nous sommes maintenant prêts à créer un nouveau projet. Choisissez n’importe quel nom de projet par ex. linuxconfig:

$ jekyll new linuxconfig

La commande ci-dessus a créé un répertoire appelé linuxconfig contenant une structure de base jekyll de votre nouvelle application.

$ cd linuxconfig/
$ ls
about.md  _config.yml  Gemfile  Gemfile.lock  index.md  _posts

Vous pouvez maintenant éditer le fichier de configuration principal _config.yml pour définir un nouveau nom pour votre site Web, ajouter une description et plus encore. Pour ajouter de nouveaux billets de blog, naviguez dans le répertoire _posts. Là, soit éditer le post d’exemple ou en créer un nouveau en copiant le post d’exemple original en lui donnant un nouveau nom tout en suivant le même format de nommage.
Voir le site Web du projet
Naviguez jusqu’ à un nouveau répertoire et lancez votre nouvelle application de projet. Remplacez l’adresse IP ci-dessous par votre adresse IP locale. Si vous n’accédez pas à votre site Web à distance, vous pouvez omettre complètement l’option hôte et votre site démarrera localement:

$ jekyll serve --host 10.1.1.125

Utilisez votre navigateur pour afficher l’URL suivante http://10.1.1.125:4000/ ou, si vous exécutez localement http://127.0.0.1:4000/.


Jekyll site statique

Installation

Exécutez la commande suivante pour installer le dernier Jekyll à l’aide de gems:

sudo apt install build-essential ruby-full
sudo gem install bundler minima jekyll-feed

Confirmez l’installation de jekyll en demandant son numéro de version:

$ jekyll -v
jekyll 3.6.2

Projet ‘static’

Créer un nouveau projet

$ jekyll new static
Running bundle install in /home/xo/static... 
  Bundler: The dependency tzinfo-data (>= 0) will be unused by any of the platforms Bundler is installing for. Bundler is installing for ruby but the dependency is only for x86-mingw32, x86-mswin32, x64-mingw32, java. To add those platforms to the bundle, run `bundle lock --add-platform x86-mingw32 x86-mswin32 x64-mingw32 java`.
  Bundler: Fetching gem metadata from https://rubygems.org/...........
  Bundler: Fetching gem metadata from https://rubygems.org/.
  Bundler: Resolving dependencies...
  Bundler: Using public_suffix 3.0.0
  Bundler: Using addressable 2.5.2
  Bundler: Using bundler 1.16.0
  Bundler: Using colorator 1.1.0
  Bundler: Using ffi 1.9.18
  Bundler: Using forwardable-extended 2.6.0
  Bundler: Using rb-fsevent 0.10.2
  Bundler: Using rb-inotify 0.9.10
  Bundler: Using sass-listen 4.0.0
  Bundler: Using sass 3.5.3
  Bundler: Using jekyll-sass-converter 1.5.0
  Bundler: Using listen 3.0.8
  Bundler: Using jekyll-watch 1.5.0
  Bundler: Using kramdown 1.15.0
  Bundler: Using liquid 4.0.0
  Bundler: Using mercenary 0.3.6
  Bundler: Using pathutil 0.16.0
  Bundler: Using rouge 2.2.1
  Bundler: Using safe_yaml 1.0.4
  Bundler: Using jekyll 3.6.2
  Bundler: Using jekyll-feed 0.9.2
  Bundler: Using minima 2.1.1
  Bundler: Bundle complete! 4 Gemfile dependencies, 22 gems now installed.
  Bundler: Use `bundle info [gemname]` to see where a bundled gem is installed.
New jekyll site installed in /home/xo/static. 

La commande ci-dessus a créé un répertoire appelé linuxconfig contenant une structure de base jekyll de votre nouvelle application.

$ cd static/

Structure /home/$USER/static/

.
|-- 404.html
|-- Gemfile
|-- Gemfile.lock
|-- _config.yml
|-- _posts
|   `-- 2017-11-08-welcome-to-jekyll.markdown
|-- about.md
`-- index.md

1 directory (_posts), 7 files

Vous pouvez maintenant éditer le fichier de configuration principal _config.yml pour définir un nouveau nom pour votre site Web, ajouter une description et plus encore. Pour ajouter de nouveaux billets de blog, naviguez dans le répertoire _posts. Là, soit éditer le post d’exemple ou en créer un nouveau en copiant le post d’exemple original en lui donnant un nouveau nom tout en suivant le même format de nommage.
Voir le site Web du projet
Naviguez jusqu’ à un nouveau répertoire et lancez votre nouvelle application de projet. Remplacez l’adresse IP ci-dessous par votre adresse IP locale. Si vous n’accédez pas à votre site Web à distance, vous pouvez omettre complètement l’option hôte et votre site démarrera localement:

$ jekyll serve --host 93.115.96.97

Utilisez votre navigateur pour afficher l’URL suivante http://93.115.96.97:4000/ ou, si vous exécutez localement http://127.0.0.1:4000/.

Thèmes

Préalable, installer les librairies

sudo apt install patch ruby-dev zlib1g-dev liblzma-dev ruby-rmagick

Ajouter le thème minimal-mistakes

Méthode Gem Ruby

Ajouter la ligne suivante au fichier Gemfile:

gem "minimal-mistakes-jekyll"

Ajouter la ligne suivante au fichiers _config.yml:

theme: minimal-mistakes-jekyll

Exécuter Bundler pour installer le theme gem et les dépendances:

bundle install

Apparence du thème, ajouter la ligne suivante au fichiers _config.yml:

minimal_mistakes_skin: "default" # "air", "aqua", "contrast", "dark", "dirt", "neon", "mint", "plum" "sunrise"

Méthode git

export LANG=fr_FR.UTF-8

git clone https://github.com/mmistakes/minimal-mistakes.git
mv minimal-mistakes jeksite
rm -r jeksite/{.editorconfig,.gitattributes,.github,docs,test,CHANGELOG.md,minimal-mistakes-jekyll.gemspec,README.md,screenshot-layouts.png,screenshot.png}
cd jeksite

Modifier Gemfile et _config.yml

bundle install

Déploiement git https://jekyllrb.com/docs/deployment-methods/ How-to setup a simple git push deployment https://gist.github.com/thomasfr/9691385

Nuage de tag jekyll http://jovandeginste.github.io/2016/05/04/add-a-tag-cloud-to-my-jekyll-site.html