没有哈希符号的锚点和有哈希符号的锚有什么区别

  • 本文关键字:符号 哈希 区别 asciidoc asciidoctor
  • 更新时间 :
  • 英文 :


根据AsciiDoc语法快速参考,内联锚声明(可能还有其他类型的锚声明,但它们没有描述?(可以采取以下形式之一:

  • [[a1]]
  • [#a2]

解释第二个选项的文档暗示(也许?(当锚定某个地方已经有哈希符号的文本时,会使用(仅?(此表单?但这并没有明确说明。(有点幽默的是,显示(内联(锚的示例的"示例15"是不可直接链接的。(

在野外,我也看到过这样定义的显式锚点:

[[goals]]
= Goals

…尽管值得注意的是,在AsciiDoc语法快速参考文档本身的AsciiDoc源代码中,没有使用该表单。

无论如何,这样一个例子可以像这样等价地定义吗?

[#goals]
= Goals

…如果是,为什么存在这两种格式?

我无意中发现了一节关于块样式和属性简写的内容,这可能是答案,这表明使用[[this-form]]作为定义锚的一种方式的做法不如使用[#this-form]正确,但我想听到更多。

啊哈!我找到了答案。使用[[this form]]作为相当于ID声明的内容是遗留的。