4 new

git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@341111 c90b9560-bf6c-de11-be94-00142212c4b1
2025-07-30 12:57:40 +00:00 · 2016-11-23 14:07:44 +00:00
parent fc664cd564
commit 12342e01af
4 changed files with 267 additions and 0 deletions
--- a/reference/fdf/book.xml
+++ b/reference/fdf/book.xml
@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 1634a886415d0ab4df195fe49d18a1c150b70758 Maintainer: rjhdby Status: ready -->
+<!-- Reviewed: no -->
+<!-- $Revision$ -->
+
+<book xml:id="book.fdf" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <title>Формат данных форм</title>
+ <titleabbrev>FDF</titleabbrev>
+ 
+ <!-- {{{ preface -->
+ <preface xml:id="intro.fdf">
+  &reftitle.intro;
+  <simpara>
+   Формал данных форм (FDF) - это формат для обработки форм в
+   документах PDF. Более подробно данный формат описан в документации на сайте 
+   <link xlink:href="&spec.pdf.fdf;">&spec.pdf.fdf;</link>.
+  </simpara>
+  <simpara>
+   Главная идея FDF похода на формы HTML. Отличие в только в формате
+   передачи данных на сервер после нажатия кнопки "Отправить"
+   (как раз про это и FDF) и формате самой формы (а это PDF).
+   Обработка данных формы - это одна из возможностей, предоставляемых
+   функциями fdf. Другая возможность - можно автоматически заполнить
+   существующую форму данными. В этом случае мы можем создать документ FDF
+   (<function>fdf_create</function>), задать значения для каждого полля ввода
+   (<function>fdf_set_value</function>) и связать его с формой PDF
+   (<function>fdf_set_file</function>). В итоге она будет послана браузеру с
+   Mime-типом <literal>application/vnd.fdf</literal>. Плагин "Acrobat reader" в вашем
+   браузере опознает Mime-тип, прочитает связанную форму PDF и заполнит ее
+   данными из документа FDF.
+  </simpara>
+  
+  <simpara>
+   Если вы посмотрите на документ FDF в простом текстовом редакторе, вы увидите
+   каталог объектов с именем <literal>FDF</literal>. Такой объект может
+   содержать набор элементов, таких как <literal>Fields</literal>,
+   <literal>F</literal>, <literal>Status</literal> и т.д.
+   Наиболее часто использующаяся запись - это <literal>Fields</literal>, которая
+   содержит список полей ввода, и <literal>F</literal>, которая содержит имя файла
+   документа PDF, для которого предназначены данные. Эти записи называются в
+   документации PDF как /F-Key или /Status-Key.
+   Изменение этих записей производится такими функциями как
+   <function>fdf_set_file</function> и <function>fdf_set_status</function>. 
+   Поля модифицируются функциями <function>fdf_set_value</function>,
+   <function>fdf_set_opt</function> и т.д.
+  </simpara>
+ </preface>
+ <!-- }}} -->
+ 
+ &reference.fdf.setup;
+ &reference.fdf.constants;
+ &reference.fdf.examples;
+ &reference.fdf.reference;
+ 
+</book>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
+
--- a/reference/fdf/configure.xml
+++ b/reference/fdf/configure.xml
@ -0,0 +1,56 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: feeda9f6d8fa3c9d6f49a83ea2d746fd7d82ef00 Maintainer: rjhdby Status: ready -->
+<!-- Reviewed: no -->
+<!-- $Revision$ -->
+<section xml:id="fdf.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ &reftitle.install;
+ <para>
+  &pecl.info.dead;
+  <link xlink:href="&url.pecl.vcs;fdf">&url.pecl.vcs;fdf</link>.
+ </para>
+ <para>
+  Начиная с PHP 5.3.0 это расширение более не поставляется в составе PHP.
+ </para>
+ <note>
+  <simpara>
+   Если у вас возникли проблемы при конфигурировании поддержки fdftk в PHP,
+   проверьте, где находятся заголовочный файл <filename>fdftk.h</filename> и
+   библиотека <filename>libfdftk.so</filename>. 
+   Скрипт <command>configure</command> поддерживает обе структуры каталогов
+   поставки FDF SDK и обычно используют раскладку <filename>DIR/include</filename> / 
+   <filename>DIR/lib</filename>, так что вы указать или каталог, в который распаковали
+   установочный пакет, либо соответствующие директории вашей операционной системы, 
+   например <filename>/usr/local/include</filename> и
+   <filename>/usr/local/lib</filename> и конфигурировать с опцией
+   <option role="configure">--with-fdftk=/usr/local</option>.
+  </simpara>
+ </note>
+ <note>
+  <title>Для пользователей Win32</title>
+  <para>
+   &ext.windows.path.dll;
+   <filename>fdftk.dll</filename>
+  </para>
+ </note>
+</section>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
--- a/reference/fdf/examples.xml
+++ b/reference/fdf/examples.xml
@ -0,0 +1,67 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: rjhdby Status: ready -->
+<!-- Reviewed: no -->
+<!-- $Revision$ -->
+<chapter xml:id="fdf.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ &reftitle.examples;
+ <para>
+  Следующий пример демонстрирует простую обработку данных.
+  <example>
+   <title>Обработка документа FDF</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+// Откроем fdf из входной строки, предоставляемой этим расширением
+// Форма pdf содержит несколько полей для ввода со следующими именами:
+// volume, date, comment, publisher, preparer, и два чекбокса
+// show_publisher и show_preparer.
+$fdf = fdf_open_string($HTTP_FDF_DATA);
+$volume = fdf_get_value($fdf, "volume");
+echo "Поле volume содержит '<b>$volume</b>'<br />";
+
+$date = fdf_get_value($fdf, "date");
+echo "Поле date содержит '<b>$date</b>'<br />";
+
+$comment = fdf_get_value($fdf, "comment");
+echo "Поле comment содержит '<b>$comment</b>'<br />";
+
+if (fdf_get_value($fdf, "show_publisher") == "On") {
+  $publisher = fdf_get_value($fdf, "publisher");
+  echo "Поле publisher содержит '<b>$publisher</b>'<br />";
+} else
+  echo "Поле publisher не должно быть показано.<br />";
+
+if (fdf_get_value($fdf, "show_preparer") == "On") {
+  $preparer = fdf_get_value($fdf, "preparer");
+  echo "Поле preparer содержит '<b>$preparer</b>'<br />";
+} else
+  echo "Поле preparer не должно быть показано.<br />";
+fdf_close($fdf);
+?>
+]]>
+   </programlisting>
+  </example>
+ </para>
+</chapter>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
+
--- a/reference/fdf/setup.xml
+++ b/reference/fdf/setup.xml
@ -0,0 +1,67 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: rjhdby Status: ready -->
+<!-- Reviewed: no -->
+<!-- $Revision$ -->
+<chapter xml:id="fdf.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ &reftitle.setup;
+ 
+ <!-- {{{ Requirements -->
+ <section xml:id="fdf.requirements">
+  &reftitle.required;
+  <para>
+   Вам будет нужен "FDF toolkit SDK", который доступен по ссылке
+   <link xlink:href="&spec.pdf.fdf;">&spec.pdf.fdf;</link>.
+   Начиная с PHP 4.3.0 вам необходима SDK версии не ниже 5.0. 
+   Библиотека "FDF toolkit" только в виде бинарного файла.
+   Adobe поддерживает Win32, Linux, Solaris и AIX.
+  </para>
+ </section>
+ <!-- }}} -->
+ 
+ <!-- {{{ Installation -->
+ &reference.fdf.configure;
+ <!-- }}} -->
+ 
+ <!-- {{{ Configuration -->
+ <section xml:id="fdf.configuration">
+  &reftitle.runtime;
+  &no.config;
+ </section>
+ <!-- }}} -->
+ 
+ <!-- {{{ Resources -->
+ <section xml:id="fdf.resources">
+  &reftitle.resources;
+  <para>
+   Большинство функций fdf требую ресурс<parameter>fdf</parameter>
+   в качестве первого параметра. Ресурс <parameter>fdf</parameter> указывает
+   на открытый файл fdf. <parameter>fdf</parameter> можно получить
+   с помощью функций <function>fdf_create</function>,
+   <function>fdf_open</function> и <function>fdf_open_string</function>.
+  </para>
+ </section>
+ <!-- }}} -->
+ 
+</chapter>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
+