Wiki搭建

0 阅读2分钟

简介

Wiki 是一款支持多人在线编辑、保留历史版本、页面间可自由链接跳转的协作知识创作平台。

Github 上有一个开源项目就是这个,github.com/requarks/wi…

本文介绍如何在本地搭建一个这样的平台。

部署

简单点,采用 Docker 部署。

wiki 需要有数据库支持,如果你本地有 MySQL,敲下面的命令,创建一个 wiki 数据库。

create schema wiki collate utf8mb4_general_ci;

接着敲下面这行命令,拉镜像,并启动容器,注意数据库账号、密码更换成自己的。

docker run -d -p 8080:3000 --name wiki --restart unless-stopped -e "DB_TYPE=mysql" -e "DB_HOST=host.docker.internal" -e "DB_PORT=3306" -e "DB_USER=root" -e "DB_PASS=123456" -e "DB_NAME=wiki" ghcr.io/requarks/wiki:2

如果本地有 PostgreSQL,敲下面的命令创建一个 wiki 数据库。

create database wiki
    with owner postgres;

接着敲下面这行命令,注意数据库账号、密码更换成自己的。

docker run -d -p 8080:3000 --name wiki --restart unless-stopped -e "DB_TYPE=mysql" -e "DB_HOST=host.docker.internal" -e "DB_PORT=3306" -e "DB_USER=root" -e "DB_PASS=123456" -e "DB_NAME=wiki" ghcr.io/requarks/wiki:2

如下,跑起来了。

在这里插入图片描述

看下容器日志,Nothing,无事发生,没有消息就是消息。

在这里插入图片描述

使用

登录浏览器,访问 http://localhost:8080,如下,进入首次登录设置页面

在这里插入图片描述

填完,点 INSTALL 安装

在这里插入图片描述

进入登录页面,使用前面设置的管理员账户登录(该说不说,登录界面有格调)

在这里插入图片描述

登录成功,CREATE HOME PAGE(创作主页)、ADMINISTRATION (控制台)

在这里插入图片描述

先进入控制台,设置语言为简体中文(Chinese Simplified)

在这里插入图片描述

舒服了

在这里插入图片描述

回到主页,这回点 创建首页

在这里插入图片描述

这里可以选多种编辑器,我这里选 Markdown

在这里插入图片描述

随笔写点,点 OK

在这里插入图片描述

随便写点内容,点 创建

在这里插入图片描述

好了

在这里插入图片描述

其他人访问该页面是这样(看起来还不错)

在这里插入图片描述

新增编辑用户,可以在下面这里设置

在这里插入图片描述

组权限在下面这里设置

在这里插入图片描述

锐评

搭建完了,博主锐评一波

先说优点:

  • github 上 starts 数量最多,社区活跃,问题少;

  • 界面简洁优雅,所见即所得,大道至简,程序员会很喜欢;

  • Markdown 页面,打印出来的效果非常好;

  • 功能齐全,有用户/组/操作权限设置,多而不繁杂,刚刚好;

  • 附带功能多,除了页面还有标签、主题、存储和支持 API 访问;

缺点也有:

  • 菜单汉化(国际化)不彻底,左侧菜单翻译过来了,右侧一些小菜单没有翻译;

  • 页面分享的社区,大多是国外的软件,国内软件仅支持微博;

总结来说,瑕不掩瑜,非常 Nice 的 wiki 工具。