Rename project to SSAU Generator and restructure content

- Move projects into content/<project>/{docx,pptx} with shared assets/
- Flatten config paths; output = project name in project folder
- Add pptx --init scaffold; remove docx exe build
- Add feature-complete content/example; ignore content/* except example
- Rewrite README and AGENTS.md
This commit is contained in:
2026-10-11 23:25:22 +04:00
parent 35611e2a91
commit bf7816ab7c
80 changed files with 1166 additions and 3432 deletions

View File

@@ -0,0 +1,104 @@
# ВОЗМОЖНОСТИ ГЕНЕРАТОРА
Раздел перечисляет все поддерживаемые элементы и показывает соответствующий
синтаксис Markdown. Нумерация заголовков, рисунков, таблиц и формул выполняется
автоматически.
## Заголовки и абзацы
Заголовок раздела задаётся одним символом `#`, подраздел — двумя `##`, пункт —
тремя `###`. Обычные абзацы разделяются пустой строкой.
### Третий уровень
Полужирный и курсив в оформлении по стандарту отключены, поэтому `**жирный**` и
`*курсив*` выводятся как обычный текст.
## Списки
- первый элемент списка;
- второй элемент с вложенными пунктами:
1. вложенный элемент, выводимый как «а)»;
2. ещё один вложенный элемент.
## Таблицы
Обычная таблица (без подписи и номера):
| Столбец A | Столбец B | Столбец C |
|---|---|---|
| 1 | 2 | 3 |
| 4 | 5 | 6 |
Таблица с подписью и автоматическим номером (ссылка — @tbl:features):
::: table "Возможности оформления" id=features note="Состав приведён условно"
| Элемент | Синтаксис | Результат |
|---|---|---|
| Таблица | `::: table` | Таблица с подписью |
| Рисунок | `::: figure` | Рисунок с подписью |
| Формула | `::: formula` | Нумерованная формула |
| Примечание | `::: note` | Примечание |
| Определения | `::: definitions` | Список терминов |
:::
## Рисунки
Готовое изображение вставляется директивой `figure`; файл ищется относительно
каталога `paths.assets`. Пример — рисунок @fig:diagram:
::: figure "Готовое изображение" id=diagram file=images/diagram.png
а) функциональные блоки;
б) направления связей.
:::
Схема PlantUML рендерится автоматически из исходного файла `.puml` — рисунок
@fig:flow:
::: figure "Схема PlantUML" id=flow file=images/flow.puml
:::
## Формулы
Формула с автоматическим номером и списком пояснений:
::: formula id=efficiency
K = (T_base - T_new)/T_base
:::
::: where
K — коэффициент снижения затрат;
T_base — исходное значение показателя;
T_new — достигнутое значение показателя.
:::
Ссылка на формулу: @eq:efficiency.
## Примечания и определения
::: note
Одиночное примечание к тексту.
:::
::: notes
- первое примечание;
- второе примечание.
:::
::: definitions
Термин — краткое определение термина;
Второй термин — ещё одно определение.
:::
## Перекрёстные ссылки
Записи @fig:diagram, @tbl:features и @eq:efficiency подставляют актуальные номера
рисунка, таблицы и формулы. Ссылки на источники оформляются как [@1] или
[@2, с. 10].
## Разрыв страницы
::: pagebreak
:::
Тематический разрыв `---` также трактуется как разрыв страницы.