Forutsetninger
Trinn 1: Oppdater systemet
Trinn 2: Installer Gollum med gem
Trinn 3: Sett opp en Gollum-wiki
Trinn 4: Tillat nettilgang
Trinn 5: Få tilgang til Gollum fra nettet
Trinn 6: Opprett eller rediger Gollum wiki-sider fra CLI
Gollum er den Git-baserte wiki-programvaren som brukes som backend av GitHub Wiki. Utplassering av Gollum vil tillate deg å være vert for et GitHub-lignende Wiki-system på serveren din.
Interessert? Flott! La oss ta en titt på hvordan du installerer Gollum på CentOS 7.
Forutsetninger
- En CentOS 7 x64-serverforekomst.
- En sudo-bruker .
- Den
EPELyum depotet.
Trinn 1: Oppdater systemet
Logg på serveren din via SSH ved å bruke sudo-brukeren for å installere epel, oppdatere systemet og starte på nytt for å bruke oppdateringene.
sudo yum install epel-release -y
sudo yum update -y && sudo shutdown -r now
Trinn 2: Installer Gollum med gem
På CentOS 7 er den enkleste måten å installere Gollum på ved å bruke 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
Merk: gem installKommandoen ovenfor kan ta en stund å fullføre. Hvis du har det travelt, kan du fremskynde installasjonen ved å hoppe over dokumenter som følger. Du kan også kjøre den i en screenøkt
sudo gem install --no-rdoc --no-ri gollum
Gollum-binærfilen vil bli installert i systemet ditt på /usr/local/bin/gollum, og du kan bekrefte om installasjonen var vellykket eller ikke ved å kjøre den enkle kommandoen nedenfor:
gollum --v
Trinn 3: Sett opp en Gollum-wiki
Alt du trenger å gjøre for å sette opp en Gollum Wiki er å lage et git-depot og kjøre gollumkommandoen i det:
cd
mkdir my-wiki
cd my-wiki
git init
gollum
Merk: Når det er nødvendig, kan du bruke for Ctrl+Cå avslutte Gollum.
Trinn 4: Tillat nettilgang
Før du kan besøke Gollum wiki-siden din i nettleseren din, må du endre brannmurreglene som følger:
sudo firewall-cmd --zone=public --permanent --add-port=4567/tcp
sudo firewall-cmd --reload
Trinn 5: Få tilgang til Gollum fra nettet
Mens Gollum kjører, pek på nettleseren for http://203.0.113.1:4567å begynne å lage den første Gollum wiki-siden. Lag gjerne flere wiki-sider der, og alle sidene du oppretter vil bli lagret som .mdfiler i gjeldende git repo-katalog.
Trinn 6: Opprett eller rediger Gollum wiki-sider fra CLI
Bortsett fra å lage eller endre sider fra en nettleser, kan du også opprette eller redigere sider fra CLI. For å gjøre det trenger du bare å lage .mdfiler i samsvar med MarkDown-syntaksen, og deretter forplikte dem til git-repoen:
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"
Det er det. For å lære mer om Gollum, skriv inn for gollum --helpå sjekke Gollum-hjelpen eller besøk Gollums offisielle nettsted .