在Asciidoctor链接描述中引用方括号

Question

我正在Asciidoctor写一篇关于我正在贡献的项目的发布指南。

该文档包含一个链接，预期的链接描述应包含[variable]等位置孔。由于Asciidoctor alsi使用方括号括起链接描述，我引用了我的方括号。但结果并不是那个被淹没的结果。

以下是我尝试的简化示例：

Here comes the problem!

https://dist.apache.org/[https://dist.apache.org/repos/\[version\]\[project\]^].

Asciidoctor（版本1.5.6.1）将链接呈现为https://dist.apache.org/repos/dist/dev/incubator/tamaya/\[version]/\[project]。但我期待https://dist.apache.org/repos/dist/dev/incubator/tamaya/[version]/\[project]作为结果。

我错过了什么？

Answer 1

根据我的经验，使用十进制HTML实体代码是解决方案。这应该适用于HTML和PDF。对于你的情况：

• left square bracket: [
• right square bracket ]

我会写：

Here comes the problem!

https://dist.apache.org/[https://dist.apache.org/repos/[version][project]^].

如果您经常使用实体，可以使用变量：

:left_sb: [
:rigth_sb: ]

Here comes the problem!

https://dist.apache.org/[https://dist.apache.org/repos/{left_sb}version{rigth_sb}{left_sb}project{rigth_sb}^].