Skip to content

Links to comparison page cannot be used because of ... (3 dots) to (1 tripple-dot) replacement by Asciidoc renderer

Problem

The Asciidoc renderer replaces ... by even for links. For instance, a link to a GitLab comparison page between two tags, e.g.

https://example.gitlab.com/$projectPath/-/compare/0.1.4...0.2.1?from_project_id=537&straight=false[my link]

Will be replaced by the renderer to

https://example.gitlab.com/$projectPath/-/compare/0.1.4…​0.2.1?from_project_id=537&straight=false[my link]

Notice the ... to replacement.

This means, that by default the comparison page links are not useable from Asciidoc rendered in GitLab (e.g., to reference comparisons from software validation reports).

Quickfix

Escape the ..., e.g. \.... This will prevent the renderer from replacing the ....

Disclaimer

After creating the issue I noticed the cause and workaround of the problem. I'm also not sure whether the problem really is a GitLab problem, or even a general Asciidoc problem.

I decided to compile my information for others as reference, and leave the issue open for you to decide how to deal with it. For instance, you might allow for an alternative URL that understands the . This would solve this problem, even if it is a general Asciidoc problem out of your control.

Edited by Philip Reiner Kensche