商汇粹外网资源平台

搜索
查看: 3378|回复: 5

哪个开源的wiki系统比较好用?

[复制链接]

该用户从未签到

8

主题

25

帖子

103

积分

注册会员

Rank: 2

积分
103
发表于 2022-9-22 17:05:02 | 显示全部楼层 |阅读模式
要搭一个wiki系统,请教一下内行的朋友,目前哪个开源的wiki系统比较好用?
为什么没有人推荐mediawiki?mediawiki存在哪些问题?为什么维基百科使用的是它呢?
回复

使用道具 举报

该用户从未签到

5

主题

75

帖子

245

积分

中级会员

Rank: 3Rank: 3

积分
245
发表于 2022-9-22 17:41:42 | 显示全部楼层
给大家介绍一个开源项目:专门用来构建 wiki 平台,助你梳理知识点的 wiki.js

地址:https://github.com/requarks/wiki
它是一款轻量级、功能强大的 wiki 开源项目,拥有评论、Markdown 编辑器、图片上传、标签、全局搜索、协同编辑、编辑历史、用户管理、谷歌分析等功能,而且支持高度自定义。

用到的技术栈也不同于老旧的 wiki 系统,它采用了 Node.js、PostgreSQL、Vue.js、Docker 等技术。基于 Docker 实现的一键部署,颇有 WordPress 之风,不要太爽!

重点是支持中文,而且界面简洁还不失美感,这点足以让它在众多同类项目中脱颖而出。
看到这儿,你是不是手痒了呢?下面就和我一起来让它跑起来吧!
安装

开源项目成功的必要因素之一就是有详细易懂的文档,而安装说明又是重中之重。
Wiki.js 官方文档提供了多种部署方法,包括:Linux、macOS、Windows、Docker、k8s 等,涵盖了几乎所有可能性,十分全面。
下面我就介绍其中最快捷和通用的一种,即基于 Docker 的 Docker Compose 部署。

Tips:如果你不懂 Docker 建议跟着这里逐步执行
下面我将主要介绍 Linux 下的安装步骤,其它系统有桌面版不再赘述。
如果你机器上有 Docker 仅需两步即可完成安装。
第一步,安装 docker-compose:
1、下载
curl -L https://get.daocloud.io/docker/compose/releases/download/v2.4.1/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
2、加执行权限
$ sudo chmod +x /usr/local/bin/docker-compose
3、创建快捷方式
$ sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
至此,你就可以在任何地方使用 docker-compose 命令了。
第二步,运行 docker-compose:
1、创建配置文件 docker-compose.yml 内容如下:
整个项目分为 数据库项目代码 两部分,与之对应的是 pg 容器 和 wiki 容器。
version: "3"services:  db:    container_name: pg    image: postgres:11-alpine    environment:      POSTGRES_DB: wiki      POSTGRES_PASSWORD: wikijsrocks      POSTGRES_USER: wikijs    logging:      driver: "none"    restart: unless-stopped    volumes:      - db-data:/var/lib/postgresql/data  wiki:    container_name: 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:      - "8001:3000"volumes:  db-data:
2、在配置所在的目录下,执行命令:

  • 运行:docker-compose up -d
  • 查看容器:docker ps
  • 停止:docker-compose down

最后,如果你想开启 HTTPS 的话,我这里推荐用 Caddy 服务器。没用过没关系,我们写过介绍使用 Caddy 的文章特别简单。
Caddyfile 的配置内容如下:
8001 端口对应的是上面 wiki 容器的 ports 端口映射
域名 {    reverse_proxy 127.0.0.1:8001}
执行 caddy start 启动 Caddy 服务器,浏览器中访问对应的域名,网站初始化的引导界面,就会出现在你的面前了。

至此,以上就是 wiki.js 安装的全过程,你跑起来了吗?
瑕不掩瑜

Wiki.js 并不是十全十美的,虽然我只是刚上手,但还是发现了一些美中不足:

  • 第一次访问加载速度较慢
  • 虽然 wiki.js 更新积极、提交频繁,但目前它还不支持自定义主题
  • 对中文搜索不友好,默认不支持中文搜索,需要采用 ES 但这样就不再轻量,或者采用 pg 插件让 pg 支持中文分词
  • 中文翻译覆盖率并不像官网展示的 100%,管理后台里还是有未翻译的地方
但是瑕不掩瑜,它基本上实现了我对 wiki 想要的所有功能。而且总好过自己从头实现一个 wiki 系统吧,后面我会用 wiki.js 做一个新的网站:
https://cheatsheet.store/
等我玩顺手了搞通上面的问题就去给它提 PR 做贡献,期待更强大的 wiki.js!
最后

知识需要融会贯通。

知识本是杂乱无章的,需要通过实践经验,让它们建立联系,变得井然有序,才会得心应手,释放出强大的创造力。
最后,用 wiki.js 构建你的知识网络,梳理已有的知识不断推陈出新,让它在你寻求更高突破的路上,助你一臂之力!
更多讲解开源项目的文章尽在:



HelloGitHub 想让更多人爱上编程、开源,所以一直在尝试、摸索如何可以帮助到更多的人。目前 HelloGitHub 交流群已全面开放,关注 HelloGitHub,添加:HelloGitHub 为好友入群,可同 CC++JavaGoPython、前端机器学习等各界大佬谈笑风生、切磋技术~ 还有大学生开源技术群,叫上你的小伙伴一起感受开源的乐趣吧!
HelloGitHub 分享 GitHub 上有趣、入门级的开源项目,找开源就上 HelloGitHub。
回复

使用道具 举报

该用户从未签到

10

主题

30

帖子

97

积分

注册会员

Rank: 2

积分
97
发表于 2022-9-22 18:18:22 | 显示全部楼层
WikiMatrix - Compare them all
WIKI 的一个 横向对比网站,建议根据自己需求比较下。。
使用过redmine自带的wiki , mediawiki ,如果是技术团队考虑下
dokuwiki [DokuWiki]
回复

使用道具 举报

该用户从未签到

10

主题

50

帖子

151

积分

注册会员

Rank: 2

积分
151
发表于 2022-9-22 18:55:02 | 显示全部楼层
通过 GitBook 开源框架私有化部署 Wiki 文档,公司内部用这个方案很久了,界面也还挺好看,仓库托管在 GitHub 上,自然也支持 GitHub 本身的各种特性,多人协作、版本控制、Markdown 写作、通过几行代码就能实现实时更新。借助于成熟的 GitBook 框架环境搭建起来还算容易。
大致实现方案就是:文档仓库托管在 GitHub 上,仓库里面包含了 GitBook 框架,找一台 Node.js 服务器,敲几句命令就可以部署完毕,十分钟内应该能搞定。
可以先给大家看下效果:
效果一:Material Design 中文版(有侧边栏菜单)http://zitiao.org/material-design/


效果二:GitBook Help Center(无侧边栏菜单)https://help.gitbook.com/


下面简单的说下步骤:
1、Fork 示例项目 https://github.com/zitiaocn/simple
项目结构:
- images 用于存放图片
- README.md 关于文档,在 SUMMARY.md 进行配置
- SUMMARY.md 文档目录
- book.json 文档框架,最核心的文件
- deploy.md 一个示例文档,可以删除
最主要的文件有 SUMMARY.md 和 book.json 文件,需要做一些修改。
2、修改 SUMMARY.md 和 book.json 文件
3、撰写文档:不会 Git 也没关系,直接在 GitHub 网页上在线写也行。
4、在服务器上部署项目,没有服务器在自己的电脑上部署也行。
5、通过在 GitHub 的仓库上配置 webhook 就能够实现实时更新,还是挺方便的。
详细的操作文档在下面(撰写加演示写了一下午):
通过 GitBook 开源框架和 GitHub 私有化部署 Wiki 文档
回复

使用道具 举报

该用户从未签到

3

主题

56

帖子

194

积分

注册会员

Rank: 2

积分
194
发表于 2022-9-22 19:31:42 | 显示全部楼层
11款Wiki系统整理分享,除了免费开源的WIKI系统,还有知识库系统。
可能有些人会认为wiki系统和内部知识库是一回事,但实际上它们是截然不同的软件类型,有时候大多数人找的是知识库软件而不是 wiki 软件。   但无论是哪种,都是为了提高企业的知识管理能力。

在正式开始之前,想先聊聊关于免费和开源:
一般情况下,其实我不太建议用免费的企业管理软件,是因为:
(1)市场上大多免费的WIKI软件对数据安全无法提供保障;
(2)另外那些完全免费的WIKI工具功能相对比较简单,技术也比较低端,是比较难满足企业的需求;
(3)你使用免费的WIKI软件,就基本上享受不到售后服务,一旦遇到紧急问题,比如数据丢失或误删,是不会有人来帮助你的,我自己就经历过这样的事。而如果你是付费的,让工具方帮你找回数据则是你的权利。
(4)国内付费的WIKI系统通常也并不贵,对比国外来说通常价格仅有30-40%,小团队一年也就几万块钱的成本。
使用开源将给团队带来的风险和受益
这是一个比较大的话题,大家可以通过以下文章进行详细了解:《开源Wiki系统给企业带来的风险与收益》
1、团队知识库:PingCode Wiki

官网:PingCode
PingCode Wiki 是一款团队知识库系统,被广泛用于团队文档协作、搭建团队知识库、产品手册、帮助中心、FAQ、Guide、产品介绍、开发文档、在线手册,并发布到网站上。
这也是我们团队在使用的知识库,它能够通过结构化沉淀高价值信息,形成完整的知识体系。
此外,明确的内容分类,层级式的页面树,还能够轻松提升知识的流转和传播效率,更好地成就组织和个人。

主要功能:

  • 多人实时协同编辑
  • 页面级的全下管控
  • 团队间的文档共享
  • 打造部门、团队、项目知识库,沉淀知识资产
  • 将整个知识库对外分享
  • 将文档与需求、缺陷、测试等任务关联
购买方案:支持私有部署、二次定制开发、saas等版本,25人以下免费。(PingCode 官网)


2、免费开源 Wiki系统:MediaWiki

官网: https://www.mediawiki.org/wiki/MediaWiki
下载: https://www.mediawiki.org/wiki/Special:MyLanguage/Download
MediaWiki 是使用 PHP 编写的免费开源 Wiki 软件包。它是 Wikipedia 和其他 Wikimedia 项目的平台,每月有成千上万人使用。缺陷可能就是国内使用会存在翻墙,无产品服务等问题。

3、开源免费Wiki系统:DokuWiki

官网: https://www.dokuwiki.org
下载: https://download.dokuwiki.org
开源免费,轻量级百科系统不需要数据库即可运行,我个人搭建的wiki就是选用的这个,总的来说需要的功能都有,模板和插件很多,最大的问题是中文资料比较少(这个我后续会将根据亲身经历写点教程),官网下载速度也有点慢。对了,下载的时候最好把“更新”插件一起下载这样后续更新就方便很多。

4、文档管理系统:MinDoc

官网: https://www.iminho.me
开源: https://github.com/lifei6671/mindoc
开源免费,官方介绍是“一款针对IT团队开发的简单好用的文档管理系统”,虽然小编没用过但是维护这么久的项目料想不会差。

5、在线文档管理系统:BookStack

官网: https://www.bookstack.cn/
开源: https://github.com/TruthHun/BookStack
开源免费,适合搭建文库,基于MinDoc,使用Beego开发的在线文档管理系统,功能类似Gitbook和看云。

6、amWiki

官网: http://amwiki.org
开源: https://github.com/tevinli/amWiki
开源免费的轻量级前端化文库系统。

7、轻量级文档网站:docsify

官网: https://docsify.js.org
开源: https://github.com/docsifyjs/docsify
免费开源,轻量级文档网站,界面简洁优雅,目前很多开源项目的文档都选用这个系统搭建,这里需要注意的是这个是单文档,不是那种大型wiki系统。

8、Wikitten

开源: https://github.com/devaneando/Wikitten
演示: https://wikitten.vizuina.com
开源免费,适合做小型wiki,界面非常简单。

9、文档管理系统:Docute

官网: https://docute.org
开源: https://github.com/egoist/docute
开源免费,恐怕没有比它更简单的文档界面了,很适合做产品的开发文档
“Docute 本质上就是一个 JavaScript 文件,它可以获取 Markdown 文件并将它们呈现为单页面应用。”——转自官方介绍

10、Wikitten and MDwiki

开源: https://github.com/zohead/wikitten-and-mdwiki
演示站: https://zohead.com
开源免费,正如名字,这是一款整合 Wikitten 和 MDwiki 的文档系统,开发者用来当作博客系统。

11、WordBook

官网: http://www.2zzt.com/bokezhuti/8938.html
演示: WordBook 更方便的文档写作
这是一款免费 Wordpress 主题,适合文档写作,不过下载估计有点麻烦。

以上就关于开源免费的Wiki系统盘点的介绍,希望对你有所帮助。
什么是企业 Wiki

通过鼓励、发动组织成员参与协作、共享与创新,企业Wiki旨在整合企业组织内部的信息孤岛,提高企业知识管理能力,提升企业信息化程度,从而为企业在知识经济时代的可持续发展打下坚实基础。
任何公司员工只要有权访问 Web 浏览器,就可以创建和编辑公司 wiki 的内容。这种类型的内容创作系统与公司博客的不同之处在于,公司 wiki 没有固有的结构,并且内容也是员工自己随意创建的。
企业wiki 的目的是内部员工众包内容,关键就是员工间的协作,这样做可以让员工分享知识,能够提高公司整体的显性知识隐性知识
什么是内部知识库

与 wiki 一样,知识库软件也旨在储存和管理重要信息,而且内部知识库软件也仅限于公司内部人员使用。它们的主要区别在于内部知识库的内容是由特定的人员做的,不是公司的每个人都可以随意编辑。


部分内容整理自: https://zhuanlan.zhihu.com/p/332458032
回复

使用道具 举报

该用户从未签到

11

主题

93

帖子

291

积分

中级会员

Rank: 3Rank: 3

积分
291
发表于 2022-9-22 20:08:22 | 显示全部楼层
dokuwiki,唯一选择。。。
最方便,最绿色,功能最强大,速度最快,用了3年了。。。

  • 只要能运行php的就能用,不需要数据库。
  • 自己用,不在意安全性的问题的话,把文件夹压缩成zip包,直接迁移。
  • 以前的老毛病,什么不能删缓存旧版本了,现在都有插件解决了。
  • 换行别扭也有插件解决了,用起来跟论坛,跟知呼一模一样。
  • 模版文件很少,简单修改一下,不用太花哨,主要是资料记载。
  • 记录密码,可以用插件进行加密,需要看到的话,需要登录,需要看密码的钥匙。嘿嘿。。
  • H1~H6,定制一下,非常清晰。。。
  • 代码高亮足够漂亮,还有更漂亮的console插件,你敢去看看么?

别无选择。。。
我就贴一张图馋馋你们。。。
回复

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

快速回复 返回顶部 返回列表