Erste Schritte mit Jekyll unter Debian 9 Stretch Linux

Ziel

Das Ziel ist die Installation von Jekyll, dem statischen Site-Generator, aus dem Quellcode oder Standard im Debian 9 Stretch-Repository.

Betriebssystem- und Softwareversionen

• Betriebssystem: – Debian 9 Stretch
• Software: – jekyll 3.4.3 (Quelle) oder jekyll 3.1.6 (Debian-Repository)

Anforderungen

Privilegierter Zugriff auf Ihr Debian-System ist erforderlich, um Jekyll-Pakete sowie alle erforderlichen Gems zu installieren.

Schwierigkeit

EINFACH

Konventionen

• # – erfordert, dass bestimmte Linux-Befehle mit Root-Rechten ausgeführt werden, entweder direkt als Root-Benutzer oder durch Verwendung von sudo Befehl
• $ – erfordert, dass bestimmte Linux-Befehle als normaler, nicht privilegierter Benutzer ausgeführt werden

Anleitung

Jekyll-Installation

Debian-Repository

Dies ist bei weitem die einfachste Möglichkeit, Jekyll auf Ihrem Linux-System zu installieren. Der Nachteil ist, dass Sie abhängig von Ihren Anforderungen möglicherweise eine zwar stabile, aber veraltete Jekyll-Version erhalten. Um Jekyll zu installieren, führen Sie Folgendes aus:

# apt install jekyll

Bestätigen Sie die Installation von jekyll, indem Sie die Versionsnummer abfragen:

$ jekyll -v
jekyll 3.1.6

Quellinstallation

Führen Sie den folgenden Linux-Befehl aus, um das neueste Jekyll mit Gems zu installieren:

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

Bestätigen Sie die Installation von jekyll, indem Sie die Versionsnummer abfragen:

$ jekyll -v
jekyll 3.4.3

Neues Projekt erstellen

Wir sind jetzt bereit, ein neues Projekt zu erstellen. Wählen Sie einen beliebigen Projektnamen, z. linuxconfig :

$ jekyll new linuxconfig

Der obige Befehl hat ein Verzeichnis namens linuxconfig erstellt hält eine grundlegende Jekyll-Struktur Ihrer neuen Anwendung.

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

Sie können jetzt _config.yml bearbeiten Hauptkonfigurationsdatei, um einen neuen Namen für Ihre Website festzulegen, eine Beschreibung hinzuzufügen und mehr. Um neue Blogbeiträge hinzuzufügen, navigieren Sie zu _posts Verzeichnis. Bearbeiten Sie dort entweder den Beispielbeitrag oder erstellen Sie einen neuen, indem Sie den ursprünglichen Beispielbeitrag kopieren und ihm einen neuen Namen geben, während Sie das gleiche Benennungsformat verwenden.

Projekt-Website anzeigen

Navigieren Sie in ein neu erstelltes Verzeichnis und starten Sie Ihre neue Projektanwendung. Ersetzen Sie die folgende IP-Adresse durch Ihre lokale IP-Adresse. Wenn Sie nicht remote auf Ihre Website zugreifen, können Sie die Host-Option vollständig weglassen und Ihre Website wird lokal gestartet:

$ jekyll serve --host 10.1.1.125

Verwenden Sie Ihren Browser, um die folgende URL http://10.1.1.125:4000/ anzuzeigen oder bei lokaler Ausführung http://127.0.0.1:4000/ .