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

Используйте эти знания для программирования интерактивного сетевого сеанса заполнения формы, пример которого показан на рисунке (посетите веб-страницу http://ymw.pdfliacks.com/form_session/, чтобы посмотреть этот пример и загрузить исходный РНР-код).

Подготовка окна

Чтобы предоставить данные серверу, PDF-форма должна отображаться в веб-браузере. Удобнее отображать ее в HTML-окне. Это позволяет сделать форму с HTML-командами и гиперссылку запасным выходом, чтобы пользователь не чувствовал себя попавшим в ловушку. Это также показывает пользователю, что это не старый PDF-документ, т. к. многие считают PDF-документ предназначенным только для загрузки и распечатки. Мало того, что он будет отличаться по виду, окно также скроет URL PDF-документа и предотвратит рефлексивную загрузку.

Ниже представлен код HTML-окна, используемого в примере на веб-странице http://www.pdfhacks.com/form_session/. Обратите внимание, что для описания формы он использует PDF+FDF URL, чтобы воспрепятствовать выходу PDF-документа из окна.

Создание интерактивной PDF-формы

В разделе представлены некоторые идеи по созданию дизайна интерактивной PDF-формы. Имейте в виду, что форма может иметь любое количество PDF-полей, и эти поля можно скрыть от пользователя или разрешить только их чтение. Сценарий forge_fdf дает возможность установить эти флажки так, как необходимо, добавлением имени поля к строкам $fields_hidden или $fields_readonly.

• Используйте поля скрытого текста, чтобы хранить информацию о сеансе формы и состоянии.
• Если форма имеет разделы, которые требуют отдельной серверной обработки, добавьте кнопку Submit Form (Представить форму) для каждого раздела. Показывайте только одну кнопку, скрывая все другие.
• Не забудьте добавлять в конце действия представления формы #FDF, например, update_state.php#FDF.

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

Измените порядок вкладок поля формы. В Acrobat 6.0.1 командой меню Tools\ Advanced Editing (Сервис\Дополнительное редактирование) активизируйте инструмент Select Object Tool (Инструмент выделения объекта), выберите Advanced\Forms\Fields\Set Tab Order (Дополнительно\Формы\Поля\Установить порядок вкладок), а затем щелкните на каждом поле в нужном порядке. В Acrobat 5 активизируйте Form Tool (Инструмент формы), выбирая команды Tools\Forms\Fields\Set Tab Order (Сервис\Формы\Поля\Установить порядок вкладок), а затем щелкните на каждом поле в нужном порядке.

• После завершения пользователем работы с разделом его поля должны быть доступны только для чтения, как и поля, содержащие результаты серверных вычислений.
• Распределите поля между двумя-тремя частями PDF-страницы, чтобы они не загромождали страницу формы.
• Преобразуйте форму из нескольких страниц в PDF-форму на одной странице.
• Создайте текстовые поля для выдачи пользователю сообщений, предназначенных только для чтения. Если пользователь представляет недопустимые данные полей, обработайте форму снова и выдайте соответствующее сообщение. При создании этих полей сообщений в Acrobat обозначьте их цветом, чтобы они отличались от полей данных. Изменить текст сообщения можно, используя FDF-файл.

В сетевом примере на веб-странице http://www.pdfhacks.com/form_session/ использованы некоторые из этих методов

Начало, середина, конец

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

Вход в форму.

Начните сеанс, используя PDF +FDF URL, чтобы открыть форму. Например:

http:localhost/form_session.pdf#FDF=http:localhost/update_state. php?reset=1

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

Ответ на представление данных. При каждом представлении формы обновляйте состояние сеанса, а затем ответьте с помощью FDF-файла. Используйте его для обновления вида формы, чтобы активизировать или скрыть поля, а также для обновления текста в поле, предназначенном только для чтения, вместе с расчетными данными или сообщениями пользователю. Опустите ключ /F ($pdf_form_url в forge_fdf) используемый в FDF-файле, если не готовы выйти из этого сеанса.

Выход из формы.

Когда сеанс работы с формой завершен, выйдите из него, используя FDF Forward. Это FDF-файл содержит только ключ /F ($pdf_form_url в forge_fdf). Установите ключ /F в URL HTML-страницы или сценария. Этот новый адрес заменит PDF-форму в браузере пользователя.

Выполнение кода

Посетите веб-страницу http://www.pdfhacks.com/form_session/ и посмотрите рабочий пример этой модели. Загрузите с этой страницы архив form_session-L1.zip, чтобы изучить PHP-сценарии и PDF-формы. Пользователи IndigoPerl могут распаковать form_session-1.1.zip в каталог: C:\indigoperl\apache\htdocs\pdf_hacks_form_session-1.1\, а затем выполнить пример на своем компьютере, указывая браузерам ссылку на http://localhost/pdf_ hacks/form_session-1.1/start.html.

Преобразуйте данные в формат FDF для объединения их с PDF-формой программами Adobe Acrobat или Adobe Reader. Как было показано в разделе «Сопровождение заполненных PDF-форм», можно распространять заполненные формы в интернете, используя FDF-данные, которые содержат URL PDF-формы. После получения FDF-данных программа Acrobat (или Reader) откроет форму, а затем заполнит ее. Следующая проблема — насколько просто создать FDF-данные на сетевом сервере.

Справочник по формату PDF описывает формат FDF в мельчайших подробностях, a Adobe предлагает бесплатный FDF-инструментарий (http://partners.adobe.com/asn/acrobat/forms.jsp). FDF-данные несложно создать с помощью языка сетевого программирования.

Здесь предлагается сценарий, написанный на языке РНР. Он конвертирует данные формы в FDF-файл, подходящий для заполнения PDF-формы.

Для создания или анализа FDF-данных в Java используйте классы FdfWriter и FdfReader в iText (http://www.lowagie.com/iText/).

Сложные формы могут потребовать высокоуровневого Adobe PDF-инструментария. Большинство форм требует простого приведения данных полей в соответствие с FDF-синтаксисом. Используйте для этой цели сценарий forge_fdf. В примере раздела «Сопровождение заполненных PDF-форм» показан образец простого FDF-файла.

Вместо использования универсальной FDF-функции или библиотеки можно применить экспорт FDF-файла из формы, а затем преобразовать его в шаблон. Замените значения формы переменными или другими метками-заполнителями. Используйте этот шаблон в своей форме после заполнения его переменными с пользовательскими данными. Сценарий forge_fdf содержит функции для кодирования PDF-строк и имен, которые могут быть полезными при заполнении шаблона.

Создание FDF-файла с помощью сценария forge_fdf

Передайте данные формы и ее URL сценарию forge_fdf, и он возвратит соответствующий ей FDF-код как строку. Создайте с ее помощью FDF-файл или используйте ее непосредственно в браузере клиента с заголовком Content-type: application/vnd.fdf. Соответствующий пример будет приведен ниже.

Необходимо помнить некоторые характерные особенности формата FDF при передаче параметров сценарию forge_fdf.

$pdf_form_url

Обеспечивает URL PDF-формы (или имя файла), если не планируется передавать эти FDF-данные как часть большего URL, который уже ссылается на PDF-форму. Например, если FDF-данные будут использоваться пользователем следующим образом:

http://localhost/fine_form.pdf#FDF=http://localhost/fine_data.fdf,

то в качестве параметра $pdf_form_url передается пустая строка. Чтобы выйти из PDF-формы и заменить ее HTML-страницей в браузере пользователя, используйте настройку параметра $pdf_form_url для URL своей HTML-страницы.

$fdf_data_strings

Загружает текст и данные полей со списком в эту строку. Это должен быть массив строковых имен полей, отображенных в их значениях. Если хотите, чтобы поле формы было скрыто или предназначалось только для чтения, добавьте его имя к параметрам $fields_hidden или $fields_readonly.

$fdf_data_names

Загружает в строку данные переключателя и кнопки выбора. Это должен быть массив строковых имен полей, отображенных в их значениях. Часто значения true и false соответствуют чувствительным к регистру строкам Yes и Off. Если хотите, чтобы поле формы было скрыто или предназначалось только для чтения, добавьте его имя к параметрам $fields_hidden или $fields_readonly.

$fields_hidden

Добавьте имя поля к этой строке, если хотите скрыть его. Любое поле, перечисленное здесь, также должно быть указано в параметрах $fdf_data_strings или $fdf_data_names.

$fields_readonly

Добавьте имя поля к этой строке, если не хотите, чтобы пользователь вносил изменения в его данные. Любое поле, перечисленное здесь, также должно быть указано в параметрах $fdf_data_strings или $fdf_data_names.

Следующий сценарий использует forge_fdf для обработки FDF-данных, которые должны заставить браузер пользователя открыть http://localhostfform.pdf и настроить его поля.

Посетите веб-страницу http//www.pdfhacks.com/form_session/, чтобы увидеть более сложный пример работы сценария forge_fdf. Исправьте сетевой пример или загрузите исходный PHP-код с этой веб-страницы.

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

Код

Скопируйте этот код в файл, названный forge_fdf.php, и включите его в свои PHP-сценарии. Или адаптируйте этот алгоритм под свой любимый язык. Посетите веб-страницу http://www.pdfhacks.com/forge_fdf/, чтобы загрузить последнюю версию.

3аполняйте сетевые PDF-формы известными данными. Для поддержки данных формы необходимо показывать их текущее состояние пользователю. Это дает ему возможность просмотра данных, обновления отдельного поля и передачи этого изменения серверу. В HTML-форме можно настроить значения полей во время работы пользователя. Чтобы заполнять поля PDF-формы данными, используйте формат Forms Data Format (Формат данных формы, FDF), как показано на рисунке.

FDF – формат данных формы

Справочник по формату PDF описывает файловый формат FDF (Формат данных формы). Его синтаксис использует для организации данных PDF-объекты. В качестве примера откройте PDF-форму в программе Acrobat и заполните некоторые поля. Экспортируйте эти данные в формате FDF, выбирая команды Advanced\Forms\Export Foms Data (Дополнительно\Формы\Экспортировать данные формы) в Acrobat 6 или File\Export\Form Data (Файл\Экспорт\Данные формы) в Acrobat 5. Форма  преобразуется в FDF-файл, который перечисляет поля в виде пар имя/значение, а затем ссылается на PDF-форму с помощью имени файла.

Раздел «Заполнение PDF-форм» предлагает РНР-сценарий для создания FDF-файла.

Для тех, кому нравится язык XML, существует инструмент XFDF — основанный на XML набор FDF-функций. Версии 5 и 6 программы Acrobat поддерживают XFDF. Его MIME-типом является application/vnd.adobe.xfdf.

Пользователи могут сохранять и управлять данными PDF-формы, используя FDF-файлы. Посетите веб-страницу http://segraves.tripod.com/index3.htm, чтобы посмотреть примеры. При работе с заполненными формами пользователь никогда не видит и не обрабатывает непосредственно FDF-файл.

Существует два способа автоматического заполнения сетевой PDF-формы данными. Можно использовать FDF-данные, которые ссылаются на PDF-форму, или создать URL, который ссылается как на PDF-форму, так и на FDF-данные.

Использование FDF-данных для заполнения форм

Один из способов автоматического заполнения сетевой формы состоит в использовании заполненного данными FDF-файла (с MIME-типом application/vnd.fdf). Браузер пользователя открывает программу Acrobat/Reader и передает ей FDF-данные. Acrobat/Reader читает их, чтобы определить местонахождение PDF-формы, загружает и отображает ее, а затем заполняет поля, используя FDF-файл. Рассматриваемая PDF-форма должна быть доступна с вашего сервера, и FDF-данные должны ссылаться на этот URL, используя ключ /F, как показано в предыдущем примере.

Убедитесь, что сервер посылает соответствующий заголовок Content-type: application/vnd.fdf при использовании FDF-файлов. Или пошлите заголовок непосредственно из сценария.

Эта методика проста, но имеет ограничения. Во-первых, не все браузеры знают, как обрабатывать FDF-данные. Во-вторых, она не всегда работает с HTML-окном. Использование следующей методики решает эти проблемы.

Объединение URL PDF-формы и FDF-файла для заполнения формы

Другой способ автоматического заполнения сетевой PDF-формы — добавление в конец URL PDF-формы ссылки на FDF-файл. В этом случае файл должен опустить ссылку к форме (ключ /F). Когда пользователь следует ссылке, программа Acrobat/Reader открывает PDF-форму и заполняет ее поля, используя данные FDF-файла. Ссылкой на PDF-файл должен быть его полный URL:

http://localhost/flne_form.pdf#FDF=http://localhost/fine_data.fdf

Или же вместо файла она должна ссылаться на PDF-генерирующий сценарий, например:

http://localhost/fineJorm.pdf#FDF=http://localhost/fdf_data.php ?t=42

Используйте эту методику ссылки на PDF-форму и на PDF-данные в одном URL при отображении заполненных форм в HTML-виде.

Используйте сервер, чтобы проверить эти способы. Windows-пользователи могут загрузить инсталлятор IndigoPerl с сайта http://www.indigostar.com.IndigoPerl — это инсталлятор Apache для Windows, поддерживающий языки Perl и РНР.

Усовершенствование метода

Файл формата FDF может содержать информацию, описывающую PDF-форму. Используйте предыдущие методы для динамического добавления аннотации к сетевой PDF-форме. Создайте примеры FDF или XFDF-файлов, открывая форму в Acrobat и добавляя аннотации. Затем выберите Document\Export Comments (Документ\Экспорт комментариев) в Acrobat 6 или File\Export\Comments (Файл\Экспорт\Комментарии) в Acrobat 5.

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

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

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

При добавлении к PDF-документу заполняемых полей формы пользователи смогут заполнить ее, используя программы Acrobat или Adobe Reader. После этого они все еще должны распечатывать ее и отправлять по почте. Пользователи Acrobat могут сохранить заполненную PDF-форму, а пользователи Adobe Reader этого сделать не смогут.

При добавлении полей заполняемой формы и кнопки Submit (Предоставить), которая отправляет эти данные на сервер, вы присоединитесь к информационной революции. Сервер сможет в интерактивном режиме проверять правильность данных пользователя, обеспечивать обратную связь, записывать информацию в базу данных и предоставить пользователю возможность сохранения копии PDF-формы.

Но это позже. Сначала создайте форму, которая предоставляет данные серверу. Последующий метод взлома будет основываться на ней. Посетите сайт http://pdfhacks.com/form_session/ и посмотрите примеры интерактивных PDF-форм, а также загрузите пример PDF-формы и PHP-код с этого сайта.

Создание формы

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

PDF-формы могут быть мощными JavaScript-nporpaммами, но здесь сценарии использоваться не будут. Мы создадим PDF-формы, которые позволят всю работу делать серверу. Это позволит программировать логику формы с помощью любого языка или интерфейса базы данных.
Поля PDF-формы практически соответствуют полям HTML-формы, как показано в таблице. Добавьте их к своей форме, используя один или несколько инструментов Acrobat.

Таблица. Сравнение типов PDF-полей с типами HTML-полей

В Acrobat 6 существует отдельный инструмент для каждого типа поля формы. Откройте эту панель инструментов командой Tools\Advanced Editing\Forms\Show Forms Toolbar (Сервис\До-полнительное редактирование\Формы\Показать панель инструментов формы). Выберите инструмент, например Text Field (Текстовое поле), щелкните на нем и перетащите прямоугольник в местоположение поля. Отпустите кнопку мыши — откроется диалоговое окно Field Properties (Свойства поля). Выберите вкладку General (Общие) и введите имя поля. Это имя идентифицирует данные поля при передаче серверу. Настройте вид поля и его поведение, используя другие вкладки. Нажмите Close (Закрыть). Поле создано.

В Acrobat 5 используется инструмент Form (Форма) для создания любого поля формы. Щелкните на нем и перетащите прямоугольник в местоположение поля. Отпустите кнопку мыши — откроется диалоговое окно Field Properties (Свойства поля). Выберите нужный тип поля, например Text (Текст), и введите его имя. Это имя идентифицирует данные поля при передаче серверу сети. Настройте вид поля и поведение, используя другие вкладки. Нажмите ОК. Чтобы изменить свойства поля, используя инструмент Form, дважды щелкните на нем кнопкой мыши.

Позаботьтесь о совместимости PDF-формы со старшими версиями программ Acrobat и Adobe Reader.

Чтобы загружать данные формы на сервер, PDF-форма должна иметь кнопку Submit Form (Предоставить форму). Создайте PDF-кнопку, откройте вкладку Actions (Действия), а затем добавьте действие Submit a Form (Предоставить форму) в Acrobat 6 или Submit Form (Предоставить форму) в Acrobat 5 событию Mouse Up (Щелчок мышью), как показано на рисунке.

Отредактируйте свойства действия, включив в него URL своего сценария; они должны соответствовать атрибуту action HTML-формы. Добавьте в конец этого URL символы #FDF:

http://localhost/pdf_hacks/echo.php#FDF

Настройте опцию Field Selection (Выбор поля) для включения полей, которые эта кнопка должна передавать серверу; наиболее безопасным является вариант All Fields (Все поля). Определите опцию Export Format (Формат экспортирования) как HTML, и PDF-форма передаст свои данные, используя HTTP-метод post.

После окончания работы сохраните свою PDF-форму и протестируйте ее.

Сделайте кнопки формы непечатаемыми. Откройте свойства кнопки и выберите вкладку General (Общие) в Acrobat 6 или Appearance (Вид) в Acrobat 5. В Common Properties (Общие свойства) установите значение Form Field (Поле формы) как Visible but Doesn’t Print (Показывать, но не печатать). Нажмите ОК.

Установка сетевого сервера Apache в Windows

Чтобы проверить интерактивную PDF-форму, необходимо иметь доступ к серверу. Многие из этих методов взлома используют РНР-сценарии, выполняемые на стороне сервера, поэтому он должен поддерживать язык РНР (http://www.php.net). Windows-пользователи могут загрузить инсталлятор сетевого сервера Apache (http://www.apache.org) под названием IndigoPerl с сайта IndigoSTAR (http://www.indigostar.com). Он содержит РНР и Perl-модули, поэтому позволяет выполнить этот метод взлома. Сервер Apache и язык РНР — бесплатное программное обеспечение.

Посетите веб-страницу http://www.indigostar.com/indigoperl.htm и загрузите файл indigoperl-2004.02.zip. Разархивируйте его во временный каталог, а затем дважды щелкните на файле setup.bat, чтобы выполнить установку. На запрос о каталоге установки нажмите клавишу Enter, чтобы выбрать значение по умолчанию: C:\indigoperl\.

После установки Indigo Perl откройте веб-браузер и укажите ему на http://localhost/. Это URL вашего локального сервера, и браузер должен отобразить Web Server Test Page (Страница тестирования сетевого сервера) со ссылками к документации. При опросе http://localhost/ Apache обращается к файлу index.html в каталоге C:\indigoperl\apache\htdocs\. Создайте каталог pdf_hacks в каталоге htdocs и используйте это местоположение для PHP-сценариев. Обратитесь к этому каталогу из своего браузера с помощью URL: http://localhost/pdf_hacks/.

Тестирование PDF-формы

Создайте текстовый файл, назовите его echo.рhp и поместите в него следующий сценарий. IndigoPerl-пользователи могут сохранить его в каталоге C:\indigoperl\apache\htdocs\pdf_hacks\echo.php. Этот РНР-сценарий возвращает переданные данные формы вашему браузеру. Создайте кнопку PDF Submit, которая отправляет данные по URL сценария (например, http://localhost/pdf_hacks/echo.php#FDF), как было описано ранее.

<?php // echo.php возвращает данные, которые мы получили
echo ‘<h2>GET Data</h2>';
fоreach ( $_CET as $key => $value ) {
echo ‘<p>Key: ‘.$key.’, Value: ‘.$value. ‘<p>';
}
echo ‘<h2>P0ST Data</h2>';
foreach( $_P0ST as $key => $value ) {
echo ‘<p>Key: ‘.$key.’, Value: ‘.$value. ‘<p>';
}

PDF-форма правильно взаимодействует с сервером только тогда, когда отображается в веб-браузере. Поэтому перетащите форму в браузер, заполните некоторые поля, а затем щелкните на кнопке Submit (Предоставить). PDF-форма должна быть заменена на экране сообщением, подобным показанному на рисунке.

Если перетаскивание PDF-формы в браузер Mozilla открывает PDF-форму вне окна браузера, то убедитесь в том, что поддержка языка Java разрешена, выбрав команду меню Edit\Preferences\Advanced (Правка\Параметры настройки\Дополнительно). После включения поддержки Java перезапустите браузер Mozilla и повторите попытку.

Регистрация щелчков на страницах встроена в шаблон pdfskins_classic_php. После его распаковки активизируйте регистрацию щелчков, редактируя файл script.include и определяя $log_hits=true. Это можно сделать в любое время, до или после создания обложки для PDF-документа. Щелчки на страницах регистрируются в текстовых файлах, расположенных в том же каталоге, что и PDF-документы с обложками, поэтому сервер должен иметь разрешение для записи в этот каталог.

Если страница называется pg_0025.pdf то ее файл регистрации щелчков называется pg_0025.pdf.hits. Каждый щелчок добавляет к файлу одну строку. Каждая строка включает IP-номер, идентифицирующий посетителей.

После создания обложки PDF-документа и файла регистрации щелчков посетите сайт http://www.pdfhacks.com/skins/ и загрузите архив hit_report.php-1.0.zip. Распакуйте его PHP-файл и скопируйте на свой сервер.

Если PDF-документ с обложкой расположен в каталоге: http://pdfhacks.com/eno/skinned_php/, то передайте его местоположение сценарию hit_report следующим образом:

http://pdfhacks.com/hit_report.php?pdf=/eno/skinned_php

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

Для разделов, которые состоят из нескольких страниц, щелчки на страницах суммируются в счетчике щелчков для раздела. Однако сюда не включается число щелчков для подразделов. Если заголовок подраздела находится на той же странице, что и заголовок раздела, используется тот же счетчик. Сценарий hit_report идентифицирует их, окрашивая эти разделы в одинаковый фоновый цвет. Например, из отчета, показанного на рисунке, видно, что заголовки разделов «CHAPTER SIX: THE COMPOSITIONAL PROCESS» и «Equipment» находятся на одной странице.

Усовершенствование метода

Предоставьте информацию о популярности тем своим читателям, объединяя функции hit_report с текущими шаблонами обложек index.html и index.toc.html.

Вместо этого можно добавить к PDF-страницам интерактивные возможности комментирования с помощью PDF-обложек и нескольких PHP-сценариев. В этом случае пользователям не нужен Acrobat, независимо от того, работают ли они в Mac, Linux или Windows. Вы можете интегрировать PDF-комментарии с текущей комментирующей системой своего сайта. Обложка Comments (Комментарии), показанная на рисунке, может помочь в этом. Посмотрите сетевой пример на веб-странице http://www.pdfhacks.com/eno/skinned_comments/.

Создание PDF-обложек, добавление комментариев

См. раздел «Веб-обложки для PDF-документов», чтобы научиться их создавать. Вместо использования шаблона pdfskins_classic_php-1.0.zip загрузите шаблон pdfskins _classic_comments-1.0.zip. Обложка Comments такая же, как и php-обложка, но содержит дополнительные файлы showannot.php и saveannot.php.

Создайте PDF-обложку с помощью шаблона comments и поместите результат в каталог на своем сервере. Сервер должен иметь права доступа для записи в этом каталоге, чтобы создавать и обслуживать комментарии. Укажите своему веб-браузеру на этот URL, и справа откроется поле комментирования. Введите комментарий и нажмите Add Comment (Добавить комментарий).

Усовершенствование метода

Сценарий сохраняет комментарии к страницам в текстовых файлах. Чтобы упростить доступ к файлу, он копирует текущие комментарии во временный файл перед добавлением нового комментария. Затем заменяет первоначальный файл комментариев модифицированным временным файлом. Чтобы два пользователя, вносящие свои комментарии, не «столкнулись», измените сценарий для хранения комментариев в базе данных вместо текстового файла.

Классическая обложка имеет много полезных встроенных функций:

• портальную страницу оглавления, содержащую PDF-закладки;
• навигационный блок для просмотра страниц;
• полосу прокрутки оглавления, базирующегося на PDF-закладках;
• гиперссылки для загрузки полного PDF-документа, имеющиеся на каждой странице;
• удобную ссылку Email This Page (Отправить эту страницу по электронной почте) на каждой странице.

Загрузите сетевую версию, имеющуюся на сайте http://www.pdfhacks.com/еnо/. HTML-код, JavaScript-сценарии и значки интерфейса пользователя свободно распространяются с лицензией GPL (General Public License — общая открытая лицензия), так что не стесняйтесь использовать их в своих собственных шаблонах.

Создание обложки PDF-документа

Установите программу pdftk. Посетите сайт http://www.pdfhacks.com/skins/ и загрузите файл pdfskins-1.1.zip. Разархивируйте его и поместите файл pdfskins.exe в каталог, например: C:\Windows\system32\. На других платформах скомпилируйте pdf-обложки из имеющегося исходного кода и выполните команды cd pdfskins-1.1 и make.

Загрузите шаблон обложки с сайта http://www.pdfhacks.com/skins/. Шаблон pdfskins_classic_Js для создания динамических блоков использует JavaScript-сценарий на стороне клиента. Шаблон pdfskins_classic_php использует PHP-сценарий на стороне сервера. Выберите один из них и разархивируйте в новый каталог:

unzip pdfskins_classic_js-1.1. zip

Скопируйте свой PDF-документ в этот каталог и разбейте на страницы с помощью программы pdftk. Она также создает файл doc_data.txt, который содержит информацию о заголовке документа, метаданных и закладках:

pdftk full_doc.pdf burst

В этом же каталоге соберите обложки, используя программу pdfskins. Она читает файл doc_data.txt, созданный ранее, для поиска заголовка документа и других данных. Если планируется сделать полный PDF-документ доступным для загрузки, используйте имя PDF-файла в качестве первого параметра. Этот параметр используется только для создания гиперссылки Download Full Document (Загрузить полный документ). Это может быть полный или относительный URL. Опустите имя файла, и эта гиперссылка не будет отображаться.

pdfskins full_doc.pdf

Запустите свой веб-браузер и укажите ему на файл index.html, расположенный в текущем каталоге. Должна появиться портальная страница, показывающая оглавление, графические метки для эмблемы (logo.gif) и эскизы обложки документа (thumb.gif). При использовании шаблонов php или comments страницы обслуживаются сетевым сервером, поддерживающим язык РНР.

PDF-страницы, из которых состоит помещенный в обложку документ, не должны линеаризоваться, при этом сервер не требует конфигурирования для байтового обслуживания. Единственное требование — чтобы пользователи сконфигурировали Adobe Reader для отображения PDF-документа в браузере, который используется заданной по умолчанию конфигурацией программы Reader.

Изменение цвета заголовка

Можно добавить или изменить данные в файле doc_data.txt или передать дополнительные данные программе pdfskins в командной строке. Это очень удобно для изменения заданного по умолчанию цвета, используемого в обложке Classic (Классическая). Например:

pdfskins full_doc.pdf -title «Great American Novel» -color1 #336600 \ -color2 white

В обложке color1 — это цвет заголовка, a color2 — цвет фона левой верхней эмблемы. Альтернативно можете добавить или изменить эти строки в файле doc_data.txt

InfoKey: Color1
InfoValue: #336600
InfoKey: Color2
InfoValue: white
InfoKey: Title
InfoValue: Great American Novel

PDF-обложки как защита от копирования

Разбивая свой PDF-документ на страницы и делая полный документ недоступным для загрузки, вы заставляете читателей возвращаться на свой сайт, когда им потребуется этот материал. Если это — одна из целей, то необходимо также защитить страницы от объединения, чтобы никто не смог собрать их в PDF-документ. Сделайте это при разбиении документа. Например:

pdftk full_doc.pdf burst encrypt_128bits owner_pw 23@#5dfa \ allow DegradedPrinting

См. раздел «Шифрование и расшифровка PDF-документов»  для получения дополнительной информации о защите документов с помощью pdftk.

Проверьте основанный на языке РНР метод взлома на своем компьютере с системой Windows, установив сетевой сервер Apache. См. раздел «Сбор данных с помощью сетевых PDF-форм», описывающий установку сервера Apache и языка РНР в Windows, используя инсталлятор IndigoPerl.

Усовершенствование метода

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

Много интересных материалов о керамике, заинтересованный читатель сможет найти на сайте elegantceramica.ru, который содержит солидный объем практических сведений.

Не позволяйте этому случиться со своим сетевым PDF-документом. Если он имеет закладки, используйте этот метод взлома, чтобы создать HTML-оглавление, которое осуществляет гиперссылку каждого заголовка непосредственно к своей PDF-странице. В противном случае обязательно добавьте их.

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

Создание оглавления PDF-документа в формате HTML с помощью программ pdftk и pdftoc

Программа pdftk предоставляет информацию о PDF-данных, включая закладки. Программа pdftoc конвертирует это сообщение открытого текста в формат HTML. Посетите сайт http://www.pdf-hacks.com/pdftoc/ и загрузите файл pdftoc-1.0.zip. Разархивируйте его и поместите файл pdftoc.exe в удобный каталог, например: C:\Windows\system32\. На других платформах создайте программу pdftoc из исходного кода.

Используйте программу pdftk для захвата данных закладок из вашего PDF-документа, например:

pdftk mydoc.pdf dump_data output mydoc_data.txt

Затем — программу pdftoc для преобразования сообщения открытого текста в формат HTML:

pdftoc mydoc.pdfmydoc_toc.html

Альтернативно можно выполнить эти два шага вместе следующим образом:

pdftk mydoc.pdf dump_data | pdftoc mydoc.pdf > mydoc_toc.html

Первый параметр программы pdftoc — это местоположение документа, которое программа должна использовать в своих гиперссылках. Предыдущий пример предполагает, что файлы mydoc.pdf и mydoc_toc.html находятся в одном каталоге. Можно указать относительный путь для PDF-документа, например:

pdftoc ../pdf/mydoc.pdf < mydoc_data.txt > mydoc_toc.html

или полный URL:

pdftoc http://pdfhacks.com/pdf/mydoc.pdf < mydoc_data.txt > mydoc_toc.html

Как только читатели получают доступ к PDF-документу, они могут использовать его закладки для дальнейшего перемещения. Чтобы обеспечить просмотр закладок, настройте PDF-документ так, чтобы он отображал их после открытия.

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

Чтобы настроить гиперссылки к PDF-документам, просто добавьте один или несколько суффиксов, перечисленных в таблице, к пути href.

Суффиксы и их воздействие на Acrobat Reader

Они добавляются в конец к пути href с помощью специального примечания. Первый суффикс следует за знаком диез. Каждый дополнительный суффикс следует за амперсендом. Эти опции полностью описаны в документе «PDF Open Parameters», расположенном на веб-странице http://partners. adobe.com/asn/acrobat/sdk/public/docs/PDFOpenParams.pdf.

Например, чтобы открыть документ mydoc.pdf на странице 17 и отобразить закладки документа, гиперссылка href должна выглядеть следующим образом:

http://pdfhacks.com/mydoc.pdf#page=17&pagemode=bookmarks

Эти специальные PDF-гиперссылки не работают при использовании Internet Explorer, и если PDF-документ находится на локальном диске. Чтобы обойти эти ограничения, см. раздел «Создание Windows-ярлыков к локальным PDF-страницам».

Сохранение параметров настройки отображения в PDF-документе

Параметры настройки отображения можно сохранить в PDF-файле. Каждый раз при открытии PDF-документ будет отображаться согласно своим параметрам настройки. См. раздел «Окончательная шлифовка PDF-издания» для получения дополнительной информации.

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

Одним из способов является использование в PDF-документе только абсолютных URL.

Другим способом является установка Base URL (Основной URL) PDF-документа. В Acrobat 6 используйте команды File\Document Properties\Advanced\Base URL (Файл\Свойства документа\Дополнительно\Основной URL), а в Acrobat 5 — File\Document Properties\Base URL (Файл\Свойства документа\Основной URL).

О запрете загрузки документа см. раздел «Веб-обложки для PDF-документов».

Архивирование документа.

Самым быстрым решением для отдельного PDF-документа является сжатие его в zip-файл, который не может читаться интерактивно. Это также позволяет сократить размер загружаемого файла. Отрицательная сторона — у читателей должна быть программа разархивирования файла. Необходимо включить гиперссылку на место, откуда они могут загрузить такую программу (например, http://www.info-zip.org/pub/infozipf). Старайтесь не использовать самораспаковывающиеся исполняемые программы, потому что они работают только на конкретной платформе.

Можно также применить zip-сжатие налету с помощью сервера.

Создание папок только для загрузки, используя файлы .htaccess

Если у вас на сервере имеется каталог PDF-документов, предназначенных только для загрузки, можно изменить его файл .htaccess так, чтобы посетители всегда запрашивали загрузку PDF-документов. Для этого необходимо послать клиентам подходящие HTTP-сообщения Content-Type (Контент-тип) и Content-Disposition (Контент-расположение).

Это работает на серверах Apache и Zeus, использующих .htaccess-функции. Добавьте в свой PDF-каталог файл под названием .htaccess, который содержит следующие строки:

<files *.pdf>
ForceType application/octet-stream
Header set Content-Disposition attachment
</files>

Управление PDF-загрузками с помощью РНР-сценария

Данный сценарий даст вам возможность управлять PDF-загрузками. Это удобно, когда требуется сделать отдельный PDF-документ доступным и для интерактивного чтения, и для загрузки. Вы можете использовать сообщения Content-Type (Контент-тип) и Content-Disposition (Контент-расположение) в любом сценарии, который обслуживает PDF-документы, предназначенные только для загрузки.