Add version v28 (#564)

Preview: https://pr-564.docs-gitea-com.pages.dev Reviewed-on: https://gitea.com/gitea/docs/pulls/564 Reviewed-by: bircni <[email protected]> Co-authored-by: Lunny Xiao <[email protected]>
2026-11-07 10:30:32 +00:00 · 2026-09-30 06:40:44 +00:00
1 parent deb2f068d4
commit ba60edbbda
@@ -0,0 +1,9 @@
+{
+  "label": "Access Control",
+  "position": 100,
+  "link": {
+    "type": "generated-index",
+    "slug": "/usage/access-control",
+    "description": "Permissions, security, and access control features"
+  }
+}
@@ -0,0 +1,77 @@
+---
+date: "2023-05-23T09:00:00+08:00"
+slug: "permissions"
+sidebar_position: 14
+aliases:
+  - /zh-tw/permissions
+---
+
+# 權限
+
+Gitea 支援對儲存庫進行權限管理，這樣您就可以為不同的人員提供不同的存取權限。首先，我們需要了解 `單元（Unit）`。
+
+## 單元（Unit）
+
+在 Gitea 中，我們將儲存庫的子模組稱為 `單元（Unit）`。現在我們有以下幾個單元。
+
+| 名稱           | 描述                               | 權限      |
+| -------------- | ---------------------------------- | --------- |
+| 程式碼           | 訪問源程式碼、文件、提交和分支。     | 讀取 寫入 |
+| 工單           | 組織缺陷報告、任務和里程碑。       | 讀取 寫入 |
+| 合併請求       | 啟用合併請求和程式碼審覈。           | 讀取 寫入 |
+| 發佈           | 跟蹤專案版本和下載。               | 讀取 寫入 |
+| 百科           | 與協作者編寫和共享文件。           | 讀取 寫入 |
+| 外部百科       | 鏈接到外部維基。                   | 讀取      |
+| 外部工單跟蹤器 | 鏈接到外部工單跟蹤器。             | 讀取      |
+| 專案           | 模板儲存庫的 URL。                   | 讀取 寫入 |
+| 包             | 鏈接到儲存庫                         | 讀取 寫入 |
+| Actions        | 審查 Actions 日誌或重啟/取消工作流 | 讀取 寫入 |
+| 設定           | 管理儲存庫。                         | 管理員    |
+
+通過不同的權限，使用者可以在這些單元上執行不同的操作。
+
+| 名稱           | 讀取                             | 寫入                           | 管理員   |
+| -------------- | -------------------------------- | ------------------------------ | -------- |
+| 程式碼           | 查看程式碼樹、文件、提交、分支等。 | 推送程式碼。                     | -        |
+| 工單           | 查看工單並建立新工單。           | 添加標籤、分配、關閉工單。     | -        |
+| 合併請求       | 查看合併請求並建立新合併請求。   | 添加標籤、分配、關閉合併請求。 | -        |
+| 發佈           | 查看發佈和下載文件。             | 建立/編輯發佈。                | -        |
+| 百科           | 查看百科頁面。克隆百科儲存庫。     | 建立/編輯百科頁面，推送更改。  | -        |
+| 外部百科       | 鏈接到外部百科。                 | -                              | -        |
+| 外部工單跟蹤器 | 鏈接到外部工單跟蹤器。           | -                              | -        |
+| 專案           | 查看面板。                       | 在面板之間移動工單。           | -        |
+| 包             | 查看包                           | 上傳/刪除包                    | -        |
+| Actions        | 查看 Actions 日誌                | 同意 / 取消 / 重啟             | -        |
+| 設定           | -                                | -                              | 管理儲存庫 |
+
+個人儲存庫和組織儲存庫之間的權限存在一些差異。
+
+## 個人儲存庫
+
+對於個人儲存庫，建立者是儲存庫的唯一所有者，對於該儲存庫的任何更改或刪除沒有限制。
+儲存庫所有者可以添加協作者來幫助維護儲存庫。協作者可以擁有 `讀取（Read）`、`寫入（Write）` 和 `管理員（Admin）` 權限。
+
+訪問私有儲存庫的體驗與訪問匿名公共儲存庫類似。您可以訪問儲存庫中的所有可用內容，包括克隆程式碼、建立工單、回覆工單評論、提交拉取請求等。如果你有 "寫"權限，只要分支保護規則允許，你就可以向儲存庫的特定分支推送程式碼。此外，你還可以修改百科頁面。有了 "管理"權限，你就可以修改儲存庫的設定。
+
+但如果你不是該儲存庫的所有者，就不能刪除或轉移該儲存庫。
+
+## 組織儲存庫
+
+對於個人儲存庫，所有者是建立它的使用者。而對於組織儲存庫，所有者是該組織中的所有者團隊成員。對該組織儲存庫的所有權限都取決於團隊權限設定。
+
+### 所有者團隊
+
+建立組織時將自動建立所有者團隊，建立者將成為所有者團隊的第一名成員。所有者團隊不可刪除，且至少有一名成員。
+
+### 管理員團隊
+
+建立團隊時，有兩種類型的團隊。一種是管理員團隊，另一種是普通團隊。可以建立一個管理員團隊來管理某些版本庫，其成員可以對這些版本庫做任何事情。只有所有者或管理員團隊的成員才能建立新團隊。
+
+### 普通團隊
+
+組織中的普通團隊具有可以根據`單元(Unit)`進行權限設定。它可以有成員和儲存庫範圍。
+
+- 一個團隊可以訪問所屬組織的所有儲存庫或特殊儲存庫。
+- 也可以設定該團隊是否有建立新儲存庫的權限。
+
+可以透過建立 "普通團隊"，並通過權限控制對其行為進行限制。一名成員可以加入多個團隊。
@@ -0,0 +1,46 @@
+---
+date: "2023-05-23T09:00:00+08:00"
+slug: "protected-tags"
+sidebar_position: 45
+aliases:
+  - /zh-tw/protected-tags
+---
+
+# 受保護的標籤
+
+受保護的標籤允許控制誰有權限建立或更新 Git 標籤。每個規則可以匹配單個標籤名稱，或者使用適當的模式來同時控制多個標籤。
+
+## 設定受保護的標籤
+
+要保護一個標籤，你需要按照以下步驟進行操作：
+
+1. 進入儲存庫的**設定** > **標籤**頁面。
+2. 輸入一個用於匹配名稱的模式。你可以使用單個名稱、[glob 模式](https://pkg.go.dev/github.com/gobwas/glob#Compile) 或正則表達式。
+3. 選擇允許的使用者和/或團隊。如果將這些欄位留空，則不允許任何人建立或修改此標籤。
+4. 選擇**保存**以保存設定。
+
+## 模式受保護的標籤
+
+該模式使用 [glob](https://pkg.go.dev/github.com/gobwas/glob#Compile) 或正則表達式來匹配標籤名稱。對於正則表達式，你需要將模式括在斜槓中。
+
+範例：
+
+| 類型  | 模式受保護的標籤         | 可能匹配的標籤                          |
+| ----- | ------------------------ | --------------------------------------- |
+| Glob  | `v*`                     | `v`，`v-1`，`version2`                  |
+| Glob  | `v[0-9]`                 | `v0`，`v1` 到 `v9`                      |
+| Glob  | `*-release`              | `2.1-release`，`final-release`          |
+| Glob  | `gitea`                  | 僅限 `gitea`                            |
+| Glob  | `*gitea*`                | `gitea`，`2.1-gitea`，`1_gitea-release` |
+| Glob  | `{v,rel}-*`              | `v-`，`v-1`，`v-final`，`rel-`，`rel-x` |
+| Glob  | `*`                      | 匹配所有可能的標籤名稱                  |
+| Regex | `/\Av/`                  | `v`，`v-1`，`version2`                  |
+| Regex | `/\Av[0-9]\z/`           | `v0`，`v1` 到 `v9`                      |
+| Regex | `/\Av\d+\.\d+\.\d+\z/`   | `v1.0.17`，`v2.1.0`                     |
+| Regex | `/\Av\d+(\.\d+){0,2}\z/` | `v1`，`v2.1`，`v1.2.34`                 |
+| Regex | `/-release\z/`           | `2.1-release`，`final-release`          |
+| Regex | `/gitea/`                | `gitea`，`2.1-gitea`，`1_gitea-release` |
+| Regex | `/\Agitea\z/`            | 僅限 `gitea`                            |
+| Regex | `/^gitea$/`              | 僅限 `gitea`                            |
+| Regex | `/\A(v\|rel)-/`          | `v-`，`v-1`，`v-final`，`rel-`，`rel-x` |
+| Regex | `/.+/`                   | 匹配所有可能的標籤名稱                  |