# lab_gen — генераторы отчётных документов

Монорепозиторий из двух независимых Node.js-генераторов, которые собирают
отчётные документы из обычного Markdown по заданному шаблону/стандарту.

```
lab_gen/
├── docx/   # генератор DOCX по СТО 02068410-004-2018 (отчёт)
├── pptx/   # генератор PPTX по шаблону Самарского университета (презентация)
└── tools/  # общие внешние инструменты (plantuml.jar)
```

## docx/ — DocxGenerator

Автономный генератор отчётов **DOCX** из Markdown по дизайну
СТО 02068410-004-2018. Поддерживает титульный лист, оглавление, таблицы, рисунки
(включая PlantUML), формулы, список источников и приложения.

```powershell
cd docx
npm install
npm run check      # проверка конфига и ссылок
npm run generate   # собрать report.docx
```

Полная документация — [docx/AGENTS.md](docx/AGENTS.md).

## pptx/ — lab-gen-pptx

Генератор презентаций **PPTX** из Markdown по фирменному шаблону Самарского
университета (16:9, синий фон, логотип, фирменный шрифт). Задники и правила
оформления извлечены из `presentation_16.pptx` и заданы в `config.yaml`.

```powershell
cd pptx
npm install
npm run check      # проверка конфига и ссылок
npm run generate   # собрать presentation.pptx
```

Формат слайдов, схема конфига и CLI описаны в [pptx/AGENTS.md](pptx/AGENTS.md).

## Требования

- Node.js 18+ (для локальной сборки).
- Java 11+ и `tools/plantuml.jar` — для рендеринга схем PlantUML (`.puml`)
  в обоих генераторах. Путь задаётся ключом `plantuml.jar` в `config.yaml`.