6.5 KiB
Installatiegids
Deze gids helpt je om je omgeving in te stellen voor het werken met het curriculum Data Science voor Beginners.
Inhoudsopgave
Vereisten
Voordat je begint, zorg ervoor dat je:
- Basiskennis hebt van de command line/terminal
- Een GitHub-account hebt (gratis)
- Een stabiele internetverbinding hebt voor de initiële setup
Snelle Startopties
Optie 1: GitHub Codespaces (Aanbevolen voor Beginners)
De eenvoudigste manier om te beginnen is met GitHub Codespaces, dat een complete ontwikkelomgeving in je browser biedt.
- Ga naar de repository
- Klik op het Code dropdownmenu
- Selecteer het tabblad Codespaces
- Klik op Create codespace on main
- Wacht tot de omgeving is geïnitialiseerd (2-3 minuten)
Je omgeving is nu klaar met alle vereiste afhankelijkheden vooraf geïnstalleerd!
Optie 2: Lokale Ontwikkeling
Voor werken op je eigen computer, volg de gedetailleerde instructies hieronder.
Lokale Installatie
Stap 1: Installeer Git
Git is nodig om de repository te klonen en je wijzigingen bij te houden.
Windows:
- Download van git-scm.com
- Voer de installer uit met de standaardinstellingen
macOS:
- Installeer via Homebrew:
brew install git - Of download van git-scm.com
Linux:
# Debian/Ubuntu
sudo apt-get update
sudo apt-get install git
# Fedora
sudo dnf install git
# Arch
sudo pacman -S git
Stap 2: Clone de Repository
# Clone the repository
git clone https://github.com/microsoft/Data-Science-For-Beginners.git
# Navigate to the directory
cd Data-Science-For-Beginners
Stap 3: Installeer Python en Jupyter
Python 3.7 of hoger is vereist voor de data science-lessen.
Windows:
- Download Python van python.org
- Vink tijdens de installatie "Add Python to PATH" aan
- Controleer de installatie:
python --version
macOS:
# Using Homebrew
brew install python3
# Verify installation
python3 --version
Linux:
# Most Linux distributions come with Python pre-installed
python3 --version
# If not installed:
# Debian/Ubuntu
sudo apt-get install python3 python3-pip
# Fedora
sudo dnf install python3 python3-pip
Stap 4: Stel Python-omgeving in
Het wordt aanbevolen om een virtuele omgeving te gebruiken om afhankelijkheden geïsoleerd te houden.
# Create a virtual environment
python -m venv venv
# Activate the virtual environment
# On Windows:
venv\Scripts\activate
# On macOS/Linux:
source venv/bin/activate
Stap 5: Installeer Python-pakketten
Installeer de benodigde data science-bibliotheken:
pip install jupyter pandas numpy matplotlib seaborn scikit-learn
Stap 6: Installeer Node.js en npm (Voor Quiz App)
De quizapplicatie vereist Node.js en npm.
Windows/macOS:
- Download van nodejs.org (LTS-versie aanbevolen)
- Voer de installer uit
Linux:
# Debian/Ubuntu
# WARNING: Piping scripts from the internet directly into bash can be a security risk.
# It is recommended to review the script before running it:
# curl -fsSL https://deb.nodesource.com/setup_lts.x -o setup_lts.x
# less setup_lts.x
# Then run:
# sudo -E bash setup_lts.x
#
# Alternatively, you can use the one-liner below at your own risk:
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
# Fedora
sudo dnf install nodejs
# Verify installation
node --version
npm --version
Stap 7: Installeer Quiz App-afhankelijkheden
# Navigate to quiz app directory
cd quiz-app
# Install dependencies
npm install
# Return to root directory
cd ..
Stap 8: Installeer Docsify (Optioneel)
Voor offline toegang tot documentatie:
npm install -g docsify-cli
Controleer je Installatie
Test Python en Jupyter
# Activate your virtual environment if not already activated
# On Windows:
venv\Scripts\activate
# On macOS/Linux:
source venv/bin/activate
# Start Jupyter Notebook
jupyter notebook
Je browser zou moeten openen met de Jupyter-interface. Je kunt nu navigeren naar een .ipynb-bestand van een les.
Test Quiz Applicatie
# Navigate to quiz app
cd quiz-app
# Start development server
npm run serve
De quizapplicatie zou beschikbaar moeten zijn op http://localhost:8080 (of een andere poort als 8080 bezet is).
Test Documentatieserver
# From the root directory of the repository
docsify serve
De documentatie zou beschikbaar moeten zijn op http://localhost:3000.
Gebruik van VS Code Dev Containers
Als je Docker hebt geïnstalleerd, kun je VS Code Dev Containers gebruiken:
- Installeer Docker Desktop
- Installeer Visual Studio Code
- Installeer de Remote - Containers extensie
- Open de repository in VS Code
- Druk op
F1en selecteer "Remote-Containers: Reopen in Container" - Wacht tot de container is gebouwd (alleen de eerste keer)
Volgende Stappen
- Verken de README.md voor een overzicht van het curriculum
- Lees USAGE.md voor veelvoorkomende workflows en voorbeelden
- Bekijk TROUBLESHOOTING.md als je problemen tegenkomt
- Bekijk CONTRIBUTING.md als je wilt bijdragen
Hulp krijgen
Als je problemen ondervindt:
- Bekijk de TROUBLESHOOTING.md gids
- Zoek in bestaande GitHub Issues
- Word lid van onze Discord-community
- Maak een nieuw issue aan met gedetailleerde informatie over je probleem
Disclaimer:
Dit document is vertaald met behulp van de AI-vertalingsservice Co-op Translator. Hoewel we streven naar nauwkeurigheid, dient u zich ervan bewust te zijn dat geautomatiseerde vertalingen fouten of onnauwkeurigheden kunnen bevatten. Het originele document in de oorspronkelijke taal moet worden beschouwd als de gezaghebbende bron. Voor cruciale informatie wordt professionele menselijke vertaling aanbevolen. Wij zijn niet aansprakelijk voor misverstanden of verkeerde interpretaties die voortvloeien uit het gebruik van deze vertaling.