Variant
Variant 也是 GitBook 中一个很重要的概念,相当于 GitHub 仓库中的分支,是一个 space 的不同版本。什么情况下需要用到 variant 呢?举个例子,比如你开发了一个中间件,写了这个中间件的文档。随着中间件版本的不断迭代,文档也应该随之更新,但是老版本的文档怎么办呢?肯定不能覆盖,因为可能有人在用你的老版本的中间件,这些人需要看老版本的文档,所以这个时候可以基于老版本文档创建 variant,然后在 variant 上修改文档,老版本的文档保持不变。每发布一个新版本的中间件,就创建一个相应的 variant,这样既不会对老用户产生影响,也可以更新文档。
再比如,如果你的文档有多个语言版本,也可以针对每种语言创建 variant。
以上便是 GitBook 的入门教程,掌握了这些,你就可以将 GitBook 用起来了。除了这些,GitBook 还支持对文档添加评论、将文档导出为 PDF 文件、在页面中嵌入视频、外部文章等功能,这些在官方文档中都有介绍,你可以边使用边探索,这也是一种乐趣。
同时,GitBook 还有强大的团队协作功能,但是我现在还没有用过,等我亲身体验过以后,会放到在此更新。
最后更新于
这有帮助吗?