Parsoid/Developer Setup/ru

Здесь описывается установка из исходного кода. В первую очередь это полезно для разработчиков Parsoid, однако, если для вашей операционной системы нет скомпилированных пакетов Parsoid, вы также найдете это полезным.

Начальный этап
Для обратной совместимости и для продолжения поддержки не-статичных конфигурационных файлов,  должен быть настроен следующим образом:

См. для подробностей этапы "edit config.yaml" и "edit localsettings.js". См. Gerrit 'getting started' документацию для справки по "git review", что необходимо только в случае, если вы планируете поделиться изменениями кода с нами.

Если команды выше для вас непонятны, почитайте более подробные инструкции.

Убедитесь, что у вас самая последняя версия Node
Перед установкой Parsoid вы должны убедиться, что у вас установлена самая последняя версия Node.

Для Parsoid нужно node версии v6.x или выше. У нас мы используем версию v6.9.1.

Если у вас установлен node достаточно свежей версии, следуйте инструкциям на, а затем возвращайтесь сюда.

Вариант 1. Клонировать репозиторий mediawiki/services/parsoid/deploy
Возможно, это самый простой способ установить Parsoid, если вы просто хотите немного поиграться и не связываться с установкой npm.

Это установит версию Parsoid, которая развернута на данный момент в производстве наряду со всеми зависимыми элементами node. Сам код parsoid будет находиться в поддиректории src/. Модули npm будут находиться в поддиректории node_modules/.

Вариант 2. Клонировать репозиторий mediawiki/services/parsoid
Вы можете установить код Parsoid куда угодно, его не обязательно устанавливать или запускать от пользователя root.

Проверка исходников:

Или, если вы планируете хакнуть Parsoid, следуйте документации Gerrit 'getting started' и настроить  в новой ветке. (Это также создаст подлинную копию с названием  в вашем репозитории.)

Проверка версии Node: наберите  (или   в Debian/Ubuntu) и это должно вывести. (Если версия выше, тоже подойдет.) Смотрите, если это не так.

Установите JS-зависимости.

Запустите эту команду в директории Parsoid (содержащей ):

Настройка
Если вы хотите указать веб-службу Parsoid для своей wiki, зайдите в директорию  и отредактируйте файл.

Используйте параметр, чтобы указать экземпляр(ы) MediaWiki, который(е) вы хотите использовать, как здесь:

Если вы хотите указать веб-службу Parsoid для своей wiki, используя файл, раскомментируйте в файле   путь   как здесь:

а также закомментируйте параметры,   и   как здесь:

перейдите в папку  и создайте файл   на основе файла. Используйте, чтобы указать экземпляр(ы) MediaWiki, который(е) вы хотите использовать, как здесь:

Потом вы сможете получить доступ к страницам Вики в Parsoid с указанием относительного URL '/yoursite.com/v3/page/html/&lt;page-title&gt;/'

См. для более детальной информации.

Запуск сервера
Вам необходимо запустить веб-службу Parsoid из директории parsoid, используя:

а в Ubuntu 14.04 наберите вот это в директории /parsoid:

Это запустит HTTP службу Parsoid, который по умолчанию в localsettings.js будет слушать порт 8000. Чтобы его проверить, перейдите в браузере по адресу http://localhost:8000/. Если вы настроили Parsoid правильно, то вы сможете просматривать страницы через. Учтите, что эта проверка может также закончиться неудачно в случае, если ваш хостинг-провайдер отключил порт 8000 для вашей учётной записи.

Две переменные окружения доступны для контроля назначенного интерфейса и/или порта:

Автоматический запуск сервиса Parsoid
Существует много способов автоматического запуска сервисов, обратитесь к документации операционной системы вашего сервера.

Upstart (Ubuntu)
В Ubuntu и других операционных системах, использующих Upstart, это достигается за счёт:

где  содержит конфигурацию подобную 's :

To test your configuration type

If the answer is "syntax ok" you can start the service:

To check, if the service is running, type

And if you want to stop your node.js-parsoid-server you can do this with

You can find more helpful instructions to get node running as server with ubuntu in this article: The Upstart Event System: What It Is And How To Use It

Fedora
В последних версиях Fedora и других операционных системах, использующих systemd, используйте файл от parsoid.service, подобный следующему шаблону (измените соответствующие пути файла):

Опциональная директива  выше может указывать путь к файлу, подобный следующему шаблону:

Вы также можете использовать PM2, чтобы демонизировать приложение server.js.

Установка с помощью npm:

Запуск server.js через PM2:

Сервер Parsoid теперь работает и управляется с помощью PM2. Сохраните список процессов:

Теперь, когда запускается PM2, сервер Parsoid будет запускаться и управляться с помощью PM2. Последний шаг - заставить PM2 автоматически запускаться при загрузке системы:

Для более старых релизов Ubuntu, которые используют, используйте это в качестве [platform] вместо 'ubuntu'.

См. баг T69313 для порядка упаковки, что позволит сделать общую установку проще.

Автоматический запуск на macOS
На macOS вы можете создать файл plist. This is an example of a suitable plist (adapt the parsoid and config.yaml paths to your system):

Save it as org.mediawiki.parsoid.start.plist in /Library/LaunchDaemons and change to root user & wheel group, correct permissions, and add it as a persistent launchd job (so that it will restart on the next reboot).

Passenger
This is probably not recommended. If using passenger, make sure that num_workers in config.yaml is set to 0, otherwise it won't bind to passenger's socket properly.

Gentoo Linux, Funtoo Linux
Add a config.yaml file in the install location (/usr/lib64/node_modules/parsoid), see example file.

Касательно файла init.d, считая что Node установлен в папку по умолчанию, а Parsoid установлен общесистемно (npm install -g)

Лучшей идеей будет запустить Parsoid без прав root. Создадим непривилегированную системную учетную запись:

И наш скрипт init.d изменится таким образом (предполагая каталоги по умолчанию, общесистемную установку):

FreeBSD
startup script from https://www.reddit.com/r/freebsd/comments/4ft79b/best_practice_for_daemonizing_nodejs/d2earq1/

Установка на Windows
Шаги те же самые, что и при установке Parsoid на Linux:

git clone https://gerrit.wikimedia.org/r/mediawiki/services/parsoid cd parsoid npm install

Если npm install дает сбой, говоря, что npm неизвестная команда, попробуйте добавить каталог nodesjs в переменную среды PATH, как описывалось ранее в секции Установки необходимого ПО, и запустите npm install напрямую из папки parsoid, созданной командой git clone.

Если установка снова не удается, можно попробовать отключить брандмауэр в маршрутизаторе.

Когда установка завершится, настройте Parsoid и запустите его (server.js должен быть расположен в папке bin\, а не в api\ в более новых версиях Parsoid):

node bin\server.js

Чтобы запустить parsoid в фоне, создайте командный файл в папке Parsoid с названием parsoid.bat. Создайте задачу в "планировщике" для ее запуска при загрузке. В качестве альтернативы в интернете существуют несколько команд "запуск командного файла как сервис".

@echo off "%ProgramFiles(x86)%\nodejs\node.exe" bin\server.js

Если используется командный файл в качестве "назначенного задания", может потребоваться использовать полный путь к файлу server.js (например, C:\www\parsoid\bin\server.js) вместо bin\server.js.

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

git config --global -e

Это запустит редактор. Теперь нажмите i один раз, и в режиме вставки наберите:

[http] proxy = http://proxy.company.com:8080

И, наконец, нажмите ESC, а затем наберите :wq и нажмите Enter, чтобы сохранить изменения. Теперь прокси включен.

Windows Server 2008 R2
MediaWiki должен быть установлен, а также установлено расширение Visual Editor.

Troubleshooting
If things are still not working, then see our troubleshooting page.

См. также

 * Installation on a shared host
 * VisualEditor and Parsoid server installation from Git on Mac OSX (Ujjwal P)
 * https://morecomputerstuff.wordpress.com/2016/01/16/mediawiki-on-windows/
 * https://morecomputerstuff.wordpress.com/2016/01/16/mediawiki-on-windows/