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

私の経験では、10進数のHTMLエンティティコードを使用することが解決策です。これは、HTMLとPDFの両方で有効です。あなたのケースのために：

• left square bracket: [
• right square bracket ]

は私が書くでしょう：

: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}^]. 

：あなたはたくさんのエンティティを使用する場合は、変数を使用することができます

Here comes the problem! 

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