Subversion instellen op Windows

Subversion?

In deze handleiding staat hoe je Subversion in kan stellen op Windows. Lees meer over hoe Subversion werkt op Werken met Subversion bij CodeYard.

TortoiseSVN

Voor Windows kan je TortoiseSVN
installeren. Dat is een interface om met Subversion te werken. Download en installeer TortoiseSVN.

Verbinden

Op de server staat het project waaraan je kunt werken. Dat kun je bereiken
door de volgende URL in te geven in je Subversion client: https://www.codeyard.net/svn/projectnaam , waarbij projectnaam de naam van jouw project is.

Als voorbeeld staat het project yoyo op de server. Dat kun je gebruiken als oefenproject om te kijken of je met subversion goed overweg kunt. Daarvoor kun je inloggen met de volgende URL:
https://cvs.codeyard.net/svn/yoyo

Klaar!

Je kunt nu aan de slag met je project op je eigen PC. Je kunt bestanden aanpassen of toevoegen. Als je (voorlopig) klaar bent geef je een update en daarna
een commit. Daarmee plaats je de door jou gewijzigde bestanden terug op de
server en kun je een beschrijving geven wat je hebt gedaan.
Die beschrijving wordt opgeslagen in een logfile waardoor iedereen kan zien wanneer er door wie wat gewijzigd is. Er wordt automatisch een revisienummer toegekend, dat iedere keer bij een commit wordt opgehoogd.
Het kan overigens geen kwaad om regelmatig een update te doen van het project, zodat je steeds de nieuwste code, plaatjes, geluidjes, enz. op je computer hebt staan.

De Check-out

• Maak een map voor CodeYard, bijvoorbeeld in Mijn Documenten.
• Open die map; rechterklik op de achtergrond voor het menu.
  Nu zie je "SVN Checkout" en "TortoiseSVN" daar in staan.
  Dat zijn de twee menuutjes die je het meest zult gebruiken.
• Kies "SVN Checkout" en vul een URL voor een CodeYard project in. Gebruik maar de link
  https://cvs.codeyard.net/svn/yoyo/.
  
• Klik op OK.
  Het project wordt gedownload naar de huidige (CodeYard) map.
  Als je nu naar de map
  CodeYard gaat kijken in My Documents
  zie je een map CodeYard met een groen
  rondje en een V-teken. Dan is alles in orde.
• In de map CodeYard zitten nu alle mappen en bestanden die horen bij het yoyo project.
  Verder kun je aan het V-teken in het groene
  rondje zien dat alle bestanden erin (nog) niet gewijzigd zijn.

Zo gaat dat! Het yoyo project is een project waar iedereen mee mag oefenen
om ervaring op te doen met het werken van Subversion (SVN) en daar doe je nu aan mee. Als je aan een ander
project mee gaat doen, moet je weer een nieuwe map maken met een passende naam en een
nieuwe checkout doorvoeren in die nieuwe map. Zo kan het dus zijn dat je meerdere checkouts kunt doen als
je zou werken aan meerdere projecten.

• De structuur van de CodeYard map ziet er als volgt uit:
  
  
• Je ziet heel duidelijk dat alle mappen en bestanden nog ongewijzigd zijn. Nu staat er in de submap
  www een bestand index.html. Als je
  dat bestand gaat wijzigen en die wijzigingen opslaat verandert meteen de aanduiding van het bestand
  index.html en de mappen waarin de bestanden of submappen staan. Dat ziet er dan als volgt uit:

Een gewijzigd bestand,
In de gewijzigde map www/,
In de gewijzigde CodeYard map.

De index.html file uit de submap www is gewijzigd en je ziet meteen dat het groene rondje
met het V-teken erin veranderd is in een rood rondje met een uitroepteken erin. De index.html file zit in de

www-map, vandaar dat ook daar het groene rondje vervangen is door het rode en dat geldt uiteraard ook
voor de map CodeYard, omdat daar weer de submap www in zit. Zo kun je meteen zien waar er veranderingen zijn aangebracht.

De files die niet gewijzigd zijn, behouden gewoon hun groene rondje.

Toevoegen van nieuwe mappen en bestanden

Naast het bewerken van bestaande bestanden komt het natuurlijk ook voor dat je nieuwe mappen met bestanden aan
het project wilt toevoegen. Dat gaat als volgt:

• Maak een nieuwe submap aan in de projectmap, bijv. de map test
• Maak in een editor bijv. het bestand testbestand.html aan en sla dat op in de map test
• Ga vervolgens met de verkenner naar de map test en klik op de rechtermuisknop en kies voor de optie
  Add in het menu TortoiseSVN.
  
• Je krijgt vervolgens een scherm te zien met de file(s) die kunnen worden toegevoegd aan het project.
  
  
• Kies de file(s) die je aan het project wilt toevoegen en klik vervolgend op OK. Je krijgt daarna de mededeling dat de
  file(s) is/zijn toegevoegd.
  
• Als je vervolgens met de verkenner naar de map test gaat, merk je dat er een wijziging is opgetreden. De map heeft een ander uiterlijk gekregen,
  evenals de file(s) die erin zit(ten).

  met in die map ...

Het uploaden van bestanden

Uploaden is het omgekeerde van downloaden: in plaats van een bestand vanaf internet op je eigen computer te zetten, zet je het nu van je eigen computer op internet, namelijk op https://cvs.codeyard.net/svn/jouwproject/jouwfile.xyz Het is natuurlijk van belang dat je regelmatig je wijzigingen uploadt naar de server.
Zeker als je met meerdere personen aan één project werkt. Het kan namelijk voorkomen dat
meerdere groepsleden aan één of meerdere dezelfde files aan het werken zijn. Dat kan leiden tot
ernstige conflicten. Het is verstandig om goede afspraken te maken binnen de groep wie wat voor
zijn rekening neemt. Bovendien is het aan te bevelen om iedere keer als je gaat werken aan een
project een nieuwe update te doen om er zeker van te zijn dat je de meest recente versie gaat
bewerken. Het is ook verstandig dat je jouw wijzigingen meteen aan de server doorgeeft. Daardoor kunnen anderen meteen jouw nieuwe dingen gebruiken, en is er een kleinere kans dat er een conflict ontstaat doordat iemand met een bestand aan de slag gaat waar jij ook al mee bezig bent.

Hoe uploaden (committen) precies in zijn werk gaat wordt nu beschreven.

• Je zet de muis op de map CodeYard en klikt op de rechtermuisknop. Je krijgt dan het menu hieronder te zien:
  
  
• Je kiest voor de optie SVN Update. Het volgende scherm verschijnt dan in beeld:
  
  

  De intussen door anderen gewijzigde files of mappen met files worden gedownload. Je kunt de logfile nog bekijken
  wat er allemaal precies is uitgevoerd. In dit geval zie je dat revisie 6
  is doorgevoerd. Iedere keer als er weer een wijziging wordt aangebracht
  wordt dit getal met 1 opgehoogd.

• Nu ben je er klaar voor om daadwerkelijk je eigen files naar de CodeYard-server te sturen. Je kiest dan voor de optie SVN Commit in het menu (zie boven). Je krijgt dan het scherm hieronder te zien. In het tekstvak (Hieronder is al tekst ingevoegd!) geef je een beschrijving van wat je hebt gedaan. Je groepsleden kunnen zo zien wat er allemaal veranderd is zonder elk bestand apart te hoeven uitpluizen op veranderingen.
  
  
• Druk vervolgens op OK. Er wordt gevraagd naar username en password.
  

  

• Vul de gebruikersnaam en het wachtwoord in en druk vervolgens op OK.
• Mocht je je gebruikersnaam en/of wachtwoord niet meer weten dan krijg je na 3 pogingen
  het volgende scherm te zien:
  
• Als alles goed verlopen is, is de update geslaagd.

Het gebruik van Help

• 
  Er staan je nog heel wat functies ter beschikking als je met tortoiseSVN werkt.
  Daarvoor kun je gebruik maken van een menu dat je met de
  rechtermuisknop kunt oproepen als je op de desktop staat:

  Wil je precies weten waarvoor die functies allemaal dienen, kun je het beste
  gebruik maken van de ingebouwde Help van dat menu.
  Daarin staat uitgebreid beschreven hoe SVN werkt. Vooral hoofstuk 5 is daarbij van belang.