Installation von Parsoid auf Linux

Parsoid ist der Rendering-Dienst für den visuellen Editor. Die hier aufgeführten Schritte sind deshalb optional und nur erforderlich, wenn Sie diesen in Ihrer BlueSpice-Installation verwenden möchten. Visual Editor muss nach BlueSpice-Installation noch separat konfiguriert werden.

Installation

Wichtig! Bitte achten Sie bei der Installation auf die richtige Parsoid-Version. Die derzeit von BlueSpice unterstützte Version ist Parsoid 0.10.0.

Auf die Installation aus Paketquellen der Distribution wird verzichtet. Installiert wird Parsoid unter /opt. mit dem folgenden Befehl dorthin wechseln:

cd /opt

Parsoid wird wie folgt heruntergeladen. Hierzu muss die Software "git" installiert sein (apt install git).

git clone --depth 1 --branch v0.10.0 https://gerrit.wikimedia.org/r/p/mediawiki/services/parsoid parsoid

Installieren Sie parsoid nun mit diesen Befehlen:

cd parsoid; \
npm install

Konfigurationsdatei anlegen

In der BlueSpice Codebase finden Sie im Ordner extensions/BlueSpiceVisualEditorConnector/docs/parsoid zwei Dateien:

• config.yaml
• localsettings.js

Kopieren Sie diese in den Ordner /opt/parsoid.

Dies liefert bereits eine fertige Konfiguration des Parsoid aus, die im Standardsetup ohne weitere Eingriffe funktionieren sollte.

Bei fehlenden Rechten im Terminal "sudo nautilus" ausführen und die Dateien von "extensions/BlueSpiceVisualEditorConnector/docs/parsoid" nach "/opt/parsoid" zu Kopieren.

Überprüfung der Parsoid-Installation und -Konfiguration

Um Installation und Konfiguration zu Testen führen Sie im Ordner /opt/parsoid den Befehl node bin/server.js aus.

Parsoid sollte nun ohne Fehlermeldung starten.

Beenden Sie Parsoid durch drücken von "Strg + C". Halten Sie die Eingabeaufforderung geöffnet und gehen Sie zum nächsten Schritt.

Installation als Service

Um Parsoid zukünftig im Hintergrund laufen zu lassen müssen Sie zusätzlich pm2 über Node.js installieren:

npm install -g pm2

Starten Sie dann Parsoid via pm2:

pm2 start /opt/parsoid/bin/server.js

Speichern Sie nun die pm2 Prozessliste – dies fügt Parsoid zu den pm2-Diensten fest hinzu:

pm2 save

Zuletzt wird pm2 in den System-Autostart gelegt:

# Render startup-script for a specific platform, the [platform] could be one of:
#   ubuntu|centos|redhat|gentoo|systemd|darwin|amazon
pm2 startup [platform]

Nächster Schritt

Haben Sie alle Schritte erfolgreich abgeschlossen können Sie zum nächsten Schritt "Python" weiter gehen.