Mediawiki 1.31 LTS VisualEditor bővítmény telepítése Debian környezetben forrásának megtekintése

A [[mediawikiwiki:MediaWiki|Mediawikinek]] egy speciális nyelve van ([[wikipedia:Help:Wikitext|WikiText]]), amelyet el kell sajátítani, hogy a wiki oldalait szerkeszthessük. A [[mediawikiwiki:Extension:VisualEditor|VisualEditor]] bővítmény lehetővé teszi, hogy a wiki oldalakat bárki szövegszerkesztő szerűen szerkessze. A bővítmény működéséhez szükséges a [[mediawikiwiki:Parsoid|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 [https://nodejs.org/ NodeJS] futtató környezet.

A pédák Debian operációs rendszeren a [[Mediawiki 1.31 LTS telepítése Debian-Apache-MySQL környezetben|Mediawiki 1.31 telepített verziójával]] készültek. Az Apache http szervert é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====
<syntaxhighlight lang="bash">
apt -y install curl php-curl apt-transport-https dirmngr
</syntaxhighlight>
====NodeJS telepítése====
<syntaxhighlight lang="bash">
curl -sL https://deb.nodesource.com/setup_6.x | bash -
apt-get install -y nodejs
</syntaxhighlight>
====Parsoid telepítése====
<syntaxhighlight lang="bash">
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
</syntaxhighlight>

===Debian 10===

====Szükséges csomagok telepítése====
<syntaxhighlight lang="bash">
apt -y install curl php-curl nodejs
</syntaxhighlight>
====Parsoid telepítése====
<syntaxhighlight lang="bash">
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
</syntaxhighlight>

===Parsoid konfiguráció===
Wiki api ellenőrzése<syntaxhighlight lang="bash">
curl https://mydomain.com/api.php
</syntaxhighlight>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.<syntaxhighlight lang="yaml">
#----
    conf:
	   - uri: 'https://mydomain.com/api.php'
	     domain: 'mydomain.com'
#----
</syntaxhighlight>Konfiguráció érvényesítése<syntaxhighlight lang="bash">
service parsoid restart
</syntaxhighlight>
==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.<syntaxhighlight lang="bash">
wget -qO- https://extdist.wmflabs.org/dist/extensions/VisualEditor-REL1_31-c3c9140.tar.gz | tar -xzf - -C /var/www/mediawiki/extensions/
</syntaxhighlight>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.<syntaxhighlight lang="php">
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;
</syntaxhighlight>
[[Kategória:Mediawiki]]