[svnbook] r5852 committed - branches/1.8/zh/book/ch07-customizing-svn.xml

wuzhouhui at users.sourceforge.net wuzhouhui at users.sourceforge.net
Sat Dec 22 21:37:57 CST 2018


Revision: 5852
          http://sourceforge.net/p/svnbook/source/5852
Author:   wuzhouhui
Date:     2018-12-23 03:37:54 +0000 (Sun, 23 Dec 2018)
Log Message:
-----------
1.8/zh: translation of chapter 7 in progress

Modified Paths:
--------------
    branches/1.8/zh/book/ch07-customizing-svn.xml

Modified: branches/1.8/zh/book/ch07-customizing-svn.xml
===================================================================
--- branches/1.8/zh/book/ch07-customizing-svn.xml	2018-12-22 13:47:21 UTC (rev 5851)
+++ branches/1.8/zh/book/ch07-customizing-svn.xml	2018-12-23 03:37:54 UTC (rev 5852)
@@ -1433,25 +1433,36 @@
           <varlistentry>
             <term><literal>ssl-pkcs11-provider</literal></term>
             <listitem>
+      <!--
               <para>The value of this option is the name of the
                 PKCS#11 provider from which an SSL client certificate
+                ### TODO
                 will be drawn (if the server asks for one).  This
                 setting is only honored by Subversion's Neon-based
                 HTTP provider module, which was removed in Subversion
                 1.8.</para>
+      -->
+              <para>选项值是 PKCS#11 提供商的名字. 这个设置只对 Subversion
+                基于 Neon 的 HTTP 模块才有效, 而这种模块在 Subversion 1.8
+                中已经被移除了.</para>
             </listitem>
           </varlistentry>
           <varlistentry>
             <term><literal>ssl-trust-default-ca</literal></term>
             <listitem>
+      <!--
               <para>Set this variable to <literal>yes</literal> if you
                 want Subversion to automatically trust the set of
                 default CAs that ship with OpenSSL.</para>
+      -->
+              <para>如果用户希望 Subversion 自动信任 OpenSSL 附带的默认证书
+                的话, 就把它设置成 <literal>yes</literal>.</para>
             </listitem>
           </varlistentry>
           <varlistentry>
             <term><literal>store-auth-creds</literal></term>
             <listitem>
+      <!--
               <para>This setting is the same as
                 <literal>store-passwords</literal>, except that it
                 enables or disables on-disk caching of
@@ -1458,11 +1469,17 @@
                 <emphasis>all</emphasis> authentication information:
                 usernames, passwords, server certificates, and any
                 other types of cacheable credentials.</para>
+      -->
+              <para>该选项基于上和 <literal>store-passwords</literal> 相同,
+                唯一的不同点是它用于开启或禁止 <emphasis>所有的</emphasis>
+                认证信息缓存, 包括用户名, 密码, 服务器证书, 以及其他能被缓存
+                的凭证.</para>
             </listitem>
           </varlistentry>
           <varlistentry>
             <term><literal>store-passwords</literal></term>
             <listitem>
+      <!--
               <para>This instructs Subversion to cache, or not to
                 cache, passwords that are supplied by the user in
                 response to server authentication challenges.  The
@@ -1470,7 +1487,7 @@
                 <literal>no</literal> to disable this on-disk password
                 caching.  You can override this option for a single
                 instance of the <command>svn</command> command using
-                the <option>--no-auth-cache</option> command-line
+                the <option>- -no-auth-cache</option> command-line
                 parameter (for those subcommands that support it).
                 For more information regarding that, see
                 <xref linkend="svn.serverconfig.netmodel.credcache"/>.
@@ -1478,11 +1495,26 @@
                 Subversion will not store passwords in plaintext
                 unless the <literal>store-plaintext-passwords</literal>
                 option is also set to <literal>yes</literal>.</para>
+      -->
+              <para>指定 Subversion 是否应该缓存用户密码, 这个密码是服务器
+                要求认证时用户输入的. 默认值是 <literal>yes</literal>, 如果
+                设置成 <literal>no</literal> 将禁止缓存密码. 用户可以使用
+                <command>svn</command> 的命令行选项
+                <option>--no-auth-cache</option> 覆盖掉
+                <literal>store-passwords</literal> 的设置 (当然, 这种覆盖只
+                对支持 <option>--no-auth-cache</option> 的子命令才有意义).
+                关于密码缓存的更多信息, 见
+                <xref linkend="svn.serverconfig.netmodel.credcache"/>. 注意,
+                无论是否设置 <literal>store-passwords</literal>, Subversion
+                都不会以明文方式存放密码, 除非
+                <literal>store-plaintext-passwords</literal> 被设置成
+                <literal>yes</literal>.</para>
             </listitem>
           </varlistentry>
           <varlistentry>
             <term><literal>store-plaintext-passwords</literal></term>
             <listitem>
+      <!--
               <para>This variable is only important on UNIX-like systems.
                 It controls what the Subversion client does in case
                 the password for the current authentication realm can
@@ -1495,21 +1527,37 @@
                 the Subversion client to ask you each time a
                 <emphasis>new</emphasis> password is about to be added to
                 the <filename>~/.subversion/auth/</filename> caching area.</para>
+      -->
+              <para>该选项只在类 Unix 系统上才需要注意. 如果密码只能以明文方式
+                缓存在磁盘上 (具体的位置是
+                <filename>~/.subversion/auth/</filename>), 此时 Subversion 将
+                根据该选项决定接下来该怎么做. 如果把它设置成
+                <literal>yes</literal> 或 <literal>no</literal>, 将分别允许
+                或禁止以明文方式缓存密码. 默认值是 <literal>ask</literal>,
+                于是 Subversion 每当遇到一个 <emphasis>新的</emphasis> 密码时,
+                都会询问用户是否以明文方式, 把它缓存到
+                <filename>~/.subversion/auth/</filename>.</para>
             </listitem>
           </varlistentry>
           <varlistentry>
             <term><literal>store-ssl-client-cert-pp</literal></term>
             <listitem>
+      <!--
               <para>This option controls whether Subversion will cache
                 SSL client certificate passphrases provided by the
                 user.  Its value defaults to <literal>yes</literal>.
                 Set this to <literal>no</literal> to disable this
                 passphrase caching.</para>
+      -->
+              <para>该选项用于设置 Subversion 是否应该缓存用户输入的 SSL
+                客户端证书密码, 默认值是 <literal>yes</literal>, 设置成
+                <literal>no</literal> 将禁止缓存.</para>
             </listitem>
           </varlistentry>
           <varlistentry>
             <term><literal>store-ssl-client-cert-pp-plaintext</literal></term>
             <listitem>
+      <!--
               <para>This option controls whether Subversion, when
                 attempting to cache an SSL client certificate
                 passphrase, will be allowed to do so using its on-disk
@@ -1523,6 +1571,14 @@
                 to <literal>yes</literal> or <literal>no</literal> to
                 indicate your preference and avoid related
                 prompts.</para>
+      -->
+              <para>当 Subversion 尝试缓存 SSL 客户端证书密码时, 该选项用于
+                控制是否允许以明文方式存放到磁盘上. 默认值是
+                <literal>ask</literal>, 使得 Subversion 每次遇到一个
+                <emphasis>新的</emphasis> SSL 客户端证书密码时都会向用户询问
+                是否以明文方式缓存到 <filename>~/.subversion/auth/</filename>,
+                把选项设置成 <literal>yes</literal> 或 <literal>no</literal>
+                将允许或禁止明文缓存, Subversion 也不会再询问用户.</para>
             </listitem>
           </varlistentry>
         </variablelist>




More information about the svnbook-dev mailing list