diff --git a/editions/tw5.com/tiddlers/wikitext/Linking in WikiText.tid b/editions/tw5.com/tiddlers/wikitext/Linking in WikiText.tid index 9d6a4d15a..ab015ad43 100644 --- a/editions/tw5.com/tiddlers/wikitext/Linking in WikiText.tid +++ b/editions/tw5.com/tiddlers/wikitext/Linking in WikiText.tid @@ -32,21 +32,37 @@ You can suppress a link from being recognised by preceding it with `~`. For exam ! External Links -To link to an external website, type the full URL of the site: +To link to an external [[resource|https://en.wikipedia.org/wiki/Web_resource]] such as a website or a file, type its //full// [[URL|https://en.wikipedia.org/wiki/URL]], including the [[URI scheme|https://en.wikipedia.org/wiki/URI_scheme]] such as a protocol (e.g. `http://`, `file://`) or `mailto`: ``` http://tiddlywiki.com/ [[TW5|http://tiddlywiki.com/]] + +[[Mail me|mailto:me@where.net]] ``` -For this syntax to work, the URL has to be recognisable as an URL, including a protocol such as `http://` or `file://`. You can force an external link with the extended syntax: +For this syntax to work, the URL has to be recognisable as a URL. Otherwise, it is treated as a tiddler title. As a result, in case you want to link to a resource locatable using a relative path, use the extended syntax: + +``` +[ext[Open file|index.html]] + +[ext[Open file|./index.html]] + +[ext[Open file|../README.md]] +``` + +The extended syntax still works with full URLs, although in that case it is not necessary: ``` [ext[http://tiddlywiki.com]] -[ext[caption for link|http://tiddlywiki.com]] +[ext[TW5|http://tiddlywiki.com]] +``` +You can also use the extended syntax to force an external link: + +``` [ext[Donate|bitcoin:1aabbdd....?amount=0.001]] ```