Télécharger à partir de Git

Git est un logiciel distribué de gestion des versions. Il vous permet de télécharger la dernière version du code source, avec toutes ses branches et les versions labellisées à votre dispposition.

Vous devez télécharger à partir de Git si vous êtes développeur et que vous désirez soumettre des corrections.

Si vous n'avez pas l'intention de développer, mais simplement installer MediaWiki avec les extensions, alors téléchargez les versions stables des archives à la place.

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. Consultez Gerrit/Tutorial#Set up Git ou utilisez votre moteur de recherche favori.

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.

Téléchargement pour le développement

La dernière version de développement de MediaWiki est gérée dans la branche « master ».

D'abord assurez vous d'avoir créé un compte développeur afin d'avoir un nom d'utilisateur SSH.

Ensuite, dans une fenêtre de terminal, entrez la commande suivante pour réaliser le clonage du dépôt :

git clone https://gerrit.wikimedia.org/r/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.

Pour réaliser l'installation 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 passer aux différentes branches ou étiquettes. 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.

• Voir le code source le plus récent

Télécharger une branche stable

Si vous ne voulez pas développer de corrections logicielles mais que vous voulez simplement cloner de manière anonyme la branche 1.42 de version stable, utilisez plutôt la commande suivante :

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

Si votre liaison Internet est lente et que vous voulez réduire le nombre de versions à cloner, ajoutez --depth=1 à la commande git clone.

Etiquettes 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. Actuellement, ces marqueurs sont : 1.42.4 (stable), 1.39.11 (LTS) et 1.39.11 (ancien LTS).

Vous pouvez voir tous les marqueurs disponibles avec :

git tag -l | sort -V

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

git checkout 1.42.4

Mettre à jour les sous-modules Git

Les branches de versions et les balises possèdent de nombreux sous-modules Git correspondant aux extensions et aux habillages couramment utilisés et pour le répertoire vendor/. La branche master n'en possède pas. Pour mettre à jour les sous-modules, exécutez :

cd mediawiki
git submodule update --init --recursive

Extraction des bibliothèques externes

Mediawiki utilise Composer pour gérer les bibliothèques PHP externes, qui viennent toutes 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 la version par défaut de PHP CLI ne correspond pas à la version PHP du serveur web, indiquez-le avec par exemple php7.4 composer.phar update --no-dev.
• Ou, si vous ne souhaitez pas utiliser Composer, ou si vous voulez utiliser exactement le même ensemble de bibliothèques de la distribution que celles déployées sur les serveurs de production de la Fondation Wikimedia, vous pouvez à la place créer un répertoire vendor/ dans le répertoire du noyau de votre installation MediaWiki :
  git clone https://gerrit.wikimedia.org/r/mediawiki/vendor.git
  • 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 paquets.

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 assez simple. Placez-vous dans le répertoire contenant votre clone de 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 des bibliothèques nécessaires. Cela signifie souvent exécuter la commande Composer suivante, mais voir ici 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/run.php update

Si vous utilisez MediaWiki-Vagrant , ce dernier ne propose qu'une seule commande, vagrant git-update, qui effectue toutes ces étapes.

Basculement vers une version différente

Chacune de nos versions est gérée en tant que branche ou étiquette. Pour basculer vers une version différente (par exemple de la branche master vers une branche différente ou une étiquette), sélectionnez la branche particulière ou l'étiquette qui vous intéresse, depuis le répertoire de votre clone MediaWiki :

git checkout <Nom de la branche>

ou bien

git checkout <nom d'étiquette>

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

Dans les commandes suivantes, remplacez ‎<EXT> par le nom de l'extension que vous voulez télécharger, sans espaces. Pour l'Extension:TitleKey , on écrirait donc TitleKey. (sensible à la casse !)

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

Avec votre compte développeur, utilisez ces commandes pour obtenir la branche master :

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

Si vous voulez à la place, cloner et extraire une branche de version stable, utilisez ces commandes :

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

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

https://gerrit.wikimedia.org/g/mediawiki/extensions/<EXT>/+/HEAD

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

Ou, pour extraire à la place les branches des versions stables, utiliser cette commande :

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

Après avoir exécuté la commande git clone continuez avec ces commandes :

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

A tout moment, pour mettre à jour toutes les extensions à leurs dernières versions de cette branche, entrez :

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_41 origin/REL1_41 || :'

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 (normalement dans la section « extra → ajouter plugin → ajouter »)
3. Enlever le dossier de l'extension dans 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.

Annexes

La version du 21 mars 2019 à 14:26 modifie la manière de pointer vers gerrit.wikimedia.org :

de :

gerrit.wikimedia.org/r/p/mediawiki

vers :

gerrit.wikimedia.org/r/mediawiki