Igor20264
1a5b35eb54
Python application / build (push) Has been cancelled
- add Local Render Mermaid - add page-starе для указания смещения страниц - add Гиперссылки в документе на списки литературы
61 lines
4.2 KiB
Markdown
61 lines
4.2 KiB
Markdown
# CLI и GUI
|
||
|
||
Движок один: GUI собирает те же параметры, что и аргументы `python -m md2gost`.
|
||
|
||
## Основные команды
|
||
|
||
```bash
|
||
python -m md2gost # GUI
|
||
python -m md2gost --gui report.md
|
||
python -m md2gost report.md -o out.docx --type coursework --check --strict
|
||
python -m md2gost report.docx --check-pages # только проверка вёрстки готового DOCX
|
||
```
|
||
|
||
Справка: `python -m md2gost -h`.
|
||
|
||
## Соответствие флагов и GUI
|
||
|
||
| CLI | Где в GUI | Смысл |
|
||
|-----|-----------|--------|
|
||
| `--type` | Основные → тип | practice, coursework, vkr, PIS_custom, APID_coursework |
|
||
| `-o` / `--output` | Выходной DOCX | путь результата |
|
||
| `--heading-numbering` | Основные | `manual` (цифры в md) / `auto` (Word) |
|
||
| `--toc` | Основные | `native` (поле Word) / `manual` (собирает md2gost) |
|
||
| `--emdash-to-hyphen` | Галочка «—» → «-» | по умолчанию выкл. |
|
||
| `--hr-pagebreak` | Галочка --- → разрыв | по умолчанию `---` игнорируется |
|
||
| `--title` / `--assignment` / `-t` | Настройки → Файлы | титул, задание, шаблон |
|
||
| `--check` / `--check-only` / `--strict` | Галочки проверки ТЗ | замечания по структуре и источникам |
|
||
| `--check-pages` | Проверить вёрстку в Word | эвристика полупустых страниц (Word + pywin32) |
|
||
| `--table-continuation` | Основные | `word` (по умолчанию), `off`, `legacy`, `caption`, `soft` |
|
||
| `--listing-continuation` | Основные | то же для листингов |
|
||
| `--table-repeat-header` | Галочка | шапка на фрагментах после word-split |
|
||
| `--plantuml-jar` / `--kroki-url` | Настройки → Диаграммы | локальный рендер UML / запасной Kroki |
|
||
| `--diagram-fallback` | Диаграммы | `remote` / `local` / `off` (отключает только kroki.io) |
|
||
| `--diagram-format` | Диаграммы | `png` / `svg` |
|
||
| `--diagram-scale` | Диаграммы | качество PNG PlantUML / локального Mermaid (по умолчанию 2) |
|
||
| `--page-start N` | Основные → Смещение страниц | начальный номер PAGE в теле; пусто = сквозной |
|
||
| `--install-chromium` | Диаграммы → «Скачать headless Chromium» | Chromium для Mermaid в `%LOCALAPPDATA%\md2gost` |
|
||
| `--schemes` | файл схем / Шаблоны UML | путь к `md2gost.schemes.json` |
|
||
| `--styles` | Настройки → Файлы → Стили JSON | оверлей `md2gost.styles.json` (также рядом с `.md`); см. [styles.md](styles.md) |
|
||
| `--syntax-highlighting` | (CLI) | подсветка в листингах |
|
||
| `--debug` | меню Дебаг | отладочные данные в документе (на одну сборку в GUI) |
|
||
|
||
## Продолжение таблиц и листингов
|
||
|
||
DOCX не умеет сам писать «Продолжение Таблицы N» только со 2-й страницы. Режим **`word`** (по умолчанию): после сохранения Word COM режет по реальной пагинации. Нужны Windows + Word + pywin32. Без Word: `--table-continuation off` (и то же для листингов).
|
||
|
||
## Меню GUI
|
||
|
||
- **Настройки → Файлы** — шаблон, титул, задание, стили JSON, выходной путь
|
||
- **Настройки → Диаграммы** — PlantUML, Mermaid (Chromium), Kroki, формат, кэш includes
|
||
- **Шаблоны UML** — редактор `md2gost.schemes.json`
|
||
- **Справка → Инструкция / Документация / Схемы / Промпт для ИИ**
|
||
(Документация — встроенный просмотр `docs/*.md`, вшито в exe)
|
||
|
||
## Другие форматы
|
||
|
||
```bash
|
||
python -m md2fodt report.md -o report.fodt # LibreOffice
|
||
# PDF через LaTeX — см. md2latex/
|
||
```
|