第 5 章 日常使用指南

目录

开始
图标重载
右键菜单
拖放
常用快捷方式
认证
最大化窗口
导入数据到版本库
版本库布局
导入
导入适当的位置
专用文件
引用的工程
检出工作副本
Checkout Depth
将你的修改提交到版本库
提交对话框
修改列表
Excluding Items from the Commit List
提交日志信息
提交进程
用来自别人的修改更新你的工作副本
解决冲突
获得状态信息
图标重载
在 Windows 资源管理器中的 TortoiseSVN 列
本地与远程状态
查看差别
修改列表
版本日志对话框
调用版本日志对话框
版本日志动作
获得更多信息
获取更多的日志信息
Merge Tracking Features
修改日志消息和作者
过滤日志信息
统计信息
统计页
作者提交次数统计页
按日期提交统计页
Offline Mode
Refreshing the View
查看差异
文件差异
Line-end and Whitespace Options
比较文件夹
使用 TortoiseIDiff 进行比较的图像
其他的比较/合并工具
添加新文件和目录
Copying/Moving/Renaming Files and Folders
忽略文件和目录
忽略列表中的模式匹配
Deleting, Moving and Renaming
Deleting files and folders
Moving files and folders
Changing case in a filename
Dealing with filename case conflicts
修复文件改名
删除未版本控制的文件
撤消更改
清理
项目设置
Subversion 属性
svn:keywords
Adding and Editing Properties
Exporting and Importing Properties
Binary Properties
TortoiseSVN Project Properties
分支/标记
创建一个分支或标记
检出或者切换
正在合并
合并指定版本范围
Reintegrate a branch
合并两个不同的目录树
Merge Options
Reviewing the Merge Results
Merge Tracking
Handling Conflicts during Merge
Merge All Changes
锁定在Subverion中是如何工作的
取得锁定
释放锁定
检查锁定状态
让非锁定的文件变成只读
锁定钩子脚本
创建并应用补丁
创建一个补丁文件
应用一个补丁文件
谁修改了哪一行?
追溯文件
追溯不同点
版本库浏览器
版本分支图
Revision Graph Nodes
Changing the View
Using the Graph
Refreshing the View
导出一个Subversion工作副本
Removing a working copy from version control
重新定位工作副本
Integration with Bug Tracking Systems / Issue Trackers
与基于 WEB 的版本库浏览器集成
TortoiseSVN的设置
常规设置
Context Menu Settings
TSVN对话框设置一
TSVN对话框设置二
TortoiseSVN 颜色设置
图标叠加设置
图标集选择
网络设置
外部程序设置
差异查看器
合并工具
差异查看/合并工具的高级设置
统一的差异查看器
已保存数据的设置
Log Caching
Log Cache Statistics
客户端钩子脚本
TortoiseBlame 的设置
注册表设置
Subversion 的工作文件夹
最后步骤

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

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

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

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

  • 你应该已经安装了TortoiseSVN。

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

  • 你应该知道Subversion的基础。

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

开始

图标重载

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

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


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

右键菜单

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

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


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

提示

Some commands which are very rarely used are only available in the extended context menu. To bring up the extended context menu, hold down the Shift key when you right-click.

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

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

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


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

If you are using Windows 2000 you will find that the context menus are shown as plain text, without the menu icons shown above. We are aware that this was working in previous versions, but Microsoft has changed the way its icon handlers work for Vista, requiring us to use a different display method which unfortunately does not work on Windows 2000.

拖放

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

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


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

常用快捷方式

Some common operations have well-known Windows shortcuts, but do not appear on buttons or in menus. If you can't work out how to do something obvious, like refreshing a view, check here.

F1

当然是帮助。

F5

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

Ctrl-A

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

Ctrl-C

... 复制选中的文本。

认证

If the repository that you are trying to access is password protected, an authentication Dialog will show up.

图 5.5. 认证对话框

认证对话框


Enter your username and password. The checkbox will make TortoiseSVN store the credentials in Subversion's default directory: %APPDATA%\Subversion\auth in three subdirectories:

  • svn.simple文件里包含了基本认证方式所需要的认证信息(用户名/口令)。

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

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

If you want to clear the authentication cache for all servers, you can do so from the Saved Data page of TortoiseSVN's settings dialog. That button will clear all cached authentication data from the Subversion auth directories, as well as any authentication data stored in the registry by earlier versions of TortoiseSVN. Refer to “已保存数据的设置”一节.

关于如何设置服务器的认证和权限的更多信息,请参考第 3 章 配置服务器

最大化窗口

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