Download from Git/fr

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

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.

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 avec votre ssh afin que vous puissiez soumettre vos corrections pour relecture :

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

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



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 de version stable, utilisez plutôt la commande suivante :

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

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 : (stable),  (LTS) et  (ancien LTS).

Vous pouvez voir tous les marqueurs disponibles avec :

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

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. La branche  n'en possède pas. Pour mettre à jour les sous-modules, exécutez :

Extraction des bibliothèques externes
Mediawiki utilise pour gérer les bibliothèques PHP externes, qui viennent toutes se placer dans le dossier   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  . Il s'agit là de la manière recommandée.
 * 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  dans le répertoire du noyau de votre installation MediaWiki :
 * With your developer account, use this command:
 * For anonymous checkout, use this command:
 * 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 :

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.

Vous devez aussi mettre à jour  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 :

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  de MediaWiki pour mettre à jour convenablement les tables de la base de données :

Si vous utilisez MediaWiki-Vagrant, ce dernier ne propose qu'une seule commande, $command, 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  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 :

ou bien

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 par le nom de l'extension que vous voulez télécharger, sans espaces. Pour l', on écrirait donc TitleKey. (sensible à la casse !)

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

With your developer account, use these commands to get the master branch:

For anonymous checkout of the stable branch instead, use these commands:

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//+/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:

With your developer account, to get the master branch:

For anonymous checkout of the stable branch instead, use this command:

After running the  command, continue with these commands:

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

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

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 :

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

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  à la place de   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

 * Intranet/Intranet Installation, partie d'une série d'articles entièrement travaillés qui utilise le déploiement de Git pour Mediawiki

Appendix
The Revision as of 14:26, 21 March 2019 changed the standard of linking to gerrit.wikimedia.org: from:
 * gerrit.wikimedia.org/r/ p /mediawiki

to:
 * gerrit.wikimedia.org/r/mediawiki