[svnbook commit] r2562 - trunk/src/zh/book
leasun
noreply at red-bean.com
Wed Dec 13 06:32:12 CST 2006
Author: leasun
Date: Wed Dec 13 06:32:11 2006
New Revision: 2562
Modified:
trunk/src/zh/book/ch01.xml
Log:
* zh/book/ch01.xml: remark, finished.
Modified: trunk/src/zh/book/ch01.xml
==============================================================================
--- trunk/src/zh/book/ch01.xml (original)
+++ trunk/src/zh/book/ch01.xml Wed Dec 13 06:32:11 2006
@@ -219,19 +219,15 @@
<title>快速入门</title>
- <para>
- 许多人为<quote>从头到尾</quote>的方式读一本介绍有趣新技术的书感到发愁，这一小节是一个很短的介绍，给许多<quote>实用</quote>的用户一个实战的机会，如果你是一个喜欢通过实验进行学习的用户，以下将告诉你怎么做，相对应，我们给出这本书相关的链接。</para>
+ <para>本书所采用的<quote>由上至下</quote>的方式讲述Subversion，某些读者可能不习惯以这样的方式学习一种新的技术。为此，本节对Subversion进行了一个简短的介绍，并为那些喜欢<quote>自下而上</quote>学习的读者提供一个实战的机会。下面的示例可以引导那些喜欢<quote>自下而上</quote>学习方式的读者走入Subversion的大门。同时，我们也会在相应的位置给出书中详细叙述部分的链接。</para>
- <para>
- 如果版本控制或者Subversion和CVS都用到的<quote>拷贝-修改-合并</quote>模型对于你来说是完全的新概念，在进一步阅读之前，你首先要读<xref linkend="svn.basic"/>。</para>
+ <para>如果读者还不熟悉版本控制，以及在Subversion和CVS中使用的<quote>拷贝-修改-合并</quote>模型这些基础的概念，那么建议在进一步学习之前，首先阅读<xref linkend="svn.basic"/>。</para>
<note>
- <para>
- 以下的例子假定你有了1.2或更新的Subversion程序（运行<command>svn --version</command>来检查版本）。</para>
+ <para>运行下面的例子需要首先正确安装Subversion客户端程序<command>svn</command>以及管理工具<command>svnadmin</command>，并且必须为1.2或更新版本的Subversion程序（可以运行<command>svn --version</command>来检查Subversion的版本）。</para>
</note>
- <para>
- Subversion存储所有版本控制的数据到一个中心版本库，作为开始，新建一个版本库：</para>
+ <para>Subversion的所有版本化数据都储存在中心版本库中。因此首先，我们需要创建一个版本库：</para>
<screen>
$ svnadmin create /path/to/repos
@@ -239,13 +235,11 @@
conf/ dav/ db/ format hooks/ locks/ README.txt
</screen>
- <para>
- 这个命令建立了一个新的目录<filename>/path/to/repos</filename>，包含了一个Subversion版本库。这个目录保存了一些数据库文件，你打开后看不到你的已经版本化的文件。更多的版本库创建和维护信息，见<xref linkend="svn.reposadmin"/>。</para>
+ <para>这个命令创建了一个新目录<filename>/path/to/repos</filename>，并在其中创建了一个Subversion版本库。这个目录里主要保存了一些数据库文件（还有其它一些文件），而不像CVS那样保存着版本化的文件。需要更多版本库创建和维护方面的内容，参见<xref linkend="svn.reposadmin"/>。</para>
- <para>Subversion没有<quote>项目</quote>的概念，版本库只是一个虚拟的版本化文件系统，可以存放你想要得任何文件。有的管理员倾向于一个版本库只存放一个项目，有的则喜欢存放多个项目到一个版本库不同的目录里，每中方式的优点将会在<xref
- linkend="svn.reposadmin.projects.chooselayout"/>讨论。每种方式，版本库都是以<quote>项目</quote>管理文件和目录，所以或许你会在整本书中经常发现项目这个词，需要记住我们只是在谈论版本库中的一些目录（或者是一组目录）。</para>
+ <para>在Subversion没有<quote>项目</quote>的概念。Subversion的版本库只是一个虚拟的版本化文件系统，可以存放你想要存放的任何文件。有些管理员喜欢为每个项目建立一个独立的版本库，而另外一些管理员则喜欢将多个项目存放到同一个版本库的不同目录里。这两种方式各有各的优点，关于这方面内容的叙述，参见<xref linkend="svn.reposadmin.projects.chooselayout"/>。不论是哪一种方式，版本库都只是负责管理文件和目录，而<quote>项目</quote>则是人为指定的概念。因此，尽管本书中遍布着项目这个词，但是请记住我们只不过是在谈论版本库中的某些特定目录（或者是一组目录）。</para>
- <para>在这个例子里，我们假定你已经有了一些希望导入到Subversion版本库的项目（一组文件和目录）。首先把这些条目整理到同一个叫做<filename>myproject</filename>（或任何名称）的目录里，你的项目要有<filename>branches</filename>、<filename>tags</filename>和<filename>trunk</filename>三个顶级目录，后面你就会知道这样做的原因。<filename>trunk</filename>目录保存所有的数据，而<filename>branches</filename>和<filename>tags</filename>都是空的：</para>
+ <para>在这个例子中，我们假定已经有一些需要导入到Subversion版本库的条目（一组文件和目录）。接下来，我们需要把这些条目整理到一个名为<filename>myproject</filename>的目录（或者其它任意目录）里。在这个目录下，创建三个顶级子目录：<filename>branches</filename>、<filename>tags</filename>和<filename>trunk</filename>，这样做的原因将在后文中阐述。之后，将所有需版本化的数据保存到<filename>trunk</filename>目录下，同时保持<filename>branches</filename>和<filename>tags</filename>目录为空：</para>
<screen>
/tmp/myproject/branches/
@@ -257,9 +251,9 @@
…
</screen>
- <para><filename>branches</filename>、<filename>tags</filename>和<filename>trunk</filename>子目录不是Subversion必需的，它们只是稍候你就会希望使用的流行习惯。</para>
+ <para><filename>branches</filename>、<filename>tags</filename>和<filename>trunk</filename>这三个子目录不是Subversion必须的。但这样做是Subversion的习惯用法，我们还是遵守这个约定吧。</para>
- <para>一旦你你已经准备好了数据，就可以使用<command>svn import</command>命令（见<xref linkend="svn.tour.other.import"/>）将其导入到版本库：
+ <para>准备好了数据之后，就可以使用<command>svn import</command>命令（参见<xref linkend="svn.tour.other.import"/>）将其导入到版本库中：
</para>
<screen>
@@ -275,10 +269,10 @@
$
</screen>
- <para>现在版本库包含了这个目录树的数据，如前所述，直接察看版本库看不到文件和目录；它们存放在数据库当中，但是版本库假想的文件系统现在保存了顶级的目录<filename>myproject</filename>，其中保存了你的数据。
+ <para>现在版本库中已经保存了目录中的数据。如前所述，直接查看版本库是看不到文件和目录的；它们存放在数据库之中。但是版本库的虚拟文件系统中则包含了一个名为<filename>myproject</filename>的顶级目录，其中依此保存了所有的数据。
</para>
- <para>注意最初的<filename>/tmp/myproject</filename>并没有改变，Subversion并没有处理它（实际上，你可以随意删除这个目录）。为了开始处理版本库数据，你需要创建一个新的包含数据的<quote>工作拷贝</quote>，这是一个私有工作区。从Subversion版本库里<quote>check out</quote>出一个<filename>myproject/trunk</filename>目录的工作拷贝：
+ <para>注意我们在一开始创建的那个<filename>/tmp/myproject</filename>目录并没有改变，Subversion并不在意它（事实上，完全可以删除这个目录）。要开始使用版本库数据，我们还要创建一个新的用于存储数据的<quote>工作拷贝</quote>，这是一个私有工作区。从Subversion版本库里<quote>检出</quote>一个<filename>myproject/trunk</filename>目录工作拷贝的操作如下：
</para>
<screen>
@@ -289,29 +283,26 @@
…
Checked out revision 1.
</screen>
- <para>
- 你现在在<filename>myproject</filename>目录里有了一个版本库的个人拷贝，你可以编辑你的工作备份中的文件，并且提交到版本库。</para>
+ <para>现在，在<filename>myproject</filename>目录下生成了一个版本库数据的独立拷贝。我们可以在这个工作拷贝中编辑文件，并将修改提交到版本库中。</para>
<itemizedlist>
<listitem>
- <para>进入到你的工作备份，编辑一个文件的内容。</para>
+ <para>进入工作拷贝目录，编辑某个文件的内容。</para>
</listitem>
<listitem>
- <para>运行<command>svn diff</command>来查看你的修改的标准区别输出。</para>
+ <para>运行<command>svn diff</command>以标准差别格式查看修改的内容。</para>
</listitem>
<listitem>
- <para>运行<command>svn commit</command>来提交你的改变到版本库。</para>
+ <para>运行<command>svn commit</command>将更改提交到版本库中。</para>
</listitem>
<listitem>
- <para>运行<command>svn update</command>将你的工作拷贝与版本库<quote>同步</quote>。</para>
+ <para>运行<command>svn update</command><quote>更新</quote>工作拷贝。</para>
</listitem>
</itemizedlist>
- <para>对于你对工作拷贝可做操作的完全教程可以察看<xref linkend="svn.tour"/>。</para>
+ <para>完整的工作拷贝操作指南，请参见<xref linkend="svn.tour"/>。</para>
- <para>
- 目前，你可以选择使你的版本库在网络上可见，可以参考<xref
- linkend="svn.serverconfig"/>，学习使用不同的服务器以及配置。</para>
+ <para>现在，Subversion版本库可以通过网络方式访问。参考<xref linkend="svn.serverconfig"/>，了解不同服务器软件的使用以及配置方法。</para>
</sect1>
More information about the svnbook-dev
mailing list