Since the author has left the department, these pages have not been maintained. They have yet to be fully reviewed and updated.
Contents |
Subversion for beginners
In these pages you will find information about the file management system, Subversion.
Subversion – the theory
The following pages describe the theory behind how Subversion works, and how it works for you as the user:
- Subversion and why you need to use it?
- A working copy and how it works
- What files belong in the repository
Accessing the repository
Before you can start using Subversion, you need to be able to access its repository:
Subversion – using it
The following pages are the general usage instructions for using Subversion.
They should be easy to follow and work as a tutorial for learning Subversion.
If you would like personal tutoring on using Subversion or have any major problems or questions, please contact pagemaster.
Ucampas – Linux only
As a Linux user, you can use the facility ucampas to format your page with the house-style and view the final result before committing your page to the repository.
(Windows users do not, as yet, have this facility).
Once you have edited the *-b.html page, run ucampas <filename>.html.
If you are happy with the results, you can run svn commit on the page to send it to the repository.
Ucampas -r
When you give ucampas a directory on the command line, it will normally only process the index.html file for that directory. With option -r (recursive mode), ucampas will also process all the files listed in the uconfig.txt of a directory, and repeat the same for any directory it finds there.
For example, the following will create *.html files from the *-b.html files in the directories misc/localarea and local arrivals:
ucampas -r misc/localarea local/arrivals
SVN Ignore
Ucampas generated *.html files are placed alongside the *-b.html source files in your working directory. Since they are generated automatically, we do not keep them in the Subversion repository. As a result, when you type svn status, they show up marked with a '?', because Subversion knows nothing about them.
Since there are usually many such files, they can be quite difficult to spot when you run svn status – a command often used to spot files that really should be in the repository (but have not yet been added with svn add, possibly because they were forgotten).
Fortunately, there is a way to tell Subversion to ignore certain files when producing the svn status list. svn status, by default, already ignores certain files, for example anything ending in '~' (Emacs backup files), and this list of files can be configured (svn:ignore property).
To add all *.html files (that correspond to the *-b.html files) to the list of files that svn status will ignore, simply call this script:
ucampas-svnignore
This will cause svn status to ignore all *.html files from the current working directory downwards.
Frequently asked questions
Should you experience problems:
Uconfig.txt and .htaccess files
Once you have mastered Subversion you will want to know how to do the following:
- Create a uconfig.txt file
- Create a .htaccess file