Wie man den VisualEditor für MediaWiki auf CentOS 7 installiert

VisualEditor ist ein Rich-Text-Editor für MediaWiki. Es ist als Erweiterung verfügbar und stützt sich auf den Parsoid-Parser-Dienst, der für die Bearbeitung von MediaWiki-Seiten zur Verfügung steht.

Bei Parsoid handelt es sich um einen Parserdienst, der auf Nodejs basiert. Es wird von vielen MediaWiki-Erweiterungen verwendet, einschließlich VisualEditor, Flow, Inhaltsübersetzung und anderen Anwendungen.

In diesem Tutorial zeige ich Ihnen, wie Sie VisualEditor Schritt für Schritt für die neueste MediaWiki-Version 1.30 installieren und konfigurieren. Es lohnt sich zu teilen, dass unser MediaWiki unter dem Betriebssystem CentOS 7 installiert ist, und wir werden Nodejs, den Parsoid-Dienst hinzufügen und installieren und VisualEditor für den MediaWiki-Editor konfigurieren.

Voraussetzungen

• CentOS 7 mit installiertem MediaWiki
• Root-Privilegien

Was wir tun werden

1. Überprüfen Sie die MediaWiki-Installation
2. Abhängigkeiten installieren
3. Parsoid-Dienst installieren und konfigurieren
4. VisualEditor für MediaWiki installieren und konfigurieren
5. Testen Sie den Aufbau

Schritt 1 – MediaWiki-Installation prüfen

In diesem Schritt werden wir unsere MediaWiki-Installation überprüfen. MediaWiki ist unter dem Domain-Namen ‚http://wiki.hakase-labs.me‘ installiert. Öffnen Sie den Webbrowser und besuchen Sie die folgende MediaWiki-URL-Adresse, meine ist es:http://wiki.hakase-labs.me/

Sie werden auf die HTTPS-Verbindung weitergeleitet, woraufhin Sie auf die MediaWiki-Seite mit einem ‚Vektor‘-Skin ähnlich dem unten gezeigten gelangen.

Melden Sie sich dann als Admin-Benutzer an und versuchen Sie, die Seite zu bearbeiten. Klicken Sie auf die Registerkarte ‚Bearbeiten‘ und Sie erhalten den Standard-MediaWiki-Editor wie unten beschrieben.

Das MediaWiki ist fehlerfrei in Betrieb.

Schritt 2 – Abhängigkeiten installieren

Um den Parsoid-Dienst zu installieren und VisualEditor zu konfigurieren, benötigen wir einige CentOS-Pakete, die auf dem System installiert werden müssen. Im Einzelnen werden wir Nodejs, npm, vim und git installieren.

Installieren Sie alle benötigten Pakete mit dem yum-Befehl unten.

yum -y install nodejs npm vim-enhanced git

Alle Pakete und Abhängigkeiten wurden installiert.

Schritt 3 – Installieren und Konfigurieren von Parsoid

Parsoid kann auf einem separaten MediaWiki-Server installiert werden. Aber für dieses Tutorial, und wir werden nur 1 CentOS 7 Server für MediaWiki und Parsoid verwenden.

Da wir jetzt den CentOS 7-Server verwenden, müssen wir den Parsoid-Dienst manuell von der Quelle aus installieren, da offizielle Pakete nur für Ubuntu/Debian-basierte Betriebssysteme verfügbar sind.

Erstellen Sie also zunächst ein neues Verzeichnis ‚/opt/parsoid‘ und klonen Sie das letzte Parsoid mit dem git-Befehl, wie unten gezeigt.

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

Gehen Sie nun in das Verzeichnis ‚/opt/parsoid‘ und installieren Sie den Parsoid-Dienst mit dem folgenden npm-Befehl.

cd /opt/parsoid
npm install

Nachdem die Installation abgeschlossen ist, erhalten Sie das Ergebnis wie unten dargestellt.

Als nächstes konfigurieren Sie den Parsoid-Dienst, indem Sie die entsprechenden Konfigurationsdateien bearbeiten.

Kopieren Sie die Beispielkonfiguration ‚localsettings.example.js‘ nach ‚localsettings.js‘, und editieren Sie dann die Datei mit vim.

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

Entkommentieren Sie die Zeile ‚parsoidConfig.setMwApi‘ und ändern Sie den ‚uri‘-Wert mit Ihrer MediaWiki-API-URL wie unten beschrieben.

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

Das war’s. Speichern und beenden.

Kopieren Sie nun die ‚config.example.yaml‘-Konfiguration nach ‚config.yaml‘ und editieren Sie sie mit dem vim-Editor.

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

Ändern Sie in der ‚mwApis‘-Zeile (Zeile Nummer 34) den ‚uri‘-Wert mit Ihrer MediaWiki-API-URL und den ‚domain‘-Wert mit Ihrem eigenen Domainnamen.

 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

Speichern und beenden.

Als nächstes werden wir Parsoid als Dienst konfigurieren. Gehen Sie dazu in das Verzeichnis ‚/etc/systemd/system‘ und erstellen Sie eine neue Dienstdatei mit dem Namen ‚parsoid.service‘.

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

Fügen Sie die Parsoid-Dienstkonfiguration unten ein.

[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

Speichern und beenden. Führen Sie dann den folgenden Befehl zum erneuten Laden aus.

systemctl daemon-reload

Starten Sie jetzt den Parsoid-Dienst und aktivieren Sie ihn so, dass er jederzeit beim Systemstart ausgeführt werden kann.

systemctl start parsoid
systemctl enable parsoid

Parsoid sollte nun als Dienst unter CentOS 7 unter Verwendung von Port 8000 laufen. Sie können es mit dem netstat-Befehl wie folgt überprüfen.

netstat -plntu

Und Sie sollten ein ähnliches Ergebnis wie das folgende erhalten:

Die parsoide Installation und Konfiguration ist abgeschlossen.

Anmerkung:

Wenn auf Ihrem Server Firewalld läuft, fügen Sie den parsoiden Port 8000 mit den folgenden Befehlen zur Firewalld-Konfiguration hinzu.

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

Schritt 4 – VisualEditor installieren und konfigurieren

In diesem Schritt werden wir die VisualEditor-Erweiterungen für MediaWiki installieren und konfigurieren.

Gehen Sie in das MediaWiki-Installationsverzeichnis ‚/var/www/mediawiki/extensions‘ und laden Sie die neueste VisualEditor-Version mit git herunter.

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

Gehen Sie nun in das VisualEditor-Verzeichnis und initialisieren und aktualisieren Sie alle darin enthaltenen Untermodule.

cd VisualEditor/
git submodule update --init

Als nächstes müssen wir die Mediawiki-Konfigurationsdatei ‚LocalSettings.php‘ bearbeiten, um VisualEditor zu aktivieren. Gehen Sie dazu in das mediawiki-Verzeichnis und editieren Sie die Datei ‚LocalSettings.php‘ mit vim.

cd /var/www/mediawiki
vim LocalSettings.php

Fügen Sie die Konfiguration unten gegen Ende der Datei ein.

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'
);

Das war’s. Speichern und beenden.

Anmerkung:

Bitte ändern Sie die URL mit Ihrem eigenen Domainnamen.

Als nächstes ändern Sie die Eigentumsberechtigungen für das mediawiki-Verzeichnis auf den Benutzer und die Gruppe ’nginx‘.

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

Die Installation der VisualEditor-Erweiterungen ist abgeschlossen.

Schritt 5 – Prüfung

Öffnen Sie Ihren Webbrowser und besuchen Sie die folgende MediaWiki URL, meine ist es:http://wiki.hakase-labs.me

Melden Sie sich jetzt als Admin an.

Sobald Sie angemeldet sind, klicken Sie auf die Registerkarte ‚Bearbeiten‘, um die Startseite zu bearbeiten. Sie sollten den VisualEditor wie unten gezeigt erhalten.

Die Installation und Konfiguration des VisualEditors von MediaWiki auf CentOS 7 wurde erfolgreich abgeschlossen.

Referenz

• https://www.mediawiki.org/wiki/Extension:VisualEditor