TortoiseSVN中文手册

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. 基本概念 ................................................................... 4 2.1. 版本库 .............................................................. 4 2.2. 版本模型 ............................................................. 4 2.2.1. 文件共享的问题 ................................................ 4 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. 基于 Apache 的服务器 ............................................... 14 3.1.1. 简介 ......................................................... 14 3.1.2. 安装 Apache .................................................. 14 3.1.3. 安装 Subversion .............................................. 15 3.1.4. 配置 ......................................................... 15 3.1.5. 多版本库 ..................................................... 17 3.1.6. 路径为基础的授权 ............................................. 18 3.1.7. 使用 Windows 域认证 ......................................... 18 3.1.8. 多重认证源 ................................................... 20 3.1.9. 用 SSL 使服务器更安全 ........................................ 20 3.1.10. Using client certificates with virtual SSL hosts ............ 22 3.2. 基于 svnserve 的服务器 ............................................. 23 3.2.1. 简介 ......................................................... 23 3.2.2. 安装 svnserve ................................................ 23 3.2.3. 运行 svnserve ................................................ 24 3.2.4. Basic Authentication with svnserve ........................... 25 3.2.5. 使用 SASL 以便更安全 ........................................ 26 3.2.6. 使用 svn+ssh 认证 ........................................... 28 3.2.7. svnserve 基于路径的授权 ...................................... 28 4. 版本库 .................................................................... 29 4.1. 创建版本库 .......................................................... 29 4.1.1. 使用命令行工具创建版本库 ..................................... 29 4.1.2. 使用 TortoiseSVN 创建版本库 .................................. 29 4.1.3. 本地访问版本库 ............................................... 30 4.1.4. 访问网络共享磁盘上的版本库 ................................... 30 TortoiseSVN iii 4.1.5. 版本库布局 ................................................... 31 4.2. 版本库备份 .......................................................... 32 4.3. 钩子脚本 ............................................................ 32 4.4. 检出链接 ............................................................ 33 5. 日常使用指南 .............................................................. 34 5.1. 开始 ............................................................... 34 5.1.1. 图标重载 ..................................................... 34 5.1.2. 右键菜单 ..................................................... 34 5.1.3. 拖放 ......................................................... 36 5.1.4. 常用快捷方式 ................................................. 37 5.1.5. 认证 ......................................................... 37 5.1.6. 最大化窗口 ................................................... 38 5.2. 导入数据到版本库 .................................................... 38 5.2.1. 导入 ......................................................... 38 5.2.2. 导入适当的位置 ............................................... 40 5.2.3. 专用文件 ..................................................... 40 5.2.4. 引用的工程 ................................................... 40 5.3. 检出工作副本 ........................................................ 42 5.3.1. 检出深度 ..................................................... 43 5.4. 将你的修改提交到版本库 .............................................. 45 5.4.1. 提交对话框 ................................................... 45 5.4.2. 修改列表 ..................................................... 47 5.4.3. Excluding Items from the Commit List ......................... 47 5.4.4. 提交日志信息 ................................................. 47 5.4.5. 提交进程 ..................................................... 48 5.5. 用来自别人的修改更新你的工作副本 .................................... 49 5.6. 解决冲突 ............................................................ 51 5.7. 获得状态信息 ........................................................ 52 5.7.1. 图标重载 ..................................................... 52 5.7.2. 在 Windows 资源管理器中的 TortoiseSVN 列 ..................... 53 5.7.3. 本地与远程状态 ............................................... 54 5.7.4. 查看差别 ..................................................... 55 5.8. 修改列表 ............................................................ 55 5.9. 版本日志对话框 ...................................................... 58 5.9.1. 调用版本日志对话框 ........................................... 58 5.9.2. 版本日志动作 ................................................. 59 5.9.3. 获得更多信息 ................................................. 59 5.9.4. 获取更多的日志信息 ........................................... 62 5.9.5. 合并跟踪特性 ................................................. 62 5.9.6. 修改日志消息和作者 ........................................... 63 5.9.7. 过滤日志信息 ................................................. 64 5.9.8. 统计信息 ..................................................... 64 5.9.9. 离线方式 ..................................................... 66 5.9.10. 刷新视图 .................................................... 67 5.10. 查看差异 ........................................................... 67 5.10.1. 文件差异 .................................................... 67 5.10.2. 行结束符和空白选项 .......................................... 68 5.10.3. 比较文件夹 .................................................. 68 5.10.4. 使用 TortoiseIDiff 进行比较的图像 ........................... 69 5.10.5. 其他的比较/合并工具 ......................................... 70 5.11. 添加新文件和目录 ................................................... 71 5.12. Copying/Moving/Renaming Files and Folders .......................... 72 5.13. 忽略文件和目录 ..................................................... 73 5.13.1. 忽略列表中的模式匹配 ........................................ 74 5.14. 删除、移动和改名 ................................................... 75 5.14.1. 正在删除文件/文件夹 ......................................... 75 5.14.2. 移动文件和文件夹 ............................................ 76 5.14.3. 改变文件名称大小写 .......................................... 77 TortoiseSVN iv 5.14.4. 处理文件名称大小写冲突 ...................................... 77 5.14.5. 修复文件改名 ................................................ 77 5.14.6. 删除未版本控制的文件 ........................................ 78 5.15. 撤消更改 ........................................................... 78 5.16. 清理 .............................................................. 79 5.17. 项目设置 ........................................................... 79 5.17.1. Subversion 属性 ............................................. 80 5.17.2. TortoiseSVN 项目属性 ........................................ 84 5.18. 分支/标记 .......................................................... 85 5.18.1. 创建一个分支或标记 .......................................... 86 5.18.2. 检出或者切换 ................................................ 87 5.19. 正在合并 ........................................................... 88 5.19.1. 合并指定版本范围 ............................................ 89 5.19.2. 复兴分支 .................................................... 91 5.19.3. 合并两个不同的目录树 ........................................ 91 5.19.4. 合并选项 .................................................... 92 5.19.5. 预览合并结果 ................................................ 93 5.19.6. 合并跟踪 .................................................... 94 5.19.7. 子合并期间处理冲突 .......................................... 94 5.19.8. Merge a Completed Branch ................................... 95 5.20. 锁 ................................................................ 96 5.20.1. 锁定在Subverion中是如何工作的 ............................... 96 5.20.2. 取得锁定 .................................................... 97 5.20.3. 释放锁定 .................................................... 97 5.20.4. 检查锁定状态 ................................................ 98 5.20.5. 让非锁定的文件变成只读 ...................................... 98 5.20.6. 锁定钩子脚本 ................................................ 98 5.21. 创建并应用补丁 ..................................................... 99 5.21.1. 创建一个补丁文件 ............................................ 99 5.21.2. 应用一个补丁文件 ........................................... 100 5.22. 谁修改了哪一行？ .................................................. 100 5.22.1. 追溯文件 ................................................... 101 5.22.2. 追溯不同点 ................................................. 103 5.23. 版本库浏览器 ...................................................... 103 5.24. 版本分支图 ........................................................ 105 5.24.1. 版本图节点 ................................................. 106 5.24.2. Changing the View ......................................... 106 5.24.3. 使用图 ..................................................... 107 5.24.4. 刷新视图 ................................................... 107 5.25. 导出一个Subversion工作副本 ........................................ 108 5.25.1. 从版本控制里移除删除工作副本 ............................... 108 5.26. 重新定位工作副本 .................................................. 109 5.27. 与 BUG 跟踪系统/问题跟踪集成 ...................................... 109 5.27.1. Adding Issue Numbers to Log Messages ....................... 110 5.27.2. Getting Information from the Issue Tracker ................. 112 5.28. 与基于 WEB 的版本库浏览器集成 ..................................... 113 5.29. TortoiseSVN的设置 ................................................. 114 5.29.1. 常规设置 ................................................... 114 5.29.2. 图标叠加设置 ............................................... 122 5.29.3. 网络设置 ................................................... 125 5.29.4. 外部程序设置 ............................................... 126 5.29.5. 已保存数据的设置 ........................................... 129 5.29.6. 日志缓存 ................................................... 130 5.29.7. 客户端钩子脚本 ............................................. 132 5.29.8. TortoiseBlame 的设置 ....................................... 136 5.29.9. 注册表设置 ................................................. 136 5.29.10. Subversion 的工作文件夹 ................................... 137 5.30. 最后步骤 .......................................................... 137 TortoiseSVN v 6. SubWCRev 程序 ............................................................ 138 6.1. SubWCRev 命令行 ................................................... 138 6.2. 关键字替换 ......................................................... 138 6.3. 关键字例子 ......................................................... 139 6.4. COM 接口 .......................................................... 140 A. 常见问题(FAQ) ............................................................ 142 B. 如何实现 … .............................................................. 143 B.1. 一次移动或复制多个文件 ............................................. 143 B.2. 强制用户写日志 ..................................................... 143 B.2.1. 服务器端的钩子脚本(Hook-script) ............................. 143 B.2.2. 工程(Project)属性 ........................................... 143 B.3. 从版本库里更新选定的文件到本地 ..................................... 143 B.4. Roll back (Undo) revisions in the repository ...................... 144 B.4.1. 使用版本日志对话框 .......................................... 144 B.4.2. 使用合并对话框 .............................................. 144 B.4.3. 使用 svndumpfilter .......................................... 144 B.5. 比较一个文件的两个版本 ............................................. 145 B.6. 包含一个普通的子项目 ............................................... 145 B.6.1. 使用 svn:externals .......................................... 145 B.6.2. 使用嵌套工作副本 ............................................ 145 B.6.3. 使用相对位置 ................................................ 145 B.7. 创建到版本库的快捷方式 ............................................. 146 B.8. 忽略已经版本控制的文件 ............................................. 146 B.9. 从工作副本删除版本信息 ............................................. 146 B.10. 删除工作副本 ...................................................... 147 C. 对管理员有用的技巧 ....................................................... 148 C.1. 通过组策略部署 TortoiseSVN ......................................... 148 C.2. 重定向升级检查 ..................................................... 148 C.3. 设置 SVN_ASP_DOT_NET_HACK 环境变量 ................................. 149 C.4. 禁用上下文菜单 ..................................................... 149 D. TortoiseSVN 操作 ......................................................... 151 D.1. TortoiseSVN 命令 .................................................. 151 D.2. TortoiseIDiff 命令 ................................................ 154 E. 命令行交叉索引 ........................................................... 155 E.1. 约定和基本规则 ..................................................... 155 E.2. TortoiseSVN 命令 .................................................. 155 E.2.1. 检出 ........................................................ 155 E.2.2. 更新 ........................................................ 155 E.2.3. 更新到版本 .................................................. 155 E.2.4. 提交 ........................................................ 156 E.2.5. 差异 ........................................................ 156 E.2.6. 显示日志 .................................................... 156 E.2.7. 检查所作的修改 .............................................. 157 E.2.8. 版本图 ...................................................... 157 E.2.9. 版本库浏览器 ................................................ 157 E.2.10. 编辑冲突 ................................................... 157 E.2.11. 已解决 ..................................................... 157 E.2.12. 改名 ....................................................... 157 E.2.13. 删除 ....................................................... 157 E.2.14. 恢复 ....................................................... 157 E.2.15. 清理 ....................................................... 158 E.2.16. 获得锁 ..................................................... 158 E.2.17. 释放锁 ..................................................... 158 E.2.18. 分支/标记 .................................................. 158 E.2.19. 切换 ....................................................... 158 E.2.20. 合并 ....................................................... 159 E.2.21. 输出 ....................................................... 159 E.2.22. 重新定位 ................................................... 159 TortoiseSVN vi E.2.23. 在当前位置创建版本库 ....................................... 159 E.2.24. 添加 ....................................................... 159 E.2.25. 导入 ....................................................... 159 E.2.26. 追溯 ....................................................... 159 E.2.27. 加入忽略列表 ............................................... 160 E.2.28. 创建补丁 ................................................... 160 E.2.29. 应用补丁(Apply Patch) ...................................... 160 F. 实现细节 ................................................................. 161 F.1. 图标重载 ........................................................... 161 G. 用 SSH 使服务器更安全 .................................................... 163 G.1. 配置 Linux 服务器 ................................................. 163 G.2. 配置 Windows 服务器 ............................................... 163 G.3. 用于 TortoiseSVN 的 SSH 客户端工具 ................................ 164 G.4. 创建 OpenSSH 证书 ................................................. 164 G.4.1. 使用 ssh-keygen 创建密钥 .................................... 164 G.4.2. 使用 PuTTYgen 创建密钥 ...................................... 164 G.5. 使用 PuTTY 测试 ................................................... 165 G.6. 使用 TortoiseSVN 测试 SSH ......................................... 165 G.7. SSH 配置参数 ...................................................... 166 术语表 ....................................................................... 168 索引 ......................................................................... 171