Cum să configurați un Wiki în stil GitHub folosind Gollum pe CentOS 7

• Cerințe preliminare
• Pasul 1: Actualizați sistemul
• Pasul 2: Instalați Gollum folosind gem
• Pasul 3: Configurați un wiki Gollum
• Pasul 4: Permiteți accesul web
• Pasul 5: Accesați Gollum de pe web
• Pasul 6: Creați sau editați pagini wiki Gollum din CLI

Gollum este software-ul wiki bazat pe Git folosit ca backend al GitHub Wiki. Implementarea Gollum vă va permite să găzduiți un sistem Wiki asemănător unui GitHub pe serverul dvs.

Interesat? Grozav! Să aruncăm o privire la modul de instalare a Gollum pe CentOS 7.

Cerințe preliminare

• O instanță de server CentOS 7 x64.
• Un utilizator sudo .
• Depozitul EPELyum

Pasul 1: Actualizați sistemul

Conectați-vă la serverul dvs. prin SSH cu ajutorul utilizatorului sudo pentru instalare epel, actualizare a sistemului și reporniți pentru a aplica actualizările.

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

Pasul 2: Instalați Gollum folosind gem

Pe CentOS 7, cel mai simplu mod de a instala Gollum este folosind 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

Notă: gem installComanda de mai sus poate dura ceva timp pentru a fi finalizată. Dacă vă grăbiți, puteți accelera instalarea omitând documentele după cum urmează. Puteți rula, de asemenea, într-o screensesiune

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

Binarul Gollum va fi instalat în sistemul dvs. /usr/local/bin/gollumși puteți confirma dacă instalarea a avut sau nu succesul executând comanda simplă de mai jos:

gollum --v

Pasul 3: Configurați un wiki Gollum

Tot ce trebuie să faceți pentru a configura un Gollum Wiki este să creați un depozit git și să rulați gollumcomanda în interiorul acestuia:

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

Notă: Când este necesar, puteți utiliza Ctrl+Cpentru a ieși din Gollum.

Pasul 4: Permiteți accesul web

Înainte de a putea vizita site-ul wiki Gollum în browserul web, trebuie să modificați regulile firewallului după cum urmează:

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

Pasul 5: Accesați Gollum de pe web

În timp ce Gollum rulează, îndreptați-vă browserul web pentru http://203.0.113.1:4567a începe crearea primei pagini woll Gollum. Simțiți-vă liber să creați mai multe pagini wiki acolo, iar toate paginile create de dvs. vor fi salvate ca .mdfișiere în directorul curent git repo.

Pasul 6: Creați sau editați pagini wiki Gollum din CLI

În afară de crearea sau modificarea paginilor dintr-un browser web, puteți crea sau edita pagini din CLI. Pentru a face acest lucru, nu trebuie decât să creați .mdfișiere în conformitate cu sintaxa MarkDown, apoi să le angajați la 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"

Asta e. Pentru a afla mai multe despre Gollum, tastați gollum --helpsă consultați ajutorul Gollum sau să faceți o vizită pe site-ul oficial Gollum .