2016年4月24日 星期日

Mediawiki 1.26.0 安裝可視化編輯器 Visual Editor

由於 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
$ 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/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

ScreenShot 2016-04-24 04.07.09

 

 

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

 

參考資料:

Parsoid github

MediaWiki-VisualEditor

Orignal From: Mediawiki 1.26.0 安裝可視化編輯器 Visual Editor

沒有留言:

張貼留言