diff --git a/README.zh-CN.md b/README.zh-CN.md index e452c4b..21ac5cd 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -16,7 +16,7 @@ ### 使用简介 -[下载](https://gitee.com) 对应平台的二进制包,可直接运行 +[下载](https://gitee.com/kesin/up2GitX/releases) 对应平台的二进制包,可直接运行 以 Gitee 为例 `./up2 gitee -h` @@ -62,38 +62,69 @@ Examples: 可以是一个包含很多 Git 仓库的目录,也可以是一个包含很多 Git 仓库绝对路径的文本文件,下面以目录为例 +![输入图片说明](https://images.gitee.com/uploads/images/2020/0613/174018_da3fb1c0_62561.png "1.png") 确认这些 Git 仓库是不是你所预期的 #### 2、输入 Gitee 账号信息并选择同步到哪个 Namespace +![输入图片说明](https://images.gitee.com/uploads/images/2020/0613/174031_79068a5e_62561.png "2.png") 输入注册 Gitee 所用的邮箱以及密码,认证成功后会列出可用的 Namespace,在 Gitee 上,它可以是个人名下、组织名下或者企业名下。(目前仅支持上传到个人名下,后续接口功能到位会支持组织和企业) #### 3、确认将要生成的仓库链接并选择公开属性 +![输入图片说明](https://images.gitee.com/uploads/images/2020/0613/174042_38e998c9_62561.png "3.png") 确认要生成的仓库链接是否符合预期,示例中有中文是为了演示错误选项的处理,如果确认无误,选择仓库的公私有属性 -#### 在 Gitee 上创建仓库并展示结果 +#### 4、在 Gitee 上创建仓库并展示结果 +![输入图片说明](https://images.gitee.com/uploads/images/2020/0613/174113_3335ba44_62561.png "4.png") 可以看到有一个创建成功,一个创建失败,一个已经存在同名地址 对于失败的,会提示我们选择是否跳过或者退出修复错误,这里我们选择跳过 +![输入图片说明](https://images.gitee.com/uploads/images/2020/0613/174130_2d6ef730_62561.png "5.png") 紧接着会提示对于已经存在的项目该怎么处理,你可以选择跳过,也可以选择本地强制覆盖远端,这里我们选择强制覆盖 -#### 同步代码到 Gitee +#### 5、同步代码到 Gitee +![输入图片说明](https://images.gitee.com/uploads/images/2020/0613/174154_edabae07_62561.png "6.png") 同步代码完成后会给出每一个代码仓的具体同步状态 这个时候我们前往 [Gitee](https://gitee.com) 查看动态 +![输入图片说明](https://images.gitee.com/uploads/images/2020/0613/174208_47f2b6ec_62561.png "7.png") + 可以看到本地的分支已经推送到 Gitee 平台,这里的同步是会同步所有的本地分支和标签,图中的强制推送就是我们刚刚选择了覆盖,所以工具会强制用本地的代码覆盖远端 Gitee 的代码,所以请想清楚,再做选择。 +### 构建 + +项目使用`go`开发,拉取代码执行`go build up2.go`即可 + +需要注意的是要修改对应的 OAuth 客户端的`id`和`key`,以 Gitee 平台为例: + +修改 `gitee.go` 文件中的 `askForAccount` 的 Client 信息 + +``` +params := fmt.Sprintf(`{ + "grant_type": "password", + "username": "%s", + "password": "%s", + "client_id": "xxxx", // client id from Gitee + "client_secret": "xxxx", // client secret from Gitee + "scope": "user_info projects groups enterprises" + }`, email, password) +``` + +通过对 Client 的信息的改动可以支持 Gitee 公有云以及大部分的 Gitee 私有云客户。 + + + ### 感谢 - [gCli](https://gitee.com/inhere/gcli) Go 的命令行工具库