Как да настроите Wiki в стил GitHub с помощта на Gollum на CentOS 7

Gollum е базиран на Git уики софтуер, използван като бекенд на GitHub Wiki. Разгръщането на Gollum ще ви позволи да хоствате Wiki система, подобна на GitHub на вашия сървър.

Интересувате ли се? Страхотен! Нека да разгледаме как да инсталирате Gollum на CentOS 7.

Предпоставки

• Инстанция на сървъра CentOS 7 x64.
• А потребителското Sudo .
• The EPELYum хранилището.

Стъпка 1: Актуализирайте системата

Влезте във вашия сървър чрез SSH, като използвате sudo потребителя, за да инсталирате epel, актуализирате системата и рестартирате, за да приложите актуализациите.

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

Стъпка 2: Инсталирайте Gollum с помощта на скъпоценен камък

На 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: Настройте уики на Gollum

Всичко, което трябва да направите, за да настроите Gollum Wiki, е да създадете git хранилище и да изпълните gollumкомандата вътре в него:

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

Забележка: Когато е необходимо, можете да използвате, за Ctrl+Cда излезете от Gollum.

Стъпка 4: Разрешете уеб достъпа

Преди да можете да посетите своя уики сайт на Gollum във вашия уеб браузър, трябва да промените правилата на защитната стена, както следва:

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

Стъпка 5: Достъп до Gollum от мрежата

Докато Gollum работи, насочете уеб браузъра си към, за http://203.0.113.1:4567да започнете да създавате първата уики страница на Gollum. Чувствайте се свободни да създадете още wiki страници там и всички страници, които създадете, ще бъдат запазени като .mdфайлове в текущата директория на git repo.

Стъпка 6: Създайте или редактирайте уики страници на 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 .