Dokuwiki 標題語法修改

Dokuwiki 的標題語法與oddmuse、Mediawiki剛好相反,h1是======,而h5是==。為了轉移方便,只好想辦法修改標題的解析。

我之前在某個地方看過,改好了。今天為了另一個功能升級Dokuwiki,結果這個修改爛掉。找了半天,好不容易才找到修改破解法。這次千萬要紀錄下來。

其實應該很簡單的,只要改掉相關解譯語法的功能就好了。但是因為headlines再dokuwiki中還有其他的功能,如用來自動產生頁面標題、產生TOC、判斷分段編輯等等之類,所以不只有一個地方要改。加上各次改版,這些功能都不是寫在相同地方,所以改起來更囉唆。

本次修改主要以DokuwikiVersion 2006-11-06

1.
這個是原本舊版就有的修改步驟,新版教學沒有提到,注意不要漏掉。在 config file中加入此項:

 $conf['inverseHeadings']     = 1;  // inverts number of "=" in heading syntax

2. 修改 inc/parser/handler.php。
找出:

 $level = 7 - strspn($title,'=');

換成:

 if ($conf['inverseHeadings']) {
$level = strspn($title,'=') - 1;
}
else {
$level = 7 - strspn($title,'=');
}

3. 修改 inc/toolbar.php
這是修改編輯工具列,找到相關語法部分,換成以下:

array(
'type'   => 'format',
'title'  => $lang['qb_h1'],
'icon'   => 'h1.png',
'key'    => '1',
'open'   => ($conf['inverseHeadings']) ? '== ' : '====== ',
'close'  => ($conf['inverseHeadings']) ? ' ==\n' : ' ======\n',
),
array(
'type'   => 'format',
'title'  => $lang['qb_h2'],
'icon'   => 'h2.png',
'key'    => '2',
'open'   => ($conf['inverseHeadings']) ? '=== ' : '===== ',
'close'  => ($conf['inverseHeadings']) ? ' ===\n' : ' =====\n',
),
array(
'type'   => 'format',
'title'  => $lang['qb_h3'],
'icon'   => 'h3.png',
'key'    => '3',
'open'   => ($conf['inverseHeadings']) ? '==== ' : '==== ',
'close'  => ($conf['inverseHeadings']) ? ' ====\n' : ' ====\n',
),
array(
'type'   => 'format',
'title'  => $lang['qb_h4'],
'icon'   => 'h4.png',
'key'    => '4',
'open'   => ($conf['inverseHeadings']) ? '===== ' : '=== ',
'close'  => ($conf['inverseHeadings']) ? ' =====\n' : ' ===\n',
),
array(
'type'   => 'format',
'title'  => $lang['qb_h5'],
'icon'   => 'h5.png',
'key'    => '5',
'open'   => ($conf['inverseHeadings']) ? '====== ' : '== ',
'close'  => ($conf['inverseHeadings']) ? ' ======\n' : ' ==\n',
),

4. 修改 inc/parser/wiki.php
找到 function header( ),將原來的階層陣列換成以下:

global $conf;
if ($conf['inverseHeadings']) {
$levels = array(
1=>'==',
2=>'===',
3=>'====',
4=>'=====',
5=>'======',
);
} else {
$levels = array(
1=>'======',
2=>'=====',
3=>'====',
4=>'===',
5=>'==',
);
}

5. 完成收工。因為dokuwiki有cache,生效可能要等一下。

Leave a Reply

Your email address will not be published. Required fields are marked *