Wiki.js, một wiki mã nguồn mở dựa trên Node.js, Git và Markdown

Giới thiệu về Wiki.js

Trong phần tiếp theo, chúng ta sẽ xem xét Wiki.js. Đây là một Ứng dụng wiki mã nguồn mở nhẹ miễn phí được xây dựng với Node.js. Không giống như các nền tảng wiki khác, nền tảng này lưu tất cả nội dung của bạn trực tiếp vào các tệp Markdown (.md). Nội dung này được tự động đồng bộ hóa với kho lưu trữ Git từ xa của người dùng.

Nó là một ứng dụng wiki mã nguồn mở, hiện đại và mạnh mẽ dựa trên Node.js, Git và Markdown. Mã nguồn Wiki.js được cung cấp công khai tại Github, đã sẵn sàng để tải xuống và cài đặt. Điều này có thể thực hiện được vì Wiki.js hoàn toàn là mã nguồn mở, theo giấy phép GNU AGPLv3.

Các tính năng chung của Wiki.js

  • Chúng tôi sẽ có thể viết nội dung của mình ở định dạng Markdown. Chúng tôi sẽ sử dụng trình chỉnh sửa trực quan tích hợp sẵn.
  • Không giống như các phần mềm wiki khác lưu nội dung vào cơ sở dữ liệu, Wiki.js lưu tất cả nội dung trực tiếp vào tệp Markdown (.md). Nội dung này được tự động đồng bộ hóa với kho lưu trữ Git từ xa của chúng tôi. Nếu chúng tôi quan tâm.
  • Ứng dụng chạy trên công cụ Node.js. Là được tối ưu hóa để sử dụng tài nguyên CPU thấp. Nó chủ yếu dựa vào bộ nhớ đệm để nhanh chóng cung cấp nội dung cho người dùng.
  • Nội dung được tạo được xử lý tự động trong định dạng đọc sạch. Nó được trình bày trong một giao diện người dùng trang nhã.
  • Chúng tôi sẽ có thể hạn chế quyền truy cập vào Wiki của chúng tôi cho một số người dùng nhất định hoặc thậm chí chỉ một phần của nội dung.
  • Chúng tôi sẽ có thể đăng nhập bằng cách sử dụng cơ sở dữ liệu cục bộ. Chúng tôi cũng sẽ có thể kết nối bằng cách sử dụng nhà cung cấp xác thực bên ngoài như Tài khoản Microsoft, ID Google, v.v.
  • Chương trình sẽ cung cấp cho chúng tôi khả năng chèn hình ảnh, sơ đồ, tài liệu, video, liên kết, v.v. Đối với điều này quản lý tài sản Trong đó kết hợp.
  • Chúng tôi sẽ có thể nhanh chóng tìm thấy mục wiki mà chúng tôi đang tìm kiếm bằng cách sử dụng công cụ tìm kiếm tích hợp sẵn. Nó sẽ cung cấp cho chúng tôi các kết quả và đề xuất có liên quan khi phân tích siêu dữ liệu và nội dung của các mục wiki của chúng tôi.

Yêu cầu máy chủ

Để làm cho chương trình này hoạt động, chúng tôi sẽ cần phải có một số thứ trên máy chủ của mình.

  • Node.js 6.9.0 trở lên.
  • MongoDB 3.2 trở lên.
  • Git 2.7.4 hoặc cao hơn.
  • Kho lưu trữ Git (công cộng hay tư nhân). Đây là tùy chọn.

Cài đặt Wiki.js trên Ubuntu

Bài viết ngắn này chúng ta sẽ xem cách cài đặt Wiki.js trên máy chủ Ubuntu 18.04 với tất cả các yêu cầu cần thiết của bạn.

Cài đặt Git

Để bắt đầu, chúng ta sẽ cần cài đặt Git để chạy Wiki.js. Git được cài đặt sẵn trên máy chủ Ubuntu. Bạn có thể không cần cài đặt nó. Tuy nhiên, nếu bạn cần phiên bản mới nhất của Git, thêm kho lưu trữ sau và cài đặt nó:

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

sudo apt update && sudo apt upgrade

sudo apt install git

Cài đặt Node.js

Node.js là một yêu cầu bắt buộc khác để tải Wiki.js. Chúng tôi sẽ chỉ phải thực hiện các lệnh sau để cài đặt Node.js:

sudo apt install curl

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

sudo apt install -y nodejs

Cài đặt MongoDB

MongoDB cũng là một trong những yêu cầu bắt buộc đối với Wiki.js. Chúng ta sắp cài đặt phiên bản có trong kho lưu trữ Ubuntu. Chúng tôi sẽ chỉ phải thực hiện lệnh:

sudo apt install mongodb

Tải xuống và cài đặt Wiki.js

Khi tất cả các yêu cầu đã được đáp ứng, chúng tôi có thể tải xuống tập lệnh cài đặt Wiki.js và khởi chạy nó. Để làm điều này, hãy chạy:

sudo mkdir /var/www/wikijs

cd /var/www/wikijs

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

Sau khi chạy lệnh cuối cùng, bạn sẽ thấy gửi tin thành công như sau:

cài đặt wiki.js

Sau khi cài đặt, chúng tôi sẽ được yêu cầu chạy thuật sĩ thiết lập. Chúng ta có thể bắt đầu nó bằng cách chạy:

sudo node wiki configure

Lệnh này sẽ hiển thị cho chúng tôi một thông báo tới mở URL http: // localhost: 3000 trong trình duyệt để định cấu hình wiki.js.

định cấu hình wiki.js

Nếu chúng tôi mở trình duyệt của mình và tìm kiếm tên máy chủ của máy chủ hoặc địa chỉ IP theo sau là cổng, trình hướng dẫn sẽ bắt đầu. Ở đây chúng ta sẽ có các màn hình cấu hình khác nhau. Nếu chúng ta không muốn quá phức tạp, chúng tôi có thể chấp nhận cài đặt mặc định và tiếp tục.

cấu hình từ trình duyệt wiki.js

Chương trình xác nhận rằng hệ thống đáp ứng các yêu cầu cần thiết.

kiểm tra hệ thống wiki.js

Điều tiếp theo chúng ta sẽ phải điền vào là Cấu hình chung.

Cài đặt Wiki.js chung

Sau đó, chúng tôi sẽ phải cấu hình Kết nối MongoDB. Nếu quá trình cài đặt mà chúng tôi thực hiện trước đó đã chính xác, chúng tôi có thể nhấn nút «Kết nối«. Cửa sổ tiếp theo sẽ là Cấu hình đường dẫn. Ở đây họ khuyên bạn nên để nó bị lỗi để chúng tôi tiếp tục cài đặt.

Trên màn hình tiếp theo, chúng ta có thể thêm dữ liệu của tài khoản Git của chúng tôihoặc bỏ qua bước này.

Cấu hình Git trong Wiki.js

Bây giờ chúng ta sẽ phải tạo một tài khoản quản trị viên để đăng nhập sau.

cài đặt tài khoản quản trị trong Wiki.js

Sau màn hình này và một vài màn hình thiết lập khác, Wiki.js sẽ được cài đặt và sẵn sàng hoạt động.

Tạo trang chủ với Wiki.js

Cuối cùng chúng tôi sẽ phải đăng nhập. Chúng tôi sẽ sử dụng tài khoản quản trị viên mà chúng tôi đã tạo trước đó để tạo trang chủ của chúng tôi.

Trang đăng nhập Wiki.js

Và sau tất cả những điều này, chúng ta sẽ đến với trình chỉnh sửa. Đây là nơi chúng ta có thể bắt đầu tạo.

Biên tập viên Wiki.js

Đây chỉ là một cài đặt cơ bản. Đối với nhận thêm thông tin về nền tảng wiki này, về cài đặt, sử dụng hoặc để xem tài liệu chính thức, chúng tôi có thể truy cập trang dự án.


Để lại bình luận của bạn

địa chỉ email của bạn sẽ không được công bố. Các trường bắt buộc được đánh dấu bằng *

*

*

  1. Chịu trách nhiệm về dữ liệu: Miguel Ángel Gatón
  2. Mục đích của dữ liệu: Kiểm soát SPAM, quản lý bình luận.
  3. Hợp pháp: Sự đồng ý của bạn
  4. Truyền thông dữ liệu: Dữ liệu sẽ không được thông báo cho các bên thứ ba trừ khi có nghĩa vụ pháp lý.
  5. Lưu trữ dữ liệu: Cơ sở dữ liệu do Occentus Networks (EU) lưu trữ
  6. Quyền: Bất cứ lúc nào bạn có thể giới hạn, khôi phục và xóa thông tin của mình.