====== 跨维基链接 ======

[[http://zh.wikipedia.org/wiki/%E8%B7%A8Wiki%E9%93%BE%E6%8E%A5|跨Wiki链接]]一开始的想法是让我们拥有一个分布在整个网络的[[wp>Wiki]]，在今天，它更多的是通过一些简单的链接语法来提供一种从一个维基链接到另一个维基的方式。

在 [[doku>DokuWiki]] 中我们只要在链接的维基快捷方式和[[doku>pagenames|页面名称]]之间加上个 ''>'' 字符就可以实现跨维基链接。

例如：
| %%[[wp>InterWiki]]%%         | [[wp>InterWiki]]  | 链接到英文维基百科 |
| %%[[Meatball>InterWiki]]%%   | [[Meatball>InterWiki]] | 链接到 MeatBall 跨维基链接 |
| %%[[google>Wiki]]%%          | [[google>Wiki]] | 链接到 Google 搜索 |
| %%[[doku>interwiki]]%%       | [[doku>interwiki]] | 链接到 DokuWiki 维基  |
|    |    |
| %%[[this>feed.php]]%%        | [[this>feed.php]] | 链接到 ''<dokuwiki_data>'' (服务器上安装 DokuWiki 的目录)。你可以使用这种方法来构建相对链接。 下面的例子表示一个到本地[[syndication|聚合订阅]]的链接：[[this>feed.php]]\\ **''注意：''**  ''.htaccess'' 文件可能会让 web 服务器拒绝提供 ''<dokuwiki_data>'' 中的特定的文件或者目录。  |

这是一个如何通过点击图片访问 dokuwiki data/media 目录中任意文件的例子，这对视频和 pdf 很有用。

  [[this>lib/exe/fetch.php?media=video.ogg|{{image.png?300}}]]
===== 配置跨维基快捷方式 =====

跨维基的快捷方式定义在这两个文件：
  *''conf/interwiki.conf'' 。\\ 这个文件默认文件，它包含了所有在 [[http://usemod.com/intermap.txt]] 建议使用的快捷方式。 直接更改这个文件也是可以，但不建议，因为这在 DokuWiki 更新的时候你所做的修改会被覆盖。
  * ''conf/interwiki.local.conf''，\\ 然后在里面添加上你自己的跨维基链接。这样你所做的修改在更新的时候不会被被覆盖。

跨维基快捷方式必须使用小写字母且遵循[[pagename|页面名称]]的规则。

跨维基链接配置文件的格式如下：

  <快捷方式>      <目标维基的 URL>

''快捷方式''是一个你将会在链接时使用的字符串，目标维基 URL 的部分你可以使用一些占位符来让链接更灵活。如果没有提供占位符，那么页面名称会经过 [[phpfn>rawurlencode| URL 编码]] 后追加到目标维基 URL 后面。 
下面是有效的占位符列表:

^   占位符    ^ 替换为 ^
| {URL}       | 经URL编码后的wikiname (追加到URL后面的那一部分) |
| {NAME}      | 未经过编码的wikiname |
| {SCHEME}    | scheme 部分，如果页面名称是一个 URL 地址 |
| {HOST}      | host 部分，如果页面名称是一个 URL 地址 |
| {PORT}      | port 部分，如果页面名称是一个 URL 地址 |
| {PATH}      | path 部分，如果页面名称是一个 URL 地址 |
| {QUERY}     | query 部分，如果页面名称是一个 URL 地址 |

最后5个参数在创建指向 cachesystems 的跨维基链接时十分有用。具体参考位于 ''interwiki.conf'' 的 ''coral'' 快捷方式 。更多使用占位符的例子可以在 ''conf/interwiki.conf'' 里找到。

比如，[[https://wiki.ubuntu.com/|Ubuntu 维基]] 使用像"LaptopTestingTeam/ToshibaPortegeM700" 这样的命名空间和页面名称，而你没有在 interwiki.local.conf 文件中使用 {NAME} 作为点位符，你会得到 “Not Found” 错误，因为斜杠会被解释成 %2F；所以你需要在你的 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>


===== 配置跨维基快捷方式的图标 =====

跨维基的图标大小为 16x16，格式为 PNG 或者 GIF 格式，以快捷方式命名。

  * ''<dokuwiki_root>/lib/images/interwiki''\\ 为存放快捷方式图片的目录。

如果你得到的是默认的图片而不是你刚刚上传的，你还需要清除下[[caching|缓存]]中的 PNG 、 GIF 图片和 CSS 文件。

<code>
rm -rf <dokuwiki_data>/data/cache/*/*.{gif,png,css}
</code>

禁用链接图标，请参考[[zh:tips:disabling_link_icons|禁用链接图标]].