Antora Navigation Builder
The Navigation Builder is a component in Antora responsible for building a navigation catalog sourced from navigation files.
This navigation catalog can be used to add site navigation to pages in an Antora documentation pipeline.
Antora is a modular static site generator designed for creating documentation sites from AsciiDoc documents.
Its site generator aggregates documents from versioned content repositories and processes them using Asciidoctor .
Copyright and License
Copyright (C) 2017-present OpenDevise Inc. and the Antora Project .
Use of this software is granted under the terms of the Mozilla Public License Version 2.0 (MPL-2.0).
@antora/navigation-builder 是什么？ Builds a navigation catalog from navigation files for adding site navigation to pages in an Antora documentation pipeline.
如何安装 @antora/navigation-builder？ 在项目目录运行 npm install @antora/navigation-builder，或使用 pnpm add / yarn add / bun add。
@antora/navigation-builder 支持 TypeScript 吗？ 该包的 package.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/antora__navigation-builder 是否存在。
@antora/navigation-builder 支持 ESM 还是 CommonJS？ 以 CommonJS 形式发布，可以直接 require()；在 ES Module 项目中也可以用 import 引入（Node.js 会把 module.exports 作为默认导出）。
@antora/navigation-builder 需要什么版本的 Node.js？ package.json 的 engines 字段要求 Node.js >=20.0.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。
@antora/navigation-builder 可以商用吗？ @antora/navigation-builder 使用 MPL-2.0 许可。弱 Copyleft：可以商用，也可以和闭源代码一起使用；但如果分发时修改了 MPL 授权的文件，这些文件的修改需以 MPL 开源。以上为概括，不构成法律意见，请以许可原文为准。
@antora/navigation-builder 的下载量有多少？ 根据 npm 官方下载统计，@antora/navigation-builder 在 2026/10/06 – 2026/11/04 这 30 天内被下载 169,795 次，日均约 5,660 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
@antora/navigation-builder 还在维护吗？ 最新版本 3.2.2 发布于 2026/10/31（8 天前）；至今共发布 102 个版本，其中过去 12 个月发布了 9 个；首次发布于 2018/01/12。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。