So richten Sie ein GitHub Style Wiki mit Gollum unter CentOS 7 ein

• Voraussetzungen
• Schritt 1: Aktualisieren Sie das System
• Schritt 2: Installieren Sie Gollum mit gem
• Schritt 3: Richten Sie ein Gollum-Wiki ein
• Schritt 4: Webzugriff zulassen
• Schritt 5: Greifen Sie über das Web auf Gollum zu
• Schritt 6: Erstellen oder bearbeiten Sie Gollum-Wiki-Seiten über die CLI

Gollum ist die Git-basierte Wiki-Software, die als Backend des GitHub-Wikis verwendet wird. Durch die Bereitstellung von Gollum können Sie ein GitHub-ähnliches Wiki-System auf Ihrem Server hosten.

Interessiert? Toll! Schauen wir uns an, wie Gollum unter CentOS 7 installiert wird.

Voraussetzungen

• Eine CentOS 7 x64-Serverinstanz.
• Ein Sudo-Benutzer .
• Das EPELYum-Repository.

Schritt 1: Aktualisieren Sie das System

Melden Sie sich über SSH mit dem sudo-Benutzer bei Ihrem Server an epel, um das System zu installieren , zu aktualisieren und neu zu starten, um die Updates anzuwenden.

sudo yum install epel-release -y
sudo yum update -y && sudo shutdown -r now

Schritt 2: Installieren Sie Gollum mit gem

Unter CentOS 7 können Sie Gollum am einfachsten mithilfe von RubyGems installieren:

sudo yum group install "Development Tools" -y
sudo yum install ruby ruby-devel libicu libicu-devel zlib zlib-devel git -y
sudo gem install gollum

Hinweis: Der gem installobige Befehl kann eine Weile dauern. Wenn Sie es eilig haben, können Sie die Installation beschleunigen, indem Sie die folgenden Dokumente überspringen. Sie können es auch in einer screenSitzung ausführen

sudo gem install --no-rdoc --no-ri gollum

Die Gollum-Binärdatei wird unter auf Ihrem System installiert. /usr/local/bin/gollumSie können überprüfen, ob die Installation erfolgreich war, indem Sie den folgenden einfachen Befehl ausführen:

gollum --v

Schritt 3: Richten Sie ein Gollum-Wiki ein

Alles, was Sie tun müssen, um ein Gollum-Wiki einzurichten, ist, ein Git-Repository zu erstellen und den darin enthaltenen gollumBefehl auszuführen :

cd
mkdir my-wiki
cd my-wiki
git init
gollum

Hinweis: Bei Bedarf können Sie Ctrl+CGollum beenden.

Schritt 4: Webzugriff zulassen

Bevor Sie Ihre Gollum-Wiki-Site in Ihrem Webbrowser besuchen können, müssen Sie die Firewall-Regeln wie folgt ändern:

sudo firewall-cmd --zone=public --permanent --add-port=4567/tcp
sudo firewall-cmd --reload

Schritt 5: Greifen Sie über das Web auf Gollum zu

Zeigen Sie während der Ausführung von Gollum mit Ihrem Webbrowser auf http://203.0.113.1:4567die Erstellung der ersten Gollum-Wiki-Seite. Sie können dort weitere Wiki-Seiten erstellen, und alle von Ihnen erstellten Seiten werden als .mdDateien im aktuellen Git-Repo-Verzeichnis gespeichert .

Schritt 6: Erstellen oder bearbeiten Sie Gollum-Wiki-Seiten über die CLI

Neben dem Erstellen oder Ändern von Seiten über einen Webbrowser können Sie auch Seiten über die CLI erstellen oder bearbeiten. Dazu müssen Sie nur .mdDateien gemäß der MarkDown-Syntax erstellen und diese dann in das Git-Repo übertragen:

cd ~/my-wiki
vi page1.md
git config --global user.email "[email protected]"
git config --global user.name "admin"
git add page1.md
git commit -m "create page1"

Das ist es. Um mehr über Gollum zu erfahren gollum --help, geben Sie die Gollum-Hilfe ein oder besuchen Sie die offizielle Gollum-Website .