Поиск по сайту:

Как установить Визуальный редактор для MediaWiki на CentOS 7

На этой странице

  1. Предпосылки
  2. Что мы будем делать
  3. Шаг 1. Проверка установки MediaWiki
  4. Шаг 2. Установите зависимости
  5. Шаг 3. Установите и настройте Parsoid
  6. Шаг 4. Установите и настройте Визуальный редактор
  7. Шаг 5. Тестирование
  8. Справочник

VisualEditor — это редактор форматированного текста для MediaWiki. Он доступен как расширение и полагается на сервис парсера Parsoid, который работает и работает для редактирования страниц MediaWiki.

Что касается Parsoid, это сервис парсера, основанный на Nodejs. Его используют многие расширения MediaWiki, включая VisualEditor, Flow, Content Translation и другие приложения.

В этом руководстве я покажу вам, как шаг за шагом установить и настроить VisualEditor для последней версии MediaWiki 1.30. Стоит поделиться тем, что наша MediaWiki установлена под операционной системой CentOS 7, и мы добавим и установим Nodejs, сервис Parsoid и настроим VisualEditor для редактора MediaWiki.

Предпосылки

  • CentOS 7 с установленной MediaWiki
  • Привилегии root

Что мы будем делать

  1. Проверьте установку MediaWiki
  2. Установить зависимости
  3. Установите и настройте службу Parsoid.
  4. Установите и настройте Визуальный редактор для MediaWiki.
  5. Проверьте настройку

Шаг 1. Проверьте установку MediaWiki.

На этом этапе мы проверим нашу установку MediaWiki. MediaWiki устанавливается под доменным именем http://wiki.hakase-labs.me. Откройте веб-браузер и перейдите по следующему URL-адресу MediaWiki, мой: http://wiki.hakase-labs.me/

Вы будете перенаправлены на HTTPS-соединение, после чего попадете на страницу MediaWiki со скином Vector, подобным показанному ниже.

Затем войдите в систему как администратор и попробуйте отредактировать страницу. Нажмите на вкладку «Редактировать», и вы получите редактор MediaWiki по умолчанию, как показано ниже.

MediaWiki запущен и работает без ошибок.

Шаг 2 — Установите зависимости

Чтобы установить службу Parsoid и настроить VisualEditor, нам нужно, чтобы в системе были установлены некоторые пакеты CentOS. В частности, мы установим Nodejs, npm, vim и git.

Установите все необходимые пакеты с помощью команды yum ниже.

yum -y install nodejs npm vim-enhanced git

Все пакеты и зависимости установлены.

Шаг 3 - Установите и настройте Parsoid

Parsoid можно установить на отдельный сервер MediaWiki. Но для этого урока мы будем использовать только 1 сервер CentOS 7 как для MediaWiki, так и для Parsoid.

Теперь, поскольку мы использовали сервер CentOS 7, нам нужно установить службу Parsoid вручную из исходного кода, поскольку официальные пакеты доступны только для операционных систем на базе Ubuntu/Debian.

Итак, для начала создайте новый каталог /opt/parsoid и клонируйте последнюю версию parsoid с помощью команды git, как показано ниже.

mkdir -p /opt/parsoid
git clone https://gerrit.wikimedia.org/r/p/mediawiki/services/parsoid /opt/parsoid

Теперь перейдите в каталог /opt/parsoid и установите службу Parsoid с помощью следующей команды npm.

cd /opt/parsoid
npm install

После завершения установки вы получите результат, как показано ниже.

Затем настройте службу Parsoid, отредактировав соответствующие файлы конфигурации.

Скопируйте пример конфигурации localsettings.example.js в localsettings.js, а затем отредактируйте файл с помощью vim.

cp localsettings.example.js localsettings.js
vim localsettings.js

Раскомментируйте строку parsoidConfig.setMwApi и измените значение uri на URL-адрес API MediaWiki, как показано ниже.

exports.setup = function(parsoidConfig) {
         // Do something dynamic with `parsoidConfig` like,
         parsoidConfig.setMwApi({
                 uri: 'http://wiki.hakase-labs.me/api.php',
          });
 };

Вот и все. Сохранить и выйти.

Теперь скопируйте конфигурацию config.example.yaml в config.yaml и отредактируйте ее с помощью редактора vim.

cp config.example.yaml config.yaml
vim config.yaml

В строке mwApis (строка номер 34) измените значение uri на URL-адрес API MediaWiki, а значение домена — на собственное доменное имя.

 mwApis:
         - # This is the only required parameter,
           # the URL of you MediaWiki API endpoint.
           uri: 'http://wiki.hakase-labs.me/api.php'
           # The "domain" is used for communication with Visual Editor
           # and RESTBase.  It defaults to the hostname portion of
           # the `uri` property above, but you can manually set it
           # to an arbitrary string. It must match the "domain" set
           # in $wgVirtualRestConfig.
           domain: 'wiki.hakase-labs.me' 
           #optional

Сохранить и выйти.

Далее мы настроим Parsoid как сервис. Для этого перейдите в каталог /etc/systemd/system и создайте новый служебный файл с именем parsoid.service.

cd /etc/systemd/system/
vim parsoid.service

Вставьте конфигурацию службы Parsoid ниже.

[Unit]
 Description=Mediawiki Parsoid web service on node.js
 Documentation=http://www.mediawiki.org/wiki/Parsoid
 Wants=local-fs.target network.target
 After=local-fs.target network.target
 
 [Install]
 WantedBy=multi-user.target
 
 [Service]
 Type=simple
 User=root
 Group=root
 WorkingDirectory=/opt/parsoid
 ExecStart=/usr/bin/node /opt/parsoid/bin/server.js
 KillMode=process
 Restart=on-success
 PrivateTmp=true
 StandardOutput=syslog

Сохранить и выйти. Затем выполните следующую команду перезагрузки.

systemctl daemon-reload

Теперь запустите службу Parsoid и включите ее выполнение каждый раз при загрузке системы.

systemctl start parsoid
systemctl enable parsoid

Теперь Parsoid должен работать как служба в CentOS 7, используя порт 8000. Вы можете проверить это с помощью команды netstat следующим образом.

netstat -plntu

И вы должны получить результат, подобный следующему:

Установка и настройка parsoid завершена.

Примечание:

Если на вашем сервере запущен Firewalld, добавьте порт parsoid 8000 в конфигурацию firewalld, используя следующие команды.

firewall-cmd --add-port=8000/tcp --permanent
firewall-cmd --reload

Шаг 4 - Установите и настройте Визуальный редактор

На этом этапе мы установим и настроим расширения VisualEditor для MediaWiki.

Перейдите в каталог установки MediaWiki /var/www/mediawiki/extensions и загрузите последнюю версию VisualEditor с помощью git.

cd /var/www/mediawiki/extensions
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/VisualEditor.git

Теперь перейдите в каталог VisualEditor и инициализируйте и обновите все подмодули внутри него.

cd VisualEditor/
git submodule update --init

Далее нам нужно отредактировать файл конфигурации Mediawiki LocalSettings.php, чтобы включить визуальный редактор. Для этого перейдите в каталог mediawiki и отредактируйте файл LocalSettings.php с помощью vim.

cd /var/www/mediawiki
vim LocalSettings.php

Вставьте конфигурацию ниже ближе к концу файла.

wfLoadExtension( 'VisualEditor' );
 
 // Enable by default for everybody
 $wgDefaultUserOptions['visualeditor-enable'] = 1;
 
 // Optional: Set VisualEditor as the default for anonymous users
 // otherwise they will have to switch to VE
 // $wgDefaultUserOptions['visualeditor-editor'] = "visualeditor";
 
 // Don't allow users to disable it
 $wgHiddenPrefs[] = 'visualeditor-enable';
 
 // OPTIONAL: Enable VisualEditor's experimental code features
 #$wgDefaultUserOptions['visualeditor-enable-experimental'] = 1;
 
 
 $wgVirtualRestConfig['modules']['parsoid'] = array(
     // URL to the Parsoid instance
     // Use port 8142 if you use the Debian package
     'url' => 'http://wiki.hakase-labs.me:8000',
     // Parsoid "domain", see below (optional)
     'domain' => 'wiki.hakase-labs.me',
     // Parsoid "prefix", see below (optional)
     'prefix' => 'wiki.hakase-labs.me'
 );

Вот и все. Сохранить и выйти.

Примечание:

Пожалуйста, измените URL на ваше собственное доменное имя.

Затем измените права собственности для каталога mediawiki на пользователя и группу nginx.

chown -R nginx:nginx /var/www/mediawiki

Установка расширений Визуального редактора завершена.

Шаг 5 - Тестирование

Откройте веб-браузер и перейдите по следующему URL-адресу MediaWiki, мой: http://wiki.hakase-labs.me

Теперь войдите в систему как администратор.

После входа в систему щелкните вкладку «Редактировать», чтобы отредактировать домашнюю страницу. Вы должны получить VisualEditor, как показано ниже.

Установка VisualEditor и настройка MediaWiki на CentOS 7 успешно завершена.

Ссылка

  • https://www.mediawiki.org/wiki/Extension:Визуальный редактор