Differences

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

--- interwiki [2009-12-05 14:53] – possible misunderstanding fixed kazmiya
+++ interwiki [2023-02-28 07:39] (current) – Link to new dokuwiki repo saggi
@@ Line 1: / Line 1: @@
 ====== InterWiki Links ======
-The original idea of InterWiki was to have one large distributed [[wp>Wiki]] over the whole net. Today its more of an easy way to link from one wiki to another by having some simple link syntax to do so.
+The original idea of InterWiki was to have one large distributed [[wp>Wiki]] over the whole Internet. Today it's more of an easy way to link from one wiki to another by having some simple link syntax to accomplish so.
-In [[DokuWiki]] this is done by prefixing Wiki [[pagenames]] with a shortcut separated by a ''>'' character.
+In [[DokuWiki]] this is done by prefixing Wiki [[pagenames]] with a shortcut separated by a **''>''** character.
 Examples:
-  [[wp>Wiki]] links to Wikipedia,
+^  Shortcut  ^  Example  ^  Description  ^
-  [[Meatball>TourBusStop]] links to the MeatBall wiki TourBusStop,
+| ''%%[[amazon>Wikis]]%%''     | [[amazon>Wikis]]    | Affiliation link to Amazon. (.de and .uk available too)  |
-  [[google>Wiki]] links to a google search,
+| ''%%[[callto>0123456789]]%%''  | [[callto>0123456789]]  | Callto link to open phone app.  |
-  [[doku>interwiki]] links to this page.
+| ''%%[[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''.  |
-[[wp>Wiki]] links to Wikipedia, [[Meatball>TourBusStop]] links to the MeatBall wiki TourBusStop, [[google>Wiki]] links to a Google search.
+Here's an example of how to access an arbitrary file in DokuWiki's data/media directory by clicking on an image. It's useful for videos and PDF files.
-[[doku>interwiki]] links to this page.
-There is one special interwiki shortcut called **''this''**. It always links to the webserver directory DokuWiki is installed in. You can use this to construct relative URLs. For example the following always links to the local [[syndication|XML feed]]: [[this>feed.php]]
+  [[this>lib/exe/fetch.php?media=video.ogg|{{image.png?300}}]]
-  [[this>feed.php]]
+Since DokuWiki [[changes#release_2017-02-19e_frusterick_manners|Release 2017-02-19b "Frusterick Manners"]], interwiki substitution for external images is available.
-**More Info on InterWiki:**
+{{ phpfn>images/php.gif?96}}
-  * [[wp>InterWiki]] at Wikipedia
-  * [[MeatBall>InterWiki]] at MeatBall
-  * [[Wiki>InterWiki]] at c2.com Wiki
+  {{ phpfn>images/php.gif?96}}
 ===== Configuring InterWiki Shortcuts =====
-InterWiki shortcuts are defined in the ''conf/interwiki.conf'' file. The default file contains all shortcuts suggested in [[http://usemod.com/intermap.txt]]. You can add your own interwiki links by creating a ''conf/interwiki.local.conf'' file and placing your links in that file (this will prevent the links from being overwritten on a update).
+InterWiki shortcuts are defined in two files:
+  * Default included links are in ''[[https://github.com/dokuwiki/dokuwiki/blob/master/conf/interwiki.conf|<dokuwiki_conf>/interwiki.conf]]'' file. (more can be found in [[http://usemod.com/intermap.txt]]). Modifications of this file are overwritten on a wiki upgrade.
+  * Local modifications in ''<dokuwiki_conf>/interwiki.local.conf'' file.\\ This is the file to add your own interwiki links. This will prevent the links from being overwritten on an update.
-It is possible to modify Dokuwiki’s ''conf/interwiki.conf'' file, however this could result in your changes being overwritten when upgrading Dokuwiki.
+The interwiki shortcut has to be in lowercase and follow the [[pagename]] rules.
-You can place imagefiles named after the shortcut in the ''lib/images/interwiki'' directory to use them instead of the default icon. They should have a size of 16x16 pixels and be in PNG or GIF format.
+The format of the interwiki config file is:
-You should also purge the [[caching|cache]] if you have the default image instead of the one you uploaded.
-<code>
+<code - conf/interwiki.local.conf>
-rm -rf <path-to-dokuwiki>/data/cache/*
+<shortcut>   <url to wiki>
 </code>
-The interwiki shortcut has to be in lowercase and follow the [[pagename]] rules.
+Modify existing interwiki links, by reusing the shortcut:<code - conf/interwiki.local.conf>
+wp           https://fr.wikipedia.org/wiki/{NAME}
+</code>
+Or disable by mentioning no link<code - conf/interwiki.local.conf>
+wpmeta
+</code>
-The format of the interwiki config file is:
+The shortcut is the one you will be able to use in the link later. In the URL you can use some placeholders to be more flexible in linking. If no placeholder is given the [[phpfn>rawurlencode|URL-encoded]] wikiname will be appended to the URL. These placeholders are available:
-  <shortcut>      <url to wiki>
+^ Placeholder  ^  Replaced by                                                                          ^
+| {URL}        | URL-encoded wikiname (the part which is appended to the URL in interwiki.local.conf)  |
+| {NAME}       | wikiname without any encoding                                                         |
+| {SCHEME}     | scheme part if a URL was given as wikiname                                           |
+| {HOST}       | host part if a URL was given as wikiname                                             |
+| {PORT}       | port part if a URL was given as wikiname                                             |
+| {PATH}       | path part if a URL was given as wikiname                                             |
+| {QUERY}      | query part if a URL was given as wikiname                                            |
-The shortcut is the one you will be able to use in the link later. In the URL you can use some placeholders to be more flexible in linking. If no placeholder is given the [[phpfn>rawurlencode|URL-encoded]] wikiname will be appended to the URL. These placeholders are available:
+The last 5 parameters are useful when creating interwikilinks to cachesystems.
-^ Placeholder ^ Replaced by ^
+For configuration changes to take effect on the pages, the [[devel:caching|cache must be purged]].
-| {URL}       | URL-encoded wikiname (the part which is appended to the url in interwiki.local.conf) |
-| {NAME}      | wikiname without any encoding |
-| {SCHEME}    | scheme part if an URL was given as wikiname |
-| {HOST}      | host part if an URL was given as wikiname |
-| {PORT}      | port part if an URL was given as wikiname |
-| {PATH}      | path part if an URL was given as wikiname |
-| {QUERY}     | query part if an URL was given as wikiname |
-The last 5 parameters are useful when creating interwikilinks to cachesystems. Refer to the ''coral'' shortcut in the distributed ''interwiki.conf''.
+==== Examples ====
-Examples of these placeholders can found in conf/interwiki.conf
+For example cached links with the old, not longer working, [[wp>Coral Content Distribution Network]] could be used by a ''coral'' shortcut, defined using a couple of placeholders:
+<code - conf/interwiki.local.conf>
+coral http://{HOST}.{PORT}.nyud.net:8090{PATH}?{QUERY}
+</code>
+For example, [[https://wiki.ubuntu.com/|Ubuntu's wiki]] uses namespaces and pagenames like this ''LaptopTestingTeam/ToshibaPortegeM700'' and without using ''{NAME}'' as a placeholder in your interwiki.local.conf file, you'll get a "Not Found" error on their wiki, because it'll interpret the forward slash as a ''%2F'' ; so what you can do is add this line to your interwiki.local.conf:
+<code - conf/interwiki.local.conf>
+ubuntu   https://wiki.ubuntu.com/{NAME}
+</code>
-For example, [[https://wiki.ubuntu.com/|Ubuntu's wiki]] uses namespaces and pagenames like this "LaptopTestingTeam/ToshibaPortegeM700" and without using {NAME} as a placeholder in your interwiki.local.conf file, you'll get a Not Found error on their wiki, because it'll interpet the forward slash as a %2F ; so what you can do is add this line to your interwiki.local.conf:
-<code>ubuntu https://wiki.ubuntu.com/{NAME}</code>
 and now create your link to it like this:
-<code>[[ubuntu>LaptopTestingTeam/ToshibaPortegeM700|Ubuntu Linux on Toshiba Portege M700 Tablet]]</code>
+<code>[[ubuntu>LaptopTestingTeam/ToshibaPortegeM700|Ubuntu on Toshiba Portege M700 Tablet]]</code>
+If the wikiname will already include encoded characters (ex: ''%26'' for ''&'') use {PATH} in your interwiki.local.conf definition.
+==== Inter(n)wiki links ====
+To refer to certain namespaces within you own wiki:((Note: the link would always appear as if the page already exists. No 'preprove'.))
+<code - conf/interwiki.local.conf>
+<shortcut>      <dokuwiki_root>:ns:..:
+</code>
+For example: <code - conf/interwiki.local.conf>
+enlib     doku.php?id=:en:lib:
+</code> would address pages in the namespace '':en:lib:pagename'' if using the link syntax ''%%[[enlib>pagename]]%%''.
+===== Configuring InterWiki Shortcut Icons =====
+Interwiki icons should have a size of 16x16 pixels, be in PNG or GIF format, and be named after the shortcut.
+  * ''<dokuwiki_root>/lib/images/interwiki''\\ The directory to place the image files in.
+You should also purge [[caching|cached]] PNG and GIF images as well as the CSS Files if you have the default image instead of the one you uploaded.
+<code>
+rm -rf <dokuwiki_data>/data/cache/*/*.{gif,png,css}
+</code>
+It may actually be enough to invalidate the CSS caching by re-saving in the config manager ('re-saving' means pressing the save button of config manager without any changes of config options).
+If you want to disable all or some kind of link icons, refer to [[tips:disabling link icons]].
+===== Using the number sign/hash (#), not as comment =====
+Because it is reserved to mark a comment line, a hash (''#'') needs to be escaped by a backslash (''\#'').
+e.g. if you are using the name of your interwiki in the fragment part of your URL, you need to escape it.
+Example:
+  * Configuration<file - conf/interwiki.local.conf>
+postconf  http://www.postfix.org/postconf.5.html\#{NAME}
+</file>
+  * Usage<code>
+[[postconf>smtpd_tls_received_header]]
+</code>
+===== See also =====
+  * [[tips:interwiki_shortcuts|Additional InterWiki Shortcuts]]
+  * [[config|Configuring DokuWiki]]