diff options
Diffstat (limited to 'docs/content/usage')
| -rw-r--r-- | docs/content/usage/permissions.zh-cn.md | 39 | ||||
| -rw-r--r-- | docs/content/usage/pull-request.zh-cn.md | 40 | ||||
| -rw-r--r-- | docs/content/usage/repo-mirror.zh-cn.md | 13 | ||||
| -rw-r--r-- | docs/content/usage/template-repositories.zh-cn.md | 2 |
4 files changed, 82 insertions, 12 deletions
diff --git a/docs/content/usage/permissions.zh-cn.md b/docs/content/usage/permissions.zh-cn.md index 5e1688f7ac..0c748aef96 100644 --- a/docs/content/usage/permissions.zh-cn.md +++ b/docs/content/usage/permissions.zh-cn.md @@ -29,10 +29,12 @@ Gitea 支持对仓库进行权限管理，这样您就可以为不同的人员 | 工单 | 组织缺陷报告、任务和里程碑。 | 读取 写入 | | 合并请求 | 启用合并请求和代码审核。 | 读取 写入 | | 发布 | 跟踪项目版本和下载。 | 读取 写入 | -| 维基 | 与协作者编写和共享文档。 | 读取 写入 | -| 外部维基 | 链接到外部维基。 | 读取 | +| 百科 | 与协作者编写和共享文档。 | 读取 写入 | +| 外部百科 | 链接到外部维基。 | 读取 | | 外部工单跟踪器 | 链接到外部工单跟踪器。 | 读取 | | 项目 | 模板仓库的 URL。 | 读取 写入 | +| 包 | 链接到仓库 | 读取 写入 | +| Actions | 审查Actions日志或重启/取消工作流 | 读取 写入 | | 设置 | 管理仓库。 | 管理员 | 通过不同的权限，用户可以在这些单元上执行不同的操作。 @@ -43,25 +45,42 @@ Gitea 支持对仓库进行权限管理，这样您就可以为不同的人员 | 工单 | 查看工单并创建新工单。 | 添加标签、分配、关闭工单。 | - | | 合并请求 | 查看合并请求并创建新合并请求。 | 添加标签、分配、关闭合并请求。 | - | | 发布 | 查看发布和下载文件。 | 创建/编辑发布。 | - | -| 维基 | 查看维基页面。克隆维基仓库。 | 创建/编辑维基页面，推送更改。 | - | -| 外部维基 | 链接到外部维基。 | - | - | +| 百科 | 查看百科页面。克隆百科仓库。 | 创建/编辑百科页面，推送更改。 | - | +| 外部百科 | 链接到外部百科。 | - | - | | 外部工单跟踪器 | 链接到外部工单跟踪器。 | - | - | | 项目 | 查看面板。 | 在面板之间移动工单。 | - | +| 包 | 查看包 | 上传/删除包 | - | +| Actions | 查看 Actions日志 | 同意 / 取消 / 重启 | - | | 设置 | - | - | 管理仓库 | 个人仓库和组织仓库之间的权限存在一些差异。 ## 个人仓库 -对于个人仓库，创建者是仓库的唯一所有者，对于该仓库的任何更改或删除没有限制。仓库所有者可以添加协作者来帮助维护仓库。协作者可以拥有 `读取（Read）`、`写入（Write）` 和 `管理员（Admin）` 权限。 +对于个人仓库，创建者是仓库的唯一所有者，对于该仓库的任何更改或删除没有限制。 +仓库所有者可以添加协作者来帮助维护仓库。协作者可以拥有 `读取（Read）`、`写入（Write）` 和 `管理员（Admin）` 权限。 + +访问私有仓库的体验与访问匿名公共仓库类似。您可以访问仓库中的所有可用内容，包括克隆代码、创建工单、回复工单评论、提交拉取请求等。如果你有 "写"权限，只要分支保护规则允许，你就可以向仓库的特定分支推送代码。此外，你还可以修改百科页面。有了 "管理"权限，你就可以修改仓库的设置。 + +但如果你不是该仓库的所有者，就不能删除或转移该仓库。 ## 组织仓库 -与个人仓库不同，组织仓库的所有者是组织的所有者团队。 +对于个人仓库，所有者是创建它的用户。而对于组织仓库，所有者是该组织中的所有者团队成员。对该组织仓库的所有权限都取决于团队权限设置。 + +### 所有者团队 + +创建组织时将自动创建所有者团队，创建者将成为所有者团队的第一名成员。所有者团队不可删除，且至少有一名成员。 + +### 管理员团队 + +创建团队时，有两种类型的团队。一种是管理员团队，另一种是普通团队。可以创建一个管理员团队来管理某些版本库，其成员可以对这些版本库做任何事情。只有所有者或管理员团队的成员才能创建新团队。 + +### 普通团队 -### 团队 +组织中的普通团队具有可以根据`单元(Unit)`进行权限设置。它可以有成员和存储库范围。 -组织中的一个团队具有单元权限设置。它可以拥有成员和仓库的范围。团队可以访问组织中的所有仓库或者由所有者团队授权访问的特定仓库。团队也可以被允许创建新的仓库。 +- 一个团队可以访问所属组织的所有仓库或特殊仓库。 +- 也可以设置该团队是否有创建新仓库的权限。 -所有者团队（Owners）将在创建组织时自动创建，并且创建者将成为所有者团队的第一个成员。 -组织的每个成员必须至少属于一个团队。所有者团队不能被删除，只有所有者团队的成员可以创建新的团队。可以创建一个管理员团队来管理某些仓库，该团队的成员可以对这些仓库进行任何操作。可以由所有者团队创建一个生成团队来执行其权限允许的操作。 +可以通过创建 "普通团队"，并通过权限控制对其行为进行限制。一名成员可以加入多个团队。 diff --git a/docs/content/usage/pull-request.zh-cn.md b/docs/content/usage/pull-request.zh-cn.md index db5646f378..0a8cf55dff 100644 --- a/docs/content/usage/pull-request.zh-cn.md +++ b/docs/content/usage/pull-request.zh-cn.md @@ -17,9 +17,45 @@ menu: # 合并请求 -## 在`合并请求`中使用“Work In Progress”标记 +合并请求(PR)是一种提出对仓库进行更改的方式。 +它是一种将一个分支合并到另一个分支的请求，附带有对所做更改的描述。 +合并请求通常用作贡献者对仓库贡献代码的方式，仓库的维护者可以通过对合并请求进行审查来决定是否接受这些更改。 -您可以通过在一个进行中的 pull request 的标题上添加前缀 `WIP:` 或者 `[WIP]`（此处大小写敏感）来防止它被意外合并，具体的前缀设置可以在配置文件 `app.ini` 中找到： +## 创建合并请求 + +要创建合并请求，您需要遵循以下步骤： + +1. **Fork 仓库** - 如果您没有直接对仓库进行更改的权限，您需要将仓库 fork 到您自己的账户中。 +这将创建一个您可以对其进行更改的仓库副本。 + +2. **创建分支（可选）** - 在 fork 的仓库中创建一个新分支，该分支包含您要提出的更改。 +给分支取一个描述性的名称，以指示更改的内容。 + +3. **进行更改** - 进行您想要的更改，提交并将其推送到 fork 的仓库中。 + +4. **创建合并请求** - 转到原始仓库并转到“合并请求”选项卡。单击“新建合并请求”按钮，并将您的新分支选择为源分支。 +为您的合并请求输入描述性标题和描述，然后单击“创建合并请求”。 + +## 评审合并请求 + +创建合并请求后，将触发评审流程。仓库的维护者将收到合并请求的通知，并可以审查所做的更改。 +他们可以留下评论、请求更改或批准更改。 + +如果维护者请求更改，您需要在分支中进行这些更改，并将更改推送到 fork 的仓库中。 +合并请求将自动使用新更改进行更新。 + +如果维护者批准更改，他们可以将合并请求合并到仓库中。 + +## 关闭合并请求 + +如果您不接受该合并请求，您可以关闭它。 +要关闭合并请求，请转到打开的合并请求并单击“关闭合并请求”按钮。这将关闭合并请求并且不会将其合并。 + +## 使用“Work In Progress”标记 + +在合并请求中使用“Work In Progress”标记可以防止合并请求被意外合并。 +要将合并请求标记为“Work In Progress”，您必须在其标题中添加前缀`WIP:`或`[WIP]`（不区分大小写）。 +标记前缀可以在您的`app.ini`文件中进行配置： ``` [repository.pull-request] diff --git a/docs/content/usage/repo-mirror.zh-cn.md b/docs/content/usage/repo-mirror.zh-cn.md index 3723b81ee4..b74a1b62ad 100644 --- a/docs/content/usage/repo-mirror.zh-cn.md +++ b/docs/content/usage/repo-mirror.zh-cn.md @@ -88,3 +88,16 @@ menu: 4. 选择**添加推送镜像**以保存配置。 仓库会很快进行推送。要强制推送，请选择**立即同步**按钮。 + +### 镜像现有的 ssh 仓库 + +当前，Gitea 不支持从 ssh 仓库进行镜像。如果您想要镜像一个 ssh 仓库，您需要将其转换为 http 仓库。您可以使用以下命令将现有的 ssh 仓库转换为 http 仓库： + +1. 确保运行 gitea 的用户有权限访问您试图从 shell 镜像到的 git 仓库。 +2. 在 Web 界面的版本库设置 > git 钩子中为镜像添加一个接收后钩子。 + +``` +#!/usr/bin/env bash +git push --mirror --quiet git@github.com:username/repository.git &>/dev/null & +echo "GitHub mirror initiated .." +``` diff --git a/docs/content/usage/template-repositories.zh-cn.md b/docs/content/usage/template-repositories.zh-cn.md index 68881e023b..885b2f4ec8 100644 --- a/docs/content/usage/template-repositories.zh-cn.md +++ b/docs/content/usage/template-repositories.zh-cn.md @@ -47,6 +47,8 @@ a/b/c/d.json 在与上述通配符匹配的任何文件中，将会扩展某些变量。 +文件名和路径的匹配也可以被扩展，并且会经过谨慎的清理处理，以支持跨平台的文件系统。 + 所有变量都必须采用`$VAR`或`${VAR}`的形式。要转义扩展，使用双重`$$`，例如`$$VAR`或`$${VAR}`。 | 变量 | 扩展为 | 可转换 | |