导航文件中的附件交叉引用
要引用附件，请使用AsciiDoc xref宏和附件的资源ID。附件的资源ID中必须指定attachment$系列坐标。
示例 1. nav.adoc
* xref:attachment$filename.pdf[我们的手册] (1)
* xref:version@component:module:attachment$filename.epub[我们的书] (2)| 1 | 针对与导航文件相同组件版本和模块的附件的交叉引用。 |
| 2 | 资源ID指定的附件位于与导航文件不同的组件版本中的交叉引用。 |
如果在针对附件的xref宏中未指定链接文本，Antora将在组件版本的页面菜单中显示附件的URL作为链接。
示例 2. nav.adoc
* xref:attachment$sample-project.zip[]从示例 2计算得到的URL，+https://docs.example.com/component/version/module/_attachments/sample-project.zip+，将显示为页面菜单中的链接。
您可以通过在xref宏的方括号之间输入文本来指定链接文本。
示例 3. nav.adoc
* xref:attachment$sample-project.zip[练习项目]使用示例 3，Antora将在页面菜单中显示文本练习项目作为链接。访问者单击链接时，根据附件的文件格式和其浏览器的设置，浏览器将下载或显示已发布的附件。