[svnbook] r5977 committed - branches/1.8/zh/book/appc-webdav.xml

wuzhouhui at users.sourceforge.net wuzhouhui at users.sourceforge.net
Sun Sep 8 07:33:57 CDT 2019


Revision: 5977
          http://sourceforge.net/p/svnbook/source/5977
Author:   wuzhouhui
Date:     2019-09-08 12:33:57 +0000 (Sun, 08 Sep 2019)
Log Message:
-----------
1.8/zh: translation of appendix C in progress

Modified Paths:
--------------
    branches/1.8/zh/book/appc-webdav.xml

Modified: branches/1.8/zh/book/appc-webdav.xml
===================================================================
--- branches/1.8/zh/book/appc-webdav.xml	2019-09-04 14:45:08 UTC (rev 5976)
+++ branches/1.8/zh/book/appc-webdav.xml	2019-09-08 12:33:57 UTC (rev 5977)
@@ -686,6 +686,7 @@
           Photoshop 和 Dreamweaver. 它们都支持直接读写由 WebDAV URL 指定的
           文件, 而且在编辑文件时, 它们都倾向于大量使用 WebDAV 锁.</para>
 
+      <!--
         <para>Note that while many of these programs also exist for
           Mac OS X, they do not appear to support WebDAV directly
           on that platform.  In fact, on Mac OS X, the
@@ -694,13 +695,23 @@
           WebDAV features were deliberately left out of Macintosh
           versions of these programs, since OS X already provides such
           excellent low-level filesystem support for WebDAV.</para>
+      -->
+        <para>注意, 虽然上面所说的几款应用程序也支持 Mac OS X 平台, 但
+          它们不一定直接支持 WebDAV. 实际上, Mac OS X 的
+          <guimenu>File→Open</guimenu> 对话框根本就不允许用户输入
+          路径或 URL. 自从 OS X 从底层文件系统上支持 WebDAV 后, Macintosh
+          的开发人员就有意地从程序中删除了对 WebDAV 的支持.</para>
 
       </sect3>
 
       <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
       <sect3 id="svn.webdav.clients.standalone.free">
+      <!--
         <title>cadaver, DAV Explorer</title>
+      -->
+        <title>cadaver, DAV 浏览器</title>
 
+      <!--
         <para>cadaver is a bare-bones Unix command-line program for
           browsing and changing WebDAV shares.  It uses the neon HTTP
           library—not surprisingly, since both neon and cadaver
@@ -707,12 +718,22 @@
           are written by the same author.  cadaver is free software (GPL
           license) and is available at <ulink
           url="http://www.webdav.org/cadaver/"/>.</para>
+      -->
+      <para>cadaver 是用于浏览和修改 WebDAV 共享目录的 Unix 命令行程序,
+        它使用 neon HTTP 函数库—不用过于惊讶, 毕竟 neon 和 cadaver
+        的作者是同一个人. cadaver 是一个免费软件 (GPL 授权), 下载地址是
+        <ulink url="http://www.webdav.org/cadaver/"/>.</para>
 
+      <!--
         <para>Using cadaver is similar to using a command-line FTP
           program, and thus it's extremely useful for basic WebDAV
           debugging.  It can be used to upload or download files in a
           pinch, to examine properties, and to copy, move,
           lock, or unlock files:</para>
+      -->
+        <para>使用 cadaver 的体验类似于使用命令行形式的 FTP 程序, 因此它非常
+          适合用来完成基本的 WebDAV 调试. 它支持上传或下载文件, 查看属性,
+          复制和移动文件, 以及对文件进行加锁和解锁.</para>
 
         <informalexample>
           <screen>
@@ -734,6 +755,7 @@
 </screen>
         </informalexample>
 
+      <!--
         <para>DAV Explorer is another standalone WebDAV client, written
           in Java.  It's under a free Apache-like license and is
           available at <ulink url="http://www.ics.uci.edu/~webdav/"/>.
@@ -741,7 +763,15 @@
           advantages of being portable and being a more user-friendly GUI
           application.  It's also one of the first clients to support
           the new WebDAV Access Control Protocol (RFC 3744).</para>
+      -->
+        <para>DAV Explorer 是另一款独立的 WebDAV 应用程序, 使用 Java 语言
+          编写. 它使用的是免费的, 类 Apache 授权, 下载地址是 <ulink
+            url="http://www.ics.uci.edu/~webdav/"/>. 它支持 cadaver 的所有
+          功能, 并且可移植性更强, 具有更加友好的 GUI 界面. 它还是第一个
+          支持新的 WebDAV 访问控制协议 (WebDAV Access Control Protocol,
+          RFC 3744) 的客户端程序.</para>
 
+      <!--
         <para>Of course, DAV Explorer's ACL support is useless in this
           case, since <command>mod_dav_svn</command> doesn't support
           it.  The fact that both cadaver and DAV Explorer support
@@ -750,6 +780,13 @@
           requests.  But it's not relevant anyway; we're assuming all
           of these clients are operating against an autoversioning
           repository.</para>
+      -->
+        <para>当然, DAV Explorer 对 ACL 的支持在这里没什么用, 因此
+          <command>mod_dav_svn</command> 根本就不支持 ACL. 实际上,
+          cadaver 和 DAV Explorer 支持的某些 DeltaV 命令其实没什么特别大
+          的用处, 因此它们不允许 <literal>MKACTIVITY</literal> 请求. 但
+          这些都无关紧要, 我们假充所有的 WebDAV 客户端都针对一个自动版本
+          控制的仓库进行操作.</para>
 
       </sect3>
     </sect2>
@@ -756,11 +793,16 @@
 
     <!-- =============================================================== -->
     <sect2 id="svn.webdav.clients.file-explorer-extensions">
+      <!--
       <title>File-Explorer WebDAV Extensions</title>
+      -->
+      <title>文件浏览器 WebDAV 扩展</title>
 
+      <!--
       <para>Some popular file explorer GUI programs support WebDAV
         extensions that allow a user to browse a DAV share as though it
         was just another directory on the local computer, and to
+        ### TODO
         perform basic tree editing operations on the items in that
         share.  For example, Windows Explorer is able to browse a
         WebDAV server as a <quote>network place.</quote>  Users can
@@ -769,16 +811,31 @@
         feature of the file explorer, the DAV share isn't visible to
         ordinary applications.  All DAV interaction must happen
         through the explorer interface.</para>
+      -->
+      <para>有些流行的文件浏览器 GUI 程序支持 WebDAV 扩展功能, 允许用户
+        浏览一个 DAV 共享目录, 就像在浏览一个普通的本地目录, 而且还可以在
+        共享目录中执行基本的目录树编辑操作. 例如, Windows 文件浏览器可以把
+        WebDAV 服务器作为一个 <quote>网络位置</quote> 进行浏览, 用户可以
+        通过拖拽来上传或下载文件, 还可以继续使用通常的方式来重命名, 复制或
+        删除文件. 但是由于这仅仅是文件浏览器的功能, DAV 共享目录对其他普通
+        的应用程序仍然是不可见的, 所有的 DAV 交互都必须通过文件浏览器接口.
+      </para>
 
       <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
       <sect3 id="svn.webdav.clients.file-explorer-extensions.windows">
         <title>Microsoft Web Folders</title>
 
+      <!--
         <para>Microsoft was one of the original backers of the WebDAV
           specification, and first started shipping a client in
           Windows 98, which was known as Web Folders.  This client was
           also shipped in Windows NT 4.0 and Windows 2000.</para>
+      -->
+        <para>Microsoft 是 WebDAV 的原始赞助商之一, 最早在 Windows 98 中
+          集成了 WebDAV 客户端, 即 Web Folders. 该客户端同样出现在 Windows
+          NT 4.0 和 Windows 2000 中.</para>
 
+      <!--
         <para>The original Web Folders client was an extension to
           Explorer, the main GUI program used to browse filesystems.  It
           works well enough.  In Windows 98, the feature might need to
@@ -786,7 +843,14 @@
           inside My Computer.  In Windows 2000, simply
           add a new <quote>network place,</quote> enter the URL, and the
           WebDAV share will pop up for browsing.</para>
+      -->
+        <para>原始的 Web Folders 其实是一个文件浏览器扩展, 但它工作得已经
+          足够好了. 在 Windows 98, 如果在 <quote>我的电脑</quote> 中看不到
+          Web Folders, 则还要显式地安装它. 在 Windows 2000, 只需要添加一个新的
+          <quote>网络位置</quote>, 输入 URL, WebDAV 共享目录就会马上跳
+          出来.</para>
 
+      <!--
         <para>With the release of Windows XP, Microsoft started shipping
           a new implementation of Web Folders, known as the WebDAV
           Mini-Redirector.  The new implementation is a
@@ -803,22 +867,46 @@
           the original author of Apache's WebDAV module, bluntly
           states that XP Web Folders simply can't operate against an Apache
           server.</para>
+      -->
+        <para>到了 Windows XP, Microsoft 决定推出一款新的 Web Folders 程序,
+          即 WebDAV Mini-Redirector. WebDAV Mini-Redirector 是一个处于文件
+          系统层的客户端, 允许 WebDAV 共享目录被挂载成一个驱动器盘符. 但
+          不幸的是, 这个程序的问题太多. WebDAV Mini-Redirector 通常情况下
+          会试图把 HTTP URL (<literal>http://host/repos</literal>) 转换成
+          UNC 共享记号 (<literal>\\host\repos</literal>), 它还经常用
+          Windows Domain 认证来响应 HTTP 认证请求, 把用户名转换成
+          转换成 <literal>HOST\username</literal>. 这些互操作问题非常严重,
+          在网上随处可见, 很多用户都不堪其扰. Apache WebDAV 模块的原始作者
+          Greg Stein 就直言不讳地说 XP Web Folders 根本不能支持 Apache
+          服务器.</para>
 
+      <!--
         <para>Windows Vista's initial implementation of Web Folders seems to
           be almost the same as XP's, so it has the same sort of
           problems.  With luck, Microsoft will remedy these issues in
           a Vista Service Pack.</para>
+      -->
+        <para>Windows Vista 的 Web Folders 最初版本几乎和 XP 一样, 所以它也
+          相同的问题, 但幸运的是, Microsoft 将会在 Vista Service Pack 里
+          修复它们.</para>
 
+      <!--
         <para>However, there seem to be workarounds for both XP and
           Vista that allow Web Folders to work against Apache.  Users
           have mostly reported success with these techniques, so we'll
           relay them here.</para>
+      -->
+        <para>然而, 似乎还是有一些方法能够让 XP 和 Vista 的 WebDAV 客户端支持
+          Apache 服务器, 很多用户都表示他们成功地解决了问题, 于是我们打算在
+          这里简单地介绍一下这些方法.</para>
 
+      <!--
         <para>On Windows XP, you have two options.  First, search
           Microsoft's web site for update KB907306, <quote>Software
           Update for Web Folders.</quote>  This may fix all your
           problems.  If it doesn't, it seems that the original pre-XP
           Web Folders implementation is still buried within the
+                   ### TODO
           system.  You can unearth it by going to Network
           Places and adding a new network place.  When prompted,
           enter the URL of the repository, but <emphasis>include a
@@ -827,7 +915,18 @@
           as <userinput>http://host:80/repos</userinput> instead.
           Respond to any authentication prompts with your Subversion
           credentials.</para>
+      -->
+        <para>如果是 Windows XP 你就有两个选择, 第一个是在 Microsoft 的网站
+          搜索 KB907306—Web Folders 软件更新. 它可能会解决你的所有
+          问题, 如果没有, 那应该是因为系统中的 Web Folders 还是 XP 前的版本.
+          为了进一步挖掘下去, 你需要到 Network Places 那儿添加一个新的网络
+          位置, 在弹出的对话框中输入仓库的 URL, 同时还要在 URL 中
+          <emphasis>加上端口号</emphasis>, 例如, 你应该把
+          <literal>http://host/repos</literal> 写成
+          <literal>http://host:80/repos</literal>, 如果需要认证, 就输入
+          Subversion 的凭证.</para>
 
+      <!--
         <para>On Windows Vista, the same KB907306 update may clear
           everything up.  But there may still be other issues.  Some
           users have reported that Vista considers
@@ -843,10 +942,27 @@
           (<filename>/</filename>), rather than some subdirectory
           such as <filename>/trunk</filename>.  Vista Web Folders
           seems to work only against repository roots.</para>
+      -->
+        <para>如果是 Windows Vista, 相同的 KB907306 更新可能会解决所有问题,
+          但也有可能仍有问题存在. 有些用户报告说 Vista 会把所有的
+          <literal>http://</literal> 看成是不安全的连接, 除非使用
+          <literal>https://</literal>, 否则的话 Vista 会让所有的来自 Apache
+          的认证请求都以失败返回. 如果用户无法通过 SSL 连接 Subversion 仓库,
+          可以通过修改系统注册表来禁止 Vista 的这种行为, 修改的方法是把
+          <literal>HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters\BasicAuthLevel</literal>
+          的值由 <literal>1</literal> 改成 <literal>2</literal>. 最后再提醒一
+          点, 要让 Web Folders 指向仓库的根目录, 而不是仓库内的子目录
+          (例如 <filename>/trunk</filename>), 因为 Vista Web Folders 似乎
+          只有在面对仓库的根目录时才能正常工作.</para>
 
+      <!--
         <para>In general, while these workarounds may function for
           you, you might get a better overall experience using a
           third-party WebDAV client such as WebDrive or NetDrive.</para>
+      -->
+        <para>通常情况下, 上面所说的方法可能会解决你的问题, 但使用第三方的
+          WebDAV 客户端程序 (例如 WebDrive 或 NetDrive) 可能会获得更好的
+          体验.</para>
 
       </sect3>
 
@@ -854,6 +970,7 @@
       <sect3 id="svn.webdav.clients.file-explorer-extensions.linux-de">
         <title>Nautilus, Konqueror</title>
 
+      <!--
         <para>Nautilus is the official file manager/browser for the
           GNOME desktop (<ulink url="http://www.gnome.org"/>), and
           Konqueror is the manager/browser for the KDE desktop (<ulink
@@ -860,12 +977,24 @@
           url="http://www.kde.org"/>).  Both of these applications
           have an explorer-level WebDAV client built in, and they
           operate just fine against an autoversioning repository.</para>
+      -->
+        <para>Nautilus 是 GNOME 桌面环境 (<ulink url="http://www.gnome.org"/>)
+          标准的文件管理与浏览器, 而 Konqueror 是 KDE 桌面环境
+          (<ulink url="http://www.kde.org"/>) 的文件管理与浏览器, 它们都内
+          建了一个文件浏览器级别的 WebDAV 客户端, 而且对自动版本控制的仓库
+          支持得很好.</para>
 
+      <!--
         <para>In GNOME's Nautilus, select the <guimenuitem>File→Open
           location</guimenuitem> menu item and enter the URL in the
           dialog box presented.  The repository should then be
           displayed like any other filesystem.</para>
+      -->
+        <para>在 GNOME 的 Nautilus 里, 选择菜单项 <guimenuitem>File→Open
+            location</guimenuitem>, 在弹出的对话框中输入仓库的, 然后仓库就
+          能像其他文件系统那样展现出来.</para>
 
+      <!--
         <para>In KDE's Konqueror, you need to use the
           <literal>webdav://</literal> scheme when entering the URL in
           the location bar.  If you enter
@@ -877,6 +1006,14 @@
           <userinput>http://host/repos</userinput>, Konqueror becomes a
           WebDAV client and displays the repository as a
           filesystem.</para>
+      -->
+        <para>在 KDE 的 Konqueror 里, 在地址栏输入 URL 时, 必须使用
+          <literal>webdav://</literal> 模式. 如果用户输入了
+          <literal>http://</literal> 模式的 URL, Konqueror 将表现得如同一个
+          网页游览器, 用户将看到由 <command>mod_dav_svn</command> 生成的
+          HTML 目录列表. 如果输入的是 <literal>webdav://host/repos</literal>,
+          而不是 <literal>http://host/repos</literal>, Konqueror 将变成一个
+          WebDAV 客户端, 把仓库按照文件系统的形式展现出来.</para>
 
       </sect3>
     </sect2>




More information about the svnbook-dev mailing list