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

@@ -4,17 +4,17 @@ slug: "swift"
sidebar_position: 115
---
# Swift 软件包注册
# Swift 軟體包註冊
您的用户或组织发布 [Swift](https://www.swift.org/) 软件包。
您的使用者或組織發佈 [Swift](https://www.swift.org/) 軟體包。
## 要求
要使用 Swift 软件包注册表,您需要使用 [swift](https://www.swift.org/getting-started/) 消费软件包,使用 HTTP 客户端(如 `curl`发布软件包。
要使用 Swift 軟體包註冊表,您需要使用 [swift](https://www.swift.org/getting-started/) 消费軟體包,使用 HTTP 客户端(如 `curl`發佈軟體包。
## 配置软件包注册
## 配置軟體包註冊
要注册软件包注册表并提供凭据,请执行以下命令:
要注册軟體包註冊表並提供凭据,請執行以下命令:
```shell
swift package-registry set https://gitea.example.com/api/packages/{owner}/swift -login {username} -password {password}
@@ -22,21 +22,21 @@ swift package-registry set https://gitea.example.com/api/packages/{owner}/swift
| 占位符 | 描述 |
| ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `owner` | 软件包的所有者。 |
| `username` | 您的 Gitea 用户名。 |
| `password` | 您的 Gitea 密。如果您使用两步验证或 OAuth使用[个人访问令牌](development/api-usage.md#通-api-认证)代替密。 |
| `owner` | 軟體包的所有者。 |
| `username` | 您的 Gitea 使用者名。 |
| `password` | 您的 Gitea 密。如果您使用两步驗證或 OAuth使用[个人访问令牌](development/api-usage.md#通-api-認證)代替密。 |
是可的,只有在软件包注册表是私有的情况下才需要。
是可的,只有在軟體包註冊表是私有的情况下才需要。
## 发布软件
## 發佈軟體
首先,您需要打包软件包的内容:
首先,您需要打包軟體包的内容:
```shell
swift package archive-source
```
发布软件包,请执行一个带有软件包内容的 HTTP `PUT` 求,将内容放在求正文中。
發佈軟體包,請執行一个带有軟體包内容的 HTTP `PUT` 求,将内容放在求正文中。
```shell --user your_username:your_password_or_token \
curl -X PUT --user {username}:{password} \
@@ -48,19 +48,19 @@ curl -X PUT --user {username}:{password} \
| 占位符 | 描述 |
| ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `username` | 您的 Gitea 用户名。 |
| `password` | 您的 Gitea 密。如果您使用两步验证或 OAuth使用[个人访问令牌](development/api-usage.md#通-api-认证)代替密。 |
| `owner` | 软件包的所有者。 |
| `scope` | 软件包的作用域。 |
| `name` | 软件包的名。 |
| `version` | 软件包的版本。 |
| `metadata` | (可选)软件包的元数据。以 JSON 编码的子集,格式参考 https://schema.org/SoftwareSourceCode |
| `username` | 您的 Gitea 使用者名。 |
| `password` | 您的 Gitea 密。如果您使用两步驗證或 OAuth使用[个人访问令牌](development/api-usage.md#通-api-認證)代替密。 |
| `owner` | 軟體包的所有者。 |
| `scope` | 軟體包的作用域。 |
| `name` | 軟體包的名。 |
| `version` | 軟體包的版本。 |
| `metadata` | (可選)軟體包的元数据。以 JSON 编码的子集,格式参考 https://schema.org/SoftwareSourceCode |
如果已经存在相同名和版本的软件包,则无法发布软件包。您必首先删除有的软件包。
如果已经存在相同名和版本的軟體包,则無法發佈軟體包。您必首先删除有的軟體包。
## 安装软件
## 安裝軟體
要从软件包注册表安 Swift 软件包,将其添加到 `Package.swift` 文件的依赖项列表中:
要从軟體包註冊表安 Swift 軟體包,将其添加到 `Package.swift` 文件的依赖项列表中:
```
dependencies: [
@@ -68,13 +68,13 @@ dependencies: [
]
```
| 参数 | 描述 |
| 參數 | 描述 |
| --------- | -------------- |
| `scope` | 软件包的作用域 |
| `name` | 软件包的名 |
| `version` | 软件包的版本 |
| `scope` | 軟體包的作用域 |
| `name` | 軟體包的名 |
| `version` | 軟體包的版本 |
之后,行以下命令来安它:
之后,行以下命令来安它:
```shell
swift package resolve