Jekyll installeren

Hugo werkt uitstekend om een statische website te genereren. Wil echter toch ook Jekyll eens uit proberen. Volgens de website Staticgen zou Jekyll momenteel de nummer 1 tool zijn.

Jekyll op de Raspberry installeren zou nu (18-08-2016) niet erg ingewikkeld meer moeten zijn. De Ruby versie in distributie Raspbian Jessie (versie 8) zou actueel genoeg moeten zijn. Ruby versie 2 of hoger is nodig voor het draaien van Jekyll 3 of hoger. Op de Raspberry staat versie 2.1.5.

De stappen uitgevoerd beschreven op de website van Raspberrypi.org. Eerst rubygems geïnstalleerd met sudo apt-get install rubygems en daarna Jekyll zelf, d.m.v. sudo gem install jekyll.

Installatie verslag van Jekyll.

$ sudo gem install jekyll
Fetching: liquid-3.0.6.gem (100%)
Fetching: kramdown-1.12.0.gem (100%)
Fetching: mercenary-0.3.6.gem (100%)
Fetching: safe_yaml-1.0.4.gem (100%)
Fetching: colorator-1.1.0.gem (100%)
Fetching: rouge-1.11.1.gem (100%)
Fetching: sass-3.4.22.gem (100%)
Fetching: jekyll-sass-converter-1.4.0.gem (100%)
Fetching: rb-fsevent-0.9.7.gem (100%)
Fetching: ffi-1.9.14.gem (100%)
Building native extensions.  This could take a while...
Fetching: rb-inotify-0.9.7.gem (100%)
Fetching: listen-3.0.8.gem (100%)
ERROR:  Error installing jekyll:
        listen requires Ruby version >= 1.9.3.

Foutmelding lijkt niet terecht.

$ ruby --version
ruby 2.1.5p273 (2014-11-13) [arm-linux-gnueabihf]

Op zoek naar het probleem. Er blijken meerdere versies van gem op de Raspberry te staan. Standaard werd die van ruby versie 1.8 gebruikt, gem versie is te controleren met:

$ gem --version
1.8.24

Om de laatste gem versie te gebruiken moet ik gem2.1 intypen.

Eerst de installaties van gem versie 1.8 opgeruimd. Wat geïnstalleerd is, maak je zichtbaar met gem list. Opruimen gaat met sudo gem uninstall <package>.

Opnieuw geprobeerd te installeren. Wederom geen succes. Zoeken op internet levert op, dat developer versie van Ruby ook geïnstalleerd moeten worden. Dat gedaan met sudo apt-get install ruby-dev.

Daarna de installatie van Jekyll nogmaals uitgevoerd, met wel de goede gem versie:
sudo gem2.1 install jykell -V.
Jekyll versie 3.2.1 lijkt nu met succes te zijn geïnstalleerd. Installatie eindigt met:

Done installing documentation for ffi, forwardable-extended, jekyll, jekyll-watch, listen, pathutil, rb-fsevent, rb-inotify after 64 seconds
8 gems installed

Een testje of Jekyll het nu doet.

$ jekyll new testsite
New jekyll site installed in /media/raspberry-v/testsite.

:-)

Wordt vervolgd.

Website genereren

Volgend doel, proberen de website te genereren. jekyll build Er volgt een foutmelding. Zoeken op internet, foutmelding komt meer voor oplossing installatie extra software.
sudo gem2.1 install bundler, bron.

Wederom proberen de website te genereren. En wederom een foutmelding. Nu lijkt het er op dat het thema niet is geïnstalleerd, foutmelding geeft aan dat gem minima niet gevonden kan worden. Gekeken op de Github pagina van het thema. Het is wel geïnstalleerd echter moet nog een opdracht worden uitgevoerd: bundle, bron.

Nogmaals de website genereren met jekyll build, nu geen foutmelding, gelukt.

Website uitvoeren

De website heeft een configuratie bestand. Eerst hierin nog wat zaken aanpassen, omdat standaard is de website alleen beschikbaar op de local host. Op de local host heb ik geen grafische omgeving met een webbrowser draaien. Na wat zoeken en puzzelen, volgen toegevoegd aan het bestand _config.yml.

port: 1313
host: 192.168.0.166
# baseurl: http://rasp166
bind: 0.0.0.0

Website opgestart met: jekyll serve.

Dan nu eindelijk de laatste stap, web oproepen in de browser: http:rasp166:1313, en hij doet het.

Posting aanpassen

Hugo kan gewijzigde postings meteen weergeven. Zoiets is met Jekyll ook mogelijk alleen moet je zelf de webpagina verversen. Jekyll opnieuw opgestart met deze optie.

$ jekyll serve --watch --incremental

In een ander venster de posting aangepast, en op verversen gedrukt. En het werkt er wordt een gewijzigde webpagina weergegeven. Voor het verversen van deze ene pagina waren 1.7 seconden nodig.

Voorlopige conclusie

Jekyll installeren was lang niet zo eenvoudig als Hugo. Er zijn veel afhankelijkheden van extra benodigde software. Jekyll is een zwaardere oplossing dan Hugo.
Inhoudelijk wel benieuwd welke thema’s er zijn en hoe eenvoudig of moeilijk content te beheren is.

Bronnen:

• https://www.raspberrypi.org/documentation/linux/software/ruby.md
• https://jekyllrb.com/docs/installation/
• http://stackoverflow.com/questions/4304438/gem-install-failed-to-build-gem-native-extension-cant-find-header-files