📚 Руководство пользователя

Как пользоваться
Zenlai Docs

Полное руководство от подготовки шаблона до пакетной генерации

Содержание
1. Основы работы 2. Подготовка шаблона 3. Поддерживаемые форматы 4. Заполнение и скачивание 5. Пакетная генерация (CSV) 6. История генераций 7. Советы и лучшие практики 8. Частые вопросы
Раздел 01

Основы работы

Zenlai Docs — это шаблонизатор документов. Идея проста: вы один раз делаете шаблон с метками-ключами, а потом за секунды генерируете заполненные документы — без копирования, без ручной замены.

1
Создайте шаблон
В любом документе расставьте ключи-плейсхолдеры в формате [ключ]
2
Загрузите на сайт
Система автоматически найдёт все ключи и предложит поля для заполнения
3
Заполните и скачайте
Введите значения для каждого ключа и получите готовый документ в нужном формате
Раздел 02

Подготовка шаблона

Откройте ваш документ в любом редакторе и вставьте ключи в формате [название] там, где должны быть переменные данные.

Договор №[номер_договора] от [дата] Исполнитель: [ФИО_исполнителя] Заказчик: [название_компании] Стоимость работ составляет [сумма] рублей.
✦ Правила именования ключей

Используйте только латинские буквы, цифры и знак подчёркивания, либо кириллицу. Пробелы внутри ключа не поддерживаются. Ключ не должен быть длиннее 60 символов.

Ключи работают везде в документе:

✓
В основном тексте
✓
В таблицах
✓
В колонтитулах (шапке и подвале страницы)
✓
Многократно — один и тот же ключ можно использовать несколько раз
Раздел 03

Поддерживаемые форматы

Zenlai Docs принимает несколько форматов на вход и умеет отдавать результат в трёх форматах.

Форматы загрузки (входные):

ФорматОписание
📝 .docxWord 2007+ — основной и рекомендуемый формат
📃 .txtПростой текст — конвертируется в .docx автоматически (без стилей)

Формат скачивания (выходной):

ФорматЛучше для
📝 DOCXРедактирования в Word, LibreOffice и любом другом редакторе
💡 Нужен PDF?

Скачайте готовый .docx и сохраните как PDF прямо в Word (Файл → Сохранить как → PDF) или LibreOffice.

Раздел 04

Заполнение и скачивание

1
Откройте шаблон
В личном кабинете нажмите «Заполнить →» на нужном шаблоне.
2
Выберите формат
DOCX, PDF или ODT — переключатель над полями.
3
Заполните поля
Каждый найденный ключ — отдельное поле. Незаполненные поля станут пустыми строками в документе.
4
Нажмите «Скачать»
Готовый документ сразу скачается на ваш компьютер.
✦ Подсказка

Если вы уже заполняли этот шаблон раньше, поля будут предзаполнены из последней генерации — удобно для небольших изменений.

Раздел 05

Пакетная генерация (CSV)

Нужно создать 50 договоров для разных клиентов? Не заполняйте форму 50 раз — используйте пакетную генерацию.

1
Подготовьте CSV файл
Первая строка — заголовки, совпадающие с названиями ключей шаблона (без скобок). Каждая следующая строка — один документ.

Пример CSV для шаблона с ключами [ФИО], [дата], [сумма]:

ФИО,дата,сумма Иванов Иван Иванович,01.07.2025,50000 Петрова Анна Сергеевна,01.07.2025,75000 Сидоров Пётр Алексеевич,15.07.2025,30000
2
Перейдите на вкладку «Пакетная генерация»
На странице шаблона → вкладка «📦 Пакетная генерация».
3
Загрузите CSV и нажмите кнопку
Выберите выходной формат и нажмите «Сгенерировать». Вы получите ZIP-архив с N документами.
⚠ Лимиты

Максимум 500 строк за один запрос. Кодировка файла — UTF-8 (с BOM или без). Разделитель — запятая.

Раздел 06

История генераций

Каждый раз когда вы заполняете шаблон, система сохраняет введённые значения. Это позволяет:

→
Видеть предыдущие данные
Вкладка «🕓 История» на странице шаблона показывает последние 5 генераций с датой и всеми заполненными значениями.
→
Предзаполнение полей
При открытии формы заполнения поля автоматически подставляются из последней генерации.
Раздел 07

Советы и лучшие практики

💡 Используйте понятные имена ключей

[дата_договора] лучше, чем [d] — особенно при пакетной генерации, когда нужно понять, какую колонку CSV назвать.

💡 Один ключ — несколько мест

Один и тот же ключ можно вставить в 10 мест документа. При замене он заменится везде сразу.

💡 Шаблон для PDF

Если вам нужен красивый PDF — оформите шаблон в Word с нужными шрифтами и стилями, загрузите как .docx, а при генерации выберите формат PDF.

💡 CSV для пакетной: используйте Excel

В Excel: Файл → Сохранить как → CSV UTF-8 (с разделителями-запятыми). Убедитесь, что первая строка — заголовки, совпадающие с именами ключей.

Раздел 08

Частые вопросы

Ключ не нашёлся в документе — почему? ▼
Проверьте: в ключе нет пробелов внутри скобок, скобки именно квадратные [ ], а не круглые или фигурные. Также убедитесь, что текст не разбит на несколько «runs» в Word — иногда при наборе Word разбивает слово на части с разным форматированием. Попробуйте удалить ключ и написать его заново.
Сохраняется ли моё форматирование при замене? ▼
Да, для большинства случаев форматирование сохраняется. Текст вставляется в тот же «run» (фрагмент текста) с теми же стилями. Если ключ разбит Word на несколько runs — форматирование может упроститься до стиля первого фрагмента.
Могу ли я переименовать шаблон или обновить файл? ▼
Пока только через удаление и повторную загрузку. Функция редактирования шаблонов в разработке.
Что будет с незаполненным ключом? ▼
Ключ будет заменён пустой строкой. Если вы хотите оставить исходный текст [ключ] — не загружайте его в сервис, а добавьте уже в скачанный документ.
Видят ли мои документы другие пользователи? ▼
Нет. Все шаблоны привязаны к вашему аккаунту и недоступны другим пользователям.
Какой максимальный размер файла? ▼
Технически ограничений нет, но очень большие файлы (более 50 МБ) могут обрабатываться долго, особенно с множеством изображений.
Попробовать сейчас →