ПРОСТОЙ ГЕНЕРАТОР ИНТЕРАКТИВНЫХ ДОКУМЕНТОВ JUPYTER NOTEBOOK С размеченной ПРОГРАММНОГО КОДА PYTHON

Аннотация

Jupyter Notebook широко применяется для интерактивных вычислений в различных областях науки и техники. Как правило документы Jupyter Notebook создаются непосредственно в браузере, но существует возможность их программной генерации, например с Python-кода, который содержит строчные Pythonлитералы с кодом Markdown. Генерация с Python-кода позволяет сохранять документы в удобном для редактирования текстовом формате. Кроме того, в некоторых случаях, этот Python-код может быть выполнен стандартным интерпретатором Python и без наличия установленного Jupyter Notebook. Это обеспечивает универсальность формата. На данный момент существует несколько инструментов для преобразования Python-кода в документ Jupyter Notebook (.ipynb). Недостатком их является или поддержка устаревших форматов или неудобный способ разметки ячеек документа Jupyter Notebook. Описаны принципы работы и разработана программа на языке Python для генерации интерактивных документов Jupyter Notebook (.ipynb v4) с размеченного простым способом Python-кода, которая имеет возможность дальнейшей конвертации .ipynb в форматы HTML и docx. Программа может быть использована для облегчения создания и редактирования документов на основе Jupyter Notebook. По сравнению с аналогами программа имеет простой и понятный алгоритм на основе регулярных выражений, позволяет ее простую модификацию для других задач. Дополнительным преимуществом является простой способ разметки Python-кода на ячейки, который заключается в расположении блоков Markdown-текста в многострочных Python-литералах в кавычках и разделении блоков кода символами ##. Приведен пример создания Python-кода, который содержит блок Markdown с такими возможностями как форматирование различными шрифтами, гиперссылки, рисунки, блоки программного кода, LaTeX формулы и таблицы; блок кода для построения интерактивного графика с помощью Python библиотек Matplotlib и ipywidgets; блок кода, который выводит неформатированный текст и результаты интерпретации кода HTML, Markdown, SVG функцией display из модуля IPython.display. Показан пример конвертации этого кода в форматы Jupyter Notebook (в том числе интерактивный), Markdown, HTML, docx.