gitea/gitea-docs
1
0
Fork 0
mirror of https://gitea.com/gitea/docs.git synced 2026-07-22 02:37:42 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update zh tw languages and fix some broken links (#455)

Browse Source 
---------

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:
Lunny Xiao
2026-07-09 23:41:46 +00:00
parent c0f8a04185
commit 965c269495
652 changed files with 30864 additions and 30792 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
i18n/zh-tw/docusaurus-plugin-content-docs/version-1.23/usage/packages/alpine.md
View File

@@ -6,7 +6,7 @@ sidebar_position: 4
# Alpine 套件註冊表
為您的用戶或組織發布 [Alpine](https://pkgs.alpinelinux.org/) 套件。
為您的使用者或組織發布 [Alpine](https://pkgs.alpinelinux.org/) 套件。
## 需求
@@ -14,7 +14,7 @@ sidebar_position: 4
以下範例使用 `apk`。
## 配置套件註冊表
## 設定套件註冊表
要註冊 Alpine 註冊表，請將 URL 添加到已知的 apk 來源列表中（`/etc/apk/repositories`）：
@@ -26,15 +26,15 @@ https://gitea.example.com/api/packages/{owner}/alpine/<branch>/<repository>
| ------------ | -------------- |
| `owner` | 套件的擁有者。 |
| `branch` | 要使用的分支。 |
| `repository` | 要使用的倉庫。 |
| `repository` | 要使用的儲存庫。 |
如果註冊表是私有的，請在 URL 中提供憑證。您可以使用密碼或 [個人訪問令牌](development/api-usage.md#authentication)：
如果註冊表是私有的，請在 URL 中提供憑證。您可以使用密碼或 [個人存取權杖](development/api-usage.md#認證)：
```
https://{username}:{your_password_or_token}@gitea.example.com/api/packages/{owner}/alpine/<branch>/<repository>
```
Alpine 註冊表文件使用 RSA 密鑰簽名，該密鑰必須為 apk 所知。下載公鑰並將其存儲在 `/etc/apk/keys/` 中：
Alpine 註冊表文件使用 RSA 密鑰簽名，該密鑰必須為 apk 所知。下載公鑰並將其儲存在 `/etc/apk/keys/` 中：
```shell
curl -JO https://gitea.example.com/api/packages/{owner}/alpine/key
@@ -58,7 +58,7 @@ PUT https://gitea.example.com/api/packages/{owner}/alpine/{branch}/{repository}
| ------------ | ------------------------------------------------------------------------------------------------- |
| `owner` | 套件的擁有者。 |
| `branch` | 分支可能與操作系統的發行版本匹配，例如：`v3.17`。 |
| `repository` | 倉庫可以用來[分組套件](https://wiki.alpinelinux.org/wiki/Repositories) 或者只是 `main` 或類似的。 |
| `repository` | 儲存庫可以用來[分組套件](https://wiki.alpinelinux.org/wiki/Repositories) 或者只是 `main` 或類似的。 |
使用 HTTP 基本身份驗證的範例請求：
@@ -68,16 +68,16 @@ curl --user your_username:your_password_or_token \
https://gitea.example.com/api/packages/testuser/alpine/v3.17/main
```
如果您使用 2FA 或 OAuth，請使用 [個人訪問令牌](development/api-usage.md#authentication) 代替密碼。
如果您使用 2FA 或 OAuth，請使用 [個人存取權杖](development/api-usage.md#認證) 代替密碼。
您不能將同名文件兩次發布到套件中。您必須先刪除現有的套件文件。
服務器響應以下 HTTP 狀態碼。
伺服器響應以下 HTTP 狀態碼。
| HTTP 狀態碼 | 含義 |
| ----------------- | ---------------------------------------- |
| `201 Created` | 套件已發布。 |
| `400 Bad Request` | 套件名稱、版本、分支、倉庫或架構無效。 |
| `400 Bad Request` | 套件名稱、版本、分支、儲存庫或架構無效。 |
| `409 Conflict` | 套件中已存在具有相同參數組合的套件文件。 |
## 刪除套件
@@ -92,7 +92,7 @@ DELETE https://gitea.example.com/api/packages/{owner}/alpine/{branch}/{repositor
| -------------- | -------------- |
| `owner` | 套件的擁有者。 |
| `branch` | 要使用的分支。 |
| `repository` | 要使用的倉庫。 |
| `repository` | 要使用的儲存庫。 |
| `architecture` | 套件架構。 |
| `filename` | 要刪除的文件。 |
@@ -103,7 +103,7 @@ curl --user your_username:your_token_or_password -X DELETE \
https://gitea.example.com/api/packages/testuser/alpine/v3.17/main/test-package-1.0.0.apk
```
服務器響應以下 HTTP 狀態碼。
伺服器響應以下 HTTP 狀態碼。
| HTTP 狀態碼 | 含義 |
| ---------------- | ------------------ |

24
i18n/zh-tw/docusaurus-plugin-content-docs/version-1.23/usage/packages/arch.md
View File

@@ -6,7 +6,7 @@ sidebar_position: 5
# Arch 套件註冊表
為您的用戶或組織發布 [Arch](https://archlinux.org/packages/) 套件。該註冊表可以作為一個完全運行的 [Arch linux 鏡像](https://wiki.archlinux.org/title/mirrors)，直接連接到 `/etc/pacman.conf`。
為您的使用者或組織發布 [Arch](https://archlinux.org/packages/) 套件。該註冊表可以作為一個完全運行的 [Arch linux 鏡像](https://wiki.archlinux.org/title/mirrors)，直接連接到 `/etc/pacman.conf`。
## 需求
@@ -14,9 +14,9 @@ sidebar_position: 5
以下範例使用 `pacman`。
## 配置套件註冊表
## 設定套件註冊表
在您可以使用套件註冊表之前，您需要下載套件驗證密鑰並將註冊表添加到 pacman 配置中。
在您可以使用套件註冊表之前，您需要下載套件驗證密鑰並將註冊表添加到 pacman 設定中。
下載套件驗證密鑰。
@@ -37,7 +37,7 @@ pacman-key --add repository.key
pacman-key --lsign-key {key id}
```
現在將註冊表配置添加到 `/etc/pacman.conf`。
現在將註冊表設定添加到 `/etc/pacman.conf`。
```conf
[{owner}.gitea.example.com]
@@ -48,12 +48,12 @@ Server = https://gitea.example.com/api/packages/{owner}/arch/{repository}/{archi
| 佔位符 | 描述 |
| -------------- | -------------- |
| `owner` | 套件的擁有者。 |
| `repository` | 要使用的倉庫。 |
| `repository` | 要使用的儲存庫。 |
| `architecture` | 要使用的架構。 |
請參閱擁有者的套件概述以查看可用的 `repository` 和 `architecture`。
如果註冊表是私有的，請在 URL 中提供憑證。您可以使用密碼或 [個人訪問令牌](development/api-usage.md#authentication)：
如果註冊表是私有的，請在 URL 中提供憑證。您可以使用密碼或 [個人存取權杖](development/api-usage.md#認證)：
```
Server = https://{username}:{your_password_or_token}@gitea.example.com/api/packages/{owner}/arch/{repository}/{architecture}
@@ -70,7 +70,7 @@ PUT https://gitea.example.com/api/packages/{owner}/arch/{repository}
| 參數 | 描述 |
| ------------ | -------------------------------------------- |
| `owner` | 套件的擁有者。 |
| `repository` | 倉庫可以用來分組套件或只是 `core` 或類似的。 |
| `repository` | 儲存庫可以用來分組套件或只是 `core` 或類似的。 |
使用 HTTP 基本身份驗證的範例請求：
@@ -80,16 +80,16 @@ curl --user your_username:your_password_or_token \
https://gitea.example.com/api/packages/testuser/arch/core
```
如果您使用 2FA 或 OAuth，請使用 [個人訪問令牌](development/api-usage.md#authentication) 代替密碼。
如果您使用 2FA 或 OAuth，請使用 [個人存取權杖](development/api-usage.md#認證) 代替密碼。
您不能將同名文件兩次發布到套件中。您必須先刪除現有的套件文件。
服務器響應以下 HTTP 狀態碼。
伺服器響應以下 HTTP 狀態碼。
| HTTP 狀態碼 | 含義 |
| ----------------- | ------------------------------------------ |
| `201 Created` | 套件已發布。 |
| `400 Bad Request` | 套件的某些部分無效。錯誤消息包含更多信息。 |
| `400 Bad Request` | 套件的某些部分無效。錯誤消息包含更多資訊。 |
| `409 Conflict` | 套件中已存在具有相同參數組合的套件文件。 |
## 安裝套件
@@ -115,7 +115,7 @@ DELETE https://gitea.example.com/api/packages/{owner}/arch/{repository}/{package
| 參數 | 描述 |
| ----------------- | -------------- |
| `owner` | 套件的擁有者。 |
| `repository` | 要使用的倉庫。 |
| `repository` | 要使用的儲存庫。 |
| `architecture` | 套件架構。 |
| `package_name` | 套件名稱。 |
| `package_version` | 套件版本。 |
@@ -127,7 +127,7 @@ curl --user your_username:your_token_or_password -X DELETE \
https://gitea.example.com/api/packages/testuser/arch/core/test-package/1.0.0/x86-64
```
服務器響應以下 HTTP 狀態碼。
伺服器響應以下 HTTP 狀態碼。
| HTTP 狀態碼 | 含義 |
| ---------------- | ------------------ |

46
i18n/zh-tw/docusaurus-plugin-content-docs/version-1.23/usage/packages/cargo.md
View File

@@ -6,35 +6,35 @@ sidebar_position: 5
# 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 將可用套件的信息存儲在一個 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]
@@ -52,8 +52,8 @@ index = "sparse+https://gitea.example.com/api/packages/{owner}/cargo/" # Sparse
| ------- | -------------- |
| `owner` | 套件的擁有者。 |
如果註冊表是私有的或您想發布新套件，您必須配置您的憑證。
將憑證部分添加到當前用戶主目錄中的憑證文件（例如 `~/.cargo/credentials.toml`）：
如果註冊表是私有的或您想發布新套件，您必須設定您的憑證。
將憑證部分添加到當前使用者主目錄中的憑證文件（例如 `~/.cargo/credentials.toml`）：
```
[registries.gitea]
@@ -62,17 +62,17 @@ token = "Bearer {token}"
| 參數 | 描述 |
| ------- | ------------------------------------------------------------ |
| `token` | 您的 [個人訪問令牌](development/api-usage.md#authentication) |
| `token` | 您的 [個人存取權杖](development/api-usage.md#認證) |
## Git vs Sparse
目前，cargo 支持兩種從註冊表中獲取 crate 的方式：Git 索引和 sparse 索引。
目前，cargo 支援兩種從註冊表中獲取 crate 的方式：Git 索引和 sparse 索引。
Sparse 索引是最新的方法，與 git 相比，在更新 crate 時提供了更好的性能。
自 Rust 1.68 起，sparse 是 crates.io 的默認方法。
自 Rust 1.68 起，sparse 是 crates.io 的預設方法。
## 發布套件
在您的項目中運行以下命令來發布套件：
在您的專案中運行以下命令來發布套件：
```shell
cargo publish
@@ -92,7 +92,7 @@ cargo add {package_name}
| -------------- | ---------- |
| `package_name` | 套件名稱。 |
## 支持的命令
## 支援的命令
```
cargo publish

14
i18n/zh-tw/docusaurus-plugin-content-docs/version-1.23/usage/packages/chef.md
View File

@@ -6,7 +6,7 @@ sidebar_position: 10
# Chef 套件註冊表
為您的用戶或組織發布 [Chef](https://chef.io/) 食譜。
為您的使用者或組織發布 [Chef](https://chef.io/) 食譜。
## 需求
@@ -14,14 +14,14 @@ sidebar_position: 10
## 認證
Chef 套件註冊表不使用用戶名：密碼認證，而是使用私鑰：公鑰對進行簽名請求。
訪問套件擁有者設置頁面以創建必要的密鑰對。
只有公鑰存儲在 Gitea 中。如果您丟失了私鑰的訪問權限，您必須重新生成密鑰對。
[配置 `knife`](https://docs.chef.io/workstation/knife_setup/) 以使用下載的私鑰和您的 Gitea 用戶名作為 `client_name`。
Chef 套件註冊表不使用使用者名稱：密碼認證，而是使用私鑰：公鑰對進行簽名請求。
訪問套件擁有者設定頁面以建立必要的密鑰對。
只有公鑰儲存在 Gitea 中。如果您丟失了私鑰的存取權限，您必須重新生成密鑰對。
[設定 `knife`](https://docs.chef.io/workstation/knife_setup/) 以使用下載的私鑰和您的 Gitea 使用者名稱作為 `client_name`。
## 配置套件註冊表
## 設定套件註冊表
要[配置 `knife`](https://docs.chef.io/workstation/knife_setup/) 以使用 Gitea 套件註冊表，請將 URL 添加到 `~/.chef/config.rb` 文件中。
要[設定 `knife`](https://docs.chef.io/workstation/knife_setup/) 以使用 Gitea 套件註冊表，請將 URL 添加到 `~/.chef/config.rb` 文件中。
```
knife[:supermarket_site] = 'https://gitea.example.com/api/packages/{owner}/chef'

14
i18n/zh-tw/docusaurus-plugin-content-docs/version-1.23/usage/packages/composer.md
View File

@@ -6,7 +6,7 @@ sidebar_position: 15
# Composer 套件註冊表
為您的用戶或組織發布 [Composer](https://getcomposer.org/) 套件。
為您的使用者或組織發布 [Composer](https://getcomposer.org/) 套件。
## 需求
@@ -15,7 +15,7 @@ sidebar_position: 15
## 發布套件
要發布 Composer 套件，請執行 HTTP PUT 操作，請求體中包含套件內容。
套件內容必須是包含 `composer.json` 文件的壓縮 PHP 項目。
套件內容必須是包含 `composer.json` 文件的壓縮 PHP 專案。
如果已經存在同名同版本的套件，您不能發布該套件。您必須先刪除現有的套件。
@@ -49,9 +49,9 @@ curl --user your_username:your_password_or_token \
https://gitea.example.com/api/packages/testuser/composer?version=1.0.3
```
如果您使用 2FA 或 OAuth，請使用 [個人訪問令牌](development/api-usage.md#authentication) 代替密碼。
如果您使用 2FA 或 OAuth，請使用 [個人存取權杖](development/api-usage.md#認證) 代替密碼。
服務器響應以下 HTTP 狀態碼。
伺服器響應以下 HTTP 狀態碼。
| HTTP 狀態碼 | 含義 |
| ----------------- | ---------------------------------- |
@@ -59,7 +59,7 @@ curl --user your_username:your_password_or_token \
| `400 Bad Request` | 套件無效。 |
| `409 Conflict` | 已存在具有相同參數組合的套件文件。 |
## 配置套件註冊表
## 設定套件註冊表
要註冊套件註冊表，您需要將其添加到 Composer 的 `config.json` 文件中（通常可以在 `<user-home-dir>/.composer/config.json` 下找到）：
@@ -90,8 +90,8 @@ curl --user your_username:your_password_or_token \
| 參數 | 描述 |
| ---------- | ------------------------------- |
| `owner` | 套件的擁有者。 |
| `username` | 您的 Gitea 用戶名。 |
| `password` | 您的 Gitea 密碼或個人訪問令牌。 |
| `username` | 您的 Gitea 使用者名稱。 |
| `password` | 您的 Gitea 密碼或個人存取權杖。 |
## 安裝套件

14
i18n/zh-tw/docusaurus-plugin-content-docs/version-1.23/usage/packages/conan.md
View File

@@ -6,15 +6,15 @@ sidebar_position: 20
# Conan 套件註冊表
為您的用戶或組織發布 [Conan](https://conan.io/) 套件。
為您的使用者或組織發布 [Conan](https://conan.io/) 套件。
## 需求
要使用 Conan 套件註冊表，您需要使用 [conan](https://conan.io/downloads.html) 命令行工具來消費和發布套件。
## 配置套件註冊表
## 設定套件註冊表
要註冊套件註冊表，您需要配置一個新的 Conan 遠程：
要註冊套件註冊表，您需要設定一個新的 Conan 遠程：
```shell
conan remote add {remote} https://gitea.example.com/api/packages/{owner}/conan
@@ -24,8 +24,8 @@ conan user --remote {remote} --password {password} {username}
| 參數 | 描述 |
| ---------- | ------------------------------------------------------------------------------------------------------------------- |
| `remote` | 遠程名稱。 |
| `username` | 您的 Gitea 用戶名。 |
| `password` | 您的 Gitea 密碼。如果您使用 2FA 或 OAuth，請使用 [個人訪問令牌](development/api-usage.md#authentication) 代替密碼。 |
| `username` | 您的 Gitea 使用者名稱。 |
| `password` | 您的 Gitea 密碼。如果您使用 2FA 或 OAuth，請使用 [個人存取權杖](development/api-usage.md#認證) 代替密碼。 |
| `owner` | 套件的擁有者。 |
例如：
@@ -56,7 +56,7 @@ conan upload --remote=gitea ConanPackage/1.2@gitea/final
您不能將同名文件兩次發布到套件中。您必須先刪除現有的套件或文件。
Gitea Conan 套件註冊表完全支持 [修訂](https://docs.conan.io/en/latest/versioning/revisions.html)。
Gitea Conan 套件註冊表完全支援 [修訂](https://docs.conan.io/en/latest/versioning/revisions.html)。
## 安裝套件
@@ -77,7 +77,7 @@ conan install --remote={remote} {recipe}
conan install --remote=gitea ConanPackage/1.2@gitea/final
```
## 支持的命令
## 支援的命令
```
conan install

10
i18n/zh-tw/docusaurus-plugin-content-docs/version-1.23/usage/packages/conda.md
View File

@@ -6,13 +6,13 @@ sidebar_position: 25
# Conda 套件註冊表
為您的用戶或組織發布 [Conda](https://docs.conda.io/en/latest/) 套件。
為您的使用者或組織發布 [Conda](https://docs.conda.io/en/latest/) 套件。
## 需求
要使用 Conda 套件註冊表，您需要使用 [conda](https://docs.conda.io/projects/conda/en/stable/user-guide/install/index.html)。
## 配置套件註冊表
## 設定套件註冊表
要註冊套件註冊表並提供憑證，請編輯您的 `.condarc` 文件：
@@ -28,7 +28,7 @@ default_channels:
| ------- | -------------- |
| `owner` | 套件的擁有者。 |
請參閱 [官方文檔](https://conda.io/projects/conda/en/latest/user-guide/configuration/use-condarc.html) 以了解各個設置的說明。
請參閱 [官方文件](https://conda.io/projects/conda/en/latest/user-guide/configuration/use-condarc.html) 以瞭解各個設定的說明。
如果您需要提供憑證，您可以將它們嵌入到頻道 URL 中（`https://user:password@gitea.example.com/...`）。
@@ -54,11 +54,11 @@ curl --user your_username:your_password_or_token \
https://gitea.example.com/api/packages/testuser/conda/package-1.0.conda
```
如果您使用 2FA 或 OAuth，請使用 [個人訪問令牌](development/api-usage.md#authentication) 代替密碼。
如果您使用 2FA 或 OAuth，請使用 [個人存取權杖](development/api-usage.md#認證) 代替密碼。
如果已經存在同名同版本的套件，您不能發布該套件。您必須先刪除現有的套件。
服務器響應以下 HTTP 狀態碼。
伺服器響應以下 HTTP 狀態碼。
| HTTP 狀態碼 | 含義 |
| ----------------- | ---------------------------------- |

14
i18n/zh-tw/docusaurus-plugin-content-docs/version-1.23/usage/packages/container.md
View File

@@ -6,15 +6,15 @@ sidebar_position: 30
# 容器註冊表
為您的用戶或組織發布符合 [Open Container Initiative](https://opencontainers.org/) 規範的映像。
容器註冊表遵循 OCI 規範，支持所有兼容的映像，如 [Docker](https://www.docker.com/) 和 [Helm Charts](https://helm.sh/)。
為您的使用者或組織發布符合 [Open Container Initiative](https://opencontainers.org/) 規範的映像。
容器註冊表遵循 OCI 規範，支援所有相容的映像，如 [Docker](https://www.docker.com/) 和 [Helm Charts](https://helm.sh/)。
## 需求
要使用容器註冊表，您可以使用特定映像類型的工具。
以下範例使用 `docker` 客戶端。
## 登錄到容器註冊表
## 登入到容器註冊表
要推送映像或如果映像在私有註冊表中，您必須進行身份驗證：
@@ -22,7 +22,7 @@ sidebar_position: 30
docker login gitea.example.com
```
如果您使用 2FA 或 OAuth，請使用 [個人訪問令牌](development/api-usage.md#authentication) 代替密碼。
如果您使用 2FA 或 OAuth，請使用 [個人存取權杖](development/api-usage.md#認證) 代替密碼。
## 映像命名規則
@@ -49,12 +49,12 @@ docker tag {some-existing-image}:{tag} {registry}/{owner}/{image}:{tag}
`gitea.example.com/testuser/my/image`
:::note
註冊表僅支持不區分大小寫的標籤名稱。因此 `image:tag` 和 `image:Tag` 被視為相同的映像和標籤。
註冊表僅支援不區分大小寫的標籤名稱。因此 `image:tag` 和 `image:Tag` 被視為相同的映像和標籤。
:::
## 推送映像
通過執行以下命令推送映像：
透過執行以下命令推送映像：
```shell
docker push gitea.example.com/{owner}/{image}:{tag}
@@ -74,7 +74,7 @@ docker push gitea.example.com/testuser/myimage:latest
## 拉取映像
通過執行以下命令拉取映像：
透過執行以下命令拉取映像：
```shell
docker pull gitea.example.com/{owner}/{image}:{tag}

10
i18n/zh-tw/docusaurus-plugin-content-docs/version-1.23/usage/packages/cran.md
View File

@@ -6,15 +6,15 @@ sidebar_position: 35
# CRAN 套件註冊表
為您的用戶或組織發布 [R](https://www.r-project.org/) 套件到類似 [CRAN](https://cran.r-project.org/) 的註冊表。
為您的使用者或組織發布 [R](https://www.r-project.org/) 套件到類似 [CRAN](https://cran.r-project.org/) 的註冊表。
## 需求
要使用 CRAN 套件註冊表，您需要安裝 [R](https://cran.r-project.org/)。
## 配置套件註冊表
## 設定套件註冊表
要註冊套件註冊表，您需要將其添加到 `Rprofile.site`，可以是系統級別、用戶級別（`~/.Rprofile`）或項目級別：
要註冊套件註冊表，您需要將其添加到 `Rprofile.site`，可以是系統級別、使用者級別（`~/.Rprofile`）或專案級別：
```
options("repos" = c(getOption("repos"), c(gitea="https://gitea.example.com/api/packages/{owner}/cran")))
@@ -60,11 +60,11 @@ curl --user your_username:your_password_or_token \
https://gitea.example.com/api/packages/testuser/cran/bin?platform=windows&rversion=4.2
```
如果您使用 2FA 或 OAuth，請使用 [個人訪問令牌](development/api-usage.md#authentication) 代替密碼。
如果您使用 2FA 或 OAuth，請使用 [個人存取權杖](development/api-usage.md#認證) 代替密碼。
如果已經存在同名同版本的套件，您不能發布該套件。您必須先刪除現有的套件。
服務器響應以下 HTTP 狀態碼。
伺服器響應以下 HTTP 狀態碼。
| HTTP 狀態碼 | 含義 |
| ----------------- | ---------------------------------- |

20
i18n/zh-tw/docusaurus-plugin-content-docs/version-1.23/usage/packages/debian.md
View File

@@ -6,7 +6,7 @@ sidebar_position: 40
# Debian 套件註冊表
為您的用戶或組織發布 [Debian](https://www.debian.org/distrib/packages) 套件。
為您的使用者或組織發布 [Debian](https://www.debian.org/distrib/packages) 套件。
## 需求
@@ -14,7 +14,7 @@ sidebar_position: 40
以下範例使用 `apt`。
## 配置套件註冊表
## 設定套件註冊表
要註冊 Debian 註冊表，請將 URL 添加到已知的 apt 來源列表中：
@@ -26,9 +26,9 @@ echo "deb [signed-by=/etc/apt/keyrings/gitea-{owner}.asc] https://gitea.example.
| -------------- | ---------------- |
| `owner` | 套件的擁有者。 |
| `distribution` | 要使用的發行版。 |
| `component` | 要使用的組件。 |
| `component` | 要使用的元件。 |
如果註冊表是私有的，請在 URL 中提供憑證。您可以使用密碼或 [個人訪問令牌](development/api-usage.md#authentication)：
如果註冊表是私有的，請在 URL 中提供憑證。您可以使用密碼或 [個人存取權杖](development/api-usage.md#認證)：
```shell
echo "deb [signed-by=/etc/apt/keyrings/gitea-{owner}.asc] https://{username}:{your_password_or_token}@gitea.example.com/api/packages/{owner}/debian {distribution} {component}" | sudo tee -a /etc/apt/sources.list.d/gitea.list
@@ -58,7 +58,7 @@ PUT https://gitea.example.com/api/packages/{owner}/debian/pool/{distribution}/{c
| -------------- | ---------------------------------------------------- |
| `owner` | 套件的擁有者。 |
| `distribution` | 發行版可能與操作系統的發行名稱匹配，例如：`bionic`。 |
| `component` | 組件可以用來分組套件或只是 `main` 或類似的。 |
| `component` | 元件可以用來分組套件或只是 `main` 或類似的。 |
使用 HTTP 基本身份驗證的範例請求：
@@ -68,11 +68,11 @@ curl --user your_username:your_password_or_token \
https://gitea.example.com/api/packages/testuser/debian/pool/bionic/main/upload
```
如果您使用 2FA 或 OAuth，請使用 [個人訪問令牌](development/api-usage.md#authentication) 代替密碼。
如果您使用 2FA 或 OAuth，請使用 [個人存取權杖](development/api-usage.md#認證) 代替密碼。
如果已經存在同名、同版本、同發行版、同組件和同架構的套件，您不能發布該套件。您必須先刪除現有的套件。
如果已經存在同名、同版本、同發行版、同元件和同架構的套件，您不能發布該套件。您必須先刪除現有的套件。
服務器響應以下 HTTP 狀態碼。
伺服器響應以下 HTTP 狀態碼。
| HTTP 狀態碼 | 含義 |
| ----------------- | ---------------------------------- |
@@ -94,7 +94,7 @@ DELETE https://gitea.example.com/api/packages/{owner}/debian/pool/{distribution}
| `package_name` | 套件名稱。 |
| `package_version` | 套件版本。 |
| `distribution` | 套件發行版。 |
| `component` | 套件組件。 |
| `component` | 套件元件。 |
| `architecture` | 套件架構。 |
使用 HTTP 基本身份驗證的範例請求：
@@ -104,7 +104,7 @@ curl --user your_username:your_token_or_password -X DELETE \
https://gitea.example.com/api/packages/testuser/debian/pool/bionic/main/test-package/1.0.0/amd64
```
服務器響應以下 HTTP 狀態碼。
伺服器響應以下 HTTP 狀態碼。
| HTTP 狀態碼 | 含義 |
| ---------------- | ------------------ |

14
i18n/zh-tw/docusaurus-plugin-content-docs/version-1.23/usage/packages/generic.md
View File

@@ -6,11 +6,11 @@ sidebar_position: 500
# 通用套件註冊表
為您的用戶或組織發布通用文件，如發布的二進制文件或其他輸出。
為您的使用者或組織發布通用文件，如發布的二進制文件或其他輸出。
## 認證到套件註冊表
要認證到套件註冊表，您需要提供[自定義 HTTP 標頭或使用 HTTP 基本認證](development/api-usage.md#authentication)。
要認證到套件註冊表，您需要提供[自訂 HTTP 標頭或使用 HTTP 基本認證](development/api-usage.md#認證)。
## 發布套件
@@ -36,9 +36,9 @@ curl --user your_username:your_password_or_token \
https://gitea.example.com/api/packages/testuser/generic/test_package/1.0.0/file.bin
```
如果您使用 2FA 或 OAuth，請使用 [個人訪問令牌](development/api-usage.md#authentication) 代替密碼。
如果您使用 2FA 或 OAuth，請使用 [個人存取權杖](development/api-usage.md#認證) 代替密碼。
服務器響應以下 HTTP 狀態碼。
伺服器響應以下 HTTP 狀態碼。
| HTTP 狀態碼 | 含義 |
| ----------------- | ---------------------------------- |
@@ -70,7 +70,7 @@ curl --user your_username:your_token_or_password \
https://gitea.example.com/api/packages/testuser/generic/test_package/1.0.0/file.bin
```
服務器響應以下 HTTP 狀態碼。
伺服器響應以下 HTTP 狀態碼。
| HTTP 狀態碼 | 含義 |
| --------------- | ------------------ |
@@ -98,7 +98,7 @@ curl --user your_username:your_token_or_password -X DELETE \
https://gitea.example.com/api/packages/testuser/generic/test_package/1.0.0
```
服務器響應以下 HTTP 狀態碼。
伺服器響應以下 HTTP 狀態碼。
| HTTP 狀態碼 | 含義 |
| ---------------- | ------------ |
@@ -127,7 +127,7 @@ curl --user your_username:your_token_or_password -X DELETE \
https://gitea.example.com/api/packages/testuser/generic/test_package/1.0.0/file.bin
```
服務器響應以下 HTTP 狀態碼。
伺服器響應以下 HTTP 狀態碼。
| HTTP 狀態碼 | 含義 |
| ---------------- | ------------------ |

12
i18n/zh-tw/docusaurus-plugin-content-docs/version-1.23/usage/packages/go.md
View File

@@ -6,13 +6,13 @@ sidebar_position: 45
# Go 套件註冊表
為您的用戶或組織發布 Go 套件。
為您的使用者或組織發布 Go 套件。
## 發布套件
要發布 Go 套件，請執行 HTTP `PUT` 操作，請求體中包含套件內容。
如果已經存在同名同版本的套件，您不能發布該套件。您必須先刪除現有的套件。
套件必須遵循[文檔結構](https://go.dev/ref/mod#zip-files)。
套件必須遵循[文件結構](https://go.dev/ref/mod#zip-files)。
```
PUT https://gitea.example.com/api/packages/{owner}/go/upload
@@ -22,7 +22,7 @@ PUT https://gitea.example.com/api/packages/{owner}/go/upload
| ------- | -------------- |
| `owner` | 套件的擁有者。 |
要認證到套件註冊表，您需要提供[自定義 HTTP 標頭或使用 HTTP 基本認證](development/api-usage.md#authentication)：
要認證到套件註冊表，您需要提供[自訂 HTTP 標頭或使用 HTTP 基本認證](development/api-usage.md#認證)：
```shell
curl --user your_username:your_password_or_token \
@@ -30,11 +30,11 @@ curl --user your_username:your_password_or_token \
https://gitea.example.com/api/packages/testuser/go/upload
```
如果您使用 2FA 或 OAuth，請使用 [個人訪問令牌](development/api-usage.md#authentication) 代替密碼。
如果您使用 2FA 或 OAuth，請使用 [個人存取權杖](development/api-usage.md#認證) 代替密碼。
如果已經存在同名同版本的套件，您不能發布該套件。您必須先刪除現有的套件。
服務器響應以下 HTTP 狀態碼。
伺服器響應以下 HTTP 狀態碼。
| HTTP 狀態碼 | 含義 |
| ----------------- | -------------------------- |
@@ -63,4 +63,4 @@ GOPROXY=https://gitea.example.com/api/packages/{owner}/go go install {package_na
如果套件的擁有者是私有的，您需要[提供憑證](https://go.dev/ref/mod#private-module-proxy-auth)。
有關 `GOPROXY` 環境變量以及如何防止數據洩漏的更多信息，請參閱[文檔](https://go.dev/ref/mod#private-modules)。
有關 `GOPROXY` 環境變量以及如何防止資料洩漏的更多資訊，請參閱[文件](https://go.dev/ref/mod#private-modules)。

18
i18n/zh-tw/docusaurus-plugin-content-docs/version-1.23/usage/packages/helm.md
View File

@@ -6,11 +6,11 @@ sidebar_position: 50
# Helm Chart 註冊表
為您的用戶或組織發布 [Helm](https://helm.sh/) 圖表。
為您的使用者或組織發布 [Helm](https://helm.sh/) 圖表。
## 需求
要使用 Helm Chart 註冊表，請使用簡單的 HTTP 客戶端，如 `curl` 或 [`helm cm-push`](https://github.com/chartmuseum/helm-push/) 插件。
要使用 Helm Chart 註冊表，請使用簡單的 HTTP 客戶端，如 `curl` 或 [`helm cm-push`](https://github.com/chartmuseum/helm-push/) 外掛。
## 發布套件
@@ -20,7 +20,7 @@ sidebar_position: 50
curl --user {username}:{password} -X POST --upload-file ./{chart_file}.tgz https://gitea.example.com/api/packages/{owner}/helm/api/charts
```
或使用 `helm cm-push` 插件：
或使用 `helm cm-push` 外掛：
```shell
helm repo add --username {username} --password {password} {repo} https://gitea.example.com/api/packages/{owner}/helm
@@ -29,9 +29,9 @@ helm cm-push ./{chart_file}.tgz {repo}
| 參數 | 描述 |
| ------------ | ------------------------------------------------------------------------------------------------------------------- |
| `username` | 您的 Gitea 用戶名。 |
| `password` | 您的 Gitea 密碼。如果您使用 2FA 或 OAuth，請使用 [個人訪問令牌](development/api-usage.md#authentication) 代替密碼。 |
| `repo` | 倉庫的名稱。 |
| `username` | 您的 Gitea 使用者名稱。 |
| `password` | 您的 Gitea 密碼。如果您使用 2FA 或 OAuth，請使用 [個人存取權杖](development/api-usage.md#認證) 代替密碼。 |
| `repo` | 儲存庫的名稱。 |
| `chart_file` | Helm Chart 存檔。 |
| `owner` | 套件的擁有者。 |
@@ -47,9 +47,9 @@ helm install {name} {repo}/{chart}
| 參數 | 描述 |
| ---------- | ------------------------------- |
| `username` | 您的 Gitea 用戶名。 |
| `password` | 您的 Gitea 密碼或個人訪問令牌。 |
| `repo` | 倉庫的名稱。 |
| `username` | 您的 Gitea 使用者名稱。 |
| `password` | 您的 Gitea 密碼或個人存取權杖。 |
| `repo` | 儲存庫的名稱。 |
| `owner` | 套件的擁有者。 |
| `name` | 本地名稱。 |
| `chart` | Helm Chart 的名稱。 |

16
i18n/zh-tw/docusaurus-plugin-content-docs/version-1.23/usage/packages/maven.md
View File

@@ -6,16 +6,16 @@ sidebar_position: 60
# Maven 套件註冊表
為您的用戶或組織發布 [Maven](https://maven.apache.org) 套件。
為您的使用者或組織發布 [Maven](https://maven.apache.org) 套件。
## 需求
要使用 Maven 套件註冊表，您可以使用 [Maven](https://maven.apache.org/install.html) 或 [Gradle](https://gradle.org/install/)。
以下範例使用 `Maven` 和 `Gradle Groovy`。
## 配置套件註冊表
## 設定套件註冊表
要註冊套件註冊表，您首先需要將訪問令牌添加到 [`settings.xml`](https://maven.apache.org/settings.html) 文件中：
要註冊套件註冊表，您首先需要將存取權杖添加到 [`settings.xml`](https://maven.apache.org/settings.html) 文件中：
```xml
<settings>
@@ -35,7 +35,7 @@ sidebar_position: 60
</settings>
```
之後將以下部分添加到您的項目 `pom.xml` 文件中：
之後將以下部分添加到您的專案 `pom.xml` 文件中：
```xml
<repositories>
@@ -58,12 +58,12 @@ sidebar_position: 60
| 參數 | 描述 |
| -------------- | -------------------------------------------------------------- |
| `access_token` | 您的 [個人訪問令牌](development/api-usage.md#authentication)。 |
| `access_token` | 您的 [個人存取權杖](development/api-usage.md#認證)。 |
| `owner` | 套件的擁有者。 |
### Gradle 變體
當您計劃在項目中添加來自 Gitea 實例的一些套件時，應該將其添加到倉庫部分：
當您計劃在專案中添加來自 Gitea 實例的一些套件時，應該將其添加到儲存庫部分：
```groovy
repositories {
@@ -123,7 +123,7 @@ mvn deploy:deploy-file -Durl=https://gitea.example.com/api/packages/{owner}/mave
## 安裝套件
要從套件註冊表中安裝 Maven 套件，請在項目 `pom.xml` 文件中添加新的依賴項：
要從套件註冊表中安裝 Maven 套件，請在專案 `pom.xml` 文件中添加新的依賴項：
```xml
<dependency>
@@ -145,7 +145,7 @@ implementation "com.test.package:test_project:1.0.0"
mvn install
```
## 支持的命令
## 支援的命令
```
mvn install

20
i18n/zh-tw/docusaurus-plugin-content-docs/version-1.23/usage/packages/npm.md
View File

@@ -6,19 +6,19 @@ sidebar_position: 70
# NPM 套件註冊表
為您的用戶或組織發布 [npm](https://www.npmjs.com/) 套件。
為您的使用者或組織發布 [npm](https://www.npmjs.com/) 套件。
## 需求
要使用 npm 套件註冊表，您需要 [Node.js](https://nodejs.org/en/download/) 以及一個包管理器，如 [Yarn](https://classic.yarnpkg.com/en/docs/install) 或 [npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm/) 本身。
要使用 npm 套件註冊表，您需要 [Node.js](https://nodejs.org/en/download/) 以及一個套件管理器，如 [Yarn](https://classic.yarnpkg.com/en/docs/install) 或 [npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm/) 本身。
註冊表支持[範圍](https://docs.npmjs.com/misc/scope/)和非範圍套件。
註冊表支援[範圍](https://docs.npmjs.com/misc/scope/)和非範圍套件。
以下範例使用 `npm` 工具和範圍 `@test`。
## 配置套件註冊表
## 設定套件註冊表
要註冊套件註冊表，您需要配置一個新的包源。
要註冊套件註冊表，您需要設定一個新的包源。
```shell
npm config set {scope}:registry=https://gitea.example.com/api/packages/{owner}/npm/
@@ -29,7 +29,7 @@ npm config set -- '//gitea.example.com/api/packages/{owner}/npm/:_authToken' "{t
| ------- | -------------------------------------------------------------- |
| `scope` | 套件的範圍。 |
| `owner` | 套件的擁有者。 |
| `token` | 您的 [個人訪問令牌](development/api-usage.md#authentication)。 |
| `token` | 您的 [個人存取權杖](development/api-usage.md#認證)。 |
例如：
@@ -47,7 +47,7 @@ npm config set -- '//gitea.example.com/api/packages/testuser/npm/:_authToken' "p
## 發布套件
在您的項目中運行以下命令來發布套件：
在您的專案中運行以下命令來發布套件：
```shell
npm publish
@@ -95,7 +95,7 @@ npm install @test/test_package
## 標記套件
註冊表支持[版本標籤](https://docs.npmjs.com/adding-dist-tags-to-packages/)，可以通過 `npm dist-tag` 進行管理：
註冊表支援[版本標籤](https://docs.npmjs.com/adding-dist-tags-to-packages/)，可以透過 `npm dist-tag` 進行管理：
```shell
npm dist-tag add {package_name}@{version} {tag}
@@ -117,9 +117,9 @@ npm dist-tag add test_package@1.0.2 release
## 搜索套件
註冊表支持[搜索](https://docs.npmjs.com/cli/v7/commands/npm-search/)，但不支持特殊搜索限定符，如 `author:gitea`。
註冊表支援[搜索](https://docs.npmjs.com/cli/v7/commands/npm-search/)，但不支援特殊搜索限定符，如 `author:gitea`。
## 支持的命令
## 支援的命令
```
npm install

20
i18n/zh-tw/docusaurus-plugin-content-docs/version-1.23/usage/packages/nuget.md
View File

@@ -6,17 +6,17 @@ sidebar_position: 80
# NuGet 套件註冊表
為您的用戶或組織發布 [NuGet](https://www.nuget.org/) 套件。套件註冊表支持 V2 和 V3 API 協議，您還可以使用 [NuGet 符號包](https://docs.microsoft.com/zh-tw/nuget/create-packages/symbol-packages-snupkg)。
為您的使用者或組織發布 [NuGet](https://www.nuget.org/) 套件。套件註冊表支援 V2 和 V3 API 協議，您還可以使用 [NuGet 符號包](https://docs.microsoft.com/zh-tw/nuget/create-packages/symbol-packages-snupkg)。
## 需求
要使用 NuGet 套件註冊表，您可以使用命令行界面工具以及各種 IDE（如 Visual Studio）中的 NuGet 功能。
有關 NuGet 客戶端的更多信息，請參閱[官方文檔](https://docs.microsoft.com/zh-tw/nuget/install-nuget-client-tools)。
要使用 NuGet 套件註冊表，您可以使用命令行介面工具以及各種 IDE（如 Visual Studio）中的 NuGet 功能。
有關 NuGet 客戶端的更多資訊，請參閱[官方文件](https://docs.microsoft.com/zh-tw/nuget/install-nuget-client-tools)。
以下範例使用 `dotnet nuget` 工具。
## 配置套件註冊表
## 設定套件註冊表
要註冊套件註冊表，您需要配置一個新的 NuGet 源：
要註冊套件註冊表，您需要設定一個新的 NuGet 源：
```shell
dotnet nuget add source --name {source_name} --username {username} --password {password} https://gitea.example.com/api/packages/{owner}/nuget/index.json
@@ -25,8 +25,8 @@ dotnet nuget add source --name {source_name} --username {username} --password {p
| 參數 | 描述 |
| ------------- | ------------------------------------------------------------------------------------------------------------------- |
| `source_name` | 所需的源名稱。 |
| `username` | 您的 Gitea 用戶名。 |
| `password` | 您的 Gitea 密碼。如果您使用 2FA 或 OAuth，請使用 [個人訪問令牌](development/api-usage.md#authentication) 代替密碼。 |
| `username` | 您的 Gitea 使用者名稱。 |
| `password` | 您的 Gitea 密碼。如果您使用 2FA 或 OAuth，請使用 [個人存取權杖](development/api-usage.md#認證) 代替密碼。 |
| `owner` | 套件的擁有者。 |
例如：
@@ -35,7 +35,7 @@ dotnet nuget add source --name {source_name} --username {username} --password {p
dotnet nuget add source --name gitea --username testuser --password password123 https://gitea.example.com/api/packages/testuser/nuget/index.json
```
您可以在沒有憑證的情況下添加源，並在發布套件時使用 [`--api-key`](https://docs.microsoft.com/zh-tw/dotnet/core/tools/dotnet-nuget-push) 參數。在這種情況下，您需要提供 [個人訪問令牌](development/api-usage.md#authentication)。
您可以在沒有憑證的情況下添加源，並在發布套件時使用 [`--api-key`](https://docs.microsoft.com/zh-tw/dotnet/core/tools/dotnet-nuget-push) 參數。在這種情況下，您需要提供 [個人存取權杖](development/api-usage.md#認證)。
## 發布套件
@@ -60,7 +60,7 @@ dotnet nuget push --source gitea test_package.1.0.0.nupkg
### 符號包
NuGet 套件註冊表支持符號服務器。嵌入在符號包（`.snupkg`）中的 PDB 文件可以被客戶端請求。
NuGet 套件註冊表支援符號伺服器。嵌入在符號包（`.snupkg`）中的 PDB 文件可以被客戶端請求。
為此，請將 NuGet 套件註冊表註冊為符號源：
```
@@ -97,7 +97,7 @@ dotnet add package --source {source_name} --version {package_version} {package_n
dotnet add package --source gitea --version 1.0.0 test_package
```
## 支持的命令
## 支援的命令
```
dotnet add

40
i18n/zh-tw/docusaurus-plugin-content-docs/version-1.23/usage/packages/overview.md
View File

@@ -8,9 +8,9 @@ sidebar_position: 1
從 Gitea **1.17** 開始，套件註冊表可以用作常見套件管理器的公共或私有註冊表。
## 支持的套件管理器
## 支援的套件管理器
目前支持以下套件管理器：
目前支援以下套件管理器：
| 名稱 | 語言 | 套件客戶端 |
| ---------------------------------------- | ---------- | --------------------------- |
@@ -37,59 +37,59 @@ sidebar_position: 1
| [Swift](usage/packages/swift.md) | Swift | `swift` |
| [Vagrant](usage/packages/vagrant.md) | - | `vagrant` |
**以下段落僅適用於套件未全局禁用的情況！**
**以下段落僅適用於套件未全域禁用的情況！**
## 存儲庫-套件
## 儲存庫-套件
套件始終屬於擁有者（用戶或組織），而不是存儲庫。
要將（已上傳的）套件鏈接到存儲庫，請打開該套件的設置頁面並選擇要鏈接此套件的存儲庫。
套件始終屬於擁有者（使用者或組織），而不是儲存庫。
要將（已上傳的）套件鏈接到儲存庫，請打開該套件的設定頁面並選擇要鏈接此套件的儲存庫。
整個套件將被鏈接，而不僅僅是單個版本。
鏈接套件會顯示在存儲庫的套件列表中，並在套件網站上顯示指向存儲庫的鏈接（以及指向存儲庫問題的鏈接）。
鏈接套件會顯示在儲存庫的套件列表中，並在套件網站上顯示指向儲存庫的鏈接（以及指向儲存庫問題的鏈接）。
## 訪問限制
| 套件擁有者類型 | 用戶 | 組織 |
| 套件擁有者類型 | 使用者 | 組織 |
| -------------- | -------------------------------------------- | -------------------------------------------- |
| **讀** 訪問 | 公共，如果用戶也是公共的；否則僅對此用戶可見 | 公共，如果組織是公共的，否則僅對組織成員可見 |
| **寫** 訪問 | 僅限擁有者 | 具有管理或寫入訪問權限的組織成員 |
| **讀** 訪問 | 公共，如果使用者也是公共的；否則僅對此使用者可見 | 公共，如果組織是公共的，否則僅對組織成員可見 |
| **寫** 訪問 | 僅限擁有者 | 具有管理或寫入存取權限的組織成員 |
注意：這些訪問限制[可能會更改](https://github.com/go-gitea/gitea/issues/19270)，將通過專用的組織團隊權限添加更細粒度的控制。
## 創建或上傳套件
## 建立或上傳套件
根據套件的類型，使用相應的套件管理器。請查看特定套件管理器的子頁面以獲取說明。
## 查看套件
您可以在存儲庫頁面上查看存儲庫的套件。
您可以在儲存庫頁面上查看儲存庫的套件。
1. 轉到存儲庫。
1. 轉到儲存庫。
1. 在導航欄中轉到 **Packages**。
要查看有關套件的更多詳細信息，請選擇套件的名稱。
要查看有關套件的更多詳細資訊，請選擇套件的名稱。
## 下載套件
要從存儲庫下載套件：
要從儲存庫下載套件：
1. 在導航欄中轉到 **Packages**。
1. 選擇套件的名稱以查看詳細信息。
1. 選擇套件的名稱以查看詳細資訊。
1. 在 **Assets** 部分中，選擇要下載的套件文件的名稱。
## 刪除套件
在套件註冊表中發布套件後，您無法編輯它。相反，您必須刪除並重新創建它。
在套件註冊表中發布套件後，您無法編輯它。相反，您必須刪除並重新建立它。
要從存儲庫中刪除套件：
要從儲存庫中刪除套件：
1. 在導航欄中轉到 **Packages**。
1. 選擇套件的名稱以查看詳細信息。
1. 選擇套件的名稱以查看詳細資訊。
1. 單擊 **Delete package** 以永久刪除套件。
## 禁用套件註冊表
套件註冊表會自動啟用。要為單個存儲庫禁用它：
套件註冊表會自動啟用。要為單個儲存庫禁用它：
1. 在導航欄中轉到 **Settings**。
1. 禁用 **Enable Repository Packages Registry**。

8
i18n/zh-tw/docusaurus-plugin-content-docs/version-1.23/usage/packages/pub.md
View File

@@ -6,7 +6,7 @@ sidebar_position: 90
# Pub 套件註冊表
為您的用戶或組織發布 [Pub](https://dart.dev/guides/packages) 套件。
為您的使用者或組織發布 [Pub](https://dart.dev/guides/packages) 套件。
## 需求
@@ -14,7 +14,7 @@ sidebar_position: 90
以下範例使用 dart。
## 配置套件註冊表
## 設定套件註冊表
要註冊套件註冊表並提供憑證，請執行：
@@ -26,7 +26,7 @@ dart pub token add https://gitea.example.com/api/packages/{owner}/pub
| ------- | -------------- |
| `owner` | 套件的擁有者。 |
您需要提供您的 [個人訪問令牌](development/api-usage.md#authentication)。
您需要提供您的 [個人存取權杖](development/api-usage.md#認證)。
## 發布套件
@@ -40,7 +40,7 @@ publish_to: https://gitea.example.com/api/packages/{owner}/pub
| ------- | -------------- |
| `owner` | 套件的擁有者。 |
現在您可以通過運行以下命令來發布套件：
現在您可以透過運行以下命令來發布套件：
```shell
dart pub publish

16
i18n/zh-tw/docusaurus-plugin-content-docs/version-1.23/usage/packages/pypi.md
View File

@@ -6,13 +6,13 @@ sidebar_position: 100
# PyPI 套件註冊表
為您的用戶或組織發布 [PyPI](https://pypi.org/) 套件。
為您的使用者或組織發布 [PyPI](https://pypi.org/) 套件。
## 需求
要使用 PyPI 套件註冊表，您需要使用工具 [pip](https://pypi.org/project/pip/) 來消費和 [twine](https://pypi.org/project/twine/) 來發布套件。
## 配置套件註冊表
## 設定套件註冊表
要註冊套件註冊表，您需要編輯本地 `~/.pypirc` 文件。添加
@@ -29,8 +29,8 @@ password = {password}
| 佔位符 | 描述 |
| ---------- | ------------------------------------------------------------------------------------------------------------------- |
| `owner` | 套件的擁有者。 |
| `username` | 您的 Gitea 用戶名。 |
| `password` | 您的 Gitea 密碼。如果您使用 2FA 或 OAuth，請使用 [個人訪問令牌](development/api-usage.md#authentication) 代替密碼。 |
| `username` | 您的 Gitea 使用者名稱。 |
| `password` | 您的 Gitea 密碼。如果您使用 2FA 或 OAuth，請使用 [個人存取權杖](development/api-usage.md#認證) 代替密碼。 |
## 發布套件
@@ -54,8 +54,8 @@ pip install --index-url https://{username}:{password}@gitea.example.com/api/pack
| 參數 | 描述 |
| -------------- | ------------------------------- |
| `username` | 您的 Gitea 用戶名。 |
| `password` | 您的 Gitea 密碼或個人訪問令牌。 |
| `username` | 您的 Gitea 使用者名稱。 |
| `password` | 您的 Gitea 密碼或個人存取權杖。 |
| `owner` | 套件的擁有者。 |
| `package_name` | 套件名稱。 |
@@ -65,9 +65,9 @@ pip install --index-url https://{username}:{password}@gitea.example.com/api/pack
pip install --index-url https://testuser:password123@gitea.example.com/api/packages/testuser/pypi/simple --no-deps test_package
```
您可以使用 `--extra-index-url` 代替 `--index-url`，但這會使您容易受到依賴混淆攻擊，因為 `pip` 在檢查指定的自定義存儲庫之前會先檢查官方 PyPi 存儲庫。請閱讀 `pip` 文檔以獲取更多信息。
您可以使用 `--extra-index-url` 代替 `--index-url`，但這會使您容易受到依賴混淆攻擊，因為 `pip` 在檢查指定的自訂儲存庫之前會先檢查官方 PyPi 儲存庫。請閱讀 `pip` 文件以獲取更多資訊。
## 支持的命令
## 支援的命令
```
pip install

14
i18n/zh-tw/docusaurus-plugin-content-docs/version-1.23/usage/packages/rpm.md
View File

@@ -6,7 +6,7 @@ sidebar_position: 105
# RPM 套件註冊表
為您的用戶或組織發布 [RPM](https://rpm.org/) 套件。
為您的使用者或組織發布 [RPM](https://rpm.org/) 套件。
## 需求
@@ -14,7 +14,7 @@ sidebar_position: 105
以下範例使用 `dnf`。
## 配置套件註冊表
## 設定套件註冊表
要註冊 RPM 註冊表，請將 URL 添加到已知來源列表中：
@@ -37,13 +37,13 @@ dnf config-manager --add-repo https://gitea.example.com/api/packages/testuser/rp
dnf config-manager --add-repo https://gitea.example.com/api/packages/testuser/rpm/centos/el7.repo
```
如果註冊表是私有的，請在 URL 中提供憑證。您可以使用密碼或 [個人訪問令牌](development/api-usage.md#authentication)：
如果註冊表是私有的，請在 URL 中提供憑證。您可以使用密碼或 [個人存取權杖](development/api-usage.md#認證)：
```shell
dnf config-manager --add-repo https://{username}:{your_password_or_token}@gitea.example.com/api/packages/{owner}/rpm/{group}.repo
```
您還需要將憑證添加到創建的 `.repo` 文件中的 URL 中，位於 `/etc/yum.repos.d`。
您還需要將憑證添加到建立的 `.repo` 文件中的 URL 中，位於 `/etc/yum.repos.d`。
## 發布套件
@@ -72,10 +72,10 @@ curl --user your_username:your_password_or_token \
https://gitea.example.com/api/packages/testuser/rpm/centos/el7/upload
```
如果您使用 2FA 或 OAuth，請使用 [個人訪問令牌](development/api-usage.md#authentication) 代替密碼。
如果您使用 2FA 或 OAuth，請使用 [個人存取權杖](development/api-usage.md#認證) 代替密碼。
您不能將同名文件兩次發布到套件中。您必須先刪除現有的套件版本。
服務器響應以下 HTTP 狀態碼。
伺服器響應以下 HTTP 狀態碼。
| HTTP 狀態碼 | 含義 |
| ----------------- | ------------------------------------ |
@@ -111,7 +111,7 @@ curl --user your_username:your_token_or_password -X DELETE \
https://gitea.example.com/api/packages/testuser/rpm/centos/el7/package/test-package/1.0.0/x86_64
```
服務器響應以下 HTTP 狀態碼。
伺服器響應以下 HTTP 狀態碼。
| HTTP 狀態碼 | 含義 |
| ---------------- | ------------------ |

8
i18n/zh-tw/docusaurus-plugin-content-docs/version-1.23/usage/packages/rubygems.md
View File

@@ -6,13 +6,13 @@ sidebar_position: 110
# RubyGems 套件註冊表
為您的用戶或組織發布 [RubyGems](https://guides.rubygems.org/) 套件。
為您的使用者或組織發布 [RubyGems](https://guides.rubygems.org/) 套件。
## 需求
要使用 RubyGems 套件註冊表，您需要使用 [gem](https://guides.rubygems.org/command-reference/) 命令行工具來消費和發布套件。
## 配置套件註冊表
## 設定套件註冊表
要註冊套件註冊表，請編輯 `~/.gem/credentials` 文件並添加：
@@ -24,7 +24,7 @@ https://gitea.example.com/api/packages/{owner}/rubygems: Bearer {token}
| 參數 | 描述 |
| ------- | -------------------------------------------------------------- |
| `owner` | 套件的擁有者。 |
| `token` | 您的 [個人訪問令牌](development/api-usage.md#authentication)。 |
| `token` | 您的 [個人存取權杖](development/api-usage.md#認證)。 |
例如：
@@ -106,7 +106,7 @@ gem install --host https://gitea.example.com/api/packages/{owner}/rubygems {pack
gem install --host https://gitea.example.com/api/packages/testuser/rubygems test_package
```
## 支持的命令
## 支援的命令
```
gem install

26
i18n/zh-tw/docusaurus-plugin-content-docs/version-1.23/usage/packages/storage.md
View File

@@ -4,9 +4,9 @@ slug: "storage"
sidebar_position: 3
---
# 存儲
# 儲存
本文檔描述了套件註冊表的存儲及其管理方式。
本文件描述了套件註冊表的儲存及其管理方式。
## 去重
@@ -19,29 +19,29 @@ sidebar_position: 3
此時不會刪除 blob，因此它們仍然需要文件系統上的空間。
當上傳新套件時，現有的 blob 可能會再次被引用。
這些未引用的 blob 會被[清理作業](../../administration/config-cheat-sheet.md#cron---cleanup-expired-packages-croncleanup_packages)刪除。
配置設置 `OLDER_THAN` 配置了未引用的 blob 在刪除前保留的時間。
這些未引用的 blob 會被[清理作業](../../administration/config-cheat-sheet.md)刪除。
設定 `OLDER_THAN` 設定了未引用的 blob 在刪除前保留的時間。
## 清理規則
隨著時間的推移，套件註冊表可能會變得很大而不進行清理。
建議刪除不必要的套件並設置清理規則以自動管理套件註冊表的使用。
每個套件擁有者（用戶或組織）管理應用於其套件的清理規則。
建議刪除不必要的套件並設定清理規則以自動管理套件註冊表的使用。
每個套件擁有者（使用者或組織）管理應用於其套件的清理規則。
| 設置 | 描述 |
| 設定 | 描述 |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| 啟用 | 打開或關閉清理規則。 |
| 類型 | 每個規則管理特定的套件類型。 |
| 將模式應用於完整的套件名稱 | 如果啟用，下面的模式將應用於完整的套件名稱（`package/version`）。否則僅應用於版本（`version`）。 |
| 保留最新的 | 每個套件要*始終*保留的版本數量。 |
| 保留匹配的版本 | 確定要保留的版本的正則表達式模式。空模式不保留任何版本，而 `.+` 保留所有版本。即使未配置，容器註冊表也會始終保留 `latest` 版本。 |
| 保留匹配的版本 | 確定要保留的版本的正則表達式模式。空模式不保留任何版本，而 `.+` 保留所有版本。即使未設定，容器註冊表也會始終保留 `latest` 版本。 |
| 刪除早於的版本 | 只刪除早於選定天數的版本。 |
| 刪除匹配的版本 | 確定要刪除的版本的正則表達式模式。空模式或 `.+` 將導致刪除所有套件，如果沒有其他設置告訴否則。 |
| 刪除匹配的版本 | 確定要刪除的版本的正則表達式模式。空模式或 `.+` 將導致刪除所有套件，如果沒有其他設定告訴否則。 |
每個清理規則都可以顯示受影響套件的預覽。
這可以用來檢查清理規則是否配置正確。
這可以用來檢查清理規則是否設定正確。
### 正則表達式示例
### 正則表達式範例
正則表達式模式會自動用 `\A` 和 `\z` 錨點包圍。
不要在正則表達式模式中包含任何 `\A`、`\z`、`^` 或 `$` 符號，因為它們不是必需的。
@@ -55,11 +55,11 @@ sidebar_position: 3
| `release.*` | 匹配命名為或以 `release` 開頭的版本。 |
| `.+-temp-.+` | 匹配包含 `-temp-` 的版本。 |
| `v.+\|release` | 匹配以 `v` 開頭的版本或命名為 `release` 的版本。 |
| `package/v.+\|other/release` | 匹配套件 `package` 的以 `v` 開頭的版本或套件 `other` 的版本 `release`。這需要啟用設置*將模式應用於完整的套件名稱*。 |
| `package/v.+\|other/release` | 匹配套件 `package` 的以 `v` 開頭的版本或套件 `other` 的版本 `release`。這需要啟用設定*將模式應用於完整的套件名稱*。 |
### 清理規則的工作原理
清理規則是[清理作業](../../administration/config-cheat-sheet.md#cron---cleanup-expired-packages-croncleanup_packages)的一部分，並定期運行。
清理規則是[清理作業](../../administration/config-cheat-sheet.md)的一部分，並定期運行。
清理規則：

18
i18n/zh-tw/docusaurus-plugin-content-docs/version-1.23/usage/packages/swift.md
View File

@@ -6,13 +6,13 @@ sidebar_position: 115
# Swift 套件註冊表
為您的用戶或組織發布 [Swift](https://www.swift.org/) 套件。
為您的使用者或組織發布 [Swift](https://www.swift.org/) 套件。
## 需求
要使用 Swift 套件註冊表，您需要使用 [swift](https://www.swift.org/getting-started/) 來消費和使用 HTTP 客戶端（如 `curl`）來發布套件。
## 配置套件註冊表
## 設定套件註冊表
要註冊套件註冊表並提供憑證，請執行：
@@ -24,10 +24,10 @@ swift package-registry login https://gitea.example.com/api/packages/{owner}/swif
| 佔位符 | 描述 |
| ---------- | ------------------------------------------------------------------------------------------------------------------- |
| `owner` | 套件的擁有者。 |
| `username` | 您的 Gitea 用戶名。 |
| `password` | 您的 Gitea 密碼。如果您使用 2FA 或 OAuth，請使用 [個人訪問令牌](development/api-usage.md#authentication) 代替密碼。 |
| `username` | 您的 Gitea 使用者名稱。 |
| `password` | 您的 Gitea 密碼。如果您使用 2FA 或 OAuth，請使用 [個人存取權杖](development/api-usage.md#認證) 代替密碼。 |
登錄是可選的，僅在套件註冊表是私有時需要。
登入是可選的，僅在套件註冊表是私有時需要。
## 發布套件
@@ -49,17 +49,17 @@ curl -X PUT --user {username}:{password} \
| 佔位符 | 描述 |
| ---------- | ------------------------------------------------------------------------------------------------------------------- |
| `username` | 您的 Gitea 用戶名。 |
| `password` | 您的 Gitea 密碼。如果您使用 2FA 或 OAuth，請使用 [個人訪問令牌](development/api-usage.md#authentication) 代替密碼。 |
| `username` | 您的 Gitea 使用者名稱。 |
| `password` | 您的 Gitea 密碼。如果您使用 2FA 或 OAuth，請使用 [個人存取權杖](development/api-usage.md#認證) 代替密碼。 |
| `owner` | 套件的擁有者。 |
| `scope` | 套件範圍。 |
| `name` | 套件名稱。 |
| `version` | 套件版本。 |
| `metadata` | （可選）套件的元數據。JSON 編碼的 https://schema.org/SoftwareSourceCode 子集 |
| `metadata` | （可選）套件的元資料。JSON 編碼的 https://schema.org/SoftwareSourceCode 子集 |
如果已經存在同名同版本的套件，您不能發布該套件。您必須先刪除現有的套件。
服務器響應以下 HTTP 狀態碼。
伺服器響應以下 HTTP 狀態碼。
| HTTP 狀態碼 | 含義 |
| ----------------- | ------------------------------------ |

14
i18n/zh-tw/docusaurus-plugin-content-docs/version-1.23/usage/packages/vagrant.md
View File

@@ -6,7 +6,7 @@ sidebar_position: 120
# Vagrant 套件註冊表
為您的用戶或組織發布 [Vagrant](https://www.vagrantup.com/) 套件。
為您的使用者或組織發布 [Vagrant](https://www.vagrantup.com/) 套件。
## 需求
@@ -14,7 +14,7 @@ sidebar_position: 120
## 發布套件
通過執行 HTTP PUT 請求來發布 Vagrant box：
透過執行 HTTP PUT 請求來發布 Vagrant box：
```
PUT https://gitea.example.com/api/packages/{owner}/vagrant/{package_name}/{package_version}/{provider}.box
@@ -25,7 +25,7 @@ PUT https://gitea.example.com/api/packages/{owner}/vagrant/{package_name}/{packa
| `owner` | 套件的擁有者。 |
| `package_name` | 套件名稱。 |
| `package_version` | 套件版本，符合 semver。 |
| `provider` | [支持的提供者名稱](https://www.vagrantup.com/docs/providers)之一。 |
| `provider` | [支援的提供者名稱](https://www.vagrantup.com/docs/providers)之一。 |
上傳 Hyper-V box 的範例：
@@ -35,11 +35,11 @@ curl --user your_username:your_password_or_token \
https://gitea.example.com/api/packages/testuser/vagrant/test_system/1.0.0/hyperv.box
```
如果您使用 2FA 或 OAuth，請使用 [個人訪問令牌](development/api-usage.md#authentication) 代替密碼。
如果您使用 2FA 或 OAuth，請使用 [個人存取權杖](development/api-usage.md#認證) 代替密碼。
如果已經存在同名、同版本和同提供者的 box，您不能發布該 box。您必須先刪除現有的套件。
服務器響應以下 HTTP 狀態碼。
伺服器響應以下 HTTP 狀態碼。
| HTTP 狀態碼 | 含義 |
| ----------------- | ------------------------------------ |
@@ -67,9 +67,9 @@ vagrant box add "https://gitea.example.com/api/packages/testuser/vagrant/test_sy
```
這將安裝套件的最新版本。要添加特定版本，請使用 `--box-version` 參數。
如果註冊表是私有的，您可以在 `VAGRANT_CLOUD_TOKEN` 環境變量中傳遞您的 [個人訪問令牌](development/api-usage.md#authentication)。
如果註冊表是私有的，您可以在 `VAGRANT_CLOUD_TOKEN` 環境變量中傳遞您的 [個人存取權杖](development/api-usage.md#認證)。
## 支持的命令
## 支援的命令
```
vagrant box add