由於 Mediawiki 預設的原始碼編輯器 WikiEditor 並不符合一般使用者進行編輯，所以為了可以推廣大家對於 Wiki 撰寫的熱情，特別安裝了 Visual Editor 這個可視化編輯器
安裝環境：
- CentOS 6.7
- Mediawiki 1.26.0
安裝 Visual Editor
Step.1 下載 Visual Editor，由於 Visual Editor 有對應的 Mediawiki 版本的限制，所以必須找到可適用的 Visual Editor
對應的版本可以參考這裡，或是從 Mediawiki 套件庫去搜尋你想要的套件版本
截自目前如果你直接用 git clone 最新的 Visual Editor 版本是是用於 >= 1.27，這邊範例是 1.26 版本不使用此方式
$ wget https://extdist.wmflabs.org/dist/extensions/VisualEditor-REL1_26-a733545.tar.gz $ tar zxvf VisualEditor-REL1_26-a733545.tar.gz $ mv VisualEditor /usr/share/nginx/html/mediawiki/extensions/ $ cd /usr/share/nginx/html/mediawiki/extensions/VisualEditor $ git submodule update --init
Step.2 設定 MediaWiki 支援 Visual Editor
$ vim /usr/share/nginx/html/mediawiki/LocalSettings.php // ==VisualEditor== // // 設定VisualEditor.php路徑 require_once "$IP/extensions/VisualEditor/VisualEditor.php"; //開啟預設啟用VisualEditor $wgDefaultUserOptions['visualeditor-enable'] = 1; $wgHiddenPrefs[] = 'visualeditor-enable'; // VisualEditor依靠parsoid來解析Mediawiki的tag標籤，必須設定以下參數和Parsoid相同 $wgVirtualRestConfig['modules']['parsoid'] = array( // URL to the Parsoid instance // Use port 8142 if you use the Debian package 'url' => 'http://mediawiki.com:8000', // Parsoid "domain", see below (optional) 'domain' => 'mediawiki.com', // Parsoid "prefix", see below (optional) 'prefix' => 'wiki' );
Step.3 安裝 Parsoid
$ yum install nodejs npm
$ git clone https://github.com/wikimedia/parsoid
$ mv parsoid /usr/local/
$ cd /usr/local/parsoid/
$ npm install
# 設定parsoid
$ cd /usr/local/parsoid/src/
$ cp localsettings.js.example localsettings.js
$ vim localseettings.js
'use strict';
exports.setup = function(parsoidConfig) {
parsoidConfig.setMwApi({
prefix: 'wiki',
domain: 'mediawiki.com',
uri: 'http://mediawiki.com/api.php',
});
parsoidConfig.useSelser = true;
Step.4 啟動 Parsoid
$ node /usr/local/parsoid/src/bin/server.js & [info][master] initalizing 4 workers [info][worker] loading ... [info][worker] loading ... [info][worker] loading ... [info][worker] loading ... [info][worker] ready on :8000 [info][worker] ready on :8000 [info][worker] ready on :8000 [info][worker] ready on :8000
Step.5 確認 VisualEditor 安裝完成
登入 Mediawiki，在頁面編輯上應該會多變成以下，預設「編輯」就是 VisualEditor
Step.6 為了讓 Parsoid 開機就可以啟動，寫入 rc.local
$ echo "/usr/bin/node /usr/local/parsoid/src/bin/server.js" >> /etc/rc.local
重新啟動在測試一次是否成功！
**MedaiWiki 的 api.php 是套件與 Mediawiki 之間的溝通橋樑
**Parsoid 和 VisualEditor 之間的溝通是靠 curl，所以在你的本機必須要可以解析 url 的位置，若是你的 url 使用的是 virtual hostname 但卻採用 localhost 就有可能無法解析而產生溝通錯誤！
**如果你必須使用 virtual hostname 可以在本機先進行解析 127.0.0.1 mediawiki.com
參考資料：
