Download from SVN



Subversion (SVN) is a version control software that allows users to download the very latest version of a branch, without having to wait for someone to get around to packaging it. Advantages to using Subversion include the latest version, vastly simplified updating, the ability to roll back an upgrade, the ability to create and submit patches.

See Subversion for more details; below are some quick directions for a couple common tasks.

Prerequisites
You must have a Subversion client installed before you can use it. (Although you can theoretically download files without Subversion, this would mean tediously downloading each individual file manually.) The recommended software is the official Subversion client, available from the [http://subversion.apache.org/ Subversion project page]. Note that this client uses a command-line interface, which the instructions below use. Alternatively, you can get subversioning software with a graphical user interface such as [http://tortoisesvn.tigris.org/ TortoiseSVN].

Download


You can download from any branch and module (before MediaWiki 1.18.2) in [http://svn.wikimedia.org/viewvc/mediawiki/ MediaWiki SVN].


 * Modules: The two modules important to web applications are phase3 (the main application) and extensions (extension code).
 * Branches: Named release branches use the naming scheme REL$1_$2[_$3], where $1 is the MediaWiki version, $2 is a major version and $3 is a minor revision. For example, version 1.6.3 is branch, the latest 1.6 is  , 1.5.8 is  , and the latest (untagged) would be.

To download from the latest release (recommended), use git>Special:MyLanguage/Download from Git|Git, not Subversion. To get MediaWiki 1.18.1 (not recommended) enter the following command from the command-line in the directory you wish to download to:

svn checkout http:// svn.wikimedia.org/svnroot/mediawiki/branches//phase3

Alternately, you can download the last development version left behind in subversion using the following command:

svn checkout http:// svn.wikimedia.org/svnroot/mediawiki/trunk/phase3

To get the latest skins directory (as of MediaWiki 1.18.1) including the Vector skin, use this line:

svn checkout http:// svn.wikimedia.org/svnroot/mediawiki/trunk/phase3/skins

To check out an extension like Extension:TitleKey to your folder "$IP/extensions/TitleKey":

cd $IP/extensions svn checkout http://svn.wikimedia.org/svnroot/mediawiki/trunk/extensions/TitleKey TitleKey

Using TortoiseSVN
[http://tortoisesvn.net/downloads TortoiseSVN] is a convenient SVN client for Windows that integrates with Windows Explorer.
 * Go to Windows Explorer (hit WIN+E or right-click on the Start button and click Explore), and create a new folder in a location of your choice. You may want to name it something like "Mediawiki Repository."
 * Right click on that folder and TortoiseSVN -> Create repository here.
 * Right click on that folder again and click SVN Checkout; DO NOT CLICK "IMPORT".
 * For the "URL of repository," put http://svn.wikimedia.org/svnroot/mediawiki/trunk/phase3/
 * The checkout directory should automatically populate to the mediawiki subfolder of your repository folder.
 * Click OK.

Installing
install>Special:MyLanguage/Manual:Installation|Normal installation rules apply. However, for best results, use PHP 5.3.3 as an Apache module.

Upgrading and downgrading
Upgrading between releases with SVN is simple. If you have direct access to the command-line on the server, you can enter the commands below directly; alternatively, you can maintain a copy on a local machine and upload updated versions to the server.

To upgrade MediaWiki, simply use the command below in the root of the installation directory. Note that this will upgrade to the latest version of the current major version. If you are using MediaWiki 1.6, this will upgrade to any version 1.6.x, but not to 1.7:

svn update

To upgrade to another release branch (version 1.7 in the example below) or to switch between individually-selected version tags, you can use the "switch" command (substituting the appropriate versions):

svn checkout http://svn.wikimedia.org/svnroot/mediawiki/tags/REL1_6_2/phase3 svn switch http://svn.wikimedia.org/svnroot/mediawiki/tags/REL1_7_3/phase3

Don't forget to run maintenance/update.php every once in a while, especially if things start acting strangely.