Download from SVN

From WeBWorK
(Difference between revisions)
Jump to: navigation, search
(Redirected page to Subversion)
 
Line 1: Line 1:
{{UnderConstruction}}
+
#REDIRECT [[Subversion]]
 
+
'''[[wp:Subversion (software)|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 [[MediaZilla:|submit patches]].
+
 
+
See [[Subversion]] for more details; below are some quick directions for a couple common tasks.
+
 
+
== Using Subversion to download WeBWorK ==
+
 
+
=== 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 [[w:command-line interface|command-line interface]], which the instructions below use. Alternatively, you can get subversioning software with a [[w:graphical user interface|graphical user interface]] such as [http://tortoisesvn.tigris.org/ TortoiseSVN].
+
 
+
=== Download ===
+
You can download from any branch and module 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 <code>REL1_6_3</code>, the latest 1.6 is <code>REL1_6</code>, 1.5.8 is <code>REL1_5_8</code>, and the latest (untagged) would be <code>HEAD</code>.
+
 
+
To download from the latest {{MW stable branch number}} release (recommended), enter the following command from the command-line in the directory you wish to download to:
+
 
+
svn checkout <nowiki>http://</nowiki>svn.wikimedia.org/svnroot/mediawiki/branches/{{MW stable branch svn}}/phase3
+
 
+
Alternately, you can download the latest bleeding-edge development version using the following command:
+
svn checkout <nowiki>http://</nowiki>svn.wikimedia.org/svnroot/mediawiki/trunk/phase3
+
 
+
To get the latest ''skins'' directory including the Vector skin, use this line:
+
svn checkout <nowiki>http://</nowiki>svn.wikimedia.org/svnroot/mediawiki/trunk/phase3/skins
+
 
+
=== 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 SVN Checkout.
+
* 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 ===
+
[[Manual:Installation|Normal installation rules]] apply, but for best results, use PHP 5.1.2 as an Apache module (SAPI). 1.7alpha requires PHP5, and will usually crash PHP if FastCGI is being used.
+
 
+
=== 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:
+
 
+
<pre>svn update</pre>
+
 
+
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):
+
 
+
<pre>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</pre>
+
 
+
Don't forget to run maintenance/update.php every once in a while, especially if things start acting strangely.
+
 
+
[[Category:MediaWiki Introduction]]
+
[[Category:Installation|{{PAGENAME}}]]
+
[[Category:SVN]]
+

Latest revision as of 15:43, 19 June 2010

  1. REDIRECT Subversion
follow us