[Linux] 在 Ubuntu 12.04 上安裝 MoinMoin wiki
因為專案的需求，需要架設一個 wiki 的網站來撰寫文件，
本來是想自己研究一下要用哪一種 wiki，
不過同事推薦使用 MoinMoin，試用了一下似乎也不錯，
就決定來裝囉～
1. 先安裝 Apache web server
如果已經有 Apache web server 的話就不用再安裝了，
沒有的話，執行下面的指令：
sudo apt-get install apache2
安裝好之後，用瀏覽器開啟一下 http:<machine IP>，
確定一下可以看到下面的訊息：
2. 安裝 Apache WSGI 模組
因為 MoinMoin 是用 python 寫的，
因此我們需要安裝 WSGI 模組，讓 Apache 可以執行 python （參考這篇）：
3. 下載並安裝 MoinMoin
可以到 MoinMoin 的官方網站下載最新的安裝檔，
像我這次使用的是 1.9.7 版本的～
下載下來之後，把它解開～
cd moin-1.9.7/
解開之後，可以用 firefox 看一下內附的安裝說明：
安裝說明裡面有提到 Quick Installation 和 Server Installation 兩種方式，
但第一種方式需要每次開機時都去執行一個指令，比較不方便，
因此我們選擇第二種方式～～
照著說明網頁上的方式，執行 setup.py，但要記得加上 sudo：
剛安裝好的 MoinMoin 預設會放在 /usr/local/share/moin 這個目錄下面～
4. 設定 MoinMoin
假設我們原先的 MoinMoin 安裝檔是解在 ~/Downloads/moin-1.9.7 的話，
要先把那下面的 wiki/data 和 wiki/underlay 兩個目錄複製到 /usr/local/share/moin/ 目錄下，
並把 owner 改成 www-data （也就是 Apache user）～
sudo cp -R ~/Downloads/moin-1.9.7/wiki/data ./
sudo cp -R ~/Downloads/moin-1.9.7/wiki/underlay ./
sudo chown www-data -R data underlay
接著要設定一下 wikiconfig.py，
先從安裝包中複製 wiki/config/wikiconfig.py 到 config 目錄下，再用 vi 編輯內容：
sudo vi config/wikiconfig.py
編輯的重點在於下面三個值～
sitename：設定成你要的 wiki 名稱
page_front_page：wiki 的首頁
superuser：系統管理者的帳號名稱。假設你想要叫 Peter 的話，就是這邊填成 superuser = [u”Peter”, ]，
同時還要再去建立一個名叫 Peter 的使用者才行～
page_front_page = u“MyStartingPage”
superuser = [u“YourName”, ]
除此之後，還要修改 moin.wsgi 檔案的內容：
基本上是把下面的第一行換成第二行那樣子（把 # 註解拿掉，並設定正確的路徑）：
sys.path.insert(0, ‘/usr/local/share/moin/config’)
5. 設定 Apache 去使用 MoinMoin 的 WSGI
上面改了一堆，但 Apache 其實還不知道 MoinMoin 這東東…
因此要改一下 Apache 的設定檔：
基本上只要把 WSGIScriptAlias 這一行放在 <VirtualHost></VirtualHost> 裡面就可以了，
放在哪一行上面倒是沒什麼關係…
WSGIScriptAlias / /usr/local/share/moin/server/moin.wsgi
</VirtualHost>
做完這些修改後，記得要把 Apache 重新啟動：
6. 用瀏覽器開啟 MoinMoin wiki
只要用瀏覽器瀏覽至 http://<IP> 就可以看到新設定好的 wiki 囉～～
接下來便可以新增使用者帳號，或者是創建新的 wiki 頁面了～～
蠻建議至 http://<IP>/LanguageSetup 這個連結上看看，
可以去點下 install help and system page packages 這個連結，
選擇 all_pages 安裝，這樣可以安裝預設的系統頁面，
這樣那些 Recent Changes 或 Find pages 的頁面就都可以使用了～～
//
//