本wiki的個性化修改
Dokuwiki版本
2023-04-04a "Jack Jackrum"
語法附加元件
以下是本wiki安裝的語法附加元件：
- discussion plugin 2021-12-31 由 Michael Hamann, Gerrit Uitslag, Gina Häussge, Christopher Smith, Michael Klier, Esther Brunner, Matthias Schulte
Provides discussion funtionality for wiki pages - fontsize2 plugin 2017-01-07 由 Thorsten Stratmann
DokuWiki plugin for controlling the size of your text - HTML Comment Plugin 2013-03-19 由 Christopher Arndt
allows HTML comments to be retained in the output - include plugin 2022-01-23 由 Michael Hamann, Gina Häussge, Christopher Smith, Michael Klier, Esther Brunner
Functions to include another page in a wiki page - Pagelist Plugin 2022-09-28 由 Matthias Schulte, Michael Hamann, Michael Klier, Gina Haeussge
Lists pages in a nice formatted way - Plain Text 2018-05-20 由 Danny Lin
<text> and <TEXT> tags that embeds plain text with linebreaks and auto wrap. - Tag Plugin 2023-05-25 由 Michael Hamann, Gina Häussge, Christopher Smith, Michael Klier, Esther Brunner
tag wiki pages - Video Sharing Site Plugin 2022-02-03 由 Andreas Gohr
Easily embed videos from various Video Sharing sites. Example: {{youtube>XXXXXX}} - Wrap Plugin 2022-08-10 由 Anika Henke
Universal plugin which combines functionalities of many other plugins. Wrap wiki text inside containers (divs or spans) and give them a class (choose from a variety of preset classes), a width and/or a language with its associated text direction.
另外﹐管理員亦自行開發了自動進行異體字轉換的附加元件canonicalchinese。
Patch files
以下是本wiki的系統管理員，對DokuWiki作出的修改（patch file）：
DokuWiki主程式
- 加入DokuWiki預設裏欠缺的wiki間互連（interwiki）。
創建 <dokuwiki_path>/conf/interwiki.local.conf - 修改預設CSS
創建 <dokuwiki_path>/conf/userall.css - 修改連結顯示方式：內部連結顯示分類名稱，wiki間互連顯示所連結的wiki名稱。
patch file: cd <dokuwiki_path>; patch -p1 < <patch file>
- dokuwiki-xhtml.patch
--- dokuwiki/inc/parser/xhtml.php.orig 2023-04-26 19:15:00.905534428 +0800 +++ dokuwiki/inc/parser/xhtml.php 2023-04-26 19:14:22.273538184 +0800 @@ -836,10 +836,10 @@ } // default name is based on $id as given - $default = $this->_simpleTitle($id); + $default = $id; // now first resolve and clean up the $id - $id = (new PageResolver($ID))->resolveId($id, $this->date_at, true); + $id = (new PageResolver($id))->resolveId($id, $this->date_at, true); $exists = page_exists($id, $this->date_at, false, true); $link = array();
- 修改連結顯示方式：[[somelink]]連往主 namespace，而不是當前頁面的namespace
patch file: cd <dokuwiki_path>; patch -p1 < <patch file>- dokuwiki-pageutils.patch
--- dokuwiki/inc/pageutils.php.orig 2015-03-18 14:54:42.733615088 +0800 +++ dokuwiki/inc/pageutils.php 2015-03-18 14:55:10.362012523 +0800 @@ -477,7 +477,7 @@ $id = implode(':', $result); }elseif($ns !== false && strpos($id,':') === false){ //if link contains no namespace. add current namespace (if any) - $id = $ns.':'.$id; + $id = ':'.$id; } if($clean) $id = cleanID($id);
- 創建<dokuwiki_path>/conf/lang/zh-tw/lang.php
- lang.php
<?php $lang['qb_code'] = '英文等寬體'; ?>
colorpicker附加元件
- patch file: cd <dokuwiki_path>/lib/plugins/colorpicker; patch -p1 < <patch file>
(https://github.com/gbirke/colorpicker/issues/2)
- script.js.patch
--- colorpicker/script.js.orig 2014-01-04 18:21:00.224688000 +0800 +++ colorpicker/script.js 2014-01-04 18:22:02.515250800 +0800 @@ -28,7 +28,7 @@ }; } - var $picker = jQuery('<div class="picker" id="' + id + '"></div>'); + var $picker = jQuery('<div class="picker a11y" id="' + id + '" aria-hidden="true"></div>'); $picker.css({position:'absolute', 'marginLeft': '-10000px'}); for(var key in list){
- 創建<dokuwiki_path>/lib/plugins/colorpicker/lang/zh-tw/lang.php
- lang.php
<?php $lang['colorpicker'] = '文字顏色'; $lang['js']['buttontext'] ='文字'; ?>
- 創建<dokuwiki_path>/lib/plugins/colorpicker/lang/zh-tw/settings.php (未有中文化)
- settings.php
<?php $lang['colorscheme'] = 'Color scheme.<br/><span style="font-size:80%">The color name, followed by a an equals sign and a text color name. A background color can be added with a slash after the foreground color.<br/><br/>Example:<br/><pre style="margin:0;padding:5px;font-size:100%;background:#c0c0c0;">Info=green<br/>Attention=black/red</pre></span>'; ?>
- 色板設定：
初音未來=#008080 鏡音鈴=#ED6F00 鏡音連=#BFAA15 巡音流歌=#FF00FF Kaito=#0000FF Meiko=#FF0000 Gumi=#008000 神威樂步=#5F00BD Lily=#FF9900 亞北音留=#000000 弱音鉑=#808080 重音Teto=#FF8080 洛天依=#66CCFF 言和=#66FFCC 歌愛雪=#BA0033 冰山清輝=#000080 貓村伊呂波=#FF4E00 龍斗=#7FB80E VY1 Mizki=#E54C4C VY2 Yuma=#D6006F 歌手音Piko=#534948 結月緣=#AE35FF 蒼姬瑾瑜=#2A5CAA 兔眠莉音=#800080 IA=#8567B6 Cul=#700000 SeeU=#897B52 Oliver=#FFCE00
fontsize2附加元件
- 創建<dokuwiki_path>/lib/plugins/fontsize2/lang/zh-tw/lang.php
- lang.php
<?php /** * German language file * * @license GPL 2 (http://www.gnu.org/licenses/gpl.html) * @author Esther Brunner <wikidesign@gmail.com> */ // custom language strings for the plugin $lang['fs_picker'] = '文字大小'; $lang['fs_xxs'] = 'Tiny Text'; $lang['fs_xxs_sample'] = 'This is a tiny text'; $lang['fs_xs'] = 'Very Small Text'; $lang['fs_xs_sample'] = 'This is a very small text'; $lang['fs_s'] = 'Small Text'; $lang['fs_s_sample'] = 'This is a small text'; $lang['fs_m'] = 'Medium Text (is bigger than default)'; $lang['fs_m_sample'] = 'This is a medium size text'; $lang['fs_l'] = 'Large Text'; $lang['fs_l_sample'] = 'This is a large text'; $lang['fs_xl'] = 'Very Large Text'; $lang['fs_xl_sample'] = 'This is a very large text'; $lang['fs_xxl'] = 'Huge Text'; $lang['fs_xxl_sample'] = 'This is a huge text'; $lang['fs_smaller'] = 'Smaller than default text'; $lang['fs_smaller_sample'] = 'This text is smaller than default text'; $lang['fs_larger'] = 'Larger than default text'; $lang['fs_larger_sampel'] = 'This text is larger than default text'; //Setup VIM: ex: et ts=2 enc=utf-8 :
hidden附加元件
- 創建<dokuwiki_path>/lib/plugins/hidden/lang/zh-tw/lang.php
- lang.php
<?php /** * English language file * * @license GPL 2 (http://www.gnu.org/licenses/gpl.html) * @author Guillaume Turri <guillaume.turri@gmail.com> */ $lang['encoding'] = 'utf-8'; $lang['direction'] = 'ltr'; $lang['onHidden'] = 'Click to display ⇲'; $lang['onVisible'] = 'Click to hide ⇱'; $lang['edit'] = 'Edit hidden section'; $lang['button'] = '隱藏段落';
Pagelist附加元件
- 改變tag頁面連結顯示方式。
patch file: cd <dokuwiki_path>/lib/plugins/pagelist; patch -p1 < <patch file>
(ref: https://github.com/dokufreaks/plugin-pagelist/issues/26)
- helper.php.patch
--- helper.php.orig 2023-04-04 09:08:12.691946216 +0800 +++ helper.php 2023-04-04 09:08:53.072735704 +0800 @@ -486,7 +486,7 @@ // produce output $content = '<a href="' . wl($id) . (!empty($this->page['section']) ? '#' . $this->page['section'] : '') . - '" class="' . $class . '" title="' . $id . '">' . $title . '</a>'; + '" class="' . $class . '" title="' . $id . '">' . $id . '</a>'; if ($this->style == 'list') { $content = '<ul><li>' . $content . '</li></ul>'; }
Tag附加元件
- 無論與tag同名的條目是否存在，tag 連結均永遠連往頁面清單
patch file: cd <dokuwiki_path>/lib/plugins/tag; patch -p1 < <patch file>
- helper.php.patch
--- helper.php.orig 2023-05-26 17:10:39.877109983 +0800 +++ helper.php 2023-05-26 17:10:39.805108672 +0800 @@ -192,7 +192,7 @@ // Compatibility with older releases resolve_pageid($this->namespace, $tag, $exists); } - if ($exists) { + /* if ($exists) { $class = 'wikilink1'; $url = wl($tag); if ($conf['useheading']) { @@ -202,7 +202,7 @@ $tagTitle = $heading; } } - } else { + } else { */ if ($dynamic) { $pages = $this->getTopic('', 1, $svtag); if (empty($pages)) { @@ -214,7 +214,7 @@ $class = 'wikilink1'; } $url = wl($tag, ['do'=>'showtag', 'tag'=>$svtag]); - } + // } if (!$title) { $title = $tagTitle; } @@ -226,7 +226,7 @@ ]; Event::createAndTrigger('PLUGIN_TAG_LINK', $link); return '<a href="'.$link['href'].'" class="'.$link['class'].'" title="'.$link['tooltip'].'" rel="tag">' - .$link['title'] + .$link['tooltip'] .'</a>'; }
Wrap附加元件
- 加入文字對齊按鈕
- 下載 http://canto.acgvlyric.org/_upload/wrap_align.zip ，解壓至 <dokuwiki_path>/lib/plugins/wrap/images/toolbar
- patch file: cd <dokuwiki_path>/lib/plugins/wrap; patch -p1 < <patch file>
- action.php.diff
diff -ru dokuwiki_plugin_wrap-stable.orig/action.php dokuwiki_plugin_wrap-stable/action.php --- dokuwiki_plugin_wrap-stable.orig/action.php 2014-02-04 18:59:07.000000000 +0800 +++ dokuwiki_plugin_wrap-stable/action.php 2014-06-08 14:22:33.886052654 +0800 @@ -35,6 +35,34 @@ 'list' => array( array( 'type' => 'format', + 'title' => $this->getLang('pleft'), + 'icon' => '../../plugins/wrap/images/toolbar/pleft.png', + 'open' => '<WRAP leftalign>\n', + 'close' => '\n</WRAP>\n', + ), + array( + 'type' => 'format', + 'title' => $this->getLang('pright'), + 'icon' => '../../plugins/wrap/images/toolbar/pright.png', + 'open' => '<WRAP rightalign>\n', + 'close' => '\n</WRAP>\n', + ), + array( + 'type' => 'format', + 'title' => $this->getLang('pcenter'), + 'icon' => '../../plugins/wrap/images/toolbar/pcenter.png', + 'open' => '<WRAP centeralign>\n', + 'close' => '\n</WRAP>\n', + ), + array( + 'type' => 'format', + 'title' => $this->getLang('pjustify'), + 'icon' => '../../plugins/wrap/images/toolbar/pjustify.png', + 'open' => '<WRAP justify>\n', + 'close' => '\n</WRAP>\n', + ), + array( + 'type' => 'format', 'title' => $this->getLang('column'), 'icon' => '../../plugins/wrap/images/toolbar/column.png', 'open' => '<'.$syntaxDiv.' group>\n<'.$syntaxDiv.' half column>\n', diff -ru dokuwiki_plugin_wrap-stable.orig/helper.php dokuwiki_plugin_wrap-stable/helper.php --- dokuwiki_plugin_wrap-stable.orig/helper.php 2014-02-04 18:59:07.000000000 +0800 +++ dokuwiki_plugin_wrap-stable/helper.php 2014-06-08 14:23:09.078548277 +0800 @@ -44,12 +44,26 @@ continue; } + //get bgcolor + $token_match = array(); + if (preg_match('/bgcolor=(.*)/', $token, $token_match)) { + $attr['bgcolor'] = $token_match[1]; + continue; + } + + //get color + if (preg_match('/color=(.*)/', $token, $token_match)) { + $attr['color'] = $token_match[1]; + continue; + } + //get id if (preg_match('/#([A-Za-z0-9_-]+)/', $token)) { $attr['id'] = trim($token,'#'); continue; } + //get classes //restrict token (class names) characters to prevent any malicious data if (preg_match('/[^A-Za-z0-9_-]/',$token)) continue; @@ -93,13 +107,17 @@ elseif($addClass) $out .= ' class="'.$addClass.'"'; if($attr['id']) $out .= ' id="'.hsc($attr['id']).'"'; // width on spans normally doesn't make much sense, but in the case of floating elements it could be used - if($attr['width']) { + if($attr['width'] || $attr['bgcolor'] || $attr['color']) { + $out .= ' style="'; if (strpos($attr['width'],'%') !== false) { - $out .= ' style="width: '.hsc($attr['width']).';"'; + $out .= ' width: '.hsc($attr['width']).';'; } else { // anything but % should be 100% when the screen gets smaller - $out .= ' style="width: '.hsc($attr['width']).'; max-width: 100%;"'; + $out .= ' width: '.hsc($attr['width']).'; max-width: 100%;'; } + if($attr['bgcolor']) $out .= ' background-color:'.hsc($attr['bgcolor']).'; '; + if($attr['color']) $out .= ' color:'.hsc($attr['color']).'; '; + $out .= '"'; } // only write lang if it's a language in lang2dir.conf if($attr['dir']) $out .= ' lang="'.$attr['lang'].'" xml:lang="'.$attr['lang'].'" dir="'.$attr['dir'].'"'; diff -ru dokuwiki_plugin_wrap-stable.orig/lang/en/lang.php dokuwiki_plugin_wrap-stable/lang/en/lang.php --- dokuwiki_plugin_wrap-stable.orig/lang/en/lang.php 2014-02-04 18:59:07.000000000 +0800 +++ dokuwiki_plugin_wrap-stable/lang/en/lang.php 2014-06-08 14:22:33.886052654 +0800 @@ -17,3 +17,8 @@ $lang['em'] = 'especially emphasised'; $lang['hi'] = 'highlighted'; $lang['lo'] = 'less significant'; + +$lang['pleft'] = 'left align'; +$lang['pright'] = 'right align'; +$lang['pcenter'] = 'center align'; +$lang['pjustify'] = 'justify'; diff -ru dokuwiki_plugin_wrap-stable.orig/lang/zh-tw/lang.php dokuwiki_plugin_wrap-stable/lang/zh-tw/lang.php --- dokuwiki_plugin_wrap-stable.orig/lang/zh-tw/lang.php 2014-02-04 18:59:07.000000000 +0800 +++ dokuwiki_plugin_wrap-stable/lang/zh-tw/lang.php 2014-06-08 14:22:33.886052654 +0800 @@ -17,3 +17,8 @@ $lang['em'] = '特別強調'; $lang['hi'] = '醒目標記'; $lang['lo'] = '不重要'; + +$lang['pleft'] = '靠左對齊'; +$lang['pright'] = '靠右對齊'; +$lang['pcenter'] = '置中對齊'; +$lang['pjustify'] = '左右對齊';
- 修改<dokuwiki_path>/lib/plugins/wrap/lang/zh-tw/lang.php，找出
$lang['picker']
一行，並將其值改爲
進階格式