You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Data-Science-For-Beginners/translations/nl/INSTALLATION.md

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.

  1. Ga naar de repository
  2. Klik op het Code dropdownmenu
  3. Selecteer het tabblad Codespaces
  4. Klik op Create codespace on main
  5. 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:

  1. Download Python van python.org
  2. Vink tijdens de installatie "Add Python to PATH" aan
  3. 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:

  1. Installeer Docker Desktop
  2. Installeer Visual Studio Code
  3. Installeer de Remote - Containers extensie
  4. Open de repository in VS Code
  5. Druk op F1 en selecteer "Remote-Containers: Reopen in Container"
  6. Wacht tot de container is gebouwd (alleen de eerste keer)

Volgende Stappen

Hulp krijgen

Als je problemen ondervindt:

  1. Bekijk de TROUBLESHOOTING.md gids
  2. Zoek in bestaande GitHub Issues
  3. Word lid van onze Discord-community
  4. 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.