OurBigBook
Insane start at any of the recognized protocols are the ones shown at: Section "Known URL protocols".absolutely anywhere if not escaped, e.g.:
renders something like:
To prevent expansion, you have to escape the protocol with a backslash
Empty domains like:
don't becomes links however. But this one does:
http://https://
ahttp://example.coma <a href="http://example.com">\\, e.g.:
\http://example.comhttp://http://aInsane links end when any insane link termination character is found.
As a consequence, to have an insane link followed immediately by a punctuation like a period you should use an empty argument as in:
Check out this website: http://example.com[].which renders as:
otherwise the punctuation will go in it. Another common use case is:Check out this website: example.com.
As mentioned on the tutorial (http://example.com[see this link]).which renders as:
As mentioned on the tutorial (see this link).
If you want your link to include one of the terminating characters, e.g.
], all characters can be escaped with a backslash, e.g.:
Hello http://example.com/\]a\}b\\c\ d world.which renders as:
Hello example.com/]a}b\c d world.
Note that the
http://example.com inside \a[http://example.com] only works because we do some post-processing magic that prevents its expansion, otherwise the link would expand twice:
\P[http://example.com]
\a[http://example.com]which renders as:
This magic can be observed with
--help-macros by seeing that the href argument of the a macro has the property:
"elide_link_only": true,