كيفية إعداد ويكي نمط GitHub باستخدام Gollum على CentOS 7

• المتطلبات الأساسية
• الخطوة 1: تحديث النظام
• الخطوة 2: قم بتثبيت Gollum باستخدام الأحجار الكريمة
• الخطوة 3: إعداد ويكي Gollum
• الخطوة 4: السماح بالوصول إلى الويب
• الخطوة 5: الوصول إلى Gollum من الويب
• الخطوة 6: قم بإنشاء أو تعديل صفحات ويكي Gollum من CLI

Gollum هو برنامج ويكي قائم على Git يستخدم كخلفية لـ GitHub Wiki. سيسمح لك نشر Gollum باستضافة نظام Wiki يشبه GitHub على خادمك.

مهتم؟ عظيم! دعونا نلقي نظرة على كيفية تثبيت Gollum على CentOS 7.

المتطلبات الأساسية

• مثيل خادم CentOS 7 x64.
• A المستخدم سودو .
• في EPELمستودع يم.

الخطوة 1: تحديث النظام

قم بتسجيل الدخول إلى الخادم الخاص بك عبر SSH باستخدام مستخدم sudo لتثبيت epelوتحديث النظام وإعادة التشغيل لتطبيق التحديثات.

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

الخطوة 2: قم بتثبيت Gollum باستخدام الأحجار الكريمة

أسهل طريقة لتثبيت Gollum على CentOS 7 هي استخدام 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 binary في نظامك في /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 wiki الخاص بك في متصفح الويب الخاص بك ، تحتاج إلى تعديل قواعد جدار الحماية على النحو التالي:

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 الرسمي على الويب .