导航文件中附件 Xrefs
要引用附件，请使用 AsciiDoc xref 宏和附件的资源 ID 。attachment$ 族坐标必须在附件的资源 ID 中指定。
Example 1. Example 1. nav.adoc
* xref:attachment$filename.pdf[Our Brochure] (1)
* xref:version@component:module:attachment$filename.epub[Our Book] (2)| 1 | Xref 指向与导航文件属于同一组件版本和模块的附件。 |
| 2 | Xref，其中资源 ID 指定与导航文件不同的组件版本的附件。 |
如果没有在针对附件的 xref 宏中指定链接文本，那么 Antora 将在组件版本的页面菜单中以链接的形式显示附件的 URL 。
Example 2. Example 2. nav.adoc
* xref:attachment$sample-project.zip[]来自示例2的计算出的URL https://docs.example.com/component/version/module/_attachments/sample-project.zip 将显示为页面菜单中的链接。
您可以通过在 xref 宏的方括号之间输入文本来指定链接文本。
Example 3. Example 3. nav.adoc
* xref:attachment$sample-project.zip[Practice Project]使用示例3, Antora 将在页面菜单中将文本 Practice Project 显示为链接。当访问者点击链接时，浏览器会根据附件的文件格式和浏览器设置下载或显示已发布的附件。