documentation-generation - Antora顶部导航栏定制

Question

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

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

既然网站已经生成，我应该在哪里更改，或者如何更改这些项目？我不想在那里列出这些项目。

Answer 1

还有一种不需要您创建独立 UI 的额外方法:supplemental_files
在您的剧本文件中，您可以指定:

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

补充 UI 文件夹提供 UI 的替换文件，前提是它们以与正在使用的 UI 相同的结构出现。

因此，要替换 header-content.hbs对于默认 UI，您将创建以下文件夹结构:

supplemental-ui/
  partials/
    header-content.hbs

您可以通过浏览 Antora 文档的存储库来了解如何使用此工具: https://gitlab.com/antora/docs.antora.org

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