어쩌다 미디어위키에 Visual Editor를 설치 할 일이 생겨서 설치 하면서 고생을 많이 해서 정리해 둡니다 ㅜ.ㅜ.

Visual Editor Extension 설치 하기

https://www.mediawiki.org/wiki/Extension:VisualEditor

우선 이 사이트에 방문해서 아무런 생각없이 사이트에서 git으로 설치 하라는 대로 설치하고 띄워 봤더니.. 하얀 화면만 나오고 아무것도 없이 먹통이 되더군요 -_-;;

뭐가 잘 못 된지도 모르고 하얀 먹통이라서 뭐가 잘 못 된지도 모르는 채 하루를 날려 버렸습니다. 😨

결국 알아 낸것이 버전에 맞는 extension을 설치해야 하는 것이였습니다..

아래 url에 가서 내가 설치한 mediawiki와 맞는 버전을 찾아서 받아서 설치해야 합니다.

https://www.mediawiki.org/wiki/Special:ExtensionDistributor/VisualEditor

wget https://extdist.wmflabs.org/dist/extensions/VisualEditor-REL1_33-f64e411.tar.gz
tar -xzf VisualEditor-REL1_33-f64e411.tar.gz -C /var/www/mediawiki/extensions

LocalSettings.php 파일에 아래 내용을 추가해 줍니다.

wfLoadExtension( 'VisualEditor' ); 
$wgDefaultUserOptions['visualeditor-enable'] = 1; 
$wgHiddenPrefs[] = 'visualeditor-enable'; 

$wgVirtualRestConfig['modules']['parsoid'] = array( 
    'url' => 'http://mydomain.com:8000', 
);

Parsoid 설치하기

Visual Editor는 확장만 설치해서 동작하지 않고 parsoid를도 같이 설치를 해 줘야 합니다.
먼저 paroid를 사용하려면 node가 설치가 되어 있어야 합니다. 설치가 되어 있지 않다면 설치하시면 됩니다.

$ mkdir /opt/parsoid
$ cd /opt/parsoid
$ git clone https://gerrit.wikimedia.org/r/mediawiki/services/parsoid
$ cd parsoid
$ npm install
$ cp config.example.yaml config.yaml
$ cp localsettings.example.js localsettings.js

먼저 api.php의 주소를 확인 합니다. 설치된 미디어위키의 주소에서 api.php파일을 띄워서 아래와 같은 화면이 나오면 됩니다.

config.yaml에서 mwApis 부분을 아래와 같이 수정해 줍니다.

mwApis: 
- # This is the only required parameter, 
  # the URL of you MediaWiki API endpoint. 
  uri: 'http://mydomain.com/api.php'

그리고, localsettings.js파일도 아래와 같이 편집해 줍니다. domain과 prefix라는게 있는 옵션이라서 생략해도 됩니다.

'use strict'; 

exports.setup = function(parsoidConfig) { 
    parsoidConfig.setMwApi({ 
        uri: 'http://mydomain.com/api.php', 
    }); 
};

위에까지 설정이 완료 되었으면, 실행해 봅니다.

$ npm start

혹시 방화벽을 사용중이라면 방화벽을 풀어주는 것도 잊지 말아 주세요.

이제 세팅이 다 되었으니, 미디어위키에서 잘 동작하는지 테스트 해 보시면 됩니다.

pm2로 parsoid를 서비스형태로 설정해 주기..

먼저 pm2를 설치해 줍니다.

$ npm install -g pm2

그리고, parsoid가 설치된 폴더로 이동해서 실행해 줍니다.

$ cd /opt/parsoid
$ pm2 start --name parsoid start -- start

다음부터 pm2에 방금 등록한 앱을 저장해 주고 서비스로 등록해 줍니다.

$ pm2 save
$ pm2 startup

startup을 했을경우 root권한이 아닐 경우, 아래와 같은 메시지가 나옵니다.

[PM2] Init System found: systemd 
[PM2] To setup the Startup Script, copy/paste the following command: 
sudo env PATH=$PATH:/usr/bin /usr/lib/node_modules/pm2/bin/pm2 startup systemd -u USERNAME --hp /home/USERNAME

마지막 sudo가 있는 내용을 복사해서 붙여넣기 해서 실행해 주면 다음부터 컴퓨터를 껐다키면 알아서 parsoid를 실행해 주게 됩니다.