DokuWiki

It's better when it's simple

用户工具

站点工具


zh:interwiki

跨维基链接

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

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

例如:

[[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.org/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.txt · 最后更改: 2024-10-29 11:20 由 Aleksandr

除额外注明的地方外,本维基上的内容按下列许可协议发布: 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