Gitlab和HTML文档

Question

我的开发环境包括Git存储库,GitLab存储库管理器和Jenkins.在构建过程中,使用HTML格式的Doxygen生成文档.

是否可以将该文档存储在GitLab项目的维基上？我知道Gollum不支持HTML,这是Gitlab的wiki引擎.由于HTML文件中指向其他HTML文件的内部链接,将HTML转换为Markdown并不令人满意.

我应该将文档存储在单独的wiki中,而只提交指向GitLab项目wiki的链接吗？

Answer 1

我想答案取决于您使用 HTML 文档的目的以及分发它的程度。

首先，Gitlab您使用的是哪个版本？

1. 如果仅供您的开发人员访问（也称为私人文档），那么有Gitlab >= 8.1.2一个名为的服务External Wiki允许您Wiki用您选择的任何 URL 替换项目的链接。只需设置一个为您的 html 文档提供服务的 Web 服务器，让您的构建服务器在每次构建后上传最新版本，然后就到此为止。

2. 如果您的文档是您想要进行版本控制和分发的代码，那么就这样做。

无论您选择 1. 还是 2.，将整个文档放在单独的git存储库中仍然是一个好主意，因为您可以免费获得压缩，并且使用 any来同步任何本地或远程目录git pull要好得多。rsync然后只需设置shell脚本或git hooks自动为您完成所有操作即可；在提交或构建时。

希望这可以帮助 ！