gitlab编写html,Gitlab and HTML documentation

最新推荐文章于 2024-06-11 16:32:20 发布

林葭音

最新推荐文章于 2024-06-11 16:32:20 发布

阅读量233

点赞数

文章标签： gitlab编写html

本文探讨了如何在GitLab中管理由Doxygen生成的HTML格式文档。提供了通过使用GitLab的External Wiki特性或单独的Git仓库来托管这些文档的方法。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

问题

My development environment consists of Git repository, GitLab repository manager and Jenkins. During build process a documentation is generated with Doxygen in HTML format.

Is it possible to store that documentation on GitLab project's wiki? I know that HTML is not supported in Gollum, which is the Gitlab's wiki engine. Converting HTML to Markdown is not satisfactory because of internal links in HTML files that point to other HTML files.

Should I store documentation in a separate wiki instead and only commit a link to GitLab project wiki?

回答1:

I guess the answer depends on what you use your HTML documentation for and how much you distribute it.

First of all, which version of Gitlab are you using ?

If it is only for your developers to get access to (aka these are private documents), then on Gitlab >= 8.1.2 there is a service called External Wiki that allows you to substitute the Wiki link of the project by any URL of your choice. Just set up a web server serving your html documentation, have your build server upload the newest version after each build and call it a day.

If your documentation is a code that you want to version control and distribute, then do so.

Whether you go for 1. or 2., it is still a good idea to have a the whole documentation in a separate git repository, because you get compression for free and using git pull is much better than using any rsync to synchronise any local or remote directories. Then is just a matter of setting up shell script or git hooks to automatically do all of it for you; either at commit or build time.

Hope this helps !

来源：https://stackoverflow.com/questions/29966292/gitlab-and-html-documentation