根据AsciiDoc语法快速参考,内联锚声明(可能还有其他类型的锚声明,但它们没有描述?(可以采取以下形式之一:
[[a1]]
[#a2]
解释第二个选项的文档暗示(也许?(当锚定某个地方已经有哈希符号的文本时,会使用(仅?(此表单?但这并没有明确说明。(有点幽默的是,显示(内联(锚的示例的"示例15"是不可直接链接的。(
在野外,我也看到过这样定义的显式锚点:
[[goals]]
= Goals
…尽管值得注意的是,在AsciiDoc语法快速参考文档本身的AsciiDoc源代码中,没有使用该表单。
无论如何,这样一个例子可以像这样等价地定义吗?
[#goals]
= Goals
…如果是,为什么存在这两种格式?
我无意中发现了一节关于块样式和属性简写的内容,这可能是答案,这表明使用[[this-form]]
作为定义锚的一种方式的做法不如使用[#this-form]
正确,但我想听到更多。
啊哈!我找到了答案。使用[[this form]]
作为相当于ID声明的内容是遗留的。