Cara Menyiapkan Wiki Gaya GitHub Menggunakan Gollum di CentOS 7

• Prasyarat
• Langkah 1: Kemas kini sistem
• Langkah 2: Pasang Gollum menggunakan permata
• Langkah 3: Siapkan wiki Gollum
• Langkah 4: Benarkan akses web
• Langkah 5: Akses Gollum dari web
• Langkah 6: Buat atau edit halaman wiki Gollum dari CLI

Gollum adalah perisian wiki berasaskan Git yang digunakan sebagai backend dari GitHub Wiki. Menggunakan Gollum akan membolehkan anda menjadi tuan rumah sistem Wiki seperti GitHub di pelayan anda.

Berminat? Hebat! Mari lihat cara memasang Gollum di CentOS 7.

Prasyarat

• Contoh pelayan CentOS 7 x64.
• Pengguna sudo .
• The EPELrepositori yum.

Langkah 1: Kemas kini sistem

Log masuk ke pelayan anda melalui SSH menggunakan pengguna sudo untuk memasang epel, mengemas kini sistem, dan memulakan semula untuk menerapkan kemas kini.

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

Langkah 2: Pasang Gollum menggunakan permata

Di CentOS 7, cara termudah untuk memasang Gollum adalah dengan menggunakan 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

Catatan: gem installPerintah di atas mungkin memerlukan sedikit masa untuk diselesaikan. Sekiranya anda tergesa-gesa, anda boleh mempercepat pemasangan dengan melangkau dokumen seperti berikut. Anda juga boleh menjalankannya dalam satu screensesi

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

Binari Gollum akan dipasang ke dalam sistem anda di /usr/local/bin/gollum, dan anda boleh mengesahkan sama ada pemasangan itu berjaya atau tidak dengan menjalankan perintah mudah di bawah:

gollum --v

Langkah 3: Siapkan wiki Gollum

Yang perlu anda lakukan untuk menyiapkan Gollum Wiki adalah dengan membuat git repositori dan jalankan gollumperintah di dalamnya:

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

Catatan: Bila perlu, anda boleh gunakan Ctrl+Cuntuk keluar dari Gollum.

Langkah 4: Benarkan akses web

Sebelum anda melayari laman web wiki Gollum di penyemak imbas web anda, anda perlu mengubah peraturan firewall seperti berikut:

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

Langkah 5: Akses Gollum dari web

Semasa Gollum sedang berjalan, arahkan penyemak imbas web anda http://203.0.113.1:4567untuk mula membuat halaman wiki Gollum pertama. Jangan ragu untuk membuat lebih banyak halaman wiki di sana, dan semua halaman yang anda buat akan disimpan sebagai .mdfail dalam direktori git repo semasa.

Langkah 6: Buat atau edit halaman wiki Gollum dari CLI

Selain membuat atau mengubah halaman dari penyemak imbas web, anda juga dapat membuat atau mengedit halaman dari CLI. Untuk melakukannya, anda hanya perlu membuat .mdfail sesuai dengan sintaks MarkDown, dan kemudian mengikatnya ke git repo:

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"

Itu sahaja. Untuk mengetahui lebih lanjut mengenai Gollum, ketik gollum --helpuntuk melihat bantuan Gollum atau kunjungi laman web rasmi Gollum .