如果 GitHub Pages 网站的存储库包含子模块，则在构建网站时会自动提取其内容。
您只能使用指向公共存储库的子模块，因为 GitHub Pages 服务器无法访问私有存储库。
对您的子模块（包括嵌套的子模块）使用 https:// 只读 URL。您可以在 .gitmodules 文件中进行此更改。
进一步阅读
- 来自 Pro Git 书籍的“Git 工具 - 子模块”
- “排查 GitHub Pages 网站的 Jekyll 构建错误”
在 GitHub Pages 中使用子模块
您可以使用子模块将其他项目包含到网站的代码中。
谁可以使用此功能？
GitHub Pages 可用于包含 GitHub Free 和 GitHub Free for organizations 的公共存储库，以及包含 GitHub Pro、GitHub Team、GitHub Enterprise Cloud 和 GitHub Enterprise Server 的公共和私有存储库。有关详细信息，请参阅“GitHub 的套餐”。
GitHub Pages 现在使用 GitHub Actions 执行 Jekyll 构建。当使用分支作为构建源时，如果要使用内置的 Jekyll 工作流，则必须在存储库中启用 GitHub Actions。或者，如果 GitHub Actions 不可用或已禁用，则将 .nojekyll 文件添加到源分支的根目录将绕过 Jekyll 构建过程并直接部署内容。有关启用 GitHub Actions 的更多信息，请参阅“管理存储库的 GitHub Actions 设置”。