Configuració de Parsoid/Desenvolupador

• Deutsch
• English
• català
• español
• русский
• 中文
• 日本語
• 閩南語 / Bân-lâm-gí
• 한국어

Inici ràpid

node-v# hauria de ser la versió 6.x o superior
gitclonehttps://gerrit.wikimedia.org/r/mediawiki/services/parsoid
cdparsoid
gitreview-s# Opcional, mireu més avall
npminstall
npmtest# pot també - requires nsp, eslint to be installed
cpconfig.example.yamlconfig.yaml
editconfig.yaml
npmstart

editlocalsettings.js
//Notethataconfig.yamlisstillrequired
editconfig.yaml
//Addapathtothefileas,"localsettings: ./localsettings.js"
//Seethecommentsinconfig.yamlfordetails
npmstart

Assegureu-vos de tenir un node recent

Instal·lació del codi font sobre Linux o Mac OS X

Opció 1. Cloneu el repositori de mediawiki/services/parsoid/deploy

$ gitclone--recursivehttps://gerrit.wikimedia.org/r/mediawiki/services/parsoid/deploy

Opció 2. Cloneu el repositori de mediawiki/services/parsoid

gitclonehttps://gerrit.wikimedia.org/r/mediawiki/services/parsoid

cdparsoid
git-review-s

npminstall

Configuració

mwApis:
-# Aquest és l'únic paràmetre obligatori, l'URL del punt final de l'API de MediaWiki.
uri:'http://yoursite.com/w/api.php'
# El "domain" s'utilitza per a la comunicació amb Visual Editor i RESTBase.
# Per defecte, es troba la part del nom d'amfitrió (''hostname'') de la propietat `uri` a continuació, però podeu configurar-la manualment en una cadena arbitrària.
domain:'yoursite.com'# opcional

# Per obtenir una compatibilitat cap enrere i seguir donant suport a configuracions no estàtiques, de moment, opcionalment, proporcioneu una ruta a un fitxer localsettings.js.
# Vegeu localsettings.example.js
localsettings:./localsettings.js

#mwApis:
#- # Aquest és l'únic paràmetre obligatori, l'URL del punt final de l'API de MediaWiki.
#uri: 'http://localhost/w/api.php'
# El "domain" s'utilitza per a la comunicació amb Visual Editor i RESTBase.
# Per defecte, es troba la part del nom d'amfitrió (''hostname'') de la propietat `uri` a continuació, però podeu configurar-la manualment en una cadena arbitrària.
#domain: 'localhost' # opcional

parsoidConfig.setMwApi({uri:'http://yoursite.com/w/api.php',domain:'yoursite.com',prefix:'someuniqueid'});

Fent anar el servidor

nodebin/server.js

nodejsbin/server.js

exportINTERFACE=127.0.0.1
exportPORT=8142
nodejsbin/server.js

Iniciant el servei Parsoid automàticament

Upstart (Ubuntu)

sudoln-s/lib/init/upstart-job/etc/init.d/parsoid
sudovi/etc/init/parsoid.conf

# vim: set ft=upstart:
# Configuració de treballs de Upstart per Parsoid
description"Parsoid HTTP service"
starton(local-filesystemsandnet-device-upIFACE!=lo)
stoponrunlevel[!2345]
setuid"www-data"
setgid"www-data"
envVCAP_APP_PORT="8000"
envNODE_PATH="/js/node_modules"
chdir"/path/to/parsoid"
execnodejsbin/server.js
respawn

init-checkconf/etc/init/parsoid.conf

sudoserviceparsoidstart

serviceparsoidstatus

sudoserviceparsoidstop

Fedora

[Unit]
Description=MediaWikiParsoidwebserviceonnode.js
Documentation=https://www.mediawiki.org/wiki/Parsoid
Wants=local-fs.targetnetwork.target
After=local-fs.targetnetwork.target
[Install]
WantedBy=multi-user.target
[Service]
Type=simple
# or better, use a dedicated user "parsoid"
User=nobody
WorkingDirectory=/path/to/parsoid
EnvironmentFile=-/etc/parsoid/parsoid.env
ExecStart=/usr/bin/nodejs/path/to/parsoid/bin/server.js
PrivateTmp=true
PrivateDevices=true
ProtectSystem=full
ProtectHome=true
NoNewPrivileges=true
CapabilityBoundingSet=
ReadOnlyPaths=/

PORT=8000
NODE_PATH=/path/to/parsoid/node_modules

npminstall-gpm2

pm2start/path/to/parsoid/bin/server.js

pm2save

# EL''renderstartup-script''peraunaplataformaespecífica,la[plataforma]podriaserunade:
# ubuntu|centos|redhat|gentoo|systemd|darwin|amazon
$ pm2startup[platform]

Iniciant automàticament en macOS

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN"
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plistversion="1.0">
<dict>
<key>Label</key>
<string>org.mediawiki.parsoid.start</string>
<key>ProgramArguments</key>
<array>
<string>/usr/local/bin/node</string>
<string>/path/to/parsoid/bin/server.js</string>
<string>--config</string>
<string>/path/to/config.yaml</string>
</array>
<key>RunAtLoad</key>
<true/>
<key>KeepAlive</key>
<true/>
<key>UserName</key>
<string>root</string>
</dict>
</plist>

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).

sudochownroot:wheel/Library/LaunchDaemons/org.mediawiki.parsoid.start.plist
sudochmodo-w/Library/LaunchDaemons/*
sudolaunchctlload-w/Library/LaunchDaemons/org.mediawiki.parsoid.start.plist

Passenger

Gentoo Linux, Funtoo Linux

emerge-av'>=dev-lang/nodejs-0.10'# install nodejs in the 0.10.x series or higher
gitclonehttps://gerrit.wikimedia.org/r/mediawiki/services/parsoid# check out source
cdparsoid# enter checked-out source
npminstall-g# download parsoid's nodejs library dependencies and install system-wide

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

As an init.d file, supposing that node is installed in its default location and parsoid installed system-wide (npm install -g)

pidfile="/var/run/parsoid.pid"
command="/usr/bin/node"
command_args="/usr/lib64/node_modules/parsoid/bin/server.js"
command_background="true"
depend(){
neednet
}

useradd-r-s/sbin/nologin-d/dev/null-M-c'Unprivileged system account for Parsoid'parsoid

And our init.d script would change accordingly (assuming default locations, system-wide installation):

#!/sbin/runscript
PARSOID_PIDFILE="/var/run/parsoid.pid"
NODE="/usr/bin/node"
NODE_FOLDER="/usr/lib64/node_modules/parsoid"
NODE_OPTS="/usr/lib64/node_modules/parsoid/bin/server.js"
depend(){
neednet
}
start(){
ebegin"Starting parsoid"
start-stop-daemon--start--quiet\
--pidfile"${PARSOID_PIDFILE}"\
--chdir${NODE_FOLDER}\
--make-pidfile--background\
--userparsoid--groupparsoid\
--exec${NODE}--${NODE_OPTS}
eend$?
}
stop(){
ebegin"Stopping parsoid"
start-stop-daemon--stop--quiet\
--pidfile"${PARSOID_PIDFILE}"
eend$?
}

FreeBSD

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

#!/bin/sh
#
# PROVIDE: parsoid
# REQUIRE: LOGIN nginx
# KEYWORD: shutdown
# parsoid_enable="yes"
./etc/rc.subr
name="parsoid"
rcvar=parsoid_enable
parsoid_pid=/var/run/parsoid.pid
# Can also be -9 etc. -HUP usually will only cause sadness.
sig_stop=-KILL
start_cmd=parsoid_start
stop_cmd=parsoid_kill
#restart_cmd=parsoid_restart # didn't bother to implement
load_rc_config${name}
# Set to either 'node' to use default or set EXPLICIT e.g. '/usr/local/bin/node1.10'
command_interpreter="node"
# Command path must always be explicit.
command="/opt/extl/parsoid/api/server.js"
# Contain arguments in quotes, use ' and \"
command_args=""
parsoid_start()
{
# See daemon(8) for more details.
daemon-f-p$parsoid_pid$command_interpreter$command$command_args
# This is another favorite method. Select only one of these.
#app_root="/opt/extl/parsoid/api"
#nginx_user="nginx"
#daemon -p $parsoid_pid -c $app_root -f -r -u $nginx_user $command_interpreter $command $command_args
if[$?-ne0];then
echo"Error starting Parsoid."
exit1
fi
echo"Starting Parsoid."
}
parsoid_kill()
{
echo"Stopping Parsoid."
kill$sig_stop`cat$parsoid_pid`
}
run_rc_command"1ドル"

Configuració de Windows

These steps are the same as the installation of Parsoid on Linux:

If npm install fails due to npm being an unknown command, try to add the nodesjs folder to the PATH, as explained earlier in the Install prerequisite software section, and run npm install directly from the parsoid folder created by the git clone command.

If the installation fails again, you may try to disable your router firewall.

When the installation is complete, configure parsoid and run (server.js might be located in the folder bin\ and not in api\ in newer versions of Parsoid):

When using the cmd file as scheduled task it might be required to use the full path to the server.js file (e.g. C:\www\parsoid\bin\server.js) instead of bin\server.js.

Git will fail to download if you have a corporate proxy to go through, so you need to do the following first;

This will launch an editor now press i once in insert mode type;

Windows Server 2008 R2

MediaWiki must be installed, and an extension Visual Editor as well.

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

Referències