[svnbook] r5333 committed - branches/1.8/zh/book/ch00-preface.xml

wuzhouhui at users.sourceforge.net wuzhouhui at users.sourceforge.net
Thu Jun 22 10:01:51 CDT 2017


Revision: 5333
          http://sourceforge.net/p/svnbook/source/5333
Author:   wuzhouhui
Date:     2017-06-22 15:01:51 +0000 (Thu, 22 Jun 2017)
Log Message:
-----------
Branch 1.8/zh: translation of chapter 0 in progress

Modified Paths:
--------------
    branches/1.8/zh/book/ch00-preface.xml

Modified: branches/1.8/zh/book/ch00-preface.xml
===================================================================
--- branches/1.8/zh/book/ch00-preface.xml	2017-06-14 14:15:58 UTC (rev 5332)
+++ branches/1.8/zh/book/ch00-preface.xml	2017-06-22 15:01:51 UTC (rev 5333)
@@ -1254,10 +1254,16 @@
   <!-- ================================================================= -->
   <!-- ================================================================= -->
   <sect1 id="svn.preface.organization">
+    <!--
     <title>Organization of This Book</title>
+    -->
+    <title>本书组织</title>
 
+    <!--
     <para>The chapters that follow and their contents are listed
       here:</para>
+    -->
+    <para>每一章要介绍的内容如下:</para>
 
     <variablelist>
 
@@ -1264,9 +1270,13 @@
       <varlistentry>
         <term><xref linkend="svn.basic"/></term>
         <listitem>
+    <!--
           <para>Explains the basics of version control and different
             versioning models, along with Subversion's repository,
             working copies, and revisions.</para>
+    -->
+          <para>介绍版本控制基础和不同的版本控制模型, 以及 Subversion 的仓库,
+            工作副本和版本号.</para>
         </listitem>
       </varlistentry>
 
@@ -1273,9 +1283,13 @@
       <varlistentry>
         <term><xref linkend="svn.tour"/></term>
         <listitem>
+    <!--
           <para>Walks you through a day in the life of a Subversion
             user.  It demonstrates how to use a Subversion client to
             obtain, modify, and commit data.</para>
+    -->
+          <para>介绍 Subversion 用户在一天的工作中将会如何使用 Subversion
+            客户端工具来获取, 修改和提交数据.</para>
         </listitem>
       </varlistentry>
 
@@ -1282,9 +1296,13 @@
       <varlistentry>
         <term><xref linkend="svn.advanced"/></term>
         <listitem>
+    <!--
           <para>Covers more complex features that regular users will
             eventually come into contact with, such as versioned
             metadata, file locking, and peg revisions.</para>
+    -->
+          <para>介绍普通用户最终将会用到的更复杂的功能, 例如版本控制的元数据,
+            文件锁和挂勾版本号 (peg revisions).</para>
         </listitem>
       </varlistentry>
 
@@ -1291,10 +1309,15 @@
       <varlistentry>
         <term><xref linkend="svn.branchmerge"/></term>
         <listitem>
+    <!--
           <para>Discusses branches, merges, and tagging, including
             best practices for branching and merging, common
             use cases, how to undo changes, and how to easily swing
             from one branch to the next.</para>
+    -->
+          <para>介绍分支, 合并和标签, 包括分支与合并的最佳使用方法,
+            常见用法, 如何撤消修改, 如何方便地从一个分支切换到另一个分支.
+          </para>
         </listitem>
       </varlistentry>
 
@@ -1301,9 +1324,13 @@
       <varlistentry>
         <term><xref linkend="svn.reposadmin"/></term>
         <listitem>
+    <!--
           <para>Describes the basics of the Subversion repository,
             how to create, configure, and maintain a repository, and
             the tools you can use to do all of this.</para>
+    -->
+          <para>介绍 Subversion 仓库基础, 包括如何创建, 配置和维护一个仓库,
+            以及其中要用到的工具.</para>
         </listitem>
       </varlistentry>
 
@@ -1310,6 +1337,7 @@
       <varlistentry>
         <term><xref linkend="svn.serverconfig"/></term>
         <listitem>
+    <!--
           <para>Explains how to configure your Subversion server and
             offers different ways to access your repository:
             <literal>HTTP</literal>, the <literal>svn</literal>
@@ -1316,6 +1344,10 @@
             protocol, and local disk access.  It also covers the details
             of authentication, authorization and anonymous
             access.</para>
+    -->
+          <para>介绍如何配置 Subversion 服务器, 以及访问仓库的不同的方法:
+            <literal>HTTP</literal>, <literal>svn</literal> 和本地磁盘访问.
+            还介绍了关于认证, 授权和匿名访问的细节.</para>
         </listitem>
       </varlistentry>
 
@@ -1322,9 +1354,13 @@
       <varlistentry>
         <term><xref linkend="svn.customization"/></term>
         <listitem>
+    <!--
           <para>Explores the Subversion client configuration files,
             the handling of internationalized text, and how to make
             external tools cooperate with Subversion.</para>
+    -->
+          <para>介绍 Subversion 客户端配置文件, 如何处理国际化文本, 以及如何
+            在 Subversion 中使用外部工具.</para>
         </listitem>
       </varlistentry>
 
@@ -1331,11 +1367,16 @@
       <varlistentry>
         <term><xref linkend="svn.developer"/></term>
         <listitem>
+    <!--
           <para>Describes the internals of Subversion, the
             Subversion filesystem, and the working copy
             administrative areas from a programmer's point of view.
             It also demonstrates how to use the public APIs to write a
             program that uses Subversion.</para>
+    -->
+          <para>从程序员的视角介绍 Subversion 的内部构造, Subversion 文件系统,
+            工作副本的管理区. 还介绍了如何使用公共 API 对 Subversion 进行二次
+            开发.</para>
         </listitem>
       </varlistentry>
 
@@ -1342,10 +1383,15 @@
       <varlistentry>
         <term><xref linkend="svn.ref"/></term>
         <listitem>
+    <!--
           <para>Explains in great detail every subcommand of
             <command>svn</command>, <command>svnadmin</command>, and
             <command>svnlook</command> with plenty of examples for
             the whole family!</para>
+    -->
+          <para>详细地介绍 <command>svn</command>, <command>svnadmin</command>,
+            <command>svnlook</command> 的每个子命令, 并带有丰富的使用示例.
+          </para>
         </listitem>
       </varlistentry>
 
@@ -1352,9 +1398,14 @@
       <varlistentry>
         <term><xref linkend="svn.intro"/></term>
         <listitem>
+    <!--
           <para>For the impatient, a whirlwind explanation of how to
             install Subversion and start using it immediately.  You
+            TODO
             have been warned.</para>
+    -->
+          <para>专门为没有耐心的读者而写, 介绍了如何快速地安装 Subversion 并
+            开始使用它.</para>
         </listitem>
       </varlistentry>
 
@@ -1361,6 +1412,7 @@
       <varlistentry>
         <term><xref linkend="svn.forcvs"/></term>
         <listitem>
+    <!--
           <para>Covers the similarities and differences between
             Subversion and CVS, with numerous suggestions on how to
             break all the bad habits you picked up from years of
@@ -1369,6 +1421,12 @@
             operations, <command>update</command>
             versus <command>status</command>, branches, tags, metadata,
             conflict resolution, and authentication.</para>
+    -->
+          <para>介绍了 Subversion 与 CVS 的异同点, 对于如何纠正长期使用 CVS
+            所养成的坏习惯也提出了大量的建议. 包含的内容有 Subversion 的版本号,
+            版本控制目录, 离线操作, <command>update</command> 与
+            <command>status</command>, 分支, 标签, 元数据, 冲突解决和授权.
+          </para>
         </listitem>
       </varlistentry>
 
@@ -1375,9 +1433,13 @@
       <varlistentry>
         <term><xref linkend="svn.webdav"/></term>
         <listitem>
+    <!--
           <para>Describes the details of WebDAV and DeltaV and how
             you can configure your Subversion repository to be
             mounted read/write as a DAV share.</para>
+    -->
+          <para>介绍了 WebDAV 和 DeltaV 的细节, 以及如何通过配置 Subversion,
+            使得仓库可以被挂载成可读写的 DAV 共享目录.</para>
         </listitem>
       </varlistentry>
 
@@ -1384,8 +1446,11 @@
       <varlistentry>
         <term><xref linkend="svn.copyright"/></term>
         <listitem>
+    <!--
           <para>A copy of the Creative Commons Attribution License,
             under which this book is licensed.</para>
+    -->
+          <para>本书所使用的创作共享署名授权协议的一份副本.</para>
         </listitem>
       </varlistentry>
 
@@ -1398,7 +1463,10 @@
   <!-- ================================================================= -->
   <!-- ================================================================= -->
   <sect1 id="svn.preface.free">
+    <!--
     <title>This Book Is Free</title>
+    -->
+    <title>本书是免费的</title>
 
     <para>This book started out as bits of documentation written by
       Subversion project developers, which were then coalesced into a
@@ -1406,14 +1474,22 @@
       free license (see <xref linkend="svn.copyright"/>).  In fact,
       the book was written in the public eye, originally as part of
       the Subversion project itself.  This means two things:</para>
+    <para>本书起源于 Subversion 开发人员编写的文档, 这些文档后来被合并到一个
+      单独的项目中, 并加以重写, 也正因为如此, 本书使用的授权是免费的
+      (见 <xref linkend="svn.copyright"/>). 实际上, 本书的编写过程一直是公开
+      进行的, 最初是 Subversion 项目的一部分, 这就意味着以下两点:</para>
 
     <itemizedlist>
       <listitem>
+    <!--
         <para>You will always find the latest version of this book in
           the book's own Subversion repository.</para>
+    -->
+        <para>你总能在本书的 Subversion 仓库中找到本书的最新版本.</para>
       </listitem>
 
       <listitem>
+    <!--
         <para>You can make changes to this book and redistribute it
           however you wish—it's under a free license.  Your only
           obligation is to maintain proper attribution to the original
@@ -1420,6 +1496,10 @@
           authors.  Of course, we'd much rather you send feedback and
           patches to the Subversion developer community, instead of 
           distributing your private version of this book.</para>
+    -->
+        <para>你可以按照自己的要求修改本书并重新发布—它使用的授权是免费
+          的, 唯一的约束是你必须保留原始作者的贡献. 当然, 我们更希望你把反馈
+          和补丁发送给 Subversion 开发社区, 而不是发布自己的私有版本.</para>
       </listitem>
     </itemizedlist>
     




More information about the svnbook-dev mailing list