mirror of
https://gitea.com/gitea/docs.git
synced 2026-07-22 12:07:51 +00:00
Update zh tw languages and fix some broken links (#455)
--------- Co-authored-by: silverwind <me@silverwind.io> Co-authored-by: silverwind <2021+silverwind@noreply.gitea.com> Reviewed-on: https://gitea.com/gitea/docs/pulls/455 Reviewed-by: silverwind <2021+silverwind@noreply.gitea.com>
This commit is contained in:
@@ -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 中的软件包与索引注册表中的信息不同步,设置页面允许重建这个索引注册表。
|
||||
这个操作将遍历注册表中的所有软件包,并将它们的信息写入索引中。
|
||||
如果有很多软件包,这个过程可能需要一些时间。
|
||||
如果儲存在 Gitea 中的套件與索引註冊表中的資訊不同步,設定頁面允許重建這個索引註冊表。
|
||||
這個操作將遍歷註冊表中的所有套件,並將它們的資訊寫入索引中。
|
||||
如果有很多套件,這個過程可能需要一些時間。
|
||||
|
||||
## 配置软件包注册表
|
||||
## 設定套件註冊表
|
||||
|
||||
要注册这个软件包注册表,必须更新 Cargo 的配置。
|
||||
将以下文本添加到位于当前用户主目录中的配置文件中(例如 `~/.cargo/config.toml`):
|
||||
要註冊這個套件註冊表,必須更新 Cargo 的設定。
|
||||
將以下文本添加到位於當前使用者主目錄中的設定文件中(例如 `~/.cargo/config.toml`):
|
||||
|
||||
```
|
||||
[registry]
|
||||
@@ -48,45 +48,45 @@ 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` | 套件名稱。 |
|
||||
|
||||
## 支持的命令
|
||||
## 支援的命令
|
||||
|
||||
```
|
||||
cargo publish
|
||||
|
||||
Reference in New Issue
Block a user