Основы создания веб-страниц, блогов и интерактивных книг в Quarto

Создание веб-страниц, отчетов, блогов и интерактивных книг в Quarto.

Второй митап построен как практическое занятие. В ходе митапа мы рассмотрим:

1. как создавать статьи, блоги и интерактивные книги в Quarto
2. адаптацию документов к языковым соответствиям (локализацию документов)
3. публикацию документов в сети Интернет
4. структуру документов Quarto на основе заготовок
5. оформление библиографии
6. основы работы с Git при работе с Quarto-документами

Основные рабочие инструменты

Для полноценной работы будут необходимы следующие установленные инструменты.

• IDE RStudio Desktop и Visual Studio Code.

• Установленный Quarto CLI версии >1.2¹, а также quarto-vscode plugin.

• Зарегистрированная учетная запись на GitHub.

• Зарегистрированная учетная запись на Netlify.

• Для клонирования репозитория и работы с Git может понадобиться, например, GitHub Desktop или GitKraken.

Видео второго митапа

Некоторые полезные расширения VS Code

• GitLens

• Project Manager

• Code Spell Checker

• Russian - Code Spell Checker

• LanguageTool Extension

• Языковой пакет для русского языка для VS Code

• Official Dracula Theme

• Color Highlight

• VS Code Great Icons

• YAML

• vscode-pdf

Примеры документов и репозитории

Пример блога / ссылка на репозиторий с примером блога

Пример отчета / ссылка на репозиторий с примером отчета

Пример интерактивной книги / ссылка на репозиторий с примером интерактивной книги

Локализация PDF

На странице документации и странице описано множество различных опций для создания Quarto -> PDF документов. Для локализации можно использовать несколько различных возможностей, например следующие.

• Способ 1 принадлежит С.В. Бабёнышеву. Локализация основана на существовании *.tex-шаблона и описана в GitHib-репозитории.

• Способ 2 предложил Георгий Алексеевич Мороз. Необходимо добавить в YAML-преамбулу:

---
title: "Тестируем кириллицу"
format: 
    pdf:
      pdf-engine: xelatex
      include-in-header: 
          text: |
            \usepackage[english,russian]{babel} 
            \usepackage{fontspec}
            \addtokomafont{disposition}{\rmfamily}
editor: visual
mainfont: "Times New Roman"
# шрифты можно указать свои
# mainfont: "Brill"
# mainfont: "Iosevka"
---

Мой дядя самых честных правил.

Сноски

1. для работы с некоторыми новыми функциями Quarto можно установить экспериментальную версию Quarto CLI >1.3; в митапе будет использоваться версия 1.3.228, однако это не обязательно.