diff options
author | Ilia Soldatenko <soldis@apache.org> | 2006-04-07 19:59:51 +0000 |
---|---|---|
committer | Ilia Soldatenko <soldis@apache.org> | 2006-04-07 19:59:51 +0000 |
commit | a604b4284a35e99077eea638a968ac2d2d76aab5 (patch) | |
tree | 77f33b2f0a0ba39cf75db2ddfa57c093c74c4ff6 | |
parent | e0e69205627dff11410309dea39b5e43335f6ea9 (diff) | |
download | httpd-a604b4284a35e99077eea638a968ac2d2d76aab5.tar.gz |
All russian translations have been updated and are now up to date with the latest English revision.
(russian translation)
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.0.x@392374 13f79535-47bb-0310-9956-ffa450edef68
-rw-r--r-- | docs/manual/filter.xml.ru | 17 | ||||
-rw-r--r-- | docs/manual/handler.xml.ru | 42 | ||||
-rw-r--r-- | docs/manual/index.xml.ru | 4 | ||||
-rw-r--r-- | docs/manual/install.xml.ru | 500 | ||||
-rw-r--r-- | docs/manual/invoking.xml.ru | 2 | ||||
-rw-r--r-- | docs/manual/mod/directives.xml.ru | 9 | ||||
-rw-r--r-- | docs/manual/mod/quickreference.xml.ru | 27 | ||||
-rw-r--r-- | docs/manual/mpm.xml.ru | 37 | ||||
-rw-r--r-- | docs/manual/new_features_2_0.xml.ru | 2 | ||||
-rw-r--r-- | docs/manual/programs/index.xml.ru | 27 | ||||
-rw-r--r-- | docs/manual/style/lang/ru.xml | 5 | ||||
-rw-r--r-- | docs/manual/upgrading.xml.ru | 69 | ||||
-rw-r--r-- | docs/manual/vhosts/index.xml.ru | 57 |
13 files changed, 325 insertions, 473 deletions
diff --git a/docs/manual/filter.xml.ru b/docs/manual/filter.xml.ru index 2fca893690..67b41764b2 100644 --- a/docs/manual/filter.xml.ru +++ b/docs/manual/filter.xml.ru @@ -1,10 +1,11 @@ <?xml version="1.0" encoding="KOI8-R" ?> <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd"> <?xml-stylesheet type="text/xsl" href="./style/manual.en.xsl"?> -<!-- English Revision: 99377:151405 (outdated) --> +<!-- English Revision: 151405 --> <!-- - Copyright 2003-2004 The Apache Software Foundation + 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,7 +21,7 @@ --> <!--***************************************************--> -<!-- Translator: Ilia Soldis (rkai@tversu.ru) --> +<!-- Translator: Ilia Soldatenko (soldis@tversu.ru) --> <!-- Reviewers: --> <!-- Ivan Shvedov (ivan@tversu.ru) --> <!-- Arthur Reznikov (art@altair.tversu.ru)--> @@ -59,11 +60,11 @@ клиента, обрабатываются <em>входным (input)</em> фильтром, в то время как данные, посылаемые сервером клиенту - <em>выходным (output)</em>. К одним и тем же данным можно - применять последовательно несколько фильтров, причем + применять последовательно несколько фильтров, причём порядок их следования может быть явно задан.</p> - <p>Фильтры используются самим серером Apache, для выполнения - функций обработки данных. В дополнение к этому, фильтры могут + <p>Фильтры используются самим серером Apache для выполнения + функций обработки данных. В дополнение к этому фильтры могут предоставляться модулями - в этом случае управление ими производится посредством соответствующих директив, указываемых в конфигурационном файле. К числу таких директив @@ -72,7 +73,7 @@ <directive module="core">SetOutputFilter</directive>, <directive module="mod_mime">AddInputFilter</directive>, <directive module="mod_mime">AddOutputFilter</directive>, - <directive module="mod_mime">RemoveInputFilter</directive>, and + <directive module="mod_mime">RemoveInputFilter</directive>, и <directive module="mod_mime">RemoveOutputFilter</directive>.</p> <p>В стандартный дистрибутив HTTP сервера Apache в настоящее время @@ -87,7 +88,7 @@ </dd> </dl> - <p>В дополнение к этому, модуль <module>mod_ext_filter</module> + <p>Модуль <module>mod_ext_filter</module> позволяет использовать внешние программы в качестве фильтров.</p> </section> </manualpage> diff --git a/docs/manual/handler.xml.ru b/docs/manual/handler.xml.ru index 77767b6f54..3120645f27 100644 --- a/docs/manual/handler.xml.ru +++ b/docs/manual/handler.xml.ru @@ -4,7 +4,8 @@ <!-- English Revision: 151405 --> <!-- - Copyright 2003-2004 The Apache Software Foundation + 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,7 +21,7 @@ --> <!--***************************************************--> -<!-- Translator: Ilia Soldis (rkai@tversu.ru) --> +<!-- Translator: Ilia Soldatenko (soldis@tversu.ru) --> <!-- Reviewers: --> <!-- Ivan Shvedov (ivan@tversu.ru) --> <!-- Arthur Reznikov (art@altair.tversu.ru)--> @@ -31,7 +32,7 @@ <title>Использование обработчиков в Apache</title> <summary> - <p>Этот документ описывает использование обработчиков (handlers) в Apache</p> + <p>Этот документ описывает использование обработчиков (handlers) в Apache.</p> </summary> <section id="definition"> @@ -57,22 +58,22 @@ <p>Обработчик является внутренней структурой - Apache, которая задает поведение сервера при обработке + Apache, которая задаёт поведение сервера при обработке запрашиваемого файла. Как правило, каждому файлу соответствует - свой внутренний обработчик, который назначается сервером, + свой внутренний обработчик, который назначается сервером исходя из типа файла. Обычно файлы просто возвращаются пользователю, но некоторые типы файлов предварительно обрабатываются (handled) сервером.</p> <p>В Apache 1.1 добавлена возможность использовать обработчики - явно. Причем обработка файлов может основываться + явно. Причём обработка файлов может основываться теперь не только на их типе, но и на расширении файлов или их местонахождении. Это представляется наиболее удачным решением, во-первых потому, что это решение элегантно, а во-вторых, это позволяет ассоциировать с файлом как тип, <strong>так и</strong> обработчик. (См. также - <a href="mod/mod_mime.html#multipleext">"Файлы с несколькими - расширениями"</a>)</p> + <a href="mod/mod_mime.html#multipleext">«Файлы с несколькими + расширениями»</a>)</p> <p>Обработчики могут представлять из себя как вкомпилированные в сервер (или подключаемые с помощью @@ -82,8 +83,8 @@ обработчики:</p> <ul> - <li><strong>default-handler</strong>: Посылает файл, используя - <code>default_handler()</code>, который является обработчиком + <li><strong>default-handler</strong>: Посылает файл, используя функцию + <code>default_handler()</code>, которая является обработчиком по-умолчанию для статических файлов. (ядро)</li> <li><strong>send-as-is</strong>: Посылает файл, содержащий в @@ -109,7 +110,7 @@ <title>Примеры</title> <section id="example1"> - <title>Обработка статического содержимого документа CGI-скриптом</title> + <title>Обработка статического документа CGI-скриптом</title> <p>При использовании следующих директив, каждый запрос файла с расширением <code>html</code> будет запускать на выполнение @@ -124,7 +125,7 @@ <p>В этом случает CGI-скрипт ответственен за то, чтобы выслать пользователю запрошенный документ (на который указывает переменная окружения <code>PATH_TRANSLATED</code>), сделав - в нем предварительно все необходимые изменения.</p> + в нём предварительно все необходимые изменения.</p> </section> <section id="example2"> @@ -149,28 +150,23 @@ <p>Для того чтобы можно было использовать обработчики, в <a href="developer/API.html">Apache API</a> были внесены - некоторые дополнения. В частности в структуру <code>request_rec</code> + некоторые дополнения. В частности, в структуру <code>request_rec</code> было добавлено новое поле:</p> <example> char *handler </example> - <p>Если вы хотите в своем модуле использовать обработчик, - то все, что вам надо сделать, это записать в <code>r->handler</code> - имя соответствующего обработчика, причем сделать это необходимо + <p>Если вы хотите в своём модуле использовать обработчик, + то всё, что вам надо сделать, это записать в <code>r->handler</code> + имя соответствующего обработчика, причём сделать это необходимо перед тем, как запрос доходит до стадии <code>invoke_handler</code>. Обработчики реализуются точно так же, как и раньше, за исключением лишь того, что теперь необходимо указывать имя обработчика, а не тип содержимого (content type). Хотя это и не является обязательным, но существуют следующие правила именования обработчиков - необходимо использовать - слова, разделенные дефисом и не содержащие косых черт - это - позволит не пересекаться с пространством имен медиа-типов (media type).</p> + слова, разделённые дефисом и не содержащие косых черт - это + позволит не пересекаться с пространством имён медиа-типов (media type).</p> </section> </manualpage> - - - - - diff --git a/docs/manual/index.xml.ru b/docs/manual/index.xml.ru index 0a564bc98a..c572270efe 100644 --- a/docs/manual/index.xml.ru +++ b/docs/manual/index.xml.ru @@ -20,7 +20,7 @@ --> <!--***************************************************--> -<!-- Translator: Ilia Soldis (rkai@tversu.ru) --> +<!-- Translator: Ilia Soldatenko (soldis@tversu.ru) --> <!-- Reviewers: --> <!-- Ivan Shvedov (ivan@tversu.ru) --> <!-- Arthur Reznikov (art@altair.tversu.ru)--> @@ -43,7 +43,7 @@ <page href="invoking.html">Запуск Apache</page> <page href="stopping.html">Останов и перезапуск</page> <page href="mod/directives.html">Алфавитный указатель директив</page> - <page href="mod/quickreference.html">Краткое руководство по директивам</page> + <page href="mod/quickreference.html">Краткий справочник по директивам</page> <page href="mod/">Modules</page> <page href="mpm.html">Мульти-процессные модули (МП-модули)</page> <page href="filter.html">Фильтры</page> diff --git a/docs/manual/install.xml.ru b/docs/manual/install.xml.ru index 4f8f34a2a1..90ecd71c70 100644 --- a/docs/manual/install.xml.ru +++ b/docs/manual/install.xml.ru @@ -1,10 +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: 97974:333057 (outdated) --> +<!-- English Revision: 333057 --> <!-- - Copyright 2002-2004 The Apache Software Foundation + 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,7 +21,7 @@ --> <!--***************************************************--> -<!-- Translator: Ilia Soldis (soldis@infolio.ru) --> +<!-- Translator: Ilia Soldatenko (soldis@tversu.ru) --> <!-- Reviewers: --> <!-- Ivan Shvedov (ivan@tversu.ru) --> <!-- Arthur Reznikov (art@altair.tversu.ru)--> @@ -34,30 +35,35 @@ <p>Этот документ освещает вопросы компилирования и установки сервера Apache только на UNIX и UNIX-подобных системах. Если вы хотите установить - сервер под Windows, то вам необходимо прочесть документ <a - href="platform/windows.html">"Использование Apache под Microsoft Windows"</a>. + сервер под Windows, то вам необходимо прочитать документ <a + href="platform/windows.html">«Использование Apache под Microsoft Windows»</a>. Информация, касающаяся остальных платформ, содержится в документе - <a href="platform/">"Платформы"</a>.</p> + <a href="platform/">«Платформы»</a>.</p> <p>Среда конфигурирования и установки сервера полностью отличается от той, которая была в Apache 1.3. Apache 1.3 использовал обычный набор скриптов, позволявший упростить процесс установки. Apache 2.0 теперь использует системы <code>libtool</code> и <code>autoconf</code>, что делает сервер похожим на другие программные продукты с открытым исходным кодом (Open Source projects).</p> + + <p>Если вы переходите от младшего релиза сервера к старшему внутри + одной и той же ветки (например, от 2.0.50 к 2.0.51), то + можете начать чтение с раздела <a href="#upgrading">апгрейд</a>.</p> </summary> +<seealso><a href="programs/configure.html">Конфигурирование дерева исходных кодов</a></seealso> <seealso><a href="invoking.html">Запуск сервера</a></seealso> <seealso><a href="stopping.html">Остановка и перезапуск</a></seealso> -<section id="overview"><title>Краткий обзор "для нетерпеливых"</title> +<section id="overview"><title>Краткий обзор «для нетерпеливых»</title> <table> + <columnspec><column width=".13"/><column width=".80"/></columnspec> <tr> <td><a href="#download">Загрузка</a></td> - <td><code>$ lynx - http://www.apache.org/dist/httpd/httpd-2_0_<em>NN</em>.tar.gz</code> + <td><code>$ lynx http://httpd.apache.org/download.cgi</code> </td> </tr> @@ -108,7 +114,7 @@ <code>/usr/local/apache2</code>.</p> <p>Более подробно все этапы компилирования и установки сервера рассмотрены - ниже, причем начинается следующий раздел с описания системных требований, + ниже, причём начинается следующий раздел с описания системных требований, необходимых, для того чтобы установка прошла успешно.</p> </section> @@ -126,7 +132,7 @@ Apache.</dd> <dt>ANSI-C компилятор и необходимая среда сборки</dt> - <dd>Убедитесь, что на вашей системе установлен ANSI-C + <dd>Убедитесь, что в вашей системе установлен ANSI-C компилятор. Рекомендуется использовать <a href="http://www.gnu.org/software/gcc/gcc.html">GNU C компилятор (GCC)</a> от <a @@ -145,20 +151,23 @@ (Network Time Protocol - NTP). Для получения более подробной информации об NTP и серверах синхронизации времени, обратитесь в группу новостей Usenet <a href="news:comp.protocols.time.ntp">comp.protocols.time.ntp</a>, - а также посетите <a href="http://www.eecis.udel.edu/~ntp/">домашнюю страницу NTP</a></dd> + а также посетите <a href="http://www.ntp.org">домашнюю страницу NTP</a>.</dd> <dt><a href="http://www.perl.org/">Perl 5</a> - [НЕОБЯЗАТЕЛЬНО]</dt> - <dd>Для выполнения некоторых вспомогательных скриптов, таких как <a - href="programs/apxs.html">apxs</a> или <a href="programs/dbmmanage.html">dbmmanage</a> + [ОПЦИОНАЛЬНО]</dt> + <dd>Для выполнения некоторых вспомогательных скриптов, таких как + <program>apxs</program> или <program>dbmmanage</program> (которые написаны на Perl), необходим интерпретатор с языка Perl - (версии 5.003 или выше достаточно). Если конфигурационный скрипт - `<code>configure</code>' не найдет его в вашей системе, то вы все равно - сможете собрать и установить Apache 2.0 - в этом случае не будут - работать только перечисленные выше вспомогательные скрипты. Если в вашей + (версии 5.003 или выше достаточно). + Если в вашей системе установлено несколько интерпретаторов с языка Perl (например Perl 4 и Perl 5), - то для того чтобы скрипт <code>./configure</code> выбрал нужный, выполните - его с опцией <code>--with-perl</code> (описание смотрите ниже).</dd> + то для того чтобы скрипт <program>configure</program> выбрал нужный, выполните + его с опцией <code>--with-perl</code> (описание смотрите ниже). + Если конфигурационный скрипт + <program>configure</program> не найдёт его в вашей системе, то вы всё равно + сможете собрать и установить Apache 2.0 - в этом случае не будут + работать только перечисленные выше вспомогательные скрипты. + </dd> </dl> </section> @@ -167,69 +176,38 @@ <p>Apache можно загрузить со <a href="http://httpd.apache.org/download.cgi">страницы загрузки Apache HTTP Software Foundation</a>, на которой также приводится список некоторых зеркальных серверов. - Здесь вы найдете самую последнюю стабильную версию сервера.</p> - - <p>После загрузки, особенно если она происходила с зеркального - сервера, необходимо убедиться, что у вас в руках полная, - неизмененная версия HTTP сервера Apache. Это выполняется - тестированием архива (tarball) на соответствие PGP подписи, что является, в - свою очередь, двушаговой процедурой. Во-первых, вы должны - загрузить файл <code>KEYS</code> со <a - href="http://www.apache.org/dist/httpd/">страницы загрузки - Apache Software Foundation</a>. (Для того чтобы быть уверенным в том, - что сам файл <code>KEYS</code> не был изменен, его лучше взять из - предыдущего дистрибутива Apache или взять с сервера - открытых ключей.) Затем ключи можно импортировать в вашу личную базу - данных ключей посредством следующих команд (в зависимости от - версии pgp):</p> - -<example>$ pgp < KEYS</example> - - <p>или </p> - -<example>$ gpg --import KEYS</example> - - <p>Следующий шаг заключается в непосредственной проверке - архива (tarball) с использованием PGP подписи, которую всегда - надо брать на <a href="http://www.apache.org/dist/httpd/">основном - веб-сервере Apache</a>. Файл с PGP подписью имеет то же имя, что - и архив дистрибутива плюс окончание <code>.asc</code>. Проверить - дистрибутив можно, набрав следующие команды (опять же, это зависит - от версии pgp, установленного в вашей системе):</p> - -<example>$ pgp httpd-2_0_<em>NN</em>.tar.gz.asc</example> - - <p>или</p> - -<example>$ gpg --verify httpd-2_0_<em>NN</em>.tar.gz.asc</example> - - <p>Вы должны увидеть что-то вроде:</p> - -<example>Good signature from user "Martin Kraemer - <martin@apache.org>".</example> - - <p>В зависимости от доверительных отношений, содержащихся в вашей - базе данных ключей, вы можете также получить сообщение о том, - что отношение между ключем и тем, кто им подписался, невозможно - установить. Это не должно вас беспокоить в том случае, если - вы уверены в подлинности файла <code>KEYS</code>.</p> + Пользователям, работающим на unix-подобных системах, рекомендуется + собирать Apache из исходных кодов. Процесс сборки (описанный ниже) + достаточно прост и позволяет настроить сервер под ваши нужды. + К тому же зачастую бинарные пакеты содержат устаревшую версию сервера. + Если же вы всё-таки загрузили бинарный пакет, то следуйте инструкциям, + находящимся в файле <code>INSTALL.bindist</code> из дистрибутива.</p> + + <p>После загрузки дистрибутива, необходимо убедиться, что у вас в руках полная, + неизменённая версия HTTP сервера Apache. Это можно сделать + тестированием архива (tarball) на соответствие PGP подписи. + Процедура проверки детально описана на <a + href="http://httpd.apache.org/download.cgi#verify">странице + загрузки</a>. Также вы можете посмотреть <a + href="http://httpd.apache.org/dev/verification.html">подробный + пример использования PGP</a>.</p> </section> <section id="extract"><title>Распаковка</title> - <p>Распаковка архива исходных кодов Apache HTTP сервера + <p>Распаковка архива исходных кодов Apache заключается в его непосредственной распаковке и разархивировании (untarring):</p> <example> - $ gzip -d httpd-2_0_<em>NN</em>.tar.gz<br /> - $ tar xvf httpd-2_0_<em>NN</em>.tar +$ gzip -d httpd-2_0_<em>NN</em>.tar.gz<br /> +$ tar xvf httpd-2_0_<em>NN</em>.tar </example> <p>После выполнения этих команд будет создан новый каталог - с исходными кодами дистрибутива. Вы должны зайти - в этот каталог, прежде чем начнете компилировать сервер.</p> + с исходными кодами сервера. Вы должны зайти + в этот каталог, прежде чем начнёте компилировать сервер.</p> </section> <section id="configure"><title>Конфигурирование дерева исходных кодов</title> @@ -237,29 +215,62 @@ <p>Следующий шаг заключается в конфигурировании дерева исходных кодов в соответствии с той системой, на которую вы устанавливаете сервер, и вашими собственными нуждами. Это делается при помощи - скрипта <code>configure</code>, расположенного в корневом каталоге - дистрибутива. Разработчики, загружающие дерево исходных кодов посредством + скрипта <program>configure</program>, расположенного в корневом каталоге + дистрибутива. (Разработчики, загружающие дерево исходных кодов посредством CVS, должны установить в своей системе утилиты <code>autoconf</code> и <code>libtool</code> и выполнить программу <code>buildconf</code>, прежде чем они смогут продолжнить установку. В официальных выпусках сервера - этого делать не требуется.</p> + этого делать не требуется.)</p> - <p>Для конфигурирования дерева исходных кодов, с использованием + <p>Для конфигурирования дерева исходных кодов с использованием значений всех опций по умолчанию, просто выполните скрипт <code>./configure</code> - без параметров. Для того чтобы изменить значения опций, скрипт <code>configure</code> - предлагает широкий набор переменных и опций командной строки. При этом - переменные окружения помещаются перед командой <code>./configure</code>, в то время как - остальные опции - после. Наиболее важная опция здесь - это префикс каталога - установки, то есть тот путь, по которому впоследствии будет установлен Apache. - Но помимо этой существует еще большой выбор опций, необходимых для тонкой настройки - сервера.</p> + без параметров. Для изменения значений опций, скрипт <program>configure</program> + предлагает широкий набор переменных и опций командной строки.</p> + + <p>Наиболее важная опция здесь - это префикс каталога + установки (<code>--prefix</code>), то есть тот путь, по которому + впоследствии будет установлен Apache. + Возможен более гибкий контроль над тем, куда будут установлены + файлы сервера, осуществляемый дополнительными <a + href="programs/configure.html#installationdirectories">опциями + конфигурации</a>.</p> + + <p>Также сейчас самое время решить, какой <a + href="programs/configure.html#optionalfeatures">функциональностью</a> + вы хотите наделить ваш веб-сервер путём включения и отключения + соответствующих <a href="mod/">модулей</a>. По умолчанию, + Apache компилируется с <a + href="mod/module-dict.html#Status">базовым</a> набором модулей. + Все остальные модули подключаются при помощи опции + <code>--enable-<var>module</var></code>, где <code>module</code> - + это название модуля, из которого убран префикс <code>mod_</code> + и все символы подчёркивания заменены на символы тире. + Вы также можете скомпилировать модули как <a + href="dso.html">динамически подключаемые объекты (DSO)</a> -- + они могут быть загружены и выгружены из сервера во время + его работы -- в этом случае используйте опцию + <code>--enable-<var>module</var>=shared</code>. Отключение + базового модуля производится при помощи опции + <code>--disable-<var>module</var></code>. Используйте данные + опции с осторожностью, так как <program>configure</program> + не сможет предупредить вас в том случае, если модуля, который + вы указали, нет; он просто проигнорирует соответствующую опцию.</p> + + <p>Наконец, иногда бывает необходимо предоставить скрипту + <program>configure</program> дополнительную информацию о + расположении вашего компилятора, библиотек или заголовочных файлов. + Это можно сделать либо при помощи переменных окружения, либо + при помощи опций командной строки скрипта <program>configure</program>. + За более подробной информацией обращайтесь к справочному руководству + скрипта <program>configure</program>.</p> <p>Для того чтобы получить представление о гибкости процесса конфигурирования Apache, - рассмотрите приведенный ниже типичный пример запуска скрипта <code>./configure</code>. - Такая конфигурация позволяет компилировать - сервер в каталог <code>/sw/pkg/apache</code>, используя указанный компилятор с + рассмотрите приведённый ниже типичный пример запуска скрипта <code>./configure</code>. + Такая конфигурация позволяет скомпилировать + сервер для последующей установки + в каталог <code>/sw/pkg/apache</code>, используя указанный компилятор с несколькими предназначенными для него опциями командной строки, и установить - еще два добавочных модуля <module>mod_rewrite</module> и <module>mod_speling</module>, + ещё два добавочных модуля <module>mod_rewrite</module> и <module>mod_speling</module>, которые можно будет потом использовать посредством механизма DSO.</p> <example> @@ -269,254 +280,15 @@ --enable-speling=shared </example> - <p>При выполнении, скрипт <code>configure</code> проверяет, установлено ли в вашей системе - все необходимое, а затем создает Make-файлы (Makefiles), которые будут затем использованы - при компилировании сервера.</p> - - <p>Наиболее простой способ узнать обо всех доступных конфигурационных опциях - это - выполнить команду <code>./configure --help</code>. На экран будет выведено краткое - описание практически всех доступных опций и переменных окружения.</p> - -<section id="environment"><title>Переменные окружения</title> - - <p>Программа <code>autoconf</code> использует ряд переменных окружения для конфигурирования - среды сборки. Вообще, посредством этих переменных можно изменить лишь метод сборки сервера - - контролировать включение и выключение дополнительных опций сервера этим невозможно. Эти - переменные можно включить в среду до вызова скрипта <code>configure</code>, но проще всего - это сделать так, как было показано в примере выше.</p> - - <dl> - <dt><code>CC=...</code></dt> - - <dd>Команда вызова компилятора с языка C</dd> - - <dt><code>CPPFLAGS=...</code></dt> - - <dd>Дополнительные опции препроцессора и компилятора с языка C.</dd> - - <dt><code>CFLAGS=...</code></dt> - - <dd>Опции отладки и оптимизации компилятора с языка C.</dd> - - <dt><code>LDFLAGS=...</code></dt> - - <dd>Дополнительные опции для компоновщика.</dd> - - <dt><code>LIBS=...</code></dt> - - <dd>Информация о расположении библиотек (опции "<code>-L</code>" и - "<code>-l</code>"), передаваемая компоновщику.</dd> - - <dt><code>INCLUDES=...</code></dt> - - <dd>Пути, по которым ищутся заголовочные файлы. ("<code>-I<em>dir</em></code>").</dd> - - <dt><code>TARGET=...</code> [По умолчанию: <code>apache</code>]</dt> - - <dd>Имя исполняемого файла после сборки сервера</dd> - - <dt><code>NOTEST_CPPFLAGS=...</code></dt> - - <dt><code>NOTEST_CFLAGS=...</code></dt> - - <dt><code>NOTEST_LDFLAGS=...</code></dt> - - <dt><code>NOTEST_LIBS=...</code></dt> - - <dd>Эти переменные окружения выполняют ту же роль, что и те же самые переменные, - но без приставки <code>NOTEST</code>. Разница заключается в том, что они добавляются - в среду после того, как autoconf выполнил тестирование возможностей операционной - среды. Это позволяет использовать те опции, которые бы вызвали ошибку при подобном - тестировании, но включение которых обязательно для окончательной сборки сервера.</dd> - - <dt><code>SHLIB_PATH=...</code></dt> - - <dd>Опции компилятора и компоновщика, определяющие путь к разделяемым библиотекам.</dd> - </dl> -</section> - -<section id="output"><title>Опции, конфигурирующие выходной поток программы autoconf</title> - - <dl> - <dt><code>--help</code></dt> - - <dd>Выдает инструкцию по использованию программы, включая все возможные опции, после - чего сразу же завершает работу.</dd> - - <dt><code>--quiet</code></dt> - - <dd>Предотвращает вывод сообщений, начинающихся с "<code>checking...</code>"</dd> - - <dt><code>--verbose</code></dt> - - <dd>Выдает полную информацию в процессе конфигурирования, включая имена - проверяемых файлов.</dd> - </dl> -</section> - -<section id="pathnames"><title>Пути</title> - - <p>В настоящее время существуют два способа задания путей, по которым - Apache установит свои файлы. Первый способ - это явно указать Apache - каталог, по которому он установится.</p> - - <dl> - <dt><code>--prefix=<em>PREFIX</em></code> [По умолчанию: - <code>/usr/local/apache2</code>]</dt> - - <dd>Определяет путь, по которому будет произведена установка Apache.</dd> - </dl> - - <p>Более того, существует возможность установить архитектурно - зависимые файлы - в другой специально заданный каталог.</p> - - <dl> - <dt><code>--exec-prefix=<em>EPREFIX</em></code> [Default: - <code><em>PREFIX</em></code>]</dt> - - <dd>Определяет путь, по которому будут установлены архитектурно - зависимые - файлы.</dd> - </dl> - - <p>Второй способ является более гибким. Он заключается в использовании - файлов <code>config.layout</code>. Используя этот метод, можно указать - каталог установки для любого типа файлов Apache. Файл <code>config.layout</code> - содержит несколько примеров конфигурирования. Используя эти примеры, вы можете - сами создавать собственные конфигурации установки. - Различные макеты установок группируются - в раздельных секциях <code><Layout FOO>...</Layout></code>, после чего - к ним можно обращаться посредством имени <code>FOO</code>.</p> - - <dl> - <dt><code>--enable-layout=<em>LAYOUT</em></code></dt> - - <dd>Использует именованный макет, описанный в файле <code>config.layout</code>, - в котором прописаны все установочные пути.</dd> - </dl> - -</section> - -<section id="modules"><title>Модули</title> - - <p>Apache - это модульный сервер. Только самые основные - функции включены в ядро сервера. Дополнительная функциональность - доступна посредством модулей. Во время процесса конфигурации - вы должны выбрать те модули, которые будут компилироваться вместе с сервером. - Обо всех доступных модулях вы можете прочитать в соответствующем - <a href="mod/index.html">списке модулей</a>. Модули, <a - href="mod/module-dict.html#Status">статус</a> которых обозначен - как "Базовый", компилируются вместе с сервером по умолчанию; если вам - не нужны некоторые базовые модули, вы должны специально это указать при - конфигурации (базовым модулем, например, является <module>mod_userdir</module>). - Модули с другим статусом не компилируются вместе с сервером по умолчанию, и (в случае - необходимости) должны быть прописаны при конфигурировании отдельно (примером такого модуля - может послужить <module>mod_expires</module>).</p> - - <p>Есть два способа указать Apache использовать какой - либо модуль. Модули - могут быть скомпилированы как <em>статические</em>, при этом их код включается - непосредственно в исполняемый код сервера Apache. Или же, если ваша операционная - система поддерживает динамически разделяемые объекты (Dynamic Shared Objects) и - и <code>autoconf</code> может определить, что это так, то модули могут быть - скомпилированы как <em>динамические</em>. DSO модули хранятся отдельно от ядра - сервера, и могут использоваться сервером в зависимости от - конфигурационных директив времени выполнения (то есть отвечающих за работу - уже собранного сервера), предоставляемых модулем <module>mod_so</module>. - Модуль mod_so автоматически включается в ядро сервера, если хотя бы - один модуль компилируется как динамический. Если же вы не компилируете никакие - динамические модули, но хотите, чтобы ваш сервер все же был способен работать - с DSO модулями, то при конфигурировании укажите следующую опцию: <code>--enable-so</code>.</p> - - <dl> - <dt><code>--enable-<em>MODULE</em>[=shared]</code></dt> - - <dd>Компилировать и включить в ядро сервера модуль <em>MODULE</em>. - <em>MODULE</em> - это <a - href="mod/module-dict.html#ModuleIdentifier">идентификатор модуля</a>, который можно - получить, отбросив от имени модуля, указанного в документации, строку "_string". Чтобы - компилировать модуль как DSO, добавьте опцию <code>=shared</code>.</dd> - - <dt><code>--disable-<em>MODULE</em></code></dt> - - <dd>Убрать <em>MODULE</em> из списка компилируемых модулей (если он есть в этом списке).</dd> - - <dt><code>--enable-modules=<em>MODULE-LIST</em></code></dt> - - <dd>Компилировать и включить в ядро сервера модули, идентификаторы которых приведены в - списке <em>MODULE-LIST</em>. Элементы списка отделяются друг от друга пробелами.</dd> - - <dt> - <code>--enable-mods-shared=<em>MODULE-LIST</em></code></dt> - - <dd>Компилировать модули, идентификаторы которых приведены в - списке <em>MODULE-LIST</em>, как динамические.</dd> - </dl> - - <p>Например, чтобы включить в сервер модули <module>mod_dav</module> и - <module>mod_info</module>, вы можете использовать либо</p> - -<example>./configure --enable-dav --enable-info</example> - - <p>либо эквивалентную предыдущей команду</p> - -<example>./configure --enable-modules="dav info"</example> - - <p>В дополнение к этому существуют специальные ключевые слова <code>all</code> или - <code>most</code>, которые могут быть использованы для компилирования всех или большинства - модулей сразу. Вы можете исключить из этого списка нежелательные модули, применяя соответствующие - опции <code>--disable-<em>MODULE</em></code>. Например, для того чтобы включить в работу сервера все - модули как DSO за исключением <module>mod_info</module>, вы можете написать следующее</p> - -<example> - ./configure --enable-mods-shared=all - --disable-info -</example> - - <p>В добавление к стандартному набору модулей, Apache 2.0 компилируется - вместе с некоторым <a href="mpm.html">мульти - процессным модулем</a> (MPMs). - Один и только один МП - модуль может быть скомпилирован вместе с сервером. Список - МП - модулей, компилируемых по умолчанию для каждой платформы, можно найти в соответствующем - <a href="mpm.html">разделе документации</a>; МП - модуль по умолчанию - можно изменить следующей опцией командной строки <code>configure</code></p> - - <dl> - <dt><code>--with-mpm=<em>NAME</em></code></dt> - - <dd>Компилироваться вместе с сервером будет МП - модуль с именем <em>NAME</em>.</dd> - </dl> + <p>При выполнении, скрипт <program>configure</program> проверяет, установлено ли в вашей системе + всё необходимое, а затем создает Make-файлы, которые будут затем использованы + для компилирования сервера.</p> + + <p>Подробное описание всех возможных опций скрипта + <program>configure</program> приведено в справочном руководстве + <program>configure</program>.</p> </section> -<section id="dbm"><title>DBM</title> - - <p>Некоторые модули Apache, как например <module>mod_auth_dbm</module> и <module>mod_rewrite</module> - (директива <directive module="mod_rewrite">RewriteMap</directive>), используют в своей работе простые - базы данных, организованные по принципу ключ/значение, что увеличивает скорость доступа к информации. - Поддержка SDBM баз данных включена в ядро сервера, так что использование баз данных подобного типа возможно - всегда. Если вам нужны базы данных другого типа, то можете использовать следующие опции:</p> - -<dl> -<dt><code>--with-gdbm[=<em>path</em>]</code></dt> -<dt><code>--with-ndbm[=<em>path</em>]</code></dt> -<dt><code>--with-berkeley-db[=<em>path</em>]</code></dt> - -<dd>Если не указано значение <em>path</em>, Apache будет искать заголовочные файлы и библиотеки -в стандартных каталогах. Явное указание <em>path</em> заставит Apache производить поиск соответсвующих -файлов в каталогах <em>path</em><code>/lib</code> и <em>path</em><code>/include</code>. Можно также -указать специфические пути для заголовочных файлов и библиотек, написав их через точку с запятой.</dd> -</dl> -</section> - - -<section id="suexec"><title>Suexec</title> - - <p>Вместе с Apache можно найти вспомогательную программу <a - href="suexec.html">suexec</a>, которая позволяет установить - более жесткий контроль над выполнением пользовательских CGI - программ. Тем не менее, если suexec сконфигурировать неправильно, - то могут появиться значительные бреши в системе безопасности - сервера. Поэтому вы должны очень внимательно прочитать <a href="suexec.html">документацию - suexec</a>, если решите использовать эту программу.</p> -</section> -</section> <section id="compile"><title>Сборка</title> @@ -535,7 +307,7 @@ <section id="install"><title>Установка</title> <p>Теперь настало время для установки сервера в каталог - <em>PREFIX</em>, который был указан при конфигурирования Apache + <em>PREFIX</em>, который был указан при конфигурировании Apache (смотрите выше опцию <code>--prefix</code>), выполнив:</p> <example>$ make install</example> @@ -567,8 +339,8 @@ <example>$ <em>PREFIX</em>/bin/apachectl start</example> - <p>и если все прошло успешно, то вы сможете запросить свой первый документ - по адресу <code>http://localhost/</code>. Веб - страница, которую вы увидете, + <p>и если всё прошло успешно, то вы сможете запросить свой первый документ + по адресу <code>http://localhost/</code>. Веб-страница, которую вы увидете, находится в каталоге <directive module="core">DocumentRoot</directive> - по умолчанию, это <code><em>PREFIX</em>/htdocs/</code>. Затем <a href="stopping.html">остановите</a> сервер следующей командой:</p> @@ -576,4 +348,60 @@ <example>$ <em>PREFIX</em>/bin/apachectl stop</example> </section> +<section id="upgrading"><title>Апгрейд</title> + + <p>Первым шагом при апгрейде является чтение информации о релизе + и файла <code>CHANGES</code>, находящегося в дереве исходных + кодов - это поможет вам понять, каким образом апгрейд повлияет + на ваш текущий веб-сервер. При переходе между разными ветками + сервера (например, с 1.3 на 2.0, или с 2.0 на 2.2), скорее всего + появятся существенные нововведения в конфигурировании процесса сборки + или работы сервера, которые потребуют анализа и ручной настройки. + Все модули также необходимо будет проапгрейдить, для того чтобы + они могли соответствовать изменениям в API модулей.</p> + + <p>Апгрейд, осуществляемый внутри одной ветки сервера + (например, с 2.0.55 на 2.0.57) существенно проще. + Выполнение команды <code>make install</code> не перезапишет + никакие существующие документы, файлы логов или конфигурационные файлы. + В дополнение к этому, разработчики сервера делают всё возможное, + чтобы избежать несовместимости в опциях скрипта <program>configure</program>, + рабочей конфигурации сервера и API модулей для разных + младших релизов внутри одной ветки. В большинстве случаев вы + можете использовать идентичную строку запуска скрипта + <program>configure</program>, тот же самый конфигурационный файл + и быть уверенными, что все ваши модули продолжат работать. + (Это верно только для версий сервера, начиная с 2.0.41; предыдущие + версии имеют несовместимые изменения.)</p> + + <p>Для апгрейда с одного младшего релиза на другой, начните + с поиска файла <code>config.nice</code>, который должен находиться + либо в каталоге <code>build</code> сервера, либо + в корне дерева исходных кодов рабочего сервера. Этот файл + содержит в себе точную копию строки запуска скрипта + <program>configure</program>, которую вы использовали + при конфигурировании дерева исходных кодов. Затем, чтобы + осуществить апгрейд, скопируйте файл <code>config.nice</code> + в дерево исходных кодов новой версии сервера, внесите в него + все необходимые изменения, а затем выполните:</p> + + <example> + $ ./config.nice<br /> + $ make<br /> + $ make install<br /> + $ <em>PREFIX</em>/bin/apachectl stop<br /> + $ <em>PREFIX</em>/bin/apachectl start<br /> + </example> + + <note type="warning">Всегда тестируйте новую версию сервера + прежде, чем запускать её в работу. Например, вы можете + установить и запустить новую версию сервера рядом с текущей, используя + другой префикс установки <code>--prefix</code> и другой + номер порта (путём изменения значения директивы <directive + module="mpm_common">Listen</directive>), для того чтобы + протестировать сервер на совместимость с рабочей конфигурацией, + прежде чем делать финальный апгрейд.</note> + +</section> + </manualpage> diff --git a/docs/manual/invoking.xml.ru b/docs/manual/invoking.xml.ru index 07ed8bd435..3d02d29d32 100644 --- a/docs/manual/invoking.xml.ru +++ b/docs/manual/invoking.xml.ru @@ -21,7 +21,7 @@ --> <!--***************************************************--> -<!-- Translator: Ilia Soldis (soldis@tversu.ru) --> +<!-- Translator: Ilia Soldatenko (soldis@tversu.ru) --> <!-- Reviewers: --> <!-- Ivan Shvedov (ivan@tversu.ru) --> <!-- Arthur Reznikov (art@altair.tversu.ru)--> diff --git a/docs/manual/mod/directives.xml.ru b/docs/manual/mod/directives.xml.ru index ed6de524ba..8ced6258c6 100644 --- a/docs/manual/mod/directives.xml.ru +++ b/docs/manual/mod/directives.xml.ru @@ -1,10 +1,11 @@ <?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: 96955:151405 (outdated) --> +<!-- English Revision: 151405 --> <!-- - Copyright 2003-2004 The Apache Software Foundation + 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,7 +21,7 @@ --> <!--***************************************************--> -<!-- Translator: Ilia Soldis (rkai@tversu.ru) --> +<!-- Translator: Ilia Soldatenko (soldis@tversu.ru) --> <!-- Reviewers: --> <!-- Ivan Shvedov (ivan@tversu.ru) --> <!-- Arthur Reznikov (art@altair.tversu.ru)--> @@ -31,7 +32,7 @@ <summary> <p>Здесь приводится список всех директив, которые доступны в стандартном дистрибутиве Apache. Для каждой директивы - дается краткое, но емкое описание, а смысл всех терминов, + даётся краткое описание, а смысл всех терминов, использованных при этом, можно найти в <a href="directive-dict.html" rel="Glossary">Глоссарии терминов</a>. </p> diff --git a/docs/manual/mod/quickreference.xml.ru b/docs/manual/mod/quickreference.xml.ru index 9a8893b8e8..5b243e42ab 100644 --- a/docs/manual/mod/quickreference.xml.ru +++ b/docs/manual/mod/quickreference.xml.ru @@ -1,10 +1,11 @@ <?xml version='1.0' encoding='KOI8-R' ?> <!DOCTYPE quickreference SYSTEM "../style/modulesynopsis.dtd"> <?xml-stylesheet type="text/xsl" href="../style/manual.ru.xsl"?> -<!-- English Revision: 96955:151405 (outdated) --> +<!-- English Revision: 151405 --> <!-- - Copyright 2003-2004 The Apache Software Foundation + 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,7 +21,7 @@ --> <!--***************************************************--> -<!-- Translator: Ilia Soldis (rkai@tversu.ru) --> +<!-- Translator: Ilia Soldatenko (soldis@tversu.ru) --> <!-- Reviewers: --> <!-- Ivan Shvedov (ivan@tversu.ru) --> <!-- Arthur Reznikov (art@altair.tversu.ru)--> @@ -28,26 +29,27 @@ <quickreference metafile="quickreference.xml.meta"> - <title>Краткое руководство по директивам</title> + <title>Краткий справочник по директивам</title> <summary> - <p>В кратком руководстве по директивам Вы найдете информацию - о том, как использовать директиву, ее значение по умолчанию, статус - и контекст. (Для расшифровки понятий "статус" и "контекст", обратитесь - к <a href="directive-dict.html">Словарю</a>.)</p> + <p>В кратком справочнике по директивам вы найдёте информацию + о том, как использовать ту или иную директиву, её значение по умолчанию, статус + и контекст. Для расшифровки понятий «статус» и «контекст», обратитесь + к <a href="directive-dict.html">Словарю</a>.</p> - <p>В первой колонке приводится название директивы и описание ее + <p>В первой колонке приводится название директивы и описание её использования. Во второй - значение по умолчанию, если таковое есть у директивы. Если это значение слишком велико, то после - первых букв идет значек "+".</p> + первых букв идет значёк «+».</p> - <p>В третьей и четвертой колонках даются значения контекста, в + <p>В третьей и четвёртой колонках даются значения контекста, в котором данная директива имеет смысл (может использоваться), и - ее статус. Все сокращения, используемые при этом, расшифровываются + её статус. Все сокращения, используемые при этом, расшифровываются в следующей таблице.</p> </summary> <legend> <table> + <columnspec><column width=".1"/><column width=".2"/></columnspec> <tr><th>s</th><td>server config</td></tr> <tr><th>v</th><td>virtual host</td></tr> <tr><th>d</th><td>directory</td></tr> @@ -55,6 +57,7 @@ </table> <table> + <columnspec><column width=".1"/><column width=".2"/></columnspec> <tr><th>C</th><td>Core</td></tr> <tr><th>M</th><td>MPM</td></tr> <tr><th>B</th><td>Base</td></tr> diff --git a/docs/manual/mpm.xml.ru b/docs/manual/mpm.xml.ru index b97228d6a3..3aba327011 100644 --- a/docs/manual/mpm.xml.ru +++ b/docs/manual/mpm.xml.ru @@ -1,10 +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: 97584:159293 (outdated) --> +<!-- English Revision: 159293 --> <!-- - Copyright 2003-2004 The Apache Software Foundation + 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. @@ -31,7 +32,7 @@ <title>Мульти-процессные модули (МП-модули)</title> <summary> -<p>Этот документ описысывает, что такое мульти-процессные модули +<p>Этот документ описывает, что такое мульти-процессные модули и как они используются в HTTP-сервере Apache.</p> </summary> @@ -43,8 +44,8 @@ требуют и различных возможностей или могут предоставлять различные пути реализации одной и той же возможности наиболее эффективно. Apache всегда мог работать в различных - средах окружения за счёт своей модульной архитектуры, которая - позволяет вебмастеру выбрать всю необходимую функциональность, + средах окружения за счёт своей модульной архитектуры, + позволяющей вебмастеру выбрать всю необходимую функциональность, которая будет реализовываться сервером после компиляции, при помощи компилируемых или подключаемых модулей.</p> @@ -64,7 +65,7 @@ эффективно, благодаря тому, что МП-модуль <module>mpm_winnt</module> может использовать собственные сетевые функции Windows взамен сетевых функций уровня POSIX. - Эта касается и других операционных систем, для которых + Это касается и других операционных систем, для которых разработаны специальные МП-модули.</li> <li>Сервер может быть настрен более оптимально для нужд конкретного @@ -92,32 +93,30 @@ а затем скомпилирован вместе с сервером, чтобы стать его частью. Компиляторы способны оптимизировать многие функции при условии, что используются потоки, - однако они должны знать еще на этапе компиляции, используются ли - потоки или нет. Поскольку некоторые МП-модули используют - потоки в ОС Unix, а другие - нет, Apache будет работать - лучше, если МП-модуль был встроен в сервер на этапе - компиляции.</p> + однако они должны знать еще на этапе компиляции, используются + потоки или нет.</p> <p>Чтобы подключить желаемый МП-модуль к Apache, - используйте аргумент --with-mpm=<em>название</em> - скрипта <code>./configure</code>, где <em>название</em> - + используйте аргумент <code>--with-mpm=<em>MPM</em></code> + скрипта <program>configure</program>, где <em>MPM</em> - это название желаемого МП-модуля.</p> - <p>Однажды откомпилировав сервер, всегда можно + <p>После того, как сервер скомпилирован, всегда можно определить, какой МП-модуль был выбран, используя команду <code>./httpd -l</code>, которая выведет список - всех модулей, откомпилированных вместе с сервером, + всех модулей, собранных вместе с сервером, в том числе и название МП-модуля.</p> </section> -<section id="defaults"><title>Подключённые по умолчанию МП-модули</title> +<section id="defaults"><title>МП-модули по умолчанию</title> <p>Приведённая ниже таблица показывает, какие МП-модули подключены -по умолчанию для различных операционнах систем. В ней указан тот -МП-модуль, который будет выбран, если Вы на этапе компиляции не -подключили другой МП-модуль.</p> +по умолчанию в различных операционных системах. В ней указан тот +МП-модуль, который будет выбран, если вы на этапе компиляции явно не +указали другой МП-модуль.</p> <table> +<columnspec><column width=".2"/><column width=".2"/></columnspec> <tr><td>BeOS</td><td><module>beos</module></td></tr> <tr><td>Netware</td><td><module>mpm_netware</module></td></tr> <tr><td>OS/2</td><td><module>mpmt_os2</module></td></tr> diff --git a/docs/manual/new_features_2_0.xml.ru b/docs/manual/new_features_2_0.xml.ru index f6084579dd..47a492845f 100644 --- a/docs/manual/new_features_2_0.xml.ru +++ b/docs/manual/new_features_2_0.xml.ru @@ -22,7 +22,7 @@ <!--***************************************************--> -<!-- Translator: Ilia Soldis (rkai@tversu.ru) --> +<!-- Translator: Ilia Soldatenko (soldis@tversu.ru) --> <!-- Reviewers: --> <!-- Ivan Shvedov (ivan@tversu.ru) --> <!-- Arthur Reznikov (art@altair.tversu.ru)--> diff --git a/docs/manual/programs/index.xml.ru b/docs/manual/programs/index.xml.ru index 1bf973a28b..ab04beb3b0 100644 --- a/docs/manual/programs/index.xml.ru +++ b/docs/manual/programs/index.xml.ru @@ -1,10 +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: 102620:161235 (outdated) --> +<!-- English Revision: 161235 --> <!-- - Copyright 2003-2004 The Apache Software Foundation + 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,7 +21,7 @@ --> <!--***************************************************--> -<!-- Translator: Ilia Soldis (rkai@tversu.ru) --> +<!-- Translator: Ilia Soldatenko (soldis@tversu.ru) --> <!-- Reviewers: --> <!-- Ivan Shvedov (ivan@tversu.ru) --> <!-- Arthur Reznikov (art@altair.tversu.ru)--> @@ -39,48 +40,48 @@ <section id="index"><title>Указатель</title> <dl> - <dt><a href="httpd.html">httpd</a></dt> + <dt><program>httpd</program></dt> <dd>HTTP сервер Apache</dd> - <dt><a href="apachectl.html">apachectl</a></dt> + <dt><program>apachectl</program></dt> <dd>Интерфейс управления HTTP сервером Apache</dd> - <dt><a href="ab.html">ab</a></dt> + <dt><program>ab</program></dt> <dd>Утилита для тестирования HTTP сервера Apache</dd> - <dt><a href="apxs.html">apxs</a></dt> + <dt><program>apxs</program></dt> <dd>Утилита APache eXtenSion</dd> - <dt><a href="dbmmanage.html">dbmmanage</a></dt> + <dt><program>dbmmanage</program></dt> <dd>Создание и обновление файлов паролей пользователей в формате DBM, необходимых для базовой аутентификации (basic authentification)</dd> - <dt><a href="htdigest.html">htdigest</a></dt> + <dt><program>htdigest</program></dt> <dd>Создание и обновление файлов паролей пользователей для дайджестной аутентификации (digest authentification)</dd> - <dt><a href="htpasswd.html">htpasswd</a></dt> + <dt><program>htpasswd</program></dt> <dd>Создание и обновление файлов паролей пользователей для базовой аутентификации (basic authentification)</dd> - <dt><a href="logresolve.html">logresolve</a></dt> + <dt><program>logresolve</program></dt> <dd>Утилита для преобразования IP-адресов в соответствующие им имена хостов в лог-файлах Apache</dd> - <dt><a href="rotatelogs.html">rotatelogs</a></dt> + <dt><program>rotatelogs</program></dt> <dd>Утилита, позволяющая производить ротацию лог-файлов Apache без остановки сервера</dd> - <dt><a href="suexec.html">suexec</a></dt> + <dt><program>suexec</program></dt> <dd>Switch User For Exec - утилита, позволяющая выполнять CGI-скрипт от имени другого пользователя</dd> diff --git a/docs/manual/style/lang/ru.xml b/docs/manual/style/lang/ru.xml index 2487a8f37a..4884b03161 100644 --- a/docs/manual/style/lang/ru.xml +++ b/docs/manual/style/lang/ru.xml @@ -116,7 +116,8 @@ <message id="langavail">Доступные языки</message> <!-- not up to date --> - <message id="outofdate">This translation may be out of date. Check the - English version for recent changes.</message> + <message id="outofdate">Этот перевод может быть устаревшим. Смотрите + английскую версию для ознакомления со всеми последними изменениями + в документе.</message> </messages> </language> diff --git a/docs/manual/upgrading.xml.ru b/docs/manual/upgrading.xml.ru index a3d4650933..5c47d30d12 100644 --- a/docs/manual/upgrading.xml.ru +++ b/docs/manual/upgrading.xml.ru @@ -1,10 +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: 96997:151405 (outdated) --> +<!-- English Revision: 151405 --> <!-- - Copyright 2002-2004 The Apache Software Foundation + 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,7 +21,7 @@ --> <!--***************************************************--> -<!-- Translator: Ilia Soldis (rkai@tversu.ru) --> +<!-- Translator: Ilia Soldatenko (soldis@tversu.ru) --> <!-- Reviewers: --> <!-- Ivan Shvedov (ivan@tversu.ru) --> <!-- Arthur Reznikov (art@altair.tversu.ru)--> @@ -32,14 +33,16 @@ <summary> <p>Этот документ необходим для того, чтобы помочь пользователям - перейти к использованию сервера версии 2.0. Здесь вы найдете лишь + перейти к использованию сервера версии 2.0. Здесь вы найдёте лишь краткие замечания; более подробную информацию о нововведениях можно найти либо в документе <a href="new_features_2_0.html" >Новые возможности</a>, либо в файле <code>src/CHANGES</code>.</p> </summary> +<seealso><a href="new_features_2_0.html">Обзор новых возможностей +в Apache 2.0</a></seealso> <section id="compile-time"> - <title>Изменения в конфигурировании сборки сервера</title> + <title>Изменения в конфигурировании процесса сборки сервера</title> <ul> <li>Apache теперь использует систему <code>autoconf</code> и @@ -63,35 +66,37 @@ <li>Многие из тех директив, которые обслуживались ядром сервера Apache 1.3, теперь перенесены в мульти - процессные модули. Если вы хотите, чтобы поведение сервера было наиболее приближено к поведению - Apache 1.3, то при сборке вы должны выбрать МП-модуль <a - href="mod/prefork.html">prefork</a>. Другие МП-модули предоставляют + Apache 1.3, то при сборке вы должны выбрать МП-модуль + <module>prefork</module>. Другие МП-модули предоставляют иные директивы, отвечающие за работу процессов сервера и обработку запросов.</li> <li><a href="mod/mod_proxy.html">Прокси модуль</a> был переписан, и теперь поддерживает спецификацию HTTP/1.1. Одним из наиболее важных изменений является то, что директивы, контролирующие работу - модуля, теперь располагаются в секции <Proxy>, а не в + модуля, теперь располагаются в секции <directive type="section" + module="mod_proxy">Proxy</directive>, а не в <Directory proxy:>, как это было ранее.</li> - <li>Обработка PATH_INFO (путевой информации, следующей за + <li>Обработка <code>PATH_INFO</code> (путевой информации, следующей за именем запрашиваемого документа) изменилась для некоторых модулей. Модули, которые раньше были написаны как обработчики (handler), а теперь выполняют роль фильтров, могут более не принимать запросы, - содержащие PATH_INFO. Такие фильтры, как <a - href="mod/mod_include.html">INCLUDES</a> реализованы первыми в базовом + содержащие <code>PATH_INFO</code>. Такие фильтры, как <a + href="mod/mod_include.html">INCLUDES</a> или <a + href="http://www.php.net/">PHP</a> реализованы первыми в базовом обработчике, таким образом они не могут принимать запросы, содержащие - PATH_INFO. Вы можете использовать директиву <directive + <code>PATH_INFO</code>. Вы можете использовать директиву <directive module="core">AcceptPathInfo</directive>, чтобы заставить базовый обработчик принимать подобные запросы, и таким образом восстановить - возможность использования PATH_INFO в документах, использующих включения - на стороне сервера (SSI).</li> + возможность использования <code>PATH_INFO</code> в документах, + использующих включения на стороне сервера (SSI).</li> <li>Директива <directive module="mod_negotiation">CacheNegotiatedDocs</directive> теперь может принимать аргументы <code>on</code> и <code>off</code>. Уже существующие экземпляры директивы - <code>CacheNegotiatedDocs</code> должны быть заменены на + <directive>CacheNegotiatedDocs</directive> должны быть заменены на <code>CacheNegotiatedDocs on</code>.</li> <li> @@ -126,7 +131,7 @@ conf/srm.conf</code>. Для того чтобы быть уверенным в том, что Apache считывает конфигурационные файлы именно в том порядке, который был предусмотрен старыми директивами, надо поместить - директивы <code>Include</code> в конце файла httpd.conf, причем + директивы <code>Include</code> в конце файла httpd.conf, причём сперва ту, что включает <code>srm.conf</code>, а затем ту, что включает <code>access.conf</code>.</li> @@ -139,7 +144,7 @@ использовалась, кроме всего прочего, для того чтобы сервер мог формировать правильные ссылки на самого себя. В Apache 2.0 для тех же целей служит новый синтаксис директивы <directive module="core" - >ServerName</directive>: он был изменен таким образом, что теперь + >ServerName</directive>: он был изменён таким образом, что теперь имя хоста <em>и</em> номер порта можно указывать в одной этой директиве.</li> <li>Директива <code>ServerType</code> более не существует. @@ -147,7 +152,7 @@ выбора МП-модуля. В настоящее время нет такого МП-модуля, который мог бы запускаться посредством демона inetd.</li> - <li>Модули mod_log_agent и mod_log_referer, которые предоставляли + <li>Модули <code>mod_log_agent</code> и <code>mod_log_referer</code>, которые предоставляли такие директивы, как <code>AgentLog</code>, <code>RefererLog</code> и <code>RefererIgnore</code>, были убраны. Ведение журнала агентов пользователей (agent logs) и отправителей (referer logs) по-прежнему @@ -163,6 +168,26 @@ <li>Директива <code>FancyIndexing</code> была убрана. Ее функциональность теперь обеспечивается опцией <code>FancyIndexing</code> в директиве <directive module="mod_autoindex">IndexOptions</directive></li> + + <li>Алгоритмы контентной негоциации (content-negotiation), + реализуемые модулем <module>mod_negotiation</module>, + стали более строгими в той части, где определяются файлы по умолчанию. + Теперь эти алгоритмы будут выбирать файлы только из списка + <em>доступных (negotiable)</em> файлов. Старое поведение может + быть восстановлено директивой <directive + module="mod_mime">MultiviewsMatch</directive>.</li> + + <li>(<em>начиная с версии 2.0.51</em>) + <p>Функциональность директивы <code>ErrorHeader</code> была + передана директиве <directive module="mod_headers">Header</directive>, + потому что прежнее название директивы было некорректно. + Теперь необходимо писать</p> + + <example> + Header always set foo bar + </example> + + <p>чтобы получить желаемый результат.</p></li> </ul> </section> @@ -170,15 +195,11 @@ <title>Другие изменения</title> <ul> - <li>Опция командной строки <code>httpd</code> <code> -S</code>, - позволявшая распечатывать конфигурацию виртуальных хостов, теперь заменена - опцией <code>-t -D DUMP_VHOSTS</code>.</li> - <li>Модуль <module>mod_auth_digest</module>, который имел экспериментальный статус в Apache 1.3, теперь является стандартным модулем.</li> <li>Модуль <code>mod_mmap_static</code>, который имел экспериментальный статус в - Apache 1.3, заменен модулем <module>mod_file_cache</module>.</li> + Apache 1.3, заменён модулем <module>mod_file_cache</module>.</li> <li>Организация дистрибутива полностью изменена и теперь более не содержит независимого каталога <code>src</code>. Вместо этого @@ -188,7 +209,7 @@ </section> <section id="third-party"> - <title>Модули третьих фирм</title> + <title>Модули сторонних разработчиков</title> <p>Значительные изменения были внесены в API для Apache 2.0. Существующие модули, написанные с использованием Apache 1.3 API, diff --git a/docs/manual/vhosts/index.xml.ru b/docs/manual/vhosts/index.xml.ru index b76104885d..f771f5ba62 100644 --- a/docs/manual/vhosts/index.xml.ru +++ b/docs/manual/vhosts/index.xml.ru @@ -1,10 +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: 106090:151405 (outdated) --> +<!-- English Revision: 151405 --> <!-- - Copyright 2003-2004 The Apache Software Foundation + 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. @@ -33,22 +34,22 @@ <summary> - <p>Термин <cite>виртуальный хост</cite> используется при размещении - более чем одного веб-сайта (например + <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-адреса. Факт того, - что эти сайты работают на одном и том же физическом сервере + на одной машине. Виртуальный хост может быть как «<a + href="ip-based.html">привязанным к IP-адресу</a>», что означает + использование отдельного IP адреса для каждого сайта, либо «<a + href="name-based.html">привязанным к имени</a>», позволяя вам + иметь несколько различных имён для каждого IP-адреса. Факт того, + что эти сайты работают на одном и том же физическом сервере, не очевиден конечным пользователям.</p> - <p>Apache был одним из первых серверов, который поддерживал IP-базированные - виртуальные хосты. Версии Apachr 1.1 и более новые поддерживают как - IP-базированные так и виртуальные хосты, определяемые по имени - (vhosts). Последний вариант виртуальных хостов также иногда - называют <em>хост-базированными</em> или <em>не-IP виртуальными хостами</em>.</p> + <p>Apache был одним из первых серверов, который поддерживал IP-привязанные + виртуальные хосты. Версии Apache 1.1 и более новые поддерживают как + IP-привязанные, так и виртуальные хосты, определяемые по имени. + Последний вариант виртуальных хостов также иногда + называют <em>хост-привязанными</em> или <em>не-IP виртуальными хостами</em>.</p> <p>Ниже вы видите список документов, которые детально объясняют поддержку виртуальных хостов в Apache 1.3 и выше.</p> @@ -56,8 +57,8 @@ </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="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> @@ -66,11 +67,11 @@ <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="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> @@ -91,18 +92,18 @@ </ul> <p>Если вы пытаетесь отлаживать вашу конфигурацию с виртуальными хостами, то - ключ для запуска Apache с коммандной строки <code>-S</code> будет крайне полезен. + ключ для запуска Apache из командной строки <code>-S</code> будет крайне полезен. То есть, слудет использовать следующую команду:</p> <example> /usr/local/apache2/bin/httpd -S </example> - <p>Эта доманда распечатает описание того, как Apache интерпретировал - файл конфигурации. Тщательное изучение IP адресов и имен серверов - поможет найти ошибки конфигурации. (Смотрите также <a - href="../programs/httpd.html">документацию к программе httpd</a> для - изучения других параметров для запуска из командной строки)</p> + <p>Эта команда распечатает описание того, как Apache разобрал + файл конфигурации. Тщательное изучение IP адресов и имён серверов + поможет найти ошибки конфигурации. (Смотрите также + документацию к программе <program>httpd</program> для + изучения других параметров для запуска из командной строки.)</p> </section> </manualpage> |