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 71% complete.
Outdated translations are marked like this.
Other languages:
Bahasa Indonesia • ‎Bahasa Melayu • ‎Deutsch • ‎English • ‎Esperanto • ‎Napulitano • ‎Nederlands • ‎Scots • ‎Tiếng Việt • ‎Türkçe • ‎asturianu • ‎català • ‎dansk • ‎español • ‎euskara • ‎français • ‎galego • ‎interlingua • ‎italiano • ‎lietuvių • ‎magyar • ‎norsk bokmål • ‎occitan • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎sicilianu • ‎slovenčina • ‎suomi • ‎svenska • ‎čeština • ‎Ελληνικά • ‎беларуская (тарашкевіца)‎ • ‎български • ‎русский • ‎українська • ‎қазақша • ‎العربية • ‎سنڌي • ‎فارسی • ‎अवधी • ‎हिन्दी • ‎ไทย • ‎中文 • ‎日本語 • ‎한국어

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

It allows you to download the very latest version of the source code, with all the branches and tagged releases at your disposal.

You should download from Git if you are a developer and want to submit patches.

If you do not want to develop but only install MediaWiki and extensions, then download stable tarball releases instead.

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 [$link 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.

Follow Gerrit/Tutorial#Set up Git, or use your favorite search engine.

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

Download per lo sviluppo

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:

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:

In una finestra di terminale, inserire il seguente comando:

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.

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.

Download a stable branch

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

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

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

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 1.34.2 (stabile), 1.31.8 (LTS) e 1.33.4 (legacy).

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

Update the Git submodules

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

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 per creare una cartella vendor/ all'interno della cartella principale del propria installazione di MediaWiki.
    • With your developer account, use this command: git clone ssh://<USERNAME>@gerrit.wikimedia.org:29418/mediawiki/vendor.git
    • For anonymous checkout, use this command: git clone https://gerrit.wikimedia.org/r/mediawiki/vendor.git
    • 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.

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:

This often means running the following Composer command, but see #Fetch external libraries above for more details:

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

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 Extension:TitleKey , sarà TitleKey. (case sensitive!)

Scarica e clona un estensione da Git:

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

cd /path/to/extensions
git clone ssh://<USERNAME>@gerrit.wikimedia.org:29418/mediawiki/extensions/<EXT>

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

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

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:

With your developer account, to get the master branch:

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

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

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

After running the git clone command, continue with these commands:

cd /path/to/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_33 origin/REL1_33 || :'

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