Wiki搭建

简介

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

Github 上有一个开源项目就是这个,https://github.com/requarks/wiki。

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

部署

简单点,采用 Docker 部署。

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

sql 复制代码
create schema wiki collate utf8mb4_general_ci;

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

shell 复制代码
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 数据库。

sql 复制代码
create database wiki
    with owner postgres;

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

shell 复制代码
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 工具。

相关推荐
码事漫谈8 小时前
当公司不久后变成冒险者公会,我担心什么
后端
Csvn9 小时前
Nginx 负载均衡进阶与健康检查:哈希、keepalive 池与 DNS 自愈
后端·nginx
皮皮林55110 小时前
京东又开源一款新框架,用起来真优雅!
后端
学长毕设10 小时前
基于SpringBoot智慧养老服务平台设计与实现-附源码
java·spring boot·后端
行百里er13 小时前
【Spring Insight 技术分享】跨服务调用链路是怎么串起来的?
后端·spring·开源
火山引擎和TA的超级拍档们13 小时前
产品情报局 11 | AI 数据湖 LAS:打造大模型时代多模态数据底座
前端·后端
源动力技术栈13 小时前
C# 集合类型全览:从 List<T> 到 FrozenDictionary,配一组实测数据
后端
aleimu13 小时前
Windows 11 右键打开 Cmder 2.0:从找不到菜单到默认使用 Cmder
前端·人工智能·后端
货拉拉技术13 小时前
AI Agent 如何进入实时交易系统:货拉拉的三个实践与一套工程方法论
后端·架构·agent
我是谁的程序员13 小时前
iOS 性能分析在 Windows 上怎么做,用 KXBuild 的 kxdevice 替代 Instruments
后端·ios