DokuWiki

It's better when it's simple

User Tools

Site Tools


interwiki

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Both sides next revision
interwiki [2017-08-17 20:48]
turnermm [Table]
interwiki [2020-06-14 11:36]
gerardnico
Line 1: Line 1:
 ====== InterWiki Links ====== ====== InterWiki Links ======
 +
 The original idea of InterWiki was to have one large distributed [[wp>Wiki]] over the whole Internet. Today its more of an easy way to link from one wiki to another by having some simple link syntax to accomplish so. The original idea of InterWiki was to have one large distributed [[wp>Wiki]] over the whole Internet. Today its more of an easy way to link from one wiki to another by having some simple link syntax to accomplish so.
  
Line 16: Line 17:
   [[this>lib/exe/fetch.php?media=video.ogg|{{image.png?300}}]]   [[this>lib/exe/fetch.php?media=video.ogg|{{image.png?300}}]]
  
-Since DokuWiki Release 2017-02-19b "Frusterick Manners", interwiki substitution for external images is available.+Since DokuWiki [[changes#release_2017-02-19e_frusterick_manners|Release 2017-02-19b Frusterick Manners”]], interwiki substitution for external images is available.
  
  {{ phpfn>images/php.gif?96}}  {{ phpfn>images/php.gif?96}}
Line 22: Line 23:
   {{ phpfn>images/php.gif?96}}   {{ phpfn>images/php.gif?96}}
  
 +===== Configuring InterWiki Shortcuts =====
  
- 
- 
- 
-===== Configuring InterWiki Shortcuts ===== 
 InterWiki shortcuts are defined in two files: InterWiki shortcuts are defined in two files:
   * the ''[[https://github.com/splitbrain/dokuwiki/blob/master/conf/interwiki.conf|<dokuwiki_conf>/interwiki.conf]]'' file.\\ This is the default file, it contains a few predefined useful shortcuts (more can be found in [[http://usemod.com/intermap.txt]]). It is possible to modify this file, however this could result in your changes being overwritten when upgrading DokuWiki.   * the ''[[https://github.com/splitbrain/dokuwiki/blob/master/conf/interwiki.conf|<dokuwiki_conf>/interwiki.conf]]'' file.\\ This is the default file, it contains a few predefined useful shortcuts (more can be found in [[http://usemod.com/intermap.txt]]). It is possible to modify this file, however this could result in your changes being overwritten when upgrading DokuWiki.
Line 53: Line 51:
  
 <code>coral http://{HOST}.{PORT}.nyud.net:8090{PATH}?{QUERY}</code> <code>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: 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:
Line 64: Line 61:
  
 If the wikiname will already include encoded characters (ex: ''%26'' for ''&'') use {PATH} in your interwiki.local.conf definition. 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 appeare like if page already exist. No preprove.))
 +
 +<code><shortcut>      <dokuwiki_root>:ns:..:</code>
 +
 +For example: ''enlib      doku.php?id=:en:lib:'' would address pages in the namespace '':en:lib:pagename'' if using the link syntax ''enlib>pagename''.
 ===== Configuring InterWiki Shortcut Icons ===== ===== 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. 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.   * ''<dokuwiki_root>/lib/images/interwiki''\\ The directory to place the image files in.
Line 77: Line 83:
  
 If you want to disable all or some kind of link icons, refer to [[tips:disabling link icons]]. If you want to disable all or some kind of link icons, refer to [[tips:disabling link icons]].
 +
 +===== Tip =====
 +==== Hastag (Fragment) ====
 +If you are using the name of your interwiki in the fragment part of your URL, you need to escape it.
 +
 +Example:
 +  * Configuration
 +<file apache conf/interwiki.local.conf>
 +postconf  http://www.postfix.org/postconf.5.html\#{NAME}
 +</file>
 +  * Usage
 +<code>
 +[[postconf>smtpd_tls_received_header]]
 +</code>
  
  
 =====See also===== =====See also=====
 +
 +  * [[tips:interwiki_shortcuts|Additional InterWiki Shortcuts]]
   * [[config|Configuring DokuWiki]]   * [[config|Configuring DokuWiki]]
interwiki.txt · Last modified: 2020-06-14 11:36 by gerardnico