GitLab页面:可以从项目wiki生成静态网站吗



所以我知道GitLab页面可以用来从项目的存储库生成静态网站。然而,我想做的是从项目的wiki生成一个静态网站,这是一个单独的存储库。

我还知道,我可以将静态站点生成器挂接到webhook事件,以通知wiki的更改。我正在努力弄清楚,这个明显的(对我来说)用例是否是通过GitLab的页面功能(它的设置更简单)预期并实现的,或者我是否真的需要求助于webhook。

据我所知,事实并非如此,我确实如此,但可能有一些方法在我能找到的任何地方都没有得到很好的描述。

最后:我想这么做的原因是,GitLab的wiki似乎有一个定制的UI,使其工作起来更像wiki,而不是存储库的UI。我希望这将使它对我预计使用它的潜在非技术用户更有用/更少的敌意

我认为这个功能还不可用,尽管它肯定非常有用。

您可以尝试以下解决方法:

将项目wiki的存储库设置为外部存储库
https://docs.gitlab.com/ee/ci/ci_cd_for_external_repos/

这将设置存储库镜像,允许自动将更新从wiki存储库拉到新的常规GitLab项目存储库。然后,您可以使用常规的GitLab CI和GitLab Pages功能从wiki生成静态网站。

有关存储库镜像的详细信息:https://docs.gitlab.com/ee/workflow/repository_mirroring.html


示例项目(编辑)

我现在已经做了一个基本的(开源)例子,它实际上运行得很好,你可以浏览它的源代码,并在https://gitlab.com/tkainrad/wiki2docs.
生成的站点位于https://tkainrad.gitlab.io/wiki2docs

你甚至可能会发现,在你的Wiki和实际的实时网站之间有一层是有用的。

这种解决方法与GitLab Pages一起提供了很多可能性,并实现了wiki或文档网站的完全免费托管,同时为非技术贡献者维护了一个简单的EDIT界面。

最新更新