Télécharger à partir de 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 100% complete.

Other languages:
Bahasa Indonesia • ‎Bahasa Melayu • ‎Deutsch • ‎English • ‎Esperanto • ‎Hawaiʻi • ‎Interlingue • ‎Lëtzebuergesch • ‎Napulitano • ‎Nederlands • ‎Scots • ‎Taqbaylit • ‎Tiếng Việt • ‎Türkçe • ‎aragonés • ‎asturianu • ‎català • ‎dansk • ‎español • ‎euskara • ‎français • ‎galego • ‎interlingua • ‎italiano • ‎kurdî • ‎lietuvių • ‎magyar • ‎norsk bokmål • ‎occitan • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎sicilianu • ‎slovenčina • ‎suomi • ‎svenska • ‎čeština • ‎Ελληνικά • ‎беларуская (тарашкевіца)‎ • ‎български • ‎русский • ‎татарча/tatarça • ‎українська • ‎ייִדיש • ‎עברית • ‎ئۇيغۇرچە • ‎العربية • ‎تۆرکجه • ‎سنڌي • ‎فارسی • ‎پښتو • ‎हिन्दी • ‎தமிழ் • ‎తెలుగు • ‎ไทย • ‎ქართული • ‎中文 • ‎日本語 • ‎粵語 • ‎한국어
Depuis les versions de MediaWiki 1.19beta2, 1.18.2, 1.17.3, le noyau MediaWiki et les 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é 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, d'annuler 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. Vous trouverez ci-dessous des indications pour effectuer quelques tâches courantes.

Prérequis

Vous devez avoir installé Git avant de pouvoir l'utiliser. Vous pouvez obtenir Git de différentes manières, selon 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

Téléchargement

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

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 suivante :

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

Ceci clone l'ensemble du dépôt du noyau MediaWiki, initialement pointé sur la branche de publication 1.32, dans un sous-répertoire nommé mediawiki.

Pour installer dans un autre répertoire, modifiez-le dans la ligne de commande (pour plus d'informations, consultez la documentation). Une fois le dépôt cloné, vous pouvez facilement passer à différentes branches ou étiquettes (voir ci-dessous), y compris celles qui suivent les versions instables de MediaWiki. La branche de développement, master, est la version de développement de MediaWiki; vous ne devez en aucun cas utiliser le code master pour la production car il n'est pas considéré comme stable.

Si vous voulez réduire le nombre de révisions qui sont clonées, ajoutez --depth=1 à la commande ci-dessus.

Les branches de versions contiennent beaucoup de sous-modules Git correspondant aux extensions et aux habillages couramment utilisés (la branche master n'en contient pas). Pour mettre à jour les sous-modules, exécutez :

cd mediawiki
git submodule update --init

Téléchargement pour le développement

Si vous disposez d'un compte développeur (qui est facile à obtenir), alors au lieu de cloner anonymement avec HTTPS, vous devez cloner avec votre nom d'utilisateur SSH de sorte à pouvoir soumettre des changements à la relecture :

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

Ceci clone le dépôt entier du coeur de MediaWiki, synchronisé avec la branche Master, vers un sous-répertoire nommé mediawiki.

Extraction des bibliothèques externes

Mediawiki utilise Composer pour gérer les bibliothèques PHP externes, qui viennent se placer dans le dossier vendor de votre répertoire MediaWiki.

Pour installer ces bibliothèques requises, vous avez le choix :

  • Téléchargez et installez composer PHAR, éventuellement renommez le fichier composer.PHAR comme indiqué pour votre système d'exploitation, positionnez-vous dans votre répertoire MediaWiki et lancez composer update --no-dev. Il s'agit là de la manière recommandée.
  • Si vous ne souhaitez pas utiliser Composer, ou si vous voulez utiliser exactement les mêmes bibliothèques que celles déployées sur les serveurs de production de WMF, vous pouvez utiliser git clone https://gerrit.wikimedia.org/r/mediawiki/vendor.git pour créer un répertoire vendor/ dans le répertoire principal de votre installation MediaWiki. Veuillez noter que si au moins une de vos extensions possède ses propres dépendances Composer, alors vous ne pourrez pas utiliser cette option.

Avant MediaWiki 1.25, les bibliothèques externes étaient disponibles dans le dépôt du noyau, et il n'était pas nécessaire d'utiliser un gestionnaire de package.

Tags de MediaWiki (version stable)

Autrement, les versions stables spécifiques de MediaWiki sont tracées en utilisant des « marqueurs » (tags). Ces derniers sont analogues aux distributions tarball. Vous pouvez voir les versions disponibles en tapant ce qui suit :

Vous pouvez voir tous les marqueurs disponibles avec :

git tag -l | sort -V

Si vous utilisez une commande de tri non GNU, comme par exemple sur Mac OS X, vous devez utiliser les bons vieux séparateurs :

git tag -l | sort -n -t. -k1 -k2 -k3

Pour utiliser un marqueur spécifique (par exemple, la dernière version stable) :

git checkout 1.32.2

Dernière version de développement de MediaWiki

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 la première fois 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 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 cette commande :

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.

Vous devez aussi mettre à jour vendor avec toute nouvelle version disponible des bibliothèques nécessaires, voir Extraction des bibliothèques externes ci-dessus pour plus de détails.

composer update --no-dev

Après avoir effectué la mise à jour du code et des bibliothèques nécessaires, vous devez exécuter le script en ligne de commande update.php de MediaWiki pour mettre à jour convenablement les tables de la base de données :

php maintenance/update.php

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

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 est tracée en tant que branche ou marquage. 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 branche>

ou bien

git checkout <nom de marqueur>

Les modifications seront appliquées automatiquement et tout sera prêt.

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

Liste des extensions dans git

Télécharger une extension

EXT devrait être remplacé par le nom de l'extension que vous voulez télécharger, sans espace. Pour l'extension:TitleKey, on écrirait donc TitleKey. (sensible aux majuscules et minuscules!)

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

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

Les développeurs cloneront comme suit :

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

Vous pouvez voir le code source de l'extension dans les répertoires Git de Gerrit (Gerrit's gitiles) de l'application , et à l'adresse URL :

https://gerrit.wikimedia.org/g/mediawiki/extensions/<EXT>/+/refs/heads/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/mediawiki/extensions --branch REL1_32
cd extensions
git submodule update --init --recursive

Par la suite, pour mettre à jour toutes les extensions vers leurs dernières versions de cette branche, entrez simplement :

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

Pour changer de branche, par exemple après une nouvelle version :

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

N'oubliez pas que vous ne devez seulement utiliser que des versions d'extensions de la même version que celle de MediaWiki et inversement.

Pour suivre la branche master :

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

Veuillez noter que vous ne devez en aucun cas utiliser le code master pour la production car il n'est pas considéré stable.

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

  1. Enlever "require_once …" ou "wfLoadExtension( … )" de LocalSettings.php
  2. Enlever toute ligne mentionnant l'extension dans composer.local.json.
  3. Enlever le dossier de l'extension du répertoire install-dir/extensions

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

Liste des habillages dans git

À partir de MediaWiki 1.24, les téléchargements par Git n'incluent pas les habillages (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 toutes les URLs et les chemins.

Les instructions d'installation détaillées sont disponibles pour chaque page d'habillage ici sur MediaWiki.org, par exemple Skin:Vector#Installation. Les instructions sont analogues pour les autres habillages.

Voir aussi