Mediawiki 1.31 LTS VisualEditor bővítmény telepítése Debian környezetben

A Mediawikinek egy speciális nyelve van (WikiText), amelyet el kell sajátítani, hogy a wiki oldalait szerkeszthessük. A VisualEditor bővítmény lehetővé teszi, hogy a wiki oldalakat bárki szövegszerkesztő szerűen szerkessze. A plugin működéséhez szükséges a Parsoid szolgáltatás, ami WikiText és a html konverziót végzi. A Parsoid működéséhez pedig szükséges a NodeJS.

A pédák Debian operációs rendszeren a Mediawiki 1.31 telepített verziójával készültek. Az Apache http szerver és a Php futtatókörnyezet az operációs rendszer tárolójából telepítettük.

A parancsok root jogot feltételeznek. (állandó root jog: sudo -i)

Előfeltételek

Debian 9

Szükséges csomagok telepítése

apt -y install curl php-curl apt-transport-https dirmngr

NodeJS telepítése

curl -sL https://deb.nodesource.com/setup_6.x | bash -
apt-get install -y nodejs

Parsoid telepítése

apt-key advanced --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys AF380A3036A03444
echo "deb https://releases.wikimedia.org/debian jessie-mediawiki main" | tee /etc/apt/sources.list.d/parsoid.list
apt-get update
apt-get install -y parsoid

Debian 10

Szükséges csomagok telepítése

apt -y install curl php-curl nodejs

Parsoid telepítése

wget https://releases.wikimedia.org/parsoid/parsoid_0.9.0all_all.deb
dpkg -i ./parsoid_0.10.0all_all.deb
rm ./parsoid_0.10.0all_all.deb

Parsoid konfiguráció

Wiki api ellenőrzése

curl https://mydomain.com/api.php

Ha beolvassa a html oldalt, akkor működik.

! https esetén érvényes tanúsítvány kell!

Pasoid konfiguráció: a /etc/mediawiki/parsoid/config.yaml konfigurációban mydomain.com -ot kell kicserélni a wiki domainjére. Több domain esetén az - uri: konfigurációs részletet kell többszörözni.

#----
    conf:
	   - uri: 'https://mydomain.com/api.php'
	     domain: 'mydomain.com'
#----

Konfiguráció érvényesítése

service parsoid restart

VisualEditor bővítmény telepítése

A bővítmények build számai release-enként változnak. A https://extdist.wmflabs.org/dist/extensions/ linken lehet ellenőrizni a legfrissebb változatokat.

wget -qO- https://extdist.wmflabs.org/dist/extensions/VisualEditor-REL1_31-c3c9140.tar.gz | tar -xzf - -C /var/www/mediawiki/extensions/

VisualEditor konfiguráció: A /var/www/mediawiki/LocalSettings.php konfiguráció végére be kell szúrni a következő konfigurációs részletet, és a mydomain.com -ot kell kicserélni a wiki domainjére.

wfLoadExtension( 'VisualEditor' );

// Engedélyezve mindenkinek
$wgDefaultUserOptions['visualeditor-enable'] = 1;

// Letiltás opció eltüntetése
$wgHiddenPrefs[] = 'visualeditor-enable';

$wgVirtualRestConfig['modules']['parsoid'] = array(
    // Parsoid URL
    // Debian-on port 8142
    'url' => 'http://localhost:8142',
    // Parsoid "domain", (optional)
    'domain' => 'mydomain.com',
    // Parsoid "prefix", (optional)
    //'prefix' => 'mydomain.com'
);

// fájlok esetén az VisualEditor letiltása
$wgVisualEditorAvailableNamespaces = [
    "File" => false
];

// This feature requires a non-locking session store. The default session store will not work and
// will cause deadlocks (connection timeouts from Parsoid) when trying to use this feature. Only required for MediaWiki 1.26.x and earlier!
$wgSessionsInObjectCache = true;

// Forward users' Cookie: headers to Parsoid. Required for private wikis (login required to read).
// If the wiki is not private (i.e. $wgGroupPermissions['*']['read'] is true) this configuration
// variable will be ignored.
//
// WARNING: ONLY enable this on private wikis and ONLY IF you understand the SECURITY IMPLICATIONS
// of sending Cookie headers to Parsoid over HTTP. For security reasons, it is strongly recommended
// that $wgVirtualRestConfig['modules']['parsoid']['url'] be pointed to localhost if this setting is enabled.
$wgVirtualRestConfig['modules']['parsoid']['forwardCookies'] = true;