1
0
mirror of https://github.com/Jermolene/TiddlyWiki5 synced 2024-12-13 11:40:27 +00:00
TiddlyWiki5/editions/tw5.com/tiddlers/wikitext/Linking in WikiText.tid

126 lines
3.9 KiB
Plaintext
Raw Normal View History

caption: Linking
created: 20131205155230596
modified: 20211230145939554
2014-09-11 08:15:58 +00:00
tags: WikiText
title: Linking in WikiText
type: text/vnd.tiddlywiki
2014-07-06 14:37:50 +00:00
A key capability of WikiText is the ability to make links to other tiddlers or to external websites.
! Manual Links
2014-05-06 19:05:51 +00:00
Link to a tiddler by title:
```
[[Tiddler Title]]
```
To link to a tiddler and specify the text of the link:
```
[[Displayed Link Title|Tiddler Title]]
```
You can also create a link from the editor toolbar. Click ''link'' (<<.icon $:/core/images/link>>), and search and select a tiddler.
2014-07-06 14:37:50 +00:00
! ~CamelCase Links
For tiddler titles that match the CamelCase rules, just typing the title without double square brackets will automatically create a link.
You can suppress a link from being recognised by preceding it with `~`. For example:
<<wikitext-example src:"* ~HelloThere is not a link
* ~http://google.com/ is not a link">>
! External Links
2014-05-06 19:05:51 +00:00
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`:
2014-05-06 19:05:51 +00:00
```
https://tiddlywiki.com/
2014-05-06 19:05:51 +00:00
[[TW5|https://tiddlywiki.com/]]
[[Mail me|mailto:me@where.net]]
[[Open file|file:///c:/users/me/index.html]]
```
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]]
[ext[Open file|c:\users\me\index.html]]
2014-05-06 19:05:51 +00:00
```
The extended syntax still works with full URLs, although in that case it is not necessary:
2014-05-06 19:05:51 +00:00
```
[ext[https://tiddlywiki.com]]
2014-05-06 19:05:51 +00:00
[ext[TW5|https://tiddlywiki.com]]
[ext[Mail me|mailto:me@where.net]]
[ext[Open file|file:///c:/users/me/index.html]]
```
2014-05-06 19:05:51 +00:00
You can also use the extended syntax to force an external link:
```
2014-05-06 19:05:51 +00:00
[ext[Donate|bitcoin:1aabbdd....?amount=0.001]]
```
2014-07-06 14:37:50 +00:00
! Customising Tiddler Links
See the LinkWidget for details of the underlying widget used to implement tiddler links, including macros that can be used to customise its behaviour.
! Generating dynamic links
[[Linking in WikiText]] does not lend itself well to creating dynamic links. The reason is because this WikiText link:
```
[[link to myself|Linking in WikiText]]
```
is shorthand for using the LinkWidget and TextWidget like this:
```
<$link to="Linking in WikiText">
<$text text="link to myself"/>
</$link>
```
Since both the link title ("link to myself") and the link target ("Linking in ~WikiText") are used as widget attributes, no WikiText expansion takes place.
For example, an attempt to use a [[reference|TextReference]] and a [[variable|Variables]] to dynamically generate a link like this:
<<.bad-example "`[[{{!!caption}}|<<currentTiddler>>]]`">>
is the same as trying to use the LinkWidget and TextWidget like this:
<<.bad-example """```
<$link to="<<currentTiddler>>">
<$text text="{{!!caption}}"/>
</$link>
```""">>
This will not work as desired. Content inside of quoted widget attributes is [[treated as a literal value|HTML in WikiText]] and protected from WikiText expansion, so it will render like this:
<<.bad-example "[[{{!!caption}}|<<currentTiddler>>]]">>
In order to get the desired result, the LinkWidget can be used directly like this:
<<wikitext-example-without-html src:"<$link to=<<currentTiddler>>>{{!!caption}}</$link>">>
See also another example of [[constructing dynamic links|Concatenating text and variables using macro substitution]].
! Linking within tiddlers - "anchor links"
In TiddlyWiki anchor links can help us link to target points and distinct sections within rendered tiddlers. They can help the reader navigate longer tiddler content.
See [[Anchor Links using HTML]] for more information.