Installation von Parsoid

Systemvoraussetzung

Die Installation von Parsoid erfordert die Installation von Node.js.

Installation und Konfiguration

Windows

Öffnen Sie eine Konsole mit Administratorberechtigungen und wechseln Sie dort in das Installationsverzeichnis von Node.js (wenn Sie sich an unsere Empfehlungen zur Ordnerstruktur unter Windows gehalten haben \bluespice\bin\nodejs). Führen Sie dort den Befehl npm install parsoid aus.

Die Konfiguration von Parsoid unter Windows ist nahezu identisch zu Parsoid unter Linux. In dieser Anleitung gibt es dennoch eine Unterscheidung der entsprechenden Artikel aufgrund der unterschiedlichen Pfade im Dateisystem. Auch hier halten wir uns an oben erwähnte Ordnerstruktur und gehen entsprechend von den Pfaden in dieser Dokumentation aus.

Anlegen der Konfigurationsdatei

Legen Sie die Datei \bluespice\etc\parsoid.yaml an. Kopieren Sie folgenden Inhalt in diese:

worker_heartbeat_timeout: 300000

logging:
    level: info

services:
  # Geben Sie hier bei "module" den absoluten Pfad der index.js
  # im Unterordner "lib" des parsoid-Moduls von nodejs an.
  # Der erste "/" stellt dabei die oberste Ebene Ihres Laufwerks
  # dar. Nutzen Sie keine "\" sondern "/"
  - module: /bluespice/bin/nodejs/node_modules/parsoid/lib/index.js
    entrypoint: apiServiceWorker
    conf:
        mwApis:
        # Geben Sie bei "uri" die URL an, unter der Sie die api.php
        # Ihrer MediaWiki-Installation erreichen können. Dies muss
        # keine öffentliche Adresse sein, Sie können durchaus mit
        # "localhost" arbeiten, sofern Ihr Webserver entsprechend
        # darauf konfiguriert ist.
        - uri: 'http://localhost/api.php'
          domain: 'bluespice'

Die beiden relevanten Änderungen, die Sie selber bei Bedarf anpassen müssen ("module" und "uri") sind im entsprechenden Kommentar darüber erklärt.

Speichern und schließen Sie die Datei.