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.
252 lines
6.5 KiB
252 lines
6.5 KiB
# 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](../..)
|
|
- [Snabbstartsalternativ](../..)
|
|
- [Lokal installation](../..)
|
|
- [Verifiera din installation](../..)
|
|
|
|
## 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](https://github.com/microsoft/Data-Science-For-Beginners)
|
|
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](https://git-scm.com/download/win)
|
|
- Kör installationsprogrammet med standardinställningar
|
|
|
|
**macOS:**
|
|
- Installera via Homebrew: `brew install git`
|
|
- Eller ladda ner från [git-scm.com](https://git-scm.com/download/mac)
|
|
|
|
**Linux:**
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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](https://www.python.org/downloads/)
|
|
2. Under installationen, kryssa i "Add Python to PATH"
|
|
3. Verifiera installationen:
|
|
```bash
|
|
python --version
|
|
```
|
|
|
|
**macOS:**
|
|
```bash
|
|
# Using Homebrew
|
|
brew install python3
|
|
|
|
# Verify installation
|
|
python3 --version
|
|
```
|
|
|
|
**Linux:**
|
|
```bash
|
|
# 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.
|
|
|
|
```bash
|
|
# 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:
|
|
|
|
```bash
|
|
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](https://nodejs.org/) (LTS-versionen rekommenderas)
|
|
- Kör installationsprogrammet
|
|
|
|
**Linux:**
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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:
|
|
|
|
```bash
|
|
npm install -g docsify-cli
|
|
```
|
|
|
|
## Verifiera din installation
|
|
|
|
### Testa Python och Jupyter
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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](https://www.docker.com/products/docker-desktop)
|
|
2. Installera [Visual Studio Code](https://code.visualstudio.com/)
|
|
3. Installera [Remote - Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers)
|
|
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
|
|
|
|
- Utforska [README.md](README.md) för en översikt av kursen
|
|
- Läs [USAGE.md](USAGE.md) för vanliga arbetsflöden och exempel
|
|
- Kontrollera [TROUBLESHOOTING.md](TROUBLESHOOTING.md) om du stöter på problem
|
|
- Granska [CONTRIBUTING.md](CONTRIBUTING.md) om du vill bidra
|
|
|
|
## Få hjälp
|
|
|
|
Om du stöter på problem:
|
|
|
|
1. Kontrollera [TROUBLESHOOTING.md](TROUBLESHOOTING.md)-guiden
|
|
2. Sök bland befintliga [GitHub Issues](https://github.com/microsoft/Data-Science-For-Beginners/issues)
|
|
3. Gå med i vår [Discord-community](https://aka.ms/ds4beginners/discord)
|
|
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](https://github.com/Azure/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. |