[svnbook] r5927 committed - branches/1.8/zh/book/ref-svnadmin.xml

[wuzhouhui at users.sourceforge.net]

Revision: 5927
          http://sourceforge.net/p/svnbook/source/5927
Author:   wuzhouhui
Date:     2019-06-04 14:02:43 +0000 (Tue, 04 Jun 2019)
Log Message:
-----------
1.8/zh: translation of svnadmin reference in progress

Modified Paths:
--------------
    branches/1.8/zh/book/ref-svnadmin.xml

Modified: branches/1.8/zh/book/ref-svnadmin.xml
===================================================================
--- branches/1.8/zh/book/ref-svnadmin.xml	2019-06-02 13:24:46 UTC (rev 5926)
+++ branches/1.8/zh/book/ref-svnadmin.xml	2019-06-04 14:02:43 UTC (rev 5927)
@@ -512,6 +512,7 @@
           Subversion 1.2 开始, <command>svnadmin</command> 默认使用 FSFS
           作为新仓库的后端存储.</para>
 
+      <!--
         <para>While <command>svnadmin create</command> will create
           the base directory for a new repository, it will not
           create intermediate directories.  For example, if you
@@ -525,12 +526,24 @@
           repository, you might need to run <command>svnadmin
           create</command> as a user with elevated privileges
           (such as the <literal>root</literal> user).</para>
+      -->
+        <para>虽然 <command>svnadmin create</command> 会创建新仓库所在的目录,
+          但它并不会创建中间目录. 例如, 假设你有一个空目录
+          <filename>/var/svn</filename>, 那么创建仓库
+          <filename>/var/svn/repos</filename> 不会有任何问题, 但是试图创建
+          <filename>/var/svn/subdirectory/repos</filename> 则会报错. 另外,
+          取决于仓库的位置, 你可能需要切换到具有特权的用户 (例如超级用户
+          <literal>root</literal>) 才能执行 <command>svnadmin create</command>.
+        </para>
 
       </refsect1>
 
     <!-- =============================================================== -->
     <refsect1>
+      <!--
       <title>Options</title>
+      -->
+      <title>选项</title>
 
       <informalexample>
         <screen>
@@ -548,9 +561,16 @@
 
     <!-- =============================================================== -->
     <refsect1>
+      <!--
       <title>Examples</title>
+      -->
+      <title>示例</title>
 
+      <!--
       <para>Creating a new repository is this easy:</para>
+      -->
+      <para>在 <filename>/var/svn</filename> 目录下创建一个名为
+        <filename>repos</filename> 的新仓库:</para>
 
       <informalexample>
         <screen>
@@ -560,11 +580,16 @@
 </screen>
       </informalexample>
       
+      <!--
       <para>In Subversion 1.0, a Berkeley DB repository is always
         created.  In Subversion 1.1, a Berkeley DB repository is
         the default repository type, but an FSFS repository can be
-        created using the <option>--fs-type</option>
+        created using the <option>- -fs-type</option>
         option:</para>
+      -->
+      <para>Subversion 1.0 总是使用 Berkeley DB 作为仓库的后端存储系统.
+        Subversion 1.1 把 Berkeley DB 作为默认的仓库后端存储, 但可以用选项
+        <option>--fs-type</option> 把后端存储系统改成 FSFS:</para>
 
       <informalexample>
         <screen>
@@ -590,7 +615,11 @@
 
     <refnamediv>
       <refname>svnadmin deltify</refname>
+      <!--
+                  ### TODO
       <refpurpose>Deltify changed paths in a revision range.</refpurpose>
+      -->
+      <refpurpose>在一个版本号范围内, 对修改过的路径执行 deltify.</refpurpose>
     </refnamediv>
 
     <refsynopsisdiv>
@@ -599,23 +628,38 @@
 
     <!-- =============================================================== -->
     <refsect1>
+      <!--
       <title>Description</title>
+      -->
+      <title>描述</title>
 
+      <!--
       <para><command>svnadmin deltify</command> exists in
         current versions of Subversion only for historical reasons.
         This command is deprecated and no longer needed.</para>
+      -->
+      <para><command>svnadmin deltify</command> 还留在 Subversion 里只是出
+        于历史原因, 该命令已经不再推荐使用, 也不会再有地方会用到它.</para>
 
+      <!--
       <para>It dates from a time when Subversion offered
         administrators greater control over compression strategies
         in the repository.  This turned out to be a lot of
         complexity for <emphasis>very</emphasis> little gain, and
         this <quote>feature</quote> was deprecated.</para>
+      -->
+      <para><command>svnadmin deltify</command> 的历史可以追溯到 Subversion
+        为管理员提供仓库压缩策略的时期, 命令的过程非常复杂, 但得到的效果却
+        很有限, 如今这个命令已不再推荐使用.</para>
 
         </refsect1>
 
     <!-- =============================================================== -->
     <refsect1>
+      <!--
       <title>Options</title>
+      -->
+      <title>选项</title>
 
       <informalexample>
         <screen>
@@ -640,7 +684,11 @@
 
     <refnamediv>
       <refname>svnadmin dump</refname>
+      <!--
       <refpurpose>Dump the contents of the filesystem to <filename>stdout</filename>.</refpurpose>
+      -->
+      <refpurpose>把文件系统的内容转储到标准输出 <filename>stdout</filename>.
+      </refpurpose>
     </refnamediv>
 
     <refsynopsisdiv>
@@ -649,7 +697,10 @@
 
     <!-- =============================================================== -->
     <refsect1>
+      <!--
       <title>Description</title>
+      -->
+      <title>描述</title>
 
       <para>Dump the contents of the filesystem to <filename>stdout</filename> in a
         <quote>dump file</quote> portable format, sending feedback