Download da Git

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Download from Git and the translation is 99% complete.

Outdated translations are marked like this.
Other languages:
Bahasa Indonesia • ‎Bahasa Melayu • ‎Deutsch • ‎English • ‎Esperanto • ‎Hawaiʻi • ‎Interlingue • ‎Lëtzebuergesch • ‎Napulitano • ‎Nederlands • ‎Scots • ‎Taqbaylit • ‎Tiếng Việt • ‎Türkçe • ‎aragonés • ‎asturianu • ‎català • ‎dansk • ‎español • ‎euskara • ‎français • ‎galego • ‎interlingua • ‎italiano • ‎kurdî • ‎lietuvių • ‎magyar • ‎norsk bokmål • ‎occitan • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎sicilianu • ‎slovenčina • ‎suomi • ‎svenska • ‎čeština • ‎Ελληνικά • ‎беларуская (тарашкевіца)‎ • ‎български • ‎русский • ‎татарча/tatarça • ‎українська • ‎հայերեն • ‎ייִדיש • ‎עברית • ‎ئۇيغۇرچە • ‎العربية • ‎تۆرکجه • ‎سنڌي • ‎فارسی • ‎پښتو • ‎नेपाली • ‎हिन्दी • ‎தமிழ் • ‎తెలుగు • ‎ไทย • ‎ქართული • ‎中文 • ‎日本語 • ‎粵語 • ‎한국어
"Dalla versione 1.19beta2, 1.18.2, 1.17.3, il sistema MediaWiki e le sue estensioni usano Git come sistema di controllo versioni. Per le versioni precedenti vedere Subversion "

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

Usare Git per il download di 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 MediaWiki. Potrebbe richiedere un po' di tempo.

In una finestra di terminale, inserire il seguente comando:

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

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

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, master, è 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 --depth=1 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:

cd mediawiki
git submodule update --init

Download per lo sviluppo

Se hai l'account come sviluppatore (che è facile da richiedere), invece di clonare anonimamente con l'https dovresti clonare co il tuo ssh <USERNAME> così che tu possa effettuare cambiamenti per essere revisionati in seguito:

git clone ssh://<USERNAME>@gerrit.wikimedia.org:29418/mediawiki/core.git mediawiki

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

Recupero delle librerie esterne

MediaWiki utilizza Composer per gestire le librerie PHP esterne, che si trovano tutte nella directory vendor/ 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 composer update --no-dev 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 git clone https://gerrit.wikimedia.org/r/p/mediawiki/vendor.git per creare una cartella vendor/ 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, versioni stabili specifiche di MediaWiki vengono segnate con 'tag'. Queste sono le stesse delle versioni tarball. È possibile visualizzare le versioni disponibili con: In alternativa, le versioni stabili specifiche di MediaWiki vengono segnate con i 'tag'. Questi sono analoge alle versioni tarball. Attualmente, questi sono 1.31.1 (stabile), 1.30.1 (LTS) e 1.30.1 (legacy).

Puoi vedere tutti i tag disponibili con:

git tag -l | sort -V

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

git tag -l | sort -n -t. -k1 -k2 -k3

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

git checkout 1.31.1

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:

git checkout master

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:

git pull

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

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

composer update --no-dev

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

php maintenance/update.php

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

Passare ad una versione differente

Passare ad un'altra versione di MediaWiki è molto più facile con Git che con SVN. 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:

git checkout <branchname>

o

git checkout <nome del tag>

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

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

Scarica e clona un estensione da Git:

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

Gli sviluppatori clonano con:

git clone ssh://<NOME UTENTE>@gerrit.wikimedia.org:29418/mediawiki/extensions/<EXT> --branch REL1_31

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

https://gerrit.wikimedia.org/g/mediawiki/extensions/<EXT>/+/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:

git clone https://gerrit.wikimedia.org/r/mediawiki/extensions --branch REL1_31
cd extensions
git submodule update --init --recursive

Successivamente, 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_30 origin/REL1_30 || :'

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 || :'

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