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,12 @@
 ---
 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,12 @@
 ---
 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"
 ---

 # 命令行
@@ -1,18 +1,12 @@
 ---
 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,12 @@
 ---
 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,12 @@
 ---
 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,12 @@
 ---
 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,15 @@
 ---
 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` 文件：

@@ -1,19 +1,10 @@
 ---
 date: "2023-04-09T11:00:00+02:00"
-title: "HTTPS配置"
 slug: "https-setup"
 sidebar_position: 12
-toc: false
-draft: false
-menu:
-  sidebar:
-    parent: "administration"
-    name: "HTTPS setup"
-    sidebar_position: 12
-    identifier: "https-setup"
 ---

-# HTTPS setup to encrypt connections to Gitea
+# HTTPS配置

 ## 使用内置服务器

@@ -1,18 +1,12 @@
 ---
 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,12 @@
 ---
 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,15 @@
 ---
 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,12 @@
 ---
 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,14 @@
 ---
 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"
 ---

-# 支持选项
+# 需要帮助
+
+## 支持选项

 - [付费商业支持](https://about.gitea.com/)
 - [Discord](https://discord.gg/Gitea)
@@ -26,7 +19,7 @@ menu:
  - [Discourse 中文分类](https://forum.gitea.com/c/5-category/5)
  - QQ 群 328432459

-# Bug 报告
+## Bug 报告

 如果您发现了 Bug，请在 GitHub 上 [创建一个问题](https://github.com/go-gitea/gitea/issues)。

@@ -43,9 +36,9 @@ menu:
 5. 如果遇到慢速/挂起/死锁等问题，请在出现问题时报告堆栈跟踪。
   转到 "Site Admin" -> "Monitoring" -> "Stacktrace" -> "Download diagnosis report"。

-# 高级 Bug 报告提示
+## 高级 Bug 报告提示

-## 更多日志的配置选项
+### 更多日志的配置选项

 默认情况下，日志以 `info` 级别输出到控制台。
 如果您需要设置日志级别和/或从文件中收集日志，
@@ -59,7 +52,7 @@ LEVEL=debug
 MODE=console,file
 ```

-## 使用命令行收集堆栈跟踪
+### 使用命令行收集堆栈跟踪

 Gitea 可以使用 Golang 的 pprof 处理程序和工具链来收集堆栈跟踪和其他运行时信息。

@@ -67,10 +60,10 @@ Gitea 可以使用 Golang 的 pprof 处理程序和工具链来收集堆栈跟

 1. 设置 app.ini：

-    ```
-    [server]
-    ENABLE_PPROF = true
-    ```
+```ini
+[server]
+ENABLE_PPROF = true
+```

 2. 重新启动 Gitea

@@ -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,18 +1,12 @@
 ---
 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"
+
 ---

 # 官方包管理器
@@ -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,12 @@
 ---
 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,15 @@
 ---
 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-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"
+
 ---

 ## 准备工作
@@ -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,9 @@
 ---
 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,9 @@
 ---
 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,7 @@
 ---
 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,16 +1,8 @@
 ---
 date: "2023-05-23T09:00:00+08:00"
-title: "密钥管理"
 slug: "secrets"
 sidebar_position: 50
-draft: false
-toc: false
-menu:
-  sidebar:
-    parent: "actions"
-    name: "密钥管理"
-    sidebar_position: 50
-    identifier: "usage-secrets"
+
 ---

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

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

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

@@ -1,16 +1,9 @@
 ---
 date: "2024-04-10T22:21:00+08:00"
-title: "变量"
+
 slug: "actions-variables"
 sidebar_position: 25
-draft: false
-toc: false
-menu:
-  sidebar:
-    parent: "actions"
-    name: "变量"
-    sidebar_position: 25
-    identifier: "actions-variables"
+
 ---

 ## 变量
@@ -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,9 @@
 ---
 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,9 @@
 ---
 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,8 @@
 ---
 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,8 @@
 ---
 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,9 @@
 ---
 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,9 @@
 ---
 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,9 @@
 ---
 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,9 @@
 ---
 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,8 @@
 ---
 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,9 @@
 ---
 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,12 @@
 ---
 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,31 +1,24 @@
 ---
 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) 的支持。

@@ -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,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,12 @@
 ---
 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