[Linux] 在 Ubuntu 12.04 上安裝 MoinMoin wiki

[Linux] 在 Ubuntu 12.04 上安裝 MoinMoin wiki

因為專案的需求,需要架設一個 wiki 的網站來撰寫文件,

本來是想自己研究一下要用哪一種 wiki,

不過同事推薦使用 MoinMoin,試用了一下似乎也不錯,

就決定來裝囉~

 

1. 先安裝 Apache web server

如果已經有 Apache web server 的話就不用再安裝了,

沒有的話,執行下面的指令:

sudo apt-get update
sudo apt-get install apache2

 

安裝好之後,用瀏覽器開啟一下 http:<machine IP>,

確定一下可以看到下面的訊息:

apache  

 

2. 安裝 Apache WSGI 模組

因為 MoinMoin 是用 python 寫的,

因此我們需要安裝 WSGI 模組,讓 Apache 可以執行 python (參考這篇):

sudo apt-get install libapache2-mod-wsgi

 

3. 下載並安裝 MoinMoin

可以到 MoinMoin 的官方網站下載最新的安裝檔, 

像我這次使用的是 1.9.7 版本的~

下載下來之後,把它解開~

tar zxvf moin-1.9.7.tar.gz
cd moin-1.9.7/

 

解開之後,可以用 firefox 看一下內附的安裝說明:

firefox docs/INSTALL.html

 

安裝說明裡面有提到 Quick Installation 和 Server Installation 兩種方式,

但第一種方式需要每次開機時都去執行一個指令,比較不方便,

因此我們選擇第二種方式~~

照著說明網頁上的方式,執行 setup.py,但要記得加上 sudo:

sudo python setup.py install –force –record=install.log

 

剛安裝好的 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)~

cd /usr/local/share/moin/
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 編輯內容:

cp ~/Downloads/moin-1.9.7/wiki/config/wikiconfig.py config/
sudo vi config/wikiconfig.py

 

編輯的重點在於下面三個值~

sitename:設定成你要的 wiki 名稱

page_front_page:wiki 的首頁

superuser:系統管理者的帳號名稱。假設你想要叫 Peter 的話,就是這邊填成 superuser = [u”Peter”, ],

同時還要再去建立一個名叫 Peter 的使用者才行~

sitename = u’Untitled Wiki’
page_front_page = u“MyStartingPage”
superuser = [u“YourName”, ] 

 

除此之後,還要修改 moin.wsgi 檔案的內容:

sudo vi server/moin.wsgi

 

基本上是把下面的第一行換成第二行那樣子(把 # 註解拿掉,並設定正確的路徑):

#sys.path.insert(0, ‘/path/to/wikiconfigdir’
sys.path.insert(0, ‘/usr/local/share/moin/config’) 

 

5. 設定 Apache 去使用 MoinMoin 的 WSGI

上面改了一堆,但 Apache 其實還不知道 MoinMoin 這東東…

因此要改一下 Apache 的設定檔:

sudo vi /etc/apache2/sites-available/default

 

基本上只要把 WSGIScriptAlias 這一行放在 <VirtualHost></VirtualHost> 裡面就可以了,

放在哪一行上面倒是沒什麼關係…

<VirtualHost *:80>
    WSGIScriptAlias / /usr/local/share/moin/server/moin.wsgi
</VirtualHost>

 

做完這些修改後,記得要把 Apache 重新啟動:

sudo service apache2 restart

 

6. 用瀏覽器開啟 MoinMoin wiki

只要用瀏覽器瀏覽至 http://<IP> 就可以看到新設定好的 wiki 囉~~

接下來便可以新增使用者帳號,或者是創建新的 wiki 頁面了~~

 

蠻建議至 http://<IP>/LanguageSetup 這個連結上看看,

可以去點下 install help and system page packages 這個連結,

選擇 all_pages 安裝,這樣可以安裝預設的系統頁面,

這樣那些 Recent Changes 或 Find pages 的頁面就都可以使用了~~

moin    

 

 

//
//

(本頁面已被瀏覽過 27 次)

發表迴響

你的電子郵件位址並不會被公開。

這個網站採用 Akismet 服務減少垃圾留言。進一步瞭解 Akismet 如何處理網站訪客的留言資料