====== Links ======

See [[syntax]] for an example of how to write links.

You can either link pages or urls. Urls are recognized because they start with "''proto://''" ("''mailto:''" is an exception here). Page names can contain ':' characters to separate namespaces.

* Links containing a ':' are resolved from the root namespace
* Links that do not contain a ':' are resolved in the current namespace
* Links that start with a '.' are resolved in the namespace below the current page
* Links that contain a '>' are interwiki links, see below.

You can make any text into a link, thus the link you see and what it links to do not have to be the same. You can use the Edit->Link menu item to modify a link.

===== Interwiki =====
There is a list of pre-defined urls in "''share/zim/urls.list''" which lists most commonly used online wikis. These urls can be refered to by a keyword so you don't have to type the full url every time; also you can update all links to a certain wiki by changing the url in the file. Have a look at the list to get an idea of how to use this.

This link for example goes to wikipedia.org: [[wp>wiki]]

To add your own urls use "''~/.local/share/zim/urls.list''".

TODO: a way to use interwiki to link to other local zim repositories

===== Back links =====
"Back links" are the reverse of normal links. For example when page //A// links to page //B// then page //B// will have "back link" to page //A//. The list with back links is the answer the the question "What links here".

In the status bar at the bottom of the window you can see how many back links there are for the current page. The view which pages link here you can open the "Search Back links" menu item (//Edit//->//Search Back links//) or click the area in the status bar that gives info about back links. Clicking the status bar area with mouse button 3 you get a popup menu with back links.