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
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.
- Gå till repositoryt
- Klicka på Code-menyn
- Välj fliken Codespaces
- Klicka på Create codespace on main
- 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:
- Ladda ner Python från python.org
- Under installationen, kryssa i "Add Python to PATH"
- 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:
- Installera Docker Desktop
- Installera Visual Studio Code
- Installera Remote - Containers extension
- Öppna repositoryt i VS Code
- Tryck på
F1och välj "Remote-Containers: Reopen in Container" - Vänta tills containern byggs (endast första gången)
Nästa steg
- Utforska README.md för en översikt av kursen
- Läs USAGE.md för vanliga arbetsflöden och exempel
- Kontrollera TROUBLESHOOTING.md om du stöter på problem
- Granska CONTRIBUTING.md om du vill bidra
Få hjälp
Om du stöter på problem:
- Kontrollera TROUBLESHOOTING.md-guiden
- Sök bland befintliga GitHub Issues
- Gå med i vår Discord-community
- 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.