docs: update zh-tw (#265)

Reviewed-on: https://gitea.com/gitea/docs/pulls/265
Reviewed-by: Lunny Xiao <xiaolunwen@gmail.com>
Co-authored-by: ifurther <55025025+ifurther@users.noreply.github.com>
Co-committed-by: ifurther <55025025+ifurther@users.noreply.github.com>
This commit is contained in:
ifurther
2025-09-03 21:00:35 +00:00
committed by techknowlogick
parent 908a27589d
commit cb462089e9
88 changed files with 3545 additions and 3423 deletions

View File

@@ -6,62 +6,62 @@ 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` 文件示例
所有路径都是相对于仓库的根目
所有路径都是相對於存放庫的根目
```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:
Gitea `1.12.0` 添加了一些转换器以用于上述适用的变量。
Gitea `1.12.0` 添加了一些转换器以用于上述适用的变量。
例如,要以 `PASCAL`-case 获取 `REPO_NAME`,你的模板使用 `${REPO_NAME_PASCAL}`
例如,要以 `PASCAL`-case 获取 `REPO_NAME`,你的模板使用 `${REPO_NAME_PASCAL}`
`go-sdk` 传递给可用的转换器的效果如下...