Maqaalka soo socda waxaan ku eegeynaa Wiki.js. Tani waa mid App wiki fudud oo fudud oo bilaash ah oo lagu dhisay Node.js. Si ka duwan barnaamijyada kale ee wiki, kani wuxuu kaydiyaa dhammaan waxyaabahaaga si toos ah faylasha Markdown (.md). Waxyaabahan ayaa si otomaatig ah loogula midoobaa keydka Git-ka fog ee isticmaalaha.
Waa il furan, dalab casri ah oo awood leh oo wiki ah ku saleysan Node.js, Git iyo Markdown. Koodhka isha ee Wiki.js ayaa si guud looga heli karaa Github, diyaar u ah inaad soo dejiso oo rakibto. Tani waa suurtagal maxaa yeelay Wiki.js gabi ahaanba waa il furan, oo hoos timaad liisanka GNU AGPLv3.
Astaamaha guud ee Wiki.js
- Waxaan awoodi doonnaa inaan ku qorno waxyaabahayaga qaab Markdown ah. Waxaan isticmaali doonaa tifaftire muuqaal ah oo la dhisay.
- Si ka duwan barnaamijyada kale ee wiki ee keydiya waxyaabaha ku jira keydka macluumaadka, Wiki.js toos u kaydi dhammaan waxyaabaha ku jira faylasha Markdown (.md). Waxyaabahan ayaa si otomaatig ah loogula midoobaa keydkeena fog ee Git. Haddaan danaynayno.
- Codsiga wuxuu ku shaqeeyaa mishiinka Node.js. Ma yahay loogu talagalay in la isticmaalo ilaha processor-ka hooseeya. Waxay si weyn ugu tiirsan tahay kaydinta si dhakhso leh ugu gudbiso waxyaabaha adeegsadayaasha.
- Waxyaabaha la soo saaray waxaa loogu shaqeynayaa si otomaatig ah a nadiif ah qaabka akhriska. Waxaa lagu soo bandhigayaa dhex-dhexaad ah isticmaale adeegsade.
- Waan awoodnaa xaddido marin u helka Wiki-keena isticmaaleyaasha qaarkood ama xitaa qaybo ka mid ah waxyaabaha ku jira.
- Waxaan awoodi doonnaa inaan ku galno adoo adeegsanaya keydka macluumaadka deegaanka. Waxaan sidoo kale awoodi doonaa inaan ku xirno adoo adeegsanaya bixiyeyaasha xaqiijinta dibadda sida Microsoft Account, Google ID, iwm.
- Barnaamijku wuxuu na siinayaa suurtagalnimada inaan galino sawirro, jaantusyo, dukumiintiyo, fiidiyowyo, xiriiriyeyaal, iwm. Tan waxaan u isticmaali doonaa maareeyaha hantida Kaas oo ku daraya.
- Waxaan awoodi doonaa inaan si dhakhso leh u helno gelitaanka wiki ee aan raadineyno isticmaalka ku rakibay mashiinka raadinta. Waxay na siin doontaa natiijooyin ku habboon iyo talo soo jeedinno marka la falanqeynayo metadata iyo waxyaabaha ku jira gelitaanka wiki.
Shuruudaha adeegaha
Si barnaamijkan looga dhigo mid shaqeynaya, waxaan u baahanahay inaan waxyaabo ku yeelano adeegeena.
- Node.js 6.9.0 ama ka sareeya.
- MongoDB 3.2 ama ka sareeya.
- Git 2.7.4 ama ka sareeya.
- Bakhaarka Git (mid dawladeed ama mid gaar loo leeyahay). Tani waa ikhtiyaari.
Ku rakib Wiki.js Ubuntu
Qoraalkan gaaban waxaan arki doonaa sida ku rakib Wiki.js server Ubuntu 18.04 dhammaan shuruudahaaga lagama maarmaanka ah.
Ku rakib Git
Si aan u bilawno waxaan u baahan doonaa inaan rakibno Git si aan u socodsiino Wiki.js. Git ayaa horay loogu sii rakibay serverka Ubuntu. Waxaa laga yaabaa inaadan u baahnayn inaad rakibato. Si kastaba ha noqotee, haddii aad u baahan tahay nooca ugu dambeeya ee Git, ku dar bakhaarka soo socda oo rakib:
sudo add-apt-repository -y ppa:git-core/ppa sudo apt update && sudo apt upgrade sudo apt install git
Ku rakib Node.js
Node.js waa shuruud kale oo khasab ah si aad u hesho Wiki.js. Waxaan kaliya u baahan doonnaa inaan fulino amarrada soo socda si aan u rakibno Node.js:
sudo apt install curl curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash - sudo apt install -y nodejs
Ku rakib MongoDB
MongoDB sidoo kale waa mid ka mid ah shuruudaha qasabka ah ee loogu talagalay Wiki.js. Waxaan u soconaa ku rakib nooca ku soo dhaca bakhaarka Ubuntu. Waxaan kaliya u baahanahay inaan fulino amarka:
sudo apt install mongodb
Soo dejiso oo rakib Wiki.js
Marka dhammaan shuruudaha la buuxiyo, waan awoodnaa soo dejiso Wiki.js rakibida qoraalka oo bilow. Si tan loo sameeyo
sudo mkdir /var/www/wikijs cd /var/www/wikijs curl -sSo- https://wiki.js.org/install.sh | sudo bash
Ka dib markaad maamusho amarka ugu dambeeya, waa inaad aragtaa a fariin guul sida kuwan soo socda:
Ka dib markii la rakibo, waxaa naloo horseedi doonaa inaan socodsiino Qalabka Dejinta. Waxaan ku bilaabi karnaa adoo ordaya:
sudo node wiki configure
Amarkan wuxuu na tusi doonaa fariin ku socota fur cinwaanka http: // localhost: 3000 ee biraawsarka si aad uhesho Wiki.js
Haddii aan furno biraawsarkayaga oo aan raadino magaca martigeliyaha ee server-ka ama cinwaanka IP-ga ee ku xigta dekedda, saaxirku wuu bilaabi doonaa. Halkan waxaan ku yeelan doonnaa shaashado qaabeynta kala duwan. Haddii aynaan rabin inaynu isku murganno, waan aqbali karnaa dejinta caadiga ah oo sii wad.
Barnaamijka ansixiyaan in nidaamku buuxiyo shuruudaha lagama maarmaan.
Waxa xiga ee ah inaan buuxinno ayaa ah qaabeynta guud.
Markaa waa inaanu kala Isku xirka MongoDB. Haddii rakibaadda aan horay u sameynay ay sax ahayd, waxaan riixi karnaa badhanka «Connect«. Daaqada xigta waxay noqon doontaa Wadooyinka isku xidhka. Halkan waxay kugula talinayaan in loo daayo inay cillad tahay sidaa darteed waxaan ku sii wadaynaa rakibidda.
Shaashadda xigta waan awoodnaa kudar xogta koontadayada 'Git', ama ka bood tallaabadan.
Hadda waxaan u baahanahay inaan samee xisaab maamul inaad gasho mar dambe.
Taas ka dib iyo dhowr shaashadood oo kale oo aad dejisid, Wiki.js waa in la rakibaa oo la diyaariyaa.
Dhamaadka waa inaan soo galnaa. Waxaan u isticmaali doonaa koontada maamulka ee aan horay u abuurnay si aan u abuurno boggeena guriga.
Oo intaas oo dhan ka dib, waxaan u tagi doonnaa tifaftiraha. Tani waa halka aan ka bilaabi karno abuurista.
Tani waa uun rakibo aasaasi ah. Wixii ka hel macluumaad dheeri ah oo ku saabsan barnaamijkan wiki, ku saabsan rakibideeda, isticmaalkeeda ama si loo arko dukumiintiyada rasmiga ah, waxaan booqan karnaa bogga mashruuca.