Getting started

A brief introduction to get you started. In case you have experience in using node.js and TypeScript, you may skip to the end. Otherwise, read on.

Installation of the web server node.js

We use node.js as our server, even though for most functionality, a server that serves static pages is enough. Download node.js and install it as admin. Node also comes with a default package manager, npm, which you can use to install (globally) our build tool, gulp, and the client side package manager, bower.

npm install –g gulp
npm install –g bower

Installing TypeScript and an IDE

Install TypeScript from here.

I'm currently using Atom as my preferred IDE, since it is free and has good TypeScript support. Read more here.

Om met TypeScript aan de slag te kunnen, zie de Atom oplossing hier: . Op deze pagina staat ook een link naar een TypeScript presentatie die je een korte inleiding hierover geeft. Voor meer info, zie de ebooks in onze ebook folder onderaan de email.

Verder heb je een GIT client nodig voor versiebeheer (zie eventueel de ebooks beneden): ikzelf gebruik de gratis apps SourceTree en GitHub. De laatste is misschien goed om mee te beginnen, aangezien csWeb in GitHub staat (overige CommonSense projecten overigens niet).

Installatie csWeb Allereerst moet je een Github account aanmaken.

Nadat je dit geïnstalleerd hebt, dan kun je de csWeb en csMap projecten op GitHub forken (Fork button rechtsboven), zdd je even veilig in je eigen versie kunt werken. De folder structuur dient er als volgt uit te zien (waarbij c:\dev\web\cs mijn home folder is):

HOME\apps HOME\apps\csMap  HOME\csWeb 

Na installatie moet je de door ons gebruikte packages nog installeren:

1. Ga naar HOME\apps\csMap\Website en run (deze gebruikt de package.json om alles op te halen): npm install
2. Ga naar HOME\apps\csMap\Website\public en run (deze gebruikt de bower.json om alles op te halen): bower install

Starten met werken Nu ben je eindelijk zo ver om aan de slag te kunnen:

1. Ga naar HOME\csWeb\csComp en run: atom
2. In deze Atom editor, run CTRL-SHIFT-B om het project te compileren.
3. Ga naar HOME\apps\csMap\Website en run: atom
4. In deze tweede Atom editor, druk CTRL-ALT-O om de gulp helper te laden, en run de ‘default’ task. Je ziet dan een aantal regels tekst verschijnen. Deze kopieert wijzigingen in csComp (zoals csComp.js) naar csMap. Eventueel kun je gulp ook via een command line draaien.
5. Ga naar HOME\apps\csMap\Website\public en run: node server.js Daarmee start je de node server
6. Open je browser (CHROME) en ga naar http://localhost:3000 (de default poort van node – je kunt een andere opgeven via de command line).