Wiki.js, ויקי קוד פתוח המבוסס על Node.js, Git ו-Markdown

במאמר הבא אנו נסתכל על Wiki.js. זה אחד אפליקציית ויקי קוד פתוח קלה וחינמית שנבנתה באמצעות Node.js. שלא כמו פלטפורמות וויקי אחרות, זו שומרת את כל התוכן שלך ישירות לקבצי Markdown (.md). תוכן זה מסונכרן אוטומטית עם מאגר Git המרוחק של המשתמש.

זהו יישום ויקי בקוד פתוח, מודרני וחזק מבוסס על Node.js, Git ו- Markdown. קוד המקור של Wiki.js זמין לציבור בכתובת GitHub, מוכן להורדה והתקנה. זה אפשרי מכיוון ש- Wiki.js הוא קוד פתוח לחלוטין, תחת הרישיון GNU AGPLv3.

התכונות הכלליות של Wiki.js

נוכל לכתוב את התוכן שלנו בפורמט Markdown. נשתמש ב- עורך חזותי מובנה.
בניגוד לתוכנות וויקי אחרות השומרות תוכן במסד נתונים, Wiki.js שמור את כל התוכן ישירות לקבצי Markdown (.md). תוכן זה מסונכרן אוטומטית עם מאגר Git המרוחק שלנו. אם אנו מעוניינים.
היישום פועל על מנוע Node.js. האם מותאם לשימוש במשאבי CPU נמוכים. זה מסתמך במידה רבה על מטמון כדי לספק במהירות תוכן למשתמשים.
התוכן שנוצר מעובד אוטומטית ב- פורמט קריאה נקי. הוא מוצג בממשק משתמש אלגנטי.
נוכל הגבל את הגישה לוויקי שלנו למשתמשים מסוימים או אפילו רק לחלקים מהתוכן.
נוכל להתחבר באמצעות בסיס הנתונים המקומי. נוכל גם להתחבר באמצעות ספקי אימות חיצוניים כמו חשבון מיקרוסופט, מזהה Google וכו '.
התוכנית תיתן לנו אפשרות להכניס תמונות, דיאגרמות, מסמכים, סרטונים, קישורים וכו '. לשם כך נשתמש ב- מנהל נכסים שמשלב.
נוכל למצוא במהירות את ערך הוויקי אותו אנו מחפשים באמצעות ה- מנוע חיפוש מובנה. זה יספק לנו תוצאות והצעות רלוונטיות בעת ניתוח המטא-נתונים והתוכן של ערכי הוויקי שלנו.

דרישות שרת

על מנת לגרום לתוכנית זו לעבוד, נצטרך שיהיו לנו כמה דברים בשרת שלנו.

Node.js 6.9.0 ומעלה.
MongoDB 3.2 ומעלה.
גיט 2.7.4 ומעלה.
מאגר Git (ציבורי או פרטי). זה אופציונלי.

התקן את Wiki.js באובונטו

פוסט קצר זה נראה כיצד התקן את Wiki.js על שרת אובונטו 18.04 עם כל הדרישות הדרושות לך.

התקן את Git

כדי להתחיל נצטרך להתקין את Git כדי להפעיל את Wiki.js. Git מגיע מותקן מראש בשרת אובונטו. ייתכן שלא תצטרך להתקין אותו. עם זאת, אם אתה צריך הגרסה האחרונה של גיט, הוסף את המאגר הבא והתקן אותו:

sudo add-apt-repository -y ppa:git-core/ppa

sudo apt update && sudo apt upgrade

sudo apt install git

התקן את Node.js

Node.js היא דרישה חובה נוספת להשיג Wiki.js. נצטרך לבצע רק את הפקודות הבאות להתקנת Node.js:

sudo apt install curl

curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -

sudo apt install -y nodejs

התקן את MongoDB

MongoDB היא גם אחת הדרישות המחייבות עבור Wiki.js. אנחנו הולכים ל התקן את הגרסה שמגיעה במאגר אובונטו. נצטרך לבצע רק את הפקודה:

sudo apt install mongodb

הורד והתקן את Wiki.js

לאחר שכל הדרישות מולאו, נוכל לעשות זאת הורד את סקריפט ההתקנה של Wiki.js והפעל אותו. לשם ביצוע ריצה זו:

sudo mkdir /var/www/wikijs

cd /var/www/wikijs

curl -sSo- https://wiki.js.org/install.sh | sudo bash

לאחר הפעלת הפקודה האחרונה, אתה אמור לראות א מסר הצלחה כמו הדברים הבאים:

לאחר ההתקנה, נתבקש להפעיל את אשף ההתקנה. אנחנו יכולים להתחיל את זה על ידי הפעלת:

sudo node wiki configure

פקודה זו תראה לנו הודעה ל- פתח את כתובת האתר http: // localhost: 3000 בדפדפן להגדרת התצורה wiki.js.

אם נפתח את הדפדפן ונחפש את שם המארח של השרת או את כתובת ה- IP ואחריו את היציאה, האשף יתחיל. כאן יהיו לנו מסכי תצורה שונים. אם אנחנו לא רוצים להסתבך יותר מדי, אנו יכולים לקבל את הגדרות ברירת המחדל והמשך.

התכנית לאמת שהמערכת עומדת בדרישות נחוץ.

הדבר הבא שנצטרך למלא הוא ה- תצורה כללית.

אז נצטרך להגדיר את חיבור MongoDB. אם ההתקנה שביצענו קודם הייתה נכונה, נוכל ללחוץ על הכפתור «לְחַבֵּר«. החלון הבא יהיה תצורת נתיבים. כאן הם ממליצים להשאיר אותו פגום ולכן נמשיך בהתקנה.

במסך הבא אנחנו יכולים הוסף את הנתונים של חשבון Git שלנו, או דלג על שלב זה.