===== Links ===== 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: [[http://www.google.com|This Link points to google]]. Email addresses like this one: are recognized, too. DokuWiki supports multiple ways of creating links. External links are recognized automagically: http://www.google.com or simply www.google.com - You can set link text as well: [[http://www.google.com|This Link points to google]]. Email addresses like this one: are recognized, too. ==== Internal ==== Internal links are created by using square brackets. You can either just give a [[wiki:dokuwiki:pagename]] or use an additional [[wiki:dokuwiki:pagename|link text]]. Internal links are created by using square brackets. You can either just give a [[pagename]] or use an additional [[pagename|link text]]. [[doku>pagename|Wiki pagenames]] are converted to lowercase automatically, special characters are not allowed. You can use [[some:namespaces]] by using a colon in the pagename. You can use [[some:namespaces]] by using a colon in the pagename. For details about namespaces see [[doku>namespaces]]. Linking to a specific section is possible, too. Just add the section name behind a hash character as known from HTML. This links to [[dokuwiki#internal|this Section]]. This links to [[syntax#internal|this Section]]. Notes: * Links to [[dokuwiki|existing pages]] are shown in a different style from [[wiki:dokuwiki:nonexisting]] ones. * DokuWiki does not use [[wp>CamelCase]] to automatically create links by default, but this behavior can be enabled in the [[doku>config]] file. Hint: If DokuWiki is a link, then it's enabled. * When a section's heading is changed, its bookmark changes, too. So don't rely on section linking too much. ==== Interwiki ==== 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]]. 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]]. ^ Shortcut ^ Example ^ Description ^ | ''%%[[amazon>Wikis]]%%'' | [[amazon>Wikis]] | Affiliation link to Amazon. (.de and .uk available too) | | ''%%[[callto>0123456789]]%%'' | [[callto>0123456789]] | Callto link to open phone app. | | ''%%[[doku>interwiki]]%%'' | [[doku>interwiki]] | links to the DokuWiki wiki | | ''%%[[go>pie]]%%'' | [[go>pie]] | Go lucky with first hit on Google | | ''%%[[google>Wiki]]%%'' | [[google>Wiki]] | links to a Google search | | ''%%[[paypal>id_here]]%%'' | [[paypal>id_here]] | links to PayPal | | ''%%[[phpfn>random]]%%'' | [[phpfn>random]] | links to a function in the PHP manual | | ''%%[[rfc>9311]]%%'' | [[rfc>9311]] | links to https://www.rfc-editor.org/rfc/rfc9311 | | ''%%[[skype>echo123]]%%'' | [[skype>echo123]] | Links that opens Skype, ready to call Skype Test Call (echo123) | | ''%%[[tel>123-456-7890]]%%'' | [[tel>123-456-7890]] | Open phone app to call. More general then callto. | | ''%%[[this>feed.php]]%%'' | [[this>feed.php]] | links to your wiki's URL. The example links to the local [[syndication|XML feed]]. ''%%[[this>]]%%'' is a special case and the only interwiki link which **cannot be configured** through any config file. | | ''%%[[user>username]]%%'' | [[user>username]] | Links default to '':user:username'', on dokuwiki.org modified to its forum user profiles. | | ''%%[[man>cp]]%%'' | [[man>cp]] | links to http://man.cx/ | | ''%%[[wp>InterWiki]]%%'' | [[wp>InterWiki]] | links to the English language Wikipedia | | ''%%[[wpfr>InterWiki]]%%'' | [[wpfr>InterWiki]] | links to the French language Wikipedia. Also available: ''wpde'', ''wpes'', ''wpjp'', ''wppl'', ''wpru'', ''wpmeta''. | ==== Windows Shares ==== Windows shares like [[\\server\share|this]] are recognized, too. Please note that these only make sense in a homogeneous user group like a corporate [[wp>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 different workaround mentioned in the [[http://kb.mozillazine.org/Links_to_local_pages_do_not_work|Mozilla Knowledge Base]]. However, there will still be a JavaScript warning about trying to open a Windows Share. To remove this warning (for all users), put the following line in ''conf/lang/en/lang.php'' (more details at [[doku>localization#changing_some_localized_texts_and_strings_in_your_installation|localization]]): ==== Image Links ==== You can also use an image to link to another internal or external page by combining the syntax for links and [[#images_and_other_files|images]] (see below) like this: [[http://php.net|{{wiki:dokuwiki-128.png}}]] [[http://php.net|{{wiki:dokuwiki:dokuwiki-128.png}}]] Please note: The image formatting is the only formatting syntax accepted in link names. The whole [[#images_and_other_files|image]] and [[#links|link]] syntax is supported (including image resizing, internal and external images and URLs and interwiki links).