背景
公司内部需要一个完整的平台归档开发和技术文档,甚至分享和一些需求调研,产品调研等需求。
本身已经有使用文档系统,但是文档系统实际上在目前公司内部并不合适。wiki 相对更能刺激创作和分享的欲望,这也是搭建平台的初衷。 文档和wiki 的区别
要求
需求程度从高到低
- 简单易用,即开即用
- 可私有化搭建
- 多种编辑方式,HTML富文本/MD/UML 支持 等,可以链接禅道
- 对Code ,图片等支持良好,
- 版本管理页面分享
- 完善的交互功能(评论,点赞等)
- 协助文档
- 开源免费
调研
MediaWiki
DEMO/官网(需带梯)
维基百科使用的wiki 系统,需要重新熟悉语言,
整体来说,插件丰富,支持MD(但是不是很好),支持PlantUML,适合公司内大部分人使用
完整的站内搜索功能和条目内联
页面过于复杂,整体也显得很臃肿
amWiki
DEMO 官网
全部由MD 组成,能否支持富媒体还待验证
整个系统整体干净整洁,但是由于基于MD ,整体功能不丰富,且不支持PlantUML等扩展
DokuWiki
DEMO/官网
个人感官是轻量级的MediaWiki 依然使用的是Wiki 的语法,MD 和 UML 需要插件支持,
页面更加干净整洁
ezWiki
官网
(待调研)
Wiki.js
一些付费的Wiki 系统
Obsidian
官网
同样是基于MD 系统和语言,个人免费,界面更加新颖,付费价格也不太高,更详细的内容没有尝试
相对较新的Wiki系统,说是Wiki 实际他更标榜的是一个笔记类型的知识体系的系统
confluence
官网
由Atlassian 开发提供的系统,同公司下的系统有JIRA 和常用的Sourcetree
功能丰富,插件和支持也很丰富,在编辑过程中有完整的批注,评论等交互功能。
支持丰富的图标。
但是,产品价格贵,MD 支持不是很好,更别说一些UML 等功能,整体偏向于产品文档等交流,可用作产品文档,但是对于开发者习惯方面的偏向并不友好。