How to install, configure and use SVN (Subversion)

How to install, configure and use SVN (Subversion) 09Jun, 2010

  1. To access your online repository (http://dev.w3syntactic.com/poemsandgifts/) from your Windows based operating system, you should install one of the SVN client applications. Here, we will be discussing about TortoiseSVN.
  2. To install TortoiseSVN client application on your system, you can find it at http://tortoisesvn.tigris.org or rather at http://tortoisesvn.net/downloads.
  3. There you will find two types of installers – one for 32-bit operating systems and another one for 64-bit operating systems. To check how many bit operating system you have – click here.

    tortoiseSVN download
    TortoiseSVN Download
  4. Once you have downloaded the right version of TortoiseSVN. Get it installed with the default selections with the installer on your system. If successfully installed, it will ask you to restart your system. Thus, get your system restarted and in the meanwhile, let me take a small break 😉
  5. So, once your system is back and running, move to the next step…
  6. The Tortoise SVN adds its functionality in the Windows Explorer Context Menu

    tortoisesvn windows explorer context menu
    TortoiseSVN – Windows Explorer Context Menu
  7. Verifying the connection to the SVN Server – Right click on any folder in the Windows Explorer and select TortoiseSVN -> “Repo-browser”. You will be asked for a path to the repository, enter the path to the SVN repository. Below is an example to demonstrate the same:

    TortoiseSVN Repo Browser
    TortoiseSVN – Repo Browser
  8. If you already have the folder of your project with any of the files in it on your local system then you can straightaway move to next step otherwise, lets create a folder preferably at C:wampwwwyourprojectfoldername and create a file named as index.html or phpinfo.php
  9. Importing files to online SVN repository for the first time – In case, you are uploading the files to this new project to the SVN for the first time, right click on the folder from which you have to move the files to the online SVN repository and a context menu will come up, select “TortiseSVN > Import” and the following screen will come up:

    TortiseSVN Import
    TortoiseSVN – Import
  10. Once you have imported the files to SVN repository and now, if you check the same online it should look somewhat like this:

    Browser - SVN Revisions
    Browser – SVN Revisions
  11. Getting the files from the repository – To get the files from the online repository, right click on the project directory on your local system and select “SVN Checkout…” from the context menu. You will see the following screen:
    tortiseSVN Checkout
    TortoiseSVN – Checkout

    If you followed all the steps the address of the repository should be already written here. All you have to do is click “OK”

    TortiseSVN - Checkout 2
    TortoiseSVN – Checkout 2

    This means we have checked out the files successfully and we can start working!
    The directory should look like this:

    Windows Explorer - Directory Structure Using SVN
    Windows Explorer – Directory Structure Using SVN

    The Green tick marks mean that nothing has changed inside the directory on our local system. Let’s add a new file to the base folder / directory and name it “readme.txt”. We will then “Right Click” on the base folder and select “Commit”.

  12. The new file that has been just added by us will look like this:

    TortiseSVN - Adding New File
    TortoiseSVN – Adding New File
  13. SVN Commit – Come to base folder, right click and select “SVN Commit…” from the context menu. The SVN Server has detected that you have added a new file and you will have to check the Checkbox next to it in order for it to be inserted to the repository.

    TortoiseSVN - Commit
    TortoiseSVN – Commit
  14. Committing and Commenting – One must practice good commenting before committing anything on the live repository.
    TortoiseSVN - Commenting
    TortoiseSVN – Commenting

    Once committed successfully, it will look like the following image:

    TortoiseSVN - Commit Dialog Box
    TortoiseSVN – Commit Dialog Box

    Let’s edit “readme.txt” file and add some text in it. Once edited, both – the file and the directory will get a red exclamation mark saying they have been changed:

    TortoiseSVN - Edit
    TortoiseSVN – Edit

    To send the changes to the server / repository, you can right click any of them and again, select “SVN Commit…” from the context menu. Doing it on the Folder will make the Commit recursive to all the files inside it.

Posted by: Sumeet Soni / In: SVN, TortoiseSVN and Tagged , ,
Cam

One thought on “How to install, configure and use SVN (Subversion)”

Comments are closed.