Quarto. Библиография

Quarto. Библиография.

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

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

2 Добавление библиографии

2.1 Подготовьте файл библиографии

• Создайте файл (например, references.bib) в формате BibTeX (см. BibTeX).

2.2 Подключите файл в документе Quarto

• В YAML-заголовке документа (вверху файла .qmd) укажите путь к файлу:

  ---
  title: "Мой документ"
  author: "Автор"
  bibliography: references.bib
  ---
  

2.3 Изменение стиля цитирования

• Чтобы изменить формат (например, на APA или ГОСТ), используйте файл *.csl.

• Укажите его в YAML:

  csl: american-political-science-association.csl
  

• Базу готовых стилей можно найти в репозитории Citation Style Language.

2.4 Цитируйте источники в тексте

• Используйте синтаксис [@ключ_из_bib] в любом месте текста для вставки цитаты.

• Пример:

  • Blah Blah [@knuth1984] → Blah Blah (Knuth 1984)
  • @wickham2015 говорит... → Wickham (2015) говорит…
  • [-@ggplot2] → (2016) — так можно сослаться без имени автора.

• По умолчанию библиография будет автоматически создана и размещена в конце документа.

3 Дополнительные настройки

3.1 Размещение библиографии в нужном месте

• Если требуется, чтобы список литературы появился не в самом конце, а перед приложением, добавьте в нужном месте разметки блок:

  ::: {#refs}
  :::
  

3.2 Включение нецитированных источников

• Чтобы добавить в список литературы работу, на которую нет прямой ссылки в тексте, используйте в YAML поле nocite:

  nocite: |
    @неупомянутая_статья_2010, @другая_книга
    @*
  

• Знак @* добавит все источники из .bib-файла.

4 Плагины

4.1 pandoc-ext/multibib

• Репозиторий: https://github.com/pandoc-ext/multibib
• Позволяет добавлять несколько библиографий.

4.2 pandoc-ext/section-bibliographies

• Репозиторий: https://github.com/pandoc-ext/section-bibliographies
• Позволяет размещать библиографию для каждого элемента верхнего уровня (раздел, глава).