You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by so...@apache.org on 2006/04/07 23:25:02 UTC
svn commit: r392410 - in /httpd/httpd/branches/2.2.x/docs/manual:
handler.xml.ru invoking.xml.ru mod/allmodules.xml.ru mod/directives.xml.ru
new_features_2_0.xml.ru programs/index.xml.ru vhosts/index.xml.ru
Author: soldis
Date: Fri Apr 7 14:25:02 2006
New Revision: 392410
URL: http://svn.apache.org/viewcvs?rev=392410&view=rev
Log:
Some of the russian translations, which have a very little difference between their English originals,
are transferred from 2.0.x branch.
Added:
httpd/httpd/branches/2.2.x/docs/manual/handler.xml.ru
httpd/httpd/branches/2.2.x/docs/manual/invoking.xml.ru
httpd/httpd/branches/2.2.x/docs/manual/mod/allmodules.xml.ru
httpd/httpd/branches/2.2.x/docs/manual/mod/directives.xml.ru
httpd/httpd/branches/2.2.x/docs/manual/programs/index.xml.ru
httpd/httpd/branches/2.2.x/docs/manual/vhosts/index.xml.ru
Modified:
httpd/httpd/branches/2.2.x/docs/manual/new_features_2_0.xml.ru
Added: httpd/httpd/branches/2.2.x/docs/manual/handler.xml.ru
URL: http://svn.apache.org/viewcvs/httpd/httpd/branches/2.2.x/docs/manual/handler.xml.ru?rev=392410&view=auto
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/handler.xml.ru (added)
+++ httpd/httpd/branches/2.2.x/docs/manual/handler.xml.ru [koi8-r] Fri Apr 7 14:25:02 2006
@@ -0,0 +1,172 @@
+<?xml version="1.0" encoding="KOI8-R" ?>
+<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="./style/manual.ru.xsl"?>
+<!-- English Revision: 160365 -->
+
+<!--
+ Copyright 2002-2005 The Apache Software Foundation or its licensors, as
+ applicable.
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<!--***************************************************-->
+<!-- Translator: Ilia Soldatenko (soldis@tversu.ru) -->
+<!-- Reviewers: -->
+<!-- Ivan Shvedov (ivan@tversu.ru) -->
+<!-- Arthur Reznikov (art@altair.tversu.ru)-->
+<!--***************************************************-->
+
+<manualpage metafile="handler.xml.meta">
+
+ <title>Использование обработчиков в Apache</title>
+
+ <summary>
+ <p>Этот документ описывает использование обработчиков (handlers) в Apache.</p>
+ </summary>
+
+ <section id="definition">
+ <title>Что такое обработчик</title>
+ <related>
+ <modulelist>
+ <module>mod_actions</module>
+ <module>mod_asis</module>
+ <module>mod_cgi</module>
+ <module>mod_imagemap</module>
+ <module>mod_info</module>
+ <module>mod_mime</module>
+ <module>mod_negotiation</module>
+ <module>mod_status</module>
+ </modulelist>
+ <directivelist>
+ <directive module="mod_actions">Action</directive>
+ <directive module="mod_mime">AddHandler</directive>
+ <directive module="mod_mime">RemoveHandler</directive>
+ <directive module="core">SetHandler</directive>
+ </directivelist>
+ </related>
+
+
+ <p>Обработчик является внутренней структурой
+ Apache, которая задаёт поведение сервера при обработке
+ запрашиваемого файла. Как правило, каждому файлу соответствует
+ свой внутренний обработчик, который назначается сервером
+ исходя из типа файла. Обычно файлы просто возвращаются
+ пользователю, но некоторые типы файлов предварительно
+ обрабатываются (handled) сервером.</p>
+
+ <p>В Apache 1.1 добавлена возможность использовать обработчики
+ явно. Причём обработка файлов может основываться
+ теперь не только на их типе, но и на расширении файлов или
+ их местонахождении. Это представляется наиболее удачным
+ решением, во-первых потому, что это решение элегантно, а
+ во-вторых, это позволяет ассоциировать с файлом как
+ тип, <strong>так и</strong> обработчик. (См. также
+ <a href="mod/mod_mime.html#multipleext">«Файлы с несколькими
+ расширениями»</a>)</p>
+
+ <p>Обработчики могут представлять из себя как
+ вкомпилированные в сервер (или подключаемые с помощью
+ модулей) функции, или они могут быть добавлены с помощью
+ директивы <directive module="mod_actions">Action</directive>.
+ В стандартном дистрибутиве сервера имеются следующие встроенные
+ обработчики:</p>
+
+ <ul>
+ <li><strong>default-handler</strong>: Посылает файл, используя функцию
+ <code>default_handler()</code>, которая является обработчиком
+ по-умолчанию для статических файлов. (ядро)</li>
+
+ <li><strong>send-as-is</strong>: Посылает файл, содержащий в
+ себе HTTP заголовки, как есть. (<module>mod_asis</module>)</li>
+
+ <li><strong>cgi-script</strong>: Обрабатывает файл как CGI-скрипт.
+ (<module>mod_cgi</module>)</li>
+
+ <li><strong>imap-file</strong>: Обрабатывает файл как карту изображения
+ (imagemap). (<module>mod_imagemap</module>)</li>
+
+ <li><strong>server-info</strong>: Возвращает конфигурационную
+ информацию сервера. (<module>mod_info</module>)</li>
+
+ <li><strong>server-status</strong>: Возвращает отчет о состоянии
+ сервера. (<module>mod_status</module>)</li>
+
+ <li><strong>type-map</strong>: Обрабатывает файл как карту типов
+ (type map). (<module>mod_negotiation</module>)</li>
+ </ul>
+ </section>
+ <section id="examples">
+ <title>Примеры</title>
+
+ <section id="example1">
+ <title>Обработка статического документа CGI-скриптом</title>
+
+ <p>При использовании следующих директив, каждый запрос файла
+ с расширением <code>html</code> будет запускать на выполнение
+ CGI-скрипт <code>footer.pl</code> для предварительной обработки
+ запрашиваемого файла.</p>
+
+ <example>
+ Action add-footer /cgi-bin/footer.pl<br/>
+ AddHandler add-footer .html
+ </example>
+
+ <p>В этом случает CGI-скрипт ответственен за то, чтобы
+ выслать пользователю запрошенный документ (на который указывает
+ переменная окружения <code>PATH_TRANSLATED</code>), сделав
+ в нём предварительно все необходимые изменения.</p>
+
+ </section>
+ <section id="example2">
+ <title>Файлы с HTTP заголовками</title>
+
+ <p>Следующие несколько директив заставят выполняться обработчик
+ <code>send-as-is</code>, который используется для файлов, содержащих
+ свои собственные HTTP-заголовки. Все файлы в каталоге
+ <code>/web/htdocs/asis/</code> будут обрабатываться обработчиком
+ <code>send-as-is</code>, независимо от их расширения.</p>
+
+ <example>
+ <Directory /web/htdocs/asis><br/>
+ SetHandler send-as-is<br/>
+ </Directory>
+ </example>
+
+ </section>
+ </section>
+ <section id="programmer">
+ <title>Замечание для программистов</title>
+
+ <p>Для того чтобы можно было использовать обработчики, в
+ <a href="developer/API.html">Apache API</a> были внесены
+ некоторые дополнения. В частности, в структуру <code>request_rec</code>
+ было добавлено новое поле:</p>
+
+ <example>
+ char *handler
+ </example>
+
+ <p>Если вы хотите в своём модуле использовать обработчик,
+ то всё, что вам надо сделать, это записать в <code>r->handler</code>
+ имя соответствующего обработчика, причём сделать это необходимо
+ перед тем, как запрос доходит до стадии <code>invoke_handler</code>.
+ Обработчики реализуются точно так же, как и раньше,
+ за исключением лишь того, что теперь необходимо указывать
+ имя обработчика, а не тип содержимого (content type).
+ Хотя это и не является обязательным, но существуют следующие
+ правила именования обработчиков - необходимо использовать
+ слова, разделённые дефисом и не содержащие косых черт - это
+ позволит не пересекаться с пространством имён медиа-типов (media type).</p>
+ </section>
+</manualpage>
Added: httpd/httpd/branches/2.2.x/docs/manual/invoking.xml.ru
URL: http://svn.apache.org/viewcvs/httpd/httpd/branches/2.2.x/docs/manual/invoking.xml.ru?rev=392410&view=auto
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/invoking.xml.ru (added)
+++ httpd/httpd/branches/2.2.x/docs/manual/invoking.xml.ru [koi8-r] Fri Apr 7 14:25:02 2006
@@ -0,0 +1,140 @@
+<?xml version='1.0' encoding='KOI8-R' ?>
+<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="./style/manual.ru.xsl"?>
+<!-- English Revision: 151408 -->
+
+<!--
+ Copyright 2002-2005 The Apache Software Foundation or its licensors, as
+ applicable.
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<!--***************************************************-->
+<!-- Translator: Ilia Soldatenko (soldis@tversu.ru) -->
+<!-- Reviewers: -->
+<!-- Ivan Shvedov (ivan@tversu.ru) -->
+<!-- Arthur Reznikov (art@altair.tversu.ru)-->
+<!--***************************************************-->
+
+<manualpage metafile="invoking.xml.meta">
+
+ <title>Запуск Apache</title>
+
+<summary>
+ <p>На Windows платформах Apache обычно работает как сервис Windows NT/2000/XP
+ или как консольное приложение Windows 95/ME. Для получения более подробной
+ информации по этому вопросу, обратитесь к документам, объясняющим <a
+ href="platform/windows.html#winsvc">работу Apache под Windows в качестве сервиса</a> и
+ <a href="platform/windows.xml#wincons">работу Apache под Windows в качестве консольного
+ приложения</a>.</p>
+
+ <p>В Unix программа <program>httpd</program> представляет собой
+ демон, выполняющийся в фоновом режиме и обслуживающий поступающие запросы.
+ О том, каким образом можно запустить <program>httpd</program> и что в результате этого
+ получится, и рассказывается в этом документе.</p>
+</summary>
+
+<seealso><a href="stopping.html">Останов и перезапуск</a></seealso>
+<seealso><program>httpd</program></seealso>
+<seealso><program>apachectl</program></seealso>
+
+<section id="startup"><title>Что происходит в момент запуска Apache</title>
+
+ <p>Если в директиве <directive module="mpm_common">Listen</directive>
+ в конфигурационном файле указано значение 80 (задаваемое по умолчанию)
+ или любое другое значение порта меньшее 1024, то для запуска Apache
+ необходимо быть привилегированным пользователем, так как Apache придется
+ подключаться к привилегированному порту. После того, как сервер запустился
+ и выполнил ряд подготовительных операций, таких как открытие своих log-файлов,
+ он порождает несколько <em>процессов потомков</em>, которые и будут выполнять
+ всю работу по обработке запросов от клиентов. Основной процесс <code>httpd</code>
+ выполняется с правами привилегированного пользователя, в то время как процессы
+ потомки имеют меньший приоритет. Все это контролируется <a
+ href="mpm.html">МП-модулем</a>, который компилируется вместе с сервером.</p>
+
+ <p>Для запуска демона <program>httpd</program> лучше всего использовать скрипт
+ <program>apachectl</program>. Этот скрипт устанавливает ряд
+ переменных окружения, необходимых для правильной работы сервера под некоторыми
+ операционными системами, а затем запускает исполняемый файл <program>httpd</program>.
+ Скрипт <program>apachectl</program> передаст серверу любую командную строку, так что
+ при вызове можно указывать в его командной строке все необходимые для сервера опции.
+ Вы также можете вручную внести некоторые изменения в скрипт <program>apachectl</program>,
+ в частности, изменив значение переменной <code>HTTPD</code> для запуска Apache
+ из другого каталога, и указав опции, которые будут передаваться серверу <em>каждый раз</em>
+ при его запуске.</p>
+
+ <p>Первым делом <code>httpd</code> находит и считывает <a href="configuring.html">конфигурационный
+ файл</a> <code>httpd.conf</code>. Путь к этому файлу задается еще во время сборки сервера,
+ но его можно изменить и после этого, запустив сервер с опцией <code>-f</code>, как это показано
+ в следующем примере</p>
+
+<example>/usr/local/apache2/bin/apachectl -f
+ /usr/local/apache2/conf/httpd.conf</example>
+
+ <p>Если во время запуска не возникло никаких проблем, то сервер отсоединится
+ от консоли и приглашение на ввод командной строки вернется к пользователю
+ практически мгновенно. Это указывает на то, что сервер запустился и теперь
+ выполняет свою работу. Теперь вы можете, используя браузер, подключиться к
+ нему и увидеть тестовую страницу, находящуюся в каталоге
+ <directive module="core">DocumentRoot</directive>, а также локальную копию документации,
+ ссылку на которую вы найдете на той же странице.</p>
+</section>
+
+<section id="errors"><title>Ошибки, которые могут возникнуть во время запуска</title>
+
+ <p>Если во время запуска Apache произойдет какая-либо фатальная ошибка,
+ то перед тем, как завершить свою работу, сервер пошлет на консоль или в
+ <directive module="core">ErrorLog</directive> сообщение, описывающее
+ данную ошибку. Наиболее распространенным сообщением об ошибке является
+ <code>"Unable to bind to Port ..."</code>. Подобная ошибка возникает в двух случаях:</p>
+
+ <ul>
+ <li>Если вы пытаетесь запустить сервер на привилегированном порту, будучи зарегистрированным
+ в системе как обычный пользователь; или</li>
+
+ <li>Если вы пытаетесь запусть сервер, когда в системе уже есть выполняющийся демон Apache
+ или другой web-сервер, слушающий тот же самый порт.</li>
+ </ul>
+
+ <p>Решение многих подобных проблем можно найти на странице
+ <a href="faq/">FAQ</a>.</p>
+</section>
+
+<section id="boot"><title>Запуск сервера вместе с запуском всей системы</title>
+
+ <p>Если вы хотите, чтобы сервер запускался автоматически после перезагрузки системы,
+ добавьте вызов скрипта <program>apachectl</program> в системные файлы, отвечающие за загрузку
+ операционной среды (обычно это <code>rc.local</code> или файлы в каталоге <code>rc.N</code>).
+ Это приведет к запуску Apache от имени привилегированного пользователя.
+ Во избежание проблем с безопасностью системы, убедитесь, что сервер сконфигурирован правильно.</p>
+
+ <p>Скрипт <program>apachectl</program> разработан таким образом, что он может
+ действовать как стандартный init-скрипт системы SysV; он может принимать
+ аргументы <code>start</code>, <code>restart</code>, и <code>stop</code>
+ и переводить их в соответствующие сигналы процессу <program>httpd</program>.
+ Поэтому чаще всего вам достаточно сделать ссылку на <program>apachectl</program>
+ в запускном каталоге процесса init. Но прежде чем делать это, узнайте
+ точные требования вашей системы.</p>
+</section>
+
+<section id="info"><title>Дополнительная информация</title>
+
+ <p>Дополнительную информацию по опциям командной строки <program>httpd</program>
+ и <program>apachectl</program>, а также других
+ вспомогательных программ, вы можете найти на странице <a href="programs/">"Сервер
+ и вспомогательные программы"</a>. Имеется также <a href="mod/directives.html">документация</a>
+ на все модули, входящие в дистрибутив Apache, и все директивы, которые они предоставляют.</p>
+</section>
+
+</manualpage>
Added: httpd/httpd/branches/2.2.x/docs/manual/mod/allmodules.xml.ru
URL: http://svn.apache.org/viewcvs/httpd/httpd/branches/2.2.x/docs/manual/mod/allmodules.xml.ru?rev=392410&view=auto
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/mod/allmodules.xml.ru (added)
+++ httpd/httpd/branches/2.2.x/docs/manual/mod/allmodules.xml.ru [koi8-r] Fri Apr 7 14:25:02 2006
@@ -0,0 +1,85 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<modulefilelist>
+ <modulefile>core.xml</modulefile>
+ <modulefile>mod_actions.xml</modulefile>
+ <modulefile>mod_alias.xml</modulefile>
+ <modulefile>mod_asis.xml</modulefile>
+ <modulefile>mod_auth_basic.xml</modulefile>
+ <modulefile>mod_auth_digest.xml</modulefile>
+ <modulefile>mod_authn_alias.xml</modulefile>
+ <modulefile>mod_authn_anon.xml</modulefile>
+ <modulefile>mod_authn_dbd.xml</modulefile>
+ <modulefile>mod_authn_dbm.xml</modulefile>
+ <modulefile>mod_authn_default.xml</modulefile>
+ <modulefile>mod_authn_file.xml</modulefile>
+ <modulefile>mod_authnz_ldap.xml</modulefile>
+ <modulefile>mod_authz_dbm.xml</modulefile>
+ <modulefile>mod_authz_default.xml</modulefile>
+ <modulefile>mod_authz_groupfile.xml</modulefile>
+ <modulefile>mod_authz_host.xml</modulefile>
+ <modulefile>mod_authz_owner.xml</modulefile>
+ <modulefile>mod_authz_user.xml</modulefile>
+ <modulefile>mod_autoindex.xml</modulefile>
+ <modulefile>mod_cache.xml</modulefile>
+ <modulefile>mod_cern_meta.xml</modulefile>
+ <modulefile>mod_cgi.xml</modulefile>
+ <modulefile>mod_cgid.xml</modulefile>
+ <modulefile>mod_charset_lite.xml</modulefile>
+ <modulefile>mod_dav.xml</modulefile>
+ <modulefile>mod_dav_fs.xml</modulefile>
+ <modulefile>mod_dav_lock.xml</modulefile>
+ <modulefile>mod_dbd.xml</modulefile>
+ <modulefile>mod_deflate.xml</modulefile>
+ <modulefile>mod_dir.xml</modulefile>
+ <modulefile>mod_disk_cache.xml</modulefile>
+ <modulefile>mod_dumpio.xml</modulefile>
+ <modulefile>mod_echo.xml</modulefile>
+ <modulefile>mod_env.xml</modulefile>
+ <modulefile>mod_example.xml</modulefile>
+ <modulefile>mod_expires.xml</modulefile>
+ <modulefile>mod_ext_filter.xml</modulefile>
+ <modulefile>mod_file_cache.xml</modulefile>
+ <modulefile>mod_filter.xml</modulefile>
+ <modulefile>mod_headers.xml</modulefile>
+ <modulefile>mod_ident.xml</modulefile>
+ <modulefile>mod_imagemap.xml</modulefile>
+ <modulefile>mod_include.xml</modulefile>
+ <modulefile>mod_info.xml</modulefile>
+ <modulefile>mod_isapi.xml</modulefile>
+ <modulefile>mod_ldap.xml</modulefile>
+ <modulefile>mod_log_config.xml</modulefile>
+ <modulefile>mod_log_forensic.xml</modulefile>
+ <modulefile>mod_logio.xml</modulefile>
+ <modulefile>mod_mem_cache.xml</modulefile>
+ <modulefile>mod_mime.xml</modulefile>
+ <modulefile>mod_mime_magic.xml</modulefile>
+ <modulefile>mod_negotiation.xml</modulefile>
+ <modulefile>mod_nw_ssl.xml</modulefile>
+ <modulefile>mod_proxy.xml</modulefile>
+ <modulefile>mod_proxy_ajp.xml</modulefile>
+ <modulefile>mod_proxy_balancer.xml</modulefile>
+ <modulefile>mod_proxy_connect.xml</modulefile>
+ <modulefile>mod_proxy_ftp.xml</modulefile>
+ <modulefile>mod_proxy_http.xml</modulefile>
+ <modulefile>mod_rewrite.xml</modulefile>
+ <modulefile>mod_setenvif.xml</modulefile>
+ <modulefile>mod_so.xml</modulefile>
+ <modulefile>mod_speling.xml</modulefile>
+ <modulefile>mod_ssl.xml</modulefile>
+ <modulefile>mod_status.xml</modulefile>
+ <modulefile>mod_suexec.xml</modulefile>
+ <modulefile>mod_unique_id.xml</modulefile>
+ <modulefile>mod_userdir.xml</modulefile>
+ <modulefile>mod_usertrack.xml</modulefile>
+ <modulefile>mod_version.xml</modulefile>
+ <modulefile>mod_vhost_alias.xml</modulefile>
+ <modulefile>beos.xml</modulefile>
+ <modulefile>mpm_common.xml</modulefile>
+ <modulefile>event.xml</modulefile>
+ <modulefile>mpm_netware.xml</modulefile>
+ <modulefile>mpmt_os2.xml</modulefile>
+ <modulefile>prefork.xml</modulefile>
+ <modulefile>mpm_winnt.xml</modulefile>
+ <modulefile>worker.xml</modulefile>
+</modulefilelist>
Added: httpd/httpd/branches/2.2.x/docs/manual/mod/directives.xml.ru
URL: http://svn.apache.org/viewcvs/httpd/httpd/branches/2.2.x/docs/manual/mod/directives.xml.ru?rev=392410&view=auto
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/mod/directives.xml.ru (added)
+++ httpd/httpd/branches/2.2.x/docs/manual/mod/directives.xml.ru [koi8-r] Fri Apr 7 14:25:02 2006
@@ -0,0 +1,46 @@
+<?xml version='1.0' encoding='KOI8-R' ?>
+<!DOCTYPE directiveindex SYSTEM "../style/modulesynopsis.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.ru.xsl"?>
+<!-- English Revision: 151408 -->
+
+<!--
+ Copyright 2002-2005 The Apache Software Foundation or its licensors, as
+ applicable.
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<!--***************************************************-->
+<!-- Translator: Ilia Soldatenko (soldis@tversu.ru) -->
+<!-- Reviewers: -->
+<!-- Ivan Shvedov (ivan@tversu.ru) -->
+<!-- Arthur Reznikov (art@altair.tversu.ru)-->
+<!--***************************************************-->
+
+<directiveindex metafile="directives.xml.meta">
+ <title>Алфавитный указатель директив</title>
+ <summary>
+ <p>Здесь приводится список всех директив, которые доступны
+ в стандартном дистрибутиве Apache. Для каждой директивы
+ даётся краткое описание, а смысл всех терминов,
+ использованных при этом, можно найти в <a href="directive-dict.html"
+ rel="Glossary">Глоссарии терминов</a>.
+ </p>
+
+ <p>
+ Также доступно <a href="quickreference.html">Краткое руководство
+ по директивам</a>, в котором приводится суммарная информация
+ по всем директивам.
+ </p>
+ </summary>
+</directiveindex>
Modified: httpd/httpd/branches/2.2.x/docs/manual/new_features_2_0.xml.ru
URL: http://svn.apache.org/viewcvs/httpd/httpd/branches/2.2.x/docs/manual/new_features_2_0.xml.ru?rev=392410&r1=392409&r2=392410&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/new_features_2_0.xml.ru [koi8-r] (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/new_features_2_0.xml.ru [koi8-r] Fri Apr 7 14:25:02 2006
@@ -1,11 +1,11 @@
<?xml version='1.0' encoding='KOI8-R' ?>
<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="./style/manual.ru.xsl"?>
-<!-- English Revision: 96910:328025 (outdated) -->
+<!-- English Revision: 328025 -->
<!--
- Copyright 2002-2005 The Apache Software Foundation or its licensors,
- as applicable.
+ Copyright 2002-2005 The Apache Software Foundation or its licensors, as
+ applicable.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
@@ -20,8 +20,9 @@
limitations under the License.
-->
+
<!--***************************************************-->
-<!-- Translator: Ilia Soldis (rkai@tversu.ru) -->
+<!-- Translator: Ilia Soldatenko (soldis@tversu.ru) -->
<!-- Reviewers: -->
<!-- Ivan Shvedov (ivan@tversu.ru) -->
<!-- Arthur Reznikov (art@altair.tversu.ru)-->
@@ -44,14 +45,14 @@
<dt>Многопоточность в UNIX</dt>
<dd>На UNIX системах, которые поддерживают потоки (нити) стандарта POSIX,
- Apache теперь может выполняться в гибридном многопроцессово -
- многопоточном режиме. Это способствует расширяемости
- системы для многих, но не для всех способов конфигурирования.</dd>
+ Apache теперь может выполняться в гибридном многопроцессово-многопоточном режиме.
+ Это способствует расширяемости
+ системы для многих, но не для всех конфигураций.</dd>
<dt>Новая система сборки</dt>
- <dd>Система сборки была полностью изменена, и теперь основывается на autoconf и libtool.
- Это делает процесс конфигурирования Apache более похожим на подобный процесс в других программных
+ <dd>Система сборки была полностью изменена, и теперь основывается на <code>autoconf</code> и <code>libtool</code>.
+ Это делает процесс конфигурирования Apache более похожим на аналогичный процесс в других программных
продуктах.</dd>
<dt>Поддержка различных протоколов</dt>
@@ -76,39 +77,39 @@
<dt>Новый API для Apache</dt>
- <dd>API для написания модулей значительно изменился в версии 2.0
+ <dd>API для написания модулей значительно изменился в версии 2.0.
Многие из проблем версии 1.3, связанные с порядком следования
модулей и их приоритетами, должны исчезнуть. В версии 2.0
- многие из подобных вещей делаются автоматически, и теперь
- порядок следования модулей определяется посредством специальных
- программных крючков (hooks), отчего настройка сервера становится
- более гибкой. Также были добавлены новые функции, которые
+ большая часть данной работы теперь делается сервером автоматически,
+ а порядок следования модулей определяется отдельно в каждом
+ хуке (hook), что делает процесс более гибким и конфигурируемым.
+ Также были добавлены новые функции, которые
предоставляют дополнительные возможности использования модулей,
- избавляя от необходимости внесения каких - либо изменений в ядро
+ избавляя от необходимости внесения каких-либо изменений в ядро
сервера.</dd>
<dt>Поддержка протокола IPv6</dt>
- <dd>На системах, где протокол IPv6 поддерживается
- базовой библиотекой Apache Portable Runtime, Apache
- по умолчанию получает возможность слушать IPv6 сокеты
- (sockets). В добавок к этому директивы <directive
+ <dd>В системах, где протокол IPv6 поддерживается
+ нижележащей библиотекой Apache Portable Runtime, Apache
+ по умолчанию получает возможность слушать IPv6 сокеты.
+ В добавок к этому директивы <directive
module="mpm_common">Listen</directive>, <directive module="core"
>NameVirtualHost</directive> и <directive module="core"
>VirtualHost</directive> могут работать с адресными строками,
- заданными в формате IPv6 (т.е. например "Listen [2001:db8::1]:8080").</dd>
+ заданными в формате IPv6 (т.е. например "<code>Listen [2001:db8::1]:8080</code>").</dd>
<dt>Использование фильтров</dt>
- <dd>Модули Apache теперь могут быть написаны как фильтры,
- обрабатывающие потоки данных, которые приходят или уходят
+ <dd>Модули Apache теперь можно написать так, что
+ они будут исполнять роль фильтров,
+ обрабатывающих потоки данных, которые приходят или уходят
из сервера. Это позволяет, к примеру, данным, являющимся
результатом работы CGI-скрипта, быть обработанными SSI
- фильтром INCLUDES, предоставляемым модулем
+ фильтром <code>INCLUDES</code>, предоставляемым модулем
<module>mod_include</module>. Модуль <module>mod_ext_filter</module>
- позволяет внешним программам исполнять роль фильтров точно так же
- как и CGI программам позволяется действовать в качестве
- обработчиков (handlers).</dd>
+ позволяет внешним программам исполнять роль фильтров точно таким же образом,
+ каким CGI программы действуют в качестве обработчиков (handlers).</dd>
<dt>Сообщения об ошибках на разных языках</dt>
@@ -120,7 +121,7 @@
<dt>Упрощенная конфигурация</dt>
<dd>Многие запутанные директивы были упрощены. Наиболее
- сбивающие с толку Port и BindAddress были убраны;
+ сбивающие с толку <code>Port</code> и <code>BindAddress</code> были убраны;
для привязки к IP адресу используется только директива
<directive module="mpm_common">Listen</directive>; директива
<directive module="core">ServerName</directive> определяет имя сервера и номер порта
@@ -135,9 +136,9 @@
систем, включая Windows 2000 и Windows XP.
<em>Это не распространяется на такие операционные системы, как
Windows 95, 98 или ME, которые для обращения к файловой системе
- используют локальные машинные кодовые страницы.</em></dd>
+ используют локальные кодовые страницы.</em></dd>
- <dt>Новая библиотека для работы с регулярными выраженями</dt>
+ <dt>Новая библиотека для работы с регулярными выражениями</dt>
<dd>В состав Apache 2.0 была включена <a href="http://www.pcre.org/">
библиотека для работы с Perl-совместимыми регулярными выраженями</a> (PCRE).
@@ -189,7 +190,7 @@
<dt><module>mod_file_cache</module></dt>
<dd>Новый модуль в Apache 2.0. Этот модуль включает в себя
- функциональность модуля mod_mmap_static из Apache 1.3
+ функциональность модуля <code>mod_mmap_static</code> из Apache 1.3
плюс новые возможности кэширования.</dd>
<dt><module>mod_headers</module></dt>
@@ -207,10 +208,10 @@
к этому была введена новая секция <directive module="mod_proxy" type="section"
>Proxy</directive>, которую можно использовать в конфигурационных файлах, что
обеспечивает более удобный (и более быстрый для ядра сервера) контроль над сайтами,
- использующими proxy-технологию. Перегруженная конфигурация <Directory "proxy:...">
+ использующими proxy-технологию. Перегруженная конфигурация <code><Directory "proxy:..."></code>
более не поддерживается. Модуль теперь разделен на отдельные специфичные модули,
- поддерживающие различные протоколы. Эти модули включают в себя proxy_connect, proxy_ftp
- и proxy_http.</dd>
+ поддерживающие различные протоколы. Эти модули включают в себя <code>proxy_connect</code>, <code>proxy_ftp</code>
+ и <code>proxy_http</code>.</dd>
<dt><module>mod_negotiation</module></dt>
@@ -220,13 +221,13 @@
определенный документ. В дополнение к этому алгоритмы
негоциации (negotiation) и MultiViews были вычищены и исправлены, для
обеспечения более последовательного результата, а также появилась возможность
- включения непосредственного содержимого документов в карту типов (type map).</dd>
+ включения непосредственно содержимого документов в карту типов (type map).</dd>
<dt><module>mod_autoindex</module></dt>
<dd>Листинги автоиндексируемых каталогов теперь могут выдаваться в виде
HTML-таблиц. Появилась возможность более гибкой сортировки, включая сортировку по версиям и
- сортировку с использованием универсальных символов (wildcard).</dd>
+ сортировку с использованием шаблонных символов (wildcard).</dd>
<dt><module>mod_include</module></dt>
@@ -236,7 +237,7 @@
в главном конфигурационном файле, а не в SSI документе. Результаты
обработки регулярных выражений (теперь основывающихся на синтаксисе
регулярных выражений языка Perl) могут быть получены при помощи переменных
- $0 .. $9 модуля mod_include.</dd>
+ <code>$0</code> .. <code>$9</code> модуля <module>mod_include</module>.</dd>
<dt><module>mod_auth_dbm</module></dt>
Added: httpd/httpd/branches/2.2.x/docs/manual/programs/index.xml.ru
URL: http://svn.apache.org/viewcvs/httpd/httpd/branches/2.2.x/docs/manual/programs/index.xml.ru?rev=392410&view=auto
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/programs/index.xml.ru (added)
+++ httpd/httpd/branches/2.2.x/docs/manual/programs/index.xml.ru [koi8-r] Fri Apr 7 14:25:02 2006
@@ -0,0 +1,101 @@
+<?xml version='1.0' encoding='KOI8-R' ?>
+<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.ru.xsl"?>
+<!-- English Revision: 219429 -->
+
+<!--
+ Copyright 2002-2005 The Apache Software Foundation or its licensors, as
+ applicable.
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<!--***************************************************-->
+<!-- Translator: Ilia Soldatenko (soldis@tversu.ru) -->
+<!-- Reviewers: -->
+<!-- Ivan Shvedov (ivan@tversu.ru) -->
+<!-- Arthur Reznikov (art@altair.tversu.ru)-->
+<!--***************************************************-->
+
+<manualpage metafile="index.xml.meta">
+<parentdocument href="../"/>
+
+ <title>Сервер и вспомогательные программы</title>
+
+<summary>
+ <p>Этот документ описывает назначение и ипользование
+ всех исполняемых файлов HTTP сервера Apache.</p>
+</summary>
+
+<section id="index"><title>Указатель</title>
+
+ <dl>
+ <dt><program>httpd</program></dt>
+
+ <dd>HTTP сервер Apache</dd>
+
+ <dt><program>apachectl</program></dt>
+
+ <dd>Интерфейс управления HTTP сервером Apache</dd>
+
+ <dt><program>ab</program></dt>
+
+ <dd>Утилита для тестирования HTTP сервера Apache</dd>
+
+ <dt><program>apxs</program></dt>
+
+ <dd>Утилита APache eXtenSion</dd>
+
+ <dt><program>dbmmanage</program></dt>
+
+ <dd>Создание и обновление файлов паролей пользователей в формате DBM,
+ необходимых для базовой аутентификации (basic authentification)</dd>
+
+ <dt><program>htcacheclean</program></dt>
+ <dd>Очистить кэш на диске</dd>
+
+ <dt><program>htdigest</program></dt>
+
+ <dd>Создание и обновление файлов паролей пользователей для
+ дайджестной аутентификации (digest authentification)</dd>
+
+ <dt><program>htpasswd</program></dt>
+
+ <dd>Создание и обновление файлов паролей пользователей
+ для базовой аутентификации (basic authentification)</dd>
+
+ <dt><program>httxt2dbm</program></dt>
+
+ <dd>Создание dbm файлов для использования с RewriteMap</dd>
+
+ <dt><program>logresolve</program></dt>
+
+ <dd>Утилита для преобразования IP-адресов в соответствующие
+ им имена хостов в лог-файлах Apache</dd>
+
+ <dt><program>rotatelogs</program></dt>
+
+ <dd>Утилита, позволяющая производить ротацию лог-файлов Apache без
+ остановки сервера</dd>
+
+ <dt><program>suexec</program></dt>
+
+ <dd>Switch User For Exec - утилита, позволяющая выполнять CGI-скрипт от имени
+ другого пользователя</dd>
+
+ <dt><a href="other.html">Другие программы</a></dt>
+ <dd>Вспомогательные утилиты, не имеющие своих собственных справочных руководств</dd>
+ </dl>
+</section>
+
+</manualpage>
Added: httpd/httpd/branches/2.2.x/docs/manual/vhosts/index.xml.ru
URL: http://svn.apache.org/viewcvs/httpd/httpd/branches/2.2.x/docs/manual/vhosts/index.xml.ru?rev=392410&view=auto
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/vhosts/index.xml.ru (added)
+++ httpd/httpd/branches/2.2.x/docs/manual/vhosts/index.xml.ru [koi8-r] Fri Apr 7 14:25:02 2006
@@ -0,0 +1,110 @@
+<?xml version='1.0' encoding='KOI8-R' ?>
+<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.ru.xsl"?>
+<!-- English Revision: 151408 -->
+
+<!--
+ Copyright 2002-2005 The Apache Software Foundation or its licensors, as
+ applicable.
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<!--***************************************************-->
+<!-- Translator: Veniamin Zolotuhin(venya@dergachi.net)-->
+<!-- Reviewers: -->
+<!-- Ivan Shvedov (ivan@tversu.ru) -->
+<!-- Arthur Reznikov (art@altair.tversu.ru)-->
+<!--***************************************************-->
+
+<manualpage metafile="index.xml.meta">
+<parentdocument href="../"/>
+
+ <title>Документация по виртуальным хостам в Apache</title>
+
+<summary>
+
+ <p>Термин <cite>виртуальный хост</cite> относится к практике
+ размещения более чем одного веб-сайта (например,
+ <code>www.company1.com</code> и <code>www.company2.com</code>)
+ на одной машине. Виртуальный хост может быть как «<a
+ href="ip-based.html">привязанным к IP-адресу</a>», что означает
+ использование отдельного IP адреса для каждого сайта, либо «<a
+ href="name-based.html">привязанным к имени</a>», позволяя вам
+ иметь несколько различных имён для каждого IP-адреса. Факт того,
+ что эти сайты работают на одном и том же физическом сервере,
+ не очевиден конечным пользователям.</p>
+
+ <p>Apache был одним из первых серверов, который поддерживал IP-привязанные
+ виртуальные хосты. Версии Apache 1.1 и более новые поддерживают как
+ IP-привязанные, так и виртуальные хосты, определяемые по имени.
+ Последний вариант виртуальных хостов также иногда
+ называют <em>хост-привязанными</em> или <em>не-IP виртуальными хостами</em>.</p>
+
+ <p>Ниже вы видите список документов, которые детально объясняют
+ поддержку виртуальных хостов в Apache 1.3 и выше.</p>
+
+</summary>
+
+<seealso><module>mod_vhost_alias</module></seealso>
+<seealso><a href="name-based.html">Виртуальные хосты, основанные на имени</a></seealso>
+<seealso><a href="ip-based.html">IP-привязанные виртуальные хосты</a></seealso>
+<seealso><a href="examples.html">Примеры виртуальных хостов</a></seealso>
+<seealso><a href="fd-limits.html">Ограничения файловых дескрипторов</a></seealso>
+<seealso><a href="mass.html">Массовый виртуальный хостинг</a></seealso>
+<seealso><a href="details.html">Подробности выбора соответствующего хоста</a></seealso>
+
+<section id="support"><title>Поддержка виртуальных хостов</title>
+
+ <ul>
+ <li><a href="name-based.html">Виртуальные хосты, основанные на имени</a>
+ (несколько веб-сайтов на одном IP адресе).</li>
+ <li><a href="ip-based.html">IP-привязанные виртуальные хосты</a> (отдельный
+ IP адрес для каждого веб-сайта).</li>
+ <li><a href="examples.html">Примеры виртуальных хостов для стандартных случаев</a>.</li>
+ <li><a href="fd-limits.html">Ограничения файловых дескрипторов</a> (или,
+ <em>Too many log files</em>)</li>
+ <li><a href="mass.html">Динамически конфигурируемый массовый виртуальный хостинг</a></li>
+ <li><a href="details.html">Подробное обсуждение алгоритма выбора соответствующего хоста</a></li>
+ </ul>
+
+</section>
+
+<section id="directives"><title>Конфигурационные директивы</title>
+
+ <ul>
+ <li><directive type="section"
+ module="core">VirtualHost</directive></li>
+ <li><directive module="core">NameVirtualHost</directive></li>
+ <li><directive module="core">ServerName</directive></li>
+ <li><directive module="core">ServerAlias</directive></li>
+ <li><directive module="core">ServerPath</directive></li>
+ </ul>
+
+ <p>Если вы пытаетесь отлаживать вашу конфигурацию с виртуальными хостами, то
+ ключ для запуска Apache из командной строки <code>-S</code> будет крайне полезен.
+ То есть, слудет использовать следующую команду:</p>
+
+ <example>
+ /usr/local/apache2/bin/httpd -S
+ </example>
+
+ <p>Эта команда распечатает описание того, как Apache разобрал
+ файл конфигурации. Тщательное изучение IP адресов и имён серверов
+ поможет найти ошибки конфигурации. (Смотрите также
+ документацию к программе <program>httpd</program> для
+ изучения других параметров для запуска из командной строки.)</p>
+
+</section>
+</manualpage>
+