109 lines
5.9 KiB
Markdown
109 lines
5.9 KiB
Markdown
# Приватные подписи и печати
|
||
|
||
Настоящие подписи и печати хранятся только в локальной папке `.private`. Весь каталог исключён из Git, поэтому его можно целиком копировать между рабочими проектами с заменой.
|
||
|
||
## Самый короткий сценарий
|
||
|
||
1. Скопируйте готовую папку `.private` рядом с `main.typ`.
|
||
2. В `main.typ` измените только один параметр:
|
||
|
||
```typst
|
||
#let use-private-assets = true
|
||
```
|
||
|
||
3. Пользуйтесь обычным предпросмотром Tinymist или нажмите `Ctrl+Shift+B`.
|
||
|
||
Чтобы снова получить безопасную сборку без приватных изображений, верните `false`. При `false` Typst вообще не пытается открыть `.private/settings.typ`, поэтому чистый форк работает даже без каталога `.private`.
|
||
|
||
## Структура папки
|
||
|
||
```text
|
||
.private/
|
||
├── settings.typ
|
||
├── scientia/
|
||
│ ├── sign.png
|
||
│ └── stamp.png
|
||
├── technology/
|
||
│ ├── sign.png
|
||
│ └── stamp.png
|
||
├── too/
|
||
│ ├── sign.png
|
||
│ └── stamp.png
|
||
└── executors/
|
||
├── Musikhin.png
|
||
├── Guzeev.png
|
||
├── Fedorov.png
|
||
└── ...
|
||
```
|
||
|
||
Необязательно хранить изображения всех компаний и сотрудников. Настройки должны включать только уже существующие PNG.
|
||
|
||
## Настройки изображений
|
||
|
||
Файл `.private/settings.typ` выглядит так:
|
||
|
||
```typst
|
||
#let settings = (
|
||
companies: (
|
||
scientia: (signature: true, stamp: true),
|
||
technology: (signature: false, stamp: false),
|
||
too: (signature: false, stamp: false),
|
||
),
|
||
signatures: (
|
||
musikhin: (enabled: true, offset: 1.25cm),
|
||
guzeev: (enabled: true, offset: 1.4cm),
|
||
fedorov: (enabled: false, offset: 0.7cm),
|
||
),
|
||
)
|
||
```
|
||
|
||
- `signature` — использовать подпись организации `sign.png`;
|
||
- `stamp` — использовать печать `stamp.png`;
|
||
- `enabled` — использовать PNG сотрудника;
|
||
- `offset` — индивидуальное смещение подписи по вертикали.
|
||
|
||
Полная безопасная заготовка: [examples/private/settings.typ](examples/private/settings.typ).
|
||
|
||
## Если подпись сотрудника ещё не получена
|
||
|
||
Укажите `enabled: false` или совсем не добавляйте сотрудника в `settings.signatures`. В списке исполнителей сохранятся должность, ФИО, линия и свободное место для ручной подписи. Сборка не будет обращаться к отсутствующему PNG и не завершится ошибкой.
|
||
|
||
Typst не умеет заранее проверить наличие файла без попытки его открыть. Поэтому `enabled: false` — явный и надёжный способ обозначить, что подписи пока нет.
|
||
|
||
## Состав исполнителей и роли
|
||
|
||
Состав конкретного отчёта задаётся в `main.typ`:
|
||
|
||
```typst
|
||
#let executors = (
|
||
report-executor("musikhin", role: "Ответственный исполнитель", private-settings: private-settings),
|
||
report-executor("guzeev", role: "Ведущий геомеханик", private-settings: private-settings),
|
||
report-executor("fedorov", private-settings: private-settings),
|
||
)
|
||
```
|
||
|
||
Чтобы изменить роль сотрудника только в текущем документе, замените текст `role`. Если `role` не указан, используется обычная должность из справочника шаблона. Чтобы убрать сотрудника из отчёта, удалите или закомментируйте одну строку.
|
||
|
||
## Справочник сотрудников
|
||
|
||
| Идентификатор | ФИО | Обычная должность | PNG |
|
||
|---------------|-----|-------------------|-----|
|
||
| `musikhin` | Мусихин А.С. | Ответственный исполнитель | `Musikhin.png` |
|
||
| `guzeev` | Гузеев И.А. | Главный геомеханик | `Guzeev.png` |
|
||
| `fedorov` | Федоров Д.А. | Инженер-геомеханик | `Fedorov.png` |
|
||
| `ilyasov` | Ильясов Б.Т. | Технический директор, к.т.н. | `Ilyasov.png` |
|
||
| `khimichev` | Химичев С.С. | Инженер-геомеханик | `Khimichev.png` |
|
||
| `brusnicin` | Брусницын И.В. | Инженер-геомеханик | `Brusnicin.png` |
|
||
| `ozornin` | Озорнин Д.А. | Геолог | `Ozornin.png` |
|
||
| `buhartdinov` | Бухартдинов А.С. | Главный маркшейдер | `Buhartdinov.png` |
|
||
| `tkachenko` | Ткаченко А.С. | Инженер-геомеханик | `Tkachenko.png` |
|
||
| `moshin` | Мошин В.Е. | Гидрогеолог | `Moshin.png` |
|
||
| `mitrokhin` | Митрохин В.А. | Главный гидрогеолог | `Mitrikhin.png` |
|
||
| `luzina` | Лузина М.В. | Геолог | `Luzina.png` |
|
||
|
||
Справочник находится внутри `.template` и синхронизируется через Git. Он не содержит самих подписей или приватных настроек смещения.
|
||
|
||
## Что попадает в Git
|
||
|
||
`.gitignore` исключает каталог `.private/` целиком, включая `settings.typ`. Перед Push всё равно посмотрите список Source Control: настоящих PNG там быть не должно.
|