[svnbook] r5571 committed - branches/1.8/zh/book/ch05-repository-admin.xml

wuzhouhui at users.sourceforge.net wuzhouhui at users.sourceforge.net
Tue Jan 9 06:27:14 CST 2018


Revision: 5571
          http://sourceforge.net/p/svnbook/source/5571
Author:   wuzhouhui
Date:     2018-01-09 12:27:14 +0000 (Tue, 09 Jan 2018)
Log Message:
-----------
1.8/zh: translation of chapter 5 in progress

Modified Paths:
--------------
    branches/1.8/zh/book/ch05-repository-admin.xml

Modified: branches/1.8/zh/book/ch05-repository-admin.xml
===================================================================
--- branches/1.8/zh/book/ch05-repository-admin.xml	2018-01-09 11:05:40 UTC (rev 5570)
+++ branches/1.8/zh/book/ch05-repository-admin.xml	2018-01-09 12:27:14 UTC (rev 5571)
@@ -1476,6 +1476,7 @@
           的公共 API 进行软件开发, 见 <xref linkend="svn.developer" />.</para>
 
         <warning>
+      <!--
           <para>Hook scripts can do almost anything, but hook script
             authors should show restraint.  It might be tempting to,
             say, use hook scripts to automatically correct errors,
@@ -1494,6 +1495,17 @@
             commit if it does not meet the desired requirements.  As a
             bonus, your users will learn the value of careful,
             compliance-minded work habits.</para>
+      -->
+          <para>钩子脚本几乎可以做任何事情, 但作者应该对脚本的功能有所控制.
+            虽然说使用钩子脚本去自动纠正被提交的文件中的错误, 缺陷或违反策略
+            的做法—是一件很有诱惑力的事情, 但这样做会导致问题.
+            Subversion 在客户端缓存了仓库的部分数据, 如果钩子脚本按照这种方式
+            修改了提交事务, 那么客户端缓存的数据就成了过时了的, 且难以察觉,
+            过时的缓存会产生不可预料的后果. 虽然通过钩子脚本添加新的提交事务属
+            性通常没什么问题, 但除此之外, 一个提交事务的其它信息都应该看成是只
+            读的. 管理员不应该为了优化事务的载荷而对事务进行修改, 更好的做法是
+            在钩子 pre-commit 里 <emphasis>验证</emphasis> 事务, 拒绝不满足要
+            求的事务. 作为回报, 仓库的用户将逐渐养成良好的提交习惯.</para>
         </warning>
 
       </sect3>
@@ -1501,8 +1513,12 @@
 
     <!-- =============================================================== -->
     <sect2 id="svn.reposadmin.create.fsfs">
+      <!--
       <title>FSFS Configuration</title>
+      -->
+      <title>FSFS 配置</title>
 
+      <!--
       <para>As of Subversion 1.6, FSFS filesystems have several
         configurable parameters which an administrator can use to
         fine-tune the performance or disk usage of their repositories.
@@ -1509,6 +1525,10 @@
         You can find these options—and the documentation for
         them—in the <filename>db/fsfs.conf</filename> file in
         the repository.</para>
+      -->
+      <para>从 Subversion 1.6 开始, FSFS 提供了几个配置参数, 管理员可利用它
+        们对仓库的性能和磁盘使用进行调整. 管理员可以在仓库目录的
+        <filename>db/fsfs.conf</filename> 里找到所有的配置参数及其说明.</para>
 
       <!-- TODO: Document the fsfs.conf options herein. -->
 
@@ -1520,7 +1540,10 @@
   <!-- ================================================================= -->
   <!-- ================================================================= -->
   <sect1 id="svn.reposadmin.maint">
+      <!--
     <title>Repository Maintenance</title>
+      -->
+    <title>仓库维护</title>
 
     <para>Maintaining a Subversion repository can be daunting, mostly
       due to the complexities inherent in systems that have a database




More information about the svnbook-dev mailing list