Использование квадратных скобок в описании ссылки Asciidoctor

Я пишу руководство по выпуску в 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]результата.

Что я пропустил?


quoting asciidoctor
person Oliver    schedule 07.08.2017    source источник

Ответы (1)


arrow_upward
2
arrow_downward

По моему опыту, решением является использование десятичного кода HTML Entity. Это должно работать как для HTML, так и для PDF. Для вашего случая:

я бы написал:

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}^].
person Jmini    schedule 08.08.2017