?

CWoW Developer Group(CWDG)從2006年開始在一直使用 MoinMoinWiki 來構建一個魔獸世界游戲插件開發技術知識庫, 這2年中wiki的版本也從1.5變更到了1.7.

moin1.6是一個變化最大的版本, 連不少wiki語法都改變了, 最顯著的莫過于內連接的語法原先是["xxx"]現在與mediawiki一致了[[xxx]], 還有不少細節語法的改變, 這不知是一件好事還是壞事, 好事是和mediawiki大多語法兼容了方便內容移植, 壞事是googlecode的wiki還是在使用moin的老語法, 而且看起來來google并不打算向mediawiki類語法兼容而是繼續保持下去這個風格. 但總之就是引起的1.5~1.6的升級困難, 除了常規步驟外需要做數據轉換工作, 雖然moin提供了轉換腳本. 時隔大半年我也忘記了當初是如何升級上來了, 慚愧, 只好在此介紹一些通用的優化與維護的經驗. 適用環境: DreamHost, Linux.

?

站點結構的安排

一個好的站點目錄結構設置能夠使升級, 備份, 移植都非常方便. 這里僅以單wiki站點為例(moin支持多wiki站點). 目標是把我們的數據與wiki程序分離開.

一個安裝好wiki(如何安裝參考我以前的文章)通常包含4個部分

wiki主程序部分

共享資源文件部分(共享的theme, img, css, js等文件)

wiki實例部分(我們的數據)

web訪問部分(web目錄, web訪問的入口通常只包含一個入口moin.cgi文件)

出于安全考慮, 把wiki實例部分放到了非web目錄下, 這樣除了1部分其余部分都會包含我們自己的數據, 需要做進一步整合.

#程序主目錄 /lib/lib/python2.5/site-packages/MoinMoin #共享資源目錄 /lib/share/MoinMoin ? /config ? /data ? /htdocs (主題目錄) ? /server ? /underlay (在線幫助文件目錄) #wiki實例 /MoinMoin ? /cwdgwiki (wiki實例目錄) ??? /data ????? /pages (wiki數據) ????? /plugin (自定義擴展插件目錄) ????? /user (此wiki下的用戶目錄) ????? ... ??? /underlay ??? wikiconfig.py (此wiki實例的配置文件) ??? logconfig (此wiki實例的log配置文件) #web目錄 /wiki.cwowaddon.com ? /theme (主題目錄) ? /img (其他圖片文件目錄) ? moin.fcgi (web入口程序) ? .htaccess

需要調整的地方集中在共享資源目錄中.

/htdocs提供了默認及自定義主題文件, 將/htdocs中的內容完全移動到web目錄下的/theme中

/underlay 目錄提供了固定的幫助文件, 將/underlay目錄全移動到wiki實例的/data中

最后在wiki實例目錄下的wikiconfig.py 中設置上面的2個路徑信息

其余部分都是些模板文件, 不會被實際引用到, 因此可以把這個共享資源目錄刪掉了. 這下只留下了2部分我們自己的文件一部分是數據文件一部分是web需要的靜態文件. 還有一點需要注意, 如果你對wiki寫了一些自定義擴展如macro等, 一定要放在wiki實例目錄下的plugin中. 日后升級只需要把wiki主程序刪掉重新裝一次就ok了.

?

性能優化

性能永遠是我們關注的主題, 在dreamhost的cgi模式下wiki的速度可以用龜速來形容, 尤其在升級到1.7后使用cgi每個頁面需要50s的時間, 讓人無法接受. 從3個方面來進行性能優化.

使用fastcgi
moin提供了好幾種可提高性能的訪問方式, 需要根據你的服務器情況來選擇, fastcgi是最為常見的一種, 需要你在服務器上打開對fastcgi的支持. 在安裝包的wiki/server目錄下你可以找到moin.fcg這個文件(具體設置見我以前的文章), 需要注意的一點在dreamhost中, 以前.fcg是可用的, 但1.6以后就不能用了, 我一直沒找到這個原因, 導致CWDG的wiki一直運行在龜速下, 直到1.7 反復調式才發現只需改名成moin.fcgi就沒問題了.

使用xapian全文檢索組件
xapian是從1.6就引入的全文檢索組件代替了以前的lupy, 使得檢索性能能夠大幅提升. 下面簡單介紹下安裝步驟:

wget http://oligarchy.co.uk/xapian/1.0.6/xapian-core-1.0.6.tar.gz tar zxf xapian-core-1.0.6.tar.gz cd xapian-core-1.0.6 ./configure --prefix=$HOME make make install wget http://oligarchy.co.uk/xapian/1.0.6/xapian-bindings-1.0.6.tar.gz tar zxf xapian-bindings-1.0.6.tar.gz cd xapian-bindings-1.0.6 ./configure --without-php --without-ruby --without-java --without-java-swig --without-csharp --without-tcl8 --with-python --prefix=$HOME XAPIAN_CONFIG=$HOME/bin/xapian-config make make install cd /lib/lib/python2.5/site-packages/MoinMoin/script/ python moin.py --config-dir=/MoinMoin/cwdgwiki --wiki-url=http://wiki.cwowaddon.com/ index build --mode=add

一個是安裝xapian-core, 一個是安裝xapain的python綁定程序, 最后是生成索引. 接下來在wikiconfig.py 中設置

xapian_search = True xapian_index_history = False xapian_stemming = False

xapian_index_history 代表是否從歷史版本中搜索, 一般情況下不需要.
xapian_stemming 是詞根時態分詞作用, 中文沒有, 而且在中文下會有問題, 建議不要打開.

上面2項做完后wiki性能提高近10倍.
?

定期清理垃圾文件
由于moin是基于文件系統存儲的wiki, 所以經常在編輯的時候會產生些垃圾文件, 比如訪問了一個未建的鏈接就會產生一個空目錄, 放棄編輯一個詞條則會產生一個edit-lock文件, 偶爾會因未知原因造成詞條死鎖導致任何人都無法再編輯. 這些文件的增多對性能有少許影響, 對備份管理也很不利. 因此我重寫了一個清理腳本代替了以前功能不足的腳本.
請將http://files.cnblogs.com/simonw/cleanpage.zip拷貝覆蓋moin主程序/script/cleanpage.py 執行下面的腳本即可

cd /lib/lib/python2.5/site-packages/MoinMoin/script/ python moin.py --config-dir=/MoinMoin/cwdgwiki? --wiki-url=http://wiki.cwowaddon.com/ maint cleanpage

轉載于:https://www.cnblogs.com/simonw/archive/2008/07/13/1241958.html

總結

以上是生活随笔為你收集整理的MoinMoin Wiki 1.7优化与维护经验的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。