Adds simplified chinese transation. See tid50767. Via dongsheng@apache.org

<?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 : 586771 -->

<!--

 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>。

    例如 (使用 &amp;gt; 而不是 &gt;):</p>

    <example>

      /**<br />

 &nbsp;* return the final element of the pathname<br />

 &nbsp;* @param pathname The path to get the final element of<br />

 &nbsp;* @return the final element of the path<br />

 &nbsp;* @tip Examples:<br />

 &nbsp;* &lt;pre&gt;<br />

 &nbsp;*                 "/foo/bar/gum"   -&amp;gt; "gum"<br />

 &nbsp;*                 "/foo/bar/gum/"  -&amp;gt; ""<br />

 &nbsp;*                 "gum"            -&amp;gt; "gum"<br />

 &nbsp;*                 "wi\\n32\\stuff" -&amp;gt; "stuff"<br />

 &nbsp;* &lt;/pre&gt;<br />

 &nbsp;* @deffunc const char * ap_filename_of_pathname(const char *pathname)<br />

  */

    </example>

    <p>总是在头文件开始包含:</p>

    <example>

      /**<br />

 &nbsp;* @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>

<?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 : 421100 -->

<!--

 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.0

    时，它们可能位于不同的阶段。请耐心等待，或者直接向

    <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="hooks.html">Apache 2.0 钩子函数</a></li>

      <li><a href="request.html">Apache 2.0 中的请求处理</a></li>

      <li><a href="filters.html">Apache 2.0 中的过滤器</a></li>

      <li><a href="modules.html">将模块从 Apache 1.3 移植到 Apache 2.0</a></li>

      <li><a href="debugging.html">在 APR 中调试内存分配</a></li>

      <li><a href="documenting.html">Apache 2.0 文档</a></li>

      <li><a href="thread_safety.html">Apache 2.0 的线程安全问题</a></li>

    </ul>

</section>

<section id="external"><title>外部资源</title>

    <ul>

      <!--

      <li>Ian Holsman 提供的工具:

      <ul>

        <li><a href="http://lxr.webperf.org/">Apache 2 交叉索引</a></li>

        <li><a href="http://docx.webperf.org/"

        >自动生成的 Apache 2 代码文档</a></li>

      </ul></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>

<?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 : 1044382 -->

<!--

 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>

<?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 : 421100 -->

<!--

 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>

        &lt;Directory /web/htdocs/asis&gt;<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-&gt;handler</code> 指向处理器名称。处理器的实现与以前一样，只是用处理器名称取代了内容类型。

    虽然不是必要，处理器的命名约定是使用破折号分割的单词，没有斜杠，从而不侵入媒体类型名称空间。</p>

  </section>

</manualpage>

<?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 : 1044382 -->

<!--

 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>