Skip to content

INSTALLATION.md

Latest commit

 

History

History
261 lines (186 loc) · 7.2 KB

INSTALLATION.md

File metadata and controls

261 lines (186 loc) · 7.2 KB
Raw

Telepítési útmutató

Ez az útmutató segít beállítani a környezetet a Data Science for Beginners tananyag használatához.

Tartalomjegyzék

Előfeltételek

Mielőtt elkezdené, szüksége lesz:

  • Alapvető ismeretekre a parancssor/terminál használatában
  • Egy GitHub fiókra (ingyenes)
  • Stabil internetkapcsolatra a kezdeti beállításhoz

Gyors kezdési lehetőségek

Opció 1: GitHub Codespaces (Ajánlott kezdőknek)

A legegyszerűbb módja a kezdésnek a GitHub Codespaces használata, amely teljes fejlesztési környezetet biztosít a böngészőben.

  1. Nyissa meg a repository-t
  2. Kattintson a Code legördülő menüre
  3. Válassza ki a Codespaces fület
  4. Kattintson a Create codespace on main gombra
  5. Várja meg, amíg a környezet inicializálódik (2-3 perc)

A környezete most készen áll, minden szükséges függőség előre telepítve van!

Opció 2: Helyi fejlesztés

Ha saját számítógépen szeretne dolgozni, kövesse az alábbi részletes utasításokat.

Helyi telepítés

1. lépés: Git telepítése

A Git szükséges a repository klónozásához és a változások nyomon követéséhez.

Windows:

  • Töltse le innen: git-scm.com
  • Futtassa az telepítőt alapértelmezett beállításokkal

macOS:

  • Telepítse Homebrew segítségével: brew install git
  • Vagy töltse le innen: 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

2. lépés: Repository klónozása

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

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

3. lépés: Python és Jupyter telepítése

A data science leckékhez Python 3.7 vagy újabb verzió szükséges.

Windows:

  1. Töltse le a Pythont innen: python.org
  2. A telepítés során jelölje be az "Add Python to PATH" opciót
  3. Ellenőrizze a telepítést:
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

4. lépés: Python környezet beállítása

Ajánlott virtuális környezetet használni a függőségek elkülönítéséhez.

# Create a virtual environment
python -m venv venv

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

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

5. lépés: Python csomagok telepítése

Telepítse a szükséges data science könyvtárakat:

pip install jupyter pandas numpy matplotlib seaborn scikit-learn

6. lépés: Node.js és npm telepítése (Kvíz alkalmazáshoz)

A kvíz alkalmazás Node.js-t és npm-et igényel.

Windows/macOS:

  • Töltse le innen: nodejs.org (Ajánlott LTS verzió)
  • Futtassa a telepítőt

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

7. lépés: Kvíz alkalmazás függőségeinek telepítése

# Navigate to quiz app directory
cd quiz-app

# Install dependencies
npm install

# Return to root directory
cd ..

8. lépés: Docsify telepítése (Opcionális)

Offline dokumentáció eléréséhez:

npm install -g docsify-cli

Telepítés ellenőrzése

Python és Jupyter tesztelése

# 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

A böngészőnek meg kell nyílnia a Jupyter felülettel. Most navigálhat bármelyik lecke .ipynb fájljához.

Kvíz alkalmazás tesztelése

# Navigate to quiz app
cd quiz-app

# Start development server
npm run serve

A kvíz alkalmazásnak elérhetőnek kell lennie a http://localhost:8080 címen (vagy más porton, ha a 8080 foglalt).

Dokumentációs szerver tesztelése

# From the root directory of the repository
docsify serve

A dokumentációnak elérhetőnek kell lennie a http://localhost:3000 címen.

VS Code Dev Containers használata

Ha telepítve van a Docker, használhatja a VS Code Dev Containers funkciót:

  1. Telepítse a Docker Desktop alkalmazást
  2. Telepítse a Visual Studio Code programot
  3. Telepítse a Remote - Containers kiegészítőt
  4. Nyissa meg a repository-t a VS Code-ban
  5. Nyomja meg az F1 gombot, és válassza a "Remote-Containers: Reopen in Container" opciót
  6. Várja meg, amíg a konténer felépül (csak első alkalommal)

Következő lépések

  • Fedezze fel a README.md fájlt a tananyag áttekintéséhez
  • Olvassa el a USAGE.md fájlt a gyakori munkafolyamatok és példák megismeréséhez
  • Nézze meg a TROUBLESHOOTING.md fájlt, ha problémákba ütközik
  • Tekintse át a CONTRIBUTING.md fájlt, ha hozzájárulni szeretne

Segítség kérése

Ha problémákba ütközik:

  1. Nézze meg a TROUBLESHOOTING.md útmutatót
  2. Keressen meglévő GitHub Issues között
  3. Csatlakozzon a Discord közösségünkhöz
  4. Hozzon létre egy új hibajelentést részletes információkkal a problémáról

Felelősség kizárása:
Ezt a dokumentumot az Co-op Translator AI fordítási szolgáltatás segítségével fordították le. Bár törekszünk a pontosságra, kérjük, vegye figyelembe, hogy az automatikus fordítások hibákat vagy pontatlanságokat tartalmazhatnak. Az eredeti dokumentum az eredeti nyelvén tekintendő hiteles forrásnak. Kritikus információk esetén javasolt professzionális emberi fordítást igénybe venni. Nem vállalunk felelősséget a fordítás használatából eredő félreértésekért vagy téves értelmezésekért.