Download da Git

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 Composer installato per scaricare ed installare le librerie di terze parti, ma non è richiesto.

Usare Git per scaricare MediaWiki

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 Gerrit .

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 il tuo repository:

git clone https://gerrit.wikimedia.org/r/mediawiki/core.git mediawiki

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

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, master, è la versione di sviluppo di MediaWiki; non se ne dovrebbe utilizzare il codice principale per la produzione in nessun caso poiché non è considerato stabile.

• Vedi l'ultimo codice sorgente

Scarica un ramo stabile

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

git clone https://gerrit.wikimedia.org/r/mediawiki/core.git --branch REL1_42 mediawiki

Se hai una connessione internet lenta e vuoi ridurre il numero di versioni da clonare, aggiungi --depth=1 al comando git clone.

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 1.42.3 (stabile), 1.39.10 (LTS) e 1.39.10 (legacy LTS).

Puoi vedere tutti i tag disponibili con:

git tag -l | sort -V

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

git checkout 1.42.3

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 vendor/. Il ramo master non ha questi. Per aggiornare i sotto moduli, esegui:

cd mediawiki
git submodule update --init --recursive

Recupero delle librerie esterne

MediaWiki utilizza Composer per gestire le librerie PHP esterne, che si trovano tutte nella sottodirectory vendor/ 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 composer update --no-dev dalla tua cartella MediaWiki. Questo è l'approccio consigliato.
  • Se la versione predefinita di PHP CLI non corrisponde alla versione di PHP del server web, specificarla con, ad esempio, php7.4 composer.phar update --no-dev.
• 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 vendor/ all'interno della directory principale della tua installazione di MediaWiki.
  git clone https://gerrit.wikimedia.org/r/mediawiki/vendor.git
  • 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:

git pull

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 git pull --recurse-submodules.

È inoltre necessario aggiornare vendor/ 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:

composer update --no-dev

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

php maintenance/run.php update

Se usi MediaWiki-Vagrant , esiste un solo comando, vagrant git-update, 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 master a un ramo o tag diverso), controlla quel particolare ramo o tag nella tua directory clone di MediaWiki:

git checkout <branch_name>

o

git checkout <tag_name>

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 ‎<EXT> con il nome dell'estensione che vuoi scaricare, senza spazi. Per Extension:TitleKey , sarebbe TitleKey. (case sensitive! - attenzione alle maiuscole!)

Scarica e clona un'estensione da Git:

Con il tuo account di sviluppatore, usa questi comandi per ottenere il branch principale:

cd /path/to/extensions
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/<EXT>

Per clonare e fare il checkout di un branch di rilascio stabile, utilizza questi comandi:

cd /path/to/extensions
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/<EXT> --branch REL1_42

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

https://gerrit.wikimedia.org/g/mediawiki/extensions/<EXT>/+/HEAD

Scarica tutte le estensioni

Se preferisci avere tutte le estensioni MediaWiki che sono su gerrit.wikimedia.org installate nella tua macchina, inserisci quanto segue:

git clone https://gerrit.wikimedia.org/r/mediawiki/extensions

Oppure, per fare il checkout delle versioni del branch stabile, utilizza questo comando:

git clone https://gerrit.wikimedia.org/r/mediawiki/extensions --branch REL1_42

Dopo aver eseguito il comando git clone, prosegui con questi comandi:

cd /path/to/extensions
git submodule update --init --recursive

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

cd /path/to/extensions
git pull
git submodule update --init --recursive

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

git submodule foreach 'git checkout -b REL1_41 origin/REL1_41 || :'

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:

git submodule foreach 'git checkout -b origin/master || :'

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 "require_once …" o "wfLoadExtension( … )" da LocalSettings.php
2. Rimuovi qualsiasi linea che faccia riferimento all'estensione in composer.local.json (di solito nella sezione "extra → merge-plugin → include")
3. Rimuovi la cartella dell'estensione in install-dir/extensions/

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 skins invece di extensions 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.

Appendice

La revisione del 21 marzo 2019 14:26 ha modificato il modo standard di fare link a gerrit.wikimedia.org:

da:

gerrit.wikimedia.org/r/p/mediawiki

a:

gerrit.wikimedia.org/r/mediawiki