︿
Top

1、前言

以下前言內容引用來源為 什麼是 Oddmuse?
Oddmuse 是由 Alex Schröder 所發展的 wiki 引擎的名稱。Emacs Wiki 就是使用 Oddmuse。Wiki 引擎本身是由一個單一而大型的 Perl script 所組成。當安裝在一個網站主機上後,會由 script 產生出 wiki 網站 -- 一個能讓使用者在上面閱讀、編寫、新增、刪除頁面的網站。所有的頁面都是經由 script 來存取。請參閱 什麼是 Wiki



文章目錄

1、前言
2、實作環境
3、安裝及設定
          步驟1.下載 Oddmuse Wiki 相關檔案
          步驟2.建立放置 Oddmuse 資料目錄
          步驟3.修改 Oddmuse 設定檔 wiki.pl
          步驟4.連結 Oddmuse Wiki 首頁
4、進階設定
          設定檔 - 置頂文字連結 (Goto Bar Pages)
          設定檔 - 呼叫小圖示 (Logo and Icons)
          設定檔 - 外部連結另開新頁 (Logo and Icons)
          設定檔 - 瀏覽器我的最愛 Icon (Favorites Icons)
          設定檔 - 將家裡 IP 加入避免修改 Wiki 時點擊到 Google 廣告
          設定檔 - 網站最底部加上 Logo
          設定檔 - 加上 Google 翻譯功能
          安裝 Modules - Image Extension
          安裝 Modules - Hidden Pages Extension
          安裝 Modules - Table of Contents Extension
5、參考



2、實作環境

  • FreeBSD 8.2-RELEASE-p2
  • wiki.pl, 1.950 2011/07/06 (The Fresh wiki.pl)
  • chinese-utf8.pl,v 1.12 2009/06/07
  • image.pl,v 1.29
  • toc.pl 
  • usemod.pl,v 1.32 2007/12/09
  • perl-5.12.3



3、安裝及設定

本站之所以會使用 Oddmuse Wiki 來當我的筆記本主要原因是此 Wiki 不需要資料庫 (Database),只要你的系統有 Perl 環境 (大部份系統都有支援) 而 Web Server 支援 CGI 就可輕鬆此 Wiki 建立加上載入 Modules 方便且多樣 (Modules 仍持續增加當中) 使網站應用更為活躍,且 Oddmuse Wiki 設定簡單維護容易,這就是本站選擇的原因,至於 Oddmuse Wiki 在安裝有多簡單?只要下列四個檔案加上基本設定不用五分鐘,Oddmuse Wiki 就搞定了 (打完收工!!)
  • wiki.pl:Oddmuse wiki 主要設定檔
  • chinese-utf8.pl:正體中文語系翻譯檔
  • usemod.pl:支援 Usemod Markup Extension 語法
  • oddmuse.css:版面美化 CSS 檔 

有關 Web Server 支援 CGI 的部份,此例使用 Web Server 為 Apache 所以如下簡述 VirtualHost 設定
vi /usr/local/etc/apache/httpd.conf
### Weithenn new wiki
 <VirtualHost 61.60.59.58:80>            //指定 VirtualHost IP
    ServerAdmin weithenn@gmail.com       //指定管理者 E-Mail
    DocumentRoot "/home/web/wiki"        //指定 VirtualHost 網站根目錄
    ServerName www.weithenn.org          //指定 VirtualHost DNS Name
    ScriptAlias /cgi-bin/ /home/web/wiki/cgi-bin/   //指定 cgi-bin 對應目錄
    <Directory "/home/web/wiki/cgi-bin/">           //指定 cgi-bin 目錄相關權限設定
        AllowOverride None
        Options ExecCGI -MultiViews +SymLinksIfOwnerMatch  //此目錄允許執行 CGI
        Order allow,deny
        Allow from all
    </Directory>
    ErrorLog "/var/log/http-error-wiki.log"             //指定錯誤 Log 產生路徑及檔名
    CustomLog "/var/log/http-access-wiki.log" combined  //指定存取 Log 產生路徑及檔名
 </VirtualHost>




步驟 1. 下載 Oddmuse Wiki 相關檔案

下載 Oddmuse wiki.pl 最新版本。
cd /home/web/wiki/cgi-bin                        //切換到 cgi-bin 目錄
fetch http://www.emacswiki.org/scripts/current   //下載最新的 wiki.pl
mv current wiki.pl                               //更改名稱為 wiki.pl
chmod 755 wiki.pl                                //更改權限

下載中文翻譯語系檔 chinese-utf8.pl,chinese-utf8.pl v1.11 是我更新 chinese-utf8.pl v1.10 後 submit 上去的,若覺得翻得不好的話就幫忙更新一下吧 Oddmuse: 中文翻譯語系檔
cd /home/web/wiki
fetch http://www.oddmuse.org/cgi-bin/wiki/download/chinese-utf8.pl

下載支援 UsdMod Wiki 語法的 usemod.pl Usemod Markup Extension usemod.pl
cd /home/web/wiki
fetch http://www.emacswiki.org/scripts/usemod.pl

下載版面美化 CSS 檔,自行挑個滿意的吧。
 http://www.emacswiki.org/css/astrid.css
 http://www.emacswiki.org/css/beige-red.css
 http://www.emacswiki.org/css/blue.css
 http://www.emacswiki.org/css/cali.css
 http://www.emacswiki.org/css/green.css
 http://www.emacswiki.org/css/hug.css
 http://www.emacswiki.org/css/oddmuse.css
 http://www.emacswiki.org/css/wikio.css  

我個人是喜歡官網的 oddmuse.css
cd /home/web/wiki
fetch http://www.emacswiki.org/css/oddmuse.css




步驟 2. 建立放置 Oddmuse 資料目錄

建立放置 Oddmuse wiki 的資料目錄,此目錄屆時將存放 Oddmuse wiki 的設定頁面資料庫、參觀者記錄檔、內部連結記錄檔、近期更動記錄檔、暫存目錄...等。(預設是放在 /tmp/oddmuse),將相關檔案放置到 Oddmuse Modules 資料夾當中,屆時將自動載入相關的 Modules 檔案。若 Oddmuse wiki 的資料目錄未設定 Web Service 則首頁可能會出現無法存取訊息 Permission denied 及 Oddmuse Modules (chinese-utf8.pl、usemod.pl...etc) 無法自動載入的情況發生。
mkdir /home/web/wiki/wikidb                        //建立 wiki 資料夾
mkdir /home/web/wiki/wikidb/modules                //建立 Modules 資料夾
mv chinese-utf8.pl /home/web/wiki/wikidata/modules //搬移至 Modules 資料夾
mv usemod.pl /home/web/wiki/wikidata/modules       //搬移至 Modules 資料夾
chown www:www -R /home/web/wiki/wikidb             //設定 Web Service 可讀取執行




步驟 3. 修改 Oddmuse 設定檔 wiki.pl

需要更詳細的設定請參考

以下只列出基本修改的部份
vi /home/web/wiki/cgi-bin/wiki.pl
 $DataDir  = '/home/web/wiki/wikidb' //指定資料目錄
 $UsePathInfo = 0                    //預設值為 1,設為 0 後連結路徑才不會累加
 $SiteName = 'Weithenn Wiki';        //站台名稱 (瀏覽器左上角所顯示的名稱)
 $HomePage = 'Homepage';            //首頁連結名稱
 $HttpCharset = 'UTF-8';             //設定語系
 $StyleSheet = '/wiki/oddmuse.css';  //指定 CSS 檔案路徑
 $LogoUrl = '';                      //指定網站 Logo (網站右上方 Logo)
 $NewText = "請在此填寫新頁面內容.\n";   //New page text
 $NewComment = "請在此加入您的註解、評論與迴響.\n";  //New comment text
 $EditAllowed = 0;                   //0 = no
 $AdminPass = '';                   //填入管理者密碼
 $EditPass = '';                    //填入編輯者密碼
 $WikiLinks = 0;                    //關閉駝峰字 (CamelCase) 功能。
 $RCName = 'RecentChanges';         //最近更新頁面名稱
 $SurgeProtectionTime  = 20;        //防止 DOS 攻擊,20秒內不可讀取超過10頁面
 $SurgeProtectionViews = 10;        //防止 DOS 攻擊,幾秒內不可讀取超過 10 頁
 $MaxPost = 1024 * 210;             //上傳圖片最大解析度
 $line = $q->span({-class=>'time'}, $time . ' UTC ') . $line if $time;  //預設值 (時區)
 $line = $q->span({-class=>'time'}, $time . ' CST ') . $line if $time;  //修改後
 return sprintf('%02d:%02d UTC', $hour, $min);     //預設值 (時間)
 return sprintf('%02d:%02d CST', $hour+8, $min);   //修改後




步驟 4. 連結 Oddmuse Wiki 首頁

打完收工了? 沒錯已經設定完成了連到您的 Oddmuse Wiki 首頁去吧,此時 Oddmuse Wiki 首頁應該是白底、紅字、中文化完成並且能使用 UseMod Wiki 語法,若連結首頁後有如下狀況發生則代表設定上可能有出錯 (再檢查一下吧)
  • 若首頁的畫面為白底、藍字:代表 Oddmuse 未正確載入 oddmuse.css 檔 (路徑可能設錯),wiki.pl 中 $StyleSheet 其指定的路徑為相對於您網站根目錄 (DocumentRoot) 的設定,而不是檔案系統路徑。
  • 若首頁的畫面未中文化 (代表 Oddmuse 未正確載入 chinese-utf8.pl 檔),若無法使用 UseMod 語法 (代表 Oddmuse 未正確載入 usemod.pl 檔),這二種狀況都代表 Oddmuse Modules 載入失敗。
  • 檢查是否已設定讓 Web Service 可讀取執行 modules 資料夾? (#chown www:www -R /home/web/wiki/wikidb)
  • 檢查是否已載入 Modules? 由首頁最下方按下 Administration >> Wiki Version 查看已載入的 Modules 清單 (有可能未載入)

輸入如下 URL 連接到您的 Oddmuse Wiki 首頁吧
 http://Your_FQDN/cgi-bin/wiki.pl



4、進階設定

基本上 Oddmuse Wiki 已經架設完畢了,如果您覺得 Oddmuse Wiki 的功能就只有這樣的話那您可就錯了,以下將說明部份進階設定 (也就是我目前有使用到的,有時間會在測試新功能並分享上來)。

設定檔 - 置頂文字連結 (Goto Bar Pages)


Oddmuse Wiki 預設的 Goto Bar 只有二個頁面連結,也就是首頁 (Home) 及最近更新 (RecentChanges),您可自行修改將站內常用到的連結加入以方便快速切換到站內頁面,預設 Goto Bar 會在 Wiki 最上方及最下方顯示,本站則是除了將文字連結加上 Goto Bar 之外還加上了圖片連結。如下將 Goto Bar 修改為三個常用文字連結即首頁、最新文章、FreeBSD筆記
vi /home/web/wiki/cgi-bin/wiki.pl
 @UserGotoBarPages = ('Home', 'RecentChanges');           //預設值
 @UserGotoBarPages = ('首頁', '最新文章', 'FreeBSD筆記');    //修改後

由於 Oddmuse Wiki 預設便支援許多常用到功能例如:隨機文章、RSS...等,使用上也非常簡單例如呼叫隨機文章功能只要在 URL 最後面的 wiki.pl 加上 ?action=random 即可而 RSS 則為加上 ?action=rss,因此我們也可以將這些功能輕鬆加至 Goto Bar 上。 以建立具有隨機文章功能的文字連結
vi /home/web/wiki/cgi-bin/wiki.pl
 @UserGotoBarPages = '<a href="/cgi-bin/wiki.pl?action=random">隨機文章</a>';  //建立隨機文章連結

建立具有 RSS 功能的圖片連結 (預設情況下 RSS Feed 會送出 15 個條目,您也可以修改欲顯示的條目數量)
vi /home/web/wiki/cgi-bin/wiki.pl
 @UserGotoBarPages = '<a href="/cgi-bin/wiki.pl?action=rss"><img src="/test/data/images/rss28.png"></a>';   //建立 RSS 圖片連結


設定檔 - 呼叫小圖示 (Logo and Icons)


您可以在 Oddmuse Wiki 中隨時利用文字符號來呼叫小圖示,以下為下載 Emacswiki.org Icons 並自訂呼叫小圖示文字,設定完成後便可在 Oddmuse Wiki 文章中隨時用您自訂的文字來呼叫指定的小圖示。從 Emacswiki.org Icons 下載微笑小圖示:
cd /home/web/wiki/wikidb/icons            //切換至存放小圖示資料夾
fetch http://www.emacswiki.org/pics/smiles/smile.png   //下載微笑圖示
fetch http://www.emacswiki.org/pics/smiles/cry.png     //下載哭圖示

修改 Oddmuse 設定檔 wiki.pl
vi /home/web/wiki/cgi-bin/wiki.pl
 %Smilies = ();           //預設值
 %Smilies = (             //修改後
             quotemeta('*:c*')  => '/wikidb/icons/cry.png',      //*:c* 文字呼叫 cry.png 圖示
             quotemeta('*:)*')  => '/wikidb/icons/smile.png',);  //*:)* 文字呼叫 smile.png 圖示

修改完成後只要在您的文章中有 *:c* 文字便會呼叫 cry.png 圖示而 *:)* 文字便會呼叫 smile.png 圖示,文章中加點小圖示更顯活潑。

設定檔 - 外部連結另開新頁 (Logo and Icons)


修改 Oddmuse 設定檔使 Wiki 文章中若有連結到外面網站是另開新視窗而不是直接連結過去 (離開 Wiki),主要為修改 1152 行內容而以下行數是 wiki.pl,v 1.893 2009/01/05 為基準,若您下載的 wiki.pl 是較新的版本行數可能會不同。
  • -target=>"_blank":外部連結則開新視窗,Wiki 文章內語法為 URL SiteName
  • 將 $text 修改 "$text":外部連結文字會在文字二旁加上方框
vi /home/web/wiki/cgi-bin/wiki.pl
  1148   $url = UnquoteHtml($url); # links should be unquoted again
  1149   if ($images && $url =~ /^(http:|https:|ftp:).+\.$ImageExtensions$/i) {
  1150     return $q->img({-src=>$url, -alt=>$url, -class=>$class});
  1151   } else {
  1152     return $q->a({-href=>$url, -class=>$class}, $text);  //預設值
  1152     return $q->a({-href=>$url, -target=>"_blank", -class=>$class}, "$text");  //修改後
  1153   }

修改完成後即可完成如下所示外部連結另開新頁並加上方框,而 Wiki 內部連結則直接連結並沒有加上方框。

設定檔 - 瀏覽器我的最愛 Icon (Favorites Icons)


您可自行製作別具特色的靜態或動態圖示,當網友將您的網站加入其瀏覽器我的最愛時一眼便能看出您的用心也顯示網站的特色,若您將本站加入您瀏覽器我的最愛後可發現本站製作的動態 Favorites Icon。
  • favicon.ico 為動態圖片 (瀏覽器加入我的最愛時所顯示),解析度大小 32x32
  • favicon.gif 為動態圖片 (當網友瀏覽 Wiki 時網址旁顯示圖示),解析度大小 32x32

修改 Oddmuse wiki 設定檔將製作的 favicon.ico 及 favicon.gif 填入設定檔中 $HtmlHeaders 欄位。
vi /home/web/wiki/cgi-bin/wiki.pl
 $HtmlHeaders = '';            //預設值   $HtmlHeaders = '<link rel="shortcut icon" href="/wikidb/icons/favicon.ico"><link rel="Animate icon" href="/wikidb/icons/favicon.gif">';  //修改後


設定檔 - 將家裡 IP 加入避免修改 Wiki 時點擊到 Google 廣告

因為將 Google Adsense 廣告放在網站最下方,而當修改 Wiki 內容時因為常常會按預覽,但有可能會不小心去按到廣告為了避免被停權,於是就修改一下 wiki.pl 內容在要顯示廣告以前加入判斷若是從家裡的 IP 連到 Wiki 時就顯示其它圖片,而其它 IP 瀏覽 Wiki 時則顯示廣告。
#My Google Adsense variables:
 use vars qw($IP $MeIP1 $MeIP2);           //宣告會使用到的變數
 $IP = $ENV{'REMOTE_ADDR'};
 $MeIP1 = "61.60.59.58";                   //ex. 家裡的 IP
 $MeIP2 = "71.70.69.68";                   //ex. 公司的 IP
 if (($IP eq $MeIP1) || ($IP eq $MeIP2)){  //判斷來源為家裡的 IP 則顯示圖片
     print '換成你要顯示的圖片';
  } else {
     print '換成 Google Adsense 內容';       //若為其它來源 IP 則顯示廣告
  }


設定檔 - 網站最底部加上 Logo

修改 Oddmuse 設定檔為 Wiki 網站最底部加入 Logo,例如我想將 OddMuse 的 Logo 加入到網站的最底部該如何達成?主要是在 GetFooterLinks 內部 print $q->end_div(); 下加入即可而以下行數是以 wiki.pl,v 1.893 2009/01/05 為基準,若您下載的 wiki.pl 是較新的版本行數可能會不同。
vi /home/web/wiki/cgi-bin/wiki.pl
    2396   print GetCommentForm($id, $rev, $comment),
   2397     $q->start_div({-class=>'wrapper close'}), $q->end_div(), $q->end_div(),
   2398       $q->start_div({-class=>'footer'}), $q->hr(), GetGotoBar($id),
   2399   GetFooterLinks($id, $rev), GetFooterTimestamp($id, $rev), GetSearchForm();
   2400   if ($DataDir =~ m|/tmp/|) {
   2401     print $q->p($q->strong(T('Warning') . ': ')
   2402     . Ts('Database is stored in temporary directory %s', $DataDir));
   2403   }
   2404   print T($FooterNote) if $FooterNote;
   2405   print $q->p(GetValidatorLink()) if GetParam('validate', $ValidatorLink);
   2406   print $q->p(Ts('%s seconds', (time - $Now))) if GetParam('timing',0);
   2407   print $q->end_div();
   2408   print '<a href="http://www.oddmuse.org" target="_blank"><img src="http://www.weithenn.org/oddmuse-logo.png"></a>';  //加入此行
   2409   PrintMyContent($id) if defined(&PrintMyContent);
   2410   foreach my $sub (@MyFooters) {
   2411     print &$sub(@_);
   2412   }


設定檔 - 加上 Google 翻譯功能


您可於 Wiki 中加上 工具 - Google 翻譯 或製作出國旗圖示配合 Script 設定自動翻譯出使用者指定的語系,本例為利用國旗圖示加上 Script 並填入於設定檔 wiki.pl 中 $UserGotoBar 欄位達成 (同本站國旗翻譯功能),下列 Script 只達成單向翻譯也就是無法進行多翻譯,例如將正體中文翻譯為日文之後無法從日文在翻譯為英文。
vi /home/web/wiki/cgi-bin/wiki.pl
 <form action="http://www.google.com/translate_p" style="margin:0;padding:0;" target="_top">
  <script type="text/javascript">
   var myLocation = location.href;
   var loc = myLocation.split("http://");
   var locID = loc.length;
   var myurl = "http://"+loclocID-1;
   document.write ("<input value=\""+myurl+"\" name=\"u\" type=\"hidden\"/>");
  </script>
  <noscript><input value="" name="u" type="hidden"/></noscript>
  <input value="zh-TW" name="hl" type="hidden"/>
  <input value="UTF8" name="ie" type="hidden"/>
  <input value="" name="langpair" type="hidden"/>
  <input src="/images/Taiwan.png" value="zh-CN|zh-TW" name="langpair" title="正體中文/Chinese Traditional" onclick="this.form.langpair.value=this.value"
  align="bottom" type="image"/>
  <input src="/images/China.png" value="zh-TW|zh-CN" name="langpair" title="简体中文/Chinese Simplified" onclick="this.form.langpair.value=this.value"
  align="bottom" type="image"/>
  <input src="/images/USA.png" value="zh-TW|en" name="langpair" title="英文/English" onclick="this.form.langpair.value=this.value" align="bottom"
  type="image"/>
  <input src="/images/Japan.png" value="zh-TW|ja" name="langpair" title="日本語/Japan" onclick="this.form.langpair.value=this.value" align="bottom"
  type="image"/>
  <input src="/images/Korea.png" value="zh-TW|ko" name="langpair" title="한국어/Korea" onclick="this.form.langpair.value=this.value" align="bottom"
  type="image"/>
 </form>

補充:若想將上述 Script 用於 Blogger 上則請修改 document.write 內容其它則同上。
 document.write ("<input value=\""+myurl+"\" name=\"u\" type=\"hidden\"/>");   //用於 Oddmuse
 document.write ('<input value="'+myurl+'" name="u" type="hidden"/>');    //用於 Blogger


安裝 Modules - Image Extension


語法格式如下
 [[image:URL(Preview) | Alt Text | URL(Link)]]

  • 欄位一 URL(Preview):此欄位的 URL 功用為預覽 (Preview) 也就是屆時會出現在 Wiki 文章中的圖片 URL
  • 欄位二 Alt Text:此欄位的 Alt Text 等於是 HTML 語法的 alt="text" 功用也就是當滑鼠移到圖片上會顯示說明文字
  • 欄位三 URL(Link):此欄位的 URL 功用為實際圖片連結也就是點選圖片後連到真正圖片的 URL

例如本站將所有實作筆記中的圖片放置於 Google Picasa 中既可以達到網頁載入速度加快 (因為圖片只載入縮圖) 又可以節省頻寬 (因為圖片是連到 Google Picasa 去),如下即為使用 Oddmuse: Image Extension 的範例。
[[image:http://lh3.ggpht.com/s220/finch1.jpg|使用 UTF-8 並且記得取消勾選 CJK|http://picasaweb.google.com/weithenn/FreeBSD#866]]
下載 Oddmuse: Image Extension ,然後將該 image.pl module file 搬移至我們的 Oddmuse wiki modules 資料夾下
mv image.pl /home/web/wiki/wikidata/modules  //下載至 Modules 資料夾
chmod www:www image.pl                       //設定 Web Service 可讀取執行

在開始使用 Oddmuse: Image Extension 以前我們先修改一下此 Modules File 內容,因為此 Modules 預設網友點選此圖片時會直接連結到指定的圖片 URL 去 (也就是會離開我們的 Wiki),因此我們將其修改為點選圖片時為另開新頁連結至圖片去。
# vi /home/web/wiki/wikidata/modules/image.pl
 $result = $q->a({-href=>$link, -class=>$linkclass}, $result); //預設值
 $result = $q->a({-href=>$link, -target=>"_blank", -class=>$linkclass}, $result);  //修改後

完成上述設定後即可達成圖片功能「 縮圖、圖片文字、另開新頁連結」。

安裝 Modules - Hidden Pages Extension


此 Modules File 功能為將您有指定關鍵字的頁面加上隱藏的功能,您可以指定誰能存取這些隱藏頁面 (編輯者 Editor 或管理者 Admin),使用此功能後有可能造成一般使用者搜尋資料上的困難 (因為無法對隱藏頁面進行搜尋,進而影響到其搜尋結果),且撰寫者有說明此隱藏功能並不能保證您所要隱藏的頁面資訊擁有決對的安全性,撰寫者說若要保證頁面資訊擁有決對的安全性請建立二個 Wiki 來進行隔離。下載 Oddmuse: Hidden Pages Extension,然後將該 hiddenpages.pl module file 搬移至我們的 Oddmuse wiki modules 資料夾下:
#mv hiddenpages.pl /home/web/wiki/wikidata/modules   //下載至 Modules 資料夾
#chmod www:www hiddenpages.pl                        //設定 Web Service 可讀取執行

將 hiddenpages.pl 下載後放到您資料目錄下的 modules 資料夾下後就載入了,然後若沒您改內容的話,只要您在產生的頁面名稱最後有 Hidden 這個關鍵字,那麼這個產生的頁面就只有管理者能看而以。在開始使用 Oddmuse: Hidden Pages Extension 以前我們先修改一下此 Modules File 內容,因為此 Modules 預設其 關鍵字為 Hidden 也就是說您所建立的頁面所頁面最後含有 Hidden 這個關鍵字的話則只有編輯者 Editor 或管理者 Admin 才可連結該頁面 (視您的設定而定),而其它一般使用者欲連結該隱藏頁面時會得到 只允許管理者能看到此隱藏頁面 的回答,下例將關鍵字修改為 Password 並只允許管理者可以連結。
vi /home/web/wiki/wikidata/modules/hiddenpages.pl
 $HideAdminPages = 1;             //允許管理者可連結 (需輸入密碼)
 $HideRegExAdmin = 'Hidden$';     //預設值 (關鍵字為 Hidden)
 $HideRegExAdmin = 'Password$';   //修改後 (關鍵字為 Password)


安裝 Modules - Table of Contents Extension


此 Modules File 功能為將每篇文章內容的最上方顯示大綱 (且具有書籤功能),如此網友在閱讀文章時可快速了解此篇文章的綱要及重點並快速跳到想閱讀的部份。下載 Oddmuse: Table of Contents Extension,然後將該 toc.pl module file 搬移至我們的 Oddmuse wiki modules 資料夾下:
mv toc.pl /home/web/wiki/wikidata/modules   //下載至 Modules 資料夾
chmod www:www toc.pl                        //設定 Web Service 可讀取執行

順利載入此 Modules File 後只要 Wiki 文章內有 == (ex. == 大綱一 ==) 的語法出現,屆時便會在文章中自動產生對應的大綱標題。



5、參考

文章標籤: