У наступній статті ми збираємось поглянути на 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. Є оптимізовано для використання низьких ресурсів процесора. Він значною мірою покладається на кешування, щоб швидко доставити вміст користувачам.
- Згенерований вміст обробляється автоматично в чистий формат читання -. Він представлений в елегантному інтерфейсі користувача.
- Ми зможемо обмежити доступ до нашої Вікі певним користувачам або навіть лише частинам вмісту.
- Ми зможемо увійти, використовуючи локальну базу даних. Ми також зможемо підключитися за допомогою зовнішні постачальники аутентифікації як обліковий запис Microsoft, ідентифікатор Google тощо.
- Програма надасть нам можливість вставляти зображення, схеми, документи, відео, посилання тощо. Для цього ми будемо використовувати менеджер активів Що включає.
- Ми зможемо швидко знайти вікі-запис, який ми шукаємо, використовуючи вбудована пошукова система. Він надасть нам відповідні результати та пропозиції при аналізі метаданих та змісту наших записів у вікі.
Вимоги до сервера
Для того, щоб ця програма працювала, нам потрібно мати кілька речей на нашому сервері.
- Node.js 6.9.0 або новішої версії.
- MongoDB 3.2 або вище.
- Git 2.7.4 або вище.
- Сховище Git (державна чи приватна). Це необов’язково.
Встановіть Wiki.js на Ubuntu
Цей короткий пост ми побачимо як встановіть Wiki.js на сервері Ubuntu 18.04 з усіма вашими необхідними вимогами.
Встановіть Git
Для початку нам потрібно буде встановити Git для запуску Wiki.js. Git поставляється попередньо встановленим на сервері Ubuntu. Можливо, вам не доведеться його встановлювати. Однак якщо вам потрібно остання версія 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. Ми збираємося встановіть версію, яка поставляється у сховищі Ubuntu. Нам залишиться лише виконати команду:
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
Ця команда покаже нам повідомлення відкрийте URL-адресу http: // localhost: 3000 у браузері, щоб налаштувати wiki.js.
Якщо ми відкриємо наш браузер і шукаємо ім'я хосту сервера або IP-адресу, за якою слідує порт, майстер запуститься. Тут ми матимемо різні екрани конфігурації. Якщо ми не хочемо занадто ускладнюватися, ми можемо прийняти налаштування за замовчуванням і продовжувати.
Програма підтвердити, що система відповідає вимогам необхідний.
Наступне, що нам доведеться заповнити, це загальна конфігурація.
Тоді нам доведеться налаштувати Підключення MongoDB. Якщо установка, яку ми проводили раніше, була правильною, ми можемо натиснути кнопку «З'єднуватися«. Наступним вікном буде вікно Конфігурація шляхів. Тут вони рекомендують залишити його дефектним, тому ми продовжуємо встановлення.
На наступному екрані ми можемо додайте дані нашого облікового запису Git, або пропустіть цей крок.
Тепер нам доведеться створити обліковий запис адміністратора для входу пізніше.
Після цього та декількох інших екранів налаштування, Wiki.js має бути встановлений і готовий до роботи.
В кінці нам доведеться увійти. Ми використаємо створений раніше обліковий запис адміністратора для створення домашньої сторінки.
І після всього цього ми дійдемо до редактора. З цього ми можемо почати творити.
Це лише базова установка. Для отримати більше інформації про цю вікі-платформу, щодо його встановлення, використання або для ознайомлення з офіційною документацією, ми можемо відвідати сайт сторінка проекту.