TortoiseSVN
针对 Windows 平台的 Subversion 客户端
版本 1.6.7
Stefan Küng
Lübbe Onken
Simon Large
ii
目录
前言 ........................................................................... x
1. 致读者 ................................................................ x
2. 阅读指南 .............................................................. x
3. TortoiseSVN 是完全免费的！ ............................................. x
4. 社区 ................................................................. xi
5. 致谢 ................................................................. xi
6. 本文使用的术语 ........................................................ xi
1. 简介 ....................................................................... 1
1.1. 什么是 TortoiseSVN？ ................................................ 1
1.2. TortoiseSVN 的历史 .................................................. 1
1.3. TortoiseSVN 的特性 .................................................. 1
1.4. 安装 TortoiseSVN .................................................... 2
1.4.1. 系统要求 ...................................................... 2
1.4.2. 安装 .......................................................... 2
1.4.3. 语言包 ........................................................ 2
1.4.4. 拼写检查器 .................................................... 3
2. Basic Version-Control Concepts ............................................. 4
2.1. 版本库 .............................................................. 4
2.2. 版本模型 ............................................................. 4
2.2.1. 文件共享的问题 ................................................ 5
2.2.2. 锁定-修改-解锁 方案 ........................................... 5
2.2.3. 复制-修改-合并 方案 ........................................... 6
2.2.4. Subversion 怎么做？ ........................................... 8
2.3. Subversion 实战 ..................................................... 9
2.3.1. 工作副本 ...................................................... 9
2.3.2. 版本库的 URL ................................................. 10
2.3.3. 修订版本 ..................................................... 11
2.3.4. 工作副本怎样跟踪版本库 ....................................... 12
2.4. 摘要 ............................................................... 12
3. 版本库 .................................................................... 14
3.1. 创建版本库 .......................................................... 14
3.1.1. 使用命令行工具创建版本库 ..................................... 14
3.1.2. 使用 TortoiseSVN 创建版本库 .................................. 14
3.1.3. 本地访问版本库 ............................................... 15
3.1.4. 访问网络共享磁盘上的版本库 ................................... 15
3.1.5. 版本库布局 ................................................... 16
3.2. 版本库备份 .......................................................... 17
3.3. 服务器端钩子脚本 .................................................... 17
3.4. 检出链接 ............................................................ 18
3.5. Accessing the Repository ........................................... 18
3.6. 基于 svnserve 的服务器 ............................................. 19
3.6.1. 简介 ......................................................... 19
3.6.2. 安装 svnserve ................................................ 19
3.6.3. 运行 svnserve ................................................ 19
3.6.4. svnserve 与基本认证 .......................................... 21
3.6.5. 使用 SASL 以便更安全 ........................................ 22
3.6.6. 使用 svn+ssh 认证 ........................................... 23
3.6.7. svnserve 基于路径的授权 ...................................... 23
3.7. 基于 Apache 的服务器 ............................................... 23
3.7.1. 简介 ......................................................... 23
3.7.2. 安装 Apache .................................................. 24
3.7.3. 安装 Subversion .............................................. 24
3.7.4. 配置 ......................................................... 25
3.7.5. 多版本库 ..................................................... 27
3.7.6. 路径为基础的授权 ............................................. 27
TortoiseSVN
iii
3.7.7. 使用 Windows 域认证 ......................................... 28
3.7.8. 多重认证源 ................................................... 29
3.7.9. 用 SSL 使服务器更安全 ........................................ 30
3.7.10. 在虚拟 SSL 主机中使用客户端证书 ............................. 32
4. 日常使用指南 .............................................................. 33
4.1. 开始 ............................................................... 33
4.1.1. 图标重载 ..................................................... 33
4.1.2. 右键菜单 ..................................................... 33
4.1.3. 拖放 ......................................................... 35
4.1.4. 常用快捷方式 ................................................. 36
4.1.5. 认证 ......................................................... 36
4.1.6. 最大化窗口 ................................................... 37
4.2. 导入数据到版本库 .................................................... 37
4.2.1. 导入 ......................................................... 37
4.2.2. 导入适当的位置 ............................................... 38
4.2.3. 专用文件 ..................................................... 39
4.3. 检出工作副本 ........................................................ 39
4.3.1. 检出深度 ..................................................... 40
4.4. 将你的修改提交到版本库 .............................................. 41
4.4.1. 提交对话框 ................................................... 41
4.4.2. 修改列表 ..................................................... 43
4.4.3. 从提交列表中排除项目 ......................................... 43
4.4.4. 提交日志信息 ................................................. 44
4.4.5. 提交进程 ..................................................... 45
4.5. 用来自别人的修改更新你的工作副本 .................................... 46
4.6. 解决冲突 ............................................................ 48
4.6.1. 文件冲突 ..................................................... 48
4.6.2. 树冲突 ....................................................... 49
4.7. 获得状态信息 ........................................................ 51
4.7.1. 图标重载 ..................................................... 51
4.7.2. 在 Windows 资源管理器中的 TortoiseSVN 列 ..................... 53
4.7.3. 本地与远程状态 ............................................... 53
4.7.4. 查看差别 ..................................................... 55
4.8. 修改列表 ............................................................ 56
4.9. 版本日志对话框 ...................................................... 57
4.9.1. 调用版本日志对话框 ........................................... 58
4.9.2. 版本日志动作 ................................................. 59
4.9.3. 获得更多信息 ................................................. 59
4.9.4. 获取更多的日志信息 ........................................... 63
4.9.5. 当前工作副本的版本 ........................................... 64
4.9.6. 合并跟踪特性 ................................................. 64
4.9.7. 修改日志消息和作者 ........................................... 65
4.9.8. 过滤日志信息 ................................................. 65
4.9.9. 统计信息 ..................................................... 66
4.9.10. 离线方式 .................................................... 69
4.9.11. 刷新视图 .................................................... 69
4.10. 查看差异 ........................................................... 69
4.10.1. 文件差异 .................................................... 69
4.10.2. 行结束符和空白选项 .......................................... 70
4.10.3. 比较文件夹 .................................................. 71
4.10.4. 使用 TortoiseIDiff 进行比较的图像 ........................... 72
4.10.5. 其他的比较/合并工具 ......................................... 73
4.11. 添加新文件和目录 ................................................... 73
4.12. 复制/移动/重命名文件和文件夹 ....................................... 74
4.13. 忽略文件和目录 ..................................................... 75
4.13.1. 忽略列表中的模式匹配 ........................................ 76
4.14. 删除、移动和改名 ................................................... 77
4.14.1. 正在删除文件/文件夹 ......................................... 77
TortoiseSVN
iv
4.14.2. 移动文件和文件夹 ............................................ 78
4.14.3. 改变文件名称大小写 .......................................... 79
4.14.4. 处理文件名称大小写冲突 ...................................... 79
4.14.5. 修复文件改名 ................................................ 79
4.14.6. 删除未版本控制的文件 ........................................ 80
4.15. 撤消更改 ........................................................... 80
4.16. 清理 .............................................................. 81
4.17. 项目设置 ........................................................... 81
4.17.1. Subversion 属性 ............................................. 82
4.17.2. TortoiseSVN 项目属性 ........................................ 85
4.18. 外部条目 ........................................................... 87
4.18.1. 外部文件夹 .................................................. 87
4.18.2. 外部文件 .................................................... 89
4.19. 分支/标记 .......................................................... 89
4.19.1. 创建一个分支或标记 .......................................... 89
4.19.2. 检出或者切换 ................................................ 91
4.20. 合并 .............................................................. 92
4.20.1. 合并指定版本范围 ............................................ 93
4.20.2. 复兴分支 .................................................... 95
4.20.3. 合并两个不同的目录树 ........................................ 96
4.20.4. 合并选项 .................................................... 97
4.20.5. 预览合并结果 ................................................ 97
4.20.6. 合并跟踪 .................................................... 98
4.20.7. 子合并期间处理冲突 .......................................... 98
4.20.8. Merge a Completed Branch ................................... 99
4.20.9. Feature Branch Maintenance ................................. 100
4.21. 锁 ............................................................... 100
4.21.1. 锁定在Subverion中是如何工作的 .............................. 101
4.21.2. 取得锁定 ................................................... 101
4.21.3. 释放锁定 ................................................... 102
4.21.4. 检查锁定状态 ............................................... 102
4.21.5. 让非锁定的文件变成只读 ..................................... 103
4.21.6. 锁定钩子脚本 ............................................... 103
4.22. 创建并应用补丁 .................................................... 103
4.22.1. 创建一个补丁文件 ........................................... 103
4.22.2. 应用一个补丁文件 ........................................... 104
4.23. 谁修改了哪一行？ .................................................. 105
4.23.1. 追溯文件 ................................................... 105
4.23.2. 追溯不同点 ................................................. 107
4.24. 版本库浏览器 ...................................................... 107
4.25. 版本分支图 ........................................................ 109
4.25.1. 版本图节点 ................................................. 110
4.25.2. Changing the View ......................................... 111
4.25.3. 使用图 ..................................................... 113
4.25.4. 刷新视图 ................................................... 114
4.25.5. Pruning Trees .............................................. 114
4.26. 导出一个Subversion工作副本 ........................................ 114
4.26.1. 从版本控制里移除删除工作副本 ............................... 116
4.27. 重新定位工作副本 .................................................. 116
4.28. 与 BUG 跟踪系统/问题跟踪集成 ...................................... 117
4.28.1. Adding Issue Numbers to Log Messages ....................... 117
4.28.2. Getting Information from the Issue Tracker ................. 120
4.29. 与基于 WEB 的版本库浏览器集成 ..................................... 121
4.30. TortoiseSVN的设置 ................................................. 122
4.30.1. 常规设置 ................................................... 122
4.30.2. Revision Graph Settings .................................... 129
4.30.3. 图标叠加设置 ............................................... 131
4.30.4. 网络设置 ................................................... 134
TortoiseSVN
v
4.30.5. 外部程序设置 ............................................... 135
4.30.6. 已保存数据的设置 ........................................... 138
4.30.7. 日志缓存 ................................................... 139
4.30.8. 客户端钩子脚本 ............................................. 142
4.30.9. TortoiseBlame 的设置 ....................................... 146
4.30.10. 注册表设置 ................................................ 146
4.30.11. Subversion 的工作文件夹 ................................... 148
4.31. 最后步骤 .......................................................... 148
5. SubWCRev 程序 ............................................................ 149
5.1. SubWCRev 命令行 ................................................... 149
5.2. 关键字替换 ......................................................... 149
5.3. 关键字例子 ......................................................... 150
5.4. COM 接口 .......................................................... 151
6. IBugtraqProvider interface ............................................... 154
6.1. The IBugtraqProvider interface ..................................... 154
6.2. The IBugtraqProvider2 interface .................................... 155
A. 常见问题(FAQ) ............................................................ 158
B. 如何实现 … .............................................................. 159
B.1. 一次移动或复制多个文件 ............................................. 159
B.2. 强制用户写日志 ..................................................... 159
B.2.1. 服务器端的钩子脚本(Hook-script) ............................. 159
B.2.2. 工程(Project)属性 ........................................... 159
B.3. 从版本库里更新选定的文件到本地 ..................................... 160
B.4. Roll back (Undo) revisions in the repository ...................... 160
B.4.1. 使用版本日志对话框 .......................................... 160
B.4.2. 使用合并对话框 .............................................. 160
B.4.3. 使用 svndumpfilter .......................................... 161
B.5. Compare two revisions of a file or folder ......................... 161
B.6. 包含一个普通的子项目 ............................................... 161
B.6.1. 使用 svn:externals .......................................... 161
B.6.2. 使用嵌套工作副本 ............................................ 162
B.6.3. 使用相对位置 ................................................ 162
B.7. 创建到版本库的快捷方式 ............................................. 162
B.8. 忽略已经版本控制的文件 ............................................. 162
B.9. 从工作副本删除版本信息 ............................................. 163
B.10. 删除工作副本 ...................................................... 163
C. Useful Tips For Administrators ........................................... 164
C.1. 通过组策略部署 TortoiseSVN ......................................... 164
C.2. 重定向升级检查 ..................................................... 164
C.3. 设置 SVN_ASP_DOT_NET_HACK 环境变量 ................................. 165
C.4. 禁用上下文菜单 ..................................................... 165
D. TortoiseSVN 操作 ......................................................... 167
D.1. TortoiseSVN 命令 .................................................. 167
D.2. TortoiseIDiff 命令 ................................................ 170
E. 命令行交叉索引 ........................................................... 171
E.1. 约定和基本规则 ..................................................... 171
E.2. TortoiseSVN 命令 .................................................. 171
E.2.1. 检出 ........................................................ 171
E.2.2. 更新 ........................................................ 171
E.2.3. 更新到版本 .................................................. 171
E.2.4. 提交 ........................................................ 172
E.2.5. 差异 ........................................................ 172
E.2.6. 显示日志 .................................................... 172
E.2.7. 检查修改 .................................................... 173
E.2.8. 版本图 ...................................................... 173
E.2.9. 版本库浏览器 ................................................ 173
E.2.10. 编辑冲突 ................................................... 173
E.2.11. 已解决 ..................................................... 173
