之前介绍过几款搭建开源项目文档的工具，有Docsify、VuePress和Hexo这些工具有个共同点，需要一些开发部署的工作，部署基本依赖Github Pages或者自建服务器那么有没有那种

 

之前介绍过几款搭建开源项目文档的工具，有Docsify、VuePress和Hexo这些工具有个共同点，需要一些开发部署的工作，部署基本依赖Github Pages或者自建服务器那么有没有那种开箱即用的工具呢，最近发现很多开源项目都用。

语雀来搭建文档网站，体验了一把，非常不错，推荐给大家！语雀简介语雀是新一代的云端知识库，可以写出像书一样的项目文档，拥有专业好用的编辑器（支持Markdown转换），方便的团队协同功能主要使用场景如下：。

个人笔记：语雀知识库具有公开私有功能，私有的知识库完全可以当在线云笔记使用，可以方便我们记录点滴，沉淀知识专栏博客：如果你不想自己搭建博客网站的话，可以直接生成项目文档：可以多人协作的项目文档，你见过没？。

官方文档：可以作为产品说明和帮助手册。效果展示我们先来看下成品效果，开箱即用，界面还是挺不错的！

核心概念在使用语雀之前，我们需要对其中的概念有所了解。下面介绍下这些核心概念，然后再展示下对应的界面。首先我们来看下各个核心概念的关系图，这对理解这些概念很有帮助：

空间：空间类似于公司或组织的概念，在空间中我们可以管理团队、知识库、知识等内容。

团队：空间下的团队可以和你实际组织结构进行挂钩，如部门团队，项目组等。

知识库：知识库是知识内容的载体，就好比一本书一样，你可以在知识库里对知识内容进行重新组织和分类。

知识：知识库中的内容，可以是文档。

搭建接下来我们使用语雀来搭建一个开源项目文档，以我的开源电商项目mall为例。快速搭建首先我们点击左上角创建空间，用于存放团队和知识库；

然后选择创建知识库，由于我们的知识库主要用于存放文档，所以选择文档知识库，然后输入名称、简介即可；

创建完知识库之后，我们就可以在知识库中添加文档了，直接复制之前使用Markdown写的文档即可，然后点击右上角的立即转换；

转换成功后显示效果如下，是不是比自己搭建项目文档网站简单多了？

这里值得一提的是，在我们复制文章时，语雀会自动帮我们上传在线图片，很多博客网站也都有这个功能；

如果你想修改知识库的文档目录的话，比如我想整个二级目录，可以使用编排目录功能；

自定义首页其实到这里，我们已经学会了如何制作一个开源项目文档网站了，但是此时文档网站的首页只是一个目录，这样未免有些单调，如果我们想要首页内容更丰富些，我就需要创建团队，然后自定义团队的首页即可；首先我们来创建个团队，选择

官方文档模板；

然后填写名称、简介、头像即可；

然后我们可以通过自定义首页功能，使用图形化界面来完成一个首页，下面是我已经完成好的首页效果；

这里我添加了搜索、知识库、自定义内容三个模块，如果你想首页更丰富些，可以添加更多模块试试；

这里最好在你的知识库的设置页，把你的知识库转移到创建的团队中去；

接下来访问你的团队主页，一个标准的开源项目文档网站就诞生了。

公开访问如果你想搭建一个私有的文档网站的话，上面的操作基本能满足需求了，但如果你想搭建一个公开的文档网站的话，还需要如下操作很遗憾的是，在新建空间中的无论团队还是知识库，都是没法设置让互联网上的所有人访问的，仅支持如下三种访问权限；。

要想团队可以公开访问，我们需要在默认的个人空间中，创建知识小组，可以选择官方文档模板；

此时我们可以发现，团队的可见范围变成了互联网可见，这才是真正公开的团队；

之后要做的就是把之前的知识库通过导入、导出功能转移到该团队中去，导出功能在知识库设置->高级设置中，选择导出为.lakebook格式；

然后在该知识小组中创建知识库，设置范围为互联网可见，并导入.lakebook文件；

之后再按照之前的步骤自定义知识小组的首页，一个可以公开访问的开源项目文档网站就诞生了！

总结通过使用语雀搭建开源项目文档的一波实践，我们可以发现这种方式确实比使用Docsify来自建网站简单太多了，既不需要编码，也不需要买服务器怪不得很多开源项目都用它来搭建文档网站，当然语雀的功能还不只这些，用来做在线云笔记也挺好用的，如果大家感兴趣的话，可以自己探索下！。

官方网站https://www.yuque.com/推荐Github掘金计划 ：历史优质原创汇总！用心发掘 Github 和 Gitee 上优质的开源项目编程基础 ：精选编程基础如学习路线、编程语言相关的开源项目。

计算机基础：精选计算机基础（操作系统、计算机网络、算法、数据结构）相关的开源项目技术面试 ：精选技术面试相关的开源项目项目实战 ：精选实战类型的开源项目神器工具&网站 : 一些好用的插件、软件、网站Github掘金计划由3位Github爱好者维护

用心发掘 Github 和 Gitee 上优质的开源项目。后台回复 「PDF」 获取 计算机必读书籍欢迎关注 「Github掘金计划」

免责声明：本站所有信息均搜集自互联网，并不代表本站观点，本站不对其真实合法性负责。如有信息侵犯了您的权益，请告知，本站将立刻处理。联系QQ：1640731186