DokuWiki

It's better when it's simple

User Tools

Site Tools


urlschemes

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]]

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]]

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
urlschemes.txt · Last modified: 2022-01-30 00:36 by Klap-in

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki