tronic Fri Dec 21 16:03:02 2001 EDT
Added files:
/phpdoc/ru/appendices about.xml
Modified files:
/phpdoc/ru/appendices aliases.xml commandline.xml
Log:
Translation done.
Index: phpdoc/ru/appendices/aliases.xml
diff -u phpdoc/ru/appendices/aliases.xml:1.2 phpdoc/ru/appendices/aliases.xml:1.3
--- phpdoc/ru/appendices/aliases.xml:1.2 Wed Dec 12 15:56:39 2001
+++ phpdoc/ru/appendices/aliases.xml Fri Dec 21 16:03:01 2001
@@ -1,18 +1,19 @@
<?xml version="1.0" encoding="windows-1251"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<appendix id="aliases">
- <title>Список псевдонимов</title>
+ <title>Список псевдонимов функций</title>
<para>
- Здесь представлен список все псевдонимов. Обычно использование
- псевдонимов не рекомендуется, поскольку они могут быть признаны
- устаревшими или переименованы, что приведет к невозможности
- портирования скрипта. Этот список предназначен для желающих
- привести старые скрипты в соответствие с новым синтаксисом.
+ Это список псевдонимов. Все псеводнимы перечислены здесь. Обычно
+ использование псевдонимов не рекомендуется, поскольку они могут
+ быть признаны устаревшими или переименованы, что приведет к
+ непортабельности скрипта. Этот список призван оказать помощь тем,
+ кто хочет привести свои старые скрипты в соответствие с новым
+ синтаксисом.
</para>
<para>
- Однако, некоторые функции имеют по два имени, и разницы в их
- использовании нет. (Например, <function>is_int</function> и
- <function>is_integer</function> одинаковы)
+ Однако, некоторые функции просто имеют два имени, причем между
+ ними не существует разницы. (Например, <function>is_int</function> и
+ <function>is_integer</function> абсолютно идентичны)
</para>
<para>
Этот список соответствует PHP 4.0.6.
@@ -24,8 +25,8 @@
<thead>
<row>
<entry>Псевдоним</entry>
- <entry>Управляющая функция</entry>
- <entry>Используемое расширение</entry>
+ <entry>Соотв. функция</entry>
+ <entry>Использ. расширение</entry>
</row>
</thead>
<tbody>
@@ -97,7 +98,7 @@
<row>
<entry>chop</entry>
<entry><function>rtrim</function></entry>
- <entry>Base syntax</entry>
+ <entry>Базовый синтаксис</entry>
</row>
<row>
<entry>close</entry>
@@ -202,7 +203,7 @@
<row>
<entry>die</entry>
<entry><function>exit</function></entry>
- <entry><link linkend="ref.misc">Разнообразные функции</link></entry>
+ <entry><link linkend="ref.misc">Функции разнообразного назначения</link></entry>
</row>
<row>
<entry>dir</entry>
@@ -372,42 +373,42 @@
<row>
<entry>i18n_convert</entry>
<entry><function>mb_convert_encoding</function></entry>
- <entry><link linkend="ref.mbstring">Строки Multi-bytes</link></entry>
+ <entry><link linkend="ref.mbstring">Мультибайтовые строки</link></entry>
</row>
<row>
<entry>i18n_discover_encoding</entry>
<entry><function>mb_detect_encoding</function></entry>
- <entry><link linkend="ref.mbstring">Строки Multi-bytes</link></entry>
+ <entry><link linkend="ref.mbstring">Мультибайтовые строки</link></entry>
</row>
<row>
<entry>i18n_http_input</entry>
<entry><function>mb_http_input</function></entry>
- <entry><link linkend="ref.mbstring">Строки Multi-bytes</link></entry>
+ <entry><link linkend="ref.mbstring">Мультибайтовые строки</link></entry>
</row>
<row>
<entry>i18n_http_output</entry>
<entry><function>mb_http_output</function></entry>
- <entry><link linkend="ref.mbstring">Строки Multi-bytes</link></entry>
+ <entry><link linkend="ref.mbstring">Мультибайтовые строки</link></entry>
</row>
<row>
<entry>i18n_internal_encoding</entry>
<entry><function>mb_internal_encoding</function></entry>
- <entry><link linkend="ref.mbstring">Строки Multi-bytes</link></entry>
+ <entry><link linkend="ref.mbstring">Мультибайтовые строки</link></entry>
</row>
<row>
<entry>i18n_ja_jp_hantozen</entry>
<entry><function>mb_convert_kana</function></entry>
- <entry><link linkend="ref.mbstring">Строки Multi-bytes</link></entry>
+ <entry><link linkend="ref.mbstring">Мультибайтовые строки</link></entry>
</row>
<row>
<entry>i18n_mime_header_decode</entry>
<entry><function>mb_decode_mimeheader</function></entry>
- <entry><link linkend="ref.mbstring">Строки Multi-bytes</link></entry>
+ <entry><link linkend="ref.mbstring">Мультибайтовые строки</link></entry>
</row>
<row>
<entry>i18n_mime_header_encode</entry>
<entry><function>mb_encode_mimeheader</function></entry>
- <entry><link linkend="ref.mbstring">Строки Multi-bytes</link></entry>
+ <entry><link linkend="ref.mbstring">Мультибайтовые строки</link></entry>
</row>
<row>
<entry>imap_create</entry>
@@ -527,27 +528,27 @@
<row>
<entry>mbstrcut</entry>
<entry><function>mb_strcut</function></entry>
- <entry><link linkend="ref.mbstring">Строки Multi-bytes</link></entry>
+ <entry><link linkend="ref.mbstring">Мультибайтовые строки</link></entry>
</row>
<row>
<entry>mbstrlen</entry>
<entry><function>mb_strlen</function></entry>
- <entry><link linkend="ref.mbstring">Строки Multi-bytes</link></entry>
+ <entry><link linkend="ref.mbstring">Мультибайтовые строки</link></entry>
</row>
<row>
<entry>mbstrpos</entry>
<entry><function>mb_strpos</function></entry>
- <entry><link linkend="ref.mbstring">Строки Multi-bytes</link></entry>
+ <entry><link linkend="ref.mbstring">Мультибайтовые строки</link></entry>
</row>
<row>
<entry>mbstrrpos</entry>
<entry><function>mb_strrpos</function></entry>
- <entry><link linkend="ref.mbstring">Строки Multi-bytes</link></entry>
+ <entry><link linkend="ref.mbstring">Мультибайтовые строки</link></entry>
</row>
<row>
<entry>mbsubstr</entry>
<entry><function>mb_substr</function></entry>
- <entry><link linkend="ref.mbstring">Строки Multi-bytes</link></entry>
+ <entry><link linkend="ref.mbstring">Мультибайтовые строки</link></entry>
</row>
<row>
<entry>ming_setcubicthreshold</entry>
Index: phpdoc/ru/appendices/commandline.xml
diff -u phpdoc/ru/appendices/commandline.xml:1.2
phpdoc/ru/appendices/commandline.xml:1.3
--- phpdoc/ru/appendices/commandline.xml:1.2 Wed Dec 12 15:56:41 2001
+++ phpdoc/ru/appendices/commandline.xml Fri Dec 21 16:03:01 2001
@@ -1,48 +1,48 @@
<?xml version="1.0" encoding="windows-1251"?>
-<!-- $Revision: 1.2 $ -->
-<!--
+<!-- $Revision: 1.3 $ -->
+<!--
TODO:
-
+
The command line options not in the
list, but in the -h output below:
-
+
-f, -e, -z, -l
-
+
It would be best to document these, and
collect more info about -c and -d!
-->
<appendix id="commandline">
<title>Использование PHP из командной строки</title>
<para>
- Параметры командной строки для PHP полезны, если вам
- нужно отладить или протестировать настройки PHP, но
- также они могут быть удобны и в том случае, если вы
- решите использовать PHP в других целях, нежели написание
- скриптов для web.
- </para>
- <para>
- Заметьте, что вы всегда можете направить вывод PHP
- во внешний файл с использованием символа >, так что
- <literal>php -q test.php > test.html</literal> выведет
- результаты выполнения скрипта <filename>test.php</filename>
- без HTTP-заголовков в файл <filename>test.html</filename>
- в том же каталоге.
- </para>
- <para>
- Вы можете использовать параметры командной строки только
- в том случае, если ваш PHP является самостоятельным приложением.
- Если вы собрали модульную версию для сервера, причем
- если на вашей машине отсутствует CGI, вы не можете
- использовать эти параметры. Для пользователей Windows
- один файл <filename>php.exe</filename> может использоваться
- как в качестве самостоятельного приложения, так и в качестве
- серверного модуля.
- </para>
- <para>
- Этот список параметров командной строки соответствует PHP 4.0.6.
- Вы можете получить их действительный список с краткими однострочными
- описаниями, используя параметр <literal>-h</literal>. Результат
- выполнения команды <literal>php -h</literal> может быть приблизительно таким:
+ Использование PHP из командной строки обычно применяется
+ в тех случаях, когда вам нужно отладить или протестировать
+ настройку PHP; также оно используется, если вам нужно
+ использовать PHP в других целях, нежели создание веб-скриптов.
+ </para>
+ <para>
+ Обратите внимание, что вы всегда можете перенаправить
+ вывод результатов выполнения скрипта во внешний файл,
+ используя символ the >, например,
+ <literal>php -q test.php > test.html</literal> перенаправит
+ вывод результатов выполнения скрипта <filename>test.php</filename>
+ без HTTP-заголовков в файл <filename>test.html</filename>,
+ находящийся в текущем каталоге.
+ </para>
+ <para>
+ Вы можете использовать PHP из командной строки только в том случае,
+ если вы обладаете PHP в формате исполняемого файла. Если вы
+ собрали PHP в виде серверного модуля и на вашей машине
+ недоступна CGI, использовать PHP таким образом вы не сможете.
+ Для пользователей Windows как исполняемый файл, так и
+ серверный модуль PHP находятся в одном файле с именем
+ <filename>php.exe</filename>.
+ </para>
+ <para>
+ Список параметров командной строки соответствует PHP 4.0.6.
+ Вы можете получить список параметров вместе с однострочными
+ описаниями с помощью параметра <literal>-h</literal> option.
+ Результат выполнения <literal>php -h</literal> может выглядеть
+ примерно так:
<screen>
<![CDATA[
Usage: php [-q] [-h] [-s [-v] [-i] [-f <file>] | {<file> [args...]}
@@ -63,8 +63,8 @@
</screen>
</para>
<para>
- Ниже приведен список наиболее значимых параметров командной
- строки с подробными описаниями.
+ Здесь мы приводим список наиболее важных параметов командной
+ строки с детальными пояснениями.
</para>
<para>
<table>
@@ -81,79 +81,80 @@
<entry>-q</entry>
<entry>
Запрещает вывод HTTP-заголовков. Обычно PHP выводит
- HTTP-заголовки по вызову программы (например, web-сервера)
- для последующей передачи их броузеру. В случае
- создания приложения, вызываемого из командной строки,
- необходимость в этих заголовках отсутствует.
+ HTTP-заголовки для обработки их браузером. Во время
+ создания скриптов для командной строки эти заголовки
+ бесполезны.
</entry>
</row>
<row>
<entry>-s</entry>
<entry>
- Выводит исходный код скрипта, выделенный цветом.
- Этот параметр равнозначен использованию функции
- <function>highlight_file</function> в скрипте PHP.
+ Выводит исходный код заданного файла с подсветкой
+ синтаксиса. Это равнозначно использованию функции
+ <function>highlight_file</function> в PHP-скрипте.
</entry>
</row>
<row>
<entry>-v</entry>
<entry>
- Передавая PHP этот параметр, вы можете узнать
- текущую версию PHP, например, 4.0.6.
+ Запустив PHP с этим параметром, вы сможете
+ узнать текущую версию PHP, например, 4.0.6.
</entry>
</row>
<row>
<entry>-C</entry>
<entry>
- Обычно PHP изменяет рабочий каталог на каталог
- с выполняемыми скрптами. Это дает возможность,
- например, открытия файлов, расположенных в одном
- каталоге со скриптом, путем указания только их
- имени. Если вы хотите отключить эту возможность смены
- каталогов, используйте этот параметр.
- this option.
+ Обычно PHP изменяет текущий каталог на каталог,
+ в котором находится выполняемый скрипт. Это делает
+ возможным, например, открытие файлов из скрипта
+ в том же каталоге, с указанием только имени файла.
+ Если вы хотите отключить эту возможность, используйте
+ указанный параметр.
</entry>
</row>
<row>
<entry>-c</entry>
<entry>
Используя этот параметр, вы можете указать альтернативный
- путь к файлу <filename>php.ini</filename> с тем, чтобы
- PHP обращался к конфигурационному файлу в указанном вами
- каталоге вместо каталога по умолчанию.
+ путь к файлу <filename>php.ini</filename>, чтобы PHP
+ искал конфигурационные файлы в указанном каталоге вместо
+ каталога по умолчанию.
</entry>
</row>
<row>
<entry>-d</entry>
<entry>
- С помощью этого параметра вы можете изменять
- отдельные настройки в файле <filename>php.ini</filename>
+ С помощью этого параметра вы можете
+ установить отдельные настройки <filename>php.ini</filename>
во время выполнения скрипта.
</entry>
</row>
<row>
<entry>-m</entry>
<entry>
- С указанием этого параметра PHP выводит информацию
- о встроенных (и загруженных) модулях PHP и Zend,
- их версии и короткое замечание о принадлежности
- авторских прав на Zend.
+ Using this option, PHP prints out the built in
+ (and loaded) PHP and Zend modules, the PHP
+ and Zend version numbers, and a short Zend
+ copyright notice.
</entry>
</row>
<row>
<entry>-i</entry>
<entry>
- Этот параметр вызывает функцию <function>phpinfo</function>
- и выводит результат ее выполнения. Если PHP не работает так,
- как нужно, выполните <literal>php -i</literal> и посмотрите,
- не ли в выведенной информации сообщений об ошибках.
+ This command line option calls
+ <function>phpinfo</function>, and prints
+ out the results. If PHP is not working well,
+ it is advisable to make a <literal>php -i</literal>
+ and see if any error messages are printed out
+ before or in place of the information tables.
</entry>
</row>
<row>
<entry>-h</entry>
<entry>
- С помощью этого параметра вы можете получить список
- доступных параметров с их краткими однострочными описаниями.
+ With this option, you can get information about
+ the actual list of command line options and some
+ one line descriptions about what they do.
</entry>
</row>
</tbody>
@@ -161,21 +162,20 @@
</table>
</para>
<para>
- PHP в виде самостоятельного приложения может использоваться
- для запуска скриптов PHP совершенно независимо от web-сервера.
- Если вы работаете с платформой Unix, вы должны добавить
- специальную строку в начало скрипта и пометить его как исполняемый,
- чтобы дать системе знать, какая программа ответственна за
- выполнение скрипта. На платформе Windows, вы можете установить
- связь между <literal>php.exe -q</literal> и <literal>.php</literal> файлами
- путем двойного щелчка на них, либо вы можете создать bat-файл для
- запуска скрипта с помощью PHP. Первая строка, добавляемая
- в скрипт на платформах Unix, игнорируется PHP на Windows-платформах,
- таким образом, вы можете создавать кроссплатформенные приложения.
- Пример программы PHP, выполняемой из командной строки, приведен ниже.
+ The PHP executable can be used to run PHP scripts absolutely
+ independent from the web server. If you are on a Unix system,
+ you should add a special first line to your PHP script, and
+ make it executable, so the system will know, what program
+ should run the script. On a Windows platform you can associate
+ <literal>php.exe -q</literal> with the double click option of
+ the <literal>.php</literal> files, or you can make a batch file
+ to run the script through PHP. The first line added to the
+ script to work on Unix won't hurt on Windows, so you can write
+ cross platform programs this way. A simple example of writing
+ a command line PHP program can be found below.
</para>
<example>
- <title>Скрипт, предназначенный для запуска из командной строки (script.php)</title>
+ <title>Script intended to be run from command line (script.php)</title>
<programlisting role="php">
<![CDATA[
#!/usr/bin/php -q
@@ -184,14 +184,14 @@
if ($argc != 2 || in_array($argv[1], array('--help', '-help', '-h', '-?'))) {
?>
-Это скрипт PHP, выполняемый из командной строки, использующий один параметр.
+This is a command line PHP script with one option.
- Использование:
- <?php echo $argv[0]; ?> <параметр>
+ Usage:
+ <?php echo $argv[0]; ?> <option>
- <параметр> может принимать любое значение.
- С параметром --help, -help, -h, или -? вы можете
- получить справку.
+ <option> can be some word you would like
+ to print out. With the --help, -help, -h,
+ or -? options, you can get this help.
<?php
} else {
@@ -202,44 +202,42 @@
</programlisting>
</example>
<para>
- В вышеприведенном скрипте была использована специальная первая строка
- с целью указания, что этот файл должен быть запущен с помощью PHP
- без вывода HTTP-заголовков. Существуют две переменных, которые
- вы можете использовать в процессе написания приложений PHP, выполняемых
- из командной строки: <varname>$argc</varname> и <varname>$argv</varname>.
- В первой содержится количество переданных приложению аргументов плюс
- один (имя выполняемого скрипта). Вторая переменная является массивом,
- содержащим собственно аргументы, начиная с имени скрипта с нулевым
- индексом (<varname>$argv[0]</varname>).
- </para>
- <para>
- В вышеприведенной программе проверялось условие отличия количества
- переданных аргументов от единицы. Также, если переданный аргумент
- был равен <literal>--help</literal>, <literal>-help</literal>,
- <literal>-h</literal> или <literal>-?</literal>, программа выдавала
- справочное сообщение. Если программе передавался какой-либо другой
- аргумент, он отображался на устройстве вывода.
- </para>
- <para>
- Если вы хотите запустить вышеприведенный скрипт на Unix, вы
- должны пометить его как исполнимый и вызвать его как
- <literal>script.php echothis</literal> или
- <literal>script.php -h</literal>. В Windows вы можете создать
- bat-файл для выполнения этого скрипта:
+ In the script above, we used the special first line to indicate,
+ that this file should be run by PHP and should not print out HTTP
+ headers. There are two variables you can use while writing command
+ line applications with PHP: <varname>$argc</varname> and
+ <varname>$argv</varname>. The first is the number of arguments plus
+ one (the name of the script running). The second is an array
+ containing the arguments, starting with the script name as number
+ zero (<varname>$argv[0]</varname>).
+ </para>
+ <para>
+ In the program above we checked if there are less or more than one
+ arguments. Also if the argument was <literal>--help</literal>,
+ <literal>-help</literal>, <literal>-h</literal> or <literal>-?</literal>,
+ we printed out the help message, printing the script name dynamically.
+ If we received some other argument we echoed that out.
+ </para>
+ <para>
+ If you would like to run the above script on Unix, you need to
+ make it executable, and simply call it as
+ <literal>script.php echothis</literal> or
+ <literal>script.php -h</literal>. On Windows, you can make a
+ batch file for this task:
</para>
<example>
- <title>Bat-файл для запуска скрипта PHP из командной строки (script.bat)</title>
+ <title>Batch file to run a command line PHP script (script.bat)</title>
<programlisting role="winbat">
@c:\php\php.exe -q script.php %1 %2 %3 %4
</programlisting>
</example>
<para>
- Учитывая, что вы назвали вышеприведенную программу как
- <filename>script.php</filename> и исполняемый файл
- <filename>php.exe</filename> имеет полное имя
- <filename>c:\php\php.exe</filename>, этот bat-файл
- выполнит скрипт с дополнительными параметрами:
- <literal>script.bat echothis</literal> или
+ Assuming, you named the above program as
+ <filename>script.php</filename>, and you have your
+ <filename>php.exe</filename> in
+ <filename>c:\php\php.exe</filename> this batch file
+ will run it for you with your added options:
+ <literal>script.bat echothis</literal> or
<literal>script.bat -h</literal>.
</para>
</appendix>
Index: phpdoc/ru/appendices/about.xml
+++ phpdoc/ru/appendices/about.xml
<?xml version="1.0" encoding="windows-1251"?>
<!-- $Revision: 1.1 $ -->
<!--
TODO: add manual conventions section (eg. how to read
function usage parts, what is fixed width, what is
bold, what is linked
add some tips about combining the versions (online-
offline), and using "http://anymirror.php.net/funcname";
-->
<appendix id="about">
<title>О руководстве</title>
<sect1 id="about.formats">
<title>Форматы</title>
<para>
Руководство по PHP поставляется в нескольких форматах. Эти форматы
могут быть разгруппированы в две категории: форматы, доступные для
онлайн-просмотра и пакеты для скачки.
</para>
<note>
<para>
Некоторые издатели предлагают печатные версии этого руководства.
Мы не рекомендуем использовать их, поскольку они очень скоро
устаревают.
</para>
</note>
<para>
Вы можете просматривать руководство в онлайне по адресу
<ulink url="&url.php;"> &url.php;</ulink> и на многочисленных
сайтах-зеркалах. Выбирайте ближайший к вам сайт-зеркало. Вы можете
просматривать руководство как в обычном (доступном для распечатки)
HTML-формате, так и в HTML-формате, который придает руководству
облик веб-сайта PHP.
</para>
<para>
Преимуществом онлайн-руководства над большинством оффлайн-форматов
является интеграция с <link linkend="about.notes">заметками,
оставляемыми пользователями</link>. Очевидным минусом является то,
что вы должны оставаться в онлайне для просмотра онлайн-форматов.
</para>
<para>
Существует несколько оффлайн-форматов руководства; приемлемость
для вас одного из таких форматов зависит от используемой вами
операционной системы и вашего собственного предпочтения.
Чтобы получить более подробную информацию о том, как руководство
генерируется в таком количестве форматов, прочитайте главу приложения
<link linkend="about.generate">'Как мы генерируем форматы'</link>.
</para>
<para>
Наиболее кросс-платформенными форматами руководства являются HTML-версии
и текстовые версии. Руководство в HTML-формате поставляется как в
виде одного HTML-файла, так и в виде пакета файлов, соответствующих
каждой главе (несколько тысяч файлов). Руководство в HTML- и текстовом
форматах поставляется в сжатых tar файлах (с использованием как
gzip, так и bzip2) и ZIP-архивах.
</para>
<para>
Другим популярным кросс-платформенных форматом, и форматом, наиболее
подходящим для распечатки, является PFD (также известный как Adobe
Acrobat). Но перед тем как вы скачаете руководство в этом формате
и нажмете кнопку 'Печать', имейте в виду, что руководство составляют
около 2000 страниц, которые постоянно обновляются.
</para>
<note>
<para>
Если у вас еще нет программы, с помощью которой вы смогли бы
просмотреть файлы в формате PDF, вам нужно будет скачать
<ulink url="&url.adobe.acrobat;">Adobe Acrobat Reader</ulink>.
</para>
</note>
<para>
Для владельцев Palm-совместимых компьютеров будут идеальны
форматы 'Palm document' и iSilo. Вы можете принести свой Palmtop
с собой на свою ежеднедневную встречу и использовать программу
просмотра <ulink url="&url.palm.doc;">DOC</ulink> или
<ulink url="&url.palm.isilo;">iSilo</ulink>, чтобы 'причесать'
свои знания в области PHP или просто использовать его в качестве
справочника.
</para>
<para>
Для платформ Windows доступна версия Windows HTML Help руководства,
использующая формат HTML для использования с приложением Windows
HTML Help. Эта версия обеспечивает поиск по всему объему текста,
полный индекс и систему закладок. Эта версия документации интегрируется
со многими популярными средами разработки PHP для Windows для
обеспечения легкого доступа.
</para>
<note>
<para>
Проект Visual Basic для Linux находится в стадии планирования
и будет включать в себя разработчик и средство просмотра CHM-файлов
для Linux. Обратитесь на их <ulink url="&url.vb4linux;">страницу на
SourceForge.net</ulink>, если вы заинтересованы в текущем состоянии
проекта.
</para>
</note>
</sect1>
<sect1 id="about.notes">
<title>О заметках пользователей</title>
<para>
Заметки, оставляемые пользователями, играют важную роль в разработке
этого руководства. Позволяя читателям руководства делиться примерами
и пояснениями непосредственно с помощью их браузеров, мы получаем
возможность объединять их сведения с текстом руководства. И, пока
заметки не объединены, они могут быть просмотрены как с помощью
формы для подачи заметки, так и в некоторых оффлайн-форматах.
</para>
<note>
<para>
Заметки, оставляемые пользователями, не модерируются перед тем, как
появиться в онлайне, таким образом, качество написания примеров и
даже верность чьего-либо мнения не могут быть гарантированы. (Как
не может гарантироваться качество и точность самого текста руководства.)
</para>
</note>
</sect1>
<sect1 id="about.more">
<title>Как получить более подробные сведения о PHP</title>
<para>
Это руководство не ставит своей целью инструктаж по общей теории
программирования. Если вы приступаете к программированию в первый
раз или являетесь просто начинающим, программирование на PHP может
показаться вам сложным, если вы используете это руководство. Может
быть, вам нужно будет найти тексты, в большей степени ориентированные
на начинающих. По адресу <ulink
url="&url.php.books;">&url.php.books;</ulink> вы сможете найти
список книг, посвященных PHP.
</para>
<para>
Существует множество активных списков рассылки, служащих для
обсуждения всех аспектов программирования на PHP. Если вы застрянете
на какой-либо проблеме и не сможете найти ее решения, вы всегда
сможете получить помощь от кого-либо из подписчиков этих списков
рассылки. Перечень списков рассылки вы можете найти по адресу
<ulink url="&url.php.support;">&url.php.support;</ulink>, также как
и ссылки на архивы список рассылки и другие ресурсы онлайн-поддержки.
Кроме того, по адресу <ulink url="&url.php.links;">&url.php.links;</ulink>
находится список веб-сайтов, посвященных статьям на тему PHP, форумы
и собраний кода.
</para>
</sect1>
<sect1 id="about.howtohelp">
<title>Как помочь в улучшении документации</title>
<para>
Существуют два способа для того, чтобы вы могли помочь
в улучшении этой документации.
</para>
<para>
Если вы обнаружите ошибки в этом руководстве на любом языке, пожалуйста,
сообщите о них, используя систему сообщения об ошибках по адресу
<ulink url="&url.php.bugs;">&url.php.bugs;</ulink>. Классифицируйте
ошибку как "Documentation Problem (Проблема с Документацией)".
Также вы можете отправлять замечания, относящиеся к форматам
представления руководства.
</para>
<note>
<para>
Пожалуйста, не используйте систему сообщения об ошибках, если вам
нужна помощь. Используйте списки рассылки или сайты обществ,
упомянутые выше.
</para>
</note>
<para>
Оставляя заметки, вы можете обеспечить других читателей примерами
и пояснениями. Но не используйте систему аннотации для сообщений
об ошибках. Вы можете получить больше подробной информации о
заметках, ознакомившись с главой <link linkend="about.notes">'О
пользовательских заметках'</link> этого приложения.
</para>
</sect1>
<sect1 id="about.generate">
<title>Как мы генерируем форматы</title>
<para>
Это руководство написано на <acronym>XML</acronym> с помощью <ulink
url="&url.docbook.xml;">DocBook XML DTD</ulink>, с использованием <ulink
url="&url.dsssl;"><acronym>DSSSL</acronym></ulink> (Document
Style and Semantics Specification Language) для форматирования, и
(экспериментально) <ulink url="&url.xslt;"><acronym>XSLT</acronym>
</ulink> (Extensible Stylesheet Language Transformations)
для обслуживания и форматирования.
</para>
<para>
Использование <acronym>XML</acronym> в качестве исходного формата
предоставляет нам возможность генерировать множество форматов из
одного исходного кода. Утилиты, используемые для форматирования
<acronym>HTML-</acronym> и <acronym>TeX-</acronym>версий:
<ulink url="&url.jade;">Jade</ulink>, автор - <ulink
url="&url.jclark;">James Clark</ulink> и <ulink
url="&url.dbstyle;">The Modular DocBook Stylesheets</ulink>
автор - <ulink url="&url.nwalsh;">Norman Walsh</ulink>.
Для генерации руководства в формате Windows HTML Help мы используем
<ulink url="&url.winhelp;">Microsoft HTML Help Workshop</ulink>, и,
конечно, сам PHP для дополнительного преобразования и форматирования.
</para>
<para>
Вы можете скачать руководство на различных языках и в
различных форматах, в том числе текстовом, <acronym>HTML</acronym>,
<acronym>PDF</acronym>, PalmPilot DOC, PalmPilot iSilo и
Windows HTML Help по адресу <ulink
url="&url.php.docs;">&url.php.docs;</ulink>. Руководство автоматически
обновляется по мере обновления исходного текста.
</para>
<para>
Вы можете получить дополнительную информацию по скачиванию
исходного <acronym>XML</acronym>-кода этой документации по адресу
<ulink url="&url.php.cvs;">&url.php.cvs;</ulink>. Документация
содержится в модуле <literal>phpdoc</literal>.
</para>
</sect1>
</appendix>
<!-- 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:"../../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
-->
