DokuWiki

It's better when it's simple

用户工具

站点工具


zh:interwiki

这是本文档旧的修订版!


姊妹维基链接

姊妹维基一开始的想法是让我们拥有一个分布在整个网络的Wiki,在今天,它更多的是通过一些简单的链接语法来提供一种从一个Wiki链接到另一个Wiki的方式。

DokuWiki ,我们在要链接的 Wiki Shortcuts和页面名称之间加上个 > 字符,便可实现跨维基链接。

实例

[[wp>InterWiki]] InterWiki 链接到英文维基百科
[[Meatball>InterWiki]] InterWiki 链接到 MeatBall 姊妹维基链接
[[google>Wiki]] Wiki 链接到 Google 搜索
[[doku>interwiki]] interwiki 链接到 DokuWiki 维基
[[this>feed.php]] feed.php 链接到 <dokuwiki_data> (服务器上安装 DokuWiki 的目录)。你可以使用这种方法来构建相对链接。 下面的例子表示一个到本地聚合订阅的链接: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
    然后在里面添加上你自己的姊妹维基链接。这样你所做的修改在更新的时候不会被被覆盖。

姊妹维基快捷方式必须使用小写字母且遵循页面名称的规则。

姊妹维基配置文件的格式如下:

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

快捷方式是一个你将会在链接时使用的字符串,目标维基 URL 的部分你可以使用一些占位符来让链接更灵活。如果没有提供占位符,那么页面名称会经过 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.confcoral 快捷方式 。更多使用占位符的例子可以在 conf/interwiki.conf 里找到。

比如,Ubuntu 维基 使用像“LaptopTestingTeam/ToshibaPortegeM700” 这样的命名空间和页面名称,而你没有在 interwiki.local.conf 文件中使用 {NAME} 作为点位符,你会得到 “Not Found” 错误,因为斜杠会被解释成 %2F;所以你需要在你的 interwiki.local.conf 文件中添加一行:

ubuntu https://wiki.ubuntu.com/{NAME}

and now create your link to it like this:

[[ubuntu>LaptopTestingTeam/ToshibaPortegeM700|Ubuntu Linux on Toshiba Portege M700 Tablet]]

配置姊妹维基快捷方式的图标

姊妹维基的图标大小为 16×16,格式为 PNG 或者 GIF 格式,以快捷方式命名。

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

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

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

禁用链接图标,请参考禁用链接图标.

zh/interwiki.1368507746.txt.gz · 最后更改: 2013-05-14 07:02 由 haobug

除额外注明的地方外,本维基上的内容按下列许可协议发布: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki