Hvernig á að setja upp GitHub Style Wiki með Gollum á CentOS 7

Gollum er Git-undirstaða wiki hugbúnaðurinn sem notaður er sem bakendi GitHub Wiki. Að setja upp Gollum mun leyfa þér að hýsa GitHub-líkt Wiki kerfi á netþjóninum þínum.

Hefur þú áhuga? Frábært! Við skulum skoða hvernig á að setja upp Gollum á CentOS 7.

Forkröfur

• CentOS 7 x64 netþjónstilvik.
• A sudo notandi .
• The EPELYum geymsla.

Skref 1: Uppfærðu kerfið

Skráðu þig inn á netþjóninn þinn í gegnum SSH með því að nota sudo notandann til að setja upp epel, uppfæra kerfið og endurræsa til að nota uppfærslurnar.

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

Skref 2: Settu upp Gollum með því að nota gem

Á CentOS 7 er auðveldasta leiðin til að setja upp Gollum með því að nota 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

Athugið: gem installSkipunin hér að ofan getur tekið smá stund að ljúka. Ef þú ert að flýta þér geturðu flýtt fyrir uppsetningunni með því að sleppa skjölum á eftirfarandi hátt. Þú getur líka keyrt það í screenlotu

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

Gollum tvöfaldurinn verður settur upp í kerfið þitt á /usr/local/bin/gollum, og þú getur staðfest hvort uppsetningin hafi heppnast eða ekki með því að keyra einföldu skipunina hér að neðan:

gollum --v

Skref 3: Settu upp Gollum wiki

Allt sem þú þarft að gera til að setja upp Gollum Wiki er að búa til git geymslu og keyra gollumskipunina inni í henni:

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

Athugið: Þegar nauðsyn krefur geturðu notað Ctrl+Ctil að hætta við Gollum.

Skref 4: Leyfa aðgang að vefnum

Áður en þú getur heimsótt Gollum wiki síðuna þína í vafranum þínum þarftu að breyta eldveggsreglum sem hér segir:

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

Skref 5: Fáðu aðgang að Gollum af vefnum

Á meðan Gollum er í gangi skaltu beina vafranum þínum á til http://203.0.113.1:4567að byrja að búa til fyrstu Gollum wiki síðuna. Ekki hika við að búa til fleiri wiki síður þar, og allar síðurnar sem þú býrð til verða vistaðar sem .mdskrár í núverandi git repo möppu.

Skref 6: Búðu til eða breyttu Gollum wiki síðum frá CLI

Fyrir utan að búa til eða breyta síðum úr vafra geturðu líka búið til eða breytt síðum úr CLI. Til að gera það þarftu aðeins að búa til .mdskrár í samræmi við MarkDown setningafræðina og binda þær síðan í git endurhverfan:

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"

Það er það. Til að læra meira um Gollum skaltu slá inn gollum --helptil að skoða Gollum hjálpina eða heimsækja opinbera Gollum vefsíðu .