982
contributi
(modificato paragrafo Modificare l'installazione di Mediawiki - inserita introduzione generale) |
(aggiunto nota su LTS non più supportata) |
||
(17 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/> | ||
Riga 8: | Riga 11: | ||
* [[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 35: | 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 57: | Riga 63: | ||
Di seguito verranno illustrate alcune operazioni di configurazione basilari per il nostro wiki. | 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'' | ''Ancora da scrivere'' | ||
Riga 84: | Riga 144: | ||
==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: | * [[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)'' | * [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/> | |||
{{Autori | |||
[[Categoria: | |Autore = [[Utente:Ferdybassi|Ferdybassi]] 16:47, 24 feb 2010 (CET) | ||
[[Categoria: | |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