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

[wuzhouhui at users.sourceforge.net]

Revision: 5565
          http://sourceforge.net/p/svnbook/source/5565
Author:   wuzhouhui
Date:     2018-01-02 12:13:22 +0000 (Tue, 02 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-01 11:06:18 UTC (rev 5564)
+++ branches/1.8/zh/book/ch05-repository-admin.xml	2018-01-02 12:13:22 UTC (rev 5565)
@@ -1137,8 +1137,11 @@
         </para>
 
         <example id="svn.reposadmin.hooks.configuration.ex-1">
+      <!--
           <title>hooks-env (custom hook script environment
             configuration)</title>
+      -->
+          <title>hooks-env (配置钩子脚本环境)</title>
 
           <programlisting>
 # All scripts should use a UTF-8 locale and have our hook script
@@ -1161,6 +1164,7 @@
         </example>
 
         <note>
+      <!--
           <para><xref linkend="svn.reposadmin.hooks.configuration.ex-1"
             /> also demonstrates the nifty string substitution syntax
             found in Subversion's configuration file parser.  In this
@@ -1173,8 +1177,18 @@
             in the Subversion runtime configuration directory.  (And
             for more information about that directory, see
             <xref linkend="svn.advanced.confarea" />.)</para>
+      -->
+          <para><xref linkend="svn.reposadmin.hooks.configuration.ex-1" />
+            还展示了 Subversion 配置文件解析器的灵活的字符串替换语法. 在这个
+            例子时, 选项 <literal>PATH</literal> 的值—拉取至文件的
+            <literal>[default]</literal> 部分—会替换掉其他地方的占位
+            符文本 <literal>%(PATH)s</literal>. 关于这种语法的更多信息,
+            见 Subversion 运行时配置目录内的 <filename>README.txt</filename>
+            文件. (关于运行时配置目录的更多信息, 见
+            <xref linkend="svn.advanced.confarea" />.)</para>
         </note>
 
+      <!--
         <para>Of course, having exact duplicates of your custom hook
           script environment configuration files in every single
           repository's <filename>conf/</filename> directory could get
@@ -1182,6 +1196,11 @@
           all.  So Subversion's servers allow you to specify an
           alternate (possibly shared) location for this configuration
           information.</para>
+      -->
+        <para>当然, 在每一个仓库的 <filename>conf/</filename> 目录内都放置
+          一份完全一样的钩子环境配置文件, 做起来可能会有点笨拙, 特别是当它
+          们都需要修改时. 为此, Subversion 允许管理员为配置信息指定一个可
+          选的位置 (可能是共享的).</para>
 
         <!-- ### TODO:  Add cross reference for the above! -->
 
@@ -1189,11 +1208,18 @@
 
       <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
       <sect3 id="svn.reposadmin.hooks.uses">
+      <!--
         <title>Common uses for hook scripts</title>
+      -->
+        <title>钩子脚本的常见用法</title>
 
+      <!--
         <para>Repository hook scripts can offer a wide range of
           utility, but most tend to fall into a few basic categories:
           notification, validation, and replication.</para>
+      -->
+        <para>仓库的钩子脚本可以提供非常多的用处, 但大多数都可以简单地归类成
+          以下几种: 通知, 验证和重复.</para>
 
         <para>Notification scripts are those which tell someone that
           something happened.  The most common of these found in a