From fe35786735d12d64c65ddb9b9b87227be0f28504 Mon Sep 17 00:00:00 2001 From: Rich Bowen Date: Tue, 15 Feb 2011 12:46:52 +0000 Subject: [PATCH] Adds simplified Chinese translation to httpd trunk docs. Via dongsheng@apache.org (see tid 50767) git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1070870 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/developer/documenting.xml.zh-cn | 79 +++++++++ docs/manual/developer/index.xml.zh-cn | 79 +++++++++ docs/manual/faq/index.xml.zh-cn | 33 ++++ docs/manual/handler.xml.zh-cn | 128 +++++++++++++++ docs/manual/howto/index.xml.zh-cn | 102 ++++++++++++ docs/manual/index.xml.zh-cn | 92 +++++++++++ docs/manual/misc/index.xml.zh-cn | 66 ++++++++ docs/manual/mod/directives.xml.zh-cn | 35 ++++ docs/manual/mod/index.xml.zh-cn | 35 ++++ docs/manual/mod/quickreference.xml.zh-cn | 34 ++++ docs/manual/mpm.xml.zh-cn | 110 +++++++++++++ docs/manual/platform/index.xml.zh-cn | 82 ++++++++++ docs/manual/programs/index.xml.zh-cn | 104 ++++++++++++ docs/manual/rewrite/index.xml.zh-cn | 71 ++++++++ docs/manual/sitemap.xml.zh-cn | 171 ++++++++++++++++++++ docs/manual/ssl/index.xml.zh-cn | 54 +++++++ docs/manual/style/lang-targets.xml | 35 +++- docs/manual/style/lang/zh-cn.xml | 141 ++++++++++++++++ docs/manual/style/manual.zh-cn.xsl | 37 +++++ docs/manual/style/xsl/util/allmodules.xml | 3 +- docs/manual/style/xsl/util/designations.xml | 1 + docs/manual/vhosts/index.xml.zh-cn | 89 ++++++++++ 22 files changed, 1576 insertions(+), 5 deletions(-) create mode 100644 docs/manual/developer/documenting.xml.zh-cn create mode 100644 docs/manual/developer/index.xml.zh-cn create mode 100644 docs/manual/faq/index.xml.zh-cn create mode 100644 docs/manual/handler.xml.zh-cn create mode 100644 docs/manual/howto/index.xml.zh-cn create mode 100644 docs/manual/index.xml.zh-cn create mode 100644 docs/manual/misc/index.xml.zh-cn create mode 100644 docs/manual/mod/directives.xml.zh-cn create mode 100644 docs/manual/mod/index.xml.zh-cn create mode 100644 docs/manual/mod/quickreference.xml.zh-cn create mode 100644 docs/manual/mpm.xml.zh-cn create mode 100644 docs/manual/platform/index.xml.zh-cn create mode 100644 docs/manual/programs/index.xml.zh-cn create mode 100644 docs/manual/rewrite/index.xml.zh-cn create mode 100644 docs/manual/sitemap.xml.zh-cn create mode 100644 docs/manual/ssl/index.xml.zh-cn create mode 100644 docs/manual/style/lang/zh-cn.xml create mode 100644 docs/manual/style/manual.zh-cn.xsl create mode 100644 docs/manual/vhosts/index.xml.zh-cn 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 @@ + + + + + + + + +开发者文档 + +Apache 2.0 文档 + + +

Apache 2.0 使用 Doxygen 从代码中 + 生成 API 和全局变量的文档。下面是对使用 Doxygen 生成文档的简介。

+ + +
简要说明 +

使用 /** 开始文档块
+ 使用 */ 结束文档块

+ +

在文档块中，我们可以使用多个标签:

+ + + Description of this functions purpose
+ @param parameter_name description
+ @return description
+ @deffunc signature of the function
+ + +

一般不需要 deffunc 。DoxyGen 没有完整的解析器，所以任何 + 在返回类型声明中使用宏的原型，都是太复杂了。这些函数就需要使用 deffunc。 + 例如 (使用 > 而不是 >):

+ + + /**
+  * return the final element of the pathname
+  * @param pathname The path to get the final element of
+  * @return the final element of the path
+  * @tip Examples:
+  * <pre>
+  * "/foo/bar/gum" -&gt; "gum"
+  * "/foo/bar/gum/" -&gt; ""
+  * "gum" -&gt; "gum"
+  * "wi\\n32\\stuff" -&gt; "stuff"
+  * </pre>
+  * @deffunc const char * ap_filename_of_pathname(const char *pathname)
+  */ + + +

总是在头文件开始包含:

+ + /**
+  * @package Name of library header
+  */ + + +

Doxygen 为每个包生成一个新的 HTML 文件，名字是 + {Name_of_library_header}.html，所以请简化名称。

+ +

更深入的讨论，请参见 + Doxygen 站点。

+
+ 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 @@ + + + + + + + + + + +Apache 2.0 开发者文档 + + +

开发者页面的许多文档都来自于 Apache 1.3。当更新到 Apache 2 + 时，它们可能位于不同的阶段。请耐心等待，或者直接向 + dev@httpd.apache.org 邮件列表报告开发者页面的差异或错误。

+ + +
主题 + +
+ +
外部资源 + +
+ 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 @@ + + + + + + + + + + +常见问题 + + +

常见问题已经移到 HTTP 服务器维基。

+ + + 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 @@ + + + + + + + + + + Apache 的处理器 + + +

本页描述 Apache 处理器的用法。

+ + +
+ 什么是处理器 + + + mod_actions + mod_asis + mod_cgi + mod_imagemap + mod_info + mod_mime + mod_negotiation + mod_status + + + Action + AddHandler + RemoveHandler + SetHandler + + + + +

“处理器”是当文件被调用时，Apache 要执行的动作的内部表示形式。 + 一般来说，每个文件都有基于其文件类型的隐式处理器。通常的文件会被 + 服务器简单处理，但是某些文件类型会被分别“处理”。

+ +

处理器也可以被基于扩展名或位置来明确配置。它们都很有用，这不仅 + 因为它是优雅的方案，而且还允许类型与处理器关联到文件 + (参见文件与多个扩展名)。

+ +

处理器可以编译到服务器中，或者包含在模块中，它们还可以被 Action 指令增加。标准发行版中内置的处理器有:

+ +
    +
  • default-handler: 使用 + default_handler() 发送文件，它是用来处理静态内容的处理器(核心)。
    • + +
  • send-as-is: 直接发送，不增加 HTTP 头(mod_asis)。
    • + +
  • cgi-script: 按 CGI 脚本处理(mod_cgi)。
    • + +
  • imap-file: 按 imagemap 规则处理(mod_imagemap)。
    • + +
  • server-info: 取得服务器配置信息(mod_info)。
    • + +
  • server-status: 取得服务器状态报告(mod_status)。
    • + +
  • type-map: 用于内容协商，按类型映射文件处理(mod_negotiation)。
    • +
+
+
+ 例子 + +
+ 使用 CGI 脚本修改静态内容 + +

下面的指令将会使具有html扩展名的文件，触发 CGI 脚本footer.pl的执行。

+ + + Action add-footer /cgi-bin/footer.pl
+ AddHandler add-footer .html + + +

于是 CGI 负责发送请求的文档(PATH_TRANSLATED 环境变量指向它)，按照需要作出 and making + whatever modifications or additions are desired.

+ +
+
+ 含有 HTTP 头的文件 + +

下面的指令会启用 + send-as-is 处理器，用于包含自己的 HTTP 的文件。不管什么扩展名， + 所有位于 /web/htdocs/asis/ 目录的文件会被 + send-as-is 处理器处理。

+ + + <Directory /web/htdocs/asis>
+ SetHandler send-as-is
+ </Directory> + + +
+
+
+ 对程序员的说明 + +

为了实现处理器特性，增加了需要使用的 Apache API。 + 特别的，结构 request_rec 增加了新成员:

+ + + char *handler + + +

如果你想要模块实现处理器，只需要在在处理请求，调用 invoke_handler + 之前，将 r->handler 指向处理器名称。处理器的实现与以前一样，只是用处理器名称取代了内容类型。 + 虽然不是必要，处理器的命名约定是使用破折号分割的单词，没有斜杠，从而不侵入媒体类型名称空间。

+
+ 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 @@ + + + + + + + + + + + 常见操作/教程 + +
+ + 常见操作/教程 + +
+
认证与授权
+
+

认证是你验证某人是所声称的人。 + 授权是允许某人执行他想要的操作，或者获得想要的信息。

+ +

参见: 认证，授权与访问控制

+
+
+ +
+
访问控制
+
+

访问控制是操作限制，或基于任意条件访问资源。这可以通过多种方法完成。

+ + +
+
+ +
+
CGI 与动态内容
+
+

CGI (通用网管接口) 为 web 服务器定义了与外部的内容生成程序的操作接口， + 通常称为 CGI 程序或 CGI 脚本。它是在 web 站点放入动态内容的最简单， + 也最常用的方法。 本文简单介绍了在 Apache 服务器中配置 CGI 的方法， + 以及如何编写 CGI 程序。

+ +

参见: CGI 与动态内容

+
+
+ +
+
.htaccess 文件
+
+

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

+ +

See: .htaccess files

+
+
+ +
+
服务器端插入简介
+
+

SSI (服务器端插入) 是在 HTML 页面中放入的指令，在页面被访问的时候执行。 + 它允许你在现有的 HTML 页面增加动态生成的内容，不需要通过 CGI + 程序或其它动态计数来生成整个页面。

+ +

参见: 服务器端插入 (SSI)

+
+
+ +
+
用户私人网站目录
+
+

在有多个用户的系统中，使用 UserDir 指令，可以允许每个用户在他们的根目录中都有一个 + web 站点。 访问 URL http://example.com/~username/ 会得到位于用户 + "username" 根目录中由 UserDir 指定的子目录中的内容。

+ +

参见: 用户私人网站目录 (public_html)

+
+
+ +
+ + 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 @@ + + + + + + + + + + +Apache HTTP 服务器 &httpd.major;.&httpd.minor; 文档 + +发行说明 + Apache 2.3/2.4 的新特性 + Apache 2.1/2.2 的新特性 + Apache 2.0 的新特性 + 从 2.2 升级到 2.4 + Apache 许可证 + + +参考手册 + 编译与安装 + 启动 + 停止与重启 + 配置指令 + 指令快速参考 + 模块 + 多处理模块(MPM) + 过滤器 + 处理器 + 表达式解析器 + 服务器与支持程序 + 术语 + + +用户指南 + 绑定指定地址与端口 + 配置文件 + 配置片段 + 缓存指南 + 内容协商 + 动态共享对象(DSO) + 环境变量 + 日志文件 + 从 URL 映射到文件系统 + 性能调谐 + 安全技巧 + 服务器全局配置 + SSL/TLS 加密 + 执行 CGI 前的用户切换(suEXEC) + URL 改写与 mod_rewrite + 虚拟主机 + + +指引/教程 + 认证，授权与访问控制 + CGI 与动态内容 + .htaccess 文件 + 服务器端插入(SSI) + 用户私人网站目录(public_html) + + +平台相关说明 + Microsoft Windows + Novell NetWare + EBCDIC 系统 + + +其它主题 + 常见问题 + 网站导航 + 开发文档 + 其它说明 + 维基 + + + 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 @@ + + + + + + + + + + + Apache 杂项文档 + + + +

下面是适用于 Apache 服务器开发项目的附加文档。

+ + 警告 +

下面的文档尚未完全更新，以反映自 Apache HTTP 服务器版本 2.1 + 之后的修改。某些信息可能仍旧适用，但请小心使用它。

+ + +
+
Apache 性能调谐
+ +
+

对如何在编译或运行时，配置 Apache，以便性能更高的说明。 + 解释了为什么 Apache 这样做，而不那样做 (这会让它更慢或更快)。

+
+ +
安全技巧
+ +
+

做和不做 - 如何让你的 Apache 站点保持安全。

+
+ +
相关标准
+ +
+

这篇文档是 Apache 遵循的相关标准的参考页面。

+
+ +
密码加密格式
+ +
+

对 Apache 身份认证支持的各种密码加密格式的讨论。

+
+
+ + + + 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 @@ + + + + + + + + + 指令索引 + +

+ 每个在 Apache 标准发行版中可用的指令都列在这里。它们使用一致的格式描述，而且有术语字典。 +

+ +

+ 指令快速参考用来以摘要的形式提供有关每个指令的详细信息。 +

+ + 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 @@ + + + + + + + + + 模块索引 + +

+ 下面是 Apache HTTP 服务器发行版中的所有模块列表。参见按照字母顺序罗列的所有 Apache HTTP 服务器指令。 +

+ + 多处理模块(MPM) + + 指令快速索引 + + 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 @@ + + + + + + + + + 指令快速索引 + +

指令快速索引显示指令的用法，默认值，状态和上下文。要获得更多信息，请参见 描述指令的术语。

+ +

第一列给出指令的名称与用法。第二列显示指令的默认值(如果有的话)。 + 如果因为默认值太长而被截断显示，会在最后一个字符之后显示字符 “+”。

+ +

第三列显示允许此指令的上下文，第四列显示指令的状态。

+ + 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 @@ + + + + + + + + + + 多处理模块(MPM) + + +

本文档介绍了什么是多处理模块，以及 Apache HTTP 服务器如何使用它们。

+ + +
介绍 + +

Apache HTTP 服务器被设计为一个功能强大，并且灵活的 web 服务器， + 可以在很多平台与环境中工作。不同平台和不同的环境往往需要不同 + 的特性，或可能以不同的方式实现相同的特性最有效率。Apache httpd + 通过模块化的设计来适应各种环境。这种设计允许网站管理员通过在 + 编译时或运行时，选择哪些模块将会加载在服务器中，来选择服务器特性。

+ +

Apache HTTP 服务器 2.0 扩展此模块化设计到最基本的 web 服务器功能。 + 它提供了可以选择的多处理模块(MPM)，用来绑定到网络端口上，接受请求， + 以及调度子进程处理请求。

+ +

扩展到这一级别的服务器模块化设计，带来两个重要的好处:

+ +
    +
  • Apache httpd 能更优雅，更高效率的支持不同的平台。尤其是 + Apache httpd 的 Windows 版本现在更有效率了，因为 + mpm_winnt 能使用原生网络特性取代在 + Apache httpd 1.3 中使用的 POSIX 层。它也可以扩展到其它平台 + 来使用专用的 MPM。
    • + +
  • Apache httpd 能更好的为有特殊要求的站点定制。例如，要求 + 更高伸缩性的站点可以选择使用线程的 MPM，即 + worker 或 event； + 需要可靠性或者与旧软件兼容的站点可以使用 + prefork。
    • +
+ +

在用户看来，MPM 很像其它 Apache httpd 模块。主要是区别是，在任何时间， + 必须有一个，而且只有一个 MPM 加载到服务器中。可用的 MPM 列表位于 + 模块索引页面。

+ +
+ +
默认 MPM + +

下表列出了不同系统的默认 MPM。如果你不在编译时选择，那么它就是你将要使用的 MPM。

+ + + + + + + +
Netwarempm_netware
OS/2mpmt_os2
Unixprefork，worker 或 + event，取决于平台特性
Windowsmpm_winnt
+
+ +
构建 MPM 为静态模块 + +

在全部平台中，MPM 都可以构建为静态模块。在构建时选择一种 + MPM，链接到服务器中。如果要改变 MPM，必须重新构建。

+ +

为了使用指定的 MPM，请在执行 configure 脚本 + 时，使用参数 --with-mpm=NAME。NAME + 是指定的 MPM 名称。

+ +

编译完成后，可以使用 ./httpd -l 来确定选择的 MPM。 + 此命令会列出编译到服务器程序中的所有模块，包括 MPM。

+ +
+ +
构建 MPM 为动态模块 + +

在 Unix 或类似平台中，MPM 可以构建为动态模块，与其它动态模块一样在运行时加载。 + 构建 MPM 为动态模块允许通过修改 LoadModule + 指令内容来改变 MPM，而不用重新构建服务器程序。

+ +

在执行 configure 脚本时，使用 + --enable-mpms-shared 选项可以启用此特性。 + 当给出的参数为 all 时，所有此平台支持的 MPM + 模块都会被安装。还可以在参数中给出模块列表。

+ +

默认 MPM，可以自动选择或者在执行 configure + 脚本时通过 --with-mpm 选项来指定，然后出现在生成的服务器配置文件中。 + 编辑 LoadModule 指令内容可以选择不同的 MPM。

+ +
+ + 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 @@ + + + + + + + + + + + 平台相关说明 + +
+ + Microsoft Windows + +
+
使用 Apache
+
+

这篇文档解释了如何在 Microsoft Windows 中安装，配置，以及运行 Apache 2.0 。

+ +

参见: 在 Microsoft Windows 中使用 Apache

+
+
+ +
+
编译 Apache
+
+

这篇文档解释了编译 Apache 的要点。

+ +

参见: 为 Microsoft Windows 编译 Apache

+
+
+ +
+ +
+ + 其它平台 + +
+
Novell NetWare
+
+

这篇文档解释了如何在 Novell NetWare 5.1 或更新的版本中，如何安装，配置，以及运行 + Apache 2.0 。 +

+ +

参见: 在 Novell NetWare 中使用 Apache

+
+
+ +
+
EBCDIC
+
+

从 Apache HTTP 版本 1.3 开始支持使用 EBCDIC 字符集作为原生字符集的(非 ASCII)主机。

+ + 警告: + 这篇文档尚未完全更新，以反映自 Apache HTTP 服务器版本 2.0 + 之后的修改。某些信息可能仍旧适用，但请小心使用它。 + +

参见: Apache 与 EBCDIC 系统

+
+
+ +
+ + 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 @@ + + + + + + + + + + + Apache HTTP 服务器与支持程序 + + +

本页描述了 Apache HTTP 服务器包含的所有可执行程序。

+ + +
索引 + +
+
httpd
+ +
Apache 服务器。
+ +
apachectl
+ +
Apache HTTP 服务器控制工具。
+ +
ab
+ +
Apache HTTP 服务器性能基准工具。
+ +
apxs
+ +
Apache 扩展工具。
+ +
configure
+ +
配置源代码。
+ +
dbmmanage
+ +
为基本认证创建和更新 DBM 格式的用户认证文件。
+ +
fcgistarter
+ +
启动 FastCGI 程序。
+ +
htcacheclean
+
清理磁盘缓存。
+ +
htdigest
+ +
为摘要认证创建和更新用户认证文件。
+ +
htdbm
+ +
操作 DBM 密码数据库。
+ +
htpasswd
+ +
为基本认证创建和更新用户认证文件。
+ +
httxt2dbm
+ +
为 RewriteMap 创建 dbm 文件。
+ +
logresolve
+ +
将 Apache 日志文件中的 IP 地址解析到主机名称。
+ +
log_server_status
+ +
周期性的记录服务器状态。
+ +
rotatelogs
+ +
不关闭 Apache 而切换日志文件。
+ +
split-logfile
+ +
将多个虚拟主机的日志文件按照主机拆分。
+ +
suexec
+ +
执行外部程序前切换用户。
+
+
+ + 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 @@ + + + + + + + + + + + Apache mod_rewrite + + +

mod_rewrite 提供了基于正则表达式规则动态修改传入的请求的 URL 的方法。 + 这允许你以自己喜欢的任意方法映射任意 URL 到你的内部 URL 结构。

+ +

它支持无限的规则，以及为每个规则附加条件，从而提供了一个真正灵活且强大的 URL + 操作机制。URL 操作可以依赖于各种测试，例如服务器变量，环境变量，HTTP + 头，时戳，甚至外部数据库查询等，以便完成 URL 单元匹配。

+ +

这个模块在服务器上下文 (httpd.conf)，虚拟主机上下文 (VirtualHost 指令块)，目录上下文 + (.htaccess 文件和 <Directory> + 指令块) 对完整的 URL (包含目录信息部分和查询字符串部分) 操作。 + 重写结果可以导致新的规则处理，内部的后续处理，外部请求重定向，甚至透过内部代理， + 这取决于你为规则附加的标志。

+ +

既然 mod_rewrite 这么强大，它当然是相当复杂。这篇文档作为参考手册的补充，试图减轻一些复杂性， + 提供你可能使用 mod_rewrite 的常见场景的有充分注释的例子。 + 但是，我们也试图告诉你，在什么时候你不应当使用 mod_rewrite， + 可以使用其它标准的 Apache 特性来达到目的，以避免无谓的复杂性。

+ + + + +mod_rewrite 参考手册 +从 URL 映射到文件系统 +mod_rewrite +wiki +术语 + + 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 @@ + + + + + + + + + + 站点导航 + + +

本页列出了 +Apache HTTP 服务器 &httpd.major;.&httpd.minor; +的全部文档。

+ + + +发行说明 +从 2.2 升级到 2.4 +Apache 2.3/2.4 的新特性 +Apache 2.1/2.2 的新特性 +Apache 2.0 的新特性 +Apache 许可证 + + + +使用 Apache HTTP 服务器 +编译与安装 Apache +启动 Apache +停止与重启 Apache +配置文件 +配置片段 +缓存指南 +服务器全局配置 +日志文件 +从 URL 映射到文件系统 +安全技巧 +动态共享对象(DSO) +内容协商 +定制错误响应 +绑定指定地址与端口 +多处理模块(MPM) +环境变量 +Apache 的处理器 +过滤器 +执行 CGI 前的用户切换(suEXEC) +性能调谐 +常见问题 + + + +Apache 虚拟主机文档 +概述 +基于名称的虚拟主机 +基于 IP 的虚拟主机 +动态配置的大规模虚拟主机 +虚拟主机样例 +虚拟主机匹配的深入讨论 +文件句柄限制 +Apache 的 DNS 相关问题 + + + +URL 改写指南 +概述 +mod_rewrite 参考文档 +简介 +标志 +技术细节 +重新映射 URL +访问控制 +高级技术 + + + +Apache SSL/TLS 加密 +概述 +SSL/TLS 加密: 简介 +SSL/TLS 加密: 兼容性 +SSL/TLS 加密: 常见操作 +SSL/TLS 加密: 常见问题 + + + +指南与教程 +概述 +认证，授权与访问控制 +CGI 与动态内容 +服务器端插入 +.htaccess 文件 +用户私人网站目录(public_html) + + + +平台相关说明 +概述 +在 Microsoft Windows 中使用 Apache +为 Microsoft Windows 编译 Apache +在 Novell NetWare 中使用 Apache +在 HPUX 中运行高性能 web 服务器 +Apache 与 EBCDIC 系统 + + + +Apache HTTP 服务器与支持程序 +概述 +手册: httpd +手册: ab +手册: apachectl +手册: apxs +手册: configure +手册: dbmmanage +手册: htcacheclean +手册: htdbm +手册: htdigest +手册: htpasswd +手册: logresolve +手册: rotatelogs +手册: suexec +其它程序 + + + +Apache 杂项文档 +概述 +相关标准 + + + +Apache 模块 +描述模块的术语 +描述指令的术语 + + + +开发者文档 +概述 +Apache API 说明 +在 APR 中调试内存分配 +Apache 2.x 文档 +Apache 2.x 钩子函数 +将模块从 Apache 1.3 移植到 Apache 2.x +Apache 2.x 中的请求处理 +Apache 2.x 中的过滤器 + + + +术语与索引 +术语 +模块索引 +指令索引 +指令快速参考 + + + 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 @@ + + + + + + + + + + + Apache SSL/TLS 加密 + + +

Apache HTTP 服务器模块 mod_ssl +提供了与 OpenSSL +的接口，它使用安全套接字层和传输层安全协议提供了强加密。 +此模块与这篇文档都基于 +Ralf S. Engelschall 的 mod_ssl 项目。

+ + +
文档 + +
+ +
mod_ssl +

此模块提供的指令和环境变量的文档位于 mod_ssl 参考手册。 +

+
+ + + + 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 @@ - - - + + + @@ -261,6 +261,32 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -279,6 +305,7 @@ + @@ -286,4 +313,4 @@ - \ No newline at end of file + 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 @@ + + + + + + + + Simplified Chinese + UTF-8 + .xml + .html.zh-cn + + + 936 Simplified Chinese + SimSun,12,0 + GBK + Simplified Chinese + + + + UTF-8 + + + + + + + Simplified Chinese + + + 核心特性与多处理模块(MPM) + 其它模块 + 过时的模块 + + + 过时的 Apache 模块 + Apache 模块 + Apache 核心特性 + Apache MPM 通用指令 + Apache MPM + + + 描述 + 参见 + 主题 + 状态 + 模块标识 + 源文件 + 兼容性 + + + 相关模块 + 相关指令 + abcdefghijklmnopqrstuvwxyz + ABCDEFGHIJKLMNOPQRSTUVWXYZ + 名称 + + + + 语法 + 默认 + 上下文 + 覆盖 + 状态 + 模块 + + + 基础 + MPM + 核心 + 扩展 + 实验 + + + 服务器配置 + 虚拟主机 + 目录 + .htaccess + + + 指令 + + 指令 + 此模块没有提供指令。 + + + 摘要 + + + 参见术语 + + + - Apache HTTP 服务器 + Apache HTTP 服务器版本 + &httpd.major;.&httpd.minor; + [APACHE 文档] + Google 搜索 + 索引 + 主页 + + + Apache + HTTP 服务器 + 文档 + 版本 &httpd.major;.&httpd.minor; + + + 模块 + 常见问题 + 术语 + 网站导航 + + + 基于 + 许可证 + 可用语言 + + + 此翻译可能过期。要了解最近的更改，请阅读英文版。 + + 此指令的文档还没有被翻译。请阅读英文版。 + + 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 @@ + + + + + + + + + + +zh-cn + + + +UTF-8 + + + + + + + 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 @@ ../../../mod/allmodules.xml.pt-br ../../../mod/allmodules.xml.ru ../../../mod/allmodules.xml.tr - \ No newline at end of file +../../../mod/allmodules.xml.zh-cn + 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 @@ .html.pt-br .html.ru.koi8-r .html.tr.utf8 +.html.zh-cn 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 @@ + + + + + + + + + + + Apache 虚拟主机文档 + + + +

术语虚拟主机指的是在单一机器上运行多个网站 + (例如 company1.example.com 和 + company2.example.com) 。 + 虚拟主机可以“基于 IP”，即每个 IP 一个站点； + 或者“基于名称”， + 即每个 IP 多个站点。这些站点运行在同一物理服务器上的事实不会明显的透漏给最终用户。

+ +

Apache 是第一个支持基于 IP 的虚拟主机的服务器。 + Apache 版本 1.1 和更新的版本同时支持基于 IP 和基于名称的虚拟主机。 + 基于名称的虚拟主机有时候称为基于主机或非 IP 的虚拟主机.

+ +

以下解释是在 Apache 中支持虚拟主机的所有详细信息的文档页面列表。

+ + + +mod_vhost_alias +基于名称的虚拟主机 +基于 IP 的虚拟主机 +虚拟主机样例 +文件句柄限制 +动态配置的大规模虚拟主机 +虚拟主机匹配的深入讨论 + +
虚拟主机支持 + + + +
+ +
配置指令 + +
    +
  • VirtualHost
    • +
  • ServerName
    • +
  • ServerAlias
    • +
  • ServerPath
    • +
+ +

如果你要调试虚拟主机配置，你会发现 Apache 的命令行参数 -S + 非常有用。即输入以下命令:

+ + + /usr/local/apache2/bin/httpd -S + + +

这个命令将会显示 Apache 是如何解析配置文件的。仔细检查 IP + 地址与服务器名称可能会帮助你发现配置错误 + (参见 httpd 程序文档，以便了解其它命令行选项)。

+ +
+ -- 2.50.1