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
You can download MediaWiki core using Git, as well as all extensions currently installed on the Wikimedia Foundation server cluster and many other extensions hosted on.

The first step is to clone the MediaWiki core repository. This will take a while.

Dans une fenêtre de terminal, entrez la commande qui suit : git clone https://gerrit.wikimedia.org/r/p/mediawiki/core.git

Ceci va cloner l’intégralité du dépôt de MediaWiki dans un sous-dossier nommé core. Pour une installation dans un dossier nommé différemment, ajoutez le nom de ce dossier à la ligne de commande (consultez ces documents pour plus d’information). La « branche » par défaut sera, la toute dernière version développeur de MediaWiki. Une fois que le dépôt est cloné, vous pouvez facilement basculer vers les différentes branches ou tags (voir plus bas), y compris celles qui suivent les versions stables de MediaWiki.

Téléchargement pour le développement
If you have Developer access (which is easy to request), then instead of cloning anonymously with https you should clone with your ssh  so that you can submit changes for review: git clone ssh:// @gerrit.wikimedia.org:29418/mediawiki/core.git



Extraction des bibliothèques externes
À partir de MediaWiki 1.25, certains bibliothèques externes requises par le logiciel ne sont plus disponible dans le dépot "core". Nous utilisons composer pour gérer ces dépendances. To install these needed libraries, you have a choice:


 * Téléchargez et installez composer, positionnez vous dans le répertoire de "core", puis lancez composer install --no-dev . Notez que si il existe un fichier composer.lock, vous devrez plutôt lancer composer update --no-dev.

Make sure you use the right branch for your MediaWiki version (e.g. REL1_25 for 1.25).
 * Si vous ne souhaitez par utiliser composer, ou si vous voulez utiliser le même jeu de bibliothèques que sur les serveurs de production WMF, vous pouvez à la placer git clone https://gerrit.wikimedia.org/r/p/mediawiki/vendor.git pour créer un répertoire vendor/ dans le répertoire core de votre installation MediaWiki.

Branches WMF
Les branches distantes sont utilisées pour récupérer les versions de MediaWiki utilisées sur la grappe de serveurs de la Wikimedia Foundation. Ces dernières ne sont peut-être pas tout à fait stables, mais elles reçoivent très rapidement des corrections de bogue et sont généralement assez stables – après tout, ce sont ces versions que des projets importants comme Wikipédia utilisent. Une fois qu'une branche REL* est considérée 'stable', nous la 'marquons' et la basculons dans une distribution tarball.

To see what branches are available, switch to your MediaWiki core directory and enter the following command: 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
If you're using a particular branch or the development version ("master" branch) of MediaWiki, picking up the latest changes is relatively easy. Change into your MediaWiki clone directory and issue the git pull command:

git pull

Toutes les dernières modifications concernant la branche que vous utilisez seront appliquées.

The new version of core may require newer versions of extensions and skins, so you must go into each extension and skin directory and update it with a command like git pull --recurse-submodules.

After updating/upgrading you should run the MediaWiki  command-line script to update database tables as needed:

php maintenance/update.php

You also need to update mediawiki/vendor to any newer versions of required libraries, see.

If you use MediaWiki-Vagrant, it offers a single command, vagrant git-update, that performs all these steps.

Basculement vers une version différente
Switching to a different version of MediaWiki is far simpler with Git than with SVN. Each of our versions are tracked as branches or tags. In order to switch to one of these, all you have to do is checkout the particular branch or tag you want from within your MediaWiki clone directory: git checkout ou bien git checkout Les modifications seront appliquées automatiquement et tout sera automatiquement configuré pour que vous puissiez y aller.

Utilisation de Git pour télécharger des extensions MediaWiki

 * Liste des extensions dans git

Télécharger une extension

 * [$url 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/<EXT>.git You can view extension source code in Phabricator's diffusion application, and at the URL:

<pre style="white-space: pre-wrap;"> https://gerrit.wikimedia.org/r/gitweb?p=mediawiki/extensions/<EXT>.git;a=tree;h=refs/heads/master;hb=master

Téléchargement de toutes les extensions
If you prefer to have all MediaWiki extensions that are at gerrit.wikimedia.org checked out to your machine, enter the following:

Thereafter, to update all extensions to their latest versions, just enter:

Pour dépister une branche spécifique:

If you only need a read-only checkout (for instance to grep or analyse all MediaWiki code), you can use the shared MediaWiki checkout on Labs, without downloading anything on your machines.

Enlever une extension
Enlever le dossier extension et " " de.

Utilisation de Git pour télécharger des "skins" MediaWiki

 * Liste des skins dans git

À partie de MediaWiki 1.24, les téléchargement par Git n'incluent pas les "skins".

Suivez exactement la même procédure que pour les extensions (décrite dans la section précédente), mais en utilisant  à la place de extensions dans tous les URLs et chemins.

Les instructions d'installation détaillées sont disponible pour chaque page de thème sur MediaWiki.org, par exemple Skin:Vector#Installation. Les intrutions sont analogues pour les autres thèmes.

Voir aussi

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