📚 Книги из ноутбуков

📕 Jupyter ноутбуки крайне удобны для представления экспериментов, создания инструкций и т.п. Все работают в колабе, показывают туториалы в ноутбуках. Но как выяснилось, есть вполне разумные инструменты, которые могут собрать много ноутбуков (например, материалы курса) в книгу или в сайт с документацией. Вариант, с которым получилось поработать - JupyterBook. Что он может:

📕 Основное: можно взять коллекцию ноутбуков и MD-файлов и сконвертировать их в сайт (ноутбук = страница) или книгу в PDF (ноутбук = глава).
📗 Есть разные варианты конвертации. Я в использовал вариант конвертации через LaTeX, в итоге можно использовать элементы стилевого оформления и управления оттуда.
📘 Собирается и формируется общая библиография, на которую можно давать ссылки прямо из ноутбуков (правда, специальной командой).
📙 Ну и еще много всяких режимов кастомизации.

✨В итоге из набора ноутбуков, которые мы подготовили для демонстрации студентам в рамках курса, можно чисто техническим путем собрать методичку, готовую к изданию! Причем связка сайт с документацией + книга + репозиторий с ноутбуками вполне можно поддерживать в целостном состоянии.

Наш пример. Методичка с учебными примерами по обучению с подкреплением “Selected topics in reinforcement learning: practical hands-on”: изданная книгой, веб-версия, репозиторий (в т.ч. с настройками билда).