mirror of
https://github.com/StepanovPlaton/SSAUGenerator.git
synced 2026-10-31 10:18:29 +04:00
48 lines
2.2 KiB
Markdown
48 lines
2.2 KiB
Markdown
# 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`.
|