git-svn-migrate 项目使用教程

git-svn-migrate 项目使用教程

git-svn-migrate Helper scripts to ease the migration of Subversion repositories to Git 项目地址: https://gitcode.com/gh_mirrors/gi/git-svn-migrate

1. 项目的目录结构及介绍

git-svn-migrate/
├── CHANGELOG.txt
├── LICENSE.txt
├── README.txt
├── fetch-svn-authors.sh
├── git-svn-migrate.sh
├── sample-repository-list.txt
└── svn-lookup-author.sh

• CHANGELOG.txt: 记录项目的变更历史。
• LICENSE.txt: 项目的开源许可证，采用 GPL-2.0 许可证。
• README.txt: 项目的介绍和使用说明。
• fetch-svn-authors.sh: 用于从 Subversion 仓库中提取作者信息的脚本。
• git-svn-migrate.sh: 主要脚本，用于将 Subversion 仓库迁移到 Git 仓库。
• sample-repository-list.txt: 示例文件，包含需要迁移的 Subversion 仓库列表。
• svn-lookup-author.sh: 用于查找 Subversion 作者信息的脚本。

2. 项目的启动文件介绍

git-svn-migrate.sh

git-svn-migrate.sh 是项目的核心启动文件，用于将 Subversion 仓库迁移到 Git 仓库。以下是该脚本的基本使用方法：

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

• --url-file: 指定包含 Subversion 仓库列表的文件。
• --authors-file: 指定包含 Subversion 用户名到 Git 提交者映射的文件。
• /var/git: 指定迁移后的 Git 仓库的存储路径。

fetch-svn-authors.sh

fetch-svn-authors.sh 用于从 Subversion 仓库中提取作者信息，并生成一个包含用户名映射的文件。以下是该脚本的基本使用方法：

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

• --url-file: 指定包含 Subversion 仓库列表的文件。
• > author-transform.txt: 将提取的作者信息输出到 author-transform.txt 文件中。

3. 项目的配置文件介绍

repository-list.txt

repository-list.txt 是一个文本文件，包含需要迁移的 Subversion 仓库列表。每行可以有两种格式：

1. 基本格式: 仅包含仓库的 URL。

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

2. 自定义格式: 包含仓库名称和 URL，以制表符分隔。

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

author-transform.txt

author-transform.txt 是一个文本文件，包含 Subversion 用户名到 Git 提交者的映射。该文件由 fetch-svn-authors.sh 脚本生成，并需要手动编辑以提供完整的 Git 提交者信息。

示例内容：

username = Full name <email>
jwilkins = John Albin Wilkins <john@example.org>

通过以上步骤，您可以顺利地将 Subversion 仓库迁移到 Git 仓库，并确保迁移后的 Git 仓库包含正确的提交者信息。

git-svn-migrate Helper scripts to ease the migration of Subversion repositories to Git 项目地址: https://gitcode.com/gh_mirrors/gi/git-svn-migrate