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