Git-Svn-Migrate 项目技术文档

1. 安装指南

git-svn-migrate 项目依赖于 git 1.7 或更高版本以及 Bash shell 环境。确保您的系统中已安装这些依赖项后，您可以按照以下步骤安装 git-svn-migrate：

1. 克隆或下载项目代码至您的系统中。
2. 确认项目脚本具有执行权限。

2. 项目的使用说明

git-svn-migrate 项目包含一系列辅助脚本，用于将 Subversion 仓库迁移到 Git。

基本步骤如下：

步骤 1: 创建需要转换的 Subversion 仓库列表

创建一个文本文件，每行包含一个要转换的仓库。每行可以是以下两种格式之一：

• 仅仓库 URL：

  svn+ssh://example.org/svn/awesomeProject
  file:///svn/secretProject
  https://example.com/svn/evilProject
  

  使用这种格式时，项目名称被假定为 URL 的最后一部分。

• 使用制表符分隔的格式，第一列为 Git 仓库名称，第二列为 Subversion 仓库 URL：

  awesomeProject    svn+ssh://example.org/svn/awesomeProject/repo
  evilproject     file:///svn/evilProject
  notthedroidsyourlookingfor  https://example.com/svn/secretProject
  

步骤 2: 创建 Subversion 用户名到 Git 提交者的转换列表

使用步骤 1 中创建的仓库列表，运行 fetch-svn-authors.sh 脚本以创建所有提交中的唯一用户名列表，并将输出重定向到文件中。

例如：

$ ./fetch-svn-authors.sh --url-file=repository-list.txt > author-transform.txt

编辑 Subversion 用户名列表，为每个用户名提供完整的名称和电子邮件地址，以适应 Git 提交者。

例如：

将：
jwilkins = jwilkins <jwilkins>
更改为：
jwilkins = John Albin Wilkins <[e-mail]>

步骤 3: 将 Subversion 仓库转换为裸 Git 仓库

使用以下命令：

$ ./git-svn-migrate.sh --url-file=repository-list.txt --authors-file=author-transform.txt /var/git

3. 项目API使用文档

git-svn-migrate 主要通过命令行脚本进行交互，没有传统意义上的 API。以下是脚本的主要参数：

• fetch-svn-authors.sh：

  • --url-file=[filename]：指定包含仓库 URL 的文件。
  • --help：显示帮助信息。

• git-svn-migrate.sh：

  • --url-file=[filename]：指定包含仓库 URL 的文件。
  • --authors-file=[filename]：指定包含用户名转换的文件。
  • --help：显示帮助信息。

4. 项目安装方式

请参考“安装指南”部分的内容进行安装。