update 0.4.4

- update документация - промт для ии полу конфигурируемый
2026-09-06 11:04:01 +03:00
parent 638fd38d7f
commit 818a044aa1
26 changed files with 1987 additions and 457 deletions
@@ -0,0 +1,67 @@
+# Кастомные стили (JSON)
+
+Опциональный оверлей оформления поверх пресета `--type` (`mirea` или `pis_custom`).  
+Неуказанные поля остаются у пресета. Стили пишет конвертер в DOCX сам — вручную в шаблон добавлять не нужно.
+
+## Как подключить
+
+Позже побеждает (deep-merge только указанных ключей):
+
+1. Встроенный пресет типа документа
+2. `md2gost.styles.json` рядом с `.md` (если есть)
+3. `--styles путь.json` или путь в GUI: **Настройки → Файлы → Стили JSON**
+
+Файл рядом с exe при первом запуске **не создаётся**.
+
+```bash
+python -m md2gost report.md -o report.docx --type practice --styles examples/md2gost.styles.json
+```
+
+Пример: [`examples/md2gost.styles.json`](../examples/md2gost.styles.json).
+
+## Схема
+
+Два блока. Неизвестный ключ или имя стиля — ошибка.
+
+```json
+{
+  "page": {
+    "left_mm": 30,
+    "right_mm": 10,
+    "top_mm": 20,
+    "bottom_mm": 20
+  },
+  "styles": {
+    "Heading 1": {
+      "alignment": "center",
+      "size_pt": 14,
+      "all_caps": true
+    }
+  }
+}
+```
+
+### `page`
+
+| Ключ | Единица | Смысл |
+|------|---------|--------|
+| `left_mm` / `right_mm` / `top_mm` / `bottom_mm` | мм | Поля страницы |
+
+### Имена стилей
+
+`Normal`, `Heading 1`, `Heading 2`, `Heading 3`, `Caption Figure`, `Caption Table`, `Название таблицы`, `Caption Listing`, `Caption`, `Code`, `Table Text`, `Bibliography`, `Bibliography Heading`, `toc 1`, `toc 2`, `toc 3`, `Footer`, `Hyperlink`, `FollowedHyperlink`, `Space After Table`.
+
+### Поля стиля
+
+| Ключ | Тип / значения |
+|------|----------------|
+| `font_name` | строка |
+| `size_pt` | число (pt) |
+| `bold`, `italic`, `all_caps`, `underline` | bool |
+| `alignment` | `left` \| `center` \| `justify` |
+| `first_line_indent_cm`, `left_indent_cm`, `right_indent_cm` | см |
+| `space_before_mm`, `space_after_mm` | мм |
+| `line_spacing` | `1.0` \| `1.5` |
+| `page_break_before`, `keep_with_next`, `widow_control` | bool |
+
+Не в JSON: табы оглавления (считаются от ширины полосы), отступы списков, формулы из шаблона, цвет (всегда чёрный).