7.3 KiB
Hướng Dẫn Cài Đặt
Hướng dẫn này sẽ giúp bạn thiết lập môi trường để làm việc với giáo trình Khoa học Dữ liệu cho Người mới bắt đầu.
Mục Lục
Yêu Cầu Trước
Trước khi bắt đầu, bạn cần:
- Có kiến thức cơ bản về dòng lệnh/terminal
- Tài khoản GitHub (miễn phí)
- Kết nối internet ổn định để thiết lập ban đầu
Các Tùy Chọn Bắt Đầu Nhanh
Tùy Chọn 1: GitHub Codespaces (Khuyến nghị cho Người mới bắt đầu)
Cách dễ nhất để bắt đầu là sử dụng GitHub Codespaces, cung cấp một môi trường phát triển hoàn chỉnh ngay trong trình duyệt của bạn.
- Truy cập repository
- Nhấp vào menu thả xuống Code
- Chọn tab Codespaces
- Nhấp vào Create codespace on main
- Chờ môi trường khởi tạo (2-3 phút)
Môi trường của bạn đã sẵn sàng với tất cả các phụ thuộc được cài đặt trước!
Tùy Chọn 2: Phát Triển Cục Bộ
Để làm việc trên máy tính của bạn, hãy làm theo hướng dẫn chi tiết dưới đây.
Cài Đặt Cục Bộ
Bước 1: Cài Đặt Git
Git cần thiết để clone repository và theo dõi các thay đổi của bạn.
Windows:
- Tải xuống từ git-scm.com
- Chạy trình cài đặt với các thiết lập mặc định
macOS:
- Cài đặt qua Homebrew:
brew install git - Hoặc tải xuống từ 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
Bước 2: Clone Repository
# Clone the repository
git clone https://github.com/microsoft/Data-Science-For-Beginners.git
# Navigate to the directory
cd Data-Science-For-Beginners
Bước 3: Cài Đặt Python và Jupyter
Python 3.7 hoặc cao hơn là cần thiết cho các bài học khoa học dữ liệu.
Windows:
- Tải Python từ python.org
- Trong quá trình cài đặt, chọn "Add Python to PATH"
- Xác minh cài đặt:
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
Bước 4: Thiết Lập Môi Trường Python
Khuyến nghị sử dụng môi trường ảo để giữ các phụ thuộc được cách ly.
# Create a virtual environment
python -m venv venv
# Activate the virtual environment
# On Windows:
venv\Scripts\activate
# On macOS/Linux:
source venv/bin/activate
Bước 5: Cài Đặt Các Gói Python
Cài đặt các thư viện khoa học dữ liệu cần thiết:
pip install jupyter pandas numpy matplotlib seaborn scikit-learn
Bước 6: Cài Đặt Node.js và npm (Dành cho Ứng Dụng Quiz)
Ứng dụng quiz yêu cầu Node.js và npm.
Windows/macOS:
- Tải xuống từ nodejs.org (khuyến nghị phiên bản LTS)
- Chạy trình cài đặ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
Bước 7: Cài Đặt Các Phụ Thuộc Ứng Dụng Quiz
# Navigate to quiz app directory
cd quiz-app
# Install dependencies
npm install
# Return to root directory
cd ..
Bước 8: Cài Đặt Docsify (Tùy Chọn)
Để truy cập tài liệu ngoại tuyến:
npm install -g docsify-cli
Xác Minh Cài Đặt
Kiểm Tra Python và 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
Trình duyệt của bạn sẽ mở giao diện Jupyter. Bạn có thể điều hướng đến bất kỳ tệp .ipynb nào của bài học.
Kiểm Tra Ứng Dụng Quiz
# Navigate to quiz app
cd quiz-app
# Start development server
npm run serve
Ứng dụng quiz sẽ có sẵn tại http://localhost:8080 (hoặc một cổng khác nếu cổng 8080 đang bận).
Kiểm Tra Máy Chủ Tài Liệu
# From the root directory of the repository
docsify serve
Tài liệu sẽ có sẵn tại http://localhost:3000.
Sử Dụng VS Code Dev Containers
Nếu bạn đã cài đặt Docker, bạn có thể sử dụng VS Code Dev Containers:
- Cài đặt Docker Desktop
- Cài đặt Visual Studio Code
- Cài đặt Remote - Containers extension
- Mở repository trong VS Code
- Nhấn
F1và chọn "Remote-Containers: Reopen in Container" - Chờ container được xây dựng (chỉ lần đầu tiên)
Các Bước Tiếp Theo
- Khám phá README.md để có cái nhìn tổng quan về giáo trình
- Đọc USAGE.md để biết các quy trình làm việc và ví dụ phổ biến
- Kiểm tra TROUBLESHOOTING.md nếu bạn gặp sự cố
- Xem CONTRIBUTING.md nếu bạn muốn đóng góp
Nhận Trợ Giúp
Nếu bạn gặp sự cố:
- Kiểm tra hướng dẫn TROUBLESHOOTING.md
- Tìm kiếm các GitHub Issues hiện có
- Tham gia cộng đồng Discord của chúng tôi
- Tạo một issue mới với thông tin chi tiết về vấn đề của bạn
Tuyên bố miễn trừ trách nhiệm:
Tài liệu này đã được dịch bằng dịch vụ dịch thuật AI Co-op Translator. Mặc dù chúng tôi cố gắng đảm bảo độ chính xác, xin lưu ý rằng các bản dịch tự động có thể chứa lỗi hoặc không chính xác. Tài liệu gốc bằng ngôn ngữ bản địa nên được coi là nguồn thông tin chính thức. Đối với các thông tin quan trọng, khuyến nghị sử dụng dịch vụ dịch thuật chuyên nghiệp bởi con người. Chúng tôi không chịu trách nhiệm cho bất kỳ sự hiểu lầm hoặc diễn giải sai nào phát sinh từ việc sử dụng bản dịch này.