Сложно – пока не знаешь. Как узнал – просто.
Быстрый старт¶
| Раздел | Описание |
|---|---|
| Исходные данные | Технологический базис проекта |
| Настройка рабочего пространства | Создание изолированного conda-окружения, установка инструментов верстки и коннекторов БД, фиксация, развертывание |
| Создание проекта | Инициализация Jupyter Book, создание структуры проекта, контента, настройка конфигурации, нюансы Jupyter Lab |
| Локальный запуск сайта | Настройка Git Bash и запуск сайта в локальном браузере |
| Инициализация Git | Шаблон .gitignore, инициализация локального репозитория, создание репозитория на GitHub, связывание по SSH |
| Публикация сайта | Публикация сайта в интернете на GitHub Pages |
| Daily Workflow | Ежедневная работа, пересборка сайта |
При создании гайда постоянно испытывал качели
С одной стороны – все просто. И ты в одном шаге от звания капитан очевидность.
С другой – если ничего подобного не делал, то все, черт подери, сложно. И непонятно насколько глубока кроличья нора для каждого индивида.
Пошел по второму пути. Пошагово, по возможности с нуля, со ссылками для самостоятельного (при желании) проваливания в тему.
Инфраструктура¶
Разворачиваем инфраструктуру и настраиваем инструменты
Как установить на комп базу данных sakila и подключиться к ней?
Как сделать чтобы вывод 5462 строк отображался как на страницах книги – в усеченном виде через многоточие?
В этом разделе ответы на эти и другие вопросы, которые помогут развернуть целостную инфраструктуру и настроить используемые инструменты.
| Раздел [1] | Описание |
|---|---|
| Установка MySQL | Разворачиваем локальную базу данных |
| Установка DBeaver | |
| Python in SQLAlchemy | Создание подключения, настройка вывода JupySQL |
| Бенчмаркинг SQL-запросов | Реализация автоматического вывода времени выполнения SQL-запросов в JupyterLab |
| VS Code vs JupyterLab | Для каких задач удобнее VS Code, настройка VS Code под проект |
| Pandas vs Polars | Зачем они в проекте, нюансы использования |
| GitVerse vs GitHub | GitVerse как резервное зеркало для основного хостинга, опыт использования |
Главы¶
По сути, я просто повторяю код из книги, чтобы лучше его запомнить и набить руку. Так я думал вначале.
Вопреки начальному замыслу, в главах все же присутствуют мои заметки, примеры и рекомендации по использованию и настройке применяемых инструментов.
Упражнения не стал разделять на exercises и solutions. Это уже сделано в книге. Я просто читаю книгу и показываю способ чтения, который вдруг пришел в голову и увлек своей идеей.
Разделы без ссылки в статусе черновик в личном Obsidian