Skip to content

docs: 去重文档图片并优化源码克隆说明 - #18359

Merged
cuicheng01 merged 1 commit into
PaddlePaddle:mainfrom
cuicheng01:docs/repository-size-optimization
Sep 16, 2026
Merged

cuicheng01 merged 1 commit into
PaddlePaddle:mainfrom
cuicheng01:docs/repository-size-optimization

Conversation

@cuicheng01

Copy link
Copy Markdown
Collaborator

改动

文档中多处保存了内容完全相同的图片,安装说明也默认下载完整 Git 历史。本次将重复图片的引用统一到已有文件,并为普通源码使用场景改用浅克隆。

  • 移除 39 个逐字节一致的图片副本,更新 123 处文档引用,减少源码展开体积约 11.63 MiB。
  • 更新中英文 3.x 安装文档和 2.x 克隆文档,使用 git clone --depth 1,说明指定分支与补取完整历史的方法。
  • 补齐进入源码目录的步骤,指定版本通过克隆时的 --branch 参数选择。

验证

  • 39 个删除副本与保留图片逐字节一致。
  • 123 处新引用均指向存在的文件。
  • 中英文 MkDocs 文档构建通过(mkdocs-ci.yml,ENABLE_GIT_PLUGINS=false)。
  • git diff --check 通过。

影响

这项改动减少工作区和源码归档中的重复文件,不会自动清除 Git 历史中的旧对象。源码、字体、模型和测试输入未修改。

删除图片的旧路径不再存在;仓库内涉及的引用已更新,仓库外使用这些旧路径的直接链接需要迁移。现有构建中的其他链接问题未在本次处理。

@cuicheng01
cuicheng01 merged commit dab3fe3 into PaddlePaddle:main Sep 16, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant