Page Formatting ~ Links to Elsewhere

>>>

DokuWiki supports multiple ways of creating links.

External

>>>

External links are recognized automagically: http://www.google.com or simply www.google.com. You can set the link text as well: This Link points to Google. E-mail addresses like this: andi@splitbrain.org or Jane Taubman are recognised, too.

External links are recognized automagically: 
**http://www.google.com** or simply **www.google.com**.
You can set the link text as well: 
**[[http://www.google.com|This Link points to Google]]**.
E-mail addresses like this: 
**<andi@splitbrain.org>** or **[[mailto:admin@fhug.org.uk|Jane Taubman]]** are recognised, too.

To prevent unwanted spam it is possible to hide E-mail addresses in encrypted JavaScript code, so only real people using real browsers will see them, and not E-mail harvesting robots that crawl the web looking for exposed addresses. See Encrypted Links below for details.

Internal

>>>

Internal links are created by using square brackets. You can either just give a pagename or use an additional link text.

Internal links are created by using square brackets.
You can either just give a **[[pagename]]** or use an additional **[[pagename|link text]]**.

Wiki pagenames are converted to lowercase automatically, special characters are not allowed. You can create namespaces by using a colon in the pagename.

You can create **[[some:namespaces]]** by using a colon in the pagename.

For details about namespaces see namespaces. Linking to a specific section, known as a bookmark, is possible. Just add the section headline behind a hash character similar to HTML. This links to this subsection.

This links to **[[Links#Internal|this subsection]]**.

Notes:

  • Links to existing pages are shown in a different style from nonexisting ones.
  • DokuWiki does not use CamelCase to automatically create links by default, but this behavior can be enabled in the config file. Hint: If DokuWiki is a link, then it's enabled.
  • When a section's headline is changed, its bookmark changes, too. So don't rely on section linking too much.

Interwiki

>>>

DokuWiki supports Interwiki links. These are quick links to other Wikis. For example this is a link to Wikipedia's page about Wikis: Wiki.

DokuWiki supports **[[doku>Interwiki]]** links. These are quick links to other Wikis.
For example this is a link to Wikipedia's page about Wikis: **[[wp>Wiki]]**.

Windows Shares

>>>

Windows shares like this are recognized, too. Please note that these only make sense in a homogeneous user group like a corporate Intranet.

Windows Shares like **[[\\server\share|this]]** are recognized, too.

Notes:

  • For security reasons direct browsing of windows shares only works in Microsoft Internet Explorer per default (and only in the "local zone").
  • For Mozilla and Firefox it can be enabled through the config option security.checkloaduri but this is not recommended.
  • See 151 for more info.

>>>

You can also use an image to link to another internal or external page by combining the syntax for Hyper-Links and Images like this:

[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]

Please note: The image formatting is the only formatting syntax accepted in link names. The whole Images and Hyper-Links syntax is supported (including image resizing, internal and external images and URLs and interwiki links).

>>>

These allow files stored in the media folder of the Dokuwiki to be “pushed” to the user so that they are downloaded rather than displayed. To update these downloadable files use the Tools > Media Manager option or the toolbar Add Images and other files images button and refer to the media_manager guide.

{{page>extras:pushfile#Details&noheader&nodate&nouser}}

==== Download Links ==== These allow files stored in the media folder of the Dokuwiki to be “pushed” to the user so that they are downloaded rather than displayed. The pushfile.php utility can be used to create download links such as http://www.fhug.org.uk/pushfile.php?filename=folder/icons.zip optionally with link text like this:

[[http://www.fhug.org.uk/pushfile.php?filename=folder/icons.zip]]
[[http://www.fhug.org.uk/pushfile.php?filename=folder/icons.zip|link text]]

Filenames are usually composed entirely of lower-case characters and underscores (_). The utility automatically replaces each underscore in the filename with a space character as it is downloaded. Other parameters offer further options.

  • ns= specifies only a full namespace, e.g. ns=/fhugdownloads/contents, where / replaces the usual colon :.
  • name= lets the filename be changed, e.g. name=Census%20Icons, where %20 represents a space character.

So to download :fhugdownloads:contents:janescensusicons.zip as Jane's Census Icons.zip would require:

[[http://www.fhug.org.uk/pushfile.php
?ns=/fhugdownloads/contents
&filename=janescensusicons.zip
&name=Jane's%20Census%20Icons
|Jane's Census Icons]]

=== Pushfile Plugin Macro === The pushfile Control Macro provides a shorthand alternative, which allows files stored in the media folder namespace of the DokuWiki to be “pushed” to the user, so that they are downloaded rather than displayed. janescensusicons.zip Jane's Census Icons

{{pushfile>:fhugdownloads:contents:janescensusicons.zip|Jane's Census Icons}}

Either the namespace must be specified in full, or if only the filename is specified it will assume the current page namespace. Thus notations such as . and .: will not work.

>>>

To prevent unwanted spam it is possible to hide E-mail addresses in encrypted JavaScript code, so only real people using real browsers will see them, and not E-mail harvesting robots that crawl the web looking for exposed addresses. For example to encrypt [[mailto:janetaubman@gmail.com|Jane Taubman]] visit http://hivelogic.com/enkoder/form and fill in the details as follows: