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
@@ -4,37 +4,37 @@ slug: "cargo"
sidebar_position: 5
---
# Cargo 软件包注册
# Cargo 軟體包註冊
您的用户或组织发布 [Cargo](https://doc.rust-lang.org/stable/cargo/) 软件包。
您的使用者或組織發佈 [Cargo](https://doc.rust-lang.org/stable/cargo/) 軟體包。
## 要求
若要使用 Cargo 软件包注册表, 您需要安 [Rust 和 Cargo](https://www.rust-lang.org/tools/install).
若要使用 Cargo 軟體包註冊表, 您需要安 [Rust 和 Cargo](https://www.rust-lang.org/tools/install).
Cargo 将可用软件包的信息存在一个存在 git 仓库中的软件包索引中。
这个仓库是与注册表交互所必需的。
下面的部分将介绍如何建它。
Cargo 将可用軟體包的信息存在一个存在 git 存放庫中的軟體包索引中。
这个存放庫是与註冊表交互所必需的。
下面的部分将介绍如何建它。
## 索引仓库
## 索引存放庫
Cargo 将可用软件包的信息存在一个存在 git 仓库中的软件包索引中。
在 Gitea 中,这个仓库有一个特殊的名叫做 `_cargo-index`
在上传软件包之后,它的元数据会自动写入索引中。
手动修改这个注册表的内容。
Cargo 将可用軟體包的信息存在一个存在 git 存放庫中的軟體包索引中。
在 Gitea 中,这个存放庫有一个特殊的名叫做 `_cargo-index`
在上传軟體包之后,它的元数据会自动写入索引中。
手动修改这个註冊表的内容。
用户或组织软件包设置页面允许建这个索引仓库以及配置文件。
使用者或組織軟體包设置页面允许建这个索引存放庫以及配置文件。
如果需要,此操作将重写配置文件。
例如,如果 Gitea 实例的域名已更改,这将非常有用。
如果存在 Gitea 中的软件包与索引注册表中的信息不同步,设置页面允许重建这个索引注册表。
这个操作将遍历注册表中的所有软件包,将它们的信息写入索引中。
如果有很多软件包,这个程可能需要一些时间。
如果存在 Gitea 中的軟體包与索引註冊表中的信息不同步,设置页面允许重建这个索引註冊表。
这个操作将遍历註冊表中的所有軟體包,将它们的信息写入索引中。
如果有很多軟體包,这个程可能需要一些时间。
## 配置软件包注册
## 配置軟體包註冊
要注册这个软件包注册表,必更新 Cargo 的配置。
将以下文本添加到位于当前用户主目中的配置文件中(例如 `~/.cargo/config.toml`):
要注册这个軟體包註冊表,必更新 Cargo 的配置。
将以下文本添加到位于当前使用者主目中的配置文件中(例如 `~/.cargo/config.toml`):
```
[registry]
@@ -48,43 +48,43 @@ index = "sparse+https://gitea.example.com/api/packages/{owner}/cargo/" # Sparse
git-fetch-with-cli = true
```
| 参数 | 描述 |
| 參數 | 描述 |
| ------- | ---------------- |
| `owner` | 软件包的所有者。 |
| `owner` | 軟體包的所有者。 |
如果这个注册表是私有的或者您想要发布新的软件包,您必配置您的凭据。
将凭据部分添加到位于当前用户主目中的凭据文件中(例如 `~/.cargo/credentials.toml`):
如果这个註冊表是私有的或者您想要發佈新的軟體包,您必配置您的凭据。
将凭据部分添加到位于当前使用者主目中的凭据文件中(例如 `~/.cargo/credentials.toml`):
```
[registries.gitea]
token = "Bearer {token}"
```
| 参数 | 描述 |
| 參數 | 描述 |
| ------- | ------------------------------------------------------------------------------------- |
| `token` | 您的[个人访问令牌](development/api-usage.md#通-api-认证) |
| `token` | 您的[个人访问令牌](development/api-usage.md#通-api-認證) |
## 发布软件
## 發佈軟體
在项目中运行以下命令来发布软件包:
在项目中运行以下命令来發佈軟體包:
```shell
cargo publish
```
如果已经存在同名和版本的软件包,您将无法发布新的软件包。您必先删除有的软件包。
如果已经存在同名和版本的軟體包,您将無法發佈新的軟體包。您必先删除有的軟體包。
## 安装软件
## 安裝軟體
要从软件包注册表安装软件包,请执行以下命令:
要从軟體包註冊表安裝軟體包,請執行以下命令:
```shell
cargo add {package_name}
```
| 参数 | 描述 |
| 參數 | 描述 |
| -------------- | ------------ |
| `package_name` | 软件包名。 |
| `package_name` | 軟體包名。 |
## 支持的命令