mirror of
https://github.com/Jermolene/TiddlyWiki5
synced 2024-12-26 18:10:27 +00:00
83 lines
2.2 KiB
Plaintext
83 lines
2.2 KiB
Plaintext
caption: Linking
|
|
created: 20131205155230596
|
|
modified: 20160607095245257
|
|
tags: WikiText
|
|
title: Linking in WikiText
|
|
type: text/vnd.tiddlywiki
|
|
|
|
A key capability of WikiText is the ability to make links to other tiddlers or to external websites.
|
|
|
|
! Manual Links
|
|
|
|
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.
|
|
|
|
! ~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
|
|
|
|
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`:
|
|
|
|
```
|
|
https://tiddlywiki.com/
|
|
|
|
[[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]]
|
|
```
|
|
|
|
The extended syntax still works with full URLs, although in that case it is not necessary:
|
|
|
|
```
|
|
[ext[https://tiddlywiki.com]]
|
|
|
|
[ext[TW5|https://tiddlywiki.com]]
|
|
|
|
[ext[Mail me|mailto:me@where.net]]
|
|
|
|
[ext[Open file|file:///c:/users/me/index.html]]
|
|
```
|
|
|
|
You can also use the extended syntax to force an external link:
|
|
|
|
```
|
|
[ext[Donate|bitcoin:1aabbdd....?amount=0.001]]
|
|
```
|
|
|
|
! 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.
|
|
|