跳到主要内容
版本：Next

仓库模板使用指南

访问模板仓库​

有两种方式可以访问模板仓库：

  1. 通过URL参数

    • 在仓库URL后添加?template=true
    • 例如：https://gitlink.org/org/repo?template=true

  2. 通过界面入口

    • 点击"新建仓库"按钮
    • 选择"从模板创建"选项

创建模板仓库​

将仓库设置为模板​

  1. 进入仓库设置
  2. 找到"仓库类型"选项
  3. 勾选"将此仓库设置为模板"
  4. 保存设置

模板仓库特性​

  • 不能被直接推送代码
  • 可以被任何人用作模板
  • 保持干净的提交历史
  • 支持自定义初始化配置

使用模板创建仓库​

基本步骤​

  1. 访问模板仓库
  2. 点击"使用此模板"按钮
  3. 填写新仓库信息
  4. 选择要包含的分支
  5. 确认创建

自定义选项​

  • 选择性复制分支
  • 包含所有标签
  • 复制Issue模板
  • 保留提交历史

最佳实践​

模板仓库结构​

template-repo/
├── .gitlink/
│   ├── ISSUE_TEMPLATE/
│   └── PR_TEMPLATE/
├── docs/
│   └── README.md
├── src/
├── tests/
├── .gitignore
└── README.md

推荐配置​

  1. 添加详细的README
  2. 包含必要的配置文件
  3. 提供示例代码
  4. 设置Issue和PR模板
  5. 配置CI/CD模板

注意事项​

  1. 模板仓库应保持最小化
  2. 定期更新模板内容
  3. 提供清晰的使用文档
  4. 避免包含敏感信息