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 工具。

相关推荐
步行cgn18 分钟前
Spring Boot 项目打包部署详解
java·spring boot·后端
我的xiaodoujiao1 小时前
Django 基础知识详细图文教程 4-Django 视图定义与使用
开发语言·数据库·后端·测试工具·django·sqlite
Apifox1 小时前
Apifox 8 月更新|调试、权限与协作体验持续优化
前端·后端·测试
kyson_1 小时前
后端登录凭证设计:Session-Cookie、Redis-Token 与 JWT
后端
对象存储与RustFS1 小时前
RustFS 后台扫描器与自愈调参:五档速度、位腐检测周期与并发上限
后端·rust·开源
天天喝旺仔1 小时前
Docker 镜像瘦身实战:多阶段构建把体积缩小 90%
运维·后端·ci/cd·docker·云原生·容器·性能优化
Lost of 程序猿1 小时前
ASP.NET Core Saga 分布式事务深度实战:备件采购跨服务长流程,如何保证“要么全成,要么全回“
分布式·后端·asp.net
卷无止境1 小时前
Coding Agent 里的上下文 Compact,到底在压缩什么
后端·python
爱勇宝1 小时前
公司没给活干,却因为员工看手机把人开了:法院判赔11万元
前端·后端·程序员
2601_962071002 小时前
【Java EE】SpringBoot的创建与简单使用
spring boot·后端·java-ee