From 5fd628e8a37547ba9adf583814cd18a4b9be48f1 Mon Sep 17 00:00:00 2001 From: Zherphy <1123678689@qq.com> Date: Fri, 11 Oct 2024 15:19:36 +0800 Subject: [PATCH] Docs: modify QuickStart.md modify QuickStart.md --- docs/BasicGuide.md | 4 +-- docs/QuickStart.md | 64 +++++++++++++++++++++------------------------- 2 files changed, 31 insertions(+), 37 deletions(-) diff --git a/docs/BasicGuide.md b/docs/BasicGuide.md index b90ac36..6f54cbe 100644 --- a/docs/BasicGuide.md +++ b/docs/BasicGuide.md @@ -57,7 +57,7 @@ Git LFS initialized.   url = https://lfs.test.osinfra.cn/{owner}/{repo} ``` -或者通过命令行设置仓库中LFS远程地址: +- 或者通过命令行设置仓库中LFS远程地址: ``` git config --local lfs.url https://lfs.test.osinfra.cn/{owner}/{repo} @@ -341,4 +341,4 @@ git config --global filter.lfs.process "git-lfs filter-process --skip" ``` git config --global filter.lfs.smudge "git-lfs smudge -- %f" git config --global filter.lfs.process "git-lfs filter-process" -``` \ No newline at end of file +``` diff --git a/docs/QuickStart.md b/docs/QuickStart.md index bd0bd3f..9de5d62 100644 --- a/docs/QuickStart.md +++ b/docs/QuickStart.md @@ -2,22 +2,20 @@ ## 准备工作 -[下载](BasicGuide.md#下载) -[安装](BasicGuide.md#安装) +请确保您在本地环境中已安装GIT LFS。详阅[安装指导](BasicGuide.md#安装)。 ## 第三方LFS服务使用配置 - 创建.lfsconfig文件 - -通过.lfsconfig文件来配置lfs服务大文件的远程地址,使得将仓库中的大文件上传至BigFiles中。 + +在仓库根目录下创建.lfsconfig文件以指定第三方LFS服务,文件内容如下: ``` -# .lfsconfig文件的格式为 [lfs]   url = https://lfs.test.osinfra.cn/{owner}/{repo} ``` -或者通过命令行设置仓库中LFS远程地址: +- 或者通过命令行设置仓库中LFS远程地址: ``` $ git config --local lfs.url https://lfs.test.osinfra.cn/{owner}/{repo} @@ -27,41 +25,42 @@ $ git config --local lfs.url https://lfs.test.osinfra.cn/{owner}/{repo} ## 第三方LFS服务与Gitee的使用差异 -- 在fork一个已经使用第三方LFS服务作为LFS远程服务的仓库后,需要手动修改新仓库中LFS远程地址中的{owner}以及{repo},否则会出现权限校验问题,**错误代码401**。 -- 在使用SSH对Gitee仓库进行克隆后,在使用第三方LFS服务作为LFS远程服务时,仍然需要输入账户和密码。 +- 当您fork一个仓库: + - 在fork一个已经使用第三方LFS服务作为LFS远程服务的仓库后,需要手动修改新仓库中LFS远程地址中的{owner}以及{repo},否则会出现权限校验问题,**错误代码401**。 +- 当您使用ssh协议进行克隆或推送: + - 在使用SSH对Gitee仓库进行克隆后,在使用第三方LFS服务作为LFS远程服务时,仍然需要输入账户和密码。 ## 迁移Gitee中使用LFS服务的仓库中的大文件 -- 克隆仓库 - -``` -$ git clone -``` +1. 克隆仓库 -- 在克隆仓库之后,想要获取远端仓库的最新LFS对象 + ``` + $ git clone + ``` -``` -$ git lfs fetch --all origin -``` +2. 在克隆仓库之后,想要获取远端仓库的最新LFS对象 -git lfs fetch命令会从远程仓库中获取所有缺失的Git LFS对象,但不会将这些对象应用到你的工作目录中。如果想将这些对象应用到工作目录中,需要使用git lfs checkout命令。 + ``` + $ git lfs fetch --all origin + ``` + + git lfs fetch命令会从远程仓库中获取所有缺失的Git LFS对象,但不会将这些对象应用到你的工作目录中。如果想将这些对象应用到工作目录中,需要使用git lfs checkout命令。 -- 通过.lfsconfig文件来[配置lfs服务](QuickStart.md#第三方lfs服务使用配置)大文件的远程地址 +3. 通过.lfsconfig文件来[配置lfs服务](QuickStart.md#第三方lfs服务使用配置)大文件的远程地址 -``` -$ git add . -$ git commit -m "modify .lfsconfig" -``` + ``` + $ git add . + $ git commit -m "modify .lfsconfig" + ``` -- 执行: +4. 执行: -``` -$ git lfs push --all origin -$ git push --all --force origin -$ git push --tags --force origin -``` + ``` + $ git lfs push --all origin + $ git push + ``` -- 原仓库中的lfs文件成功存储于第三方lfs服务中 +5. 原仓库中的lfs文件成功存储于第三方lfs服务中 ## 关闭第三方LFS功能 @@ -79,8 +78,3 @@ $ git push ``` $ git config lfs.url "" ``` - - - - -