DokuWiki

It's better when it's simple

User Tools

Site Tools


urlschemes

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
urlschemes [2011-08-26 14:31]
berteh
urlschemes [2015-05-02 20:16] (current)
krichter [Which actions are necessary after an entry has been added to ''conf/scheme.conf''?] created
Line 1: Line 1:
 ====== URL Schemes ====== ====== 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.+DokuWiki allows linking to external URLs but only to known protocols. Which protocols are allowed is setup in ''[[https://github.com/splitbrain/dokuwiki/blob/master/conf/scheme.conf|conf/scheme.conf]]'' or ''conf/scheme.local.conf'' respectively.
  
 The following protocols are supported by default: The following protocols are supported by default:
Line 15: Line 15:
   * ldap   * ldap
  
-To allow local links (or any other protocol) from Rincewind on (2011.05+) you'll need to add "fileto your conf/scheme.local.conf.+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''.
  
 +===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:
 +<code>
 +[[http://dokuwiki.org]]
 +[[irc://irc.freenode.net/dokuwiki]]
 +</code>
 +[[http://dokuwiki.org]]\\
 +[[irc://irc.freenode.net/dokuwiki]]
 +
 +===How direct 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|interwiki link]]. For example, the default interwiki configuration let you use:
 +<code>
 +[[skype>contactname]]
 +</code>
 +[[skype>contactname]]
 +
 +=====See also=====
 +
 +  * [[config|Configuring DokuWiki]]
 +
 +=====Discussion=====
 +==== Support for URL schemes containing ''+''====
 +Does dokuwiki support URLs with schemes which contain ''+'', e.g. the ''svn'' checkout URL ''<nowiki>svn+ssh://user@svn.java.net/glassfish~svn</nowiki>'' (after ''svn+ssh'' has been added to ''conf/scheme.conf''? --- [[user>krichter|krichter]] //2015-05-02 18:11//
 +
 +====Which actions are necessary after an entry has been added to ''conf/scheme.conf''?====
 +I realized that after adding an entry to ''conf/scheme.conf'' actions seem to be necessary (when I edit the page and press preview the changes are recognized, when I reload they're not - but that's not the main point, a statement whether actions are necessary (none might be necessary and the behaviour a bug) and which would be appreciated).
urlschemes.1314361890.txt.gz ยท Last modified: 2011-08-26 14:31 by berteh