Hoe je een GitHub Style Wiki opzet met Gollum op CentOS 7

• Vereisten
• Stap 1: werk het systeem bij
• Stap 2: Installeer Gollum met gem
• Stap 3: stel een Gollum-wiki in
• Stap 4: Webtoegang toestaan
• Stap 5: Gollum openen via internet
• Stap 6: Maak of bewerk Gollum-wikipagina's vanuit CLI

Gollum is de op Git gebaseerde wikisoftware die wordt gebruikt als de backend van de GitHub Wiki. Door Gollum te implementeren, kunt u een GitHub-achtig Wiki-systeem op uw server hosten.

Geïnteresseerd? Super goed! Laten we eens kijken hoe Gollum op CentOS 7 kan worden geïnstalleerd.

Vereisten

• Een CentOS 7 x64 serverinstantie.
• Een sudo-gebruiker .
• De EPELyum-opslagplaats.

Stap 1: werk het systeem bij

Log in op uw server via SSH met de sudo-gebruiker om te installeren epel, het systeem bij te werken en opnieuw op te starten om de updates toe te passen.

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

Stap 2: Installeer Gollum met gem

Op CentOS 7 is de eenvoudigste manier om Gollum te installeren met RubyGems:

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

Opmerking: het gem installkan enige tijd duren voordat de bovenstaande opdracht is voltooid. Als u haast heeft, kunt u de installatie versnellen door documenten als volgt over te slaan. Je kunt het ook in een screensessie uitvoeren

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

Het Gollum-binaire bestand wordt op uw systeem geïnstalleerd op /usr/local/bin/gollumen u kunt bevestigen of de installatie is geslaagd of niet door het onderstaande eenvoudige commando uit te voeren:

gollum --v

Stap 3: stel een Gollum-wiki in

Het enige dat u hoeft te doen om een ​​Gollum Wiki in te stellen, is door een git-repository te maken en de gollumopdracht erin uit te voeren:

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

Opmerking: indien nodig kunt u Ctrl+CGollum afsluiten.

Stap 4: Webtoegang toestaan

Voordat u uw Gollum-wikisite in uw webbrowser kunt bezoeken, moet u de firewallregels als volgt wijzigen:

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

Stap 5: Gollum openen via internet

Terwijl Gollum actief is, wijs je webbrowser naar http://203.0.113.1:4567om te beginnen met het maken van de eerste Gollum-wikipagina. Voel je vrij om daar meer wikipagina's te maken en alle pagina's die je maakt, worden opgeslagen als .mdbestanden in de huidige git repo-directory.

Stap 6: Maak of bewerk Gollum-wikipagina's vanuit CLI

Naast het maken of wijzigen van pagina's vanuit een webbrowser, kunt u ook pagina's maken of bewerken vanuit de CLI. Om dat te doen, hoeft u alleen .mdbestanden te maken in overeenstemming met de MarkDown-syntaxis en deze vervolgens toe te wijzen aan de git repo:

cd ~/my-wiki
vi page1.md
git config --global user.email "admin@example.com"
git config --global user.name "admin"
git add page1.md
git commit -m "create page1"

Dat is het. Voor meer informatie over Gollum typt gollum --helpu om de Gollum-hulp te bekijken of een bezoek te brengen aan de officiële Gollum-website .