Télécharger à partir de 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 • ‎ייִדיש • ‎粵語 • ‎中文
Depuis les versions de MediaWiki 1.19beta2, 1.18.2, 1.17.3, le noyau MediaWiki et beaucoup d'extensions utilisent Git pour le contrôle des versions. Pour les versions plus anciennes, voir 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 correctifs. (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[edit]

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 recommandé d'avoir composer installé pour télécharger et installer des librairies tierces, mais ce n'est pas requis.

Utilisation de Git pour télécharger MediaWiki[edit]

Téléchargement[edit]

Vous pouvez télécharger le noyau de MediaWiki en utilisant Git, ainsi que toutes les extensions actuellement installées sur les serveurs de la Wikimedia Foundation et d'autres extensions hébergées sur Gerritgerrit.

La première étape consiste à faire un clone du répertoire de MediaWiki. Cette opération prend un moment.

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 master, 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[edit]

Si vous disposez d'un accès développeur (qui est facile à obtenir), alors au lieu de cloner anonymement avec HTTPS, vous devriez cloner avec votre nom d'utilisateur SSH de sorte que vous puissiez soumettre des changements pour révision :

git clone ssh://<Nom d'utilisateur>@gerrit.wikimedia.org:29418/mediawiki/core.git

Extraction des bibliothèques externes[edit]

À partir de MediaWiki 1.25, certaines bibliothèques externes requises par le logiciel ne sont plus disponible dans le dépôt « core ». Nous utilisons composer pour gérer ces dépendances. Pour installer ces bibliothèques requises, vous avez le choix :

  • Téléchargez et installez composer, positionnez vous dans le répertoire « 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.
  • 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. Assurez-vous d'utiliser la bonne branche de votre version de MediaWiki (par exemple REL1_25 pour 1.25).

Versions MediaWiki spécifiques[edit]

Branches WMF[edit]

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

Pour voir quelles branches sont disponibles, basculez sur votre clone du noyau MediaWiki et tapez la commande suivante :

git branch -r | sort -V

Les versions majeures sont repérées par « origin/REL<release number> », comme par exemple « origin/REL1_29 ». Pour basculer sur une branche de version particulière :

git checkout -b REL<Numéro de libération> origin/REL<Nom de version>

Par exemple, pour passer à la version stable actuelle, 1.29.0, entrez :

git checkout -b REL1_29 origin/REL1_29
Marqueurs MediaWiki (version stable)[edit]

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 <nom de variable>

Dernière version de développement de MediaWiki[edit]

La dernière version de 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[edit]

Si vous utilisez une branche particulière ou bien la version de développement (branche « master ») de MediaWiki, récupérer les dernières modifications est vraiment facile. Basculez sur votre clone du répertoire MediaWiki et tapez la commande git pull :

git pull

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

La nouvelle version du noyau peut nécessiter de nouvelles versions des extensions et des thèmes, donc vous devez aller dans le répertoire de chaque extension et chaque thème et le mettre à jour avec une commande comme git pull --recurse-submodules.

Après avoir effectué la mise à jour, vous devriez faire tourner le script en ligne de commande update.phpManual:update.php de MediaWiki pour mettre à jour les tables de la base de données comme nécessaire :

php maintenance/update.php

Vous devez aussi mettre à jour mediawiki/vendor à toutes les nouvelles versions des bibliothèques requises, voir #Extraction des bibliothèques externes.

Si vous utilisez MediaWiki-Vagrant, il offre une simple commande, vagrant git-update, qui effectue toutes ces étapes.

Basculement vers une version différente[edit]

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 <Nom de la succursale>

ou bien

git checkout <nom de variable>

Les modifications seront appliquées automatiquement et tout sera configuré pour que vous puissiez y aller.

Utilisation de Git pour télécharger des extensions MediaWiki[edit]

Liste des extensions dans git

Télécharger une extension[edit]

[$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/<EXT>.git

Les développeurs cloneront comme suit:

git clone ssh://<Nom d'utilisateur>@gerrit.wikimedia.org:29418/mediawiki/extensions/<EXT>.git

Vous pouvez visualiser le code source d'une extension dans l'application de la diffusion de Phabricator, et à l'URL :

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[edit]

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

Ensuite, pour mettre à jour toutes les extensions vers leur dernière version, tapez simplement :

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_29 origin/REL1_29 || :'

Si vous avez seulement besoin de vérifier quelque chose par la lecture (par exemple pour effectuer une recherche ou analyser tout le code MediaWiki), vous pouvez utiliser le clone partagé de MediaWiki dans les Labs, sans rien télécharger sur vos machines.

Enlever une extension[edit]

Enlever le dossier extension et "require_once …" de LocalSettings.php.

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

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 skins à 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[edit]