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

[wuzhouhui at users.sourceforge.net]

Revision: 5558
          http://sourceforge.net/p/svnbook/source/5558
Author:   wuzhouhui
Date:     2017-12-28 12:25:19 +0000 (Thu, 28 Dec 2017)
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	2017-12-27 12:03:50 UTC (rev 5557)
+++ branches/1.8/zh/book/ch05-repository-admin.xml	2017-12-28 12:25:19 UTC (rev 5558)
@@ -772,12 +772,19 @@
 
     <!-- =============================================================== -->
     <sect2 id="svn.reposadmin.basics.creating">
+      <!--
       <title>Creating the Repository</title>
+      -->
+      <title>创建仓库</title>
 
+      <!--
       <para>Subversion repository creation is an incredibly simple
         task.  The <command>svnadmin</command> utility that comes with
         Subversion provides a subcommand (<command>svnadmin
         create</command>) for doing just that.</para>
+      -->
+    <para>创建 Subversion 仓库是一件非常简单的工作, 用到的命令是
+      <command>svnadmin create</command>.</para>
 
       <informalexample>
         <screen>
@@ -787,6 +794,7 @@
 </screen>
       </informalexample>
 
+      <!--
       <para>Assuming that the parent directory 
         <filename>/var/svn</filename> exists and that you have
         sufficient permissions to modify that directory, the previous
@@ -793,9 +801,15 @@
         command creates a new repository in the directory
         <filename>/var/svn/repos</filename>, and with the default
         filesystem data store (FSFS).  You can explicitly choose the
-        filesystem type using the <option>--fs-type</option> argument,
+        filesystem type using the <option>- -fs-type</option> argument,
         which accepts as a parameter either <literal>fsfs</literal> or
         <literal>bdb</literal>.</para>
+      -->
+      <para>假设父目录 <filename>/var/svn</filename> 已存在, 并且管理员对父
+        目录拥有写权限, 上面的命令在 <filename>/var/svn/repos</filename>
+        创建了一个新的仓库, 使用的是默认的后端存储类型 (FSFS). 你还可以利用
+        选项 <option>--fs-type</option> 显式地指定后端存储类型, 该选项接受
+        的参数是 <literal>fsfs</literal> 或 <literal>bdb</literal>.</para>
 
       <informalexample>
         <screen>
@@ -813,6 +827,7 @@
 </screen>
       </informalexample>
 
+      <!--
       <para>After running this simple command, you have a Subversion
         repository.  Depending on how users will access this new
         repository, you might need to fiddle with its filesystem
@@ -819,8 +834,14 @@
         permissions.  But since basic system administration is rather
         outside the scope of this text, we'll leave further
         exploration of that topic as an exercise to the reader.</para>
+      -->
+      <para>执行完这个简单的命令, 你就拥有了一个新的 Subversion 仓库. 取决于
+        用户的访问方式, 管理员可能还需要调整仓库目录的文件系统权限. 与系统
+        管理有关的基础知识不在本书的讨论范围之内, 所以这方面的内容就当作训练
+        留给读者.</para>
 
       <tip>
+      <!--
         <para>The path argument to <command>svnadmin</command> is just
           a regular filesystem path and not a URL like the
           <command>svn</command> client program uses when referring to
@@ -832,8 +853,17 @@
           network.  A common mistake made by Subversion newcomers is
           trying to pass URLs (even <quote>local</quote>
           <literal>file://</literal> ones) to these two programs.</para>
+      -->
+        <para>传递给 <command>svnadmin</command> 的路径参数只是一个普通的文件
+          系统路径, 而不是一个 URL (就像 <command>svn</command> 访问仓库时用
+          到的 URL 参数). <command>svnadmin</command> 和
+          <command>svnlook</command> 都是服务器端的工具—它们只在存放着
+          仓库的主机上使用, 用于查看或修改仓库的某些部分, 实际上它们也无法
+          跨网络执行任务. Subversion 新手的一个常见错误是试图为这两个工具传
+          递 URL (即使是 <literal>file://</literal> 也不行).</para>
       </tip>
 
+      <!--
       <para>Present in the <filename>db/</filename> subdirectory of
         your repository is the implementation of the versioned
         filesystem.  Your new repository's versioned filesystem begins
@@ -842,9 +872,17 @@
         Initially, revision 0 also has a single revision property,
         <literal>svn:date</literal>, set to the time at which the
         repository was created.</para>
+      -->
+      <para>存放在仓库子目录 <filename>db/</filename> 内的就是版本化文件系统的
+        实现. 新仓库的版本化文件系统的生命开始于版本号 0, 根据定义版本号 0 不
+        包含任何数据, 只有最顶层的根目录. 初始时, 版本号 0 也有一个版本号属性,
+        <literal>svn:date</literal>, 属性的值是创建仓库的日期.</para>
 
+      <!--
       <para>Now that you have a repository, it's time to customize
         it.</para>
+      -->
+      <para>仓库既然创建好了, 接下来就可以对它进行改造.</para>
 
       <warning>
         <para>While some parts of a Subversion repository—such