Update meta data of docs

2026-09-20 04:58:52 +00:00 · 2024-08-06 16:44:42 -07:00
parent 4917bd18ae
commit af22422e1a
861 changed files with 1383 additions and 7148 deletions
@@ -1,16 +1,9 @@
 ---
 date: "2023-05-24T15:00:00+08:00"
-title: "Act Runner"
+
 slug: "act-runner"
 sidebar_position: 20
-draft: false
-toc: false
-menu:
-  sidebar:
-    parent: "actions"
-    name: "Act Runner"
-    sidebar_position: 20
-    identifier: "actions-runner"
+
 ---

 # Act Runner
@@ -1,16 +1,9 @@
 ---
 date: "2023-05-24T15:00:00+08:00"
-title: "与GitHub Actions的对比"
+
 slug: "comparison"
 sidebar_position: 30
-draft: false
-toc: false
-menu:
-  sidebar:
-    parent: "actions"
-    name: "对比"
-    sidebar_position: 30
-    identifier: "actions-comparison"
+
 ---

 # 与GitHub Actions的对比
@@ -1,16 +1,9 @@
 ---
 date: "2023-05-24T15:00:00+08:00"
-title: "Gitea Actions设计"
+
 slug: "design"
 sidebar_position: 40
-draft: false
-toc: false
-menu:
-  sidebar:
-    parent: "actions"
-    name: "设计"
-    sidebar_position: 40
-    identifier: "actions-design"
+
 ---

 # Gitea Actions设计
@@ -1,16 +1,7 @@
 ---
 date: "2023-05-24T15:00:00+08:00"
-title: "Gitea Actions常见问题解答"
 slug: "faq"
 sidebar_position: 100
-draft: false
-toc: false
-menu:
-  sidebar:
-    parent: "actions"
-    name: "常见问题"
-    sidebar_position: 100
-    identifier: "actions-faq"
 ---

 # Gitea Actions常见问题解答
@@ -1,16 +1,7 @@
 ---
 date: "2023-05-24T15:00:00+08:00"
-title: "Gitea Actions"
 slug: "overview"
 sidebar_position: 1
-draft: false
-toc: false
-menu:
-  sidebar:
-    parent: "actions"
-    name: "Overview"
-    sidebar_position: 1
-    identifier: "actions-overview"
 ---

 # Gitea Actions
@@ -1,16 +1,9 @@
 ---
 date: "2023-05-24T15:00:00+08:00"
-title: "快速入门"
+
 slug: "quickstart"
 sidebar_position: 10
-draft: false
-toc: false
-menu:
-  sidebar:
-    parent: "actions"
-    name: "快速入门"
-    sidebar_position: 10
-    identifier: "actions-quickstart"
+
 ---

 # 快速入门
@@ -1,18 +1,12 @@
 ---
 date: "2023-05-23T09:00:00+08:00"
-title: "Agit 设置"
+
 slug: "agit-setup"
 sidebar_position: 12
-toc: false
-draft: false
+
 aliases:
  - /zh-cn/agit-setup
-menu:
-  sidebar:
-    parent: "usage"
-    name: "Agit 设置"
-    sidebar_position: 12
-    identifier: "agit-setup"
+
 ---

 # Agit 设置
@@ -1,18 +1,12 @@
 ---
 date: "2016-12-01T16:00:00+02:00"
-title: "认证"
+
 slug: "authentication"
 sidebar_position: 10
-toc: false
-draft: false
+
 aliases:
  - /zh-cn/authentication
-menu:
-  sidebar:
-    parent: "usage"
-    name: "认证"
-    sidebar_position: 10
-    identifier: "authentication"
+
 ---

 # 认证
@@ -1,18 +1,11 @@
 ---
 date: "2023-05-23T09:00:00+08:00"
-title: "克隆过滤器 (部分克隆)"
+
 slug: "clone-filters"
 sidebar_position: 25
-draft: false
-toc: false
 aliases:
  - /zh-cn/clone-filters
-menu:
-  sidebar:
-    parent: "usage"
-    name: "克隆过滤器"
-    sidebar_position: 25
-    identifier: "clone-filters"
+
 ---

 # 克隆过滤器 (部分克隆)
@@ -1,18 +1,11 @@
 ---
 date: "2023-05-23T09:00:00+08:00"
-title: "邮件接收"
+
 slug: "incoming-email"
 sidebar_position: 13
-draft: false
-toc: false
 aliases:
  - /zh-cn/incoming-email
-menu:
-  sidebar:
-    parent: "usage"
-    name: "邮件接收"
-    sidebar_position: 13
-    identifier: "incoming-email"
+
 ---

 # 邮件接收
@@ -1,18 +1,10 @@
 ---
 date: "2022-09-07T16:00:00+08:00"
-title: "工单与合并请求模板"
 slug: "issue-pull-request-templates"
 sidebar_position: 15
 toc: true
-draft: false
 aliases:
  - /zh-cn/issue-pull-request-templates
-menu:
-  sidebar:
-    parent: "usage"
-    name: "工单与合并请求模板"
-    sidebar_position: 15
-    identifier: "issue-pull-request-templates"
 ---

 # 从模板创建工单与合并请求
@@ -1,18 +1,12 @@
 ---
 date: "2023-05-23T09:00:00+08:00"
-title: "标签"
+
 slug: "labels"
 sidebar_position: 13
-toc: false
-draft: false
+
 aliases:
  - /zh-cn/labels
-menu:
-  sidebar:
-    parent: "usage"
-    name: "标签"
-    sidebar_position: 13
-    identifier: "labels"
+
 ---

 # 标签
@@ -1,21 +1,15 @@
 ---
 date: "2023-05-23T09:00:00+08:00"
-title: "自动链接引用"
+
 slug: "automatically-linked-references"
 sidebar_position: 15
-toc: false
-draft: false
+
 aliases:
  - /zh-cn/automatically-linked-references
-menu:
-  sidebar:
-    parent: "usage"
-    name: "自动链接引用s"
-    sidebar_position: 15
-    identifier: "automatically-linked-references"
+
 ---

-# 在工单、合并请求和提交消息中的自动链接引用
+# 自动链接引用

 当发布工单、合并请求或评论时，文本描述会被解析以查找引用。这些引用将显示为工单视图中的链接，并且在某些情况下会触发特定的“操作”。

@@ -1,18 +1,12 @@
 ---
 date: "2023-05-23T09:00:00+08:00"
-title: "合并消息模板"
+
 slug: "merge-message-templates"
 sidebar_position: 15
-toc: false
-draft: false
+
 aliases:
  - /zh-cn/merge-message-templates
-menu:
-  sidebar:
-    parent: "usage"
-    name: "合并消息模板"
-    sidebar_position: 15
-    identifier: "merge-message-templates"
+
 ---

 # 合并消息模板
@@ -1,15 +1,8 @@
 ---
 date: "2023-03-25T00:00:00+00:00"
-title: "Alpine 软件包注册表"
+
 slug: "alpine"
-draft: false
-toc: false
-menu:
-  sidebar:
-    parent: "packages"
-    name: "Alpine"
-    sidebar_position: 4
-    identifier: "alpine"
+
 ---

 # Alpine 软件包注册表
@@ -1,16 +1,9 @@
 ---
 date: "2022-11-20T00:00:00+00:00"
-title: "Cargo 软件包注册表"
+
 slug: "cargo"
 sidebar_position: 5
-draft: false
-toc: false
-menu:
-  sidebar:
-    parent: "packages"
-    name: "Cargo"
-    sidebar_position: 5
-    identifier: "cargo"
+
 ---

 # Cargo 软件包注册表
@@ -1,19 +1,12 @@
 ---
 date: "2023-01-20T00:00:00+00:00"
-title: "Chef 软件包注册表"
+
 slug: "chef"
 sidebar_position: 5
-draft: false
-toc: false
-menu:
-  sidebar:
-    parent: "packages"
-    name: "Chef"
-    sidebar_position: 5
-    identifier: "chef"
+
 ---

-# Chef Package Registry
+# Chef 软件包注册表

 为您的用户或组织发布 [Chef](https://chef.io/) cookbooks。

@@ -1,16 +1,9 @@
 ---
 date: "2021-07-20T00:00:00+00:00"
-title: "Composer 软件包注册表"
+
 slug: "composer"
 sidebar_position: 10
-draft: false
-toc: false
-menu:
-  sidebar:
-    parent: "packages"
-    name: "Composer"
-    sidebar_position: 10
-    identifier: "composer"
+
 ---

 # Composer 软件包注册表
@@ -1,16 +1,9 @@
 ---
 date: "2021-07-20T00:00:00+00:00"
-title: "Conan 软件包注册表"
+
 slug: "conan"
 sidebar_position: 20
-draft: false
-toc: false
-menu:
-  sidebar:
-    parent: "packages"
-    name: "Conan"
-    sidebar_position: 20
-    identifier: "conan"
+
 ---

 # Conan 软件包注册表
@@ -1,16 +1,7 @@
 ---
 date: "2022-12-28T00:00:00+00:00"
-title: "Conda 软件包注册表"
 slug: "conda"
 sidebar_position: 25
-draft: false
-toc: false
-menu:
-  sidebar:
-    parent: "packages"
-    name: "Conda"
-    sidebar_position: 25
-    identifier: "conda"
 ---

 # Conda 软件包注册表
@@ -1,16 +1,9 @@
 ---
 date: "2021-07-20T00:00:00+00:00"
-title: "容器注册表"
+
 slug: "container"
 sidebar_position: 30
-draft: false
-toc: false
-menu:
-  sidebar:
-    parent: "packages"
-    name: "容器"
-    sidebar_position: 30
-    identifier: "container"
+
 ---

 # 容器注册表
@@ -1,15 +1,8 @@
 ---
 date: "2023-01-01T00:00:00+00:00"
-title: "CRAN 软件包注册表"
+
 slug: "cran"
-draft: false
-toc: false
-menu:
-  sidebar:
-    parent: "packages"
-    name: "CRAN"
-    sidebar_position: 35
-    identifier: "cran"
+
 ---

 # CRAN 软件包注册表
@@ -1,15 +1,6 @@
 ---
 date: "2023-01-07T00:00:00+00:00"
-title: "Debian 软件包注册表"
 slug: "debian"
-draft: false
-toc: false
-menu:
-  sidebar:
-    parent: "packages"
-    name: "Debian"
-    sidebar_position: 35
-    identifier: "debian"
 ---

 # Debian 软件包注册表
@@ -1,16 +1,7 @@
 ---
 date: "2021-07-20T00:00:00+00:00"
-title: "通用软件包注册表"
 slug: "generic"
 sidebar_position: 40
-draft: false
-toc: false
-menu:
-  sidebar:
-    parent: "packages"
-    name: "通用"
-    sidebar_position: 40
-    identifier: "generic"
 ---

 # 通用软件包注册表
@@ -1,16 +1,7 @@
 ---
 date: "2023-05-10T00:00:00+00:00"
-title: "Go 软件包注册表"
 slug: "go"
 sidebar_position: 45
-draft: false
-toc: false
-menu:
-  sidebar:
-    parent: "packages"
-    name: "Go"
-    sidebar_position: 45
-    identifier: "go"
 ---

 # Go 软件包注册表
@@ -1,16 +1,9 @@
 ---
 date: "2022-04-14T00:00:00+00:00"
-title: "Helm Chart 注册表"
+
 slug: "helm"
 sidebar_position: 50
-draft: false
-toc: false
-menu:
-  sidebar:
-    parent: "packages"
-    name: "Helm"
-    sidebar_position: 50
-    identifier: "helm"
+
 ---

 # Helm Chart 注册表
@@ -1,16 +1,7 @@
 ---
 date: "2021-07-20T00:00:00+00:00"
-title: "Maven 软件包注册表"
 slug: "maven"
 sidebar_position: 60
-draft: false
-toc: false
-menu:
-  sidebar:
-    parent: "packages"
-    name: "Maven"
-    sidebar_position: 60
-    identifier: "maven"
 ---

 # Maven 软件包注册表
@@ -1,16 +1,7 @@
 ---
 date: "2021-07-20T00:00:00+00:00"
-title: "npm 软件包注册表"
 slug: "npm"
 sidebar_position: 70
-draft: false
-toc: false
-menu:
-  sidebar:
-    parent: "packages"
-    name: "npm"
-    sidebar_position: 70
-    identifier: "npm"
 ---

 # npm Package Registry
@@ -1,16 +1,7 @@
 ---
 date: "2021-07-20T00:00:00+00:00"
-title: "NuGet 软件包注册表"
 slug: "nuget"
 sidebar_position: 80
-draft: false
-toc: false
-menu:
-  sidebar:
-    parent: "packages"
-    name: "NuGet"
-    sidebar_position: 80
-    identifier: "nuget"
 ---

 # NuGet 软件包注册表
@@ -1,16 +1,9 @@
 ---
 date: "2021-07-20T00:00:00+00:00"
-title: "软件包注册表"
+
 slug: "overview"
 sidebar_position: 1
-draft: false
-toc: false
-menu:
-  sidebar:
-    parent: "packages"
-    name: "Overview"
-    sidebar_position: 1
-    identifier: "packages-overview"
+
 ---

 # 软件包注册表
@@ -1,16 +1,9 @@
 ---
 date: "2022-07-31T00:00:00+00:00"
-title: "Pub 软件包注册表"
+
 slug: "pub"
 sidebar_position: 90
-draft: false
-toc: false
-menu:
-  sidebar:
-    parent: "packages"
-    name: "Pub"
-    sidebar_position: 90
-    identifier: "pub"
+
 ---

 # Pub 软件包注册表
@@ -1,16 +1,9 @@
 ---
 date: "2021-07-20T00:00:00+00:00"
-title: "PyPI 软件包注册表"
+
 slug: "pypi"
 sidebar_position: 100
-draft: false
-toc: false
-menu:
-  sidebar:
-    parent: "packages"
-    name: "PyPI"
-    sidebar_position: 100
-    identifier: "pypi"
+
 ---

 # PyPI 软件包注册表
@@ -1,15 +1,6 @@
 ---
 date: "2023-03-08T00:00:00+00:00"
-title: "RPM 软件包注册表"
 slug: "packages/rpm"
-draft: false
-toc: false
-menu:
-  sidebar:
-    parent: "packages"
-    name: "RPM"
-    sidebar_position: 105
-    identifier: "rpm"
 ---

 # RPM 软件包注册表
@@ -1,16 +1,9 @@
 ---
 date: "2021-07-20T00:00:00+00:00"
-title: "RubyGems 软件包注册表"
+
 slug: "rubygems"
 sidebar_position: 110
-draft: false
-toc: false
-menu:
-  sidebar:
-    parent: "packages"
-    name: "RubyGems"
-    sidebar_position: 110
-    identifier: "rubygems"
+
 ---

 # RubyGems 软件包注册表
@@ -1,16 +1,9 @@
 ---
 date: "2022-11-01T00:00:00+00:00"
-title: "存储"
+
 slug: "storage"
 sidebar_position: 5
-draft: false
-toc: false
-menu:
-  sidebar:
-    parent: "packages"
-    name: "Storage"
-    sidebar_position: 2
-    identifier: "storage"
+
 ---

 # 存储
@@ -1,16 +1,9 @@
 ---
 date: "2023-01-10T00:00:00+00:00"
-title: "Swift 软件包注册表"
+
 slug: "swift"
 sidebar_position: 95
-draft: false
-toc: false
-menu:
-  sidebar:
-    parent: "packages"
-    name: "Swift"
-    sidebar_position: 95
-    identifier: "swift"
+
 ---

 # Swift 软件包注册表
@@ -1,16 +1,9 @@
 ---
 date: "2022-08-23T00:00:00+00:00"
-title: "Vagrant 软件包注册表"
+
 slug: "vagrant"
 sidebar_position: 120
-draft: false
-toc: false
-menu:
-  sidebar:
-    parent: "packages"
-    name: "Vagrant"
-    sidebar_position: 120
-    identifier: "vagrant"
+
 ---

 # Vagrant 软件包注册表
@@ -1,18 +1,12 @@
 ---
 date: "2023-05-23T09:00:00+08:00"
-title: "权限"
+
 slug: "permissions"
 sidebar_position: 14
-toc: false
-draft: false
+
 aliases:
  - /zh-cn/permissions
-menu:
-  sidebar:
-    parent: "usage"
-    name: "权限"
-    sidebar_position: 14
-    identifier: "permissions"
+
 ---

 # 权限
@@ -1,16 +1,7 @@
 ---
 date: "2023-05-23T09:00:00+08:00"
-title: "个人资料 README"
 slug: "profile-readme"
 sidebar_position: 12
-toc: false
-draft: false
-menu:
-  sidebar:
-    parent: "usage"
-    name: "个人资料 README"
-    sidebar_position: 12
-    identifier: "profile-readme"
 ---

 # 个人资料 README
@@ -1,18 +1,12 @@
 ---
 date: "2023-05-23T09:00:00+08:00"
-title: "受保护的标签"
+
 slug: "protected-tags"
 sidebar_position: 45
-toc: false
-draft: false
+
 aliases:
  - /zh-cn/protected-tags
-menu:
-  sidebar:
-    parent: "usage"
-    name: "受保护的标签"
-    sidebar_position: 45
-    identifier: "protected-tags"
+
 ---

 # 受保护的标签
@@ -1,18 +1,9 @@
 ---
 date: "2018-06-01T19:00:00+02:00"
-title: "合并请求"
 slug: "pull-request"
 sidebar_position: 13
-toc: false
-draft: false
 aliases:
  - /zh-cn/pull-request
-menu:
-  sidebar:
-    parent: "usage"
-    name: "Pull Request"
-    sidebar_position: 13
-    identifier: "pull-request"
 ---

 # 合并请求
@@ -1,35 +1,28 @@
 ---
 date: "2023-05-23T09:00:00+08:00"
-title: "推送"
 slug: "push"
 sidebar_position: 15
-toc: false
-draft: false
 aliases:
  - /zh-cn/push-to-create
  - /zh-cn/push-options
-menu:
-  sidebar:
-    parent: "usage"
-    name: "推送"
-    sidebar_position: 15
-    identifier: "push"
 ---

+# 推送
+
 在将提交推送到 Gitea 服务器时，还有一些额外的功能。

-# 通过推送打开 PR
+## 通过推送打开 PR

 当您第一次将提交推送到非默认分支时，您将收到一个链接，您可以单击该链接访问分支与主分支的比较页面。
 从那里，您可以轻松创建一个拉取请求，即使您想要将其目标指向另一个分支。

 ![Gitea 推送提示](/gitea-push-hint.png)

-# 推送选项
+## 推送选项

 在 Gitea `1.13` 版本中，添加了对一些 [推送选项](https://git-scm.com/docs/git-push#Documentation/git-push.txt--oltoptiongt) 的支持。

-## 支持的选项
+### 支持的选项

 - `repo.private` (true|false) - 更改仓库的可见性。

@@ -43,15 +36,15 @@ menu:
 git push -o repo.private=false -u origin main
 ```

-# 推送创建
+## 推送创建

 推送创建是一项功能，允许您将提交推送到在 Gitea 中尚不存在的仓库。这对于自动化和允许用户创建仓库而无需通过 Web 界面非常有用。此功能默认处于禁用状态。

-## 启用推送创建
+### 启用推送创建

 在 `app.ini` 文件中，将 `ENABLE_PUSH_CREATE_USER` 设置为 `true`，如果您希望允许用户在自己的用户帐户和所属的组织中创建仓库，将 `ENABLE_PUSH_CREATE_ORG` 设置为 `true`。重新启动 Gitea 以使更改生效。您可以在 [配置速查表](../administration/config-cheat-sheet.md#仓库) 中了解有关这两个选项的更多信息。

-## 使用推送创建
+### 使用推送创建

 假设您在当前目录中有一个 git 仓库，您可以通过运行以下命令将提交推送到在 Gitea 中尚不存在的仓库：

@@ -1,18 +1,12 @@
 ---
 date: "2023-05-23T09:00:00+08:00"
-title: "仓库镜像"
+
 slug: "repo-mirror"
 sidebar_position: 45
-toc: false
-draft: false
+
 aliases:
  - /zh-cn/repo-mirror
-menu:
-  sidebar:
-    parent: "usage"
-    name: "仓库镜像"
-    sidebar_position: 45
-    identifier: "repo-mirror"
+
 ---

 # 仓库镜像
@@ -1,18 +1,9 @@
 ---
 date: "2023-05-23T09:00:00+08:00"
-title: "密钥管理"
 slug: "secrets"
 sidebar_position: 50
-draft: false
-toc: false
 aliases:
  - /zh-cn/secrets
-menu:
-  sidebar:
-    parent: "usage"
-    name: "密钥管理"
-    sidebar_position: 50
-    identifier: "usage-secrets"
 ---

 # 密钥管理
@@ -20,7 +11,7 @@ menu:
 密钥管理允许您在用户、组织或仓库中存储敏感信息。
 密钥管理在 Gitea 1.19+ 版本中可用。

-# 设置密钥名称
+## 设置密钥名称

 以下规则适用于密钥名称：

@@ -1,18 +1,12 @@
 ---
 date: "2023-05-23T09:00:00+08:00"
-title: "模板仓库"
+
 slug: "template-repositories"
 sidebar_position: 14
-toc: false
-draft: false
+
 aliases:
  - /zh-cn/template-repositories
-menu:
-  sidebar:
-    parent: "usage"
-    name: "模板仓库"
-    sidebar_position: 14
-    identifier: "template-repositories"
+
 ---

 # 模板仓库
@@ -1,18 +1,9 @@
 ---
 date: "2016-12-01T16:00:00+02:00"
-title: "Webhooks"
 slug: "webhooks"
 sidebar_position: 30
-toc: false
-draft: false
 aliases:
  - /zh-cn/webhooks
-menu:
-  sidebar:
-    parent: "usage"
-    name: "Webhooks"
-    sidebar_position: 30
-    identifier: "webhooks"
 ---

 # Webhooks
@@ -31,9 +22,13 @@ Gitea支持用于仓库事件的Webhooks。这可以在仓库管理员在设置
 - Wechatwork（企业微信）
 - Packagist

-### 事件信息
+## 事件信息

-**警告**：自 Gitea 1.13.0 版起，payload 中的 `secret` 字段已被弃用，并将在 1.14.0 版中移除：https://github.com/go-gitea/gitea/issues/11755
+:::warning
+
+自 Gitea 1.13.0 版起，payload 中的 `secret` 字段已被弃用，并将在 1.14.0 版中移除：https://github.com/go-gitea/gitea/issues/11755
+
+:::

 以下是 Gitea 将发送给 payload URL的事件信息示例：

@@ -117,7 +112,7 @@ X-Gitea-Event: push
 }
 ```

-### 示例
+## 示例

 这是一个示例，演示如何使用 Webhooks 在推送请求到达仓库时运行一个 php 脚本。
 在你的仓库设置中，在 Webhooks 下，设置一个如下的 Gitea webhook：
@@ -189,6 +184,6 @@ if (json_last_error() !== JSON_ERROR_NONE) {

 在 Webhook 设置中有一个“测试推送（Test Delivery）”按钮，可以测试配置，还有一个“最近推送记录（Recent Deliveries）”的列表。

-### 授权头（Authorization header）
+## 授权头（Authorization header）

 **从1.19版本开始**，Gitea 的 Webhook 可以配置为向 Webhook 目标发送一个 [授权头（authorization header）](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Authorization)。