幾分鐘內使用 Wiki.js 設定您自己的 Wiki 的快速指南

幾分鐘內使用 Wiki.js 設定您自己的 Wiki 的快速指南

Wiki.js 是一款基於 Node.js 框架設計的功能豐富的開源 Wiki 應用程式。它提供豐富的編輯體驗,支援 Markdown 和所見即所得 (WYSIWYG) 介面。此外,它還支援即時協作、版本控制以及多種身份驗證方法,包括 Google 和 LDAP 整合。本指南將引導您完成使用 Docker 設定 Wiki.js 的必要步驟,讓您只需幾分鐘即可部署自己的 Wiki。

透過 Docker Compose 設定 Wiki.js

使用 Docker 和 Docker Compose 設定 Wiki.js 的過程非常簡單。首先建立一個名為 的新目錄wikijs-docker並導航到該目錄:

mkdir wikijs-docker && cd wikijs-docker

docker-compose.yml接下來,使用您喜歡的文字編輯器建立一個名為的檔案:

nano docker-compose.yml

然後,將以下配置插入到文件中:

services: db: image: postgres:16 environment: POSTGRES_DB: wiki POSTGRES_PASSWORD: wikijsrocks POSTGRES_USER: wikijs restart: unless-stopped volumes: - db-data:/var/lib/postgresql/data wiki: image: ghcr.io/requarks/wiki:2 depends_on: - db environment: DB_TYPE: postgres DB_HOST: db DB_PORT: 5432 DB_USER: wikijs DB_PASS: wikijsrocks DB_NAME: wiki restart: unless-stopped ports: - "80:3000" volumes: db-data:

儲存並關閉檔案後,執行以下命令啟動容器:

docker compose up -d

運行 Docker 容器

安裝過程完成後,在 Web 瀏覽器中導覽至http://localhost。在這裡,您需要提供管理員帳戶詳細信息,然後選擇“安裝”按鈕開始安裝:

開始安裝 Wiki.js

完成安裝後,使用您的憑證登入。

在 Wiki.js 中建立和管理頁面

初始設定完成後,您可以建立主頁以開始填充內容或存取管理面板來管理設定、使用者和可用功能:

歡迎頁面 Wiki.js

透過點擊「建立主頁」選項,系統將提示您選擇適合您偏好設定的編輯器:

選擇編輯器

接下來,定義頁面的屬性並點擊「確定」按鈕繼續建立新頁面:

設定頁面屬性

編寫您想要的內容並點擊“建立”按鈕以完成頁面建立:

建立頁面 Wiki.js

管理和組織內容

您的儀表板提供了一種便捷的方式,讓您可以查看和修改現有頁面,以及使用您選擇的編輯器建立新頁面。您可以透過重新命名、移動或刪除頁面來組織內容,並使用標籤進行有效分類。此外,側邊欄和搜尋功能可以加快您 wiki 中特定頁面的導航速度:

Wiki.js 儀表板

配置 Wiki.js 站點設置

在 Wiki.js 管理面板中,您可以靈活地配置網站設置,例如語言環境、導航結構、主題和標籤。這些設定在定義 Wiki.js 實例的整體配置中起著至關重要的作用。

在「常規」標籤下,您可以調整基本網站設置,包括網站標題、描述、預設主頁和可見性設定(公開或私人):

常規設定

切換到「區域設定」標籤以指定網站的預設語言、時區和日期/時間格式:

設定區域

若要管理您的 wiki 的選單結構並增強使用者導航,請造訪導航列部分:

管理網站導航

「頁面」標籤中,您可以監督、編輯和組織所有 wiki 頁面、建立新頁面以及管理內容的層次結構:

管理頁面

此外,在「標籤」標籤下,您可以建立和管理內容標籤,從而增強頁面的可搜尋性。您也可以透過「主題」標籤自訂wiki的美觀元素,例如變更網站標誌、顏色、字體和版面樣式。

管理主題

管理 Wiki 中的群組

「群組」部分可讓您建立使用者群組、指定成員並設定群組層級的權限來規範存取權限。這種組織方法有助於簡化使用者角色,並在整個 Wiki 中保持一致的存取權管理。

團體

點擊特定群組即可存取該群組的設定、權限、頁面規則以及使用者管理。透過「設定」選項卡,您可以調整選項,包括登入重新導向 URL。

編輯群組設定

您也可以瀏覽「權限」「頁面規則」「使用者」部分,以最佳化群組可以存取的內容並相應地指派使用者。

Wiki.js 中的使用者管理

若要新增用戶,請前往「用戶」部分,按一下「新用戶」按鈕,然後填寫必填欄位。

完成後,選擇“建立”“建立並關閉”以完成新使用者設定:

創建用戶

選擇特定使用者可讓您查看和編輯他們的個人資料,分配使用者群組,定義身份驗證方法(如密碼或雙重認證),以及使用諸如停用驗證刪除之類的操作管理他們的狀態:

使用者創建

此外,您還可以更新他們的基本資訊、擴展元資料(包括位置和職位),並查看他們的活動歷史記錄:

編輯使用者

管理您的 Wiki 模組

模組是增強 Wiki.js 功能的增強功能。例如,Analytics模組可讓您整合 Google Analytics 等工具來追蹤用戶參與度和流量指標:

添加分析

利用「驗證」標籤建立和管理身分驗證提供者(本機登入、LDAP、OAuth)以及設定各種登入選項:

配置身份驗證設定

您也可以開啟或關閉評論系統並確定使用者如何參與頁面討論:

將討論加入 Wiki

系統配置

透過配置渲染引擎、搜尋索引和儲存設置,管理內容的渲染、搜尋索引和儲存方式。例如,存取「渲染」標籤來自訂內容渲染,例如調整 Markdown 引擎設定或啟用對圖表和數學表達式的支援:

配置頁面渲染

搜尋引擎部分,您可以管理內部搜尋索引選項和第三方搜尋引擎整合:

配置搜尋引擎

儲存部分中,指定內容的備份和同步目標,使您能夠管理媒體和頁面附件的儲存位置和方式(例如在本機檔案系統或 AWS S3 上):

管理安全性和連接性

您可以透過設定 API 存取、設定電子郵件通知、調整安全性原則以及啟用 SSL 來保護 Wiki.js 執行個體的安全,以獲得安全體驗。例如,處理API 令牌以將 Wiki.js 與其他應用程式整合:

管理 API 金鑰

設定電子郵件設定以管理 Wiki.js 中的通知、邀請和密碼復原流程:

配置郵件設定

安全性設定也可以微調,涵蓋會話逾時、密碼策略和存取限制等面向:

配置安全設定

此外,您可以設定SSL/TLS憑證以確保您的 Wiki.js 實例透過 HTTPS 安全地運作:

管理 SSL/TLS 憑證

此外,從系統資訊部分驗證您的 Wiki 訊息,例如係統診斷、伺服器規格和運行時環境統計資訊:

驗證系統訊息

從「實用程式」標籤執行維護活動,例如重新索引搜尋結果、清除快取資料或重置配置:

管理實用程式

最後,開發者工具提供進階資源,如 GraphQL 遊樂場、日誌偵錯功能或自訂腳本整合:

管理開發工具

現在您已經掌握了使用 Docker 設定 Wiki.js 的知識,您可以自信地使用此平台輕鬆建立內部文件、協作團隊 wiki 或公共知識庫。

來源和圖片

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *