Wiki.js的安裝和配置

基于NodeJS技術(shù)的開源項目Wiki.js，其界面簡潔美觀、權(quán)限管理靈活，支持多種編輯器、多種用戶驗證方式、多種備份存儲方式、多種搜索引擎，支持國際化、自定義主題(Theme)、流量分析等。更多功能正在開發(fā)中，相信不久即可用。

A modern, lightweight and powerful wiki app built on Node.js
The most powerful and extensible open source Wiki software

當(dāng)前版本：2.1.113
GitHub地址：Requarks wiki

支持的平臺

• Docker
• Heroku
• Linux
• macOS
• Windows
• 即將支持Kubernetes

支持的數(shù)據(jù)庫

• PostgreSQL 9.5 or later
• MySQL 8.0 or later
• MariaDB 10.2.7 or later
• MS SQL Server 2012 or later
• SQLite 3.9 or later

身份驗證方式

• Auth0
• Azure Active Directory
• Discord
• Dropbox
• GitHub
• GitLab
• Keycloak
• LDAP / Active Directory
• Local
• Okta
• SAML 2.0
• Slack
• ...

存儲方式

• Amazon S3
• Azure Blob Storage
• DigitalOcean Spaces
• Git
• Local File System
• SFTP
• ...

搜索引擎

• AWS CloudSearch
• Algolia
• Azure Search
• Database
• Elasticsearch
• ...

極簡的安裝

Node.js版本：10.12 or later

以Windows為例：

1. 下載Wiki.js
2. 解壓，進入根目錄，復(fù)制config.sample.yml，然后重命名為config.yml
3. 編輯config.yml

默認配置使用了PostgreSQL數(shù)據(jù)庫，如下：

db:
  type: postgres

  # PostgreSQL / MySQL / MariaDB / MS SQL Server only:
  host: localhost
  port: 5432
  user: wikijs
  pass: wikijsrocks
  db: wiki
  ssl: false

1. 安裝配置數(shù)據(jù)庫
2. 啟動Wiki.js

node server

1. 訪問Wiki.js完成安裝向?qū)?/li>

安裝成功登錄后即可創(chuàng)建您的HOME頁：

國際化

Wiki.js支持多語言，為啟用其他語言，點擊右上角Account圖標(biāo)，選擇Administration，進入Locale菜單，下載您要啟用的語言，然后啟用Multilingual Namespaces -> Active Namespaces:

在新建頁面時選擇Locale，即可為不同語言創(chuàng)建頁面。瀏覽wiki時，點擊右上角Language圖標(biāo)即可切換語言。

編輯wiki

頁面布局

目前只提供了一個主題，可以切換為Dark Mode；還不支持自定義模板，不能靈活的調(diào)整布局。

命名限制

以下路徑保留供系統(tǒng)使用，不能用于content。

Single-character pages
所有單字符路徑都保留用于訪問 Wiki 的各個部分：

• a: Administration Area
• e: Page Editor
• f: Assets Manager
• h: Page History
• i: Browse Page by ID
• p: User Profile
• s: Page Source
• t: Tags
• u: Upload Endpoint (API)
• w: Personal Wiki

IETF Language tags
下面格式的語言標(biāo)記保留用于指定區(qū)域命名空間：

• Two-letter language code (e.g. en, fr)
• Country specific locale code (e.g. en-us, fr-ca)

特殊單詞
路徑不能與下面的術(shù)語完全匹配，也不能成為路徑的第一部分。比如，register 或 register/test是無效的。

• browserconfig [.xml]
• css
• favicon [.ico]
• favicons
• fonts
• graphql
• healthz
• home (reserved for the root homepage)
• img
• js
• login
• logout
• manifest [.json]
• register
• svg

Markdown

最常用的編輯器是Markdown，Wiki.js支持全部的CommonMark specification和一些有用的擴展，提供常用語法工具欄。語法請參考官方Markdown文檔。

幾個例子：

代碼高亮

自定義圖片大小

![Image](/link/to/image.jpg =100x)
![Image](/link/to/image.jpg =x50)
![Image](/link/to/image.jpg =100%x)

給無序列表添加樣式

- Grid Item 1
- Grid Item 2
- Grid Item 3
{.grid-list}

---

- [Lorem ipsum dolor sit amet *Subtitle description here*](https://www.google.com)
- [Consectetur adipiscing elit *Another subtitle description here*](https://www.google.com)
- [Morbi vehicula aliquam *Third subtitle description here*](https://www.google.com)
{.links-list}

注意樣式間要添加分隔線。

任務(wù)列表

- [x] Checked task item
- [x] Another checked task item
- [ ] Unchecked task item

Emojis

:apple:

Can be also be used :fire: inline

權(quán)限管理

Wiki.js 擁有強大的權(quán)限系統(tǒng)，可以細粒度地控制用戶可見和可操作的內(nèi)容。

基于Permissions和Page Rules定義組權(quán)限，一個用戶可以屬于一個或多個組，可以靈活地限制用戶訪問的部分和執(zhí)行的操作。

Permissions

Page Rules