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

[wuzhouhui at users.sourceforge.net]

Revision: 5760
          http://sourceforge.net/p/svnbook/source/5760
Author:   wuzhouhui
Date:     2018-09-01 03:14:28 +0000 (Sat, 01 Sep 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-08-26 02:27:32 UTC (rev 5759)
+++ branches/1.8/zh/book/ch06-server-configuration.xml	2018-09-01 03:14:28 UTC (rev 5760)
@@ -4944,6 +4944,7 @@
           先是一些握手操作, 然后是一个带有大量数据的 <literal>REPORT</literal>
           请求, 这些数据就是整个的检出/更新数据集!</para>
 
+      <!--
         <para>Subversion clients which use the Serf HTTP
           library—which includes all clients built atop the
           Subversion 1.8—still send the <literal>REPORT</literal>
@@ -4956,7 +4957,17 @@
           that <literal>REPORT</literal> is followed by many smaller
           requests (<literal>GET</literal>s and, in older versions of
           Subversion, <literal>PROPFIND</literal>s).</para>
+      -->
+        <para>使用 Serf 函数库的 Subversion 客户端—版本大于或等于
+          Subversion 1.8—仍然会发送 <literal>REPORT</literal> 请求,
+          但在请求内会设置一些稍微不同的标志, 这些标志告诉服务器不用发送全
+          部的数据, 而是发送一个清单, 客户端随后根据清单向服务器请求更明确
+          的数据, 从而完成整个操作. 在服务器的 <filename>access_log</filename>
+          日志里, 这种 <literal>REPORT</literal> 请求后面会出现很多小块的
+          <literal>GETS</literal> 请求 (如果是旧版 Subversion, 则是
+          <literal>PROPFIND</literal> 请求).</para>
 
+      <!--
         <para>There are pros and cons to each approach.  As we've
           mentioned, the so-called bulk updates generate considerably
           less information in the server logs, but a given Apache HTTP
@@ -4979,6 +4990,20 @@
           is set to <literal>Prefer</literal>, supporting clients (1.8
           or newer) will try to use the bulk update approach unless
           otherwise configured.</para>
+      -->
+        <para>上面的做法有好有坏. 批量更新的做法虽然在服务器产生的日志更少,
+          但在操作运行的过程中, 被占用的 Apache HTTP 服务器子进程将无暇顾及
+          其他工作, 而当前操作可能还需要很长时间才能完成. 非批量更新提供了
+          设置内容缓存的机会 (缓存可用于提高性能), 但生成的服务器日志比批量
+          更新多得多. 无论是由于哪种原因, 管理员可能想对客户端施加更多的限制.
+          Subversion 1.6 为 <command>mod_dav_svn</command> 添加了一个新的二
+          元配置指令 <literal>SVNAllowBulkUpdates</literal>, 用于配置服务器
+          是否允许批量更新. 在 Subversion 1.8,
+          <literal>SVNAllowBulkUpdates</literal> 的值除了 <literal>On</literal>
+          和 <literal>Off</literal> 外, 还新增了 <literal>Prefer</literal>,
+          如果 <literal>SVNAllowBulkUpdates</literal> 被设置为
+          <literal>Prefer</literal>, 受支持的客户端 (1.8 或更新的版本) 将尝试
+          使批量更新, 除非另有指定.</para>
 
       </sect3>
     </sect2>
@@ -4985,17 +5010,28 @@
 
     <!-- =============================================================== -->
     <sect2 id="svn.serverconfig.httpd.extra">
+      <!--
       <title>Extra Goodies</title>
+      -->
+      <title>其他好处</title>
 
+      <!--
       <para>We've covered most of the authentication and authorization
         options for Apache and <command>mod_dav_svn</command>.  But
         there are a few other nice features that Apache
         provides.</para>
+      -->
+      <para>关于 Apache 和 <command>mod_dav_svn</command> 的认证与授权, 我
+        们已经介绍了大部分, 不过 Apache 还提供了一些非常有效的特性.</para>
 
       <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
       <sect3 id="svn.serverconfig.httpd.extra.browsing">
+      <!--
         <title>Repository browsing</title>
+      -->
+        <title>仓库浏览</title>
 
+      <!--
         <para>One of the most useful benefits of an Apache/WebDAV
           configuration for your Subversion repository is that your
           versioned files and directories are immediately available
@@ -5007,9 +5043,19 @@
           whether that URL represents a versioned directory or
           file, <command>mod_dav_svn</command> will respond with a
           directory listing or with file contents.</para>
+      -->
+        <para>Apache/WebDAV 最实用的功能之一是允许用户直接在网页浏览器上浏览
+          仓库内的文件与目录. 因为 Subversion 使用 URL 标识仓库内的文件,
+          基于 HTTP 的 URL 可以直接输入到网页浏览器的地址栏上, 然后浏览器
+          向服务器发送 HTTP <literal>GET</literal> 请求, 根据 URL 所指向的
+          资源是文件还是目录, <command>mod_dav_svn</command> 将返回目录内的
+          文件列表, 或文件的内容.</para>
 
         <sect4 id="svn.serverconfig.httpd.extra.browsing.syntax">
+      <!--
           <title>URL syntax</title>
+      -->
+          <title>URL 语法</title>
 
           <para>If the URLs do not contain any information about which
             version of the resource you wish to