# Приложения (/docs/reference/appendixes)

Приложения — это дополнительные материалы, которые дополняют текст отчёта, но не включаются в основную часть из-за большого объёма или вспомогательного характера.

В шаблоне `modern-g7-32` реализована мощная система автоматизации приложений: они получают буквенную нумерацию, собственные счётчики рисунков и таблиц, а также корректно отображаются в [содержании](./outline.mdx).

<Callout type="info">
  Шаблон автоматически пропускает буквы **Ё, З, Й, О, Ч, Ъ, Ы, Ь** при именовании приложений, как того требует пункт [6.17.4](#6.17.4).
</Callout>

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

Чтобы переключить отчёт в режим приложений, используйте команду `#show: appendixes`. После неё все заголовки первого уровня (`=`) станут приложениями.

<TypstRender
  code={`
// Конец основного текста
#show: appendixes

= Листинги программного кода
Здесь располагается исходный код...

= Схемы алгоритмов
#figure(image("scheme.png"), caption: "Алгоритм поиска") <flow>
// Будет пронумеровано как: Рисунок Б.1
`}
  image="appendix-example-simple.png"
/>

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

При включении режима `#show: appendixes` шаблон выполняет следующие действия:

1. **Смена нумерации**: Заголовки получают формат «ПРИЛОЖЕНИЕ А», «ПРИЛОЖЕНИЕ Б» и т. д. согласно [6.17.3](#6.17.3).
2. **Сброс счётчиков**: Для каждого приложения (заголовка 1 уровня) счётчики рисунков, таблиц и формул обнуляются ([6.17.6](#6.17.6)).
3. **Формат элементов**: Рисунки и таблицы нумеруются с префиксом приложения, например: `Рисунок А.1`, `Таблица В.12`.
4. **Сквозная нумерация страниц**: Сохраняется общая нумерация страниц отчёта.
5. **Содержание**: В [содержание](./outline.mdx) автоматически добавляется слово «Приложение» перед заголовком.

## Функции и параметры

### appendixes

Функция-обертка, которая переключает контекст документа. Обычно вызывается через `#show: appendixes`.

### appendix-heading

Специальная функция для создания заголовков приложений с указанием их статуса (обязательное, информационное и т. д.) согласно [6.17.7](#6.17.7).

<TypstRender
  code={`
#import "@preview/modern-g7-32:0.2.0": appendixes, appendix-heading

#show: appendixes

#appendix-heading("обязательное")[Техническое задание]
`}
  image="appendix-status.png"
/>

<TypeTable
  type={{
  status: {
    description: "Статус приложения (например, 'рекомендуемое', 'справочное')",
    type: "string",
  },
  level: {
    description: "Уровень заголовка",
    type: "integer",
    default: "1"
  },
  body: {
    description: "Текст заголовка",
    type: "content"
  }
}}
/>

## Продвинутое использование

### Вложенные разделы в приложениях

Внутри приложения можно создавать подразделы. Они будут нумероваться с учётом литеры приложения: `А.1`, `А.1.1` и так далее ([6.17.6](#6.17.6)).

### Формулы в приложениях

Формулы также автоматически получают нумерацию с буквенным префиксом в круглых скобках, например: `(Б.1)`.

### Нумерация страниц

Приложения продолжают общую нумерацию страниц отчёта. Буквенная нумерация относится к самим
приложениям и их внутренним элементам, но не запускает новый счётчик страниц. Например, если
основная часть закончилась на странице 42, первое приложение начнётся со следующей страницы
общей последовательности.

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

<GostQuote page={10} id="5.11.1">
  5.11.1 В приложения рекомендуется включать материалы, дополняющие текст отчета, связанные с выполненной НИР, если они не могут быть включены в основную часть.
  В приложения могут быть включены:

  * дополнительные материалы к отчету;
  * промежуточные математические доказательства и расчеты;
  * таблицы вспомогательных цифровых данных;
  * протоколы испытаний;
  * заключение метрологической экспертизы;
  * инструкции, методики, описания алгоритмов и программ, разработанных в процессе выполнения НИР;
  * иллюстрации вспомогательного характера;
  * копии технического задания на НИР, программы работ или другие исходные документы для выполнения НИР;
  * протокол рассмотрения результатов выполненной НИР на научно-техническом совете;
  * акты внедрения результатов НИР или их копии;
  * копии охранных документов.
</GostQuote>

<GostQuote page={10} id="5.11.2">
  5.11.2 Приложения к отчету о НИР, в составе которых предусмотрено проведение патентных исследований, могут быть включены в отчет о патентных исследованиях, оформленный по [ГОСТ 15.011](/documents/gost-15.011-2024.pdf), библиографический список публикаций и патентных документов, полученных в результате выполнения НИР, который должен быть оформлен по [ГОСТ 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={17} id="6.17.1">
  6.17.1 Приложения могут включать: графический материал, таблицы не более формата А3, расчеты, описания алгоритмов и программ.
  Приложение оформляют одним из следующих способов:

  1. как продолжение данного отчета на последующих его листах;
  2. в виде самостоятельного документа (отдельной книги).
</GostQuote>

<GostQuote page={17} id="6.17.2">
  6.17.2 В тексте отчета на все приложения должны быть даны ссылки. Приложения располагают в порядке ссылок на них в тексте отчета.
</GostQuote>

### Оформление заголовков

<GostQuote page={17} id="6.17.3">
  6.17.3 Каждое приложение следует размещать с новой страницы с указанием в центре верхней части страницы слова «ПРИЛОЖЕНИЕ».
  Приложение должно иметь заголовок, который записывают с прописной буквы, полужирным шрифтом, отдельной строкой по центру без точки в конце.
</GostQuote>

<GostQuote page={18} id="6.17.4">
  6.17.4 Приложения обозначают прописными буквами кириллического алфавита, начиная с А, за исключением букв Ё, З, Й, О, Ч, Ъ, Ы, Ь. После слова «ПРИЛОЖЕНИЕ» следует буква, обозначающая его последовательность. Допускается обозначение приложений буквами латинского алфавита, за исключением букв I и O.
  В случае полного использования букв кириллического или латинского алфавита допускается обозначать приложения арабскими цифрами.
  Если в отчете одно приложение, оно обозначается «ПРИЛОЖЕНИЕ А».
</GostQuote>

<GostQuote page={18} id="6.17.5">
  6.17.5 Приложения, как правило, выполняют на листах формата А4. Допускается оформление приложения на листах формата А3.
</GostQuote>

### Нумерация элементов

<GostQuote page={18} id="6.17.6">
  6.17.6 Текст каждого приложения при необходимости может быть разделен на разделы, подразделы, пункты, подпункты, которые нумеруют в пределах каждого приложения. Перед номером ставится обозначение этого приложения.
  Приложения должны иметь общую с остальной частью отчета сквозную нумерацию страниц.
</GostQuote>

### Отображение в содержании

<GostQuote page={18} id="6.17.7">
  6.17.7 Все приложения должны быть перечислены в содержании отчета (при наличии) с указанием их обозначений, статуса и наименования.
</GostQuote>