如何覆盖 GitLab wiki 页面的标题？答案

【问题标题】：How can I override the title of a GitLab wiki page?如何覆盖 GitLab wiki 页面的标题？
【发布时间】：2018-12-27 09:31:53
【问题描述】：

我正在 GitLab 项目 wiki 中编辑页面。

如果我将页面命名为“first-last”，则 URL 为“project/wikis/first-last”，页面标题在句子中呈现为“First-last”。如果我将页面命名为“first-(last)”，则 URL 为“project/wikis/first-(last)”，并且页面标题在句子中呈现为“First(last)”。

我希望 URL 为“project/wikis/first-last”，页面标题为“First（last）”。因此，我想覆盖页面标题。

我的理解是 GitLab 项目 wiki 在 Gollum 上运行。 According to the Gollum docs 页面标题可以用以下两种方法之一覆盖：

启用--h1-title。页面上的第一个 H1 级标题将覆盖页面标题。
使用元数据指令。如果页面的第一行是，则给定的值将覆盖页面标题。

我无法访问选项 1。我尝试了选项 2，但没有任何反应。

如何覆盖 GitLab wiki 页面的标题？

【问题讨论】：

标签： gitlab wiki gollum-wiki

【解决方案1】：

据我所知，可能没有办法做到这一点。我还没有尝试使用那个咕噜标志。

GitLab 文档有 this section:

咕噜笔记

我们只使用 Gollum 作为存储抽象层，来处理 wiki 页面 slug 和存储库中文件之间的映射。

在渲染 wiki 页面时，我们根本不使用 Gollum，而是通过 custom Banzai pipeline。这增加了一些wiki-specific markup，例如Gollum 的[[link]] 语法。

由于我们没有使用 Gollum 的大部分功能，我们计划在某个时候完全放弃它。 See this epic供参考。

【讨论】：