Quarto. Использование переменных

Quarto. Использование переменных.

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

• В Quarto переменные позволяют динамически управлять содержимым документа.

2 Переменные проекта (var)

• Этот способ подходит для значений, которые повторяются во многих документах одного проекта (например, название компании или номер версии).
• Этот метод работает только в рамках проекта Quarto, а не в одиночных файлах.

2.1 Как создать

• Создайте файл _variables.yml в корневой папке проекта (рядом с _quarto.yml) и определите переменные в формате ключ: значение.

2.2 Как использовать

• В любом документе проекта (.qmd-файле) вставьте короткод {{< var ключ *>}}.

2.3 Пример

# файл _variables.yml
project_name: "Мой анализ"
version: "1.0"

<!-- В документе .qmd -->
Это — отчет проекта {{< var project_name >}}.

3 Метаданные документа (meta)

• Используйте этот способ, чтобы вставлять значения из YAML-заголовка документа (например, заголовок, автор, дата) или другие динамически заданные метаданные.
• Значения метаданных можно также задавать динамически с помощью кода R и функции quarto::write_yaml_metadata_block(). Это особенно полезно для параметризованных отчетов.

3.1 Как создать

• Определите переменные в YAML-заголовке (между --- в начале файла).

3.2 Как использовать

• В тексте документа используйте короткод {{< meta ключ *>}}.

3.3 Пример

---
title: "Отчет о продажах"
author: "Иван Петров"
output_date: 2025-12-15
---

Документ "{{< meta title >}}" подготовлен {{< meta author >}}.

4 Переменные окружения (env)

• Этот метод нужен для работы с конфиденциальными данными (токены, пароли) или системными настройками, которые не должны храниться в репозитории кода.

4.1 Как создать

• Определите переменные в файле _environment в корне проекта.
• Для локальных значений, которые не должны попасть в Git, используйте _environment.local (он автоматически добавляется в .gitignore) .

4.2 Как использовать

• В документе применяйте короткод {{< env имя_переменной *>}}.

4.3 Пример

# файл _environment.local
API_KEY=my_secret_key_123

<!-- В документе .qmd -->
Ключ доступа: {{< env API_KEY >}}

5 Сравнение методов