Frequently Asked Questions About WorldForge Media

  1. Where is the WorldForge Media Repository?
  2. What is Subversion (or SVN)?
  3. How do I get a working copy of the Media Repository?
  4. How do I checkout the media repository using the command line svn tool?
  5. I'm getting an error during checkout - what is wrong?

Where is the WorldForge Media Repository?
The Media Repository is a Subversion repository located at https://svn.worldforge.org:886/svn/media/trunk/. Read-only access is allowed for anonymous users but if you wish to commit files then you need to contact one of the Media Team admins.

For browsing the repository we recommend that you use the Wombat web frontend.

The Infra team wants to thank balinor for doing some serious hard work on converting the existing CVS repository to SVN, nowhere for doing the initial investigations into SVN and zzorn (with help from munin and the entire media team) for making the new media repository structure simple but well thought out.
What is Subversion (or SVN)?
The following description is taken from the introduction to the book Version Control with Subversion
Subversion is a free/open-source version control system. That is, Subversion manages files and directories over time. A tree of files is placed into a central repository. The repository is much like an ordinary file server, except that it remembers every change ever made to your files and directories. This allows you to recover older versions of your data, or examine the history of how your data changed. In this regard, many people think of a version control system as a sort of "time machine".

The FAQ for Subversion is here.
How do I get a copy of the Media Repository?
First you need to read the Media Repository Usage Guidelines. Failure to do what is suggested will cause you to lose any commit privileges, but even worse, you will be visited by balinor and bear late one night and they will not be there to tuck you in ;)

Second you need to obtain a SVN client: google knows how and where,

Thirdly you need to re-read the Media Repository Usage Guidelines and follow the instructions. 

The whole media repository is about 12 GB on disk currently (2009-11-08). As Subversion keeps local copies of all files to do fast binary diffs, this means you have to get about 6 GB from the server if you want to check out everything.
How do I checkout the media repository using the command line svn tool?
svn co https://svn.worldforge.org:886/svn/media/trunk media; 

This will get the current trunk media repository, and put it into the dir called 'media' in your local directory. You can use this checkout anonymously for reading the repository, for details on committing to the repository see the svn manual.
I'm getting an error during checkout - what is wrong?
First read this FAQ to make sure you are telling svn to access our repository properly.
But if that doesn't help, check if the error is listed below. If not, ask on the #media channel to see if someone else has run into a the same problem.
  • svn: Unrecognized URL scheme 'https://svn.worldforge.org:886/svn/media/trunk
    Your svn tool needs to understand and support SSL connections - that means it must have been compiled to use the neon package.
    On Mandrake - make sure the package libsvn_ra_dav is installed