Skip to content

INSTALLATION.md

Latest commit

 

History

History
252 lines (177 loc) · 6.48 KB

INSTALLATION.md

File metadata and controls

252 lines (177 loc) · 6.48 KB

Installationsguide

Den här guiden hjälper dig att ställa in din miljö för att arbeta med Data Science for Beginners-kursen.

Innehållsförteckning

Förutsättningar

Innan du börjar bör du ha:

  • Grundläggande kunskaper om kommandoraden/terminalen
  • Ett GitHub-konto (gratis)
  • Stabil internetanslutning för den första installationen

Snabbstartsalternativ

Alternativ 1: GitHub Codespaces (Rekommenderas för nybörjare)

Det enklaste sättet att komma igång är med GitHub Codespaces, som erbjuder en komplett utvecklingsmiljö direkt i din webbläsare.

  1. Gå till repositoryt
  2. Klicka på Code-menyn
  3. Välj fliken Codespaces
  4. Klicka på Create codespace on main
  5. Vänta tills miljön har initierats (2-3 minuter)

Din miljö är nu redo med alla beroenden förinstallerade!

Alternativ 2: Lokal utveckling

För att arbeta på din egen dator, följ de detaljerade instruktionerna nedan.

Lokal installation

Steg 1: Installera Git

Git krävs för att klona repositoryt och spåra dina ändringar.

Windows:

  • Ladda ner från git-scm.com
  • Kör installationsprogrammet med standardinställningar

macOS:

  • Installera via Homebrew: brew install git
  • Eller ladda ner från 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

Steg 2: Klona repositoryt

# Clone the repository
git clone https://github.com/microsoft/Data-Science-For-Beginners.git

# Navigate to the directory
cd Data-Science-For-Beginners

Steg 3: Installera Python och Jupyter

Python 3.7 eller högre krävs för data science-lektionerna.

Windows:

  1. Ladda ner Python från python.org
  2. Under installationen, kryssa i "Add Python to PATH"
  3. Verifiera installationen:
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

Steg 4: Ställ in Python-miljö

Det rekommenderas att använda en virtuell miljö för att hålla beroenden isolerade.

# Create a virtual environment
python -m venv venv

# Activate the virtual environment
# On Windows:
venv\Scripts\activate

# On macOS/Linux:
source venv/bin/activate

Steg 5: Installera Python-paket

Installera de nödvändiga data science-biblioteken:

pip install jupyter pandas numpy matplotlib seaborn scikit-learn

Steg 6: Installera Node.js och npm (För quiz-appen)

Quiz-applikationen kräver Node.js och npm.

Windows/macOS:

  • Ladda ner från nodejs.org (LTS-versionen rekommenderas)
  • Kör installationsprogrammet

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

Steg 7: Installera beroenden för quiz-appen

# Navigate to quiz app directory
cd quiz-app

# Install dependencies
npm install

# Return to root directory
cd ..

Steg 8: Installera Docsify (Valfritt)

För offlineåtkomst till dokumentationen:

npm install -g docsify-cli

Verifiera din installation

Testa Python och 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

Din webbläsare bör öppnas med Jupyter-gränssnittet. Du kan nu navigera till valfri lektions .ipynb-fil.

Testa quiz-applikationen

# Navigate to quiz app
cd quiz-app

# Start development server
npm run serve

Quiz-appen bör vara tillgänglig på http://localhost:8080 (eller en annan port om 8080 är upptagen).

Testa dokumentationsservern

# From the root directory of the repository
docsify serve

Dokumentationen bör vara tillgänglig på http://localhost:3000.

Använda VS Code Dev Containers

Om du har Docker installerat kan du använda VS Code Dev Containers:

  1. Installera Docker Desktop
  2. Installera Visual Studio Code
  3. Installera Remote - Containers extension
  4. Öppna repositoryt i VS Code
  5. Tryck på F1 och välj "Remote-Containers: Reopen in Container"
  6. Vänta tills containern byggs (endast första gången)

Nästa steg

Få hjälp

Om du stöter på problem:

  1. Kontrollera TROUBLESHOOTING.md-guiden
  2. Sök bland befintliga GitHub Issues
  3. Gå med i vår Discord-community
  4. Skapa ett nytt ärende med detaljerad information om ditt problem

Ansvarsfriskrivning:
Detta dokument har översatts med hjälp av AI-översättningstjänsten Co-op Translator. Även om vi strävar efter noggrannhet, vänligen notera att automatiserade översättningar kan innehålla fel eller felaktigheter. Det ursprungliga dokumentet på dess originalspråk bör betraktas som den auktoritativa källan. För kritisk information rekommenderas professionell mänsklig översättning. Vi ansvarar inte för eventuella missförstånd eller feltolkningar som uppstår vid användning av denna översättning.