手册

第 4 章 日常使用指南

目录

一般功能
图标叠加
上下文菜单
拖放
常用快捷键
身份验证
最大化窗口
将数据导入存储库
导入
就地导入
特殊文件
签出工作副本
签出深度
存储原始副本
将更改提交到存储库
提交对话框
更改列表
仅提交文件的部分内容
从提交列表中排除项目
提交日志消息
提交进度
使用他人的更改更新工作副本
解决冲突
文件冲突
属性冲突
树冲突
获取状态信息
图标叠加
详细状态
本地和远程状态
查看差异
更改列表
搁置
修订日志对话框
调用修订日志对话框
修订日志操作
获取更多信息
获取更多日志消息
当前工作副本修订版
合并跟踪功能
更改日志消息和作者
过滤日志消息
统计信息
离线模式
刷新视图
查看差异
文件差异
行尾和空白选项
比较文件夹
使用 TortoiseIDiff 对图像进行差异比较
对 Office 文档进行差异比较
外部差异/合并工具
添加新文件和目录
复制/移动/重命名文件和文件夹
忽略文件和目录
忽略列表中的模式匹配
删除、移动和重命名
删除文件和文件夹
移动文件和文件夹
处理文件名大小写冲突
修复文件重命名
删除未版本控制的文件
撤消更改
清理
项目设置
Subversion 属性
TortoiseSVN 项目属性
属性编辑器
外部项目
外部文件夹
外部文件
通过拖放创建外部项目
分支/标记
创建分支或标记
创建分支或标记的其他方法
签出还是切换...
合并
合并一系列修订版
合并两棵不同的树
合并选项
查看合并结果
合并跟踪
处理合并后的冲突
功能分支维护
锁定
Subversion 中的锁定机制
获取锁定
释放锁定
检查锁定状态
将未锁定文件设为只读
锁定钩子脚本
创建和应用补丁
创建补丁文件
应用补丁文件
谁修改了哪一行?
文件责任追踪
责任追踪差异
仓库浏览器
版本图
版本图节点
更改视图
使用版本图
刷新视图
修剪树
导出 Subversion 工作副本
从版本控制中移除工作副本
重新定位工作副本
与错误跟踪系统/问题跟踪器的集成
在日志消息中添加问题编号
从问题跟踪器获取信息
与基于 Web 的仓库查看器的集成
TortoiseSVN 的设置
常规设置
版本图设置
图标覆盖设置
网络设置
外部程序设置
保存数据设置
日志缓存
客户端钩子脚本
TortoiseBlame 设置
TortoiseUDiff 设置
导出 TSVN 设置
高级设置
最后一步

本文档描述了 TortoiseSVN 客户端的日常使用。它不是版本控制系统的介绍,也不是Subversion (SVN) 的介绍。它更像是一个当你大致知道要做什么,但不太记得怎么做的时候可以参考的地方。

如果你需要了解使用 Subversion 进行版本控制的介绍,我们建议你阅读这本很棒的书: 版本控制与 Subversion .

本文件也正在开发中,就像 TortoiseSVN 和 Subversion 一样。如果您发现任何错误,请向邮件列表报告,以便我们更新文档。日常使用指南 (DUG) 中的一些屏幕截图可能无法反映软件的当前状态。请原谅我们。我们利用业余时间开发 TortoiseSVN。

为了充分利用日常使用指南

  • 您应该已经安装了 TortoiseSVN。

  • 您应该熟悉版本控制系统。

  • 您应该了解 Subversion 的基本知识。

  • 您应该已经设置了服务器,或者可以访问 Subversion 存储库。

一般功能

本节介绍 TortoiseSVN 的一些功能,这些功能适用于手册中的几乎所有内容。请注意,许多功能仅在 Subversion 工作副本中显示。

图标叠加

图 4.1. 显示图标叠加的资源管理器

Explorer showing icon overlays


TortoiseSVN 最显眼的功能之一是工作副本中文件上的图标叠加。这些叠加让您一目了然地了解哪些文件已修改。请参阅 名为“图标叠加”的部分,了解不同的叠加代表什么。

上下文菜单

图 4.2. 版本控制下目录的上下文菜单

Context menu for a directory under version control


所有 TortoiseSVN 命令都从 Windows 资源管理器的上下文菜单中调用。大多数命令在您 右键单击 文件或文件夹时直接可见。可用的命令取决于文件或文件夹或其父文件夹是否处于版本控制之下。您也可以在资源管理器文件菜单中看到 TortoiseSVN 菜单。

提示

一些很少使用的命令仅在扩展上下文菜单中可用。要调出扩展上下文菜单,请在 右键单击 时按住 Shift 键。

在某些情况下,您可能会看到多个 TortoiseSVN 条目。这不是错误!

图 4.3. 版本控制文件夹中快捷方式的资源管理器文件菜单

Explorer file menu for a shortcut in a versioned folder


此示例用于版本化文件夹中的非版本化快捷方式,在资源管理器文件菜单中,有 三个 TortoiseSVN 条目。一个是文件夹,一个是快捷方式本身,第三个是快捷方式指向的对象。为了帮助您区分它们,图标在右下角有一个指示器,以显示菜单条目是针对文件、文件夹、快捷方式还是多个选定项目。

拖放

图 4.4. 版本控制下目录的右键拖动菜单

Right drag menu for a directory under version control


当您 右键拖动 文件或文件夹到工作副本中的新位置,或者当您 右键拖动 非版本化文件或文件夹到版本控制下的目录时,其他命令可用作拖动处理程序。

常用快捷键

一些常见的操作有众所周知的 Windows 快捷键,但不会出现在按钮或菜单中。如果您无法弄清楚如何执行某些明显的操作,例如刷新视图,请在此处查看。

F1

当然,帮助。

F5

刷新当前视图。这可能是最实用的单键命令。例如... 在资源管理器中,这将刷新工作副本上的图标叠加。在提交对话框中,它将重新扫描工作副本以查看哪些内容需要提交。在修订日志对话框中,它将再次联系存储库以检查是否有更新的更改。

Ctrl-A

全选。如果您收到错误消息并希望将其复制粘贴到电子邮件中,可以使用此功能。使用 Ctrl-A 选择错误消息,然后...

Ctrl-C

复制选定的文本。如果未选择任何文本,例如列表条目或消息框,则将该列表条目或消息框的内容复制到剪贴板。

身份验证

如果您尝试访问的存储库受密码保护,则会显示身份验证对话框。

图 4.5. 身份验证对话框

Authentication Dialog


输入您的用户名和密码。该复选框将使 TortoiseSVN 将凭据存储在 Subversion 的默认目录中:%APPDATA%\Subversion\auth,位于三个子目录中

  • svn.simple 包含基本身份验证的凭据(用户名/密码)。请注意,密码使用 WinCrypt API 存储,而不是以纯文本形式存储。

  • svn.ssl.server 包含 SSL 服务器证书。

  • svn.username 包含仅用户名身份验证的凭据(不需要密码)。

如果您想清除身份验证缓存,您可以在 TortoiseSVN 设置对话框的 已保存数据 页面进行操作。全部清除 按钮将清除所有存储库的缓存身份验证数据。而 清除... 按钮将显示一个对话框,您可以在其中选择要删除的缓存身份验证数据。请参考 “已保存数据设置” 部分。

有些人喜欢在注销 Windows 或关机时删除身份验证数据。要实现此目的,可以使用关机脚本删除 %APPDATA%\Subversion\auth 目录,例如:

@echo off
rmdir /s /q "%APPDATA%\Subversion\auth"
      

您可以在 Windows 上安装此类脚本,方法如下:

  1. 运行 gpedit.msc(本地策略)

  2. 用户配置 -> Windows 设置 -> 脚本 -> 登录或注销 -> 属性 -> 添加

有关如何设置服务器以进行身份验证和访问控制的更多信息,请参考 “访问存储库” 部分。

最大化窗口

TortoiseSVN 的许多对话框都显示大量信息,但通常只最大化高度或宽度,而不是最大化以填充整个屏幕,会更方便。为此,最大化 按钮提供了一些快捷方式。使用 鼠标中键 垂直最大化,使用 鼠标右键 水平最大化。

TortoiseSVN 主页