Table of Contents
URL Schemes
DokuWiki allows linking to external URLs but only to known protocols. Which protocols are allowed is setup in conf/scheme.conf
or conf/scheme.local.conf
respectively.
The following protocols are supported by default:
- http
- https
- telnet
- gopher
- wais
- ftp
- ed2k
- irc
- ldap
To allow any other protocol you will need to add the protocol to your conf/scheme.local.conf
(create it when non-existing).
For example to allow local links you add file
to your conf/scheme.local.conf
:
- conf/scheme.local.conf
file xmpp
Disable url schemes by prefixing with (!
):
- conf/scheme.local.conf
!telnet
For configuration changes to take effect on the pages, the cache must be purged.
Examples of recognized urls
DokuWiki recognizes only external urls with schemes followed by ://
. Two samples of external urls recognized by with the upper configuration are:
[[http://dokuwiki.org]] [[irc://irc.libera.chat/dokuwiki]]
How redirect to already configured programs
The restriction to <scheme>://
means that when you use it to open a program you cannot only provide an address, but you also need to provide user and domain details e.g xmpp://guestlogin@example.com/support@example.com?message
. But normally you don't want to provide these details, because the program is already configured on the computer of the user.
When you like to use urls with only an address, you need urls where the scheme is followed by only a :
e.g. xmpp:support@example.com?message
. Such urls are possible in DokuWiki by creating an interwiki link. For example, the default interwiki configuration let you use:
[[skype>contactname]]
See also
Discussion
Support for URL schemes containing ''+''
Does dokuwiki support URLs with schemes which contain +
, e.g. the svn
checkout URL svn+ssh://user@svn.java.net/glassfish~svn
(after svn+ssh
has been added to conf/scheme.conf
? — krichter 2015-05-02 18:11
If escaped\+
at least the url is shown and not interpreted as italic text, but still not automatically changed in an url. — klap-in 2022-01-30 00:28