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
@@ -3,8 +3,7 @@ date: "2016-12-01T16:00:00+02:00"
 title: "运维"
 slug: "administration"
 sidebar_position: 30
-toc: false
-draft: false
+
 menu:
  sidebar:
    name: "运维"
@@ -1,20 +1,13 @@
 ---
 date: "2023-05-23T09:00:00+08:00"
-title: "添加法律页面"
 slug: adding-legal-pages
 sidebar_position: 110
-toc: false
-draft: false
 aliases:
  - /zh-cn/adding-legal-pages
-menu:
-  sidebar:
-    parent: "administration"
-    name: "添加法律页面"
-    identifier: "adding-legal-pages"
-    sidebar_position: 110
 ---

+# 添加法律页面
+
 一些法域（例如欧盟）要求在网站上添加特定的法律页面（例如隐私政策）。按照以下步骤将它们添加到你的 Gitea 实例中。

 ## 获取页面
@@ -1,18 +1,9 @@
 ---
 date: "2018-06-06T09:33:00+08:00"
-title: "备份与恢复"
 slug: "backup-and-restore"
 sidebar_position: 11
-toc: false
-draft: false
 aliases:
  - /zh-cn/backup-and-restore
-menu:
-  sidebar:
-    parent: "administration"
-    name: "备份与恢复"
-    sidebar_position: 11
-    identifier: "backup-and-restore"
 ---

 # 备份与恢复
@@ -1,18 +1,9 @@
 ---
 date: "2023-05-23T09:00:00+08:00"
-title: "嵌入资源提取工具"
 slug: "cmd-embedded"
 sidebar_position: 20
-toc: false
-draft: false
 aliases:
  - /zh-cn/cmd-embedded
-menu:
-  sidebar:
-    parent: "administration"
-    name: "嵌入资源提取工具"
-    sidebar_position: 20
-    identifier: "cmd-embedded"
 ---

 # 嵌入资源提取工具
@@ -1,18 +1,9 @@
 ---
 date: "2023-05-23T09:00:00+08:00"
-title: "Gitea 命令行"
 slug: "command-line"
 sidebar_position: 1
-toc: false
-draft: false
 aliases:
  - /zh-cn/command-line
-menu:
-  sidebar:
-    parent: "administration"
-    name: "Gitea 命令行"
-    sidebar_position: 1
-    identifier: "command-line"
 ---

 # 命令行
@@ -374,11 +365,11 @@ AuthorizedKeysCommand /path/to/gitea keys -e git -u %u -t %t -k %k

 ```go
 var checklist = []check{
-	{
-		title: "Check if OpenSSH authorized_keys file id correct",
-		f:     runDoctorLocationMoved,
-    },
-    // more checks please append here
+  {
+    title: "Check if OpenSSH authorized_keys file id correct",
+    f:     runDoctorLocationMoved,
+  },
+  // more checks please append here
 }
 ```

@@ -1,18 +1,9 @@
 ---
 date: "2016-12-26T16:00:00+02:00"
-title: "配置说明"
 slug: "config-cheat-sheet"
 sidebar_position: 30
-toc: false
-draft: false
 aliases:
  - /zh-cn/config-cheat-sheet
-menu:
-  sidebar:
-    parent: "administration"
-    name: "配置说明"
-    sidebar_position: 30
-    identifier: "config-cheat-sheet"
 ---

 # 配置说明
@@ -1,18 +1,9 @@
 ---
 date: "2017-04-15T14:56:00+02:00"
-title: "自定义 Gitea 配置"
 slug: "customizing-gitea"
 sidebar_position: 100
-toc: false
-draft: false
 aliases:
  - /zh-cn/customizing-gitea
-menu:
-  sidebar:
-    parent: "administration"
-    name: "自定义 Gitea 配置"
-    sidebar_position: 100
-    identifier: "customizing-gitea"
 ---

 # 自定义 Gitea 配置
@@ -1,18 +1,9 @@
 ---
 date: "2023-05-23T09:00:00+08:00"
-title: "Email 设置"
 slug: "email-setup"
 sidebar_position: 12
-toc: false
-draft: false
 aliases:
  - /zh-cn/email-setup
-menu:
-  sidebar:
-    parent: "administration"
-    name: "Email 设置"
-    sidebar_position: 12
-    identifier: "email-setup"
 ---

 # Email 设置
@@ -1,18 +1,9 @@
 ---
 date: "2017-04-08T11:34:00+02:00"
-title: "环境变量清单"
 slug: "environment-variables"
 sidebar_position: 10
-toc: false
-draft: false
 aliases:
  - /zh-cn/environment-variables
-menu:
-  sidebar:
-    parent: "administration"
-    name: "环境变量清单"
-    sidebar_position: 10
-    identifier: "environment-variables"
 ---

 # 环境变量清单
@@ -1,21 +1,12 @@
 ---
 date: "2023-05-23T09:00:00+08:00"
-title: "外部渲染器"
 slug: "external-renderers"
 sidebar_position: 60
-toc: false
-draft: false
 aliases:
  - /zh-cn/external-renderers
-menu:
-  sidebar:
-    parent: "administration"
-    name: "外部渲染器"
-    sidebar_position: 60
-    identifier: "external-renderers"
 ---

-# 自定义文件渲染配置
+# 外部渲染器

 Gitea 通过外部二进制文件支持自定义文件渲染（例如 Jupyter notebooks、asciidoc 等），只需要进行以下步骤：

@@ -1,21 +1,12 @@
 ---
 date: "2022-08-01T00:00:00+00:00"
-title: "设置 Fail2ban"
 slug: "fail2ban-setup"
 sidebar_position: 16
-toc: false
-draft: false
 aliases:
  - /zh-cn/fail2ban-setup
-menu:
-  sidebar:
-    parent: "administration"
-    name: "设置 Fail2ban"
-    sidebar_position: 16
-    identifier: "fail2ban-setup"
 ---

-# 使用 Fail2ban 阻止攻击者的暴力登录
+# 设置 Fail2ban

 **Fail2ban 检查客户端登录日志，将多次登录失败的客户端识别为攻击者并在一段时间内阻止其访问服务。如果你的实例是公开的，这一点尤其重要。请管理员仔细设置 fail2ban，错误的配置将导致防火墙阻止你访问自己的服务器。**

@@ -31,7 +22,7 @@ Gitea 会在日志文件 `log/gitea.log` 中记录登录失败的 CLI、SSH 或
 2020/10/15 16:08:44 [E] invalid credentials from xxx.xxx.xxx.xxx
 ```

-## 设置 Fail2ban
+## Fail2ban 规则

 添加日志过滤器规则到配置文件 `/etc/fail2ban/filter.d/gitea.conf`:

@@ -1,21 +1,12 @@
 ---
 date: "2023-05-23T09:00:00+08:00"
-title: "Git LFS 设置"
 slug: "git-lfs-setup"
 sidebar_position: 12
-toc: false
-draft: false
 aliases:
  - /zh-cn/git-lfs-setup
-menu:
-  sidebar:
-    parent: "administration"
-    name: "Git LFS 设置"
-    sidebar_position: 12
-    identifier: "git-lfs-setup"
 ---

-# 配置 Git 大文件存储（Large File Storage，LFS）
+# Git LFS 设置

 要使用 Gitea 内置的 LFS 支持，您需要更新 `app.ini` 文件：

@@ -2,14 +2,7 @@
 date: "2023-04-09T11:00:00+02:00"
 slug: "https-setup"
 sidebar_position: 12
-toc: false
-draft: false
-menu:
-  sidebar:
-    parent: "administration"
-    name: "HTTPS setup"
-    sidebar_position: 12
-    identifier: "https-setup"
+
 ---

 # HTTPS配置
@@ -1,18 +1,9 @@
 ---
 date: "2023-05-23T09:00:00+08:00"
-title: "日志配置"
 slug: "logging-config"
 sidebar_position: 40
-toc: false
-draft: false
 aliases:
  - /zh-cn/logging-configuration
-menu:
-  sidebar:
-    parent: "administration"
-    name: "日志配置"
-    sidebar_position: 40
-    identifier: "logging-config"
 ---

 # 日志配置
@@ -1,18 +1,12 @@
 ---
 date: "2023-05-23T09:00:00+08:00"
-title: "邮件模板"
+
 slug: "mail-templates"
 sidebar_position: 45
-toc: false
-draft: false
+
 aliases:
  - /zh-cn/mail-templates
-menu:
-  sidebar:
-    parent: "administration"
-    name: "邮件模板"
-    sidebar_position: 45
-    identifier: "mail-templates"
+
 ---

 # 邮件模板
@@ -1,18 +1,12 @@
 ---
 date: "2023-05-23T09:00:00+08:00"
-title: "仓库索引器"
+
 slug: "repo-indexer"
 sidebar_position: 45
-toc: false
-draft: false
+
 aliases:
  - /zh-cn/repo-indexer
-menu:
-  sidebar:
-    parent: "administration"
-    name: "仓库索引器"
-    sidebar_position: 45
-    identifier: "repo-indexer"
+
 ---

 # 仓库索引器
@@ -1,18 +1,12 @@
 ---
 date: "2018-05-22T11:00:00+00:00"
-title: "反向代理"
+
 slug: "reverse-proxies"
 sidebar_position: 16
-toc: false
-draft: false
+
 aliases:
  - /zh-cn/reverse-proxies
-menu:
-  sidebar:
-    parent: "administration"
-    name: "反向代理"
-    sidebar_position: 16
-    identifier: "reverse-proxies"
+
 ---

 # 反向代理
@@ -1,21 +1,15 @@
 ---
 date: "2023-05-23T09:00:00+08:00"
-title: "搜索引擎索引"
+
 slug: "search-engines-indexation"
 sidebar_position: 60
-toc: false
-draft: false
+
 aliases:
  - /zh-cn/search-engines-indexation
-menu:
-  sidebar:
-    parent: "administration"
-    name: "搜索引擎索引"
-    sidebar_position: 60
-    identifier: "search-engines-indexation"
+
 ---

-# Gitea 安装的搜索引擎索引
+# 搜索引擎索引

 默认情况下，您的 Gitea 安装将被搜索引擎索引。
 如果您不希望您的仓库对搜索引擎可见，请进一步阅读。
@@ -1,18 +1,12 @@
 ---
 date: "2023-05-23T09:00:00+08:00"
-title: "GPG 提交签名"
+
 slug: "signing"
 sidebar_position: 50
-toc: false
-draft: false
+
 aliases:
  - /zh-cn/signing
-menu:
-  sidebar:
-    parent: "administration"
-    name: "GPG 提交签名"
-    sidebar_position: 50
-    identifier: "signing"
+
 ---

 # GPG 提交签名
@@ -1,18 +1,12 @@
 ---
 date: "2023-05-25T23:41:00+08:00"
-title: "后端开发指南"
+
 slug: "guidelines-backend"
 sidebar_position: 20
-toc: false
-draft: false
+
 aliases:
  - /zh-cn/guidelines-backend
-menu:
-  sidebar:
-    parent: "contributing"
-    name: "后端开发指南"
-    sidebar_position: 20
-    identifier: "guidelines-backend"
+
 ---

 # 后端开发指南
@@ -1,18 +1,12 @@
 ---
 date: "2023-05-25T16:00:00+02:00"
-title: "前端开发指南"
+
 slug: "guidelines-frontend"
 sidebar_position: 20
-toc: false
-draft: false
+
 aliases:
  - /zh-cn/guidelines-frontend
-menu:
-  sidebar:
-    parent: "contributing"
-    name: "前端开发指南"
-    sidebar_position: 20
-    identifier: "guidelines-frontend"
+
 ---

 # 前端开发指南
@@ -1,18 +1,12 @@
 ---
 date: "2023-05-25T00:00:00+00:00"
-title: "重构指南"
+
 slug: "guidelines-refactoring"
 sidebar_position: 20
-toc: false
-draft: false
+
 aliases:
  - /zh-cn/guidelines-refactoring
-menu:
-  sidebar:
-    parent: "contributing"
-    name: "重构指南"
-    sidebar_position: 20
-    identifier: "guidelines-refactoring"
+
 ---

 # 重构指南
@@ -1,18 +1,9 @@
 ---
 date: "2016-12-01T16:00:00+02:00"
-title: "本地化"
 slug: "localization"
 sidebar_position: 70
-toc: false
-draft: false
 aliases:
  - /zh-cn/localization
-menu:
-  sidebar:
-    parent: "contributing"
-    name: "本地化"
-    sidebar_position: 70
-    identifier: "localization"
 ---

 # 本地化
@@ -1,17 +0,0 @@
---
-date: "2023-05-25T00:00:00+02:00"
-title: "翻译指南"
-sidebar_position: 70
-toc: true
-draft: false
-menu:
-  sidebar:
-    parent: "contributing"
-    name: "翻译指南"
-    sidebar_position: 70
-    identifier: "translation-guidelines"
---
-
-本页面用于提供一套通用规则，以确保翻译的一致性。
-
-* [German](/de-de/übersetzungs-richtlinien/)
@@ -3,8 +3,7 @@ date: "2016-12-01T16:00:00+02:00"
 title: "开发"
 slug: "development"
 sidebar_position: 40
-toc: false
-draft: false
+
 menu:
  sidebar:
    name: "开发"
@@ -1,21 +1,12 @@
 ---
 date: "2018-06-24:00:00+02:00"
-title: "API 使用指南"
 slug: "api-usage"
 sidebar_position: 40
-toc: false
-draft: false
 aliases:
  - /zh-cn/api-usage
-menu:
-  sidebar:
-    parent: "development"
-    name: "API 使用指南"
-    sidebar_position: 40
-    identifier: "api-usage"
 ---

-# Gitea API 使用指南
+# API 使用指南

 ## 开启/配置 API 访问

@@ -1,18 +1,12 @@
 ---
 date: "2016-12-01T16:00:00+02:00"
-title: "玩转 Gitea"
+
 slug: "hacking-on-gitea"
 sidebar_position: 10
-toc: false
-draft: false
+
 aliases:
  - /zh-cn/hacking-on-gitea
-menu:
-  sidebar:
-    parent: "development"
-    name: "玩转 Gitea"
-    sidebar_position: 10
-    identifier: "hacking-on-gitea"
+
 ---

 # Hacking on Gitea
@@ -1,18 +1,9 @@
 ---
 date: "2023-05-25T17:29:00+08:00"
-title: "集成"
 slug: "integrations"
 sidebar_position: 65
-toc: false
-draft: false
 aliases:
  - /zh-cn/integrations
-menu:
-  sidebar:
-    parent: "development"
-    name: "集成"
-    sidebar_position: 65
-    identifier: "integrations"
 ---

 # 集成
@@ -1,21 +1,15 @@
 ---
 date: "2023-05-25T17:29:00+08:00"
-title: "迁移界面"
+
 slug: "migrations-interfaces"
 sidebar_position: 55
-toc: false
-draft: false
+
 aliases:
  - /zh-cn/migrations-interfaces
-menu:
-  sidebar:
-    parent: "development"
-    name: "迁移界面"
-    sidebar_position: 55
-    identifier: "migrations-interfaces"
+
 ---

-# 迁移功能
+# 迁移接口

 完整迁移功能在Gitea 1.9.0版本中引入。它定义了两个接口，用于支持从其他Git托管平台迁移存储库数据到Gitea，或者在将来将Gitea数据迁移到其他Git托管平台。

@@ -1,18 +1,12 @@
 ---
 date: "2019-04-19:44:00+01:00"
-title: "OAuth2 提供者"
+
 slug: "oauth2-provider"
 sidebar_position: 41
-toc: false
-draft: false
+
 aliases:
  - /zh-cn/oauth2-provider
-menu:
-  sidebar:
-    parent: "development"
-    name: "OAuth2 提供者"
-    sidebar_position: 41
-    identifier: "oauth2-provider"
+
 ---

 # OAuth2 提供者
@@ -3,8 +3,7 @@ date: "2017-01-20T15:00:00+08:00"
 title: "帮助"
 slug: "help"
 sidebar_position: 5
-toc: false
-draft: false
+
 menu:
  sidebar:
    name: "帮助"
@@ -1,18 +1,12 @@
 ---
 date: "2023-05-25T16:00:00+02:00"
-title: "常见问题"
+
 slug: "faq"
 sidebar_position: 5
-toc: false
-draft: false
+
 aliases:
  - /zh-cn/faq
-menu:
-  sidebar:
-    parent: "help"
-    name: "常见问题"
-    sidebar_position: 5
-    identifier: "faq"
+
 ---

 # 常见问题
@@ -1,21 +1,12 @@
 ---
 date: "2017-01-20T15:00:00+08:00"
-title: "需要帮助"
 slug: "support"
 sidebar_position: 20
-toc: false
-draft: false
 aliases:
  - /zh-cn/seek-help
-menu:
-  sidebar:
-    parent: "help"
-    name: "需要帮助"
-    sidebar_position: 20
-    identifier: "support"
 ---

-## 需要帮助?
+# 需要帮助?

 如果您在使用或者开发过程中遇到问题，请到以下渠道咨询：

@@ -1,10 +1,9 @@
 ---
 date: "2016-11-08T16:00:00+02:00"
-title: "文档"
+
 slug: /
 sidebar_position: 10
-toc: false
-draft: false
+
 ---

 # 关于Gitea
@@ -3,8 +3,7 @@ date: "2016-12-01T16:00:00+02:00"
 title: "安装"
 slug: "installation"
 sidebar_position: 10
-toc: false
-draft: false
+
 menu:
  sidebar:
    name: "安装"
@@ -1,18 +1,12 @@
 ---
 date: "2019-02-14T11:51:04+08:00"
-title: "对比 Gitea 与其它 Git 托管工具"
+
 slug: "comparison"
 sidebar_position: 5
-toc: false
-draft: false
+
 aliases:
  - /zh-cn/comparison
-menu:
-  sidebar:
-    parent: "installation"
-    name: "横向对比"
-    sidebar_position: 5
-    identifier: "comparison"
+
 ---

 # 对比 Gitea 与其它 Git 托管工具
@@ -1,18 +1,12 @@
 ---
 date: "2020-01-16"
-title: "数据库准备"
+
 slug: "database-prep"
 sidebar_position: 10
-toc: false
-draft: false
+
 aliases:
  - /zh-cn/database-prep
-menu:
-  sidebar:
-    parent: "installation"
-    name: "数据库准备"
-    sidebar_position: 10
-    identifier: "database-prep"
+
 ---

 # 数据库准备
@@ -1,18 +1,12 @@
 ---
 date: "2016-12-01T16:00:00+02:00"
-title: "使用二进制文件安装"
+
 slug: "install-from-binary"
 sidebar_position: 15
-toc: false
-draft: false
+
 aliases:
  - /zh-cn/install-from-binary
-menu:
-  sidebar:
-    parent: "installation"
-    name: "使用二进制文件安装"
-    sidebar_position: 15
-    identifier: "install-from-binary"
+
 ---

 # 使用二进制文件安装
@@ -1,23 +1,19 @@
 ---
 date: "2016-12-01T16:00:00+02:00"
-title: "使用包管理器安装"
+
 slug: "install-from-package"
 sidebar_position: 20
-toc: false
-draft: false
+
 aliases:
  - /zh-cn/install-from-package
-menu:
-  sidebar:
-    parent: "installation"
-    name: "使用包管理器安装"
-    sidebar_position: 20
-    identifier: "install-from-package"
+
 ---

-# 官方包管理器
+# 使用包管理器安装

-## macOS
+## 官方包管理器
+
+### macOS

 macOS 平台下当前我们仅支持通过 `brew` 来安装。如果你没有安装 [Homebrew](http://brew.sh/)，你也可以查看 [从二进制安装](installation/from-binary.md)。在你安装了 `brew` 之后， 你可以执行以下命令：

@@ -26,9 +22,9 @@ brew tap gitea/tap https://gitea.com/gitea/homebrew-gitea
 brew install gitea
 ```

-# 非官方包管理器
+## 非官方包管理器

-## Alpine Linux
+### Alpine Linux

 Gitea 已经包含在 Alpine Linux 的[社区存储库](https://pkgs.alpinelinux.org/packages?name=gitea&branch=edge)中，版本与 Gitea 官方保持同步。

@@ -36,7 +32,7 @@ Gitea 已经包含在 Alpine Linux 的[社区存储库](https://pkgs.alpinelinux
 apk add gitea
 ```

-## Arch Linux
+### Arch Linux

 Gitea 已经在滚动发布发行版的官方[社区存储库](https://www.archlinux.org/packages/community/x86_64/gitea/)中，版本与 Gitea 官方保持同步。

@@ -44,7 +40,7 @@ Gitea 已经在滚动发布发行版的官方[社区存储库](https://www.archl
 pacman -S gitea
 ```

-## Arch Linux ARM
+### Arch Linux ARM

 官方支持 [aarch64](https://archlinuxarm.org/packages/aarch64/gitea)， [armv7h](https://archlinuxarm.org/packages/armv7h/gitea) 和 [armv6h](https://archlinuxarm.org/packages/armv6h/gitea) 架构。

@@ -52,7 +48,7 @@ pacman -S gitea
 pacman -S gitea
 ```

-## Canonical Snap
+### Canonical Snap

 目前 Gitea 已在 Snap Store 中发布，名称为 [gitea](https://snapcraft.io/gitea)。

@@ -60,12 +56,12 @@ pacman -S gitea
 snap install gitea
 ```

-## SUSE/openSUSE
+### SUSE/openSUSE

 OpenSUSE 构建服务为 [openSUSE 和 SLE](https://software.opensuse.org/download/package?package=gitea&project=devel%3Atools%3Ascm)
 提供包，你可以在开发软件配置管理存储库中找到它们。

-## Windows
+### Windows

 目前你可以通过 [Chocolatey](https://chocolatey.org/) 来安装 [Gitea](https://chocolatey.org/packages/gitea)。

@@ -75,7 +71,7 @@ choco install gitea

 你也可以 [从二进制安装](installation/from-binary.md) 。

-## FreeBSD
+### FreeBSD

 可以使用 Gitea 的 FreeBSD port `www/gitea`。 请安装预构建的二进制包：

@@ -97,7 +93,7 @@ make install clean

 要使 Gitea 作为服务运行，请运行 `sysrc gitea_enable=YES` 并使用 `service gitea start` 命令启动它。

-## 第三方
+### 其它

 如果这里没有找到你喜欢的包管理器，可以使用 Gitea 第三方软件包。这里有一个完整的列表： [awesome-gitea](https://gitea.com/gitea/awesome-gitea/src/branch/master/README.md#user-content-packages)。

@@ -1,18 +1,12 @@
 ---
 date: "2016-12-01T16:00:00+02:00"
-title: "使用源代码安装"
+
 slug: "install-from-source"
 sidebar_position: 30
-toc: false
-draft: false
+
 aliases:
  - /zh-cn/install-from-source
-menu:
-  sidebar:
-    parent: "installation"
-    name: "使用源代码安装"
-    sidebar_position: 30
-    identifier: "install-from-source"
+
 ---

 # 使用源代码安装
@@ -1,18 +1,9 @@
 ---
 date: "2016-12-01T16:00:00+02:00"
-title: "在云服务器中安装 Gitea"
 slug: "install-on-cloud-provider"
 sidebar_position: 90
-toc: false
-draft: false
 aliases:
  - /zh-cn/install-on-cloud-provider
-menu:
-  sidebar:
-    parent: "installation"
-    name: "在云服务器中安装 Gitea"
-    sidebar_position: 90
-    identifier: "install-on-cloud-provider"
 ---

 # 在云服务器上安装 Gitea
@@ -1,21 +1,12 @@
 ---
 date: "2020-03-19T19:27:00+02:00"
-title: "在 Kubernetes 中安装 Gitea"
 slug: "install-on-kubernetes"
 sidebar_position: 80
-toc: false
-draft: false
 aliases:
  - /zh-cn/install-on-kubernetes
-menu:
-  sidebar:
-    parent: "installation"
-    name: "在 Kubernetes 中安装 Gitea"
-    sidebar_position: 80
-    identifier: "install-on-kubernetes"
 ---

-# 使用 Helm 在 Kubernetes 云原生环境中安装 Gitea
+# 在 Kubernetes 中安装 Gitea

 Gitea 已经提供了便于在 Kubernetes 云原生环境中安装所需的 Helm Chart

@@ -1,23 +1,16 @@
 ---
 date: "2017-07-21T12:00:00+02:00"
-title: "在 Linux 中以 service 方式运行"
 slug: "linux-service"
 sidebar_position: 40
-toc: false
-draft: false
 aliases:
  - /zh-cn/linux-service
-menu:
-  sidebar:
-    parent: "installation"
-    name: "在Linux中以service方式运行"
-    sidebar_position: 40
-    identifier: "linux-service"
 ---

-### 在 Ubuntu 16.04 LTS 中以 service 方式运行
+# 在 Linux 中以 service 方式运行

-#### systemd 方式
+## 在 Ubuntu 16.04 LTS 中以 service 方式运行
+
+### systemd 方式

 在 terminal 中执行以下命令：

@@ -36,7 +29,7 @@ sudo systemctl enable gitea
 sudo systemctl start gitea
 ```

-#### 使用 supervisor
+### 使用 supervisor

 在 terminal 中执行以下命令安装 supervisor：

@@ -1,16 +1,9 @@
 ---
 date: "2021-09-02T16:00:00+08:00"
-title: "从旧版 Gitea 升级"
+
 slug: "upgrade-from-gitea"
 sidebar_position: 100
-toc: false
-draft: false
-menu:
-  sidebar:
-    parent: "installation"
-    name: "从旧版 Gitea 升级"
-    sidebar_position: 100
-    identifier: "upgrade-from-gitea"
+
 ---

 # 从旧版 Gitea 升级
@@ -1,18 +1,12 @@
 ---
 date: "2016-12-01T16:00:00+02:00"
-title: "从 Gogs 升级"
+
 slug: "upgrade-from-gogs"
 sidebar_position: 101
-toc: false
-draft: false
+
 aliases:
  - /zh-cn/upgrade-from-gogs
-menu:
-  sidebar:
-    parent: "installation"
-    name: "从 Gogs 升级"
-    sidebar_position: 101
-    identifier: "upgrade-from-gogs"
+
 ---

 # 从 Gogs 升级
@@ -1,18 +1,12 @@
 ---
 date: "2016-12-21T15:00:00-02:00"
-title: "注册为Windows服务"
+
 slug: "windows-service"
 sidebar_position: 50
-toc: false
-draft: false
+
 aliases:
  - /zh-cn/windows-service
-menu:
-  sidebar:
-    parent: "installation"
-    name: "Windows服务"
-    sidebar_position: 50
-    identifier: "windows-service"
+
 ---

 # 注册为Windows服务
@@ -1,21 +1,12 @@
 ---
 date: "2020-02-09T20:00:00+02:00"
-title: "使用 Docker 安装 (rootless)"
 slug: "install-with-docker-rootless"
 sidebar_position: 60
-toc: false
-draft: false
 aliases:
  - /zh-cn/install-with-docker-rootless
-menu:
-  sidebar:
-    parent: "installation"
-    name: "使用 Docker 安装 (rootless)"
-    sidebar_position: 60
-    identifier: "install-with-docker-rootless"
 ---

-# 使用 Docker 安装
+# 使用 Docker 安装 (rootless)

 Gitea 在其 Docker Hub 组织中提供自动更新的 Docker 镜像。您可以始终使用最新的稳定标签，或使用其他处理 Docker 镜像更新的服务。

@@ -1,18 +1,12 @@
 ---
 date: "2016-12-01T16:00:00+02:00"
-title: "使用 Docker 安装"
+
 slug: "install-with-docker"
 sidebar_position: 70
-toc: false
-draft: false
+
 aliases:
  - /zh-cn/install-with-docker
-menu:
-  sidebar:
-    parent: "installation"
-    name: "使用 Docker 安装"
-    sidebar_position: 70
-    identifier: "install-with-docker"
+
 ---

 # 使用 Docker 安装
@@ -3,8 +3,7 @@ date: "2016-12-27T16:00:00+02:00"
 title: "使用指南"
 slug: "usage"
 sidebar_position: 35
-toc: false
-draft: false
+
 menu:
  sidebar:
    name: "使用指南"
@@ -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)。