gitea/gitea-docs
1
0
Fork 0
mirror of https://gitea.com/gitea/docs.git synced 2026-07-23 13:07: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

156
i18n/zh-tw/docusaurus-plugin-content-docs/version-1.24/usage/issue-pull-request-templates.md
View File

@@ -7,37 +7,37 @@ aliases:
- /zh-tw/issue-pull-request-templates
---
# 从模板建立工單与合並請求
# 從模板建立工單與合併請求
开发者可以利用问题模板建立工單与合並請求，其目的在于规范参与者的语言表达。
開發者可以利用問題模板建立工單與合併請求，其目的在於規範參與者的語言表達。
## 模板介绍
## 模板介紹
Gitea 支持两种格式的模板：Markdown 和 YAML。
Gitea 支援兩種格式的模板：Markdown 和 YAML。
### Markdown 模板
在 Gitea 中存在两种用途的 Markdown 模板：
在 Gitea 中存在兩種用途的 Markdown 模板：
- `ISSUE_TEMPLATE/bug-report.md` 用于规范工單的 Markdown 文本描述
- `PULL_REQUEST_TEMPLATE.md` 用于规范合並請求的 Markdown 文本描述
- `ISSUE_TEMPLATE/bug-report.md` 用於規範工單的 Markdown 文本描述
- `PULL_REQUEST_TEMPLATE.md` 用於規範合併請求的 Markdown 文本描述
對於以上 Markdown 模板，我们推荐您将它们放置到项目目錄 `.gitea` 進行收纳。
對於以上 Markdown 模板，我們推薦您將它們放置到專案目錄 `.gitea` 進行收納。
### YAML 模板
用 YAML 语法编写的模板相比 Markdown 可以实現更丰富的功能，利用表單实現诸如：问卷调查、字符校验。在 Gitea 中的 YAML 同样支持两种用途：
用 YAML 語法編寫的模板相比 Markdown 可以實現更豐富的功能，利用表單實現諸如：問卷調查、字符校驗。在 Gitea 中的 YAML 同樣支援兩種用途：
- `ISSUE_TEMPLATE/bug-report.yaml` 用于建立问卷调查形式的工單
- `PULL_REQUEST_TEMPLATE.yaml` 用于建立表單形式的合並請求
- `ISSUE_TEMPLATE/bug-report.yaml` 用於建立問卷調查形式的工單
- `PULL_REQUEST_TEMPLATE.yaml` 用於建立表單形式的合併請求
對於以上 YAML 模板，我们同样推荐您将它们放置到项目目錄 `.gitea` 進行收纳。
對於以上 YAML 模板，我們同樣推薦您將它們放置到專案目錄 `.gitea` 進行收納。
##### 表單支持通過 URL 查询參數传值
##### 表單支援通過 URL 查詢參數傳值
当新建工單页面 URL 以 `?title=Issue+Title&body=Issue+Text` 為查询參數，表單将使用其中的參數（key-value）填充表單内容。
當新建工單頁面 URL 以 `?title=Issue+Title&body=Issue+Text` 為查詢參數，表單將使用其中的參數（key-value）填充表單內容。
### Gitea 支持的模板文件路径
### Gitea 支援的模板文件路徑
工單模板文件名:
@@ -60,7 +60,7 @@ Gitea 支持两种格式的模板：Markdown 和 YAML。
- `.github/issue_template.yaml`
- `.github/issue_template.yml`
合並請求模板:
合併請求模板:
- `PULL_REQUEST_TEMPLATE.md`
- `PULL_REQUEST_TEMPLATE.yaml`
@@ -83,7 +83,7 @@ Gitea 支持两种格式的模板：Markdown 和 YAML。
#### 工單模板目錄
由于工單存在多种類型，Gitea 支持将工單模板统一收纳到 `ISSUE_TEMPLATE` 目錄。以下是 Gitea 支持的工單模板目錄:
由於工單存在多種類型，Gitea 支援將工單模板統一收納到 `ISSUE_TEMPLATE` 目錄。以下是 Gitea 支援的工單模板目錄:
- `ISSUE_TEMPLATE`
- `issue_template`
@@ -94,9 +94,9 @@ Gitea 支持两种格式的模板：Markdown 和 YAML。
- `.gitlab/ISSUE_TEMPLATE`
- `.gitlab/issue_template`
目錄支持混合存放 Markdown (`.md`) 或 YAML (`.yaml`/`.yml`) 格式的工單模板。另外，合並請求模板不支持目錄存放。
目錄支援混合存放 Markdown (`.md`) 或 YAML (`.yaml`/`.yml`) 格式的工單模板。另外，合併請求模板不支援目錄存放。
## Markdown 模板语法
## Markdown 模板語法
```md
---
@@ -112,24 +112,24 @@ labels:
This is the template!
```
上面的示例表示使用者从列表中選择一个工單模板时，列表会展示模板名稱 `Template Name` 和模板描述 `This template is for testing!`。 同时，标题会预先填充為 `[TEST]`，而正文将预先填充 `This is the template!`。該 Issue 会被指派给 `user1`。 最后，Issue 還会被分配两个標籤，`bug` 和 `help needed`，並且将问题指向 `main` 分支。
上面的範例表示使用者從列表中選擇一個工單模板時，列表會展示模板名稱 `Template Name` 和模板描述 `This template is for testing!`。 同時，標題會預先填充為 `[TEST]`，而正文將預先填充 `This is the template!`。該 Issue 會被指派給 `user1`。 最後，Issue 還會被分配兩個標籤，`bug` 和 `help needed`，並且將問題指向 `main` 分支。
## YAML 模板语法
## YAML 模板語法
YAML 模板格式如下，相比 Markdown 模板提供了更多实用性的功能。
YAML 模板格式如下，相比 Markdown 模板提供了更多實用性的功能。
```yaml
name: 表單名稱
about: 表單描述
title: 默认标题
body: 主體内容
type: 定义表單元素類型
id: 定义表單标号
attributes: 扩展的属性
validations: 内容校验
title: 默認標題
body: 主體內容
type: 定義表單元素類型
id: 定義表單標號
attributes: 擴展的屬性
validations: 內容校驗
```
下例 YAML 配置文件完整定义了一个用于提交 bug 的问卷调查。
下例 YAML 設定文件完整定義了一個用於提交 bug 的問卷調查。
```yaml
name: Bug Report
@@ -195,89 +195,89 @@ body:
### Markdown 段落
您可以在 YAML 模板中使用 `markdown` 元素為开发者提供额外的上下文支撑，这部分内容会作為建立工單的提示但不会作為工單内容提交。
您可以在 YAML 模板中使用 `markdown` 元素為開發者提供額外的上下文支撐，這部分內容會作為建立工單的提示但不會作為工單內容提交。
`attributes` 子项提供了以下扩展能力：
`attributes` 子項提供了以下擴展能力：
| 键 | 描述 | 必選 | 類型 | 默认值 | 有效值 |
| 鍵 | 描述 | 必選 | 類型 | 預設值 | 有效值 |
| ------- | ------------------------------ | ---- | ------ | ------ | ------ |
| `value` | 渲染的文本。支持 Markdown 格式 | 必選 | 字符串 | - | - |
| `value` | 渲染的文本。支援 Markdown 格式 | 必選 | 字符串 | - | - |
### Textarea 多行文本输入框
### Textarea 多行文本輸入框
您可以使用 `textarea` 元素在表單中添加多行文本输入框。 除了输入文本，开发者還可以在 `textarea` 区域附加文件。
您可以使用 `textarea` 元素在表單中添加多行文本輸入框。 除了輸入文本，開發者還可以在 `textarea` 區域附加文件。
`attributes` 子项提供了以下扩展能力：
`attributes` 子項提供了以下擴展能力：
| 键 | 描述 | 必選 | 類型 | 默认值 | 有效值 |
| 鍵 | 描述 | 必選 | 類型 | 預設值 | 有效值 |
| ------------- | ----------------------------------------------------------------------------------------------------- | ---- | ------ | -------- | ------------------ |
| `label` | 预期使用者输入的简短描述，也以表單形式显示。 | 必選 | 字符串 | - | - |
| `description` | 提供上下文或指导的文本区域的描述，以表單形式显示。 | 可選 | 字符串 | 空字符串 | - |
| `placeholder` | 半透明的占位符，在文本区域空白时呈現 | 可選 | 字符串 | 空字符串 | - |
| `value` | 在文本区域中预填充的文本。 | 可選 | 字符串 | - | - |
| `render` | 如果提供了值，提交的文本将格式化為代码块。 提供此键时，文本区域将不会扩展到文件附件或 Markdown 编辑。 | 可選 | 字符串 | - | Gitea 支持的语言。 |
| `label` | 預期使用者輸入的簡短描述，也以表單形式顯示。 | 必選 | 字符串 | - | - |
| `description` | 提供上下文或指導的文本區域的描述，以表單形式顯示。 | 可選 | 字符串 | 空字符串 | - |
| `placeholder` | 半透明的佔位符，在文本區域空白時呈現 | 可選 | 字符串 | 空字符串 | - |
| `value` | 在文本區域中預填充的文本。 | 可選 | 字符串 | - | - |
| `render` | 如果提供了值，提交的文本將格式化為程式碼塊。 提供此鍵時，文本區域將不會擴展到文件附件或 Markdown 編輯。 | 可選 | 字符串 | - | Gitea 支援的語言。 |
`validations` 子项提供以下文本校验參數：
`validations` 子項提供以下文本校驗參數：
| 键 | 描述 | 必選 | 類型 | 默认值 | 有效值 |
| 鍵 | 描述 | 必選 | 類型 | 預設值 | 有效值 |
| ---------- | ---------------------------- | ---- | ------ | ------ | ------ |
| `required` | 防止在元素完成之前提交表單。 | 可選 | 布尔型 | false | - |
| `required` | 防止在元素完成之前提交表單。 | 可選 | 布爾型 | false | - |
### Input 單行输入框
### Input 單行輸入框
您可以使用 `input` 元素添加單行文本字段到表單。
您可以使用 `input` 元素添加單行文本欄位到表單。
`attributes` 子项提供了以下扩展能力：
`attributes` 子項提供了以下擴展能力：
| 键 | 描述 | 必選 | 類型 | 默认值 | 有效值 |
| 鍵 | 描述 | 必選 | 類型 | 預設值 | 有效值 |
| ------------- | ---------------------------------------------- | ---- | ------ | -------- | ------ |
| `label` | 预期使用者输入的简短描述，也以表單形式显示。 | 必選 | 字符串 | - | - |
| `description` | 提供上下文或指导的字段的描述，以表單形式显示。 | 可選 | 字符串 | 空字符串 | - |
| `placeholder` | 半透明的占位符，在字段空白时呈現。 | 可選 | 字符串 | 空字符串 | - |
| `value` | 字段中预填的文本。 | 可選 | 字符串 | - | - |
| `label` | 預期使用者輸入的簡短描述，也以表單形式顯示。 | 必選 | 字符串 | - | - |
| `description` | 提供上下文或指導的欄位的描述，以表單形式顯示。 | 可選 | 字符串 | 空字符串 | - |
| `placeholder` | 半透明的佔位符，在欄位空白時呈現。 | 可選 | 字符串 | 空字符串 | - |
| `value` | 欄位中預填的文本。 | 可選 | 字符串 | - | - |
`validations` 子项提供以下文本校验參數：
`validations` 子項提供以下文本校驗參數：
| 键 | 描述 | 必選 | 類型 | 默认值 | 有效值 |
| 鍵 | 描述 | 必選 | 類型 | 預設值 | 有效值 |
| ----------- | -------------------------------- | ---- | ------ | ------ | -------------------------------------------------------------- |
| `required` | 防止在未填内容时提交表單。 | 可選 | 布尔型 | false | - |
| `is_number` | 防止在未填数字时提交表單。 | 可選 | 布尔型 | false | - |
| `regex` | 直到满足了与正则表达式匹配的值。 | 可選 | 字符串 | - | [正则表达式](https://en.wikipedia.org/wiki/Regular_expression) |
| `required` | 防止在未填內容時提交表單。 | 可選 | 布爾型 | false | - |
| `is_number` | 防止在未填數字時提交表單。 | 可選 | 布爾型 | false | - |
| `regex` | 直到滿足了與正則表達式匹配的值。 | 可選 | 字符串 | - | [正則表達式](https://en.wikipedia.org/wiki/Regular_expression) |
### Dropdown 下拉菜單
您可以使用 `dropdown` 元素在表單中添加下拉菜單。
`attributes` 子项提供了以下扩展能力：
`attributes` 子項提供了以下擴展能力：
| 键 | 描述 | 必選 | 類型 | 默认值 | 有效值 |
| 鍵 | 描述 | 必選 | 類型 | 預設值 | 有效值 |
| ------------- | --------------------------------------------------------- | ---- | ---------- | -------- | ------ |
| `label` | 预期使用者输入的简短描述，以表單形式显示。 | 必選 | 字符串 | - | - |
| `description` | 提供上下文或指导的下拉列表的描述，以表單形式显示。 | 可選 | 字符串 | 空字符串 | - |
| `multiple` | 确定使用者是否可以選择多个選项。 | 可選 | 布尔型 | false | - |
| `options` | 使用者可以選择的選项列表。 不能為空，所有選择必須是不同的。 | 必選 | 字符串数组 | - | - |
| `label` | 預期使用者輸入的簡短描述，以表單形式顯示。 | 必選 | 字符串 | - | - |
| `description` | 提供上下文或指導的下拉列表的描述，以表單形式顯示。 | 可選 | 字符串 | 空字符串 | - |
| `multiple` | 確定使用者是否可以選擇多個選項。 | 可選 | 布爾型 | false | - |
| `options` | 使用者可以選擇的選項列表。 不能為空，所有選擇必須是不同的。 | 必選 | 字符串數組 | - | - |
`validations` 子项提供以下文本校验參數：
`validations` 子項提供以下文本校驗參數：
| 键 | 描述 | 必選 | 類型 | 默认值 | 有效值 |
| 鍵 | 描述 | 必選 | 類型 | 預設值 | 有效值 |
| ---------- | ---------------------------- | ---- | ------ | ------ | ------ |
| `required` | 防止在元素完成之前提交表單。 | 可選 | 布尔型 | false | - |
| `required` | 防止在元素完成之前提交表單。 | 可選 | 布爾型 | false | - |
### Checkboxes 复選框
### Checkboxes 復選框
您可以使用 `checkboxes` 元素添加一组复選框到表單。
您可以使用 `checkboxes` 元素添加一組復選框到表單。
`attributes` 子项提供了以下扩展能力：
`attributes` 子項提供了以下擴展能力：
| 键 | 描述 | 必選 | 類型 | 默认值 | 有效值 |
| 鍵 | 描述 | 必選 | 類型 | 預設值 | 有效值 |
| ------------- | ----------------------------------------------------- | ---- | ------ | -------- | ------ |
| `label` | 预期使用者输入的简短描述，以表單形式显示。 | 必選 | 字符串 | - | - |
| `description` | 复選框集的描述，以表單形式显示。 支持 Markdown 格式。 | 可選 | 字符串 | 空字符串 | - |
| `options` | 使用者可以選择的复選框列表。 有关语法，請参阅下文。 | 必選 | 数组 | - | - |
| `label` | 預期使用者輸入的簡短描述，以表單形式顯示。 | 必選 | 字符串 | - | - |
| `description` | 復選框集的描述，以表單形式顯示。 支援 Markdown 格式。 | 可選 | 字符串 | 空字符串 | - |
| `options` | 使用者可以選擇的復選框列表。 有關語法，請參閱下文。 | 必選 | 數組 | - | - |
對於 `options`，您可以设置以下參數：
對於 `options`，您可以設定以下參數：
| 键 | 描述 | 必選 | 類型 | 默认值 | 有效值 |
| 鍵 | 描述 | 必選 | 類型 | 預設值 | 有效值 |
| ---------- | --------------------------------------------------------------------------------- | ---- | ------ | ------ | ------ |
| `label` | 選项的标识符，显示在表單中。 支持 Markdown 用于粗體或斜體文本格式化和超文本链接。 | 必選 | 字符串 | - | - |
| `required` | 防止在元素完成之前提交表單。 | 可選 | 布尔型 | false | - |
| `label` | 選項的標識符，顯示在表單中。 支援 Markdown 用於粗體或斜體文本格式化和超文本鏈接。 | 必選 | 字符串 | - | - |
| `required` | 防止在元素完成之前提交表單。 | 可選 | 布爾型 | false | - |