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