# Список источников (/docs/reference/references)

Список использованных источников — обязательный структурный элемент отчёта: здесь оказываются книги,
статьи, сайты, стандарты и репозитории, на которые вы ссылаетесь в тексте.

В `modern-g7-32` этот раздел строится на стандартной функции Typst `#bibliography()`. Пакет заранее
выбирает стиль `gost-r-705-2008-numeric`, печатает заголовок «СПИСОК ИСПОЛЬЗОВАННЫХ ИСТОЧНИКОВ»
как структурный и оставляет вам главное: аккуратно заполнить библиографическую базу.

<Callout type="info">
  Оформление библиографии происходит согласно с [ГОСТ 7.1](/documents/gost-7.1-2003.pdf)
</Callout>

## Быстрый старт

Для вставки списка используйте стандартную функцию Typst `#bibliography()`.

<TypstRender
  code={`
// В тексте отчёта
Отчёт оформлен согласно стандарту ГОСТ 7.32-2017 @gost732.

// В конце отчёта
#bibliography("references.bib")
`}
  image="references-example.png"
  editable={false}
  assets={["references.bib"]}
/>

## Автоматизация и логика шаблона

Шаблон управляет библиографией в соответствии с пунктами [6.16](#6.16) и [6.9.1](#6.9.1):

1. **Порядок следования**: источники располагаются в порядке появления ссылок в
   тексте отчёта (numeric style).
2. **Нумерация**: ссылки в тексте оформляются арабскими цифрами в квадратных скобках, например `[1]`.
3. **Заголовок**: название раздела «СПИСОК ИСПОЛЬЗОВАННЫХ ИСТОЧНИКОВ» оформляется прописными
   буквами по центру страницы и не нумеруется согласно [6.3.2](#6.3.2).
4. **Стиль ГОСТ**: `gost-r-705-2008-numeric` задаётся в пакете через `set bibliography(...)`.

## Параметры функции

Функция `#bibliography` принимает путь к файлу с источниками и необязательные параметры.

<TypeTable
  type={{
  path: {
    description: "Путь к файлу с библиографической базой, например .bib",
    type: "string | array",
  },
  title: {
    description: "Заголовок раздела (шаблон подставляет верный автоматически)",
    type: "content | none",
    default: "auto"
  },
  style: {
    description: "Стиль оформления (по умолчанию используется ГОСТ-овский)",
    type: "string",
    default: "gost-r-705-2008-numeric"
  }
}}
/>

## Работа с источниками

Чтобы сослаться на источник, используйте символ `@` и ключ записи из вашего `.bib` файла:

* `@label` — стандартная ссылка: `[1]`.
* `@label1 @label2` — группа ссылок: `[1, 2]`.

Согласно [6.9.2](#6.9.2), вы можете ссылаться на документ в целом или на его конкретные разделы.
Если нормоконтроль требует конкретный набор полей, заполните их в `.bib`: автор, название, год,
издательство или URL. Пакет отвечает за оформление вывода, но не может восстановить отсутствующие
библиографические данные.

Для ручной подготовки BibTeX-записей можно использовать справочник и генератор
[bibtex.eu на русском языке](https://bibtex.eu/ru/). После генерации всё равно проверьте поля:
ГОСТ-стиль в Typst красиво оформит запись, но не исправит неверного автора, год или URL.

## Требования ГОСТ 7.32-2017

### Состав сведений

<GostQuote page={10} id="5.10.1">
  5.10.1 Список должен содержать сведения об источниках, использованных при составлении отчета.
  Сведения об источниках приводятся в соответствии с требованиями [ГОСТ 7.1](/documents/gost-7.1-2003.pdf), [ГОСТ 7.80](/documents/gost-7.80-2000.pdf), [ГОСТ 7.82](/documents/gost-7.82-2001.pdf).
</GostQuote>

<GostQuote page={10} id="5.10.2">
  5.10.2 Список использованных источников должен включать библиографические записи на документы, использованные при составлении отчета, ссылки на которые оформляют арабскими цифрами в квадратных скобках.
</GostQuote>

### Оформление и ссылки

<GostQuote page={17} id="6.16">
  6.16 Сведения об источниках следует располагать в порядке появления ссылок на источники в тексте
  отчета и нумеровать арабскими цифрами с точкой и печатать с абзацного отступа.
</GostQuote>

<GostQuote page={15} id="6.9.1">
  6.9.1 В отчете о НИР рекомендуется приводить ссылки на использованные источники. При нумерации ссылок на документы, использованные при составлении отчета, приводится сплошная нумерация для всего текста отчета в целом или для отдельных разделов. Порядковый номер ссылки (отсылки) приводят арабскими цифрами в квадратных скобках в конце текста ссылки. Порядковый номер библиографического описания источника в списке использованных источников соответствует номеру ссылки.
</GostQuote>

<GostQuote page={15} id="6.9.2">
  6.9.2 Ссылаться следует на документ в целом или на его разделы и приложения.
</GostQuote>

<GostQuote page={15} id="6.9.3">
  6.9.3 При ссылках на стандарты и технические условия указывают их обозначение, при этом допускается не указывать год их утверждения при условии полного описания стандарта и технических условий в списке использованных источников в соответствии с [ГОСТ 7.1](/documents/gost-7.1-2003.pdf).
</GostQuote>