PDFTK

Выбор исходных страниц

Оператор cat используется для отбора определенных страниц из исходного файла, которые затем будут включены в итоговый файл. В качестве аргументов оператора задается список диапазонов страниц:

cat Список диапазонов страниц

Отдельные диапазоны разделяются пробелом. Диапазоны указываются следующим образом:

Буква-псевдоним Номер начальной страницы - Номер конечной страницы

Например, для того, чтобы отобрать из файла с псевдонимом "B" первые пять страниц надо записать оператор cat следующим образом:

cat B1-5

В разных диапазонах можно ссылаться на один и тот же псевдоним несколько раз. Например, можно сначала выбрать из файла с псевдонимом "А" страницы с 8-ой по 11-ую, а затем с 1-ой по 3-ю, при этом вставив между ними страницы с 1-ой по 9-ую из файла с псевдонимом "B":

cat A8-11 B1-9 A1-3

В том случае, если требуется включить в диапазон все страницы из файла с указанным псевдонимом, можно в качестве диапазона просто указать псевдоним файла, а номера начальной и конечной страницы опустить. Например, в следующем примере, в отличие от предыдущего, в итоговый файл будут включены все страницы файла с псевдонимом "B":

cat A8-11 B A1-3

В том случае, если из файла с определенным псевдонимом требуется выбрать только одну страницу, можно указать только номер этой страницы:

cat A56

Перед указанием диапазона можно опустить букву-псевдоним. В этом случае выбор страниц будет производиться из первого исходного файла.

Если оператор cat запускается без аргументов, то в итоговый файл будут полностью включены все исходные файлы, один за другим, в том порядке, в котором они заданы в списке исходных файлов.

Служебное слово end

В том случае, если диапазон заканчивается на последней странице файла, можно вместо номера этой страницы указать служебное слово end. Например, с помощью приведенного ниже оператора можно отобрать из файла с псевдонимом "A" страницы с 10-ой по последнюю:

cat A10-end

Страницы в обратном порядке

Номер конечной страницы диапазона может быть больше номера начальной страницы. В этом случае при формировании итогового файла страницы будут выстраиваться в обратном порядке. Например, в следующем примере из файла с псевдонимом "A" будут выбраны в обратном порядке все страницы с 20-ой по 3-ю:

cat A20-3

Для того, чтобы выбрать все страницы файла с псевдонимом "A" в обратном порядке можно воспользоваться следующим оператором:

cat Aend-1

Четные и нечетные страницы

Для того, чтобы из определенного диапазона выбрать только четные или нечетные страницы, используются служебные слова even и odd (соответственно). Эти слова записываются непосредственно после задания диапазона (без пробела). Например, для того, чтобы выбрать из файла с псевдонимом "A" только четные страницы между 18-ой и 30-ой, можно воспользоваться следующим оператором:

cat A18-30even

В следующем примере будут выбраны все нечетные страницы из файла с псевдонимом "B":

cat Bodd

---

Присоединение файлов

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

attach_files Список присоединяемых файлов или PROMPT to_page Номер страницы или PROMPT

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

С помощью параметра to_page задается номер страницы исходного файла, к которой будут приложены файлы. Если вместо номера страницы указано служебное слово PROMPT, этот номер будет запрошен у пользователя непосредственно в процессе выполнения программы.

Примеры:
attach_files table1.html table2.html to_page 6


Параметр to_page может быть опущен. В этом случае присоединяемые файлы будут приложены к исходному файлу без указания конкретной страницы.

---

Извлечение присоединенных файлов

Оператор unpack_files используется для извлечения файлов-вложений, присоединенных к исходному файлу (обрабатывается только один исходный файл). В качестве аргумента оператора задается путь к каталогу, в который следует произвести запись извлеченных файлов:

unpack_files output Каталог для извлечения файлов или PROMPT

Имя каталога может быть опущено. В этом случае файлы будут извлечены в текущий каталог.

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

Пример:
unpack_files output ~/files/

---

Разделение исходного файла на отдельные страницы

С помощью оператора burst можно выполнить разделение исходного файла на отдельные страницы. Каждая страница будет записана в отдельный файл PDF.

По умолчанию имена новых файлов будут иметь следующий формат: pg_0001.pdf, pg_0002.pdf и т.д. Для того, чтобы изменить формат имен файлов можно воспользоваться специальными шаблонами, задаваемыми в блоке output. Шаблоны представляют собой последовательность символов с обязательным включением специальной конструкции:

%0nd
где n - число разрядов в номере

Например, для того, чтобы итоговые файлы имели номера: page-01.pdf, page-02.pdf и т.д., нужно задать следующий шаблон:

page-%02d.pdf

В том случае, если принимается формат итоговых файлов, заданный по умолчанию, блок output может быть опущен.

В текущем каталоге также будет создан текстовый файл "doc_data.txt" с отчетом о выполнении оператора.

---

Автоматическое заполнение PDF форм

С помощью оператора fill_form можно выполнить автоматическое заполнение форм в исходном PDF файле (обрабатывается только один исходный файл). Информация для заполнения форм загружается из специального файла формата FDF или вводится непосредственно в момент выполнения программы.

fill_form Имя файла FDF или  —  или PROMPT

Исходный файл с заполненной формой сохраняется в итоговый файл, указанный в блоке output. После заполнения форма по умолчанию остается интерактивной и доступной для редактирования (например, при открытии этого файла в программе Acrobat Reader). Если в команду исполнения включен блок flatten, то информация для заполнения формы объединяется с pdf-файлом и форма становится недоступной для редактирования.

Если вместо имени файла FDF указано служебное слово PROMPT, информация для заполнения формы будет запрошена у пользователя непосредственно в процессе выполнения программы.

Пример:
fill_form data.fdf

Если исходный FDF-файл включает в себя кроме обычного текста, блоки в формате RTF, то эти блоки при заполнении форм будут включены в PDF как обычный текст. При этом программа установит в PDF файле специальный признак, который указывает на то, что данная часть текста имеет формат RTF. В дальнейшем, при открытии данного файла в программе Acrobat (или Acrobat Reader), в нем будет создано новое поле в формате RTF (при этом нужно помнить, что в этом случае не следует выполнять объединение информации с исходным PDF файлом с помощью блока flatten до того, как файл будет открыт в программе Acrobat или Acrobat Reader). Такой подход позволит корректно отображать PDF файл в программах просмотра, не поддерживающих RTF-поля.

---

Включение водяных знаков в PDF

С помощью оператора background можно включить на каждую страницу исходного файла (обрабатывается только один исходный файл) фоновые водяные знаки (watermark), изображение которых загружается из файла, указанного в атрибутах данного оператора.

background Имя файла PDF с изображением или  —  или PROMPT

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

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

---

Получение метаданных исходного файла

С помощью оператора dump_data можно получить отчет об различных параметрах исходного файла (обрабатывается только один исходный файл): различные статистические данные, метаданные, закладки, метки страниц и т.п. Информация выгружается в текстовом виде в файл, указанный в блоке output. Оператор dump_data не имеет аргументов. Если данный оператор включен в команду запуска программы, то независимо от наличия или отсутствия других операторов, PDF файл создаваться не будет.

---

Получение информации о заполнении форм в исходном файле

С помощью оператора dump_data_fields можно получить отчет о заполнении форм в исходном файле (обрабатывается только один файл). Информация выгружается в файл, указанный в блоке output. Оператор dump_data_fields не имеет аргументов. Если данный оператор включен в команду запуска программы, то независимо от наличия или отсутствия других операторов, PDF файл создаватьс не будет.

---

Изменение метаданных

С помощью оператора update_info можно изменить метаданные исходного файла (обрабатывается только один файл). Загрузка метаданных выполняется их файла, формат которого совпадает с форматом файла, получаемого при выполнении оператора dump_data.

update_info Имя файла с метаданными или  —  или PROMPT

Исходный файл с измененными метаданными сохраняется в итоговый файл, указанный в блоке output.

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