Quarto. Профили

Quarto. Профили.

1 Общая информация

• Профили в Quarto позволяют адаптировать опции, окружение и содержание проектов для различных сценариев.
• С их помощью можно, например:
  • настроить разное поведение при выполнении на производственном сервере и локально;
  • предоставлять различные учётные данные для баз данных или веб-сервисов в зависимости от профиля;
  • создавать разные версии книги из одного исходного кода (например, базовую и продвинутую).

2 Шаги по применению профилей в Quarto

2.1 Создание основного файла конфигурации

• начните с создания основного файла _quarto.yml, в котором укажите базовые настройки проекта;
• в этом файле определите общие параметры, которые будут применяться ко всем версиям проекта.

2.2 Создание дополнительных файлов конфигурации для профилей

• для каждого профиля создайте отдельный файл конфигурации, например, _quarto-production.yml для производственного профиля или _quarto-advanced.yml для продвинутой версии;
• в этих файлах укажите параметры, которые должны переопределять или дополнять настройки из основного файла _quarto.yml.

2.3 Настройка параметров в файлах профилей:

• в файлах профилей можно настроить такие параметры, как заголовок проекта, директорию вывода, поведение выполнения и другие опции;
• пример настройки:

_quarto-production.yml:
  execute:
    freeze: false

• Это отключит использование freeze при рендеринге в производственном профиле.

2.4 Активация профилей

• Активировать профили можно двумя способами: через переменную окружения QUARTO_PROFILE или с помощью аргумента командной строки --profile.
• Активация через переменную окружения:

export QUARTO_PROFILE=production
quarto render

• Активация через аргумент командной строки:

quarto render --profile production

• Активация нескольких профилей одновременно:

quarto render --profile production,advanced

2.5 Включение/исключение контента в зависимости от профиля

• Чтобы включать или исключать контент в зависимости от активного профиля, используйте класс .content-visible вместе с атрибутом when-profile для элементов div или span:

::: {.content-visible when-profile="advanced"}
Этот контент будет отображаться только в продвинутой версии.
:::

• Для исключения контента из определённого профиля можно использовать атрибут unless-profile:

::: {.content-visible unless-profile="advanced"}
Этот контент будет отображаться во всех версиях, кроме продвинутой.
:::

2.6 Настройка профиля по умолчанию

• Чтобы определить профиль по умолчанию, который будет использоваться, если не указан QUARTO_PROFILE или --profile, добавьте опцию default в ключ profile в файле _quarto.yml:

profile:
  default: development

3 Пример использования профилей для создания многоязычного сайта

• Создайте отдельные профили для каждого языка, например, _quarto-english.yml и _quarto-german.yml.
• Настройте в профилях соответствующие параметры, такие как язык интерфейса, навигацию и директорию вывода.
• Для переключения между языками на сайте можно использовать ссылки с относительными путями, например:

navbar:
  right:
    - href: ../de
      text: Deutsch
    - href: ../en
      text: English

• При публикации сайта укажите _site в качестве папки для публикации.