Antora顶级导航栏定制

Question

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

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

自生成网站以来，我应该在哪里更改或如何更改这些项目？我不想在那里列出这些物品。

Answer 1

还有一种方法不需要您创建独立的UI：supplemental_files

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

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

补充UI文件夹为UI提供替换文件，前提是它们与正在使用的UI显示在相同的结构中。

因此，要将header-content.hbs替换为默认UI，您将创建此文件夹结构：

supplemental-ui/
  partials/
    header-content.hbs

您可以通过探索Antora文档的repo来了解如何使用此工具：https://gitlab.com/antora/docs.antora.org

您可以以这种方式替换UI使用的任何文件，并添加新文件。您无法删除文件，但可以将其内容设为空。总而言之，这意味着您可以根据需要更改任何CSS，Javascript，部分，布局以及提供任何其他全局UI资源。

Answer 2

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

就像马特说的那样，你需要检查你的header-content.hbs车把。