# suai-report — SUAI reports following GOST 7.32-2017 The `suai-report` package typesets student reports (lab works, coursework, practice reports) for Saint Petersburg State University of Aerospace Instrumentation (SUAI, ГУАП) according to GOST 7.32-2017 and GOST 2.105-2019. - The title page reproduces the official university form. - Page layout, headings, table of contents, captions, tables, figures, equations, listings, appendices and the list of sources follow the standard without any configuration. - Line-based block commands keep the source short: every line below `\suaitasks`, `\suaitable`, `\suaieq` or `\suaisources` becomes a list item, a table row or an explanation of a symbol. The package requires XeLaTeX. Times New Roman, Liberation Sans and Liberation Mono are used when installed, otherwise TeX Gyre Termes, Heros and Cursor. ## Files | File | Contents | | --- | --- | | `suai-report.sty` | the package | | `suai-report-template.tex` | an empty report to start from | | `suai-report-demo.tex`, `suai-report-demo.pdf` | a report showing every feature (in Russian) | | `images/scheme.png` | a picture used by the demo | ## Usage ```latex \documentclass[a4paper,14pt]{extarticle} \usepackage{suai-report} \suaisetup{ department = 41, teacher = И. И. Иванов, type = Отчет о лабораторной работе, number = 1, title = Название работы, course = Название дисциплины, group = 4414, student = И. И. Студентов, date = today, } \begin{document} \maketitle \suaitoc ... \end{document} ``` Compile with `latexmk -xelatex` (add `biber` if you use biblatex). Full documentation (in Russian), the `suai` command-line tool that creates and builds reports, and VS Code settings with snippets are in the repository: https://github.com/Echways/suai-report ## Кратко по-русски Шаблон отчёта ГУАП по ГОСТ 7.32-2017 на XeLaTeX: титульный лист по официальному бланку, оформление ставится само, в `main.tex` пишется только текст. Пример — `suai-report-demo.tex` и `suai-report-demo.pdf`, заготовка — `suai-report-template.tex`. Полное описание, команда `suai` и настройки VS Code — в репозитории по ссылке выше. ## License MIT, see `LICENSE`. Copyright (c) 2026 Grigorii Moiseev