Wil je beginnen aan je eerste project? Lees verder hoe dat moet -- aanmelden, software, project uitzoeken en werken met de software.

Om mee te mogen doen met CodeYard moet je in principe een middelbare scholier zijn, hoewel we ook gasten toelaten (mail dan even). Ben je scholier? Dan mag je je meteen inschrijven!

Het CodeYard-stappenplan

CodeYard in drie eenvoudige stappen.

1. Aanmelden
   1. Besluit hoe je wil meedoen: als nieuwe groep, of door aan te haken bij een al bestaand project. Je kunt ook aangeven wat je ongeveer wil doen, dan proberen wij een project voor je te vinden.
   2. CodeYard is in principe alleen voor middelbare scholieren. Dus: zie een leraar zover te krijgen dat hij als jouw contactpersoon wil optreden.
   3. Schrijf je in via de aanmeldpagina.
       
2. Wachten op bericht van deelname (hier hoef je dus niets voor te doen)
   1. Als je leraar nog niet met CodeYard meedoet nemen we contact met hem op om te kijken of alles in orde is; als hij al wel meedoet dan kan hij jullie direct toelaten.
   2. (Als je met een nieuw project begint:) wij maken een stuk schijfruimte voor jullie project vrij. Dit stuk krijgt een svnnaam (naam waarmee Subversion het kan bereiken) die we aan jullie doorgeven.
   3. Wij maken een loginnaam en een wachtwoord voor je aan en sturen die naar je emailadres. Daarmee kan je inloggen op de website en je kunt deze gebruiken voor subversion. Op de website kan je je persoonlijke en je projectgegevens inzien en zonodig veranderen; met subversion krijg je (schrijf-)toegang tot de schijfruimte van je project.
       
3. Software installeren
   1. Zorg dat op de computers waar je aan werkt de juiste software is geïnstalleerd. In elk geval moet je Subversion geïnstalleerd hebben om bij jullie projectruimte te kunnen. Daarnaast hangt het van jullie project af of, en welke, compiler(s) en andere software (zoals fotobewerkingsprogramma's enzo) je nodig hebt.
   2. Doe een checkout van jullie project en je kan aan de slag. In de subversion-handleiding lees je hoe dat moet.
       
4. Dat was alles!

---

Je bent nu klaar om aan de slag te gaan.

Om te beginnen is het handig om eens op de website in te loggen om te kijken of je gegevens correct zijn. Je kan dan ook meteen een beschrijving van jullie project invoeren als je/jullie dat nog niet gedaan hebt/hebben.

Bij elk project hoort een website; je browser vindt die op http://cvs.codeyard.net/svnnaam. (Bij je aanmelding vertellen we welke dat is, voor het yoyo project is dat http://cvs.codeyard.net/yoyo/) In het begin staat daar nog niets op. Om je project alvast een gezicht te geven, en om al wat te oefenen met subversion zou je daar alvast wat tekst neer kunnen zetten, en bijv. een fotootje van de projectleden.

Je kunt je op deze pagina aanmelden.

Wat heb ik nodig om te beginnen?

Om mee te doen met CodeYard heb je twee programma's nodig, zie hieronder. Dat is de enige beperking; het maakt niet uit welk besturingssysteem je gebruikt, alleen hebben we wat meer tips voor Windows en UNIX (Linux) omdat wij daar zelf het meeste ervaring mee hebben. Wat je nodig hebt voor CodeYard is:

1. Een webbrowser.
   

   Die heb je vast al wel, anders kon je deze pagina waarschijnlijk niet lezen. We proberen onze webpagina's er op alle browsers goed uit te laten zien, dus het maakt niet uit of je Firefox (gratis, vrij), Opera (gratis, niet vrij), Konqueror (gratis, vrij) of Internet Explorer (niet gratis, niet vrij) gebruikt. Minder bekend zijn bijv. K-meleon, Amaya, galeon of Camino (MacOS X).

2. Het programma Subversion.
   

   Subversion heb je nodig om jullie projectcode, afbeeldingen, enz. van en naar CodeYard te sturen. Subversion houdt ook bij wie wanneer wat heeft veranderd of toegevoegd. Subversion maakt het daarbij mogelijk dat meerdere mensen tegelijkertijd aan hetzelfde bestand sleutelen. Meer over Subversion lees je onder het kopje Wat is Subversion en hoe werkt dat? Er is ook een uitgebreidere handleiding op de CodeYard-site.

   • Windows: Voor Windows bevelen wij TortoiseSVN aan. Dat doet het best aardig, dan heb je een muisgestuurde interface om met Subversion te werken, en bovendien hebben wij een specifieke TortoiseSVN-handleiding geschreven. De homepage van Subversion zelf vind je hier. Daar kan je ook een 'kale' Subversion-client downloaden.
   • UNIX (Linux): Onder UNIX-achtigen kan je de command-line Subversion client installeren (die heet meestal SVN). Afhankelijk van je distributie moet je iets doen als "pkg_add -r subversion" of "emerge subversion" of "apt-get subversion". Dat moet je zelf uitzoeken omdat er zoveel verschillende mogelijkheden zijn. Je kan het ook handmatig installeren; de software vind je op de homepage van Subversion. Er is ook een uitgebreide handleiding voor Subversion op onze site.
   • Mac OS X: Via de homepage van Subversion kun je packages voor Mac OS X downloaden, die al dan niet Fink nodig hebben.
3. Nog meer?
   

   Afhankelijk van het project kan je meer software nodig hebben. Voor projecten waar geprogrammeerd wordt, zal je een tekst-editor nodig hebben. Voor projecten waar veel grafisch werk gedaan wordt, heb je een foto-editor of zoiets nodig. Links naar handige tools kan je op het forum kwijt (of vinden).

Projecten

CodeYard is georganizeerd rond projecten; als je bij CodeYard zit werk je aan een of meer projecten. Hieronder lees je hoe je naar projecten kunt zoeken, wat kunt snuffelen bij projecten en hoe je er aan kunt werken met Subversion.

Hoe kan ik een project zoeken of bekijken?

Alle CodeYard projecten staan op de CodeYard server cvs.codeyard.net. Je kan met je webbrowser daar heen surfen om te kijken welke projecten er zijn. Ieder project heeft zijn eigen website. Het overzicht laat zien welke er zijn:

De websites van de projecten worden gemaakt door de leerlingen die aan dat project werken. Zoek een leuk project en meld je daarvoor aan.

Hoe kan ik werken aan een project?

Als je je hebt aangemeld en bent toegelaten tot een project, dan krijg je van de CodeYard beheerders een Subversion login en wachtwoord. Je krijgt ook een URL voor je project. Die ziet er ongeveer zo uit:

Dit is de URL van de repository (niet de website) van het project, in dit geval, project "xr12".

Je kan die URL gewoon in een webbrowser intikken, dan krijg je zoiets te zien:

De webpagina van het project staat dan op http://cvs.codeyard.net/xr12/ (dus zonder svn/ ertussen).

Je kunt wat rond klikken met je browser, en de bestanden van de repository bekijken, maar je kunt ze niet bewerken. Daarvoor moet je Subversion zelf gebruiken. De Subversion handleiding legt uit hoe dat moet.

De webpagina van je project kan je zelf aanpassen (en dat is ook de bedoeling omdat bij het aanmaken van het project er nog niets op staat); dat doe je door in je project-repository, in de subdirectory www/, het bestand index.html aan te passen. Je kunt ook overschakelen op PHP als je wilt.

Wat is Subversion en hoe werkt dat?

Als je met een groep aan een project werkt moeten verschillende mensen, elk op hun eigen computer, tegelijkertijd aan een eigen stukje van de code kunnen werken, zonder per se op het werk van anderen te hoeven wachten. Subversion maakt dit mogelijk: CodeYard is het centrale depot van jullie code, en met subversion haal je de code naar jullie eigen computers. Die kan ieder voor zich dan gaan bewerken, en als je iets zinnigs voor mekaar hebt gecodeerd, kun je met subversion de code in het CodeYard-depot up-to-date maken ("inchecken"). Door je werk in te checken laat je jouw aanpassingen in het depot samenvoegen met de aanpassingen die iemand anders in de tussentijd misschien heeft ingecheckt. Je kunt dus met Subversion tegelijk aan hetzelfde bestand werken! Tegelijk biedt Subversion je ook backup kopieën, het is dus ook een vangnet voor fouten en nodigt uit om te experimenteren. De Subversion handleiding legt dat haarfijn uit.

Waar kan ik meer hulp krijgen?

• Je werkt niet voor niets in een groepje: als je iets niet weet, probeer het dan eerst eens bij je groepsgenoten.
• De SVN handleiding geeft uitkomst voor de meeste Subversion-gerelateerde vragen.
• De tools die CodeYard levert (PHP, LastFive, MySQL en meer) worden op de tools pagina uitgelegd.
• Als niemand uit jullie groepje een oplossing weet voor jouw probleem, kijk dan eens op het CodeYard-forum. Misschien staat daar je vraag al beantwoord, en zo niet dan kan je daar je vragen (en natuurlijk ook de oplossingen voor andere scholieren!) kwijt. Help elkaar, zo komt Open Source Software het snelst van de grond! Wij zullen zelf ook af en toe het forum bezoeken en vragen beantwoorden.
• Natuurlijk kan je ook op de rest van het internet zoeken of je daar een oplossing kan vinden.
• Voor CodeYard-specifieke problemen tenslotte houden we een "FAQ" (Frequently Asked Questions) lijst met veel voorkomende vragen voor jullie bij. Die vind je op de "FAQ" (Frequently Asked Questions) pagina.

Heb je hierover een vraag? Neem dan contact met ons op.