Πώς να ρυθμίσετε ένα Wiki στυλ GitHub χρησιμοποιώντας το Gollum στο CentOS 7

Το Gollum είναι το λογισμικό wiki που βασίζεται στο Git και χρησιμοποιείται ως backend του GitHub Wiki. Η ανάπτυξη του Gollum θα σας επιτρέψει να φιλοξενήσετε ένα σύστημα Wiki παρόμοιο με το GitHub στον διακομιστή σας.

Ενδιαφερόμενος? Εξαιρετική! Ας ρίξουμε μια ματιά στον τρόπο εγκατάστασης του Gollum στο CentOS 7.

Προαπαιτούμενα

• Μια παρουσία διακομιστή CentOS 7 x64.
• Ένας χρήστης sudo .
• Το EPELαποθετήριο yum.

Βήμα 1: Ενημερώστε το σύστημα

Συνδεθείτε στον διακομιστή σας μέσω SSH χρησιμοποιώντας τον χρήστη sudo για εγκατάσταση epel, ενημέρωση του συστήματος και επανεκκίνηση για εφαρμογή των ενημερώσεων.

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

Βήμα 2: Εγκαταστήστε το Gollum χρησιμοποιώντας Gem

Στο CentOS 7, ο ευκολότερος τρόπος εγκατάστασης του Gollum είναι χρησιμοποιώντας το 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

Σημείωση: Η gem installπαραπάνω εντολή μπορεί να χρειαστεί λίγο χρόνο για να ολοκληρωθεί. Εάν βιάζεστε, μπορείτε να επιταχύνετε την εγκατάσταση παραλείποντας έγγραφα ως εξής. Μπορείτε επίσης να το εκτελέσετε σε μια screenπερίοδο λειτουργίας

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

Το δυαδικό σύστημα Gollum θα εγκατασταθεί στο σύστημά σας στη διεύθυνση /usr/local/bin/gollum, και μπορείτε να επιβεβαιώσετε εάν η εγκατάσταση ήταν επιτυχής ή όχι εκτελώντας την παρακάτω απλή εντολή:

gollum --v

Βήμα 3: Ρυθμίστε ένα wiki Gollum

Το μόνο που χρειάζεται να κάνετε για να ρυθμίσετε ένα Gollum Wiki είναι να δημιουργήσετε ένα αποθετήριο git και να εκτελέσετε την gollumεντολή μέσα σε αυτό:

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

Σημείωση: Όταν είναι απαραίτητο, μπορείτε να το χρησιμοποιήσετε Ctrl+Cγια έξοδο από το Gollum.

Βήμα 4: Επιτρέψτε την πρόσβαση στον ιστό

Για να μπορέσετε να επισκεφτείτε τον ιστότοπό σας στο Gollum wiki στο πρόγραμμα περιήγησής σας, πρέπει να τροποποιήσετε τους κανόνες του τείχους προστασίας ως εξής:

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

Βήμα 5: Πρόσβαση στο Gollum από τον Ιστό

Ενώ εκτελείται το Gollum, κατευθύνετε το πρόγραμμα περιήγησής σας για http://203.0.113.1:4567να ξεκινήσει η δημιουργία της πρώτης σελίδας wiki Gollum. Μη διστάσετε να δημιουργήσετε περισσότερες σελίδες wiki εκεί και όλες οι σελίδες που δημιουργήσατε θα αποθηκευτούν ως .mdαρχεία στον τρέχοντα κατάλογο git repo.

Βήμα 6: Δημιουργήστε ή επεξεργαστείτε σελίδες wiki Gollum από το CLI

Εκτός από τη δημιουργία ή την τροποποίηση σελίδων από ένα πρόγραμμα περιήγησης ιστού, μπορείτε επίσης να δημιουργήσετε ή να επεξεργαστείτε σελίδες από το CLI. Για να το κάνετε αυτό, χρειάζεται μόνο να δημιουργήσετε .mdαρχεία σύμφωνα με τη σύνταξη MarkDown και στη συνέχεια να τα δεσμεύσετε στο 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"

Αυτό είναι. Για να μάθετε περισσότερα για το Gollum, πληκτρολογήστε gollum --helpγια να δείτε τη βοήθεια του Gollum ή επισκεφθείτε τον επίσημο ιστότοπο του Gollum .