IT-блог Жаконды

VisualEditor — это удобный редактор (Wysiwyg) страниц в MediaWiki. Рассмотрим как его установить на MediaWiki 1.30.0 на Debian 8 Jessie/Ubuntu Server 14.04 LTS

Исходные данные:

• ОС Debian 8 Jessie
• Mediawiki 1.30.0 (развернута по данной статье)

Подготовка системы

Перед началом установки обновляем систему до актуального состояния:

apt-get update && sudo apt-get upgrade -y

Устанавливаем необходимые зависимости:

apt-get install php5-curl -y

Установка NodeJS & NPM

Добавляем необходимый PPA, для установки актуальной версии NodeJS:

apt-get install curl python-software-properties
curl -sL https://deb.nodesource.com/setup_8.x | sudo bash -

Устанавливаем NodeJS, пакет NPM также будет установлен.

apt-get install nodejs

Проверим версии установленных NodeJS и NPM:

node -v 
v8.10.0

npm -v 
5.6.0

Установка Parsiod

Добавляем необходимый PPA, устанавливаем Parsoid:

apt-key advanced --keyserver pgp.mit.edu --recv-keys 90E9F83F22250DD7
echo > "deb https://releases.wikimedia.org/debian jessie-mediawiki main" | sudo tee /etc/apt/sources.list.d/parsoid.list
apt-get update
apt-get install apt-transport-https
apt-get install parsoid

В конфигурационный файл (/etc/mediawiki/parsoid/config.yaml), добавляем данные для подключения с API MediaWiki:

mwApis:
        - # First wiki
          uri:'http://yoursite.com/api.php'
          # domain:'yoursite.com'  # optional

Перезапускаем Parsoid:

service parsoid restart

Установка расширения VisualEditor

Скачиваем расширение VisualEditor, для нужной версии версии MediaWiki (прим. 1.30.0) (https://www.mediawiki.org/wiki/Special:ExtensionDistributor/VisualEditor):

wget https://extdist.wmflabs.org/dist/extensions/VisualEditor-REL1_30-61f161a.tar.gz
tar -xzf VisualEditor-REL1_30-61f161a.tar.gz -C /var/www/mediawiki/extensions

В конфигурационный файл (/var/www/mediawiki/LocalSettings.php) добавляем следующие параметры:

# VisualEditor
wfLoadExtension('VisualEditor');
 
// Enable by default for everybody
$wgDefaultUserOptions['visualeditor-enable'] = 1;

// Don't allow users to disable it
$wgHiddenPrefs[] = 'visualeditor-enable';
 
// OPTIONAL: Enable VisualEditor's experimental code features
#$wgDefaultUserOptions['visualeditor-enable-experimental'] = 1;
 
$wgSessionsInObjectCache = true;
$wgVirtualRestConfig['modules']['parsoid']['forwardCookies'] = true;
 
$wgVirtualRestConfig['modules']['parsoid'] = array('url' => 'http://yoursite.com:8142');

Запускаем скрипт обновления данных в MediaWiki (после подключения любых расширений в MediaWiki, необходимо выполнять данное действие, иначе подключенные расширения в LocalSettings.php будут проигнорированы). Так же перезапускаем службу apache:

php /var/www/mediawiki/maintenance/update.php
service apache2 restart

Вот так выглядит VisualEditor:

Понравилась или оказалась полезной статья, поблагодари автора