Mediawiki software - installatienotities: verschil tussen versies

Uit MakerSpace Leiden
Ga naar: navigatie, zoeken
(→‎updaten van de extensies)
 
(14 tussenliggende versies door 6 gebruikers niet weergegeven)
Regel 1: Regel 1:
−
<languages />
+
[[Category:Algemeen]][[Category:Servers network & websites]]
−
 
 
−
<translate>
 
−
<!--T:1-->
 
 
Sinds zomer 2018 wordt de mediawiki software niet meer via apt beheerd maar met de hand. Reden hiervoor is dat we zelf controle willen hebben over de exacte versies die we gebruiken van de mediawiki en de extensies.  
 
Sinds zomer 2018 wordt de mediawiki software niet meer via apt beheerd maar met de hand. Reden hiervoor is dat we zelf controle willen hebben over de exacte versies die we gebruiken van de mediawiki en de extensies.  
  
−
== Softwarelocaties == <!--T:2-->
+
== Softwarelocaties ==  
  
−
<!--T:3-->
 
 
* De documentroot van mediawiki voor apache2 is /var/lib/mediawiki. Deze directory bevat voornamelijk symbolic links naar bestanden in /usr/share/mediawiki, maar ook wat echte directories (images, config, cache, uploads) met kostbare gebruikersdata.
 
* De documentroot van mediawiki voor apache2 is /var/lib/mediawiki. Deze directory bevat voornamelijk symbolic links naar bestanden in /usr/share/mediawiki, maar ook wat echte directories (images, config, cache, uploads) met kostbare gebruikersdata.
 
* /usr/share/mediawiki is zelf weer een symbolic link naar /usr/share/mediawiki-<version>, waar de echte software staat. Op dit moment is dat /usr/share/mediawiki-1.31.0.
 
* /usr/share/mediawiki is zelf weer een symbolic link naar /usr/share/mediawiki-<version>, waar de echte software staat. Op dit moment is dat /usr/share/mediawiki-1.31.0.
Regel 13: Regel 9:
 
* In deze versiespecifieke directories staan ook de extensies die we gebruiken (MLEB, zie verder).
 
* In deze versiespecifieke directories staan ook de extensies die we gebruiken (MLEB, zie verder).
  
−
=== Extensies === <!--T:4-->
+
=== Extensies ===
 +
 
 +
 
 +
=== Fileformats ===
 +
 
 +
2022/11 - added f3d (Fusion) to <code>wgFileExtensions</code> in <code>/etc/mediawiki/LocalSettings.php</code> (dirkx)
  
−
<!--T:5-->
+
2024/10 - added mch (Fusion) to <code>wgFileExtensions</code> in <code>/etc/mediawiki/LocalSettings.php</code> (MarkvdKlaauw)
−
De enige extra extensie die is toegevoegd is de 'multi language extension bundle' ([https://www.mediawiki.org/wiki/MediaWiki_Language_Extension_Bundle MLEB]) waardoor we meerdere talen in de wiki kunnen ondersteunen.
 
  
−
== Updaten van mediawiki == <!--T:6-->
+
== Updaten van mediawiki ==  
  
−
=== Maak backups === <!--T:7-->
+
=== Maak backups ===  
  
−
==== systeembackup ==== <!--T:8-->
+
==== systeembackup ====  
  
−
<!--T:9-->
 
 
<code>sudo /etc/duplicity/run.sh</code>
 
<code>sudo /etc/duplicity/run.sh</code>
  
−
==== databasebackups ==== <!--T:10-->
+
==== databasebackups ====
  
−
<!--T:11-->
 
 
Maak backups in sql en xml:
 
Maak backups in sql en xml:
 
<code>mysqldump -h localhost -u mediawiki -p --default-character-set=utf8 mediawiki --single-transaction > mediawikibackup.sql</code>
 
<code>mysqldump -h localhost -u mediawiki -p --default-character-set=utf8 mediawiki --single-transaction > mediawikibackup.sql</code>
  
−
<!--T:12-->
 
 
<code>mysqldump -h localhost -u mediawiki -p --xml mediawiki --single-transaction > mediawikibackup.xml</code>
 
<code>mysqldump -h localhost -u mediawiki -p --xml mediawiki --single-transaction > mediawikibackup.xml</code>
  
−
<!--T:13-->
 
 
(Authorisatiegegevens staan in LocalSettings.php)
 
(Authorisatiegegevens staan in LocalSettings.php)
  
−
=== download mediawiki === <!--T:14-->
+
=== download mediawiki ===  
  
−
<!--T:15-->
 
 
De meest recente versie van mediawiki kan worden gevonden op https://www.mediawiki.org/wiki/Download. Een wget is hier wellicht handig:
 
De meest recente versie van mediawiki kan worden gevonden op https://www.mediawiki.org/wiki/Download. Een wget is hier wellicht handig:
  
−
<!--T:16-->
 
 
<code>wget https://releases.wikimedia.org/mediawiki/1.27/mediawiki-1.31.0.tar.gz</code>
 
<code>wget https://releases.wikimedia.org/mediawiki/1.27/mediawiki-1.31.0.tar.gz</code>
 
   
 
   
 
Het beste kun je deze eerst uncompressen in een eigen directory zodat je alle tijd hebt het pakket te bestuderen.
 
Het beste kun je deze eerst uncompressen in een eigen directory zodat je alle tijd hebt het pakket te bestuderen.
  
−
=== Lees de release notes === <!--T:17-->
+
=== Lees de release notes ===  
  
−
<!--T:18-->
 
 
De release notes bevatten de meest recente instructies en gegevens. Wellicht meer recent dan de pagina die je nu leest.
 
De release notes bevatten de meest recente instructies en gegevens. Wellicht meer recent dan de pagina die je nu leest.
  
−
=== Lees de release notes! === <!--T:19-->
+
=== Lees de release notes! ===
  
−
<!--T:20-->
 
 
Nogmaals. Zodat je zeker weet waar je mee bezig bent.
 
Nogmaals. Zodat je zeker weet waar je mee bezig bent.
  
−
=== verplaats === <!--T:21-->
+
=== verplaats ===  
  
−
<!--T:22-->
 
 
Voordat je hiermee aan de slag gaat is het slim om apache even te laten stoppen met het uitserveren van mediawiki (in /etc/apache2/conf-enabled).
 
Voordat je hiermee aan de slag gaat is het slim om apache even te laten stoppen met het uitserveren van mediawiki (in /etc/apache2/conf-enabled).
  
−
<!--T:23-->
 
 
* Verplaats de code naar /usr/share/mediawiki-<versie> en chown deze naar wikiadmin.
 
* Verplaats de code naar /usr/share/mediawiki-<versie> en chown deze naar wikiadmin.
 
* maak in deze directory een symbolic link aan van LocalSettings.php naar /etc/mediawiki/LocalSettings.php
 
* maak in deze directory een symbolic link aan van LocalSettings.php naar /etc/mediawiki/LocalSettings.php
Regel 70: Regel 60:
 
* en uiteindelijk maak een nieuwe symbolic link aan van /usr/share/mediawiki naar de nieuwe versie /usr/share/mediawiki.versie.
 
* en uiteindelijk maak een nieuwe symbolic link aan van /usr/share/mediawiki naar de nieuwe versie /usr/share/mediawiki.versie.
  
−
<!--T:24-->
 
 
Kijk in de release notes of je nog andere dingen aan moet passen.
 
Kijk in de release notes of je nog andere dingen aan moet passen.
  
−
=== update de database === <!--T:25-->
+
=== update de database ===  
  
−
<!--T:26-->
 
 
''Neem nu risico'' en voer het database-update script 'update.php' uit in /usr/share/mediawiki/maintenance. Met een beetje geluk werkt dit.  
 
''Neem nu risico'' en voer het database-update script 'update.php' uit in /usr/share/mediawiki/maintenance. Met een beetje geluk werkt dit.  
  
−
== updaten van de extensies == <!--T:27-->
+
== updaten van de extensies ==  
  
−
<!--T:28-->
 
 
Het updaten van de MLEB extensie is vrijwel volledig standaard, zoals [https://www.mediawiki.org/wiki/MediaWiki_Language_Extension_Bundle beschreven]. De extensie plaats je in /usr/share/mediawiki-<versis>/extensions. Vergeet ook hier de release notes niet.  
 
Het updaten van de MLEB extensie is vrijwel volledig standaard, zoals [https://www.mediawiki.org/wiki/MediaWiki_Language_Extension_Bundle beschreven]. De extensie plaats je in /usr/share/mediawiki-<versis>/extensions. Vergeet ook hier de release notes niet.  
  
−
De MLEB configuratie is met enkele regels uitgebreid om de paginataal handmatig in te kunnen stellen en ziet er zo uit:
+
De MLEB configuratie is met enkele regels uitgebreid om de paginataal handmatig in te kunnen stellen:
−
 
 
−
<code>
 
−
# Added this MLEB configuration:
 
−
wfLoadExtension( 'Babel' );
 
−
 
 
−
wfLoadExtension( 'cldr' );
 
  
−
wfLoadExtension( 'CleanChanges' );
+
<code>$wgPageLanguageUseDB = true;</code>
−
$wgCCTrailerFilter = true;
 
−
$wgCCUserFilter = false;
 
−
$wgDefaultUserOptions['usenewrc'] = 1;
 
  
−
wfLoadExtension( 'LocalisationUpdate' );
+
<code>$wgGroupPermissions['sysop']['pagelang'] = true;</code>
−
$wgLocalisationUpdateDirectory = "$IP/cache";
 
  
−
require_once "$IP/extensions/Translate/Translate.php";
+
To change the maximum number of items shown per category in MediaWiki from maximum 50 to maximum 500, change the following in LocalSettings.php:
−
$wgGroupPermissions['user']['translate'] = true;
 
−
$wgGroupPermissions['user']['translate-messagereview'] = true;
 
−
$wgGroupPermissions['user']['translate-groupreview'] = true;
 
−
$wgGroupPermissions['user']['translate-import'] = true;
 
−
$wgGroupPermissions['sysop']['pagetranslation'] = true;
 
−
$wgGroupPermissions['sysop']['translate-manage'] = true;
 
−
$wgTranslateDocumentationLanguageCode = 'qqq';
 
−
$wgExtraLanguageNames['qqq'] = 'Message documentation'; # No linguistic content. Used for documenting messages
 
  
−
wfLoadExtension( 'UniversalLanguageSelector' );
+
<code>$wgCategoryPagingLimit = 500;</code>
−
# end MLEB configuration
 
−
#
 
−
# extra MLEB configuration added to be able to set page language:
 
−
$wgPageLanguageUseDB = true;
 
−
$wgGroupPermissions['sysop']['pagelang'] = true;
 
−
</code>
 
  
−
== afronden van de update == <!--T:29-->
+
== afronden van de update ==
  
−
<!--T:30-->
 
 
* Laat apache2 weer doorgaan met het uitserveren van de mediawiki (als je dat in een van de voorgaande stappen al niet had gedaan)
 
* Laat apache2 weer doorgaan met het uitserveren van de mediawiki (als je dat in een van de voorgaande stappen al niet had gedaan)
 
* test
 
* test
 
* Pas deze documentatie aan als deze aangepast of verbeterd moet worden.
 
* Pas deze documentatie aan als deze aangepast of verbeterd moet worden.
−
</translate>
 

Huidige versie van 6 okt 2024 om 15:10

Sinds zomer 2018 wordt de mediawiki software niet meer via apt beheerd maar met de hand. Reden hiervoor is dat we zelf controle willen hebben over de exacte versies die we gebruiken van de mediawiki en de extensies.

Softwarelocaties

  • De documentroot van mediawiki voor apache2 is /var/lib/mediawiki. Deze directory bevat voornamelijk symbolic links naar bestanden in /usr/share/mediawiki, maar ook wat echte directories (images, config, cache, uploads) met kostbare gebruikersdata.
  • /usr/share/mediawiki is zelf weer een symbolic link naar /usr/share/mediawiki-<version>, waar de echte software staat. Op dit moment is dat /usr/share/mediawiki-1.31.0.
  • In deze versiespecifieke directories staan symbolic links van LocalSettings.php naar /etc/mediawiki/LocalSettings.php. (Ook bevat /etc/mediawiki een kopie van de apache2 (globale) configuratiefile mediawiki.conf. Waarom deze daar staat weet ik niet, maar hij is wel makkelijk terug te vinden zo)
  • In deze versiespecifieke directories staan ook de extensies die we gebruiken (MLEB, zie verder).

Extensies

Fileformats

2022/11 - added f3d (Fusion) to wgFileExtensions in /etc/mediawiki/LocalSettings.php (dirkx)

2024/10 - added mch (Fusion) to wgFileExtensions in /etc/mediawiki/LocalSettings.php (MarkvdKlaauw)

Updaten van mediawiki

Maak backups

systeembackup

sudo /etc/duplicity/run.sh

databasebackups

Maak backups in sql en xml: mysqldump -h localhost -u mediawiki -p --default-character-set=utf8 mediawiki --single-transaction > mediawikibackup.sql

mysqldump -h localhost -u mediawiki -p --xml mediawiki --single-transaction > mediawikibackup.xml

(Authorisatiegegevens staan in LocalSettings.php)

download mediawiki

De meest recente versie van mediawiki kan worden gevonden op https://www.mediawiki.org/wiki/Download. Een wget is hier wellicht handig:

wget https://releases.wikimedia.org/mediawiki/1.27/mediawiki-1.31.0.tar.gz

Het beste kun je deze eerst uncompressen in een eigen directory zodat je alle tijd hebt het pakket te bestuderen.

Lees de release notes

De release notes bevatten de meest recente instructies en gegevens. Wellicht meer recent dan de pagina die je nu leest.

Lees de release notes!

Nogmaals. Zodat je zeker weet waar je mee bezig bent.

verplaats

Voordat je hiermee aan de slag gaat is het slim om apache even te laten stoppen met het uitserveren van mediawiki (in /etc/apache2/conf-enabled).

  • Verplaats de code naar /usr/share/mediawiki-<versie> en chown deze naar wikiadmin.
  • maak in deze directory een symbolic link aan van LocalSettings.php naar /etc/mediawiki/LocalSettings.php
  • maak in deze directory een symbolic link aan van images naar /var/lib/images
  • en uiteindelijk maak een nieuwe symbolic link aan van /usr/share/mediawiki naar de nieuwe versie /usr/share/mediawiki.versie.

Kijk in de release notes of je nog andere dingen aan moet passen.

update de database

Neem nu risico en voer het database-update script 'update.php' uit in /usr/share/mediawiki/maintenance. Met een beetje geluk werkt dit.

updaten van de extensies

Het updaten van de MLEB extensie is vrijwel volledig standaard, zoals beschreven. De extensie plaats je in /usr/share/mediawiki-<versis>/extensions. Vergeet ook hier de release notes niet.

De MLEB configuratie is met enkele regels uitgebreid om de paginataal handmatig in te kunnen stellen:

$wgPageLanguageUseDB = true;

$wgGroupPermissions['sysop']['pagelang'] = true;

To change the maximum number of items shown per category in MediaWiki from maximum 50 to maximum 500, change the following in LocalSettings.php:

$wgCategoryPagingLimit = 500;

afronden van de update

  • Laat apache2 weer doorgaan met het uitserveren van de mediawiki (als je dat in een van de voorgaande stappen al niet had gedaan)
  • test
  • Pas deze documentatie aan als deze aangepast of verbeterd moet worden.
Overgenomen van "https://wiki.makerspaceleiden.nl/mediawiki/index.php?title=Mediawiki_software_-_installatienotities&oldid=16692"