Download from Git/fr


 * Depuis les versions de MediaWiki 1.19beta2, 1.18.2, 1.17.3 et ultérieures, le noyau MediaWiki et beaucoup d'extensions utilisent Git pour le contrôle des versions plutôt que Subversion.

Git est un logiciel de contrôle des versions distribués qui permet aux utilisateurs de télécharger la toute dernière version d'une branche, sans avoir à attendre que quelqu'un fasse un package. MediaWiki se met à jour plus rapidement et il sera plus facile pour vous de mettre à jour votre installation, lancer une mise à jour ou soumettre des patches. (Bien entendu, souvenez-vous que les versions officielles stables sont moins risquées.)

Voir Git pour plus de détails, particulièrement pour faire des contributions. Ci-dessous se trouvent quelques directions pour faire quelques tâches courantes.

Pré-requis
Vous devez avoir installé Git avant de pouvoir l'utiliser. Vous pouvez acquérir Git de plusieurs façons, suivant votre système d'exploitation. Pour les sources et les fichiers binaires officiels, voir git-scm.com. Pour d'autres moyens d'installer Git, utilisez votre moteur de recherche favori pour trouver les instructions concernant votre système d'exploitation.

Il est recommander d'avoir composer installé pour télécharger et installer des librairies tierces, mais ce n'est pas requis.

Téléchargement
Vous pouvez actuellement télécharger le noyau de MediaWiki (phase3 sur SVN) en utilisant Git, ainsi que toute extension actuellement installée sur le serveur de la Wikimedia Foundation.

La première étape consiste à faire un clone du répertoire de MediaWiki.

Entrez ce qui suit sur votre ligne de commande: git clone https://gerrit.wikimedia.org/r/p/mediawiki/core.git

Dans le cas où vous voyez "The requested URL returned error: 403" ou bien "error: The requested URL returned error: 403 while accessing https://gerrit.wikimedia.org/r/p/mediawiki/core.git", vous avez besoin de vérifier votre version client de git git --version et de mettre à jour vers au minimum une version git 1.7, les versions 1:1.7.2.3-2.2~bpo50+1, 1.7.9.2 et 1.7.9.6 fonctionnent.

Ceci clone la base du noyau MediaWiki dans son ensemble. La 'branche' par défaut sera la toute dernière version développeur de MediaWiki. Une fois que la base est clonée, vous pouvez facilement basculer vers les différentes branches ou tags (voir plus bas), y compris celles qui traquent les versions stables de MediaWiki.

Téléchargement pour le développement
Si vous disposez d'un accès développeur (très facile à obtenir) : git clone ssh:// @gerrit.wikimedia.org:29418/mediawiki/core.git



Extraction des bibliothèques externes
Starting with MediaWiki 1.25, some external libraries that MediaWiki requires are no longer in this "core" git repository. We use composer to manage them. To install these needed libraries:


 * Download and install composer, switch to the core directory and then run . Note that if you have an existing   file you will need to run   instead.


 * If you don't want to use composer, or if you want to use the same set of vendor libraries as used on the WMF production cluster, you can instead   to create a   directory inside the core folder of your MediaWiki installation.

Branches WMF
Remote branches track the MediaWiki versions used on the Wikimedia Foundation server cluster. These may not be entirely stable, but they receive very quick bug fixes and are generally stable enough – after all, these are what major projects such as Wikipedia are using. Once a REL* branch is considered 'stable', we 'tag' it and turn it into a tarball release.

Pour voir quelles branches sont disponibles, basculez sur votre clone de MediaWiki et tapez la commande suivante: git branch -r | sort -V Les versions majeures sont repérées par "origin/REL " comme par exemple "origin/". Pour basculer sur une branche de version particulière: git checkout -b REL origin/REL Par exemple, pour passer à la version stable actuelle,, entrez : git checkout -b origin/

Marqueurs MediaWiki (version stable)
Autrement, les versions stables spécifiques de MediaWiki sont tracées en utilisant des 'marqueurs'. Ces derniers sont analogues aux distributions tarball. Vous pouvez voir les versions disponibles en tapant ce qui suit: git tag -l | sort -V Si vous utilisez une commande de tri non GNU, comme par exemple sur Mac OS X, vous devez utiliser ces bons vieux séparateurs: git tag -l | sort -n -t. -k1 -k2 -k3

Pour utiliser un marqueur spécifique: git checkout

Dernière version développement de MediaWiki
La dernière version développement de MediaWiki est tracée dans la branche 'master'. C'est ce qui est vérifié par défaut lorsque vous clonez en premier la base de connaissances MediaWiki. Si vous avez basculé sur autre branche mais souhaitez revenir sur la toute dernière version de MediaWiki, tapez: git checkout master

Restez à jour
Si vous utilisez une branche particulière ou bien la version développement de MediaWiki, récupérer les dernières modifications est vraiment facile. Basculez sur votre clone du répertoire MediaWiki et tapez la commande suivante: git pull Toutes les dernières modifications concernant la branche que vous utilisez seront appliquées.

Puis, après avoir effectué la mise à jour, vous devriez faire tourner le script de mise à jour MediaWiki depuis la ligne de commande: php maintenance/update.php

Basculement vers une version différente
Le basculement vers une version différente de MediaWiki est bien plus simple avec Git qu'avec SVN. Chacune de nos versions sont tracées en tant que branches ou marquages. Pour basculer vers l'une d'entre elles, tout ce que vous avez à faire est de 'sélectionner' la branche ou le marquage que vous souhaitez depuis votre clone du répertoire MediaWiki: git checkout ou bien git checkout Les modifications seront appliquées automatiquement et tout sera automatiquement configuré pour que vous puissiez y aller.

Téléchargement

 * Liste des extensions dans Git
 * EXT devrait être remplacé par le nom de l'extension que vous voulez télécharger, sans espace. Pour Extension:TitleKey, on écrirait donc TitleKey.

Pour téléchargez et cloner une extension depuis Git:

cd /path/to/extensions git clone https: //gerrit.wikimedia.org/r/p/mediawiki/extensions/.git

Les développeurs cloneront comme suit: git clone ssh:// @gerrit.wikimedia.org:29418/mediawiki/extensions/.git Le code source peut être vérifié comme suit:

https://gerrit.wikimedia.org/r/gitweb?p=mediawiki/extensions/.git;a=tree;h=refs/heads/master;hb=master

Téléchargement de toutes les extensions
Si vous préférez disposer de toutes les extensions MediaWiki qui sont sur gerrit.wikimedia.org directement sur votre machine, tapez ce qui suit:

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

Pour mettre à jour les extensions vers leur dernière version, faites simplement ceci:

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

Pour dépister une branche spécifique: git submodule foreach 'git checkout -b REL1_24 origin/REL1_24 || :'

Utilisation de Git pour télécharger des extensions MediaWiki
MediaWiki 1.24 and later don't include skins in the Git download.

Téléchargement
git clone https://gerrit.wikimedia.org/r/p/mediawiki/skins.git

Switch to the skins folder, that was just cloned. Obtenir toutes les apparences utiliser :

git submodule update --init --recursive

Add a  line to your  file corresponding to the skin:
 * (This is identical to extension installation, only in a different directory.)
 * (This is identical to extension installation, only in a different directory.)

Detailed installation instructions are available on each skin's page here on MediaWiki.org, for example see Skin:Vector#Installation. Instructions for all other skins are analogous.

Voir aussi

 * Migration depuis SVN vers Git
 * Nightlies, une alternative pour télécharger depuis Git