diff options
22 files changed, 1576 insertions, 5 deletions
diff --git a/docs/manual/developer/documenting.xml.zh-cn b/docs/manual/developer/documenting.xml.zh-cn new file mode 100644 index 0000000000..040ce7ca6b --- /dev/null +++ b/docs/manual/developer/documenting.xml.zh-cn @@ -0,0 +1,79 @@ +<?xml version="1.0" encoding="UTF-8" ?> +<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.zh-cn.xsl"?> +<!-- English revision : 586770 --> + +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You 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. +--> + +<manualpage metafile="documenting.xml.meta"> +<parentdocument href="./">开发者文档</parentdocument> + +<title>Apache 2.0 文档</title> + +<summary> + <p>Apache 2.0 使用 <a href="http://www.doxygen.org/">Doxygen</a> 从代码中 + 生成 API 和全局变量的文档。下面是对使用 Doxygen 生成文档的简介。</p> +</summary> + +<section id="brief"><title>简要说明</title> + <p>使用 <code>/**</code> 开始文档块<br /> + 使用 <code>*/</code> 结束文档块</p> + + <p>在文档块中，我们可以使用多个标签:</p> + + <example> + Description of this functions purpose<br /> + @param parameter_name description<br /> + @return description<br /> + @deffunc signature of the function<br /> + </example> + + <p>一般不需要 <code>deffunc</code> 。DoxyGen 没有完整的解析器，所以任何 + 在返回类型声明中使用宏的原型，都是太复杂了。这些函数就需要使用 <code>deffunc</code>。 + 例如 (使用 &gt; 而不是 >):</p> + + <example> + /**<br /> + * return the final element of the pathname<br /> + * @param pathname The path to get the final element of<br /> + * @return the final element of the path<br /> + * @tip Examples:<br /> + * <pre><br /> + * "/foo/bar/gum" -&gt; "gum"<br /> + * "/foo/bar/gum/" -&gt; ""<br /> + * "gum" -&gt; "gum"<br /> + * "wi\\n32\\stuff" -&gt; "stuff"<br /> + * </pre><br /> + * @deffunc const char * ap_filename_of_pathname(const char *pathname)<br /> + */ + </example> + + <p>总是在头文件开始包含:</p> + <example> + /**<br /> + * @package Name of library header<br /> + */ + </example> + + <p>Doxygen 为每个包生成一个新的 HTML 文件，名字是 + {Name_of_library_header}.html，所以请简化名称。</p> + + <p>更深入的讨论，请参见 + <a href="http://www.doxygen.org/">Doxygen 站点</a>。</p> +</section> +</manualpage> diff --git a/docs/manual/developer/index.xml.zh-cn b/docs/manual/developer/index.xml.zh-cn new file mode 100644 index 0000000000..a4928a5dc7 --- /dev/null +++ b/docs/manual/developer/index.xml.zh-cn @@ -0,0 +1,79 @@ +<?xml version="1.0" encoding="UTF-8" ?> +<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.zh-cn.xsl"?> +<!-- English revision : 1042988 --> + +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You 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. +--> + +<manualpage metafile="index.xml.meta"> +<parentdocument href="../" /> + +<title>Apache 2.0 开发者文档</title> + +<summary> + <p>开发者页面的许多文档都来自于 Apache 1.3。当更新到 Apache 2 + 时，它们可能位于不同的阶段。请耐心等待，或者直接向 + <a href="http://httpd.apache.org/lists.html#http-dev" + >dev@httpd.apache.org</a> 邮件列表报告开发者页面的差异或错误。</p> +</summary> + +<section id="topics"><title>主题</title> + <ul> + <li><a href="API.html">Apache 1.3 API 说明</a></li> + <li><a href="new_api_2_4.html">在 Apache 2.3/2.4 中的 API 改变</a></li> + <li><a href="hooks.html">Apache 2.x 钩子函数</a></li> + <li><a href="request.html">Apache 2.x 中的请求处理</a></li> + <li><a href="filters.html">Apache 2.x 中的过滤器</a></li> + <li><a href="output-filters.html">Apache 2.x 中的输出过滤器指南</a></li> + <li><a href="modules.html">将模块从 Apache 1.3 移植到 Apache 2.x</a></li> + <li><a href="debugging.html">在 APR 中调试内存分配</a></li> + <li><a href="documenting.html">Apache 2.x 文档</a></li> + <li><a href="thread_safety.html">Apache 2.x 的线程安全问题</a></li> + </ul> +</section> + +<section id="external"><title>外部资源</title> + <ul> + <li><a + href="http://ci.apache.org/projects/httpd/trunk/doxygen/" + >自动生成的 Apache HTTP 服务器 (trunk) 代码文档</a></li> + + <li>Kevin O'Donnell 的模块开发教程 + <ul> + <li><a + href="http://threebit.net/tutorials/apache2_modules/tut1/tutorial1.html" + >集成模块到 Apache 构建系统</a></li> + + <li><a + href="http://threebit.net/tutorials/apache2_modules/tut2/tutorial2.html" + >处理配置指令</a></li> + </ul></li> + + <li><a href="http://www.onlamp.com/pub/ct/38">Ryan Bloom 对 Apache 模块开发的说明</a></li> + + <li>位于 <a href="http://www.apachetutor.org/">apachetutor</a> 的开发者文章: + <ul> + <li><a href="http://www.apachetutor.org/dev/request">Apache 中的请求处理</a></li> + <li><a href="http://www.apachetutor.org/dev/config">模块的配置</a></li> + <li><a href="http://www.apachetutor.org/dev/pools">Apache 中的资源管理</a></li> + <li><a href="http://www.apachetutor.org/dev/reslist">Apache 中的连接池</a></li> + <li><a href="http://www.apachetutor.org/dev/brigades">桶与队列简介</a></li> + </ul></li> + </ul> +</section> +</manualpage> diff --git a/docs/manual/faq/index.xml.zh-cn b/docs/manual/faq/index.xml.zh-cn new file mode 100644 index 0000000000..75ec080e77 --- /dev/null +++ b/docs/manual/faq/index.xml.zh-cn @@ -0,0 +1,33 @@ +<?xml version='1.0' encoding='UTF-8' ?> +<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.zh-cn.xsl"?> +<!-- English revision : 1044378 --> + +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You 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. +--> + +<manualpage metafile="index.xml.meta"> +<parentdocument href="../"/> + +<title>常见问题</title> + +<summary> + <p>常见问题已经移到 <a + href="http://wiki.apache.org/httpd/FAQ">HTTP 服务器维基</a>。</p> +</summary> + +</manualpage> diff --git a/docs/manual/handler.xml.zh-cn b/docs/manual/handler.xml.zh-cn new file mode 100644 index 0000000000..4dc73ffbc9 --- /dev/null +++ b/docs/manual/handler.xml.zh-cn @@ -0,0 +1,128 @@ +<?xml version="1.0" encoding="UTF-8" ?> +<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd"> +<?xml-stylesheet type="text/xsl" href="./style/manual.zh-cn.xsl"?> +<!-- English revision : 420990 --> + +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You 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. +--> + +<manualpage metafile="handler.xml.meta"> + + <title>Apache 的处理器</title> + + <summary> + <p>本页描述 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 要执行的动作的内部表示形式。 + 一般来说，每个文件都有基于其文件类型的隐式处理器。通常的文件会被 + 服务器简单处理，但是某些文件类型会被分别“处理”。</p> + + <p>处理器也可以被基于扩展名或位置来明确配置。它们都很有用，这不仅 + 因为它是优雅的方案，而且还允许类型<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>: 用于内容协商，按类型映射文件处理(<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> 环境变量指向它)，按照需要作出 and making + whatever modifications or additions are desired.</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>invoke_handler</code> + 之前，将 <code>r->handler</code> 指向处理器名称。处理器的实现与以前一样，只是用处理器名称取代了内容类型。 + 虽然不是必要，处理器的命名约定是使用破折号分割的单词，没有斜杠，从而不侵入媒体类型名称空间。</p> + </section> +</manualpage> diff --git a/docs/manual/howto/index.xml.zh-cn b/docs/manual/howto/index.xml.zh-cn new file mode 100644 index 0000000000..d2403c5233 --- /dev/null +++ b/docs/manual/howto/index.xml.zh-cn @@ -0,0 +1,102 @@ +<?xml version="1.0" encoding="UTF-8" ?> +<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.zh-cn.xsl"?> +<!-- English revision : 420990 --> + +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You 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. +--> + +<manualpage metafile="index.xml.meta"> + <parentdocument href="../"/> + + <title>常见操作/教程</title> + + <section id="howto"> + + <title>常见操作/教程</title> + + <dl> + <dt>认证与授权</dt> + <dd> + <p>认证是你验证某人是所声称的人。 + 授权是允许某人执行他想要的操作，或者获得想要的信息。</p> + + <p>参见: <a href="auth.html">认证，授权与访问控制</a></p> + </dd> + </dl> + + <dl> + <dt>访问控制</dt> + <dd> + <p>访问控制是操作限制，或基于任意条件访问资源。这可以通过多种方法完成。</p> + + <!-- <p>参见: <a href="access.html">访问控制</a></p> --> + </dd> + </dl> + + <dl> + <dt>CGI 与动态内容</dt> + <dd> + <p>CGI (通用网管接口) 为 web 服务器定义了与外部的内容生成程序的操作接口， + 通常称为 CGI 程序或 CGI 脚本。它是在 web 站点放入动态内容的最简单， + 也最常用的方法。 本文简单介绍了在 Apache 服务器中配置 CGI 的方法， + 以及如何编写 CGI 程序。</p> + + <p>参见: <a href="cgi.html">CGI 与动态内容</a></p> + </dd> + </dl> + + <dl> + <dt><code>.htaccess</code> 文件</dt> + <dd> + <p><code>.htaccess</code> files provide a way to make configuration + changes on a per-directory basis. A file, containing one or more + configuration directives, is placed in a particular document directory, + and the directives apply to that directory, and all subdirectories thereof.</p> + + <p>See: <a href="htaccess.html"><code>.htaccess</code> files</a></p> + </dd> + </dl> + + <dl> + <dt>服务器端插入简介</dt> + <dd> + <p>SSI (服务器端插入) 是在 HTML 页面中放入的指令，在页面被访问的时候执行。 + 它允许你在现有的 HTML 页面增加动态生成的内容，不需要通过 CGI + 程序或其它动态计数来生成整个页面。</p> + + <p>参见: <a href="ssi.html">服务器端插入 (SSI)</a></p> + </dd> + </dl> + + <dl> + <dt>用户私人网站目录</dt> + <dd> + <p>在有多个用户的系统中，使用 <directive + module="mod_userdir">UserDir</directive> 指令，可以允许每个用户在他们的根目录中都有一个 + web 站点。 访问 URL <code>http://example.com/~username/</code> 会得到位于用户 + "<code>username</code>" 根目录中由 <directive + module="mod_userdir">UserDir</directive> 指定的子目录中的内容。</p> + + <p>参见: <a href="public_html.html" + >用户私人网站目录 (<code>public_html</code>)</a></p> + </dd> + </dl> + + </section> + +</manualpage> diff --git a/docs/manual/index.xml.zh-cn b/docs/manual/index.xml.zh-cn new file mode 100644 index 0000000000..2c786b706d --- /dev/null +++ b/docs/manual/index.xml.zh-cn @@ -0,0 +1,92 @@ +<?xml version="1.0" encoding="UTF-8" ?> +<!DOCTYPE indexpage SYSTEM "./style/sitemap.dtd"> +<?xml-stylesheet type="text/xsl" href="./style/manual.zh-cn.xsl"?> +<!-- English revision : 1050960 --> + +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You 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. +--> + +<indexpage metafile="index.xml.meta"> +<parentdocument href="http://httpd.apache.org/docs-project/" /> + +<title>Apache HTTP 服务器 &httpd.major;.&httpd.minor; 文档</title> + +<category id="release"><title>发行说明</title> + <page href="new_features_2_4.html">Apache 2.3/2.4 的新特性</page> + <page href="new_features_2_2.html">Apache 2.1/2.2 的新特性</page> + <page href="new_features_2_0.html">Apache 2.0 的新特性</page> + <page href="upgrading.html">从 2.2 升级到 2.4</page> + <page href="license.html">Apache 许可证</page> +</category> + +<category id="manual"><title>参考手册</title> + <page href="install.html">编译与安装</page> + <page href="invoking.html">启动</page> + <page href="stopping.html">停止与重启</page> + <page href="mod/directives.html">配置指令</page> + <page href="mod/quickreference.html">指令快速参考</page> + <page href="mod/">模块</page> + <page href="mpm.html">多处理模块(MPM)</page> + <page href="filter.html">过滤器</page> + <page href="handler.html">处理器</page> + <page href="expr.html">表达式解析器</page> + <page href="programs/">服务器与支持程序</page> + <page href="glossary.html">术语</page> +</category> + +<category id="usersguide"><title>用户指南</title> + <page href="bind.html">绑定指定地址与端口</page> + <page href="configuring.html">配置文件</page> + <page href="sections.html">配置片段</page> + <page href="caching.html">缓存指南</page> + <page href="content-negotiation.html">内容协商</page> + <page href="dso.html">动态共享对象(DSO)</page> + <page href="env.html">环境变量</page> + <page href="logs.html">日志文件</page> + <page href="urlmapping.html">从 URL 映射到文件系统</page> + <page href="misc/perf-tuning.html">性能调谐</page> + <page href="misc/security_tips.html">安全技巧</page> + <page href="server-wide.html">服务器全局配置</page> + <page href="ssl/">SSL/TLS 加密</page> + <page href="suexec.html">执行 CGI 前的用户切换(suEXEC)</page> + <page href="rewrite/">URL 改写与 mod_rewrite</page> + <page href="vhosts/">虚拟主机</page> +</category> + +<category id="howto"><title>指引/教程</title> + <page href="howto/auth.html">认证，授权与访问控制</page> + <page href="howto/cgi.html">CGI 与动态内容</page> + <page href="howto/htaccess.html">.htaccess 文件</page> + <page href="howto/ssi.html">服务器端插入(SSI)</page> + <page href="howto/public_html.html">用户私人网站目录(public_html)</page> +</category> + +<category id="platform"><title>平台相关说明</title> + <page href="platform/windows.html">Microsoft Windows</page> + <page href="platform/netware.html">Novell NetWare</page> + <page href="platform/ebcdic.html">EBCDIC 系统</page> +</category> + +<category id="other"><title>其它主题</title> + <page href="http://wiki.apache.org/httpd/FAQ">常见问题</page> + <page href="sitemap.html">网站导航</page> + <page href="developer/">开发文档</page> + <page href="misc/">其它说明</page> + <page href="http://wiki.apache.org/httpd/">维基</page> +</category> + +</indexpage> diff --git a/docs/manual/misc/index.xml.zh-cn b/docs/manual/misc/index.xml.zh-cn new file mode 100644 index 0000000000..f45161284f --- /dev/null +++ b/docs/manual/misc/index.xml.zh-cn @@ -0,0 +1,66 @@ +<?xml version="1.0" encoding="UTF-8" ?> +<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.zh-cn.xsl"?> +<!-- English revision : 636430 --> + +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You 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. +--> + +<manualpage metafile="index.xml.meta"> + <parentdocument href="../"/> + + <title>Apache 杂项文档</title> + + <summary> + + <p>下面是适用于 Apache 服务器开发项目的附加文档。</p> + + <note type="warning"><title>警告</title> + <p>下面的文档尚未完全更新，以反映自 Apache HTTP 服务器版本 2.1 + 之后的修改。某些信息可能仍旧适用，但请小心使用它。</p> + </note> + + <dl> + <dt><a href="perf-tuning.html">Apache 性能调谐</a></dt> + + <dd> + <p>对如何在编译或运行时，配置 Apache，以便性能更高的说明。 + 解释了为什么 Apache 这样做，而不那样做 (这会让它更慢或更快)。</p> + </dd> + + <dt><a href="security_tips.html">安全技巧</a></dt> + + <dd> + <p>做和不做 - 如何让你的 Apache 站点保持安全。</p> + </dd> + + <dt><a href="relevant_standards.html">相关标准</a></dt> + + <dd> + <p>这篇文档是 Apache 遵循的相关标准的参考页面。</p> + </dd> + + <dt><a href="password_encryptions.html">密码加密格式</a></dt> + + <dd> + <p>对 Apache 身份认证支持的各种密码加密格式的讨论。</p> + </dd> + </dl> + + </summary> + +</manualpage> diff --git a/docs/manual/mod/directives.xml.zh-cn b/docs/manual/mod/directives.xml.zh-cn new file mode 100644 index 0000000000..0134a4c030 --- /dev/null +++ b/docs/manual/mod/directives.xml.zh-cn @@ -0,0 +1,35 @@ +<?xml version="1.0"?> +<!DOCTYPE directiveindex SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.zh-cn.xsl"?> +<!-- English revision : 420990 --> + +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You 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. +--> + +<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> diff --git a/docs/manual/mod/index.xml.zh-cn b/docs/manual/mod/index.xml.zh-cn new file mode 100644 index 0000000000..4990112ef7 --- /dev/null +++ b/docs/manual/mod/index.xml.zh-cn @@ -0,0 +1,35 @@ +<?xml version="1.0"?> +<!DOCTYPE moduleindex SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.zh-cn.xsl"?> +<!-- English revision : 926432 --> + +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You 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. +--> + +<moduleindex metafile="index.xml.meta"> + <title>模块索引</title> + <summary> + <p> + 下面是 Apache HTTP 服务器发行版中的所有模块列表。参见按照字母顺序罗列的<a + href="directives.html">所有 Apache HTTP 服务器指令</a>。 + </p> + </summary> + <seealso><a href="../mpm.html">多处理模块(MPM)</a> + </seealso> + <seealso><a href="quickreference.html">指令快速索引</a> + </seealso> +</moduleindex> diff --git a/docs/manual/mod/quickreference.xml.zh-cn b/docs/manual/mod/quickreference.xml.zh-cn new file mode 100644 index 0000000000..6670949d98 --- /dev/null +++ b/docs/manual/mod/quickreference.xml.zh-cn @@ -0,0 +1,34 @@ +<?xml version="1.0"?> +<!DOCTYPE quickreference SYSTEM "../style/modulesynopsis.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.zh-cn.xsl"?> +<!-- English revision : 636495 --> + +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You 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. +--> + +<quickreference metafile="quickreference.xml.meta"> + <title>指令快速索引</title> + <summary> + <p>指令快速索引显示指令的用法，默认值，状态和上下文。要获得更多信息，请参见 <a + href="directive-dict.html">描述指令的术语</a>。</p> + + <p>第一列给出指令的名称与用法。第二列显示指令的默认值(如果有的话)。 + 如果因为默认值太长而被截断显示，会在最后一个字符之后显示字符 “+”。</p> + + <p>第三列显示允许此指令的上下文，第四列显示指令的状态。</p> + </summary> +</quickreference> diff --git a/docs/manual/mpm.xml.zh-cn b/docs/manual/mpm.xml.zh-cn new file mode 100644 index 0000000000..66cf3899ec --- /dev/null +++ b/docs/manual/mpm.xml.zh-cn @@ -0,0 +1,110 @@ +<?xml version='1.0' encoding='UTF-8' ?> +<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd"> +<?xml-stylesheet type="text/xsl" href="./style/manual.zh-cn.xsl"?> +<!-- English revision : 927046 --> + +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You 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. +--> + +<manualpage metafile="mpm.xml.meta"> + + <title>多处理模块(MPM)</title> + +<summary> +<p>本文档介绍了什么是多处理模块，以及 Apache HTTP 服务器如何使用它们。</p> +</summary> + +<section id="introduction"><title>介绍</title> + + <p>Apache HTTP 服务器被设计为一个功能强大，并且灵活的 web 服务器， + 可以在很多平台与环境中工作。不同平台和不同的环境往往需要不同 + 的特性，或可能以不同的方式实现相同的特性最有效率。Apache httpd + 通过模块化的设计来适应各种环境。这种设计允许网站管理员通过在 + 编译时或运行时，选择哪些模块将会加载在服务器中，来选择服务器特性。</p> + + <p>Apache HTTP 服务器 2.0 扩展此模块化设计到最基本的 web 服务器功能。 + 它提供了可以选择的多处理模块(MPM)，用来绑定到网络端口上，接受请求， + 以及调度子进程处理请求。</p> + + <p>扩展到这一级别的服务器模块化设计，带来两个重要的好处:</p> + + <ul> + <li>Apache httpd 能更优雅，更高效率的支持不同的平台。尤其是 + Apache httpd 的 Windows 版本现在更有效率了，因为 + <module>mpm_winnt</module> 能使用原生网络特性取代在 + Apache httpd 1.3 中使用的 POSIX 层。它也可以扩展到其它平台 + 来使用专用的 MPM。</li> + + <li>Apache httpd 能更好的为有特殊要求的站点定制。例如，要求 + 更高伸缩性的站点可以选择使用线程的 MPM，即 + <module>worker</module> 或 <module>event</module>； + 需要可靠性或者与旧软件兼容的站点可以使用 + <module>prefork</module>。</li> + </ul> + + <p>在用户看来，MPM 很像其它 Apache httpd 模块。主要是区别是，在任何时间， + 必须有一个，而且只有一个 MPM 加载到服务器中。可用的 MPM 列表位于 + <a href="mod/">模块索引页面</a>。</p> + +</section> + +<section id="defaults"><title>默认 MPM</title> + +<p>下表列出了不同系统的默认 MPM。如果你不在编译时选择，那么它就是你将要使用的 MPM。</p> + +<table border="1" style="zebra"> +<columnspec><column width=".2"/><column width=".2"/></columnspec> +<tr><td>Netware</td><td><module>mpm_netware</module></td></tr> +<tr><td>OS/2</td><td><module>mpmt_os2</module></td></tr> +<tr><td>Unix</td><td><module>prefork</module>，<module>worker</module> 或 + <module>event</module>，取决于平台特性</td></tr> +<tr><td>Windows</td><td><module>mpm_winnt</module></td></tr> +</table> +</section> + +<section id="static"><title>构建 MPM 为静态模块</title> + + <p>在全部平台中，MPM 都可以构建为静态模块。在构建时选择一种 + MPM，链接到服务器中。如果要改变 MPM，必须重新构建。</p> + + <p>为了使用指定的 MPM，请在执行 <program>configure</program> 脚本 + 时，使用参数 <code>--with-mpm=<em>NAME</em></code>。<em>NAME</em> + 是指定的 MPM 名称。</p> + + <p>编译完成后，可以使用 <code>./httpd -l</code> 来确定选择的 MPM。 + 此命令会列出编译到服务器程序中的所有模块，包括 MPM。</p> + +</section> + +<section id="dynamic"><title>构建 MPM 为动态模块</title> + + <p>在 Unix 或类似平台中，MPM 可以构建为动态模块，与其它动态模块一样在运行时加载。 + 构建 MPM 为动态模块允许通过修改 <directive module="mod_so">LoadModule</directive> + 指令内容来改变 MPM，而不用重新构建服务器程序。</p> + + <p>在执行 <program>configure</program> 脚本时，使用 + <code>--enable-mpms-shared</code> 选项可以启用此特性。 + 当给出的参数为 <code><em>all</em></code> 时，所有此平台支持的 MPM + 模块都会被安装。还可以在参数中给出模块列表。</p> + + <p>默认 MPM，可以自动选择或者在执行 <program>configure</program> + 脚本时通过 <code>--with-mpm</code> 选项来指定，然后出现在生成的服务器配置文件中。 + 编辑 <directive module="mod_so">LoadModule</directive> 指令内容可以选择不同的 MPM。</p> + +</section> + +</manualpage> diff --git a/docs/manual/platform/index.xml.zh-cn b/docs/manual/platform/index.xml.zh-cn new file mode 100644 index 0000000000..ff0d141f27 --- /dev/null +++ b/docs/manual/platform/index.xml.zh-cn @@ -0,0 +1,82 @@ +<?xml version="1.0" encoding="UTF-8" ?> +<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.zh-cn.xsl"?> +<!-- English revision : 420990 --> + +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You 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. +--> + +<manualpage metafile="index.xml.meta"> + <parentdocument href="../"/> + + <title>平台相关说明</title> + + <section id="win"> + + <title>Microsoft Windows</title> + + <dl> + <dt>使用 Apache</dt> + <dd> + <p>这篇文档解释了如何在 Microsoft Windows 中安装，配置，以及运行 Apache 2.0 。</p> + + <p>参见: <a href="windows.html">在 Microsoft Windows 中使用 Apache</a></p> + </dd> + </dl> + + <dl> + <dt>编译 Apache</dt> + <dd> + <p>这篇文档解释了编译 Apache 的要点。</p> + + <p>参见: <a href="win_compiling.html">为 Microsoft Windows 编译 Apache</a></p> + </dd> + </dl> + + </section> + + <section id="other"> + + <title>其它平台</title> + + <dl> + <dt>Novell NetWare</dt> + <dd> + <p>这篇文档解释了如何在 Novell NetWare 5.1 或更新的版本中，如何安装，配置，以及运行 + Apache 2.0 。 + </p> + + <p>参见: <a href="netware.html">在 Novell NetWare 中使用 Apache</a></p> + </dd> + </dl> + + <dl> + <dt>EBCDIC</dt> + <dd> + <p>从 Apache HTTP 版本 1.3 开始支持使用 EBCDIC 字符集作为原生字符集的(非 ASCII)主机。</p> + + <note type="warning"><strong>警告:</strong> + 这篇文档尚未完全更新，以反映自 Apache HTTP 服务器版本 2.0 + 之后的修改。某些信息可能仍旧适用，但请小心使用它。</note> + + <p>参见: <a href="ebcdic.html">Apache 与 EBCDIC 系统</a></p> + </dd> + </dl> + + </section> + +</manualpage> diff --git a/docs/manual/programs/index.xml.zh-cn b/docs/manual/programs/index.xml.zh-cn new file mode 100644 index 0000000000..7ccc043f44 --- /dev/null +++ b/docs/manual/programs/index.xml.zh-cn @@ -0,0 +1,104 @@ +<?xml version='1.0' encoding='UTF-8' ?> +<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.zh-cn.xsl"?> +<!-- English revision : 669736 --> + +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You 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. +--> + +<manualpage metafile="index.xml.meta"> +<parentdocument href="../"/> + + <title>Apache HTTP 服务器与支持程序</title> + +<summary> + <p>本页描述了 Apache HTTP 服务器包含的所有可执行程序。</p> +</summary> + +<section id="index"><title>索引</title> + + <dl> + <dt><program>httpd</program></dt> + + <dd>Apache 服务器。</dd> + + <dt><program>apachectl</program></dt> + + <dd>Apache HTTP 服务器控制工具。</dd> + + <dt><program>ab</program></dt> + + <dd>Apache HTTP 服务器性能基准工具。</dd> + + <dt><program>apxs</program></dt> + + <dd>Apache 扩展工具。</dd> + + <dt><program>configure</program></dt> + + <dd>配置源代码。</dd> + + <dt><program>dbmmanage</program></dt> + + <dd>为基本认证创建和更新 DBM 格式的用户认证文件。</dd> + + <dt><program>fcgistarter</program></dt> + + <dd>启动 FastCGI 程序。</dd> + + <dt><program>htcacheclean</program></dt> + <dd>清理磁盘缓存。</dd> + + <dt><program>htdigest</program></dt> + + <dd>为摘要认证创建和更新用户认证文件。</dd> + + <dt><program>htdbm</program></dt> + + <dd>操作 DBM 密码数据库。</dd> + + <dt><program>htpasswd</program></dt> + + <dd>为基本认证创建和更新用户认证文件。</dd> + + <dt><program>httxt2dbm</program></dt> + + <dd>为 RewriteMap 创建 dbm 文件。</dd> + + <dt><program>logresolve</program></dt> + + <dd>将 Apache 日志文件中的 IP 地址解析到主机名称。</dd> + + <dt><a href="other.html#log_server_status">log_server_status</a></dt> + + <dd>周期性的记录服务器状态。</dd> + + <dt><program>rotatelogs</program></dt> + + <dd>不关闭 Apache 而切换日志文件。</dd> + + <dt><a href="other.html#split-logfile">split-logfile</a></dt> + + <dd>将多个虚拟主机的日志文件按照主机拆分。</dd> + + <dt><program>suexec</program></dt> + + <dd>执行外部程序前切换用户。</dd> + </dl> +</section> + +</manualpage> diff --git a/docs/manual/rewrite/index.xml.zh-cn b/docs/manual/rewrite/index.xml.zh-cn new file mode 100644 index 0000000000..e7e4a763b0 --- /dev/null +++ b/docs/manual/rewrite/index.xml.zh-cn @@ -0,0 +1,71 @@ +<?xml version='1.0' encoding='UTF-8' ?> +<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.zh-cn.xsl"?> +<!-- English revision : 1028730 --> + +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You 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. +--> + +<manualpage metafile="index.xml.meta"> +<parentdocument href="../"/> + + <title>Apache mod_rewrite</title> + +<summary> + <p><module>mod_rewrite</module> 提供了基于<a + href="intro.html#regex">正则表达式</a>规则动态修改传入的请求的 URL 的方法。 + 这允许你以自己喜欢的任意方法映射任意 URL 到你的内部 URL 结构。</p> + + <p>它支持无限的规则，以及为每个规则附加条件，从而提供了一个真正灵活且强大的 URL + 操作机制。URL 操作可以依赖于各种测试，例如服务器变量，环境变量，HTTP + 头，时戳，甚至外部数据库查询等，以便完成 URL 单元匹配。</p> + + <p>这个模块在服务器上下文 (<code>httpd.conf</code>)，虚拟主机上下文 (<directive + type="section" module="core">VirtualHost</directive> 指令块)，目录上下文 + (<code>.htaccess</code> 文件和 <code><Directory></code> + 指令块) 对完整的 URL (包含目录信息部分和查询字符串部分) 操作。 + 重写结果可以导致新的规则处理，内部的后续处理，外部请求重定向，甚至透过内部代理， + 这取决于你为规则附加的<a href="flags.html">标志</a>。</p> + + <p>既然 mod_rewrite 这么强大，它当然是相当复杂。这篇文档作为<a + href="../mod/mod_rewrite.html">参考手册</a>的补充，试图减轻一些复杂性， + 提供你可能使用 mod_rewrite 的常见场景的有充分注释的例子。 + 但是，我们也试图告诉你，在什么时候你不应当使用 mod_rewrite， + 可以使用其它标准的 Apache 特性来达到目的，以避免无谓的复杂性。</p> + +<ul> +<li><a href="../mod/mod_rewrite.html">mod_rewrite 参考手册</a></li> +<li><a href="intro.html">正则表达式与 mod_rewrite 入门</a></li> +<li><a href="remapping.html">使用 mod_rewrite 重定向和重新映射 URL</a></li> +<li><a href="access.html">使用 mod_rewrite 控制访问</a></li> +<li><a href="vhosts.html">动态虚拟主机与 mod_rewrite</a></li> +<li><a href="proxy.html">动态代理与 mod_rewrite</a></li> +<li><a href="rewritemap.html">使用 RewriteMap</a></li> +<li><a href="advanced.html">高级技术与诀窍</a></li> +<li><a href="avoid.html">何时 <strong>不要</strong>使用 mod_rewrite</a></li> +<li><a href="flags.html">RewriteRule 标志</a></li> +<li><a href="tech.html">技术细节</a></li> +</ul> +</summary> + +<seealso><a href="../mod/mod_rewrite.html">mod_rewrite 参考手册</a></seealso> +<seealso><a href="../urlmapping.html">从 URL 映射到文件系统</a></seealso> +<seealso><a href="http://wiki.apache.org/httpd/Rewrite">mod_rewrite +wiki</a></seealso> +<seealso><a href="../glossary.html">术语</a></seealso> + +</manualpage> diff --git a/docs/manual/sitemap.xml.zh-cn b/docs/manual/sitemap.xml.zh-cn new file mode 100644 index 0000000000..450c6be0b4 --- /dev/null +++ b/docs/manual/sitemap.xml.zh-cn @@ -0,0 +1,171 @@ +<?xml version="1.0" encoding="UTF-8" ?> +<!DOCTYPE sitemap SYSTEM "./style/sitemap.dtd"> +<?xml-stylesheet type="text/xsl" href="./style/manual.zh-cn.xsl"?> +<!-- English revision : 1044380 --> + +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You 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. +--> + +<sitemap metafile="sitemap.xml.meta"> + + <title>站点导航</title> + +<summary> +<p>本页列出了 +<a href="./">Apache HTTP 服务器 &httpd.major;.&httpd.minor; +的全部文档</a>。</p> +</summary> + +<category id="release"> +<title>发行说明</title> +<page href="upgrading.html">从 2.2 升级到 2.4</page> +<page href="new_features_2_4.html">Apache 2.3/2.4 的新特性</page> +<page href="new_features_2_2.html">Apache 2.1/2.2 的新特性</page> +<page href="new_features_2_0.html">Apache 2.0 的新特性</page> +<page href="license.html">Apache 许可证</page> +</category> + +<category id="using"> +<title>使用 Apache HTTP 服务器</title> +<page href="install.html">编译与安装 Apache</page> +<page href="invoking.html">启动 Apache</page> +<page href="stopping.html">停止与重启 Apache</page> +<page href="configuring.html">配置文件</page> +<page href="sections.html">配置片段</page> +<page href="caching.html">缓存指南</page> +<page href="server-wide.html">服务器全局配置</page> +<page href="logs.html">日志文件</page> +<page href="urlmapping.html">从 URL 映射到文件系统</page> +<page href="misc/security_tips.html">安全技巧</page> +<page href="dso.html">动态共享对象(DSO)</page> +<page href="content-negotiation.html">内容协商</page> +<page href="custom-error.html">定制错误响应</page> +<page href="bind.html">绑定指定地址与端口</page> +<page href="mpm.html">多处理模块(MPM)</page> +<page href="env.html">环境变量</page> +<page href="handler.html">Apache 的处理器</page> +<page href="filter.html">过滤器</page> +<page href="suexec.html">执行 CGI 前的用户切换(suEXEC)</page> +<page href="misc/perf-tuning.html">性能调谐</page> +<page href="http://wiki.apache.org/httpd/FAQ">常见问题</page> +</category> + +<category id="vhosts"> +<title>Apache 虚拟主机文档</title> +<page separate="yes" href="vhosts/">概述</page> +<page href="vhosts/name-based.html">基于名称的虚拟主机</page> +<page href="vhosts/ip-based.html">基于 IP 的虚拟主机</page> +<page href="vhosts/mass.html">动态配置的大规模虚拟主机</page> +<page href="vhosts/examples.html">虚拟主机样例</page> +<page href="vhosts/details.html">虚拟主机匹配的深入讨论</page> +<page href="vhosts/fd-limits.html">文件句柄限制</page> +<page href="dns-caveats.html">Apache 的 DNS 相关问题</page> +</category> + +<category id="rewrite"> +<title>URL 改写指南</title> +<page separate="yes" href="rewrite/">概述</page> +<page href="mod/mod_rewrite.html">mod_rewrite 参考文档</page> +<page href="rewrite/intro.html">简介</page> +<page href="rewrite/flags.html">标志</page> +<page href="rewrite/tech.html">技术细节</page> +<page href="rewrite/remapping.html">重新映射 URL</page> +<page href="rewrite/access.html">访问控制</page> +<page href="rewrite/advanced.html">高级技术</page> +</category> + +<category id="ssl"> +<title>Apache SSL/TLS 加密</title> +<page separate="yes" href="ssl/">概述</page> +<page href="ssl/ssl_intro.html">SSL/TLS 加密: 简介</page> +<page href="ssl/ssl_compat.html">SSL/TLS 加密: 兼容性</page> +<page href="ssl/ssl_howto.html">SSL/TLS 加密: 常见操作</page> +<page href="ssl/ssl_faq.html">SSL/TLS 加密: 常见问题</page> +</category> + +<category id="howto"> +<title>指南与教程</title> +<page separate="yes" href="howto/">概述</page> +<page href="howto/auth.html">认证，授权与访问控制</page> +<page href="howto/cgi.html">CGI 与动态内容</page> +<page href="howto/ssi.html">服务器端插入</page> +<page href="howto/htaccess.html">.htaccess 文件</page> +<page href="howto/public_html.html">用户私人网站目录(public_html)</page> +</category> + +<category id="platform"> +<title>平台相关说明</title> +<page separate="yes" href="platform/">概述</page> +<page href="platform/windows.html">在 Microsoft Windows 中使用 Apache</page> +<page href="platform/win_compiling.html">为 Microsoft Windows 编译 Apache</page> +<page href="platform/netware.html">在 Novell NetWare 中使用 Apache</page> +<page href="platform/perf-hp.html">在 HPUX 中运行高性能 web 服务器</page> +<page href="platform/ebcdic.html">Apache 与 EBCDIC 系统</page> +</category> + +<category id="programs"> +<title>Apache HTTP 服务器与支持程序</title> +<page separate="yes" href="programs/">概述</page> +<page href="programs/httpd.html">手册: httpd</page> +<page href="programs/ab.html">手册: ab</page> +<page href="programs/apachectl.html">手册: apachectl</page> +<page href="programs/apxs.html">手册: apxs</page> +<page href="programs/configure.html">手册: configure</page> +<page href="programs/dbmmanage.html">手册: dbmmanage</page> +<page href="programs/htcacheclean.html">手册: htcacheclean</page> +<page href="programs/htdbm.html">手册: htdbm</page> +<page href="programs/htdigest.html">手册: htdigest</page> +<page href="programs/htpasswd.html">手册: htpasswd</page> +<page href="programs/logresolve.html">手册: logresolve</page> +<page href="programs/rotatelogs.html">手册: rotatelogs</page> +<page href="programs/suexec.html">手册: suexec</page> +<page href="programs/other.html">其它程序</page> +</category> + +<category id="misc"> +<title>Apache 杂项文档</title> +<page separate="yes" href="misc/">概述</page> +<page href="misc/relevant_standards.html">相关标准</page> +</category> + +<category id="modules"> +<title>Apache 模块</title> +<page href="mod/module-dict.html">描述模块的术语</page> +<page href="mod/directive-dict.html">描述指令的术语</page> +</category> + +<category id="developer"> +<title>开发者文档</title> +<page separate="yes" href="developer/">概述</page> +<page href="developer/API.html">Apache API 说明</page> +<page href="developer/debugging.html">在 APR 中调试内存分配</page> +<page href="developer/documenting.html">Apache 2.x 文档</page> +<page href="developer/hooks.html">Apache 2.x 钩子函数</page> +<page href="developer/modules.html">将模块从 Apache 1.3 移植到 Apache 2.x</page> +<page href="developer/request.html">Apache 2.x 中的请求处理</page> +<page href="developer/filters.html">Apache 2.x 中的过滤器</page> +</category> + +<category id="index"> +<title>术语与索引</title> +<page href="glossary.html">术语</page> +<page href="mod/">模块索引</page> +<page href="mod/directives.html">指令索引</page> +<page href="mod/quickreference.html">指令快速参考</page> +</category> + +</sitemap> diff --git a/docs/manual/ssl/index.xml.zh-cn b/docs/manual/ssl/index.xml.zh-cn new file mode 100644 index 0000000000..48ff1099ad --- /dev/null +++ b/docs/manual/ssl/index.xml.zh-cn @@ -0,0 +1,54 @@ +<?xml version='1.0' encoding='UTF-8' ?> +<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?> +<!-- English revision : 420990 --> + +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You 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. +--> + +<manualpage metafile="index.xml.meta"> +<parentdocument href="../"/> + + <title>Apache SSL/TLS 加密</title> + +<summary> +<p>Apache HTTP 服务器模块 <module>mod_ssl</module> +提供了与 <a href="http://www.openssl.org/">OpenSSL</a> +的接口，它使用安全套接字层和传输层安全协议提供了强加密。 +此模块与这篇文档都基于 +Ralf S. Engelschall 的 mod_ssl 项目。</p> +</summary> + +<section id="documentation"><title>文档</title> +<ul> +<li><a href="ssl_intro.html">简介</a></li> +<li><a href="ssl_compat.html">兼容性</a></li> +<li><a href="ssl_howto.html">常见操作</a></li> +<li><a href="ssl_faq.html">常见问题</a></li> +<li><a href="../glossary.html">术语</a></li> +</ul> +</section> + +<section id="mod-ssl"><title>mod_ssl</title> +<p>此模块提供的指令和环境变量的文档位于 <a +href="../mod/mod_ssl.html">mod_ssl 参考手册</a>。 +</p> +</section> + +</manualpage> + + diff --git a/docs/manual/style/lang-targets.xml b/docs/manual/style/lang-targets.xml index fba83950c8..17cf1cab03 100644 --- a/docs/manual/style/lang-targets.xml +++ b/docs/manual/style/lang-targets.xml @@ -23,9 +23,9 @@ <project name="lang-targets"> <target name="check-man"><if><not><available type="dir" file="../../man"/></not><then><property value="yes" name="skip-man"/></then></if></target> -<target description="- builds all HTML files and nroff man pages" name="all" depends="da, de, en, es, fr, ja, ko, pt-br, ru, tr"/> -<target description="- builds all zip download packages" name="zip-all" depends="zip-da, zip-de, zip-en, zip-es, zip-fr, zip-ja, zip-ko, zip-pt-br, zip-ru, zip-tr"/> -<target description="- builds all war download packages" name="war-all" depends="war-da, war-de, war-en, war-es, war-fr, war-ja, war-ko, war-pt-br, war-ru, war-tr"/> +<target description="- builds all HTML files and nroff man pages" name="all" depends="da, de, en, es, fr, ja, ko, pt-br, ru, tr, zh-cn"/> +<target description="- builds all zip download packages" name="zip-all" depends="zip-da, zip-de, zip-en, zip-es, zip-fr, zip-ja, zip-ko, zip-pt-br, zip-ru, zip-tr, zip-zh-cn"/> +<target description="- builds all war download packages" name="war-all" depends="war-da, war-de, war-en, war-es, war-fr, war-ja, war-ko, war-pt-br, war-ru, war-tr, war-zh-cn"/> <!-- Dansk --> <!-- ==================================================================== --> @@ -261,6 +261,32 @@ <nroff.generic lang="tr"/> </target> +<!-- Simplified Chinese --> +<!-- ==================================================================== --> +<property value=".xml.zh-cn" name="inputext.zh-cn"/> +<property value=".html.zh-cn" name="outputext.zh-cn"/> + +<target description="- builds Simplified Chinese HTML files" name="zh-cn"> + <html.generic lang="zh-cn"/> +</target> +<target unless="-off.zh-cn.done" depends="metafiles" name="-off-zh-cn"> + <dependencies.offline dir="_off" style="zip" lang="zh-cn"/> + <offline.generic dir="_off" style="zip" lang="zh-cn"/> + <property value="yes" name="-off.zh-cn.done"/> +</target> +<target description="- builds the Simplified Chinese zipped download package" depends="-off-zh-cn" name="zip-zh-cn"> + <zip.generic lang="zh-cn"/> +</target> +<target description="- builds the Simplified Chinese Konqueror Web Archive" depends="-off-zh-cn" name="war-zh-cn"> + <war.generic lang="zh-cn"/> +</target> +<target description="- builds the Simplified Chinese CHM file" name="chm-zh-cn"> + <chm.generic lang="zh-cn"/> +</target> +<target description="- builds the Simplified Chinese nroff files" depends="check-man" name="man-zh-cn"> + <nroff.generic lang="zh-cn"/> +</target> + <!-- XML validation. --> <!-- If you get an error during transformation, this task may be useful --> <!-- because it mostly gives you a hint, where you forgot the </p> ;-) --> @@ -279,6 +305,7 @@ <include name="**/*.xml.pt-br"/> <include name="**/*.xml.ru"/> <include name="**/*.xml.tr"/> + <include name="**/*.xml.zh-cn"/> <patternset refid="excludes"/> <patternset refid="scratch"/> @@ -286,4 +313,4 @@ </xmlvalidate> </target> -</project>
\ No newline at end of file +</project> diff --git a/docs/manual/style/lang/zh-cn.xml b/docs/manual/style/lang/zh-cn.xml new file mode 100644 index 0000000000..45e75e72c7 --- /dev/null +++ b/docs/manual/style/lang/zh-cn.xml @@ -0,0 +1,141 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE language SYSTEM "../lang.dtd"> +<!-- $LastChangedRevision: -1 $ --> + +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You 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. +--> + +<language id="zh-cn"> + <name>Simplified Chinese</name> + <charset>UTF-8</charset> + <source-ext>.xml</source-ext> + <target-ext>.html.zh-cn</target-ext> + + <chm> + <lang>936 Simplified Chinese</lang> + <toc-font>SimSun,12,0</toc-font> + <charset>GBK</charset> + <settings>Simplified Chinese</settings> + </chm> + + <man> + <charset>UTF-8</charset> + </man> + + <!-- Some strings might be used in other contexts, than stated in the --> + <!-- comments... --> + <messages> + <!-- language link titles --> + <message id="nativename">Simplified Chinese</message> + + <!-- Used for the moduleindex --> + <message id="corefeatures">核心特性与多处理模块(MPM)</message> + <message id="othermodules">其它模块</message> + <message id="obsoletemodules">过时的模块</message> + + <!-- Used for the modulesynopsis and sitemap --> + <message id="obsoleteapachemodule">过时的 Apache 模块</message> + <message id="apachemodule">Apache 模块</message> + <message id="apachecore">Apache 核心特性</message> + <message id="apachempmcommon">Apache MPM 通用指令</message> + <message id="apachempm">Apache MPM</message> + + <!-- Used in description box for modulesynopsis --> + <message id="description">描述</message> + <message id="seealso">参见</message> + <message id="topics">主题</message> + <message id="status">状态</message> + <message id="moduleidentifier">模块标识</message> + <message id="sourcefile">源文件</message> + <message id="compatibility">兼容性</message> + + <!-- Used in manualpage --> + <message id="relatedmodules">相关模块</message> + <message id="relateddirectives">相关指令</message> + <message id="lowercase">abcdefghijklmnopqrstuvwxyz</message> + <message id="uppercase">ABCDEFGHIJKLMNOPQRSTUVWXYZ</message> + <message id="name-section">名称</message> + <message id="hyphenation"></message> + + <!-- Used in description box for directives --> + <message id="syntax">语法</message> + <message id="default">默认</message> + <message id="context">上下文</message> + <message id="override">覆盖</message> + <message id="status">状态</message> + <message id="module">模块</message> + + <!-- Status descriptions --> + <message id="base" letter="B">基础</message> + <message id="mpm" letter="M">MPM</message> + <message id="core" letter="C">核心</message> + <message id="extension" letter="E">扩展</message> + <message id="experimental" letter="X">实验</message> + + <!-- Used in directive context lists --> + <message id="serverconfig" letter="s">服务器配置</message> + <message id="virtualhost" letter="v">虚拟主机</message> + <message id="directory" letter="d">目录</message> + <message id="htaccess" letter="h">.htaccess</message> + + <!-- Used for directive lists --> + <message id="directives">指令</message> + <!-- the optional attribute replace-space-with takes a string. + if present, the space between <directive name> and 'Directive' + in directivesynopsis headings will be replaced by the given string. + (see de.xml for an example) --> + <message id="directive">指令</message> + <message id="nodirectives">此模块没有提供指令。</message> + + <!-- Used in summaries --> + <message id="summary">摘要</message> + + <!-- Used for glossary link titles --> + <message id="glossarylink">参见术语</message> + + <!-- Used in headers and footers --> + <message id="apachetitle">- Apache HTTP 服务器</message> + <message id="apachehttpserver">Apache HTTP 服务器版本 + &httpd.major;.&httpd.minor;</message> + <message id="apachedocalt">[APACHE 文档]</message> + <message id="search">Google 搜索</message> <!-- search button --> + <message id="index">索引</message> <!-- deprecated --> + <message id="home">主页</message> <!-- deprecated --> + + <!-- breadcrumb links --> + <message id="apache">Apache</message> + <message id="http-server">HTTP 服务器</message> + <message id="documentation">文档</message> + <message id="version">版本 &httpd.major;.&httpd.minor;</message> + + <!-- super menu --> + <message id="modules">模块</message> + <message id="faq">常见问题</message> + <message id="glossary">术语</message> + <message id="sitemap">网站导航</message> + + <!-- footer line --> + <message id="before-license">基于</message> + <message id="after-license">许可证</message> + <message id="langavail">可用语言</message> + + <!-- not up to date --> + <message id="outofdate">此翻译可能过期。要了解最近的更改，请阅读英文版。</message> + <!-- directive not translated yet --> + <message id="nottranslated">此指令的文档还没有被翻译。请阅读英文版。</message> + </messages> +</language> diff --git a/docs/manual/style/manual.zh-cn.xsl b/docs/manual/style/manual.zh-cn.xsl new file mode 100644 index 0000000000..ece7d0db76 --- /dev/null +++ b/docs/manual/style/manual.zh-cn.xsl @@ -0,0 +1,37 @@ +<?xml version="1.0" encoding="utf-8"?> + +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You 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. +--> + +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"> + +<xsl:output method="xml" encoding="UTF-8" indent="no" doctype-public="-//W3C//DTD XHTML 1.0 Strict//EN" doctype-system="http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"/> + +<!-- Read the localized messages from the specified language file --> +<xsl:variable name="message" select="document('lang/zh-cn.xml')/language/messages/message"/> +<xsl:variable name="doclang">zh-cn</xsl:variable> +<xsl:variable name="allmodules" select="document('xsl/util/allmodules.xml')/items/item[@lang=$doclang]"/> + +<!-- some meta information have to be passed to the transformation --> +<xsl:variable name="output-encoding">UTF-8</xsl:variable> +<xsl:variable name="is-chm" select="false()"/> +<xsl:variable name="is-zip" select="false()"/> + +<!-- Now get the real guts of the stylesheet --> +<xsl:include href="xsl/common.xsl"/> + +</xsl:stylesheet> diff --git a/docs/manual/style/xsl/util/allmodules.xml b/docs/manual/style/xsl/util/allmodules.xml index 24378bce0d..f60588a6fb 100644 --- a/docs/manual/style/xsl/util/allmodules.xml +++ b/docs/manual/style/xsl/util/allmodules.xml @@ -10,4 +10,5 @@ <item lang="pt-br">../../../mod/allmodules.xml.pt-br</item> <item lang="ru">../../../mod/allmodules.xml.ru</item> <item lang="tr">../../../mod/allmodules.xml.tr</item> -</items>
\ No newline at end of file +<item lang="zh-cn">../../../mod/allmodules.xml.zh-cn</item> +</items> diff --git a/docs/manual/style/xsl/util/designations.xml b/docs/manual/style/xsl/util/designations.xml index 5e363f6568..0091213564 100644 --- a/docs/manual/style/xsl/util/designations.xml +++ b/docs/manual/style/xsl/util/designations.xml @@ -10,4 +10,5 @@ <item charset="ISO-8859-1" lang="pt-br">.html.pt-br</item> <item charset="KOI8-R" lang="ru">.html.ru.koi8-r</item> <item charset="UTF-8" lang="tr">.html.tr.utf8</item> +<item charset="UTF-8" lang="zh-cn">.html.zh-cn</item> </items> diff --git a/docs/manual/vhosts/index.xml.zh-cn b/docs/manual/vhosts/index.xml.zh-cn new file mode 100644 index 0000000000..98e8291a01 --- /dev/null +++ b/docs/manual/vhosts/index.xml.zh-cn @@ -0,0 +1,89 @@ +<?xml version='1.0' encoding='UTF-8' ?> +<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd"> +<?xml-stylesheet type="text/xsl" href="../style/manual.zh-cn.xsl"?> +<!-- English revision : 1053231 --> + +<!-- + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You 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. +--> + +<manualpage metafile="index.xml.meta"> +<parentdocument href="../"/> + + <title>Apache 虚拟主机文档</title> + +<summary> + + <p>术语<cite>虚拟主机</cite>指的是在单一机器上运行多个网站 + (例如 <code>company1.example.com</code> 和 + <code>company2.example.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 中支持虚拟主机的所有详细信息的文档页面列表。</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>日志文件太多</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">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> |