Yuanji's Wiki

人間は考える葦である

用户工具

站点工具


wiki:interwiki

差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

wiki:interwiki [2019/11/19 21:17 JST] (当前版本)
gimo 创建
行 1: 行 1:
 +====== 自定义 InterWiki ======
  
 +在学习 DokuWiki 格式语法的时候有一小节介绍了 [[wiki:​syntax#​interwiki|InterWiki]],然后打开 DokuWiki 关于[[doku>​interwiki|InterWiki]] 的介绍页面了解了下,感觉是个比较好用的别名功能,对于常见的网站,在书写链接的时候可以省却很多字符。DokuWiki 内置了好几个常用的 InterWiki,具体的配置可以直接查看 ''​conf/​interwiki.conf''​ 这个文件,自己自定义的话,建议放到 ''​conf/​interwiki.local.conf''​ 里,如果直接追加到 ''​conf/​interwiki.conf''​ 里的话,后续升级可能会被覆盖掉。
 +
 +===== 本站新定义的 InterWiki =====
 +配置文件如下:
 +<file ini interwiki.local.conf>​
 +arch      https://​wiki.archlinux.org/​index.php/​
 +gh        https://​github.com/​{PATH}
 +</​file>​
 +
 +示例:
 +| %%[[arch>​Arch Linux]]%% ​        | [[arch>​Arch_Linux]] ​        | 指向 Arch Linux Wiki 页面 ​ |
 +| %%[[gh>​splitbrain/​dokuwiki]]%% ​ | [[gh>​splitbrain/​dokuwiki]] ​ | 指向 GitHub 页面 ​          |
 +
 +另外,如果需要为新添加的别名配上相应的 icon,需要把对应的 icon 文件上传到 ''​lib/​images/​interwiki''​ 内。
 +
 +===== 制作 icon 的小技巧 =====
 +可以直接用网站的 [[wp>​favicon|favicon.ico]],不过需要记得把 icon 的名字改成 ''​别名.扩展名''​ 的形式,比如 ''​arch.gif''​,我看了下 DokuWiki 的 ''​lib/​exe/​css.php''​ 代码,似乎只支持 png 和 gif 格式,如果不确定可以使用 [[https://​ezgif.com/​]] 这个在线工具转一下格式,另外也可以改改大小,比如我这里的 icon 都是 16x16 的。
 +
 +===== 为什么我的 icon 没有生效 =====
 +如果文件名对得上的话,那八成是缓存的问题,可以试下:
 +
 +  rm -rf <​dokuwiki_data>/​data/​cache/​*/​*.{gif,​png,​css}
 +  ​
 +===== 参考资料 =====
 +  * [[doku>​interwiki]]
 +  * [[doku>​devel:​caching]]
wiki/interwiki.txt · 最后更改: 2019/11/19 21:17 JST 由 gimo