Download da Git

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

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

Git è un software distribuito per il controllo della versione che permette agli utenti di scaricare l'ultima versione di un programma, senza dover aspettare qualcuno che lo condivida. MediaWiki rilascerà più velocemente, e sarà più facile per voi per aggiornare la propria installazione, eseguire il rollback di un aggiornamento, o presentare patch. (Ovviamente ricordate che i download ufficiali sono più stabili e meno rischiosi.)

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

Prerequisiti

Tu hai bisogno di avere Git installato prima che tu lo possa usare. Ci sono vari modi per acquisire Git, a seconda dal tuo sistema operativo. Per il sorgente e l'exe visitare git-scm.com. Per altri modi per installare Git, usa 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

Attualmente è possibile scaricare il nucleo MediaWiki usando Git, così come qualsiasi estensione attualmente installata sul cluster dei server Wikimedia Foundation, e molte altre estensioni ospitate su Gerritgerrit.

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

In una finestra di terminale, inserisci il seguente comando:

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

Questo clona tutto il repository del nucleo di MediaWiki in una sottocartella chiamata core. Per installarla in una cartella specifica, aggiungila alla riga di comando (per ulteriori info refer to these docs). Il "ramo" principale sarà master, la versione degli sviluppatori più curata di MediaWiki. Una volta clonata la repository, puoi facilmente cambiare tra differenti rami o tag (vedi sotto), incluse le versioni stabili di MediaWiki.

Download per lo sviluppo

Se hai l'accesso come sviluppatoreDeveloper access (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

Recupero delle librerie esterne

A partire da MediaWiki 1.25, alcune librerie esterne richieste da MediaWiki non si trovano più nel nucleo del git repository. Utilizziamo composer per gestirle. Per installare le librerie necessarie:

  • Scarica e installa il composer, passa alla cartella primaria e fai partire composer install --no-dev. Nota che se hai già un composer.lock file dovrai far partire composer update --no-dev.
  • Se non vuoi utilizzare il composer, o se vuoi utilizzare lo stesso set di librerie utilizzato dalla produzione WMF, puoi usare git clone https://gerrit.wikimedia.org/r/p/mediawiki/vendor.git per creare una cartella vendor/ all'interno della cartella core della tua installazione MediaWiki. Assicurati di star usando il ramo corretto per la tua versione di MediaWiki (es. REL1_25 per la 1.25).

Versioni specifiche di MediaWiki

WMF branch

I branch remoti tracciano le versioni di MediaWiki utilizzate nei cluster di server nella Wikimedia Foundation. Questi potrebbero non essere completamente stabili, ma ricevono velocemente buf fix e generalmente sono abbastanza stabili (dopotutto questi sono i branch che i maggiori progetti come Wikipedia stanno usando). Prima che un branch REL* sia considerato stabile lo 'tag' e lo trasformiamo in rilascio tarball.

Per vedere i rami disponibili, passa alla tua cartella core di MediaWiki ed esegui il seguente comando:

git branch -r | sort -V

le major release sono identificate da "origin/REL<release number>" (esempio "origin/REL1_29"). Per passare a un branch particolare:

git checkout -b REL<numero release> origin/REL<numero release>

Per esempio per passare alla versione stabile 1.29.0 corrente inserire:

git checkout -b REL1_29 origin/REL1_29
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:

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 usare un tag specifico:

git checkout <nome del tag>

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 il comando git pull:

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

Inoltre, dopo aver fatto l'update/l'upgrade, dovresti eseguire l'update.phpManual:update.php di MediaWiki dalla riga di comando per aggiornare le tavole del database:

php maintenance/update.php

Devi anche aggiornare mediawiki/vendor all'ultima versione delle librerie richieste, vedi #Fetch external libraries.

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

Gli sviluppatori clonano con:

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

Puoi vedere il codice sorgente delle estensioni nell'applicazione Phabricator e alla seguente URL:

https://gerrit.wikimedia.org/r/gitweb?p=mediawiki/extensions/<EXT>.git;a=tree;h=refs/heads/master;hb=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/p/mediawiki/extensions.git
cd extensions
git submodule update --init --recursive

Per aggiornare le estensioni all'ultima versione, basta fare questo:

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

Per seguire uno specifico ramo:

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

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

Semplicemente rimuovi l'estensione dalla cartelle e rimuovi "require_once …" da LocalSettings.php.

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