Как добавить номера страниц в PDF и настроить их положение

Что можно настроить

Нумерация страниц помогает ориентироваться в многостраничном документе, ссылаться на нужный лист в переписке или подготовить PDF к печати. Инструмент принимает PDF в виде закодированных данных, добавляет текст с номером на каждую страницу и возвращает изменённые данные PDF после успешной обработки. Перед началом подготовьте исходный файл и решите, где должен находиться номер: внизу или вверху страницы, слева, по центру либо справа.

Настройка состоит из нескольких независимых параметров. Положение определяет место вставки, начальный номер задаёт число для первой страницы, а формат управляет видом добавленного текста. Если оставить формат по умолчанию, на странице отображается само число. Благодаря отдельному выбору этих параметров можно, например, начать нумерацию с 5 или добавить к числу поясняющий текст.

Пошаговая настройка нумерации

1. Подготовьте PDF-файл. Его содержимое нужно представить как строгую строку Base64. После декодирования данные должны начинаться с сигнатуры PDF. Если строка не является корректными данными Base64 или результат декодирования не имеет сигнатуры PDF, обработка завершится ошибкой.

2. Передайте закодированные данные в поле файла. Не подставляйте сюда обычный текст, имя файла или произвольную строку: инструмент проверяет именно закодированное содержимое документа.

3. Выберите положение номера. Доступны шесть вариантов: снизу слева, снизу по центру, снизу справа, сверху слева, сверху по центру и сверху справа. Если положение не указано, используется нижняя центральная позиция.

4. Укажите начальный номер, если нумерация должна начинаться не с единицы. По умолчанию начальным значением служит 1. Инструмент преобразует введённое значение в целое число, а для следующих страниц увеличивает его последовательно. Поэтому при старте с 5 страницы получают номера 5, 6, 7 и далее. Проверьте значение до запуска: несовместимый или некорректный ввод может привести к ошибке.

5. Задайте формат текста. По умолчанию используется шаблон {page}: он превращается в номер текущей страницы. При необходимости добавьте оформление вокруг номера, например Страница {page}. Учитывайте ограничение: получившийся текст с номером страницы не должен быть длиннее 100 символов, иначе обработка завершится ошибкой.

6. Запустите обработку и сохраните полученный результат. При успешном выполнении инструмент выдаёт данные PDF, в которые добавлены номера страниц. Откройте результат и проверьте первую, последнюю и одну из внутренних страниц: так проще заметить неверное положение, стартовое число или формат.

Как проверить результат и понять ошибку

Успешный результат представляет собой изменённый PDF, а не отдельный список номеров. На каждой странице появляется текст, сформированный из выбранного шаблона и номера страницы. При стандартных настройках это последовательность, начинающаяся с 1, с размещением внизу по центру. При другом начальном значении последовательность начинается с него и продолжает возрастать на каждой следующей странице.

Положение относится к шести поддерживаемым вариантам и не означает автоматическое выравнивание по произвольной точке. Значение вне списка поддерживаемых позиций может вызвать ошибку. Если номера не видны после обработки, проверьте не только исходный PDF, но и выбранный край страницы: номер мог оказаться сверху вместо низа или у другой стороны.

Ошибки до получения результата обычно связаны с входными данными или настройками. Проверьте, что декодированное содержимое действительно начинается с сигнатуры PDF, начальный номер допускает преобразование в целое число, а сформированный текст укладывается в 100 символов. Эти проверки важнее визуального выбора положения: при их нарушении изменённый PDF не будет выдан. Также учитывайте, что добавленный текст накладывается на страницы документа, поэтому перед распространением файла просмотрите места вставки на страницах с плотным содержимым.

Практический пример

Нужно пронумеровать трёхстраничный отчёт с 5 и показать номера в правом верхнем углу.

Для трёхстраничного PDF передайте корректные данные Base64, выберите верхний правый угол, задайте начальный номер 5 и формат Страница {page}, затем запустите обработку.

После успешной обработки получается PDF, где на первой странице отображается «Страница 5», на следующей «Страница 6», а текст размещён в выбранной верхней правой позиции.

Ограничения

• Обработка может завершиться ошибкой при некорректном Base64 или отсутствии сигнатуры PDF после декодирования, неподходящем начальном номере, неподдерживаемой позиции либо тексте с номером длиннее 100 символов.

Частые ошибки

• Причина: в поле файла передана обычная строка или некорректный Base64, поэтому после декодирования не распознаётся сигнатура PDF. Исправление: заново закодируйте байты исходного PDF в строгий Base64 и передайте получившееся значение без постороннего текста.

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

Какие положения номера страницы поддерживаются?

Можно выбрать нижний левый, нижний центральный, нижний правый, верхний левый, верхний центральный или верхний правый вариант. Если ничего не выбирать, номер размещается внизу по центру.

Можно ли начать нумерацию не с единицы?

При пустом значении применяется старт с 1. Если указать другое совместимое значение, оно преобразуется в целое число и становится номером первой страницы, а последующие номера возрастают последовательно.

Можно ли добавить к номеру слово «Страница»?

Да, если после подстановки номера длина сформированного текста не превышает 100 символов. По умолчанию используется {page}, а собственный формат может содержать текст вокруг номера. Более длинный результат приводит к ошибке обработки.