Научно-издательская система Quarto
практическое руководство
Введение

В настоящее время все большую популярность набирает научно-издательская система Quarto, которая представляет собой унифицированную систему для авторов, позволяя соединять код на языках программирования R, Python, Julia, Observable JS и его результаты с повествовательным текстом, что делает его незаменимым инструментом в науке о данных. Здесь есть все, что необходимо для комфортной работы студенту или научному исследователю, а также тем, кому необходимо представить свои результаты.
Вот лишь некоторые ключевые функции Quarto:
- В Quarto можно создавать интерактивные книги, презентации, веб-страницы и многое другое на основе единого источника текста. В качестве выходных форматов для экспорта могут служить как веб-страницы, так и многие другие форматы:
*.pdf, MS Word,*.epub, и другие. Это стало возможным благодаря использованию универсального конвертера Pandoc, который обеспечивает поддержку множества форматов. - Документы Quarto могут создаваться на основе шаблонов, написанных на расширенном варианте Markdown и поддерживают динамическое обновление при изменении параметров или данных. Доступны такие функции, как перекрестные ссылки, расширенные макеты, всплывающие цитаты, сноски и многое другое.
- Нумерация разделов, рисунков, таблиц и других элементов выполняется автоматически. В Quarto предусмотрена автоматизация работы с библиографией.
- Формат Quarto совместим со многими IDE, такими как RStudio, Visual Studio Code, Positron, Cursor, Neovim, а также блокнотами, включая JupyterLab и marimo.
- Работа с документом Quarto происходит полностью в текстовом редакторе, а итоговый документ (скажем,
*.pdf) формируется только на последнем этапе во время рендеринга, что позволяет эффективно писать в соавторстве и активно использовать распределенную систему управления версиями Git.
Quarto еще достаточно молодой, постоянно развивающийся инструмент, который активно дополняется новым функционалом, тем не менее, уже сейчас можно сказать, что Quarto — достаточно мощный по потенциалу продукт. Quarto выгодно выделяется на фоне аналогичных решений благодаря глубокой интеграции кода, единому источнику для документов различных форматов и широкому использованию метаданных.
Книга содержит следующие части:
- Начало работы с Quarto
Этот раздел посвящен основам, необходимым для начала работы в Quarto. Здесь вы узнаете, как настроить рабочее окружение в IDE, использовать язык разметки, а также создавать базовые элементы документа. - Примеры проектов в Quarto
В этом разделе представлены практические примеры создания различных основных типов контента: веб-страниц, статей, блогов, презентаций и книг. - Специальные вопросы
Цель данной части состоит в том, чтобы рассмотреть специальные вопросы, связанные с Quarto, такие как, например, дэшборды, формат Wasm в Quarto, позволяющий запускать код в браузере, как работает параметризация шаблонов, а также другие вопросы.
Для быстрой навигации по книге используйте ссылки в разделе Содержание.
В первую очередь книга ориентирована на авторов, которые используют в своей деятельности язык программирования R, однако основы и принципы работы с научно-издательской системой Quarto не зависят от базового языка программирования, и книга может быть полезной для всех, кто программирует также на Python или Julia.
Данное издание не является всеобъемлющим руководством по издательской системе Quarto, поскольку существует полное руководство на официальном сайте Quarto, подробно излагающее большинство тем, рассмотренных в данной книге.
Кроме того, следует отметить, что в настоящий момент готовится к изданию книга Quarto: The Definitive Guide, которая подробно рассматривает различные концептуальные аспекты работы с Quarto.
Благодарности
В первую очередь необходимо отметить авторов Quarto: Carlos Scheidegger, Charles Teague, Christophe Dervieux, J.J. Allaire, Yihui Xie, а также тех, кто внес огромный вклад в развитие и продвижение Quarto: Mine Çetinkaya-Rundel, Charlotte Wickham, Mickaël Canouil, Emil Hvitfeldt, James J Balamuta.
Автор благодарит читателей Telegram-канала Наука и данные за активность и полезные советы при написании книги.