在 Asciidoctor link 描述中引用方括号

Question

我正在为我正在贡献的项目在 Asciidoctor 中编写发布指南。

该文档包含一个 link，预期的 link 描述应包含像 [variable] 这样的占位符。由于 Asciidoctor alsi 使用方括号将 link 描述括起来，所以我引用了我的方括号。但是结果不是预期的那样。

这是我尝试的一个简化示例：

Here comes the problem!

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

Asciidoctor（版本 1.5.6.1）将 link 渲染为 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。对于您的情况：

我会写：

Here comes the problem!

https://dist.apache.org/[https://dist.apache.org/repos/&#91;version&#93;&#91;project&#93;^].

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

:left_sb: &#91;
:rigth_sb: &#93;

Here comes the problem!

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

在 Asciidoctor link 描述中引用方括号

Quoting square brackets in an Asciidoctor link description

quoting

asciidoctor