[svnbook] r5358 committed - branches/1.8/zh/book/ch03-advanced-topics.xml

[wuzhouhui at users.sourceforge.net]

Revision: 5358
          http://sourceforge.net/p/svnbook/source/5358
Author:   wuzhouhui
Date:     2017-07-15 09:38:13 +0000 (Sat, 15 Jul 2017)
Log Message:
-----------
Branch 1.8/zh: translation of chapter 3 in progress

Modified Paths:
--------------
    branches/1.8/zh/book/ch03-advanced-topics.xml

Modified: branches/1.8/zh/book/ch03-advanced-topics.xml
===================================================================
--- branches/1.8/zh/book/ch03-advanced-topics.xml	2017-07-14 14:20:28 UTC (rev 5357)
+++ branches/1.8/zh/book/ch03-advanced-topics.xml	2017-07-15 09:38:13 UTC (rev 5358)
@@ -2278,8 +2278,12 @@
 
     <!-- =============================================================== -->
     <sect2 id="svn.advanced.props.auto">
+    <!--
       <title>Automatic Property Setting</title>
+    -->
+      <title>自动属性设置</title>
 
+    <!--
       <para>Properties are a powerful feature of Subversion, acting as
         key components of many Subversion features discussed elsewhere
         in this and other chapters—textual diff and merge
@@ -2292,7 +2296,16 @@
         add a file to version control).  To help your properties get
         applied to the places that need them, Subversion provides a
         few simple but useful features.</para>
+    -->
+      <para>属性是 Subversion 最强大的特性之一, 它是本章和其他章节介绍的众多
+        Subversion 特性—文本差异比较, 合并支持, 关键词替换和换行符转换
+        等—的关键基础. 为了充分发挥属性的作用, 它们必须被设置到正确的
+        文件和目录上, 不幸的是, 这个步骤在在日常工作常常被人遗忘, 尤其是因为
+        即使属性设置不当通常也不会造成很明显的错误 (至少和文件添加失败比起
+        来, 不是很明显). 为了帮助用户更好地使用属性, Subversion 提供了几个
+        简单但很有用的特性.</para>
 
+    <!--
       <para>Whenever you introduce a file to version control using the
         <command>svn add</command> or <command>svn import</command>
         commands, Subversion tries to assist by setting some common
@@ -2303,7 +2316,15 @@
         imported files whose execute bit is enabled.  (See <xref
         linkend="svn.advanced.props.special.executable" /> later in
         this chapter for more about this property.)</para>
+    -->
+      <para>每当用户使用 <command>svn add</command> 和 <command>svn import
+        </command> 向仓库添加文件时, Subversion 自动地在文件上设置一些常见的
+        属性. 首先, 如果操作系统的文件系统支持可执行权限位并且文件具有可执行
+        权限, Subversion 就自动在文件上设置 <literal>svn:executable</literal>
+        属性 (关于这个属性的更多信息, 见
+        <xref linkend="svn.advanced.props.special.executable"/>).</para>
 
+    <!--
       <para>Second, Subversion tries to determine the file's MIME
         type.  If you've configured a
         <literal>mime-types-files</literal> runtime configuration
@@ -2332,6 +2353,26 @@
         Subversion's use of MIME types, see <xref
         linkend="svn.advanced.props.special.mime-type" /> later in
         this chapter.)</para>
+    -->
+      <para>然后, Subversion 会试图判断文件的 MIME 类型. 如果用户为
+        <literal>mime-types-files</literal> 设置了一个运行时配置参数, Subversion
+        就会尝试根据文件的后缀名为文件搜索一个对应的 MIME 类型映射, 若找到的话,
+        它就把文件的 <literal>svn:mime-type</literal> 属性设置成找到的 MIME
+        类型. 如果用户没有为 <literal>mime-types-files</literal> 设置运行时
+        配置参数, 或者根据后缀名没有找到对应的类型映射, Subversion 就使用启发
+        式的算法来判断文件的 MIME 类型. 取决于编译时的配置, Subversion 1.7
+        可以利用文件扫描函数库<footnote><para>当前比较常用的函数库是 libmagic
+        </para></footnote> 检测文件的类型. 如果前面的都失败了, Subversion 就
+        使用它非常基本的启发式算法来判断文件是否包含非文本数据, 如果是, 就自动
+        地把文件的 <literal>svn:mime-type</literal> 属性设置成
+        <literal>application/octet-stream</literal> (最一般的 MIME 类型, 表示
+        <quote>这是字节的集合</quote>). 当然, 如果 Subversion 的判断不正确,
+        又或者是用户想把 <literal>svn:mime-type</literal> 设置成更精确的值
+        —比如 <literal>image/png</literal> 或 <literal>
+          application/x-shockwave-flash</literal>—可以自由地修改或删除
+        属性 <literal>svn:mime-type</literal> (关于 Subversion 如何使用 MIME
+        类型的更多信息, 见本章后面的
+        <xref linkend="svn.advanced.props.special.mime-type" />).</para>
 
       <note>
         <para>UTF-16 is commonly used to encode files whose semantic