mirror of
https://gitea.com/gitea/docs.git
synced 2026-06-26 14:16:22 +00:00
Reviewed-on: https://gitea.com/gitea/docs/pulls/265 Reviewed-by: Lunny Xiao <xiaolunwen@gmail.com> Co-authored-by: ifurther <55025025+ifurther@users.noreply.github.com> Co-committed-by: ifurther <55025025+ifurther@users.noreply.github.com>
1.7 KiB
1.7 KiB
date, slug, sidebar_position, aliases
| date | slug | sidebar_position | aliases | |
|---|---|---|---|---|
| 2023-05-23T09:00:00+08:00 | agit | 12 |
|
AGit
在 Gitea 1.13 版本中,添加了对 AGit 的支持。AGit 允许使用者在没有存放庫写入权限的情况下直接建立拉取請求,也不需要分叉存放庫。这有助于减少重复存放庫的数量,降低不必要的硬碟使用量。
:::note 服务器端需要 Git 版本 2.29 或更高版本才能正常运行。 :::
使用 AGit 建立 PR
AGit 允许在推送代码到远程存放庫时建立 PR(合並請求)。 通過在推送时使用特定的 refspec(git 中已知的位置标识符),可以实現这一功能。 下面的示例说明了这一点:
git push origin HEAD:refs/for/main
該命令的结构如下:
HEAD:目标分支refs/<for|draft|for-review>/<branch>:目标 PR 類型for:建立一个以<branch>為目标分支的普通 PRdraft/for-review:目前被静默忽略
<branch>/<session>:要打开 PR 的目标分支-o <topic|title|description>:PR 的選项title:PR 的标题topic:PR 應該打开的分支名稱description:PR 的描述force-push=true: 是否强制更新目标分支- 注意: 如果不传值,只用
-o force-push也同样可以正常工作。
- 注意: 如果不传值,只用
下面是另一个高级示例,用于建立一个以 topic、title 和 description 為參數的新 PR,目标分支是 main:
git push origin HEAD:refs/for/main -o topic="Topic of my PR" -o title="Title of the PR" -o description="# The PR Description\nThis can be **any** markdown content.\n- [x] Ok"