第 4 章 日常使用指南

目录

开始
图标重载
右键菜单
拖放
常用快捷方式
认证
最大化窗口
导入数据到版本库
导入
导入适当的位置
专用文件
检出工作副本
检出深度
将你的修改提交到版本库
提交对话框
修改列表
从提交列表中排除项目
提交日志信息
提交进程
用来自别人的修改更新你的工作副本
解决冲突
文件冲突
树冲突
获得状态信息
图标重载
在 Windows 资源管理器中的 TortoiseSVN 列
本地与远程状态
查看差别
修改列表
版本日志对话框
调用版本日志对话框
版本日志动作
获得更多信息
获取更多的日志信息
当前工作副本的版本
合并跟踪特性
修改日志消息和作者
过滤日志信息
统计信息
离线方式
刷新视图
查看差异
文件差异
行结束符和空白选项
比较文件夹
使用 TortoiseIDiff 进行比较的图像
其他的比较/合并工具
添加新文件和目录
复制/移动/重命名文件和文件夹
忽略文件和目录
忽略列表中的模式匹配
删除、移动和改名
正在删除文件/文件夹
移动文件和文件夹
改变文件名称大小写
处理文件名称大小写冲突
修复文件改名
删除未版本控制的文件
撤消更改
清理
项目设置
Subversion 属性
TortoiseSVN 项目属性
外部条目
外部文件夹
外部文件
分支/标记
创建一个分支或标记
创建分支或标记的其他方法
检出或者切换
合并
合并指定版本范围
复兴分支
合并两个不同的目录树
合并选项
预览合并结果
合并跟踪
子合并期间处理冲突
Merge a Completed Branch
Feature Branch Maintenance
锁定在Subverion中是如何工作的
取得锁定
释放锁定
检查锁定状态
让非锁定的文件变成只读
锁定钩子脚本
创建并应用补丁
创建一个补丁文件
应用一个补丁文件
谁修改了哪一行?
追溯文件
追溯不同点
版本库浏览器
版本分支图
版本图节点
Changing the View
使用图
刷新视图
Pruning Trees
导出一个Subversion工作副本
从版本控制里移除删除工作副本
重新定位工作副本
与 BUG 跟踪系统/问题跟踪集成
Adding Issue Numbers to Log Messages
Getting Information from the Issue Tracker
与基于 WEB 的版本库浏览器集成
TortoiseSVN的设置
常规设置
Revision Graph Settings
图标叠加设置
网络设置
外部程序设置
已保存数据的设置
日志缓存
客户端钩子脚本
TortoiseBlame 的设置
Subversion 的工作文件夹
Advanced Settings
最后步骤

本文目的在与描述TortoiseSVN客户端的日常使用。不是一个版本控制系统指南,也不是Subversion (SVN)的指南。本文档的价值在于,当你知道大概要做什么,却又记不起应该怎么做的时候,可以有个参考的地方。

如果你需要了解使用Subversion进行版本控制的指南,我们建立你阅读以下这本梦幻之书: 《使用 Subversion 进行版本管理》.

本文档与TortoiseSVN和Subversion一样,也是处于“正在开发”的状态。如果你找到了错误之处,请向邮件列表报告,这样我们就可以更新它。日常使用指南(DUG)中的一些屏幕截图也许不符合当前软件中的情况。请您原谅我们。毕竟我们只是用业余的时间在制作TortoiseSVN 。

为了获得比每日用户指南更多的信息:

  • 你应该已经安装了TortoiseSVN。

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

  • 你应该知道Subversion的基础。

  • 你应该已经建立了一个服务器并且可以访问Subversion库。

开始

图标重载

图 4.1. 显示重载图标的资源管理器

显示重载图标的资源管理器


TortoiseSVN 最明显的特性之一就是图标重载,重载的图标显示在你的工作副本文件上。你一眼就可以看到文件被修改过了。参考 “图标重载”一节 查阅不同的重载图标含义。

右键菜单

图 4.2. 版本控制下一个目录的右键菜单

版本控制下一个目录的右键菜单


所有的TortoiseSVN命令都是通过windows资源管理器的右键菜单执行。右键点击一个文件或者文件夹,大多数菜单项都能够直接显示。一个命令是否显示取决于这个文件或文件夹或者它们的父文件夹是否受版本控制,你也可以将TortoiseSVN的菜单作为资源管理器菜单的一部分。

提示

有些命令很少被用到,只有在扩展右键菜单中才能显示。要显示扩展右键菜单,请在单击右键时按住 Shift 键。

在某些情况下,你可能看到多个TortoiseSVN条目。这不是BUG!

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

在一个版本控制的文件夹下资源管理器文件菜单中的快捷方式。


本示例是在一个受控文件夹下的某个未受控的快捷方式, 在资源管理器的文件菜单下有三个TortoiseSVN条目。一个是受控文件夹本身的,一个是快捷方式本身的,第三个是快捷方式所指向的对象。为了帮助你区分它们,菜单条目的图标的右下角有标志,表明是文件、快捷方式、文件夹或是选中了多项。

Windows 2000 的用户将会发现右键菜单仅显示文字,没有上图所示的菜单图标。我们知道这是因为在旧版下使用的缘故,由于微软改变了 Vista 中图标句柄工作方式,我们只好使用不同的方式,很遗憾,这种方式不能在 Windows 2000 下工作。

拖放

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

版本控制下的一个目录的右键拖拽菜单


在工作副本里右键拖拽文件或目录到新的位置,或者右键拖拽一个非版本控制的文件或文件夹到一个版本控制目录下的时候,右键菜单还能够出现其他的命令。

常用快捷方式

一些常见的操作与 Windows 的快捷键是一样的,但没有出现在按钮或是菜单中。如果你找不到一些显而易见的操作,比如刷新视图,请参考以下内容。

F1

当然是帮助。

F5

刷新当前视图。这也许是单键命令中唯一一个最常用的了。比如... 在资源浏览器中,这个键可以刷新工作副本中的图标重载。在提交对话框中,它可以重新扫描查找哪些是需要提交的。在版本日志对话框中,可以重新联系版本库以检查更多的最近修改情况。

Ctrl-A

全选。可用于在得到一个错误消息并想要复制粘贴到电子邮件时。使用Ctrl-A to选择错误错误,然后...

Ctrl-C

... 复制选中的文本。

认证

如果连接的版本库需要密码,就会显示认证对话框。

图 4.5. 认证对话框

认证对话框


输入你的用户名和密码。复选框能让 TortoiseSVN 在 Subversion 的缺省目录: %APPDATA%\Subversion\auth 的三个子目录内保存认证信息:

  • svn.simple 里包含了基本认证方式所需要的认证信息(用户名/密码)。注意,保存的密码是通过 WinCrypt API 加密的,不是文本形式。

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

  • svn.username 里包含了用户名认证的认证信息(不需要提供密码)。

如果想要清除所有服务器的认证缓存,可以通过 TortoiseSVN 设置对话框的已保存数据页来实现。那个按钮能够清除 Subversion 的 auth 目录中缓存的所有认证数据,以及老版本的 TortoiseSVN 存储在注册表里的认证数据。请参考 “已保存数据的设置”一节

如果你想清除某一个范围的认证信息,那么你需要打开那些目录,找到包含你要清除的信息的文件并删除文件。

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

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

你可以从 windows-help-central.com 找到如何安装此脚本的详细描述。

关于如何设置服务器的认证和权限的更多信息,请参考“Accessing the Repository”一节

最大化窗口

大多数 TortoiseSVN 的对话框显示很多信息,但是经常只有最大化高度或者宽度有用,而不是全部最大化,覆盖整个屏幕。为了方便,在 最大化 按钮有快捷方式做这些工作。使用鼠标中键最大化高度,右键最大化宽度。