Це чеклист якості, за яким ми готуємо новий генератор Paperka до публікації. Це не загальна обіцянка, що PDF «має надрукуватися». Ми створюємо справжні файли, перевіряємо їхні технічні властивості, рендеримо сторінки назад у зображення та зберігаємо приклади з фіксованим сідом, які кожен може завантажити й порівняти.
1. Створити файл через публічний сценарій
Перша корисна перевірка починається в тій самій точці, де відвідувач натискає завантаження. Ми обираємо формат паперу, макет, налаштування вмісту і, якщо це головоломка, фіксований сід. Це важливо: внутрішній метод малювання може працювати, а маршрут завантаження, назва файла, мова чи передані з форми параметри — ні.
Для цієї перевірки 20 серпня 2026 року ми створили три приклади A4: лабіринт із розв'язком, судоку зі сторінкою відповідей і аркуш змішаних математичних завдань із відповідями. Це звичайні результати генераторів, а не вручну перемальовані рекламні макети.
2. Перевірити документ, а не лише назву
Закінчення .pdf у назві майже нічого не доводить. Ми перевіряємо PDF-заголовок, відкриття файла парсером, очікувану кількість сторінок і розміри кожної сторінки. A4 має приблизно 595 × 842 PDF-пункти, US Letter — 612 × 792. Переплутаний або непомітно масштабований формат є помилкою, навіть якщо на екрані він здається правдоподібним.
Також звіряємо тип відповіді й назву завантаження. Ці дрібниці знаходять ситуації, коли сторінка помилки зберігається з розширенням PDF або експорт ігнорує вибране налаштування.
3. Відрендерити кожну сторінку в зображення
Технічна справність не помітить заголовок, обрізаний полем, крихітний лабіринт у кутку чи ключ відповідей за межами аркуша. Тому готові сторінки PDF перетворюємо на растрові зображення й оглядаємо. Це відбувається вже після генерації: рендер бачить ту саму геометрію, яку побачить PDF-переглядач або система друку.
Під час візуальної перевірки дивимося на зовнішні поля, відступи заголовка й футера, місце для письма, контраст ліній, вирівнювання та розмір головного завдання. У багатосторінковому файлі перевіряємо всі аркуші: сторінка відповідей не повинна успадкувати макет, придатний лише для завдань.
4. Перевірити завдання разом із ключем
Гарний аркуш із неправильною відповіддю гірший за негарний. У математиці задачі звіряються з обчисленими відповідями. Генератор судоку має зберегти правильну заповнену сітку, тоді як гравець бачить лише підказки. Лінія розв'язку лабіринту повинна йти відкритими проходами від старту до фінішу, а не перетинати стіни.
Фіксовані сіди роблять помилки відтворюваними. Якщо варіація 48201 виявила проблему, після виправлення можна згенерувати точно той самий випадок. Випадковість корисна гравцеві; відтворюваність необхідна для налагодження й учителю, якому потрібна ще одна копія тієї самої вправи.
5. Порівняти прев'ю з експортом
Прев'ю — швидка підказка для налаштування, а не окремий продукт. Ми порівнюємо заголовок, складність, орієнтацію, кількість завдань, стан ключа відповідей і головні пропорції з PDF. Піксельна тотожність неможлива й не потрібна: прев'ю адаптується до екрана, а PDF має фізичний розмір. Важливо, щоб показаний у формі вибір очікувано змінював завантажений документ.
Ця перевірка знаходить помилки, які користувач бачить одразу: наприклад, нормальний повнорозмірний PDF поруч із надто малим прев'ю або контрол, який змінюється на екрані, але не доходить до сервісу експорту.
6. Зробити один практичний тест друку, коли важливий масштаб
Рендер знаходить більшість проблем макета, але папір додає поля принтера, контраст тонера й налаштування масштабування. Для шаблонів із вимірюваними інтервалами практична перевірка — один аркуш у масштабі 100% / «Фактичний розмір» на відповідному папері. Після цього лінійкою можна звірити клітинку або відстань між лініями й лише тоді друкувати пачку.
Ми не стверджуємо, що один принтер представляє всі пристрої. Поля драйвера, безрамковий режим і опція «Припасувати» різняться. Саме тому Paperka тримає важливий вміст у безпечній зоні, а гайд про A4 та US Letter пояснює перевірки на боці принтера.
Що ці докази підтверджують, а чого — ні
PDF-приклади дозволяють оглянути справжній результат до роботи з генератором. Чеклист описує повторювані перевірки, а фіксовані сіди відтворюють два приклади головоломок. Це не гарантує сумісності з кожним драйвером і не означає, що одна мітка складності однаково відчуватиметься кожному учневі.
Якщо приклад неправильно виглядає у вашому переглядачі або створений файл не відповідає контролам, напишіть через сторінку контактів і вкажіть інструмент, формат паперу та номер варіації. Так нечітке повідомлення перетворюється на випадок, який можна повторити.