[svnbook commit] r1805 - trunk/src/zh/book
leasun
svnbook-dev at red-bean.com
Mon Nov 7 09:54:33 CST 2005
Author: leasun
Date: Mon Nov 7 09:54:32 2005
New Revision: 1805
Modified:
trunk/src/zh/book/ch07.xml
Log:
* zh/book/ch07.xml: made a little adjusts.
Modified: trunk/src/zh/book/ch07.xml
==============================================================================
--- trunk/src/zh/book/ch07.xml (original)
+++ trunk/src/zh/book/ch07.xml Mon Nov 7 09:54:32 2005
@@ -23,25 +23,25 @@
<para>Subversion提供了许多用户可以控制的可选行为方式，许多是用户希望添加到所有的Subversion操作中的选项，为了避免强制用户记住命令行参数并且并且在每个命令中使用，Subversion使用配置文件，并且将配置文件保存在独立的Subversion配置区。</para>
- <para>Subversion<firstterm>配置区</firstterm>是一个双层结构，保存了可选项的名称和值。通常，Subversion配置区是一个保存<firstterm>配置文件</firstterm>的特殊目录（第一层结构），目录种保存了一些标准INI格式的文本文件（文件中的<quote>sections</quote>形成第二层结构）。这些文件可以简单用你喜欢的文本编辑器编辑（如Emacs或vi），而且保存了客户端可以读取的指示，用来指导用户的一些行为选项。</para>
+ <para>Subversion<firstterm>配置区</firstterm>是一个双层结构，保存了可选项的名称和值。通常，Subversion配置区是一个保存<firstterm>配置文件</firstterm>的特殊目录（第一层结构），目录中保存了一些标准INI格式的文本文件（文件中的<quote>section</quote>形成第二层结构）。这些文件可以简单用你喜欢的文本编辑器编辑（如Emacs或vi），而且保存了客户端可以读取的指示，用来指导用户的一些行为选项。</para>
<!-- ***************************************************************** -->
<sect2 id="svn-ch-7-sect-1.1">
<title>配置区布局</title>
- <para><command>svn</command>命令行客户端第一次执行时，会创建一个单用户配置区，在Unix类系统中，配置区位于用户主目录中，名为<filename>.subversion</filename>。在Win32系统，Subversion创建一个名为<filename>Subversion</filename>的目录，这个目录通常位于用户配置目录（顺便说一句，通常是一个隐藏目录）的<filename>Application Data</filename>子目录下。然而，在Win32平台上目录的具体位置在不同的系统上是不一样的，由Windows注册表决定。
+ <para><command>svn</command>命令行客户端第一次执行时，会创建一个用户配置区，在类Unix系统中，配置区位于用户主目录中，名为<filename>.subversion</filename>。在Win32系统，Subversion创建一个名为<filename>Subversion</filename>的目录，这个目录通常位于用户配置目录（顺便说一句，通常是一个隐藏目录）的<filename>Application Data</filename>子目录下。然而，在Win32平台上，此目录的具体位置在不同的系统上是不一样的，由Windows注册表决定。
<footnote>
<para><literal>APPDATA</literal>环境变量指向<filename>Application Data</filename>目录，所以你可以通过<filename>%APPDATA%\Subversion</filename>引用用户配置区目录。
</para>
</footnote>
- 我们以Unix下的名字<filename>.subversion</filename>来表示单用户配置区。
+ 我们以Unix下的名字<filename>.subversion</filename>来表示用户配置区。
</para>
- <para>除了单用户配置区，Subversion也提供了系统配置区，通过系统配置区,系统管理员可以为某个机器的所有用户建立缺省配置值。注意系统配置区不会规定强制性的策略—每个单用户配置区都可以覆盖系统配置区中的配置项，而<command>svn</command>的命令行参数决定了最后的行为。在Unix类的平台上，系统配置区位于<filename>/etc/subversion</filename>目录下，在Windows平台上，系统配置区位于<filename>Application Data</filename>（再说一次，是由Windows注册表决定的）的<filename>Subversion</filename>目录中。与单用户配置区不同，<command>svn</command>不会试图创建系统级的配置区域。</para>
+ <para>除了用户配置区，Subversion也提供了系统配置区，通过系统配置区,系统管理员可以为某个机器的所有用户建立缺省配置值。注意系统配置区不会规定强制性的策略—每个用户配置区都可以覆盖系统配置区中的配置项，而<command>svn</command>的命令行参数决定了最后的行为。在类Unix的平台上，系统配置区位于<filename>/etc/subversion</filename>目录下，在Windows平台上，系统配置区位于<filename>Application Data</filename>（再说一次，是由Windows注册表决定的）的<filename>Subversion</filename>目录中。与用户配置区不同，<command>svn</command>不会试图创建系统配置区。</para>
- <para>目前配置区包含三个文件—两个配置文件（<filename>config</filename>和<filename>servers</filename>），和一个描述INI文件格式的<filename>README.txt</filename>文件。配置文件创建的时候，缺省的Subversion选项已经设置好，其中大多数已经加了注释，并且用文字描述分组，记述了这些值对Subversion的关键影响。要修改选项，只需用文本编辑器打开并编辑配置文件。如果想要恢复缺省的配置，可以直接删除（或者重命名）配置目录，并且运行一些如<command>svn --version</command>之类的无影响的<command>svn</command>命令，一个包含缺省值的新配置目录就会创建起来。</para>
+ <para>目前，Subversion的配置区包含三个文件—两个配置文件（<filename>config</filename>和<filename>servers</filename>），和一个描述INI文件格式的<filename>README.txt</filename>文件。配置文件创建的时候，Subversion的选项都设置为默认值。配置文件中的选项都按功能划分成组，大多数选项还有详细的文字描述注释，说明这些选项的值对Subversion的主要影响。要修改选项，只需用文本编辑器打开并编辑配置文件。如果想要恢复缺省的配置，可以直接删除（或者重命名）配置目录，并且运行一些如<command>svn --version</command>之类的无关紧要的<command>svn</command>命令，一个包含缺省值的新配置目录就会创建起来。</para>
- <para>单用户配置区也缓存了认证信息，<filename>auth</filename>目录下的子目录中缓存了一些Subversion支持的各种认证方法的信息，这个目录需要相应的用户权限才可以读取。</para>
+ <para>用户配置区也缓存了认证信息，<filename>auth</filename>目录下的子目录中缓存了一些Subversion支持的各种认证方法的信息，这个目录需要相应的用户权限才可以访问。</para>
</sect2>
@@ -49,34 +49,33 @@
<sect2 id="svn-ch-7-sect-1.2">
<title>配置和Windows注册表</title>
- <para>作为INI为基础的配置趋于的补充，运行在Windows平台Subversion客户端也可以使用Windows猪膘来保存配置数据，选项名称和它们的值与INI文件的一样，<quote>file/section</quote>层级也已经保存，尽管使用不同的样式—在这种模式里，文件和小节也是注册表树的层级。</para>
+ <para>除了基于INI文件的配置区，运行在Windows平台Subversion客户端也可以使用Windows注册表来保存配置数据。注册表中保存的选项名称和值的含义与INI文件中相同，<quote>文件/section</quote>在注册表中表现为注册表键树的层级，使得双层结构得以保留下来。</para>
- <para>Subversion查找系统级的配置值得位置是键<literal>HKEY_LOCAL_MACHINE\Software\Tigris.org\Subversion</literal>，举个例子，<literal>global-ignores</literal>选项是在<filename>config</filename>文件的<literal>miscellany</literal>小节，会在<literal>HKEY_LOCAL_MACHINE\Software\Tigris.org\Subversion\Config\Miscellany\global-ignores</literal>看到，每用户的配置值是存放在<literal>HKEY_CURRENT_USER\Software\Tigris.org\Subversion</literal>下。
- </para>
+ <para>Subversion的系统配置值保存在键<literal>HKEY_LOCAL_MACHINE\Software\Tigris.org\Subversion</literal>下。举个例子，<literal>global-ignores</literal>选项位于<filename>config</filename>文件的<literal>miscellany</literal>小节，在Windows注册表中，则位于<literal>HKEY_LOCAL_MACHINE\Software\Tigris.org\Subversion\Config\Miscellany\global-ignores</literal>。用户配置值存放在<literal>HKEY_CURRENT_USER\Software\Tigris.org\Subversion</literal>下。</para>
- <para>注册表为基础的配置选项在它的文件为基础的对应部分<emphasis>之前</emphasis>被解析，所以会被配置文件中的值覆盖，换句话说，在Windows系统下配置级别是下面的次序：</para>
+ <para>基于注册表的配置项在基于文件的配置项<emphasis>之前</emphasis>解析，所以其配置项的值会被配置文件中相同配置项的值覆盖，换句话说，在Windows系统下配置项的优先级是：</para>
<orderedlist>
<listitem>
<para>命令行选项</para>
</listitem>
<listitem>
- <para>每用户INI文件</para>
+ <para>用户INI配置文件</para>
</listitem>
<listitem>
- <para>每用户注册表值</para>
+ <para>用户注册表值</para>
</listitem>
<listitem>
- <para>系统级INI文件</para>
+ <para>系统INI配置文件</para>
</listitem>
<listitem>
- <para>系统级注册表值</para>
+ <para>系统注册表值</para>
</listitem>
</orderedlist>
- <para>所以，Windows注册表不会真的支持<quote>注释掉了</quote>这种概念，但是Subversion会忽略所有以井号（<literal>#</literal>）开始的字符，这允许你快速的取消一个选项而不需要删除整个注册表，很明显简化了保存选项的过程。</para>
+ <para>此外，虽然Windows注册表不支持<quote>注释掉</quote>这种概念，但是Subversion会忽略所有以井号（<literal>#</literal>）开始的字符，这允许你快速的取消一个选项而不需要删除整个注册表键，明显简化了恢复选项的过程。</para>
- <para><command>svn</command>命令行客户端决不会尝试写Windows注册表，不会创建你需要使用<command>REGEDIT</command>创建的键，作为选择，你可以创建一个<filename>.reg</filename>文件，并且双击这个文件，这回倒这数据合并到你的注册表。</para>
+ <para><command>svn</command>命令行客户端不会尝试写Windows注册表，也不会在注册表中创建默认配置区。不过可以使用<command>REGEDIT</command>创建所需的键。此外，还可以创建一个<filename>.reg</filename>文件，并在文件浏览器中双击这个文件，文件中的数据就会合并到注册表中。</para>
<example id="svn-ch-7-sect-1.2-ex-1">
<title>注册表条目（.reg）样本文件。</title>
@@ -122,7 +121,7 @@
</programlisting>
</example>
- <para>前一个例子里展现了<filename>.reg</filename>文件的内容，保存了一些最常用的配置选项和它们的缺省值，注意包括了系统级（关于网络代理相关的选项）和每用户的设置（编辑器程序和密码保存，还有其它）。也应该注意所有的选项已经有效的注释掉了，你只需要删除选项名称前面的井号（<literal>#</literal>），然后设置你希望的值就可以了。</para>
+ <para>上面例子里显示的<filename>.reg</filename>文件中，包含了一些最常用的配置选项和它们的缺省值。注意，上面的例子中不仅包含了系统设置（关于网络代理相关的选项），也包含了用户设置（指定的编辑器程序，是否保存密码，以及其它选项）。同时要注意的是，所有选项都注释掉了，要启用其中的选项，只需删除该选项名称前面的井号（<literal>#</literal>），然后设置相应的值就可以了。</para>
</sect2>
More information about the svnbook-dev
mailing list