Download from Git/nl

Git is een gedistribueerd versiebeheer systeem. It allows you to download the very latest version of the source code, with all the branches and tagged releases at your disposal.

You should download from Git if you are a developer and want to submit patches.

If you do not want to develop but only install MediaWiki and extensions, then download stable tarball releases instead.

Zie Git voor meer details, zeker voor het maken van bijdrages. Hieronder zijn enkele snelle richtlijnen voor een aantal veelvoorkomende zaken.

Vereisten
Git moet geïnstalleerd zijn alvorens gebruik. Er zijn veel verschillende manieren om Git te verkrijgen, afhankelijk van uw besturingssysteem. Follow Gerrit/Tutorial#Set up Git, or use your favorite search engine.

Het is aanbevolen, maar niet noodzakelijk, om geïnstalleerd te hebben om bibliotheken van derden te downloaden en installeren.

Downloaden
Je kan de MediaWiki core downloaden via Git, evenals alle uitbreidingen die momenteel op de Wikimedia Foundation server cluster geïnstalleerd zijn en vele andere uitbreidingen die gehost worden op.

Als eerste moet de MediaWiki gekloond worden. Dit zal even duren.

Download voor ontwikkeling
De laatste ontwikkelaarsversie van MediaWiki wordt opgevolgd in de 'master' branch.

Zorg dat u een ontwikkelaarsaccount hebt aangemaakt, zodat uw een ssh gebruikernaam hebt.

Voer het volgende commando in op een console venster:

Dit kloont de volledige MediaWiki kern repository, gesynchroniseerd met de master branch, in een onderliggende map genaamd.

Om naar een andere locatie the installeren, wijzig dat in de commandolijn (voor meer info zie deze documentatie). Eens de repository gekloond is, kan je eenvoudig overschakelen naar andere branches of tags (zie hieronder), inclusief diegene die onstabiele versies van MediaWiki volgen. De ontwikkeling branch,, is de allernieuwste, ontwikkelaarsversie van MediaWiki; je dient master code niet te gebruiken in productie onder eender welke omstandigheden aangezien deze niet als stabiel wordt beschouwd.



Download a stable branch
Dit kloont de volledige MediaWiki core repository, initieel wijzend naar de release branch, naar een onderliggende map genaamd $dir.

Indien je het aantal herwerkingen die gekloond worden, wil verminderen, voeg dan  toe aan bovenstaande commando.

MediaWiki labels (stabiele versie)
Als alternatief, specifieke stabiele versies van MediaWiki worden opgevolgd via 'tags'. Deze zijn analoog aan de tarball uitgaves. Momenteel, zijn dit (stabiel),  (LTS) and  (oud).

Je kan alle beschikbare tags zien met:

Om een specifiek label te gebruiken, bijvoorbeeld de laatste stabiele uitgave:

Update the Git submodules
De release branches bevatten een hoop Git deelmodules, voor veelgebruikte uitbreidingen en thema's (de master branch heeft deze niet). Om de deelmodules bij te werken, voer uit:

Externe bibliotheken ophalen
MediaWiki gebruikt Composer om externe PHP bibliotheken te beheren, die allemaal terug te vinden zijn de  map in je MediaWiki map.

Om deze benodigde bibliotheken te installeren, heeft u de volgende keuze:


 * Download en installeer de composer PHAR, optioneel hernoem het composer.phar bestand zoals opgegeven voor je OS, en voer dan  uit vanuit je MediaWiki map. Dit is de aanbevolen aanpak.
 * Of, indien je Composer niet wenst te gebruiken of exact dezelfde verzameling leveranciersbibliotheken wil gebruiken zoals op de WMF productie cluster, kan je in plaats $git om een  map aan te maken binnen de core map van je MediaWiki installatie.
 * With your developer account, use this command:
 * For anonymous checkout, use this command:
 * Merk op dat indien er ook maar één van je uitbreidingen zijn eigen Composer vereisten heeft je deze optie niet kan gebruiken.

Voor MediaWiki 1.25, werden externe bibliotheken in de core repository verzameld, en was een package beheerder niet vereist.

Bijgewerkt houden
Indien je een specifieke branch of de ontwikkelaarsversie ("master" branch) gebruikt van MediaWiki, dan is de laatste wijzigingen oppikken vrij eenvoudig. Navigeer naar je MediaWiki kloon map en voer dit commando uit:

Alle laatste wijzigingen voor de branch die je gebruikt, zullen toegepast worden.

De nieuwe versie van core kan nieuwere versies van extensies en thema's vereisen, je dient elke extensie en thema map te overlopen en deze bij te werken met een commando zoals.

Je dient ook  bij te werken met elke nieuwere versie van de vereiste bibliotheken. Dit betekent vaak het volgende Composer commando uitvoeren, maar zie #Externe bibliotheken ophalen hierboven voor meer details: This often means running the following Composer command, but see #Fetch external libraries above for more details:

Na het bijwerken/opwaarderen van de code en de vereiste bibliotheken kan je best het MediaWiki  commandolijn script uitvoeren om database tabellen bij te werken waar nodig:

Indien je MediaWiki-Vagrant gebruikt, deze biedt één enkel commando,, die al deze stappen uitvoert.

Naar andere versie veranderen
Elke van jouw versies worden opgevolgd als branches of tags. Om te veranderen naar één van deze, dien je enkel de specifieke branch of tag die je wenst uit te checken uit je MediaWiki kloon map:

of

De wijzigingen zullen automatisch toegepast worden en je bent helemaal klaar.

Git gebruiken om MediaWiki extensies te downloaden

 * Lijst van extensies in git

Download een extensie

 *  dient vervangen te worden met de naam van de extensie die je wenst te downloaden, zonder spaties. Voor, zou dit zijn TitleKey. (Hoofdlettergevoelig!)

Download en dupliceer een extensie van Git:

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

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

U kunt de extensie broncode bekijken in de Gerrit's gitiles applicatie en via de URL:

 https://gerrit.wikimedia.org/g/mediawiki/extensions//+/refs/heads/master

Download alle extensies
Indien je verkiest om alleMediaWiki extensies die op gerrit.wikimedia.org staan uit te checken naar je machine, voer het volgende in:

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:

Vul het volgende in om vervolgens alle extensies van die branch te updaten:

Om de veranderen naar een andere branch, zoals na een nieuwe release:

Onthoud dat je enkel versies van extensies hoort te gebruiken van dezelfde release als de versie van MediaWiki en elkaar.

Om de master branch op te volgen:

Merk op dat je master code niet dient te gebruiken in productie onder geen enkele voorwaarde omdat deze niet als stabiel beschouwd wordt.

Indien je een alleen-lezen checkout (bijvoorbeeld om een grep of analyse te doen van alle MediaWiki code), kan je gedeelde MediaWiki checkout op Labs gebruiken, zonder iets te downloaden op je machines.

Een extensie verwijderen

 * 1) Verwijder de "$code" of "$code2" van $LocalSettings
 * 1) Verwijder elke lijn die verwijst naar de extensie in   (meestal in de "extra → merge-plugin → include" sectie)
 * 2) Verwijder de map van de extensie in

Gebruik Git om MediaWiki skins te downloaden

 * Liijst van skins in git

MediaWiki 1.24 en later bevatten geen skins in de Git download.

Volg exact dezelfde procedure zoals voor extensies (beschreven in de vorige sectie), maar gebruik  in plaats van   in alle URL's en paden.

Gedetailleerde instructies voor installatie zijn beschikbaar voor elk themapagina hier op MediaWiki.org, zie bijvoorbeeld Skin:Vector#Installation. Instructies voor alle andere thema's zijn analoog.

Zie ook

 * Intranet/Intranet Installatie, deel van een volledige uitgewerkte reeks artikels die Git gebruikt voor Mediawiki ontwikkeling

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