Antora顶部导航栏自定义

Question

我的问题很简单，但我在文档中找不到任何相关的内容。

我正在使用Antora中的默认生成器为项目生成文档，但我无法弄清楚如何自定义顶部导航栏右侧的条目，因为它们有一些默认值。

由于该站点是生成的，我应该在哪里更改这些项，或者如何更改这些项？我不想在那里列出这些项目。

- Germán Diago

---

在我看来，顶级导航由header-content.hbs中的antora-ui-default控制 - 因此，您需要创建自己的antora-ui项目。 - Matt Whetton

Answer 1

有一种不需要创建独立的用户界面的额外方法：supplemental_files

在你的playbook文件中，你可以指定：

...
ui:
  supplemental_files: <path to supplemental UI folder>
...

补充UI文件夹提供了与正在使用的UI具有相同结构的UI替换文件。

因此，要替换默认UI的header-content.hbs文件，您需要创建以下文件夹结构：

supplemental-ui/
  partials/
    header-content.hbs

您可以通过浏览 Antora 文档 repo 来了解此功能的使用情况：https://gitlab.com/antora/docs.antora.org 您可以以这种方式替换 UI 使用的任何文件，并添加新文件。您无法删除文件，但可以使其内容为空。总体而言，这意味着您可以更改任何 CSS、Javascript、partials、layouts，并根据需要提供任何其他全局 UI 资产。

- eskwayrd

Answer 2

是的，你需要构建自己的用户界面。相关文档可以在这里找到：https://docs.antora.org/antora-ui-default/

就像Matt所说的那样，你需要检查你的header-content.hbs handlebars文件。

- Christoph Safferling