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



 

 

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