# Печать: колонтитулы и параметры страницы

Читать, когда макет готовят к печати: повторяющиеся надписи сверху и снизу, ориентация, поля, масштаб.

## Колонтитулы

У верхнего и нижнего колонтитула по три слота — `left`, `center`, `right` — и общие настройки:

```json
"header": {
  "font": "мелкий",
  "verticalAlignment": "Bottom",
  "startPage": 2,
  "left": "Слева\nвторая строка",
  "center": "Стр. [&НомерСтраницы] из [&СтраницВсего]",
  "right": { "ru": "Справа", "en": "Right" }
},
"footer": {
  "show": false,
  "center": { "formatted": "<b>Итог</> <colorstyle -16>красным</>" }
}
```

| Поле | По умолч. | Описание |
|------|-----------|----------|
| `left`, `center`, `right` | — | Текст слота: строка, объект «язык → текст» или `{ "formatted": … }` |
| `font` | — | Имя шрифта из `fonts` — на весь колонтитул |
| `verticalAlignment` | — | Положение текста по вертикали: `Top`, `Center`, `Bottom` |
| `show` | `true` | Выводить ли колонтитул |
| `startPage` | `1` | Страница, с которой колонтитул печатается |

Текст может быть многострочным (`\n`) и содержать поля `[&НомерСтраницы]`, `[&СтраницВсего]`,
`[&Дата]`, `[&Время]` — платформа подставляет их при печати. `{ "formatted": … }` — форматированная
строка: разметка живёт прямо в тексте (`<b>жирный</>`, `<fontsize 12>`, `<colorstyle -16>`).

## Параметры печати

Плоский объект; имя ключа совпадает с именем свойства в выгрузке:

```json
"printSettings": {
  "pageOrientation": "Landscape",
  "topMargin": 500, "leftMargin": 500, "bottomMargin": 500, "rightMargin": 500,
  "headerSize": 1000, "footerSize": 1000,
  "fitToPage": true, "firstPageNumber": 7
}
```

Допустимые ключи: `pageOrientation`, `scale`, `collate`, `copies`, `perPage`, `topMargin`,
`leftMargin`, `bottomMargin`, `rightMargin`, `headerSize`, `footerSize`, `fitToPage`,
`blackAndWhite`, `printerName`, `paper`, `paperSource`, `pageWidth`, `pageHeight`, `duplexType`,
`pagePlacementAlternation`, `firstPageNumber`. Незнакомый ключ — ошибка. Порядок в объекте не
важен: компилятор пишет свойства в том порядке, что и платформа.

## Чего в DSL нет

Область печати и повторение области при печати (шапка на каждой странице) не описываются:
эти настройки задаются в Конфигураторе и при пересборке чужого макета теряются. Если задача
требует именно их — правьте макет в Конфигураторе, а не через DSL.
