mirror of https://github.com/Nikolay-Shirokov/cc-1c-skills.git synced 2026-09-04 17:20:52 +03:00

Files

T

Nick ShirokovandClaude Opus 5 26b38e2ee3 docs(mxl): колоночные раскладки в описании DSL

Инкремент B изменил DSL, а документация осталась от предыдущей версии.

Добавлены columnSets в карту структуры и в таблицу верхнего уровня, раздел про
колоночные раскладки со ссылкой columnSet у области, оговорка что columns: 0 —
допустимая величина (все строки живут в именованных раскладках) и что позиции
колонок проверяются по ширине раскладки своей области.

Из ограничений убран пункт про несколько наборов колонок: теперь поддержаны.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-08-10 19:21:36 +03:00

5.2 KiB

Raw Blame History

name, description, argument-hint, allowed-tools

name

description

argument-hint

allowed-tools

mxl-compile

Компиляция табличного документа (MXL) из JSON-определения. Используй когда нужно создать макет печатной формы

Bash

Read

Write

Glob

/mxl-compile — Компилятор макета из DSL

Принимает компактное JSON-определение макета и генерирует корректный Template.xml для табличного документа 1С. Claude описывает что нужно (области, параметры, стили), скрипт обеспечивает корректность XML (палитры, индексы, объединения, namespace).

Использование

/mxl-compile <JsonPath> <OutputPath>

Параметры

Параметр	Обязательный	Описание
JsonPath	да	Путь к JSON-определению макета
OutputPath	да	Путь для генерации Template.xml

Команда

powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/mxl-compile.ps1" -JsonPath "<путь>.json" -OutputPath "<путь>/Template.xml"

Рабочий процесс

Написать JSON-определение (Write tool) → файл .json
Вызвать /mxl-compile для генерации Template.xml
Вызвать /mxl-validate для проверки корректности
Вызвать /mxl-info для верификации структуры

Если макет создаётся по изображению (скриншот, скан печатной формы) — сначала вызвать /img-grid для наложения сетки, по ней определить границы колонок и пропорции, затем использовать "Nx" ширины + "page" для автоматического расчёта размеров.

JSON-схема DSL

Ниже — компактная структура и ключевые правила, достаточные для типового макета. Полные таблицы полей (все свойства шрифтов, стилей, ячеек), развёрнутый пример и ограничения формата — в reference/dsl-spec.md; нужны не всегда, читать по необходимости.

Краткая структура:

{ columns, page, defaultWidth, columnWidths,
  fonts: { name: { face, size, bold, italic, underline, strikeout } },
  styles: { name: { font, align, valign, border, borderWidth, wrap, format } },
  areas: [{ name, columnSet, rows: [{ height, rowStyle, cells: [
    { col, span, rowspan, style, param, detail, text, template }
  ]}]}],
  namedAreas: [{ name, rows, cols }],
  columnSets: { name: { columns, columnWidths } }
}

Ключевые правила:

page — формат страницы ("A4-landscape", "A4-portrait" или число). Автоматически вычисляет defaultWidth из суммы пропорций "Nx"
name у области в areas необязателен: область без имени — просто кусок сетки, именованной она не станет
namedAreas — области, которые не описываются диапазоном подряд идущих строк: полоса колонок, прямоугольник, ячейка. Тип не указывается, он следует из того, какие оси заданы
columnSet у области — ссылка на раскладку из columnSets, когда группе строк нужны свои ширины колонок; без него действует документная раскладка
rowStyle — автозаполнение пустот стилем (рамки по всей ширине)
empty в строке — шорткат для N подряд пустых строк ({ "empty": 3 } = три {})
Строку можно писать массивом ячеек — позиция из порядка, col не нужен: "текст", "{Имя}" — параметр, ">" — продолжить ячейку слева, "|" — сверху, null — пропуск колонки
col — 1-based позиция колонки
rowspan — объединение строк вниз (rowStyle учитывает занятые ячейки)
Содержимое ячейки задаётся одним из ключей: param — параметр заполнения, text — статический текст, template — текст со вставками [Параметр]

Двухуровневая шапка массивами:

"rows": [
  ["Вид", "Остаток", ">", "Итог"],
  ["|",   "начало",  "конец", "|"],
  ["{Вид}", "{Нач}", "{Кон}", "{Итог}"]
]

5.2 KiB Raw Blame History Unescape Escape