Skip to content

INSTALLATION.md

Latest commit

 

History

History
252 lines (177 loc) · 9.12 KB

INSTALLATION.md

File metadata and controls

252 lines (177 loc) · 9.12 KB

Руководство по установке

Это руководство поможет вам настроить среду для работы с учебной программой «Основы Data Science».

Содержание

Предварительные требования

Перед началом работы вам потребуется:

  • Базовые знания работы с командной строкой/терминалом
  • Аккаунт на GitHub (бесплатный)
  • Стабильное интернет-соединение для начальной настройки

Быстрые варианты начала работы

Вариант 1: GitHub Codespaces (рекомендуется для новичков)

Самый простой способ начать — использовать GitHub Codespaces, который предоставляет готовую среду разработки прямо в браузере.

  1. Перейдите в репозиторий
  2. Нажмите на выпадающее меню Code
  3. Выберите вкладку Codespaces
  4. Нажмите Create codespace on main
  5. Дождитесь инициализации среды (2-3 минуты)

Ваша среда готова, и все зависимости уже установлены!

Вариант 2: Локальная разработка

Для работы на вашем компьютере следуйте подробным инструкциям ниже.

Локальная установка

Шаг 1: Установите Git

Git необходим для клонирования репозитория и отслеживания изменений.

Windows:

  • Скачайте с git-scm.com
  • Запустите установщик с настройками по умолчанию

macOS:

  • Установите через Homebrew: brew install git
  • Или скачайте с 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: Клонируйте репозиторий

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

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

Шаг 3: Установите Python и Jupyter

Для уроков по Data Science требуется Python версии 3.7 или выше.

Windows:

  1. Скачайте Python с python.org
  2. Во время установки отметьте «Add Python to PATH»
  3. Проверьте установку:
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: Настройте Python-среду

Рекомендуется использовать виртуальную среду для изоляции зависимостей.

# 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: Установите Python-библиотеки

Установите необходимые библиотеки для Data Science:

pip install jupyter pandas numpy matplotlib seaborn scikit-learn

Шаг 6: Установите Node.js и npm (для приложения викторины)

Для работы приложения викторины требуется Node.js и npm.

Windows/macOS:

  • Скачайте с nodejs.org (рекомендуется версия LTS)
  • Запустите установщик

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: Установите зависимости для приложения викторины

# Navigate to quiz app directory
cd quiz-app

# Install dependencies
npm install

# Return to root directory
cd ..

Шаг 8: Установите Docsify (опционально)

Для офлайн-доступа к документации:

npm install -g docsify-cli

Проверка установки

Тестирование Python и 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

Ваш браузер должен открыть интерфейс Jupyter. Теперь вы можете перейти к любому файлу .ipynb из уроков.

Тестирование приложения викторины

# Navigate to quiz app
cd quiz-app

# Start development server
npm run serve

Приложение викторины должно быть доступно по адресу http://localhost:8080 (или другому порту, если 8080 занят).

Тестирование сервера документации

# From the root directory of the repository
docsify serve

Документация должна быть доступна по адресу http://localhost:3000.

Использование Dev Containers в VS Code

Если у вас установлен Docker, вы можете использовать Dev Containers в VS Code:

  1. Установите Docker Desktop
  2. Установите Visual Studio Code
  3. Установите расширение Remote - Containers
  4. Откройте репозиторий в VS Code
  5. Нажмите F1 и выберите «Remote-Containers: Reopen in Container»
  6. Дождитесь сборки контейнера (только при первом запуске)

Следующие шаги

  • Ознакомьтесь с README.md для обзора учебной программы
  • Прочитайте USAGE.md для примеров и часто используемых рабочих процессов
  • Ознакомьтесь с TROUBLESHOOTING.md, если столкнетесь с проблемами
  • Изучите CONTRIBUTING.md, если хотите внести вклад

Получение помощи

Если вы столкнулись с проблемами:

  1. Ознакомьтесь с руководством TROUBLESHOOTING.md
  2. Найдите существующие GitHub Issues
  3. Присоединяйтесь к нашему сообществу в Discord
  4. Создайте новый issue с подробным описанием вашей проблемы

Отказ от ответственности:
Этот документ был переведен с помощью сервиса автоматического перевода Co-op Translator. Несмотря на наши усилия обеспечить точность, автоматические переводы могут содержать ошибки или неточности. Оригинальный документ на его родном языке следует считать авторитетным источником. Для получения критически важной информации рекомендуется профессиональный перевод человеком. Мы не несем ответственности за любые недоразумения или неправильные интерпретации, возникшие в результате использования данного перевода.