Downloaden vanaf 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 97% complete.

Outdated translations are marked like this.
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 • ‎українська • ‎հայերեն • ‎ייִדיש • ‎עברית • ‎ئۇيغۇرچە • ‎العربية • ‎تۆرکجه • ‎سنڌي • ‎فارسی • ‎پښتو • ‎नेपाली • ‎हिन्दी • ‎தமிழ் • ‎తెలుగు • ‎ไทย • ‎ქართული • ‎中文 • ‎日本語 • ‎粵語 • ‎한국어
Sinds MediaWiki 1.19beta2, 1.18.2, 1.17.3 gebruiken MediaWiki core en extensies Git voor versiebeheer. Voor oudere versies, zie Subversion

Git is gedistribueerde versiebeheer software die gebruikers toelaat om de allerlaatste versie van een branch te downlaoden, zonder te moeten wachten op iemand om deze klaar te zetten. MediaWiki zal sneller uitgebracht worden, en het zal eenvoudiger zijn om jouw installatie bij te werken, een upgrade ongedaan te maken, of patches toe te passen. (Onthoud dat officiële stabiele releases minder risicovol zijn.)

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

Vereisten

Je dient Git geïnstalleerd te hebben vooraleer je het kan gebruiken. Er zijn veel verschillende manieren om Git te verkrijgen, afhankelijk van je besturingssysteem. Voor broncode en officiële binaries, zie git-scm.com. Voor alternatieve manieren om Git te installeren, gebruik je favoriete zoekmachine om instructies te vinden voor jouw besturingssysteem.

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

Git gebruiken om MediaWiki te downloaden

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

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

Voer het volgende commando in op een console venster:

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

Dit kloont de volledige MediaWiki core repository, initieel wijzend naar de release branch 1.31, naar een onderliggende map genaamd mediawiki.

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

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

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:

cd mediawiki
git submodule update --init

Download voor ontwikkeling

Dien je een developer account hebt (dewelke eenvoudig aan te vragen is), kan je beter in plaats van anoniem te klonen via https klonen via je ssh <USERNAME> zodat je wijzigingen kan aanbieden ter controle:

git clone ssh://<GEBRUIKERSNAAM>@gerrit.wikimedia.org:29418/mediawiki/core.git mediawiki

This clones the entire MediaWiki core repository, synced to the master branch, into a sub-directory named mediawiki.

Externe bibliotheken ophalen

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

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

  • 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 clone https://gerrit.wikimedia.org/r/p/mediawiki/vendor.git om een vendor/ map aan te maken binnen de core map van je MediaWiki installatie. 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.

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 1.31.1 (stabiel), 1.27.5 (LTS) and 1.30.1 (oud).

Je kan alle beschikbare tags zien met:

git tag -l | sort -V

Gebruikmakend van een niet-GNU soort commando, zoals op Mac OS X, moet je terugvallen op de goede oude scheidingstekens:

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

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

git checkout 1.31.1


Laatste ontwikkelversie van MediaWiki

De laatste ontwikkelaarsversie van MediaWiki wordt opgevolgd in de 'master' branch. Dit is wat lokaal standaard uitgecheckt wordt wanneer je een eerste kloon neemt van de MediaWiki repository. Indien je overgeschakeld bent naar een andere branch, maar graag terug wil naar de allernieuwste MediaWiki, voer uit:

git checkout master


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:

git pull

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 git pull --recurse-submodules.

Je dient ook vendor/ 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:

composer update --no-dev

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

php maintenance/update.php


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

Naar andere versie veranderen

Veranderen naar een andere versie van MediaWiki is veel eenvoudiger met Git dan met SVN. 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:

git checkout <branch naam>

of

git checkout <labelnaam>

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

<EXT> dient vervangen te worden met de naam van de extensie die je wenst te downloaden, zonder spaties. VoorExtension:TitleKey, zou dit zijn TitleKey. (Hoofdlettergevoelig!)

Download en dupliceer een extensie van Git:

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

Ontwikkelaars dupliceer met:

git clone ssh://<GEBRUIKERSNAAM>@gerrit.wikimedia.org:29418/mediawiki/extensions/<EXT> --branch REL1_31

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

https://gerrit.wikimedia.org/g/mediawiki/extensions/<EXT>/+/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:

git clone https://gerrit.wikimedia.org/r/mediawiki/extensions --branch REL1_31
cd extensions
git submodule update --init --recursive

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

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

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

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

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:

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

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 "require_once …" of "wfLoadExtension( … )" van LocalSettings.php
  2. Verwijder elke lijn die de extensie vermeldt in composer.local.json (meestal in de sectie "extra → merge-plugin → include" sectie)
  3. Verwijder de extensie map in install-dir/extensions/

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 skins in plaats van extensions 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