From 554aa8b13d18469ca89fa00a8feafe9e4443ea80 Mon Sep 17 00:00:00 2001 From: Manuel Fuenmayor Date: Fri, 7 Jun 2024 22:07:58 -0400 Subject: [PATCH] content: Escaping HTTP links nested into http macros --- author/ref/asciidoc-tips.adoc | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/author/ref/asciidoc-tips.adoc b/author/ref/asciidoc-tips.adoc index 87d7db9a..84c9787e 100644 --- a/author/ref/asciidoc-tips.adoc +++ b/author/ref/asciidoc-tips.adoc @@ -162,6 +162,23 @@ multiple-character combinations, try interpolating `+‌+` between the char as em-dashes. Character `U+200c` (the zero width non-joiner) is invisible, and its function is to prevent ligatures combining the characters either side of it. +=== Escaping HTTP links within `http` macros + +In cases where an HTTP link is nested into an `http` macro, like for example: + +[source%unnumbered] +---- +http://example.com[http://example.com/] +---- + +it is necessary to escape the inner `http` string with a backslash in order to not be +recognized as another `http` macro, like so: + +[source%unnumbered] +---- +http://example.com[\http://example.com/] +---- + == Document attributes Metanorma AsciiDoc body content is interpolated and processed, such as: