Come configurare un wiki stile GitHub usando Gollum su CentOS 7

• Prerequisiti
• Passaggio 1: aggiornare il sistema
• Passaggio 2: installa Gollum usando gem
• Passaggio 3: imposta un wiki Gollum
• Passaggio 4: consentire l'accesso al Web
• Passaggio 5: accedi a Gollum dal Web
• Passaggio 6: creare o modificare pagine wiki Gollum dalla CLI

Gollum è il software wiki basato su Git utilizzato come backend del wiki GitHub. L'implementazione di Gollum ti permetterà di ospitare un sistema Wiki simile a GitHub sul tuo server.

Interessato? Grande! Diamo un'occhiata a come installare Gollum su CentOS 7.

Prerequisiti

• Un'istanza del server CentOS 7 x64.
• Un utente sudo .
• Il EPELrepository yum.

Passaggio 1: aggiornare il sistema

Accedere al server tramite SSH utilizzando l'utente sudo per installare epel, aggiornare il sistema e riavviare per applicare gli aggiornamenti.

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

Passaggio 2: installa Gollum usando gem

Su CentOS 7, il modo più semplice per installare Gollum è utilizzare 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

Nota: il completamento del gem installcomando sopra potrebbe richiedere alcuni minuti. Se hai fretta, puoi accelerare l'installazione saltando i documenti come segue. Puoi anche eseguirlo in una screensessione

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

Il binario Gollum verrà installato nel tuo sistema all'indirizzo /usr/local/bin/gollume puoi confermare se l'installazione ha avuto successo o meno eseguendo il semplice comando seguente:

gollum --v

Passaggio 3: imposta un wiki Gollum

Tutto ciò che devi fare per configurare un Gollum Wiki è creare un repository git ed eseguire il gollumcomando al suo interno:

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

Nota: se necessario, è possibile utilizzare Ctrl+Cper uscire da Gollum.

Passaggio 4: consentire l'accesso al Web

Prima di poter visitare il sito wiki Gollum nel browser Web, è necessario modificare le regole del firewall come segue:

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

Passaggio 5: accedi a Gollum dal Web

Mentre Gollum è in esecuzione, punta il tuo browser web http://203.0.113.1:4567per iniziare a creare la prima pagina wiki di Gollum. Sentiti libero di creare più pagine wiki lì e tutte le pagine che crei verranno salvate come .mdfile nella directory corrente di git repo.

Passaggio 6: creare o modificare pagine wiki Gollum dalla CLI

Oltre a creare o modificare pagine da un browser Web, è anche possibile creare o modificare pagine dalla CLI. Per fare ciò, devi solo creare .mdfile in accordo con la sintassi MarkDown, e poi trasferirli nel repository git:

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"

Questo è tutto. Per ulteriori informazioni su Gollum, digitare gollum --helpper consultare la guida di Gollum o visitare il sito Web ufficiale di Gollum .