jenkins - Gitlab 和 HTML 文档

Question

我的开发环境由 Git 存储库、GitLab 存储库管理器和 Jenkins 组成。在构建过程中，使用 Doxygen 生成 HTML 格式的文档。

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

我是否应该将文档存储在单独的 wiki 中，并且只提交 GitLab 项目 wiki 的链接？

Answer 1

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

首先，Gitlab是哪个版本的你正在用吗 ？

如果只有您的开发人员可以访问(也就是这些是私有(private)文档)，那么在 Gitlab >= 8.1.2有一个服务叫 External Wiki这允许您替换 Wiki通过您选择的任何 URL 链接项目。只需设置一个为您的 html 文档提供服务的 Web 服务器，让您的构建服务器在每次构建后上传最新版本并收工。

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

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

希望这可以帮助 !