[程序员的知识传承 ] 自建知识库 & wiki 文档 & 静态网站生成框架 推荐

初衷

准备打造专属于程序员个人特征知识库与 Wiki (知识库是自己看的,wiki 对对外展示用),之前一直用语雀作为主要文档管理工具(包括团队级文档)。

但随着量越来越大,并且想 DIY 的东西越来越多(比如在某些技术文档上加上 code 可运行的效果),而且有些知识文档属于团队业务机密的逻辑记录。

方案

于是准备把语雀知识库,使用 Node 导出 Markdown ,再通过自建文档库的方式+私有化部署,这样就不用受到服务商的任何限制了。

这里放出我搜集和对比过的部分技术选型(+A 表示实践体验还不错,其他感觉中规中矩,亦或是不符合我的使用场景)。 看看大家还有没有更好的技术选型推荐。 还有语雀导出工具试了好几个,在量比较大的情况下,导出流程特别容易失败。

自建知识库 & wiki 文档 技术选型

    ○ Docusaurus (基于 React 生态系统)
    ○ Docsify 
    ○ Gitbooks  (有限制)
○ Vitepress   ( A ,主题自定义,菜单全自动生成插件)
○ MkDocs    ( A ,搭配 Material for MkDocs 主题)
○ hugo    ( A ,搭配自定义主题 )

○ Jekyll  (纯文档库用)
○ Astro   (纯文档库用)
○ Hexo    (纯文档库用)
○ Pagic   (小众、静态站点生成,适合个人文档站点)
○ Docz 
○ confluence ( Wiki 文档管理平台,适合团队协作)
○ bisheng (阿里之前有开源项目用过,但不适用于我这种纯文档库)
○ dumi    (适用于 React 组件库)