Download from Git/it

Git è un sistema di controllo di versioni distribuite che permette agli utenti scaricare la versione più recente di un ramo senza dovere aspettare che qualcuno lo condivida. MediaWiki rilascerà più rapidamente, e sarà più facile aggiornare la propria installazione, annullare un aggiornamento, o [$bugzilla inviare patches]. (Ovviamente, ricorda sempre che le release ufficiali stabili sono meno rischiose).

Vedi Git per maggiori dettagli, in particolare per apportare un contributo. Qui di seguito alcune indicazioni veloci per un paio di operazioni comuni.

Prerequisiti
Devi aver installato Git per poterlo utilizzare. Esistono molti modi diversi per acquisire Git, a seconda del tuo sistema operativo. Per i sorgente e i binari ufficiali, consulta git-scm.com. Per i metodi alternativi di installazione di Git, utilizza il tuo motore di ricerca preferito per trovare le istruzioni per il tuo sistema operativo.

È raccomandabile avere Composer installato per scaricare ed installare le librerie di terze parti, ma non è necessario.

Download
E' possibile scaricare il core di MediaWiki usando Git, così come qualsiasi estensione attualmente installata sul cluster dei server Wikimedia Foundation, e molte altre estensioni ospitate su.

Il primo passo è quello di clonare il repository MediaWiki. Potrebbe richiedere un po' di tempo.

In una finestra di terminale, inserire il seguente comando:

Questo clona l'intero repository core di MediaWiki, inizialmente puntato sul ramo di rilascio, in una sottodirectory di nome.

Per installare in una cartella diversa, cambiatela nella riga di comando (per maggiori informazioni [$doc si riferiscono a questi documenti]). Una volta che il repository è clonato, puoi facilmente passare a diversi rami o tag (vedi sotto), compresi quelli che monitorano le versioni instabili di MediaWiki. Il ramo di sviluppo,, è la versione di sviluppatore di MediaWiki all'avanguardia; non si dovrebbe utilizzare il codice principale per la produzione in nessun caso poiché non è considerato stabile.

Se si desidera ridurre il numero di revisioni che vengono clonate, aggiungere  al comando precedente.

Che i rami di rilascio contengano alcuni sottomoduli Git, estensioni e skin comunemente usati (il ramo master non ha questi). Per aggiornare i sottomoduli, esegui:

Download per lo sviluppo
Se hai l' (che è facile da richiedere), invece di clonare anonimamente con l'https dovresti clonare co il tuo ssh  così che tu possa effettuare cambiamenti per essere revisionati in seguito:

Questo clona l'intero repository core di MediaWiki, sincronizzato con il ramo master, in una sottodirectory chiamata.



Recupero delle librerie esterne
MediaWiki utilizza Composer per gestire le librerie PHP esterne, che si trovano tutte nella directory  nella directory MediaWiki.

Per installare le librerie necessarie:


 * Scarica e installa il composer PHAR, facoltativamente rinomina il file composer.phar come indicato per il tuo sistema operativo, quindi esegui  dalla tua cartella MediaWiki. Questo è l'approccio consigliato.
 * Oppure, se non si desidera utilizzare Composer o se si desidera utilizzare lo stesso set di librerie del fornitore utilizzato nel cluster di produzione WMF, è possibile invece  per creare una cartella   all'interno della cartella principale del propria installazione di MediaWiki. Nota che se una qualsiasi delle tue estensioni ha i propri requisiti di Compositore, allora non puoi usare questa opzione.

Prima di MediaWiki 1.25, le librerie esterne erano conservate nel repository principale e non era richiesto alcun gestore di pacchetti.

MediaWiki tags (versione stabile)
In alternativa, le versioni stabili specifiche di MediaWiki vengono segnate con i 'tag'. Questi sono analoge alle versioni tarball. Attualmente, questi sono (stabile),  (LTS) e  (legacy).

Puoi vedere tutti i tag disponibili con:

Se non si utilizza un comando GNU, ad esempio su Mac OS X, si deve fare affidamento sui buoni vecchi separatori:

Per utilizzare un tag specifico, ad es. l'ultima versione stabile:

Ultima versione di sviluppo di MediaWiki
L'ultima versione di sviluppo di MediaWiki è tracciata nel ramo 'master'. Questo è ciò che viene localmente verificato di default quando cloni per la prima volta il repository di MediaWiki. Se ti sei spostato su un altro ramo ma vuoi tornare ad usare l'ultimissima versione di MediaWiki, esegui:

Aggiornamento continuo
Se stai usando un ramo particolare della versione di sviluppo (ramo "master") di MediaWiki, recuperare gli ultimi cambiamenti è molto facile. Spostati nella tua directory clone di MediaWiki e usa questo comando:

Tutti gli ultimi cambiamenti alla branca che sta usando verranno eseguiti.

La nuova versione del core può richiedere l'ultima versione delle estensioni e delle skin, quindi devi andare in ogni cartella di estensioni e skin e aggiornarle con il comando.

È inoltre necessario aggiornare  con le versioni più recenti delle librerie richieste. Questo spesso significa eseguire il seguente comando Composer, ma vedere Recupero delle librerie esterne sopra per maggiori dettagli:

Dopo aver fatto l'update/l'upgrade del codice e delle librerie richieste, è necessario eseguire lo script da riga di comando MediaWiki  per aggiornare le tabelle del database in base alle esigenze:

Se usi MediaWiki-Vagrant, esiste un solo comando,, che esegue tutti questi passi.

Passare ad una versione differente
Ognuna delle nostre versioni viene tracciata con rami e tag. Per spostarsi ad uno di questo, tutto quello che devi fare è il checkout di quel particolare ramo o tag nella tua directory clone di MediaWiki:

o

I cambiamenti verranno eseguiti in automatico e sarà tutto pronto per partire.

Usare Git per il download delle estensioni MediaWiki

 * Lista di esternsioni in git

Scaricare un'estensione

 *  dovrebbe essere sostituito con il nome dell'estensione che vuoi scaricare, senza spazi. Per, sarà TitleKey. (case sensitive!)

Scarica e clona un estensione da Git:

Gli sviluppatori clonano con:

Puoi vedere il codice sorgente delle estensioni nell'applicazione Gerrit's gitiles e alla seguente URL:

 https://gerrit.wikimedia.org/g/mediawiki/extensions//+/refs/heads/master

Scarica tutte le estensioni
Se si preferisce avere 'tutte' le estensioni MediaWiki che sono su gerrit.wikimedia.org installate nella tua macchina inserisci il seguente:

Successivamente, per aggiornare tutte le estensioni alle loro ultime versioni di quel ramo, basta inserire:

Per passare a un ramo diverso, ad esempio dopo una nuova versione:

Ricorda che dovresti usare solo versioni di estensioni della stessa versione di quella versione di MediaWiki e tra loro.

Per tenere traccia del ramo principale:

Si noti che non si dovrebbe utilizzare il codice principale per la produzione in nessun caso poiché non è considerato stabile.

Se hai bisogno solo di un checkout di sola lettura (per usare grep o analizzare il codice di MediaWiki), puoi usare il checkout di MediaWiki nei Laboratori, senza scaricare niente sul tuo computer.

Rimuovi un'estensione

 * 1) Rimuovi il " " o " " da
 * 2) Rimuovi qualsiasi linea che faccia riferimento all'estensione in  (di solito nella sezione "extra → merge-plugin → include")
 * 3) Rimuovi la cartella dell'estensione in

Usare Git per scaricare le skin di MediaWiki

 * Lista di interfacce in git

MediaWiki 1.24 e successivi non includono le skin nel dowload con Git.

Segui medesima procedura delle estensioni (descritta nella sezione precedente), ma utilizzando  invece di   in tutti gli URL e percorsi.

Le istruzioni dettagliate per l'installazione sono disponibili in ognuna delle pagine delle skin qui su MediaWiki.org per esempio leggi Skin:Vector#Installation. Le istruzioni per tutte le altre skin sono analoghe.

Vedi anche

 * , un alternativa per scaricare da Git
 * Intranet/Installazione Intranet, parte di una serie di articoli completamente funzionante che utilizza Git per l'implementazione di MediaWiki
 * Intranet/Installazione Intranet, parte di una serie di articoli completamente funzionante che utilizza Git per l'implementazione di MediaWiki