内部交叉引用

内部交叉引用是指对同一页面中其他元素的引用。您可以引用章节、块或内联元素。这些交叉引用只需要指定锚点(也称为ID)。

引用同一页面中的章节

当AsciiDoc页面被处理时,章节标题ID会自动生成,因此您可以通过引用章节标题来使用它们作为链接。但是,标题必须以大写字母(基本拉丁字母)开头,且没有任何前导格式标记。

要链接到同一页面中某个章节的开头,请使用页面内交叉引用,其标记为一对双尖括号(<< >>)。

示例 1. 链接到同一页面中的章节标题
这是一个页面内交叉引用:<<引用同一页面中的章节>>。(1)

这是一个页面内交叉引用:
<<reference-a-section-in-the-same-page,查看一下>>!(2)
1 使用章节标题进行页面内交叉引用。
2 使用章节的隐式ID进行页面内交叉引用。

引用同一页面中的块或内联元素

要链接到同一页面中的块或内联元素,您必须在该位置定义一个ID。

示例 2. 创建一个ID
[#playbook](1)
这是一个playbook的示例。

这是一个[#name-me]#内联ID#。(2)
1 可以将ID放在段落(即块)上。
2 可以内联放置ID。

有一些例外情况,请查看Asciidoctor手册中关于定义锚点部分以获取更多用例。

要链接到该ID,请使用与章节标题相同的页面内交叉引用语法。

示例 3. 链接到一个ID
我们将在本教程中详细介绍一个playbook的<<playbook,示例>>。