Download from Git/it

Git è un sistema di controllo di versioni distribuite. Permette agli utenti di scaricare la versione più recente del codice sorgente, con tutti i rami e le versioni taggate a tua disposizione.

Dovresti scaricare da Git, se sei uno sviluppatore e vuoi proporre patch.

Se non desideri sviluppare, bensì solamente installare MediaWiki e le sue estensioni, allora scarica i tarball stabili, piuttosto.

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 prima di poterlo utilizzare. Ci sono molti modi diversi per acquisire Git, a seconda del tuo sistema operativo. Segui Gerrit/Tutorial#installare Git, o usa il tuo motore di ricerca preferito.

È preferibile avere installato per scaricare ed installare le librerie di terze parti, ma non è richiesto.



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 principale di MediaWiki. Potrebbe richiedere un po' di tempo.



Download per lo sviluppo
L'ultima versione di sviluppo di MediaWiki è tracciata nel ramo 'master'.

Per prima cosa assicurati di aver creato un account dev, così potrai avere un nome utente SSH.

Poi, in una finestra di terminale, inserisci il seguente comando per clonare con il tuo ssh, così potrai proporre patch per la revisione:

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

Per installare in una cartella diversa, cambiala nella riga di comando (per maggiori informazioni [$doc si riferisce a questi documenti]). Una volta che il repository è clonato, puoi facilmente passare a diversi rami o tag. Il ramo di sviluppo,, è la versione di sviluppo di MediaWiki; non se ne dovrebbe utilizzare il codice principale per la produzione in nessun caso poiché non è considerato stabile.





Scarica un ramo stabile
Se non intendi sviluppare patch per il software, ma vuoi invece clonare anonimamente il ramo della versione stabile, usa invece questo comando:

Se hai una connessione internet lenta e vuoi ridurre il numero di versioni da clonare, aggiungi  al comando.



MediaWiki tags (versione stabile)
In alternativa, le specifiche versioni stabili di MediaWiki vengono tracciate con 'tag' ('etichette'). Queste etichette sono analoghe a quelle delle versioni tarball. Attualmente, questi sono (stabile),  (LTS) e  (legacy LTS).

Puoi vedere tutti i tag disponibili con:

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



Aggiorna i submoduli di Git
I rami e i tag contengono un gruppo sottomoduli Git all'interno, per estensioni di uso comune e skin per la directory. Il ramo  non ha questi. Per aggiornare i sotto moduli, esegui:



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

Per installare le librerie necessarie, puoi scegliere:


 * 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.
 * If the default PHP CLI version does not match the web server's PHP version, specify it with e.g..
 * Oppure, se non vuoi utilizzare Composer o se intendi utilizzare lo stesso esatto set di librerie del fornitore così come utilizzato nel cluster di produzione WMF, puoi invece creare una directory  all'interno della directory principale della tua installazione di MediaWiki.
 * With your developer account, use this command:
 * For anonymous checkout, use this command:
 * Nota che se una qualsiasi delle tue estensioni ha propri specifici requisiti in Composer, 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.



Tenere aggiornato
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 al ramo che stai usando verranno applicati.

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 tutte le versioni più recenti delle librerie richieste. Questo spesso significa dover eseguire il seguente comando Composer, ma vedi sopra Recupero delle librerie esterne per maggiori dettagli:

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

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



Passare a una versione differente
Ognuna delle nostre versioni è tracciata con rami e tag. Per spostarsi a una versione diversa (per esempio dal ramo  a un ramo o tag diverso), controlla quel particolare ramo o tag nella tua directory clone di MediaWiki:

o

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



Usare Git per il download delle estensioni MediaWiki

 * Lista di estensioni in git



Scaricare un'estensione

 * Nei prossimi comandi, sostituisci con il nome dell'estensione che vuoi scaricare, senza spazi. Per, sarebbe TitleKey. (case sensitive! - attenzione alle maiuscole!)

Scarica e clona un'estensione da Git:

With your developer account, use these commands to get the master branch:

For anonymous checkout of the stable branch instead, use these commands:

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 preferisci avere tutte le estensioni MediaWiki che sono su gerrit.wikimedia.org installate nella tua macchina, inserisci quanto segue:

With your developer account, to get the master branch:

For anonymous checkout of the stable branch instead, use this command:

After running the  command, continue with these commands:

In qualsiasi momento, 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:

Ricorda che in produzione non si dovrebbe utilizzare il codice master in nessun caso poiché non è considerato stabile.

Se hai bisogno solo di un checkout di sola lettura (per usare grep o analizzare tutto il codice di MediaWiki), puoi usare il checkout condiviso di MediaWiki su Labs, senza scaricare niente sulle tue macchine.



Rimuovi un'estensione

 * 1) Rimuovi " " 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 skin (interfacce) in git

MediaWiki 1.24 e successivi non includono le skin nel download da Git.

Segui la stessa esatta procedura seguita per le estensioni (descritta nella sezione precedente), ma utilizzando  invece di   in tutti gli URL e percorsi.

Sono disponibili istruzioni dettagliate per l'installazione in ciascuna 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

 * Intranet/Installazione Intranet, parte di una serie di articoli completi che utilizza Git per la distribuzione di MediaWiki

Appendix
The Revision as of 14:26, 21 March 2019 changed the standard of linking to gerrit.wikimedia.org: from:
 * gerrit.wikimedia.org/r/ p /mediawiki

to:
 * gerrit.wikimedia.org/r/mediawiki