Differences

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

--- urlschemes [2011-08-19 20:49] – created andi
+++ urlschemes [2015-05-02 18:12] – [Support for URL schemes containing ''+''] added missing signature krichter
@@ Line 1: / Line 1: @@
 ====== 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:
@@ Line 15: / Line 15: @@
   * 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''.
+===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//