Небольшая работа, в которой используется большинство возможностей MGost. Ниже приведён исходный текст целиком, а затем разбор каждого фрагмента: что он делает и с чем связан.

Структура файлов

├── main.md
├── titul.docx
├── img/
│   └── modules.png
└── code/
    └── service.py

Исходный текст

`include(titul.docx, section)`

`work_interval(01.02.2026, 30.05.2026)`

# **Аннотация
Работа содержит `count_images` рисунка, `count_tables` таблицу, `count_formulas` формулу и `count_sources` источника.

# **Содержание
`table_of_contents`

# **Введение
Цель работы — `store_var_return(цель): разработать сервис учёта заявок`.

# Анализ предметной области
## Существующие решения
Популярность языков приведена на сайте [[TIOBE]](https://www.tiobe.com/tiobe-index/ "TIOBE Index").
Сравнение решений приведено в таблице `mention(only_number): Сравнение решений`.

`table_name: Сравнение решений`

| Решение | Цена |
|---------|------|
| Jira    | 10   |
| Trello  | 5    |

## Постановка задачи
Цель — `var(цель)`. Поток данных показан на `mention: Поток данных`.

```build_graph
digraph "Поток данных" {
    rankdir=LR
    "Пользователь" -> "Сервис" -> "База данных"
}
```

Нагрузка оценивается по формуле `mention(only_number): нагрузка`:

`formula(нагрузка): N=\frac{R}{t}`
`formula_describe(R — число запросов, t — время в секундах)`

# Реализация
## Структура проекта
Схема модулей представлена на `mention: Схема модулей`.

![Схема модулей](./img/modules.png)

Код сервиса приведён в листинге `mention(only_number): Сервис заявок`.
Он оформлен по рекомендациям [[PEP8]](https://peps.python.org/pep-0008/).

# **Заключение
Цель работы — `var(цель)` — достигнута.

# **Список использованных источников
`sources`

# **Приложения
Приложение А - Код сервиса

`page_break`

## **Приложение А - Код сервиса
`listing(Сервис заявок): ./code/service.py`

Разбор

Титульный лист и настройки документа

`include(titul.docx, section)`

`work_interval(01.02.2026, 30.05.2026)`

Титульный лист не пишется в Markdown: его делают в Word по форме кафедры и вставляют макросом include. Аргумент section сохраняет поля и оформление файла, а документ продолжается с новой страницы с полями по ГОСТ.

Макросы, действующие на весь документ, ставятся в самом начале. work_interval задаёт период написания работы. Из него берётся дата обращения к источникам в разделе «Список использованных источников».

Списки по умолчанию оформляются по ГОСТ, поэтому макросы set_list_marker и set_list_digit здесь не нужны.

Аннотация

# **Аннотация
Работа содержит `count_images` рисунка, `count_tables` таблицу, `count_formulas` формулу и `count_sources` источника.

# ** — заголовок без номера, не сдвигающий нумерацию глав (см. заголовки). Счётчики count_* подставляют числа после того, как документ собран целиком, поэтому стоят в начале, а считают всё, что ниже: здесь выйдет «2 рисунка, 1 таблицу, 1 формулу и 2 источника». Граф build_graph тоже считается рисунком.

Содержание

# **Содержание
`table_of_contents`

table_of_contents выводит все заголовки документа, кроме самого «Содержание». Номера страниц Word проставит после обновления полей: Ctrl + A, затем F9 (см. ЧаВо).

Введение и переменные

Цель работы — `store_var_return(цель): разработать сервис учёта заявок`.

store_var_return сохраняет текст в переменную цель и сразу выводит его. Ниже var(цель) подставляет тот же текст в «Постановку задачи» и «Заключение»: поменяв формулировку здесь, вы поменяете её во всём документе.

Глава, источник и таблица

# Анализ предметной области
## Существующие решения
Популярность языков приведена на сайте [[TIOBE]](https://www.tiobe.com/tiobe-index/ "TIOBE Index").
Сравнение решений приведено в таблице `mention(only_number): Сравнение решений`.
  • # Анализ предметной области — первая нумерованная глава, «1». Она начинается с новой страницы, а ## получает номер «1.1».
  • [[TIOBE]](…) — ссылка на источник. В тексте она превратится в [1], а в списке источников — в строку по ГОСТ. Название в кавычках используется вместо заголовка страницы, который MGost иначе скачал бы с сайта.
  • mention с аргументом only_number выводит только номер — «1.1», ведь слово «таблице» уже написано. Упоминание стоит до таблицы: позиция значения не имеет.
`table_name: Сравнение решений`

| Решение | Цена |
|---------|------|
| Jira    | 10   |
| Trello  | 5    |

table_name даёт название следующей таблице. Над ней появится подпись «Таблица 1.1 — Сравнение решений», а название станет именем, по которому её находит mention.

Граф и формула

## Постановка задачи
Цель — `var(цель)`. Поток данных показан на `mention: Поток данных`.

```build_graph
digraph "Поток данных" {
    rankdir=LR
    "Пользователь" -> "Сервис" -> "База данных"
}
```
  • mention без аргумента выводит сокращение вместе с номером: «Рис. 1.1».
  • Блок кода с языком build_graph рисует граф через Graphviz. Имя графа «Поток данных» становится подписью «Рисунок 1.1 — Поток данных». Другие блоки кода MGost не выводит: ГОСТ их не допускает.
Нагрузка оценивается по формуле `mention(only_number): нагрузка`:

`formula(нагрузка): N=\frac{R}{t}`
`formula_describe(R — число запросов, t — время в секундах)`

formula строит формулу из LaTeX с номером «(1.1)» справа, а formula_describe добавляет под ней пояснение «где R — …».

Рисунок и листинг

# Реализация
## Структура проекта
Схема модулей представлена на `mention: Схема модулей`.

![Схема модулей](./img/modules.png)

Вторая глава, поэтому нумерация рисунков начинается заново: «Рисунок 2.1 — Схема модулей». Текст в квадратных скобках — одновременно подпись и имя для mention. Путь указывается относительно main.md (см. ЧаВо).

Код сервиса приведён в листинге `mention(only_number): Сервис заявок`.
Он оформлен по рекомендациям [[PEP8]](https://peps.python.org/pep-0008/).

Упоминание ссылается на листинг из приложения: листинги нумеруются сквозной нумерацией, здесь — «1». Ссылка [[PEP8]] без названия в кавычках: название источника MGost получит со страницы сайта.

Заключение и список источников

# **Заключение
Цель работы — `var(цель)` — достигнута.

# **Список использованных источников
`sources`

Ссылки на источники собираются только до заголовка «Заключение», поэтому в заключении источники не цитируются. sources выводит список из двух источников в порядке первого упоминания.

Приложения

# **Приложения
Приложение А - Код сервиса

`page_break`

## **Приложение А - Код сервиса
`listing(Сервис заявок): ./code/service.py`

Приложения оформляются вручную: перечень в разделе «Приложения», затем каждое приложение заголовком ## **. Заголовок второго уровня не начинается с новой страницы, поэтому перед ним стоит page_break. listing вставляет содержимое service.py в рамке с подписью «Листинг 1. Сервис заявок».

Для работы примера нужны права FILE_READING и TOOLS (граф и листинг). Без них эти элементы пропускаются, а остальной документ собирается.