Quarto. Подключение файлов

Quarto. Подключение файлов.

1 Директива include

• Директива include в Quarto позволяет включать содержимое других Markdown-файлов в ваш документ.
• Это полезно, когда вы хотите:
  • повторно использовать фрагменты текста или кода;
  • разбить документ на логические части, хранящиеся в разных файлах;
  • упростить работу с большими документами, разделяя их на более мелкие модули.

2 Синтаксис

• Для включения файла используется шорткод:

{{< include путь_к_файлу >}}

• Где путь_к_файлу — это путь к Markdown-файлу, который вы хотите включить.
• Путь может быть:
  • относительным (например, ../folder/file.md);
  • абсолютным (если требуется, хотя чаще используются относительные пути).

3 Примеры применения

3.1 Включение файла из текущей директории

{{< include src.md >}}

• Этот код включит содержимое файла src.md, который находится в той же папке, что и ваш основной документ.

3.2 Включение файла из поддиректории

{{< include subfolder/another_src.md >}}

• Будет включён файл another_src.md из поддиректории subfolder.

3.3 Использование в сложных структурах:

• Подключение файлов из разных каталогов:

## Раздел 1
{{< include intro.md >}}
## Раздел 2
{{< include sections/part1.md >}}
{{< include sections/part2.md >}}

4 Особенности

4.1 Тип файлов

• Директива include предназначена для включения Markdown-файлов.
• Для включения других типов файлов (например, R-скриптов или Jupyter Notebook) могут потребоваться другие методы.

4.2 Иерархия включения

• Можно включать файлы, которые, в свою очередь, включают другие файлы.
• Следует избегать циклических включений, так как это может привести к ошибкам.

4.3 Обработка метаданных

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

5 Изменение уровня структуры

• Используйте параметр shift-heading-level-by в заголовке YAML для настройки уровней заголовков в подключаемых файлах.
• Установка значения shift-heading-level-by: 1 преобразует заголовки уровня 1 в заголовки уровня 2, уровня 2 — в заголовки уровня 3 и т. д.

  ---
  shift-heading-level-by: 1
  ---