docs: update zh-tw (#265)

Reviewed-on: https://gitea.com/gitea/docs/pulls/265
Reviewed-by: Lunny Xiao <[email protected]>
Co-authored-by: ifurther <[email protected]>
Co-committed-by: ifurther <[email protected]>
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
@@ -9,29 +9,29 @@ aliases:
# 嵌入资源提取工具
Gitea 的可行文件包含了运行所需的所有资源:模板、图片、样式表和翻译文件。你可以通`custom`下的相路径中放置替换文件来覆盖其中的任何资源(详见 [自定义 Gitea 配置](../administration/customizing-gitea.md))。
Gitea 的可行文件包含了运行所需的所有资源:模板、图片、样式表和翻译文件。你可以通`custom`下的相路径中放置替换文件来覆盖其中的任何资源(详见 [自定义 Gitea 配置](../administration/customizing-gitea.md))。
要获取嵌入资源的副本以行编辑,可以使用 CLI 中的 `embedded` 命令,通操作系统的 shell 行。
要获取嵌入资源的副本以行编辑,可以使用 CLI 中的 `embedded` 命令,通操作系统的 shell 行。
**注意:** 嵌入资源提取工具包含在 Gitea 1.12 及以上版本中。
## 资源列表
要列出嵌入在 Gitea 可行文件中的资源,使用以下语法:
要列出嵌入在 Gitea 可行文件中的资源,使用以下语法:
```sh
gitea embedded list [--include-vendored] [patterns...]
```
`--include-vendored` 标志使命令包括被供的文件,这些文件通常被排除在外;即来自外部库的文件,这些文件是 Gitea 所需的(例如 [octicons](https://octicons.github.com/) 等)。
`--include-vendored` 标志使命令包括被供的文件,这些文件通常被排除在外;即来自外部库的文件,这些文件是 Gitea 所需的(例如 [octicons](https://octicons.github.com/) 等)。
可以提供一系列文件搜索模式。Gitea 使用 [gobwas/glob](https://github.com/gobwas/glob) 作其 glob 语法。以下是一些示例:
可以提供一系列文件搜索模式。Gitea 使用 [gobwas/glob](https://github.com/gobwas/glob) 作其 glob 语法。以下是一些示例:
- 列出所有模板文件,论在哪个虚拟目下:`**.tmpl`
- 列出所有模板文件,论在哪个虚拟目下:`**.tmpl`
- 列出所有邮件模板文件:`templates/mail/**.tmpl`
列出 `public/assets/img`下的所有文件:`public/assets/img/**`
列出 `public/assets/img`下的所有文件:`public/assets/img/**`
不要忘记模式使用引号,因空格、`*` 和其他字符可能对命令行解释器有特殊含义。
不要忘记模式使用引号,因空格、`*` 和其他字符可能对命令行解释器有特殊含义。
如果未提供模式,则列出所有文件。
@@ -53,31 +53,31 @@ templates/user/settings/security_openid.tmpl
## 提取资源
要提取嵌入在 Gitea 可行文件中的资源,使用以下语法:
要提取嵌入在 Gitea 可行文件中的资源,使用以下语法:
```sh
gitea [--config {file}] embedded extract [--destination {dir}|--custom] [--overwrite|--rename] [--include-vendored] {patterns...}
```
`--config` 项用于告知 Gitea `app.ini` 配置文件的位置(如果不在默认位置)。此选项仅在使用 `--custom` 标志时使用。
`--config` 项用于告知 Gitea `app.ini` 配置文件的位置(如果不在默认位置)。此選项僅在使用 `--custom` 标志时使用。
`--destination` 项用于指定提取文件的目标目。默认当前目
`--destination` 项用于指定提取文件的目标目。默认当前目
`--custom` 标志告知 Gitea 直接将文件提取到 `custom`中。使其正常工作,命令需要知道 `app.ini` 配置文件的位置(通 `--config` 指定),且根据配置的不同,需要从 Gitea 通常启动的目运行。有关详细信息,参阅 [自定义 Gitea 配置](../administration/customizing-gitea.md)。
`--custom` 标志告知 Gitea 直接将文件提取到 `custom`中。使其正常工作,命令需要知道 `app.ini` 配置文件的位置(通 `--config` 指定),且根据配置的不同,需要从 Gitea 通常启动的目运行。有关详细信息,参阅 [自定义 Gitea 配置](../administration/customizing-gitea.md)。
`--overwrite` 标志允许覆盖目标目中的任何有文件。
`--overwrite` 标志允许覆盖目标目中的任何有文件。
`--rename` 标志告知 Gitea 将目标目中的任何有文件重命名 `filename.bak`。之前的 `.bak` 文件将被覆盖。
`--rename` 标志告知 Gitea 将目标目中的任何有文件重命名 `filename.bak`。之前的 `.bak` 文件将被覆盖。
至少需要提供一个文件搜索模式;有关模式的语法和示例,参阅上述 `list` 子命令。
至少需要提供一个文件搜索模式;有关模式的语法和示例,参阅上述 `list` 子命令。
### 重要提示
确保**只提取需要自定义的文件**。位于 `custom`中的文件不会受到 Gitea 的升级程的影。当 Gitea 升级到新版本(通替换可行文件)时,许多嵌入文件将发生变化。Gitea 将尊重使用在 `custom`中找到的任何文件,即使这些文件是旧的和不兼容的。
确保**只提取需要自定义的文件**。位于 `custom`中的文件不会受到 Gitea 的升级程的影。当 Gitea 升级到新版本(通替换可行文件)时,许多嵌入文件将发生变化。Gitea 将尊重使用在 `custom`中找到的任何文件,即使这些文件是旧的和不兼容的。
### 示例:提取邮件模板
将邮件模板提取到临时目
将邮件模板提取到临时目
```sh
$ mkdir tempdir