982
contributi
(aggiunto nota su LTS non più supportata) |
|||
(22 versioni intermedie di 7 utenti non mostrate) | |||
Riga 1: | Riga 1: | ||
{{Versioni compatibili|Debian | {{Versioni compatibili|Squeeze|Wheezy|Jessie}} | ||
{{Warningbox|L'ultima versione disponibile nei repository Debian (da Wheezy e successive) è la LTS v.1.19 il cui ciclo di vita terminerà a maggio 2015.<br />Come citato nelle note di rilascio della release Jessie:<br />"Il pacchetto mediawiki è incluso in Jessie per soddisfare le dipendenze in altri pacchetti. Il supporto di sicurezza per mediawiki terminerà insieme con il supporto per Wheezy nell'aprile 2016."}} | |||
==Introduzione== | ==Introduzione== | ||
[http://www.mediawiki.org MediaWiki] è un software ''lato server'' basato sulla filosofia wiki, scritto in PHP e basato su un database relazionale MySQL o PostgreSQL.<br/> | [http://www.mediawiki.org MediaWiki] è un software ''lato server'' basato sulla filosofia wiki, scritto in PHP e basato su un database relazionale MySQL o PostgreSQL.<br/> | ||
MediaWiki è rilasciato sotto la licenza GNU GPL ed è usato dal progetto [http://it.wikipedia.org Wikipedia], dagli altri progetti della [http://it.wikipedia.org/wiki/Wikimedia_Foundation Wikimedia Foundation] e da molti altri wiki. | MediaWiki è rilasciato sotto la licenza GNU GPL ed è usato dal progetto [http://it.wikipedia.org Wikipedia], dagli altri progetti della [http://it.wikipedia.org/wiki/Wikimedia_Foundation Wikimedia Foundation] e da molti altri wiki tra i quali il wiki di debianizzati.org. | ||
==Prerequisiti== | ==Prerequisiti== | ||
Per poter installare MediaWiki è necessario possedere un web server già configurato e completo di supporto PHP. Si veda ad esempio una di queste guide: | Per poter installare MediaWiki è necessario possedere un web server già configurato e completo di supporto PHP. Si veda ad esempio una di queste guide: | ||
* [[Installare un ambiente LAMP: Linux, Apache2, SSL, MySQL, PHP5]] | * [[Installare un ambiente LAMP: Linux, Apache2, SSL, MySQL, PHP5]] | ||
* [[LAMP: Linux, Apache, MySQL e PHP| Installare un ambiente LAMP: Linux, Apache, SSL, MySQL, PHP4]] | * [[LAMP: Linux, Apache, MySQL e PHP| Installare un ambiente LAMP: Linux, Apache, SSL, MySQL, PHP4]] | ||
==Prima parte: installazione del pacchetto== | ==Prima parte: installazione del pacchetto== | ||
L'installazione segue la stessa facile strada di ogni pacchetto Debian: | L'installazione segue la stessa facile strada di ogni pacchetto Debian: | ||
<pre> | <pre> | ||
# apt-get install mediawiki mediawiki-extensions mediawiki-math ocaml-core gcc | # apt-get install mediawiki mediawiki-extensions mediawiki-math ocaml-core gcc imagemagick gs cjk-latex tetex-extra php5-imagick binutils gcc | ||
</pre> | </pre> | ||
Riga 34: | Riga 39: | ||
Una volta installato MediaWiki potete ancora modificarne la configurazione agendo sulle variabili del file <code>LocalSettings.php</code>. Ma prima di poterlo fare abbiamo bisogno di spostarlo dalla sua configurazione originale: | Una volta installato MediaWiki potete ancora modificarne la configurazione agendo sulle variabili del file <code>LocalSettings.php</code>. Ma prima di poterlo fare abbiamo bisogno di spostarlo dalla sua configurazione originale: | ||
<pre> | <pre> | ||
mv /var/lib/mediawiki/ | mv /var/lib/mediawiki/LocalSettings.php /etc/mediawiki/ | ||
ln -s /etc/mediawiki/LocalSettings.php /var/www/mediawiki/LocalSettings.php | |||
</pre> | </pre> | ||
==Accesso a MediaWiki== | ==Accesso a MediaWiki== | ||
A questo punto potete accedere al vostro nuovo MediaWiki puntando il browser all'indirizzo: | A questo punto potete accedere al vostro nuovo MediaWiki puntando il browser all'indirizzo: | ||
Riga 42: | Riga 49: | ||
</pre> | </pre> | ||
==Modificare l'installazione di MediaWiki== | ==Modificare l'installazione di MediaWiki== | ||
Il comportamento e l'aspetto di Mediawiki vengono personalizzati dall'amministratore attraverso il file <code>/etc/mediawiki/LocalSettings.php</code>.<br/> | |||
Questo file fornisce le impostazioni di configurazione locale di Mediawiki e viene generato automaticamente dallo script di configurazione lanciato subito dopo l'installazione (secondo la procedura descritta al paragrafo [[#Seconda parte: installazione via web|Installazione via web]]): <code>LocalSettings.php</code> contiene dunque le preferenze di configurazione specificate dall'utente allo script di configurazione.<br/> | |||
Tutte le altre opzioni di configurazione, invece, mantengono i valori di default contenuti nel file <code>/usr/share/mediawiki/includes/DefaultSettings.php</code> che '''non deve essere mai modificato direttamente''': se la variabile che si desidera modificare non si trova nel file <code>LocaleSettings.php</code> basterà copiare la riga relativa alla variabile stessa dal file <code>DefaultSettings.php</code> e inserirla in <code>LocalSettings.php</code> e di qui modificarne il valore. | |||
Le opzioni di configurazione, infatti, sono espresse sotto forma di variabili PHP: in genere si presentano così | |||
<pre> $nome_variabile = true;</pre> | |||
Dove, ovviamente, i valori che la variabile può assumere sono <code>true</code> (nel caso in cui venga abilitata l'opzione corrispondente) o <code>false</code> (in caso contrario). | |||
{{Box|Nota:|il manuale di Mediawiki avvisa che nel vostro file <code>LocalSettings.php</code> potrebbe mancare il tag di chiusura del codice php, ovvero <code>?></code> alla fine del file, ma che questo è fatto di proposito per evitare che gli utenti inesperti inseriscano delle righe al di sotto del tag di chiusura e che il file funzionerà correttamente anche senza tale tag: non preoccupatevi, quindi se doveste notarne l'assenza!}} | |||
[http://www.mediawiki.org/wiki/Manual:Configuration_settings Qui] troverete un elenco completo, con relative spiegazioni, delle variabili che possono essere configurate in <code>LocalSettings.php</code>. | |||
Di seguito verranno illustrate alcune operazioni di configurazione basilari per il nostro wiki. | |||
===Modificare il logo MediaWiki=== | ===Modificare il logo MediaWiki=== | ||
Il logo di default di MediaWiki può essere modificato con un'immagine a nostra scelta, purché le sue dimensioni siano pari o inferiori ai 135x135 pixel.<br/> | |||
La variabile da modificare è <code>'''$wgLogo'''</code> e a tale variabile dobbiamo, ovviamente, associare il path dell'immagine che utilizzeremo come logo.<br/> | |||
Dunque, apriamo il file <code>/etc/mediawiki/LocalSettings.php</code> e inseriamo, nell'ultima riga (ma sempre prima del tag di chiusura del file php, ovvero <code>?></code>) la seguente riga (il percorso all'immagine del vostro logo potrebbe variare: adattatelo secondo le vostre esigenze): | |||
<pre>$wgLogo = "/mediawiki/images/logo.png";</pre> | |||
{{Warningbox|Non cambiate il logo limitandovi a sostituire il logo di default installato con MediaWiki (che si trova in <code>/skins/common/images/wiki.png</code>) con il vostro logo: infatti questa cartella verrà sovrascritta ad ogni aggiornamento di MediaWiki!}} | |||
===Abilitare la scrittura di equazioni LaTeX=== | |||
Occorre semplicemente modificare in questa maniera: | |||
<pre> | |||
$wgUseTeX = true; | |||
</pre> | |||
la variabile presente in /etc/mediawiki/LocalSettings.php | |||
===Upload dei file: configurazioni varie=== | |||
Una delle caratteristiche più utilizzate dagli utenti di un wiki è l'upload di immagini, per arricchire gli articoli inseriti. Anche nel caso dell'upload di file, sono possibili vari aggiustamenti e scelte personalizzate tramite la modifica e l'inserimento di variabili specifiche nel file <code>LocalSettings.php</code>.<br/> | |||
====Abilitare il caricamento di file==== | |||
Il caricamento di file da parte degli utenti è inizialmente disabilitato, per motivi di sicurezza, nelle installazioni di MediaWiki. Pertanto è necessario abilitarlo nel file <code>LocalSettings.php</code>. | |||
Per prima cosa,è necessario controllare la presenza di alcuni prerequisiti: | |||
*'''assicuratevi che l'upload dei file sia abilitato in PHP''' : in particolare, all'interno del file <code>/etc/php5/cli/php.ini</code> e nel file <code>/etc/php5/apache2/php.ini</code> alla sezione <code>File Uploads</code> deve essere presente la riga: | |||
<pre>file_uploads = On</pre> | |||
Se non è presente, infatti, gli script PHP non potranno utilizzare la funzione di upload. | |||
*'''controllate i permessi della cartella <code>/var/lib/mediawiki/images</code>''': dovrà avere permessi <code>755</code>; per fare ciò basterà dare da terminale il seguente comando (come proprietario della cartella): | |||
<pre>chmod -R 755 /var/lib/mediawiki/images</pre> | |||
A questo punto possiamo aprire il nostro <code>LocalSettings.php</code>: scorriamolo fino a raggiungere la riga | |||
<pre>$wgEnableUploads = false;</pre> | |||
che modificheremo in | |||
<pre>$wgEnableUploads = true;</pre> | |||
Le impostazioni di default prevedono che tutti gli utenti registrati al wiki possano caricare file: è possibile modificare questo comportamento di MediaWiki attraverso l'uso della variabile <code>$wgGroupPermissions</code>. Ad esempio, per permettere l'upload di un nuovo file (o di caricare una nuova versione di un file esistente) anche ad utenti non registrati, basterà aggiungere queste righe: | |||
<pre> | |||
# Upload anonimo abilitato | |||
$wgGroupPermissions['*']['upload'] = true; | |||
$wgGroupPermissions['*']['reupload'] = true; | |||
</pre> | |||
Maggiori informazioni sono reperibili consultando [http://www.mediawiki.org/wiki/Manual:$wgGroupPermissions questa pagina]. | |||
====Abilitare il caricamento di altri tipi di file (pdf, doc, xls)==== | |||
La variabile che definisce il tipo di file che possono essere caricati sul wiki è '''$wgFileExtensions'''. Questa variabile, di default, permette il caricamento di file con estensione <code>png</code>,<code>gif</code>,<code>jpg</code>,<code>jpeg</code>.<br/> | |||
Tuttavia è possibile aggiungere altri tipi di file, aggiungendo le relative estensioni alla variabile $wgFileExtensions nel file <code>LocalSettings.php</code>. | |||
Questo può essere fatto in vari modi, ad esempio inserendo una riga simile a questa (sotto alla variabile $wgEnableUploads): | |||
<pre>$wgFileExtensions = array('png', 'gif', 'jpg', 'jpeg', 'doc', 'xls', 'mpp', 'pdf');</pre> | |||
oppure inserendo questa riga: | |||
<pre>$wgFileExtensions = array_merge($wgFileExtensions, array('doc', 'xls', 'mpp', 'pdf'));</pre> | |||
Io mi sono limitata ad inserire il solo formato pdf, ed ho quindi preferito aggiungere questa riga: | |||
<pre> $wgFileExtensions[] = 'pdf';</pre> | |||
È da sottolineare, comunque, che alcuni formati non verranno in ogni caso caricati, anche se ne abilitate il caricamento tramite la variabile $wgFileExtensions: questo perché, per ragioni di sicurezza, esiste una blacklist di estensioni vietate, specificate dalla variabile $wgFileBlacklist nel file <code>DefaultSettings.php</code>. | |||
===Creare una nuova skin per MediaWiki=== | ===Creare una nuova skin per MediaWiki=== | ||
''Ancora da scrivere'' | |||
===Modificare il menu di navigazione laterale=== | |||
Per modificare il menu di navigazione laterale di MediaWiki basta collegarsi, come utente amministratore, alla pagina del wiki: | |||
<pre> | |||
/index.php/MediaWiki:Sidebar | |||
</pre> | |||
Segue un esempio di come modificare la pagina: | |||
<pre> | |||
* custom wiki | |||
** mainpage|mainpage | |||
** portal-url|portal | |||
** currentevents-url|currentevents | |||
** recentchanges-url|recentchanges | |||
** randompage-url|randompage | |||
** helppage|help | |||
** sitesupport-url|sitesupport | |||
** Speciale:Categorie|Collegamento interno alla pagina delle categorie | |||
* nuovo menu | |||
**Utente:Ferdy|Collegamento alla pagina utente Ferdy | |||
**http://www.google.it|Collegamento a Google | |||
</pre> | |||
==Utilizzare MediaWiki== | ==Utilizzare MediaWiki== | ||
Il wiki di Debianizzati.org è basato su MediaWiki. Consigliamo pertanto di leggere attentamente le guide di Debianizzati.org | Il wiki di Debianizzati.org è basato su MediaWiki. Consigliamo pertanto di leggere attentamente le guide di Debianizzati.org: | ||
* [[ | * [[Aiuto:Linee guida su come contribuire al Wiki|Linee guida su come contribuire al Wiki]] | ||
Per l'amministrazione di MediaWiki è invce opportuno fare riferimento alla documentazione ufficiale: | Per l'amministrazione di MediaWiki è invce opportuno fare riferimento alla documentazione ufficiale: | ||
* | * [http://www.mediawiki.org/wiki/Manual:System_administration Amministrazione di MediaWiki] ''(in inglese)'' | ||
<br/> | |||
==Fonti e appronfondimenti== | |||
Per la stesura della guida si è fatto riferimento innanzitutto alla completissima documentazione presente sul [http://www.mediawiki.org/wiki/MediaWiki sito di MediaWiki] e in particolare alla sezione [http://www.mediawiki.org/wiki/Manual:Configuration dedicata alla configurazione], alla quale si rimanda per ulteriori approfondimenti.<br/> | |||
[[Categoria: | {{Autori | ||
[[Categoria: | |Autore = [[Utente:Ferdybassi|Ferdybassi]] 16:47, 24 feb 2010 (CET) | ||
|Estesa_da = | |||
:[[Utente:MadameZou|MadameZou]] 18:10, 21 mar 2010 (CET) | |||
|Verificata_da = | |||
:[[Utente:MadameZou|MadameZou]] 18:10, 21 mar 2010 (CET) | |||
:[[Utente:stefanodef|stefanodef]] 21:04, 1 nov 2012 | |||
|Numero_revisori= 2 | |||
}} | |||
[[Categoria:Web server]] | |||
[[Categoria:CMS]] |
contributi