refactor syllabus naar vsc.

syllabus/Bijlage_Github_en_Pycharm.md

@@ -1,4 +1,7 @@
-# Bijlage: GitHub en PyCharm
+# ~~Bijlage: GitHub en PyCharm~~
+
+**DEZE MOET NOG UITGEWERKT WORDEN
+**
 
 In deze cursus is het verplicht Git te gebruiken. Hiermee houd je online de versies van je software bij. Ook kunnen wij als begeleiders makkelijk met je meekijken en je vorderingen zien. Uiteindelijk moet je een zip-file van je software vanuit GitHub maken en deze inleveren in je Q-highschool portfolio/inleverbakje. Deze handleiding bestaat uit twee delen. Je kunt kiezen om deel 1 te volgen of deel 2 te volgen. Het resultaat van de instructie is bij allebei hetzelfde. In de les gebruiken we deel 1 van de instructie.
 

syllabus/Bijlage_Installeren old.md

@@ -0,0 +1,14 @@
+# Bijlage: Python en PyCharm installeren
+
+In deze module ga je het professionele gereedschap PyCharm gebruiken. Dit programma is namelijk makkelijk in gebruik en overzichtelijk, en heeft daarbij ook nog eens een ingebouwde interpreter (hetgeen je code leest en vertaalt naar computertaal).
+
+Installeer eerst Python. Download de installer [hier](https://www.python.org/downloads/), en volg de instructies. Verander niets qua instelling, aangezien dit niet nodig is.
+
+Download als dat klaar is **PyCharm Community Edition** [hier](https://www.jetbrains.com/pycharm/download/#section=windows). Bij de installatie, selecteer *Add launchers dir to the PATH*, *Create Associations - .py* en *Add “Open Folder as Project”*. Als alles gereed is kan je beginnen met het instellen. Open PyCharm, accepteer de *Terms and Conditions* en kies je favoriete theme. Plugins zijn niet nodig, sla deze over.
+
+Als het goed is, heb je nu Python en PyCharm geïnstalleerd en kun je aan de slag voor deze module.
+
+Verdere informatie kan je hier vinden:
+<https://www.jetbrains.com/help/pycharm/quick-start-guide.html>
+
+Bij de module Basis van Programmeren met Python mocht je ook Replit of een andere editor gebruiken. Dat mag in deze module ook, alleen alle uitleg en instructie is gericht op het gebruik van PyCharm. Dus het meest verstandig is om PyCharm te gebruiken.

syllabus/Bijlage_Installeren.md

@@ -1,14 +1,141 @@
-# Bijlage: Python en PyCharm installeren
+# Bijlage: Python en Visual Studio Code installeren
 
-In deze module ga je het professionele gereedschap PyCharm gebruiken. Dit programma is namelijk makkelijk in gebruik en overzichtelijk, en heeft daarbij ook nog eens een ingebouwde interpreter (hetgeen je code leest en vertaalt naar computertaal).
+In deze bijlage lees je hoe je Python installeert en hoe je Visual Studio Code gebruikt als ontwikkelomgeving (IDE) voor je Python-projecten. Met Visual Studio Code kun je eenvoudig Python-code schrijven, testen en debuggen, en dankzij de vele extensies kun je je werkomgeving op maat uitbreiden.
 
-Installeer eerst Python. Download de installer [hier](https://www.python.org/downloads/), en volg de instructies. Verander niets qua instelling, aangezien dit niet nodig is.
+---
 
-Download als dat klaar is **PyCharm Community Edition** [hier](https://www.jetbrains.com/pycharm/download/#section=windows). Bij de installatie, selecteer *Add launchers dir to the PATH*, *Create Associations - .py* en *Add “Open Folder as Project”*. Als alles gereed is kan je beginnen met het instellen. Open PyCharm, accepteer de *Terms and Conditions* en kies je favoriete theme. Plugins zijn niet nodig, sla deze over.
+## Python installeren
 
-Als het goed is, heb je nu Python en PyCharm geïnstalleerd en kun je aan de slag voor deze module.
+Om met Python aan de slag te gaan, heb je eerst een recente versie van Python nodig. De meeste projecten in dit lesmateriaal gaan uit van Python 3.10 of hoger.
 
-Verdere informatie kan je hier vinden:
-<https://www.jetbrains.com/help/pycharm/quick-start-guide.html>
+### Windows
 
-Bij de module Basis van Programmeren met Python mocht je ook Replit of een andere editor gebruiken. Dat mag in deze module ook, alleen alle uitleg en instructie is gericht op het gebruik van PyCharm. Dus het meest verstandig is om PyCharm te gebruiken.
+1. **Download de installer**  
+   Ga naar de [officiële Python-website](https://www.python.org/downloads/) en download de nieuwste stabiele release van Python 3 voor Windows.
+
+2. **Voer de installer uit**  
+   Dubbelklik op het gedownloade bestand. Zorg dat je bij de eerste stap van de installer het vakje **Add Python to PATH** aanvinkt, zodat je Python straks vanaf de opdrachtprompt (cmd) of PowerShell kunt gebruiken.
+
+3. **Controleer de installatie**  
+   Open een opdrachtprompt (cmd) of PowerShell en typ:
+   ```bash
+   python --version
+   ```
+   Je zou nu een versienummer moeten zien, bijvoorbeeld Python 3.10.9.
+
+### macOS
+1.	**Controleer of Python 3 al aanwezig is**
+
+    Open de *Terminal*-app en typ:
+
+    ```bash
+    python3 --version
+    ```
+    Het kan zijn dat je macOS standaard een oudere Python-versie bevat (zoals 2.7). Daarom is het vaak handig om de officiële installatie van Python 3 te gebruiken.
+
+2.	**Download en installeer Python 3**
+
+    Ga naar de [officiële Python-website](https://www.python.org/downloads/mac-osx/) en download de macOS 64-bit installer voor de meest recente Python 3-versie. Voer de installer uit en volg de stappen.
+3.	**Controleer de installatie**
+
+    Open de Terminal opnieuw en typ:
+
+    ```bash
+    python3 --version
+    ```
+
+    Je zou nu een bericht moeten krijgen met de door jou geïnstalleerde versie, bijvoorbeeld `Python 3.10.9`. Of in ieder geval een versie die hoger ligt dan Python 3.5.
+
+### Linux (optioneel)
+Als je op Linux werkt, heb je vaak al een recente Python-versie in je distributie. Je kunt dit controleren met:
+```bash
+python3 --version
+```
+Is je versie verouderd? Volg dan de instructies van je specifieke Linux-distributie (bijv. `apt-get`, `dnf`, of `pacman`) om Python 3 te installeren of te upgraden.
+
+## Visual Studio Code installeren
+### Downloaden en installeren
+1. **Download Visual Studio Code**
+
+    Ga naar de [officiële Visual Studio Code-website](https://code.visualstudio.com/) en download de installer voor jouw besturingssysteem (Windows, macOS of Linux).
+2. **Volg de installatiestappen**
+
+    Volg de instructies van de installer. Op Windows krijg je bijvoorbeeld de optie om “*Add to PATH*” aan te vinken. Dit is handig, maar niet strikt noodzakelijk.
+
+### Visual Studio Code starten
+Nadat de installatie is voltooid, kun je Visual Studio Code openen via het icoontje op je bureaublad of in je applicatieoverzicht (Windows Startmenu, macOS Launchpad, of Linux-menu).
+
+## Visual Studio Code configureren voor Python
+Voor het schrijven en debuggen van Python-code in Visual Studio Code raden we aan om de **officiële Python-extensie** te installeren.
+1. **Open de extensies**.
+
+    Klik aan de linkerzijde in Visual Studio Code op het icoon van de **Extensions**-sidebar (de vier blokken).
+2. **Zoek naar 'Python'**
+
+    Voer in de zoekbalk `Python` in.
+3. **Installeer de Python-extensie**
+
+    Kies de extensie van **Microsoft** en klik op *Install*.
+
+4.	**Eventueel: linting en formatting**
+
+    Installeer ook de extensies voor **Pylint** of **Flake8** (linting) en bijvoorbeeld **Black** of **autopep8** (formattering) als je je code wilt laten controleren en automatisch netjes wilt laten opmaken.
+
+### Python-interpreter selecteren
+Visual Studio Code kan met meerdere Python-versies op je systeem omgaan. Om zeker te weten dat je de juiste versie gebruikt, kun je rechtsonder in de statusbalk (of via de Command Palette) de actieve Python-interpreter kiezen.
+
+1.	**Command Palette openen**
+
+    Druk op `Ctrl + Shift + P` (Windows/Linux) of `Cmd + Shift + P` (macOS).
+
+2.	**Kies de interpreter**
+
+    Typ in de Command Palette Python: `Select Interpreter` en kies de gewenste Python-versie.
+
+### PEP8 Style Checking met PyLint
+
+Om je code te laten voldoen aan de PEP8-standaarden (leesbare en consistente Python-code), kun je een linter als **PyLint** installeren:
+1.	**Installeer de PyLint-extensie**
+	-	Ga naar het **Extensions**-icoon in Visual Studio Code.
+	-	Zoek op *PyLint* en installeer de extensie (meestal ook van Microsoft).
+2.	**PyLint configureren**
+	-	Open een `.py`-bestand in je project.
+	-	Visual Studio Code detecteert nu automatisch dat je PyLint hebt. Je krijgt eventuele opmerkingen over je code direct in de editor te zien.
+3.	**Lint-fouten bekijken**
+	-	Als er PEP8-waarschuwingen of -fouten zijn, verschijnen deze in het **Problems**-paneel (meestal onderin het scherm).
+	-	Je kunt dubbelklikken op een waarschuwing om naar de betreffende regel in je code te springen.
+4.	**Automatisch formatteren (optioneel)**
+	-	Voeg extensies als **Black** of **autopep8** toe om je code automatisch op te schonen.
+	-	Na installatie kun je in de Command Palette (`Ctrl+Shift+P` of `Cmd+Shift+P`) zoeken op Format Document.
+
+Door PyLint te gebruiken, blijft je code consistent en overzichtelijk, wat vooral bij grotere projecten van onschatbare waarde is.
+
+## Testen of alles werkt
+
+Om te controleren of alles naar behoren is ingesteld:
+1.	Maak in Visual Studio Code een nieuw bestand aan, bijvoorbeeld `hallo.py`.
+2.	Voeg de volgende code toe:
+    ```python
+    print("Hallo, Python!")
+    ```
+3. Sla het bestand op (bij voorkeur in een nieuwe map, zoals `C:\mijnproject` op Windows of in je Thuismap).
+4.	Druk op F5 om te debuggen of gebruik de knop **Run and Debug** (links in Visual Studio Code).
+5.	Als alles goed gaat, zie je in het Debug Console-venster `Hallo, Python!` verschijnen.
+
+Is dit gelukt, dan ben je klaar om aan de slag te gaan met de rest van het lesmateriaal!
+
+## Veelvoorkomende problemen en oplossingen
+-	**Python niet gevonden**
+
+    Controleer of je Python correct aan je PATH hebt toegevoegd tijdens de installatie of doe dit handmatig in je systeeminstellingen.
+-	**Oude Python-versie**
+
+    Verwijder (of update) oude versies, en zorg dat je in VS Code de juiste interpreter selecteert.
+-	**Geen uitvoer**
+
+    Check of je het juiste bestand hebt opgeslagen en of je in de juiste directory werkt.
+-	**Linting werkt niet**
+
+    Controleer of je de juiste extensie hebt geïnstalleerd en dat in je statusbalk (rechtsonder) de juiste Python-interpreter staat geselecteerd.
+
+**Gefeliciteerd!** Je hebt nu zowel Python als Visual Studio Code geïnstalleerd, geconfigureerd én een PEP8-style checker zoals PyLint toegevoegd. Met deze set-up kun je moeiteloos Python-code schrijven, uitvoeren, debuggen en controleren op stijl en kwaliteit. Ga nu gerust verder met het ontwikkelen van je projecten en veel plezier met programmeren!

syllabus/Bijlage_nieuwproject old.md

@@ -0,0 +1,5 @@
+# Bijlage: Nieuw project in PyCharm
+
+Klik dan op *Create New Project*. Kies de gewilde locatie op je PC waar je het project wil neerzetten en de naam van het project. Klik dan op *Project Interpreter*. Selecteer *Existing Interpreter* en kies *Python 3.x*. Als deze er niet tussen staat, klik op de drie puntjes, *System Interpreter* en selecteer de enige optie. Klik op *OK* en daarna *Create*.
+
+Je hebt nu je eerste project! Om een nieuw bestand te maken klik je met de rechter-muisknop op het mapje met de naam die je het project gegeven hebt, onder *Project*. Selecteer *New*, *Python File*. Copy-paste `print("hi")` in het bestand dat je net gemaakt hebt en klik bovenin op tab *Run, Run* (of klik Shift + F10). Je ziet onder in beeld een zwart scherm opkomen waar 'hi' in staat.

syllabus/Bijlage_nieuwproject.md

@@ -1,5 +1,68 @@
-# Bijlage: Nieuw project in PyCharm
+# Bijlage: Nieuw project in Visual Studio Code
 
-Klik dan op *Create New Project*. Kies de gewilde locatie op je PC waar je het project wil neerzetten en de naam van het project. Klik dan op *Project Interpreter*. Selecteer *Existing Interpreter* en kies *Python 3.x*. Als deze er niet tussen staat, klik op de drie puntjes, *System Interpreter* en selecteer de enige optie. Klik op *OK* en daarna *Create*.
+In deze bijlage zie je hoe je snel en eenvoudig een nieuw Python-project opzet in Visual Studio Code. 
 
-Je hebt nu je eerste project! Om een nieuw bestand te maken klik je met de rechter-muisknop op het mapje met de naam die je het project gegeven hebt, onder *Project*. Selecteer *New*, *Python File*. Copy-paste `print("hi")` in het bestand dat je net gemaakt hebt en klik bovenin op tab *Run, Run* (of klik Shift + F10). Je ziet onder in beeld een zwart scherm opkomen waar 'hi' in staat.
+---
+
+## Een nieuwe map maken
+
+1. **Kies een locatie**  
+   Bedenk waar je je project wilt bewaren en maak daar een nieuwe map aan, bijvoorbeeld `C:\MijnProject` (Windows) of in je thuismap op macOS/Linux.
+
+2. **Open de map in Visual Studio Code**  
+   - Start Visual Studio Code.  
+   - Klik op *File* > *Open Folder…* (Windows/Linux) of *File* > *Open…* (macOS).  
+   - Navigeer naar de map die je net hebt gemaakt en open deze.
+
+Je hebt nu de basis van je project klaargezet in Visual Studio Code.
+
+---
+
+## Interpreter instellen (optioneel)
+
+1. **Interpreter selecteren**  
+   Rechts onderin de statusbalk van Visual Studio Code kun je de actieve Python-versie zien. Staat er geen Python-versie?  
+   - Druk op <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> (Windows/Linux) of <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> (macOS).  
+   - Typ `Python: Select Interpreter` en kies de Python 3.x-versie die je wilt gebruiken.
+
+2. **Interpreter ontbreekt?**  
+   Als je geen optie ziet voor Python 3.x, controleer dan of je Python correct hebt geïnstalleerd (zie *Bijlage: Python en Visual Studio Code installeren*) en herstart eventueel Visual Studio Code.
+
+---
+
+## Eerste Python-bestand maken
+
+1. **Nieuw bestand**  
+   Klik in de *Explorer*-sidebar (het eerste icoontje links in beeld) met de rechtermuisknop op je projectmap. Kies *New File*. 
+
+2. **Bestandsnaam**  
+   Noem het bestand bijvoorbeeld `main.py` of `hallo.py`.
+
+3. **Code invoeren**  
+   Open het nieuwe bestand en voeg de volgende regel code toe:  
+   ```python
+   print("hi")
+   ```
+
+4. **Bestand opslaan**
+   Druk op <kbd>Ctrl</kbd> + <kbd>S</kbd> (Windows/Linux) of <kbd>Cmd</kbd> + <kbd>S</kbd> (macOS) om het bestand op te slaan.
+
+## Code uitvoeren
+1.	**Run and Debug**
+
+    Klik in Visual Studio Code links op het *Run and Debug*-icoon (play-icoon met een kever). Als je de Python-extensie hebt geïnstalleerd, kies dan de optie *Python: Current File* (of iets vergelijkbaars).
+
+2.	**Run-bestemming kiezen**
+
+    Visual Studio Code kan je vragen om een launch configuration aan te maken. Hiermee wordt je huidige Python-bestand uitgevoerd.
+
+3.	**Resultaten bekijken**
+
+    Zodra je het script uitvoert, verschijnt er een *Debug Console* of *Terminal*-paneel onder in beeld. Hier zou `hi` moeten verschijnen.
+
+
+Tip: Je kunt ook met <kbd>F5</kbd> (of <kbd>Fn</kbd> + <kbd>F5</kbd> op macOS) het huidige bestand starten, mits je een Python-debugconfiguratie hebt ingesteld.
+
+## Projectstructuur bijhouden
+
+Je hebt nu je eerste Python-project in Visual Studio Code! Houd je bestanden en mappen netjes geordend. Wil je een extra bestand toevoegen? Klik dan simpelweg in de *Explorer*-sidebar met de rechtermuisknop op je projectmap, kies *New File* of *New Folder* en ga aan de slag.

syllabus/Bijlage_requirements.md

@@ -3,36 +3,36 @@
 Een `requirements.txt` maakt het eenvoudig om op een andere machine je Pythonproject te installeren en te runnen. Het is verplicht om een `requirements.txt` te gebruiken bij deze Python Plus module.
 
 1. Maak een bestand ‘requirements.txt’ en plaats het bij je andere .py bestanden;
-2. Open `requirements.txt` en voeg alle geïnstalleerde en gebruikte python packages toe aan requirements.txt door het runnen van de volgende command in de Terminal van PyCharm:
+2. Open `requirements.txt` en voeg alle geïnstalleerde en gebruikte python packages toe aan requirements.txt door het runnen van de volgende command in de Terminal van Visual Studio Code:
 
-```
-pip freeze > .\requirements.txt
-```
+    ```
+    pip freeze > .\requirements.txt
+    ```
 
-3. Mocht je nu in de problemen komen, omdat het commando `pip` niet herkend wordt door je computer, dan kun je alsnog een `requirements.txt` genereren in PyCharm. Klik hiervoor op het menu *Tools*. Kies vervolgens voor *Sync Python requirements*. Je komt dan in een dialoogvenster terecht. Je hoeft alleen maar op *OK* te klikken. PyCharm plaatst vervolgens een `requirements.txt` met de door jouw code gebruikte externe bibliotheken in de projectmap. Waarschijnlijk zal PyCharm dan een melding geven of je het bestand aan de Git-repo wil toevoegen. Uiteraard klik je op *Add*. 
+   
 3. Als je een nieuwe package nodig hebt, kun je ze op de volgende manier toevoegen `<packagename>==version`, bijvoorbeeld:
 
-`Tensorflow==2.11.0`
+    `Tensorflow==2.11.0`
 
-5. Om de packages vervolgens te installeren open je de terminal en voer je het volgende commando uit:
+4. Om de packages vervolgens te installeren open je de terminal en voer je het volgende commando uit:
 
-```
-pip install -r .\requirements.txt
-```
-6. Voor het toevoegen van nieuwe packages, update je dus de `requirements.txt` en installeer je de file. Vergeet de packages niet te importeren in je .py files.
+    ```
+    pip install -r .\requirements.txt
+    ```
+5. Voor het toevoegen van nieuwe packages, update je dus de `requirements.txt` en installeer je de file. Vergeet de packages niet te importeren in je .py files.
 
-7. Je kunt kijken of alle packages up to date zijn door middel van het commando: 
+6. Je kunt kijken of alle packages up to date zijn door middel van het commando: 
 
-```
-pip list --outdated
-```
-8. Je kunt alle packages updaten door middel van het commando: 
+    ```
+    pip list --outdated
+    ```
+7. Je kunt alle packages updaten door middel van het commando: 
 
-```
-pip upgrade -r requirements.txt
-```
-Of een specifieke package door middel van het commando:
-```
-pip install -U packagename
-```
-9. Meer tips en trucks kun je hier vinden: (https://learnpython.com/blog/python-requirements-file/)
+    ```
+    pip upgrade -r requirements.txt
+    ```
+    Of een specifieke package door middel van het commando:
+    ```
+    pip install -U packagename
+    ```
+8. Meer tips en trucks kun je hier vinden: (https://learnpython.com/blog/python-requirements-file/)