Vai al contenuto

Creare un sito web con MediaWiki

Da WikiJournal.

MediaWiki è un software wiki libero e open source che permette di creare un’enciclopedia, una base di conoscenza, una rivista online, un sito di documentazione o un progetto collaborativo. Il software è gratuito, ma un sito stabile richiede una corretta configurazione del server, backup, aggiornamenti regolari e una gestione chiara dei permessi.

Questo articolo descrive i passaggi principali: scegliere l’hosting, installare MediaWiki, configurare `LocalSettings.php`, aggiungere skin ed estensioni, impostare URL brevi e aggiornare il sito in modo sicuro.

Che cos’è MediaWiki

MediaWiki è scritto principalmente in PHP ed è stato sviluppato originariamente per Wikipedia. Oggi è usato dai progetti della Wikimedia Foundation e da molti siti indipendenti.[1] È adatto a progetti in cui le pagine vengono aggiornate nel tempo, collegate tra loro, categorizzate e migliorate da più utenti.

MediaWiki non è un semplice generatore di pagine statiche. È una piattaforma wiki completa con cronologia delle revisioni, account utente, permessi, namespace, template, categorie, caricamento di file e sistema di estensioni.

Installazione di MediaWiki

Prima dell’installazione bisogna decidere che tipo di sito si vuole creare: enciclopedia pubblica, base di conoscenza privata, progetto multilingue, archivio di file o guida tematica. Da questo dipendono permessi, estensioni, backup e requisiti dell’hosting.

Di solito servono Apache o Nginx, PHP, un database MariaDB/MySQL, PostgreSQL o SQLite e accesso ai file del sito. Prima dell’installazione bisogna controllare i requisiti attuali della versione scelta.[2]

Passaggi principali:

  1. controllare i requisiti ufficiali;
  2. scaricare una versione stabile;
  3. creare database e utente del database;
  4. caricare i file tramite FTP/SFTP o SSH;
  5. aprire il sito nel browser ed eseguire l’installazione guidata;
  6. salvare `LocalSettings.php` e caricarlo nella directory principale di MediaWiki;
  7. controllare pagina principale, accesso, modifica e caricamento dei file.

L’installatore web verifica l’ambiente, richiede i dati del database, crea l’account amministratore e genera `LocalSettings.php`.[3] Questo file è la configurazione principale del sito.

Configurazione di base

Dopo l’installazione si configurano spesso in `LocalSettings.php` il nome del sito, gli URL pubblici, il caricamento dei file, i permessi, l’invio delle email, la skin predefinita, gli URL brevi, la cache e i backup. 

$wgEnableUploads = true;
$wgDefaultSkin = "vector-2022";

Skin

In MediaWiki il tema grafico si chiama skin. Vector 2022 è la skin moderna predefinita; possono essere usate anche Vector legacy, MonoBook, Timeless, MinervaNeue e altre skin.[4] Le skin di solito si trovano in `skins` e vengono caricate da `LocalSettings.php`. 

wfLoadSkin( 'Vector' );
$wgDefaultSkin = 'vector-2022';

Estensioni

Le estensioni aggiungono funzioni a MediaWiki: editor visuale, mappe, funzioni parser, strumenti antispam, moduli, gestione dei file, forum, dati semantici e molto altro.[5] L’installazione tipica consiste nello scaricare una versione compatibile, caricarla in `extensions`, aggiungere la riga di caricamento, aggiornare il database se necessario e controllare `Special:Version`. 

wfLoadExtension( 'ParserFunctions' );

URL brevi

Per impostazione predefinita, le pagine MediaWiki possono usare indirizzi come `/index.php?title=Titolo_pagina`. Per un sito pubblico sono più comodi URL come `/wiki/Titolo_pagina`. Servono sia impostazioni MediaWiki sia regole del server web.[6] 

$wgScriptPath = "/w";
$wgArticlePath = "/wiki/$1";

Aggiornamento di MediaWiki

MediaWiki deve essere aggiornato regolarmente per ricevere correzioni di sicurezza, bug fix e compatibilità con versioni recenti di PHP. Prima di aggiornare bisogna fare backup del database, dei file, di `LocalSettings.php`, `images`, `extensions` e `skins`.[7] 

cd /percorso/di/mediawiki
mysqldump -u db_user -p db_name > backup.sql
cd ..
tar -czf mediawiki-files-backup.tar.gz mediawiki
wget https://releases.wikimedia.org/mediawiki/1.43/mediawiki-1.43.5.tar.gz
tar -xzf mediawiki-1.43.5.tar.gz
cp mediawiki/LocalSettings.php mediawiki-1.43.5/
rsync -a mediawiki/images/ mediawiki-1.43.5/images/
cd mediawiki-1.43.5
php maintenance/run.php update

Nelle vecchie guide si trova spesso `php maintenance/update.php`; nelle versioni moderne è preferibile usare `maintenance/run.php`.

Voci correlate

Fonti

[2] [3] [4] [5] [6] [7]

  1. ↑ MediaWiki. MediaWiki.org.
  2. ↑ 2,0 2,1 Requisiti di installazione. MediaWiki.org.
  3. ↑ 3,0 3,1 Installare MediaWiki. MediaWiki.org.
  4. ↑ 4,0 4,1 Tutte le skin. MediaWiki.org.
  5. ↑ 5,0 5,1 Estensioni. MediaWiki.org.
  6. ↑ 6,0 6,1 URL brevi. MediaWiki.org.
  7. ↑ 7,0 7,1 Aggiornamento. MediaWiki.org.
Estratto da "https://it.wikijournal.org/w-wiki/index.php?title=Creare_un_sito_web_con_MediaWiki&oldid=254"