[svnbook] r5723 committed - branches/1.8/zh/book/ ch06-server-configuration.xml

[wuzhouhui at users.sourceforge.net]

Revision: 5723
          http://sourceforge.net/p/svnbook/source/5723
Author:   wuzhouhui
Date:     2018-07-01 03:03:25 +0000 (Sun, 01 Jul 2018)
Log Message:
-----------
1.8/zh: translation of chapter 6 in progress

Modified Paths:
--------------
    branches/1.8/zh/book/ch06-server-configuration.xml

Modified: branches/1.8/zh/book/ch06-server-configuration.xml
===================================================================
--- branches/1.8/zh/book/ch06-server-configuration.xml	2018-06-23 12:34:32 UTC (rev 5722)
+++ branches/1.8/zh/book/ch06-server-configuration.xml	2018-07-01 03:03:25 UTC (rev 5723)
@@ -3117,8 +3117,12 @@
   <!-- ================================================================= -->
   <sect1 id="svn.serverconfig.httpd">
 
+      <!--
     <title>httpd, the Apache HTTP Server</title>
+      -->
+    <title>httpd, Apache HTTP 服务器</title>
 
+      <!--
     <para>The Apache HTTP Server is a <quote>heavy-duty</quote>
       network server that Subversion can leverage.  Via a custom
       module, <command>httpd</command> makes Subversion repositories
@@ -3136,7 +3140,21 @@
       server has more features than <command>svnserve</command>, it's
       also a bit more difficult to set up.  With flexibility often
       comes more complexity.</para>
+      -->
+    <para>Apache HTTP 服务器是 Subversion 可使用的 <quote>重型</quote> 网络
+      服务器. 借助一个定制的模块, <command>httpd</command> 允许客户端通过
+      WebDAV/Delta 协议 <footnote><para>见 <ulink
+            url="http://www.webdav.org/"/>.</para></footnote> 访问 Subversion
+      仓库, WebDAV/Delta 协议是 HTTP 1.1 的扩展. WebDAV/Delta 在万维网核心
+      协议 HTTP 的基础上, 增加了写功能—确切地说, 是版本化的写. 这样做的
+      结果是得到了一个标准化的, 健壮的软件系统, 可以方便地作为 Apache 2.0
+      软件的一部分进行打包, 受到多种操作系统和第三方软件的支持, 也不要求网络
+      管理员开通额外的端口.<footnote><para>他们真得很讨厌这样做.</para>
+      </footnote> 因为 Apache-Subversion 服务器比 <command>svnserve</command>
+      拥有更多的特性, 因此设置起来会更加困难—灵活性往往伴随着复杂性.
+    </para>
 
+      <!--
     <para>Much of the following discussion includes references to
       Apache configuration directives.  While some examples are given
       of the use of these directives, describing them in full is
@@ -3146,7 +3164,15 @@
       reference for the configuration directives is located at
       <ulink url="http://httpd.apache.org/docs/current/mod/directives.html"
       />.</para>
+      -->
+  <para>下面将要介绍的很多内容都包含了关于 Apache 配置命令的引用, 虽然某些
+    例子用到了 Apache 的配置命令, 但完整地介绍它们已经超出了本章的范畴.
+    Apache 团队维护了非常优秀的文档供用户参考, 可以到它的官网 <ulink
+      url="http://httpd.apache.org"/> 获取, 例如, 关于 Apache 配置命令的
+    文档在 <ulink
+      url="http://httpd.apache.org/docs/current/mod/directives.html"/>.</para>
 
+      <!--
     <para>Also, as you make changes to your Apache setup, it is likely
       that somewhere along the way a mistake will be made.  If you are
       not already familiar with Apache's logging subsystem, you should
@@ -3159,6 +3185,14 @@
       logging interface as well.  You can always browse the contents
       of those files for information that might reveal the source of a
       problem that is not clearly noticeable otherwise.</para>
+      -->
+    <para>另外, 在管理员修改 Apache 设置的过程中, 有可能会有错误发生, 如果你
+      还不太熟悉 Apache 的日志子系统, 现在应该着手熟悉它. 文件
+      <filename>httpd.conf</filename> 可以指定 Apache 所生成的访问与错误
+      日志的存放位置 (配置命令分别是 <literal>CustomLog</literal> 和
+      <literal>ErrorLog</literal>). Subversion 的
+      <command>mod_dav_svn</command> 也用到了 Apache 的错误日志接口. 管理员
+      可以通过查看这些日志文件定位问题发生的原因.</para>
 
     <!-- =============================================================== -->
     <sect2 id="svn.serverconfig.httpd.prereqs">