gitea/gitea-docs
1
0
Fork 0
mirror of https://gitea.com/gitea/docs.git synced 2026-07-22 12:37:42 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update zh tw languages and fix some broken links

Browse Source
This commit is contained in:
Lunny Xiao
2026-07-01 14:47:51 -07:00
parent 9558006c39
commit a084bdb556
842 changed files with 31137 additions and 31065 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
i18n/zh-tw/docusaurus-plugin-content-docs/current/usage/repository/clone-filter.md
View File

@@ -7,12 +7,12 @@ aliases:
- /zh-tw/clone-filters
---
# 克隆过滤器 (部分克隆)
# 克隆過濾器 (部分克隆)
Git 引入了 `--filter` 选项用于 `git clone` 命令，该选项可以过滤掉大文件和对象（如 blob），从而创建一个仓库的部分克隆。克隆过滤器对于大型仓库和/或按流量计费的连接特别有用，因为完全克隆（不使用 `--filter`）可能会很昂贵（需要下载所有历史数据）。
Git 引入了 `--filter` 選項用於 `git clone` 命令，該選項可以過濾掉大文件和對象（如 blob），從而建立一個儲存庫的部分克隆。克隆過濾器對於大型儲存庫和/或按流量計費的連接特別有用，因爲完全克隆（不使用 `--filter`）可能會很昂貴（需要下載所有歷史資料）。
这需要 Git 2.22 或更高版本，无论是在 Gitea 服务器上还是在客户端上都需要如此。为了使克隆过滤器正常工作，请确保客户端上的 Git 版本至少与服务器上的版本相同（或更高）。以管理员身份登录到 Gitea，然后转到管理后台 -> 应用配置，查看服务器的 Git 版本。
這需要 Git 2.22 或更高版本，無論是在 Gitea 伺服器上還是在客戶端上都需要如此。爲了使克隆過濾器正常工作，請確保客戶端上的 Git 版本至少與伺服器上的版本相同（或更高）。以管理員身份登入到 Gitea，然後轉到管理後臺 -> 應用設定，查看伺服器的 Git 版本。
默认情况下，克隆过滤器是启用的，除非在 `[git]` 下将 `DISABLE_PARTIAL_CLONE` 设置为 `true`。
預設情況下，克隆過濾器是啟用的，除非在 `[git]` 下將 `DISABLE_PARTIAL_CLONE` 設定爲 `true`。
请参阅 [GitHub 博客文章：了解部分克隆](https://github.blog/2020-12-21-get-up-to-speed-with-partial-clone-and-shallow-clone/) 以获取克隆过滤器的常见用法（无 Blob 和无树的克隆），以及 [GitLab 部分克隆文档](https://docs.gitlab.com/ee/topics/git/partial_clone.html) 以获取更高级的用法（例如按文件大小过滤和取消过滤以将部分克隆转换为完全克隆）。
請參閱 [GitHub 部落格文章：瞭解部分克隆](https://github.blog/2020-12-21-get-up-to-speed-with-partial-clone-and-shallow-clone/) 以獲取克隆過濾器的常見用法（無 Blob 和無樹的克隆），以及 [GitLab 部分克隆文件](https://docs.gitlab.com/ee/topics/git/partial_clone.html) 以獲取更高級的用法（例如按文件大小過濾和取消過濾以將部分克隆轉換爲完全克隆）。

32
i18n/zh-tw/docusaurus-plugin-content-docs/current/usage/repository/incoming-email.md
View File

@@ -7,32 +7,32 @@ aliases:
- /zh-tw/incoming-email
---
# 邮件接收
# 郵件接收
Gitea 支持通过接收邮件执行多种操作。本页面描述了如何进行设置。
Gitea 支援通過接收郵件執行多種操作。本頁面描述瞭如何進行設定。
## 要求
处理接收的电子邮件需要启用 IMAP 功能的电子邮件帐户。
推荐的策略是使用 [电子邮件子地址](https://en.wikipedia.org/wiki/Email_address#Sub-addressing)，但也可以使用 catch-all 邮箱。
接收电子邮件地址中包含一个用户/操作特定的令牌，告诉 Gitea 应执行哪个操作。
此令牌应该出现在 `To` 和 `Delivered-To` 头字段中。
處理接收的電子郵件需要啟用 IMAP 功能的電子郵件帳戶。
推薦的策略是使用 [電子郵件子地址](https://en.wikipedia.org/wiki/Email_address#Sub-addressing)，但也可以使用 catch-all 郵箱。
接收電子電子郵件地址中包含一個使用者/操作特定的令牌，告訴 Gitea 應執行哪個操作。
此令牌應該出現在 `To` 和 `Delivered-To` 頭欄位中。
Gitea 会尝试检测自动回复并跳过它们，电子邮件服务器也应该配置以减少接收到的干扰（垃圾邮件、通讯订阅等）。
Gitea 會嘗試檢測自動回覆並跳過它們，電子郵件伺服器也應該設定以減少接收到的干擾（垃圾郵件、通訊訂閱等）。
## 配置
## 設定
要激活处理接收的电子邮件消息功能，您需要在配置文件中配置 `email.incoming` 部分。
要激活處理接收的電子郵件消息功能，您需要在設定文件中設定 `email.incoming` 部分。
`REPLY_TO_ADDRESS` 包含电子邮件客户端将要回复的地址。
该地址需要包含 `%{token}` 占位符，该占位符将被替换为描述用户/操作的令牌。
此占位符在地址中只能出现一次，并且必须位于地址的用户部分（`@` 之前）。
`REPLY_TO_ADDRESS` 包含電子郵件客戶端將要回復的地址。
該地址需要包含 `%{token}` 佔位符，該佔位符將被替換爲描述使用者/操作的令牌。
此佔位符在地址中只能出現一次，並且必須位於地址的使用者部分（`@` 之前）。
使用电子邮件子地址的示例可能如下：`incoming+%{token}@example.com`
使用電子郵件子地址的範例可能如下：`incoming+%{token}@example.com`
如果使用 catch-all 邮箱，则占位符可以出现在地址的用户部分的任何位置：`incoming+%{token}@example.com`、`incoming_%{token}@example.com`、`%{token}@example.com`
如果使用 catch-all 郵箱，則佔位符可以出現在地址的使用者部分的任何位置：`incoming+%{token}@example.com`、`incoming_%{token}@example.com`、`%{token}@example.com`
## 安全性
在选择用于接收传入电子邮件的域时要小心。
建议在子域名上接收传入电子邮件，例如 `incoming.example.com`，以防止与运行在 `example.com` 上的其他服务可能存在的安全问题。
在選擇用於接收傳入電子郵件的域時要小心。
建議在子域名上接收傳入電子郵件，例如 `incoming.example.com`，以防止與運行在 `example.com` 上的其他服務可能存在的安全問題。

10
i18n/zh-tw/docusaurus-plugin-content-docs/current/usage/repository/profile-readme.md
View File

@@ -4,12 +4,12 @@ slug: "profile-readme"
sidebar_position: 12
---
# 个人资料 README
# 個人資料 README
要在您的 Gitea 个人资料页面显示一个 Markdown 文件，只需创建一个名为 `.profile` 的仓库，并编辑其中的 `README.md` 文件。Gitea 将自动获取该文件并在您的仓库上方显示。
要在您的 Gitea 個人資料頁面顯示一個 Markdown 文件，只需建立一個名爲 `.profile` 的儲存庫，並編輯其中的 `README.md` 文件。Gitea 將自動獲取該文件並在您的儲存庫上方顯示。
注意：您可以将此仓库设为私有。这样可以隐藏您的源文件，使其对公众不可见，并允许您将某些文件设为私有。但是，README.md 文件将是您个人资料上唯一存在的文件。如果您希望完全私有化 .profile 仓库，则需删除或重命名 README.md 文件。
注意：您可以將此儲存庫設爲私有。這樣可以隱藏您的源文件，使其對公衆不可見，並允許您將某些文件設爲私有。但是，README.md 文件將是您個人資料上唯一存在的文件。如果您希望完全私有化 .profile 儲存庫，則需刪除或重命名 README.md 文件。
用户示例 `.profile/README.md`:
使用者範例 `.profile/README.md`:
![个人资料自述文件截图](/images/usage/profile-readme.png)
![個人資料自述文件截圖](/images/usage/profile-readme.png)

44
i18n/zh-tw/docusaurus-plugin-content-docs/current/usage/repository/push.md
View File

@@ -9,53 +9,53 @@ aliases:
# 推送
在将提交推送到 Gitea 服务器时，还有一些额外的功能。
在將提交推送到 Gitea 伺服器時，還有一些額外的功能。
## 通过推送打开 PR
## 通過推送打開 PR
当您第一次将提交推送到非默认分支时，您将收到一个链接，您可以单击该链接访问分支与主分支的比较页面。
从那里，您可以轻松创建一个拉取请求，即使您想要将其目标指向另一个分支。
當您第一次將提交推送到非預設分支時，您將收到一個鏈接，您可以單擊該鏈接訪問分支與主分支的比較頁面。
從那裏，您可以輕鬆建立一個拉取請求，即使您想要將其目標指向另一個分支。
![Gitea 推送提示](/gitea-push-hint.png)
## 推送选项
## 推送選項
在 Gitea `1.13` 版本中，添加了对一些 [推送选项](https://git-scm.com/docs/git-push#Documentation/git-push.txt--oltoptiongt) 的支持。
在 Gitea `1.13` 版本中，添加了對一些 [推送選項](https://git-scm.com/docs/git-push#Documentation/git-push.txt--oltoptiongt) 的支援。
### 支持的选项
### 支援的選項
- `repo.private` (true|false) - 更改仓库的可见性。
- `repo.private` (true|false) - 更改儲存庫的可見性。
这在与 push-to-create 结合使用时特别有用。
這在與 push-to-create 結合使用時特別有用。
- `repo.template` (true|false) - 更改仓库是否为模板。
- `repo.template` (true|false) - 更改儲存庫是否爲模板。
将仓库的可见性更改为公开的示例：
將儲存庫的可見性更改爲公開的範例：
```shell
git push -o repo.private=false -u origin main
```
## 推送创建
## 推送建立
推送创建是一项功能，允许您将提交推送到在 Gitea 中尚不存在的仓库。这对于自动化和允许用户创建仓库而无需通过 Web 界面非常有用。此功能默认处于禁用状态。
推送建立是一項功能，允許您將提交推送到在 Gitea 中尚不存在的儲存庫。這對於自動化和允許使用者建立儲存庫而無需通過 Web 介面非常有用。此功能預設處於禁用狀態。
### 启用推送创建
### 啟用推送建立
在 `app.ini` 文件中，将 `ENABLE_PUSH_CREATE_USER` 设置为 `true`，如果您希望允许用户在自己的用户帐户和所属的组织中创建仓库，将 `ENABLE_PUSH_CREATE_ORG` 设置为 `true`。重新启动 Gitea 以使更改生效。您可以在 [配置速查表](../administration/config-cheat-sheet.md#仓库) 中了解有关这两个选项的更多信息。
在 `app.ini` 文件中，將 `ENABLE_PUSH_CREATE_USER` 設定爲 `true`，如果您希望允許使用者在自己的使用者帳戶和所屬的組織中建立儲存庫，將 `ENABLE_PUSH_CREATE_ORG` 設定爲 `true`。重新啟動 Gitea 以使更改生效。您可以在 [設定速查表](../../config-cheat-sheet) 中瞭解有關這兩個選項的更多資訊。
### 使用推送创建
### 使用推送建立
假设您在当前目录中有一个 git 仓库，您可以通过运行以下命令将提交推送到在 Gitea 中尚不存在的仓库：
假設您在當前目錄中有一個 git 儲存庫，您可以透過運行以下命令將提交推送到在 Gitea 中尚不存在的儲存庫：
```shell
# 添加要推送到的远程仓库
git remote add origin git@{domain}:{username}/{尚不存在的仓库名称}.git
# 添加要推送到的遠程倉庫
git remote add origin git@{domain}:{username}/{尚不存在的倉庫名稱}.git
# 推送到远程仓库
# 推送到遠程倉庫
git push -u origin main
```
这假设您使用的是 SSH 远程，但您也可以使用 HTTPS 远程。
這假設您使用的是 SSH 遠程，但您也可以使用 HTTPS 遠程。
推送创建将默认使用 `app.ini` 中定义的可见性 `DEFAULT_PUSH_CREATE_PRIVATE`。
推送建立將預設使用 `app.ini` 中定義的可見性 `DEFAULT_PUSH_CREATE_PRIVATE`。

102
i18n/zh-tw/docusaurus-plugin-content-docs/current/usage/repository/repo-mirror.md
View File

@@ -6,90 +6,90 @@ aliases:
- /zh-tw/repo-mirror
---
# 仓库镜像
# 儲存庫鏡像
仓库镜像允许将仓库与外部源之间进行镜像。您可以使用它在仓库之间镜像分支、标签和提交。
儲存庫鏡像允許將儲存庫與外部源之間進行鏡像。您可以使用它在儲存庫之間鏡像分支、標籤和提交。
## 使用场景
## 使用場景
以下是一些仓库镜像的可能使用场景：
以下是一些儲存庫鏡像的可能使用場景：
- 您迁移到了 Gitea，但仍需要在其他源中保留您的项目。在这种情况下，您可以简单地设置它以进行镜像到 Gitea（拉取），这样您的 Gitea 实例中就可以获取到所有必要的提交历史、标签和分支。
- 您在其他源中有一些旧项目，您不再主动使用，但出于归档目的不想删除。在这种情况下，您可以创建一个推送镜像，以便您的活跃的 Gitea 仓库可以将其更改推送到旧位置。
- 您遷移到了 Gitea，但仍需要在其他源中保留您的專案。在這種情況下，您可以簡單地設定它以進行鏡像到 Gitea（拉取），這樣您的 Gitea 實例中就可以獲取到所有必要的提交歷史、標籤和分支。
- 您在其他源中有一些舊專案，您不再主動使用，但出於歸檔目的不想刪除。在這種情況下，您可以建立一個推送鏡像，以便您的活躍的 Gitea 儲存庫可以將其更改推送到舊位置。
## 从远程仓库拉取
## 從遠程儲存庫拉取
对于现有的远程仓库，您可以按照以下步骤设置拉取镜像：
對於現有的遠程儲存庫，您可以按照以下步驟設定拉取鏡像：
1. 在右上角的“创建...”菜单中选择“迁移外部仓库”。
2. 选择远程仓库服务。
3. 输入仓库的 URL。
4. 如果仓库需要身份验证，请填写您的身份验证信息。
5. 选中“该仓库将是一个镜像”复选框。
6. 选择“迁移仓库”以保存配置。
1. 在右上角的“建立...”菜單中選擇“遷移外部儲存庫”。
2. 選擇遠程儲存庫服務。
3. 輸入儲存庫的 URL。
4. 如果儲存庫需要身份驗證，請填寫您的身份驗證資訊。
5. 選中“該儲存庫將是一個鏡像”複選框。
6. 選擇“遷移儲存庫”以保存設定。
现在，该仓库会定期从远程仓库进行镜像。您可以通过在仓库设置中选择“立即同步”来强制进行同步。
現在，該儲存庫會定期從遠程儲存庫進行鏡像。您可以透過在儲存庫設定中選擇“立即同步”來強制進行同步。
:::warning
:exclamation::exclamation: **注意：**您只能为尚不存在于您的实例上的仓库设置拉取镜像。一旦仓库创建成功，您就无法再将其转换为拉取镜像。:exclamation::exclamation:
:exclamation::exclamation: **注意：**您只能爲尚不存在於您的實例上的儲存庫設定拉取鏡像。一旦儲存庫建立成功，您就無法再將其轉換爲拉取鏡像。:exclamation::exclamation:
:::
## 推送到远程仓库
## 推送到遠程儲存庫
对于现有的仓库，您可以按照以下步骤设置推送镜像：
對於現有的儲存庫，您可以按照以下步驟設定推送鏡像：
1. 在仓库中，转到**设置** > **仓库**，然后进入**镜像设置**部分。
2. 输入一个仓库的 URL。
3. 如果仓库需要身份验证，请展开**授权**部分并填写您的身份验证信息。请注意，所请求的**密码**也可以是您的访问令牌。
4. 选择**添加推送镜像**以保存配置。
1. 在儲存庫中，轉到**設定** > **儲存庫**，然後進入**鏡像設定**部分。
2. 輸入一個儲存庫的 URL。
3. 如果儲存庫需要身份驗證，請展開**授權**部分並填寫您的身份驗證資訊。請注意，所請求的**密碼**也可以是您的存取權杖。
4. 選擇**添加推送鏡像**以保存設定。
该仓库现在会定期镜像到远程仓库。您可以通过选择**立即同步**来强制同步。如果出现错误，会显示一条消息帮助您解决问题。
該儲存庫現在會定期鏡像到遠程儲存庫。您可以透過選擇**立即同步**來強制同步。如果出現錯誤，會顯示一條消息幫助您解決問題。
:::warning
:exclamation::exclamation: **注意：** 这将强制推送到远程仓库。这将覆盖远程仓库中的任何更改！ :exclamation::exclamation:
:exclamation::exclamation: **注意：** 這將強制推送到遠程儲存庫。這將覆蓋遠程儲存庫中的任何更改！ :exclamation::exclamation:
:::
### 从 Gitea 向 GitHub 设置推送镜像
### 從 Gitea 向 GitHub 設定推送鏡像
要从 Gitea 设置镜像到 GitHub，您需要按照以下步骤进行操作：
要從 Gitea 設定鏡像到 GitHub，您需要按照以下步驟進行操作：
1. 创建一个具有选中 _public_repo_ 选项的 [GitHub 个人访问令牌](https://docs.github.com/en/github/authenticating-to-github/creating-a-personal-access-token)。
2. 在 GitHub 上创建一个同名的仓库。与 Gitea 不同，GitHub 不支持通过推送到远程来创建仓库。如果您的现有远程仓库与您的 Gitea 仓库具有相同的提交历史，您也可以使用现有的远程仓库。
3. 在您的 Gitea 仓库设置中，填写**Git 远程仓库 URL**：`https://github.com/<your_github_group>/<your_github_project>.git`。
4. 使用您的 GitHub 用户名填写**授权**字段，并将个人访问令牌作为**密码**。
5. （可选，适用于 Gitea 1.18+）选择`当推送新提交时同步`，这样一旦有更改，镜像将会及时更新。如果您愿意，您还可以禁用定期同步。
6. 选择**添加推送镜像**以保存配置。
1. 建立一個具有選中 _public_repo_ 選項的 [GitHub 個人存取權杖](https://docs.github.com/en/github/authenticating-to-github/creating-a-personal-access-token)。
2. 在 GitHub 上建立一個同名的儲存庫。與 Gitea 不同，GitHub 不支援通過推送到遠程來建立儲存庫。如果您的現有遠程儲存庫與您的 Gitea 儲存庫具有相同的提交歷史，您也可以使用現有的遠程儲存庫。
3. 在您的 Gitea 儲存庫設定中，填寫**Git 遠程儲存庫 URL**：`https://github.com/<your_github_group>/<your_github_project>.git`。
4. 使用您的 GitHub 使用者名稱填寫**授權**欄位，並將個人存取權杖作爲**密碼**。
5. （可選，適用於 Gitea 1.18+）選擇`當推送新提交時同步`，這樣一旦有更改，鏡像將會及時更新。如果您願意，您還可以禁用定期同步。
6. 選擇**添加推送鏡像**以保存設定。
仓库会很快进行推送。要强制推送，请选择**立即同步**按钮。
儲存庫會很快進行推送。要強制推送，請選擇**立即同步**按鈕。
### 从 Gitea 向 GitLab 设置推送镜像
### 從 Gitea 向 GitLab 設定推送鏡像
要从 Gitea 设置镜像到 GitLab，您需要按照以下步骤进行操作：
要從 Gitea 設定鏡像到 GitLab，您需要按照以下步驟進行操作：
1. 创建具有 _write_repository_ 作用域的 [GitLab 个人访问令牌](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html)。
2. 填写**Git 远程仓库 URL**：`https://<destination host>/<your_gitlab_group_or_name>/<your_gitlab_project>.git`。
3. 在**授权**字段中填写 `oauth2` 作为**用户名**，并将您的 GitLab 个人访问令牌作为**密码**。
4. 选择**添加推送镜像**以保存配置。
1. 建立具有 _write_repository_ 作用域的 [GitLab 個人存取權杖](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html)。
2. 填寫**Git 遠程儲存庫 URL**：`https://<destination host>/<your_gitlab_group_or_name>/<your_gitlab_project>.git`。
3. 在**授權**欄位中填寫 `oauth2` 作爲**使用者名稱**，並將您的 GitLab 個人存取權杖作爲**密碼**。
4. 選擇**添加推送鏡像**以保存設定。
仓库会很快进行推送。要强制推送，请选择**立即同步**按钮。
儲存庫會很快進行推送。要強制推送，請選擇**立即同步**按鈕。
### 从 Gitea 向 Bitbucket 设置推送镜像
### 從 Gitea 向 Bitbucket 設定推送鏡像
要从 Gitea 设置镜像到 Bitbucket，您需要按照以下步骤进行操作：
要從 Gitea 設定鏡像到 Bitbucket，您需要按照以下步驟進行操作：
1. 创建一个具有选中 _Repository Write_ 选项的 [Bitbucket 应用密码](https://support.atlassian.com/bitbucket-cloud/docs/app-passwords/)。
2. 填写**Git 远程仓库 URL**：`https://bitbucket.org/<your_bitbucket_group_or_name>/<your_bitbucket_project>.git`。
3. 使用您的 Bitbucket 用户名填写**授权**字段，并将应用密码作为**密码**。
4. 选择**添加推送镜像**以保存配置。
1. 建立一個具有選中 _Repository Write_ 選項的 [Bitbucket 應用密碼](https://support.atlassian.com/bitbucket-cloud/docs/app-passwords/)。
2. 填寫**Git 遠程儲存庫 URL**：`https://bitbucket.org/<your_bitbucket_group_or_name>/<your_bitbucket_project>.git`。
3. 使用您的 Bitbucket 使用者名稱填寫**授權**欄位，並將應用密碼作爲**密碼**。
4. 選擇**添加推送鏡像**以保存設定。
仓库会很快进行推送。要强制推送，请选择**立即同步**按钮。
儲存庫會很快進行推送。要強制推送，請選擇**立即同步**按鈕。
### 镜像现有的 ssh 仓库
### 鏡像現有的 ssh 儲存庫
当前，Gitea 不支持从 ssh 仓库进行镜像。如果您想要镜像一个 ssh 仓库，您需要将其转换为 http 仓库。您可以使用以下命令将现有的 ssh 仓库转换为 http 仓库：
當前，Gitea 不支援從 ssh 儲存庫進行鏡像。如果您想要鏡像一個 ssh 儲存庫，您需要將其轉換爲 http 儲存庫。您可以使用以下命令將現有的 ssh 儲存庫轉換爲 http 儲存庫：
1. 确保运行 gitea 的用户有权限访问您试图从 shell 镜像到的 git 仓库。
2. 在 Web 界面的版本库设置 > git 钩子中为镜像添加一个接收后钩子。
1. 確保運行 gitea 的使用者有權限訪問您試圖從 shell 鏡像到的 git 儲存庫。
2. 在 Web 介面的版本庫設定 > git 鉤子中爲鏡像添加一個接收後鉤子。
```
#!/usr/bin/env bash

64
i18n/zh-tw/docusaurus-plugin-content-docs/current/usage/repository/template-repositories.md
View File

@@ -6,66 +6,66 @@ aliases:
- /zh-tw/template-repositories
---
# 模板仓库
# 模板儲存庫
Gitea `1.11.0` 及以上版本引入了模板仓库，并且其中一个实现的功能是自动展开模板文件中的特定变量。
Gitea `1.11.0` 及以上版本引入了模板儲存庫，並且其中一個實現的功能是自動展開模板文件中的特定變量。
要告诉 Gitea 哪些文件需要展开，您必须在模板仓库的 `.gitea` 目录中包含一个 `template` 文件。
要告訴 Gitea 哪些文件需要展開，您必須在模板儲存庫的 `.gitea` 目錄中包含一個 `template` 文件。
Gitea 使用 [gobwas/glob](https://github.com/gobwas/glob) 作为其 glob 语法。它与传统的 `.gitignore` 语法非常相似，但可能存在细微的差异。
Gitea 使用 [gobwas/glob](https://github.com/gobwas/glob) 作爲其 glob 語法。它與傳統的 `.gitignore` 語法非常相似，但可能存在細微的差異。
## `.gitea/template` 文件示例
## `.gitea/template` 文件範例
所有路径都是相对于仓库的根目录
所有路徑都是相對於儲存庫的根目錄
```gitignore
# 仓库中的所有 .go 文件
# 倉庫中的所有 .go 文件
**.go
# text 目录中的所有文本文件
# text 目錄中的所有文本文件
text/*.txt
# 特定文件
a/b/c/d.json
# 匹配批处理文件的大小写变体
# 匹配批處理文件的大小寫變體
**.[bB][aA][tT]
```
**注意：** 当从模板生成仓库时，`.gitea` 目录中的 `template` 文件将被删除。
**注意：** 當從模板生成儲存庫時，`.gitea` 目錄中的 `template` 文件將被刪除。
## 参数展开
## 參數展開
在与上述通配符匹配的任何文件中，将会扩展某些变量。
在與上述通配符匹配的任何文件中，將會擴展某些變量。
文件名和路径的匹配也可以被扩展，并且会经过谨慎的清理处理，以支持跨平台的文件系统。
文件名和路徑的匹配也可以被擴展，並且會經過謹慎的清理處理，以支援跨平台的文件系統。
所有变量都必须采用`$VAR`或`${VAR}`的形式。要转义扩展，使用双重`$$`，例如`$$VAR`或`$${VAR}`。
所有變量都必須採用`$VAR`或`${VAR}`的形式。要轉義擴展，使用雙重`$$`，例如`$$VAR`或`$${VAR}`。
| 变量 | 扩展为 | 可转换 |
| 變量 | 擴展爲 | 可轉換 |
| -------------------- | ----------------------------- | ------ |
| REPO_NAME | 生成的仓库名称 | ✓ |
| TEMPLATE_NAME | 模板仓库名称 | ✓ |
| REPO_DESCRIPTION | 生成的仓库描述 | ✘ |
| TEMPLATE_DESCRIPTION | 模板仓库描述 | ✘ |
| REPO_OWNER | 生成的仓库所有者 | ✓ |
| TEMPLATE_OWNER | 模板仓库所有者 | ✓ |
| REPO_LINK | 生成的仓库链接 | ✘ |
| TEMPLATE_LINK | 模板仓库链接 | ✘ |
| REPO_HTTPS_URL | 生成的仓库的 HTTP(S) 克隆链接 | ✘ |
| TEMPLATE_HTTPS_URL | 模板仓库的 HTTP(S) 克隆链接 | ✘ |
| REPO_SSH_URL | 生成的仓库的 SSH 克隆链接 | ✘ |
| TEMPLATE_SSH_URL | 模板仓库的 SSH 克隆链接 | ✘ |
| REPO_NAME | 生成的儲存庫名稱 | ✓ |
| TEMPLATE_NAME | 模板儲存庫名稱 | ✓ |
| REPO_DESCRIPTION | 生成的儲存庫描述 | ✘ |
| TEMPLATE_DESCRIPTION | 模板儲存庫描述 | ✘ |
| REPO_OWNER | 生成的儲存庫所有者 | ✓ |
| TEMPLATE_OWNER | 模板儲存庫所有者 | ✓ |
| REPO_LINK | 生成的儲存庫鏈接 | ✘ |
| TEMPLATE_LINK | 模板儲存庫鏈接 | ✘ |
| REPO_HTTPS_URL | 生成的儲存庫的 HTTP(S) 克隆鏈接 | ✘ |
| TEMPLATE_HTTPS_URL | 模板儲存庫的 HTTP(S) 克隆鏈接 | ✘ |
| REPO_SSH_URL | 生成的儲存庫的 SSH 克隆鏈接 | ✘ |
| TEMPLATE_SSH_URL | 模板儲存庫的 SSH 克隆鏈接 | ✘ |
## 转换器 :robot:
## 轉換器 :robot:
Gitea `1.12.0` 添加了一些转换器以应用于上述适用的变量。
Gitea `1.12.0` 添加了一些轉換器以應用於上述適用的變量。
例如，要以 `PASCAL`-case 获取 `REPO_NAME`，你的模板应使用 `${REPO_NAME_PASCAL}`
例如，要以 `PASCAL`-case 獲取 `REPO_NAME`，你的模板應使用 `${REPO_NAME_PASCAL}`
将 `go-sdk` 传递给可用的转换器的效果如下...
將 `go-sdk` 傳遞給可用的轉換器的效果如下...
| 转换器 | 效果 |
| 轉換器 | 效果 |
| ------ | ------ |
| SNAKE | go_sdk |
| KEBAB | go-sdk |

6
i18n/zh-tw/docusaurus-plugin-content-docs/current/usage/repository/webhooks.md
View File

@@ -51,7 +51,7 @@ Gitea 支援以下對外 Webhook 整合：
### 設定 Webhook
建立 Webhook 時，主要設定項目包括：
建立 Webhook 時，主要設定專案包括：
- `Target URL`：接收投遞的目標位址。
- `HTTP Method`：通用 Webhook 通常使用 `POST`。
@@ -132,7 +132,7 @@ Gitea 也會同時送出對應的 GitHub 與 Gogs 風格標頭。
#### `Event` 與 `Event-Type`
某些 Gitea Webhook 訂閱會被歸類到同一個規範化事件名稱下。例如，issue 指派
投遞會歸類到 issue 事件群組：
投遞會歸類到 issue 事件羣組：
```http
X-Gitea-Event: issues
@@ -565,7 +565,7 @@ http_response_code(204);
#### `pull_request_review_approved`
當 pull request review 以核准形式提交時，會觸發此事件。
當 pull request review 以覈准形式提交時，會觸發此事件。
**動作類型：** `reviewed`