gitea/gitea-docs
1
0
Fork 0
mirror of https://gitea.com/gitea/docs.git synced 2026-07-22 11:17:51 +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

171
i18n/zh-tw/docusaurus-plugin-content-docs/version-1.23/help/faq.md
View File

@@ -20,35 +20,36 @@ aliases:
1.20 目錄是每次合併提交到 [`release/v1.20`](https://github.com/go-gitea/gitea/tree/release/v1.20) 分支時構建的夜間構建。
1.20.0 目錄是當 [`v1.20.0`](https://github.com/go-gitea/gitea/releases/tag/v1.20.0) 標籤創建時創建的發布構建。
1.20.0 目錄是當 [`v1.20.0`](https://github.com/go-gitea/gitea/releases/tag/v1.20.0) 標籤建立時建立的發布構建。
夜間構建（1.x）下載將隨著提交合併到各自的分支而變化，它們包含在標籤發布之前的最新更改/修復。
如果錯誤修復針對 1.20.1，但 1.20.1 尚未發布，您可以獲取 "1.20-nightly" 構建以獲取錯誤修復。
## 如何找到配置文件 "app.ini"
## 如何找到設定文件 "app.ini"
這取決於您如何安裝 Gitea。如果您沒有手動設置自定義路徑或配置文件的路徑，那麼配置文件 (app.ini) 應該存在於 Gitea 工作路徑的 "custom/conf" 目錄中。一些軟件包供應商可能會使用 "/etc/gitea" 來存儲配置文件，而其他供應商則不會。
這取決於您如何安裝 Gitea。如果您沒有手動設定自訂路徑或設定文件的路徑，那麼設定文件 (app.ini) 應該存在於 Gitea 工作路徑的 "custom/conf" 目錄中。一些套件供應商可能會使用 "/etc/gitea" 來儲存設定文件，而其他供應商則不會。
您可以通過檢查 Gitea 的啟動日誌或閱讀 Gitea 網站管理員 -> 配置摘要來手動查找配置文件 (app.ini)。
您可以透過檢查 Gitea 的啟動日誌或閱讀 Gitea 網站管理員 -> 設定摘要來手動查找設定文件 (app.ini)。
如果您使用的是一些隔離環境（如容器 docker），您看到的路徑通常不是主機文件系統中的實際路徑。在這種情況下，您需要檢查容器的文件系統卷映射並找出主機上配置文件的實際路徑。
如果您使用的是一些隔離環境（如容器 docker），您看到的路徑通常不是主機文件系統中的實際路徑。在這種情況下，您需要檢查容器的文件系統卷映射並找出主機上設定文件的實際路徑。
## Gitea 存儲文件的位置
<a id="where-does-gitea-store-what-file"></a>
## Gitea 儲存文件的位置
- _`AppWorkPath`_
- `app.ini` 中的 `WORK_PATH` 選項
- 否則 `--work-path` 標誌
- 否則環境變量 `GITEA_WORK_DIR`
- 否則在構建時設置的內置值
- 否則在構建時設定的內置值
- 否則包含 Gitea 二進制文件的目錄
- `AppDataPath`（默認為數據庫、索引器等）
- `AppDataPath`（預設為資料庫、索引器等）
- `app.ini` 中的 `APP_DATA_PATH`
- 否則 _`AppWorkPath`_`/data`
- _`CustomPath`_（自定義模板）
- _`CustomPath`_（自訂模板）
- `--custom-path` 標誌
- 否則環境變量 `GITEA_CUSTOM`
- 否則在構建時設置的內置值
- 否則在構建時設定的內置值
- 否則 _`AppWorkPath`_`/custom`
- HomeDir
- Unix：環境變量 `HOME`
@@ -56,12 +57,12 @@ aliases:
- RepoRootPath
- `app.ini` 中 \[repository] 部分的 `ROOT`（如果是絕對路徑）
- 否則 _`AppWorkPath`_`/ROOT`（如果 `app.ini` 中 \[repository] 部分的 `ROOT` 是相對路徑）
- 默認 `%(APP_DATA_PATH)/gitea-repositories`
- INI（配置文件）
- 預設 `%(APP_DATA_PATH)/gitea-repositories`
- INI（設定文件）
- `--config` 標誌
- 構建時設置的可能內置值
- 構建時設定的可能內置值
- 否則 _`CustomPath`_`/conf/app.ini`
- SQLite 數據庫
- SQLite 資料庫
- `app.ini` 中 `database` 部分的 `PATH`
- 否則 `%(APP_DATA_PATH)/gitea.db`
@@ -70,13 +71,13 @@ aliases:
有幾個地方可能會導致顯示不正確。
1. 如果使用反向代理，請確保您已按照[反向代理指南](../administration/reverse-proxies.md)中的正確指示進行操作
2. 確保您已正確設置 `app.ini` 中 `server` 部分的 `ROOT_URL`
2. 確保您已正確設定 `app.ini` 中 `server` 部分的 `ROOT_URL`
如果某些克隆選項未顯示（HTTP/S 或 SSH），可以在 `app.ini` 中檢查以下選項
- `DISABLE_HTTP_GIT`：如果設置為 true，則不會有 HTTP/HTTPS 連接
- `DISABLE_SSH`：如果設置為 true，則不會有 SSH 連接
- `SSH_EXPOSE_ANONYMOUS`：如果設置為 false，則匿名用戶將隱藏 SSH 連接
- `DISABLE_HTTP_GIT`：如果設定為 true，則不會有 HTTP/HTTPS 連接
- `DISABLE_SSH`：如果設定為 true，則不會有 SSH 連接
- `SSH_EXPOSE_ANONYMOUS`：如果設定為 false，則匿名使用者將隱藏 SSH 連接
## 文件上傳失敗：413 Request Entity Too Large
@@ -84,43 +85,43 @@ aliases:
請參閱[反向代理指南](../administration/reverse-proxies.md)以獲取 nginx 的解決方案。
## 自定義模板未加載或工作不正確
## 自訂模板未加載或工作不正確
Gitea 的自定義模板必須添加到正確的位置，否則 Gitea 將無法找到並使用它們。
Gitea 的自訂模板必須添加到正確的位置，否則 Gitea 將無法找到並使用它們。
模板的正確路徑將相對於 `CustomPath`
1. 要查找 `CustomPath`，請在網站管理 -> 配置中查找自定義文件根路徑
2. 如果您仍然無法找到路徑，可以[在上面計算](#where-does-gitea-store-what-file)默認值
3. 一旦您找到了正確的自定義路徑，您可以參考[自定義 Gitea](../administration/customizing-gitea.md)頁面將模板添加到正確的位置。
1. 要查找 `CustomPath`，請在網站管理 -> 設定中查找自訂文件根路徑
2. 如果您仍然無法找到路徑，可以在上面計算預設值
3. 一旦您找到了正確的自訂路徑，您可以參考[自訂 Gitea](../administration/customizing-gitea.md)頁面將模板添加到正確的位置。
## Gitea 是否有 "GitHub/GitLab pages" 功能？
Gitea 沒有內置的 Pages 服務器。您需要一個專用域來提供靜態頁面以避免 CSRF 安全風險。
Gitea 沒有內置的 Pages 伺服器。您需要一個專用域來提供靜態頁面以避免 CSRF 安全風險。
對於簡單的使用，您可以使用反向代理來重寫並從 Gitea 的原始文件 URL 提供靜態內容。
已經有可用的第三方服務，如獨立的[pages 服務器](https://codeberg.org/Codeberg/pages-server)或[caddy 插件](https://github.com/42wim/caddy-gitea)，可以提供所需的功能。
已經有可用的第三方服務，如獨立的[pages 伺服器](https://codeberg.org/Codeberg/pages-server)或[caddy 外掛](https://github.com/42wim/caddy-gitea)，可以提供所需的功能。
## 活躍用戶與禁止登錄用戶
## 活躍使用者與禁止登入使用者
在 Gitea 中，“活躍”用戶是指通過電子郵件激活其帳戶的用戶。
在 Gitea 中，“活躍”使用者是指通過電子郵件激活其帳戶的使用者。
“禁止登錄”用戶是指不再允許登錄 Gitea 的用戶
“禁止登入”使用者是指不再允許登入 Gitea 的使用者
## 什麼是 Swagger？
[Swagger](https://swagger.io/) 是 Gitea 用於其 API 文檔的工具。
[Swagger](https://swagger.io/) 是 Gitea 用於其 API 文件的工具。
所有 Gitea 實例都有內置的 API，無法完全禁用它。
但是，您可以通過在 `app.ini` 的 `api` 部分中設置 `ENABLE_SWAGGER` 為 `false` 來禁用顯示其文檔。
有關更多信息，請參閱 Gitea 的 [API 文檔](development/api-usage.md)。
但是，您可以透過在 `app.ini` 的 `api` 部分中設定 `ENABLE_SWAGGER` 為 `false` 來禁用顯示其文件。
有關更多資訊，請參閱 Gitea 的 [API 文件](development/api-usage.md)。
您可以在 https://gitea.com/api/swagger 上查看最新的 API（例如）
您還可以在 https://gitea.com/swagger.v1.json 上查看 `swagger.json` 文件的示例
您還可以在 https://gitea.com/swagger.v1.json 上查看 `swagger.json` 文件的範例
## 調整您的服務器以供公用/私用
## 調整您的伺服器以供公用/私用
### 防止垃圾郵件
@@ -128,48 +129,48 @@ Gitea 沒有內置的 Pages 服務器。您需要一個專用域來提供靜態
1. 通過白名單或黑名單某些電子郵件域
2. 通過僅白名單某些域與 OpenID（見下文）
3. 在 `app.ini` 中設置 `ENABLE_CAPTCHA` 為 `true` 並正確配置 `RECAPTCHA_SECRET` 和 `RECAPTCHA_SITEKEY`
4. 設置 `DISABLE_REGISTRATION` 為 `true` 並通過 [CLI](../administration/command-line.md)、[API](development/api-usage.md) 或 Gitea 的管理 UI 創建新用戶
3. 在 `app.ini` 中設定 `ENABLE_CAPTCHA` 為 `true` 並正確設定 `RECAPTCHA_SECRET` 和 `RECAPTCHA_SITEKEY`
4. 設定 `DISABLE_REGISTRATION` 為 `true` 並通過 [CLI](../administration/command-line.md)、[API](development/api-usage.md) 或 Gitea 的管理 UI 建立新使用者
### 只允許/阻止某些電子郵件域
您可以在 `app.ini` 的 `[service]` 部分中配置 `EMAIL_DOMAIN_WHITELIST` 或 `EMAIL_DOMAIN_BLOCKLIST`
您可以在 `app.ini` 的 `[service]` 部分中設定 `EMAIL_DOMAIN_WHITELIST` 或 `EMAIL_DOMAIN_BLOCKLIST`
### 只允許/阻止某些 OpenID 提供商
您可以在 `app.ini` 的 `[openid]` 部分中配置 `WHITELISTED_URIS` 或 `BLACKLISTED_URIS`
您可以在 `app.ini` 的 `[openid]` 部分中設定 `WHITELISTED_URIS` 或 `BLACKLISTED_URIS`
:::note
白名單優先，如果它不是空白的，則忽略黑名單。
:::
### 僅限問題用戶
### 僅限問題使用者
目前的實現方式是創建/修改用戶，將其最大倉庫創建限制設置為 0。
目前的實現方式是建立/修改使用者，將其最大儲存庫建立限制設定為 0。
### 受限用戶
### 受限使用者
受限用戶僅限於根據其組織/團隊成員資格和協作關係訪問部分內容，忽略組織/倉庫等的公共標誌。
受限使用者僅限於根據其組織/團隊成員資格和協作關係訪問部分內容，忽略組織/儲存庫等的公共標誌。
示例用例：一家公司運行一個需要登錄的 Gitea 實例。大多數倉庫是公共的（所有同事都可以訪問/瀏覽）。
範例用例：一家公司運行一個需要登入的 Gitea 實例。大多數儲存庫是公共的（所有同事都可以訪問/瀏覽）。
某個時候，客戶或第三方需要訪問特定倉庫並且僅限於該倉庫。將此類客戶帳戶設置為受限並使用團隊成員資格和/或協作關係授予所需的訪問權限是一種簡單的方法，無需將所有內容設置為私有。
某個時候，客戶或第三方需要訪問特定儲存庫並且僅限於該儲存庫。將此類客戶帳戶設定為受限並使用團隊成員資格和/或協作關係授予所需的存取權限是一種簡單的方法，無需將所有內容設定為私有。
### 啟用 Fail2ban
使用 [Fail2Ban](../administration/fail2ban-setup.md) 監控並阻止基於日誌模式的自動登錄嘗試或其他惡意行為
使用 [Fail2Ban](../administration/fail2ban-setup.md) 監控並阻止基於日誌模式的自動登入嘗試或其他惡意行為
## SSHD 與內置 SSH
SSHD 是大多數 Unix 系統上的內置 SSH 服務器。
SSHD 是大多數 Unix 系統上的內置 SSH 伺服器。
Gitea 也提供了自己的 SSH 服務器，用於 SSHD 不可用時使用。
Gitea 也提供了自己的 SSH 伺服器，用於 SSHD 不可用時使用。
## 翻譯不正確/如何添加更多翻譯
我們的翻譯目前在我們的 [Crowdin 項目](https://crowdin.com/project/gitea) 上進行群眾外包
我們的翻譯目前在我們的 [Crowdin 專案](https://crowdin.com/project/gitea) 上進行群眾外包
無論您是想更改翻譯還是添加新翻譯，都需要在那裡進行，因為所有翻譯都會在我們的 CI 中通過 Crowdin 集成進行覆蓋。
無論您是想更改翻譯還是添加新翻譯，都需要在那裡進行，因為所有翻譯都會在我們的 CI 中通過 Crowdin 整合進行覆蓋。
## 推送 Hook / Webhook / Actions 未運行
@@ -177,15 +178,15 @@ Gitea 也提供了自己的 SSH 服務器，用於 SSHD 不可用時使用。
有幾種可能性：
1. git hooks 不同步：在網站管理面板上運行“重新同步所有倉庫的 pre-receive、update 和 post-receive hooks”
2. git 倉庫（和 hooks）存儲在某些文件系統上（例如由 NAS 掛載）不支持腳本執行，確保文件系統支持 `chmod a+x any-script`
3. 如果您使用 docker，確保 Docker 服務器（不是客戶端）>= 20.10.6
1. git hooks 不同步：在網站管理面板上運行“重新同步所有儲存庫的 pre-receive、update 和 post-receive hooks”
2. git 儲存庫（和 hooks）儲存在某些文件系統上（例如由 NAS 掛載）不支援腳本執行，確保文件系統支援 `chmod a+x any-script`
3. 如果您使用 docker，確保 Docker 伺服器（不是客戶端）>= 20.10.6
## SSH 問題
如果您無法通過 `ssh` 訪問倉庫，但 `https` 正常工作，請考慮查看以下內容。
如果您無法通過 `ssh` 訪問儲存庫，但 `https` 正常工作，請考慮查看以下內容。
首先，確保您可以通過 SSH 訪問 Gitea。
首先，確保您可以透過 SSH 訪問 Gitea。
`ssh git@myremote.example`
@@ -198,7 +199,7 @@ If this is unexpected, please log in with password and setup Gitea under another
如果您沒有收到上述消息但仍然連接，這意味著您的 SSH 密鑰**未**由 Gitea 管理。這意味著 hooks 不會運行，還有其他潛在問題。
如果您無法連接，您的 SSH 密鑰可能在本地配置不正確。
如果您無法連接，您的 SSH 密鑰可能在本地設定不正確。
這是特定於 SSH 而不是 Gitea 的問題，因此不在此處涵蓋。
### SSH 常見錯誤
@@ -208,25 +209,25 @@ Permission denied (publickey).
fatal: Could not read from remote repository.
```
此錯誤表示服務器拒絕了登錄嘗試，請檢查以下內容：
此錯誤表示伺服器拒絕了登入嘗試，請檢查以下內容：
- 在客戶端：
- 確保公鑰和私鑰已添加到正確的 Gitea 用戶。
- 確保遠程 URL 中沒有問題。特別是，確保 Git 用戶名（在 `@` 之前）拼寫正確。
- 確保公鑰和私鑰已添加到正確的 Gitea 使用者。
- 確保遠程 URL 中沒有問題。特別是，確保 Git 使用者名稱（在 `@` 之前）拼寫正確。
- 確保客戶端機器上的公鑰和私鑰正確。
- 在服務器上：
- 在伺服器上：
- 確保倉庫存在並且名稱正確。
- 檢查系統用戶主目錄中 `.ssh` 目錄的權限。
- 確保儲存庫存在並且名稱正確。
- 檢查系統使用者主目錄中 `.ssh` 目錄的權限。
- 驗證正確的公鑰已添加到 `.ssh/authorized_keys`。
嘗試在 Gitea 管理面板上運行“重寫 '.ssh/authorized_keys' 文件（用於 Gitea SSH 密鑰）”。
- 閱讀 Gitea 日誌。
- 閱讀 /var/log/auth（或類似）。
- 檢查倉庫的權限。
- 檢查儲存庫的權限。
以下是缺少公鑰的示例，其中身份驗證成功，但某些其他設置阻止 SSH 訪問正確的倉庫。
以下是缺少公鑰的範例，其中身份驗證成功，但某些其他設定阻止 SSH 訪問正確的儲存庫。
```
fatal: Could not read from remote repository.
@@ -235,77 +236,77 @@ Please make sure you have the correct access rights
and the repository exists.
```
在這種情況下，請查看以下設置：
在這種情況下，請查看以下設定：
- 在服務器上：
- 確保 `git` 系統用戶設置了可用的 shell
- 在伺服器上：
- 確保 `git` 系統使用者設定了可用的 shell
- 使用 `getent passwd git | cut -d: -f7` 驗證
- 可以使用 `usermod` 或 `chsh` 進行修改。
- 確保 `.ssh/authorized_keys` 中的 `gitea serv` 命令使用正確的配置文件。
- 確保 `.ssh/authorized_keys` 中的 `gitea serv` 命令使用正確的設定文件。
## 遷移帶有標籤的倉庫後缺少發布
## 遷移帶有標籤的儲存庫後缺少發布
要遷移帶有所有標籤的倉庫，您需要做兩件事：
要遷移帶有所有標籤的儲存庫，您需要做兩件事：
- 將標籤推送到倉庫：
- 將標籤推送到儲存庫：
```
git push --tags
```
- 在 Gitea 中（重新）同步所有倉庫的標籤：
- 在 Gitea 中（重新）同步所有儲存庫的標籤：
```
gitea admin repo-sync-releases
```
## 如何在啟動 Gitea 之前創建用戶
## 如何在啟動 Gitea 之前建立使用者
Gitea 提供了一個子命令 `gitea migrate` 來初始化數據庫，之後您可以使用 [admin CLI 命令](../administration/command-line.md#admin) 像正常一樣添加用戶。
Gitea 提供了一個子命令 `gitea migrate` 來初始化資料庫，之後您可以使用 [admin CLI 命令](../administration/command-line.md#admin) 像正常一樣添加使用者。
## 如何啟用密碼重置
沒有密碼重置的設置。當配置了[郵件服務](../administration/email-setup.md)時，它會啟用，否則禁用。
沒有密碼重置的設定。當設定了[郵件服務](../administration/email-setup.md)時，它會啟用，否則禁用。
## 如何更改用戶的密碼
## 如何更改使用者的密碼
- 作為**管理員**，您可以更改任何用戶的密碼（並可選擇強制他們在下次登錄時更改）...
- 作為**管理員**，您可以更改任何使用者的密碼（並可選擇強制他們在下次登入時更改）...
- 通過導航到您的 `網站管理 -> 用戶帳戶` 頁面並編輯用戶。
- 通過導航到您的 `網站管理 -> 用戶帳戶` 頁面並編輯使用者。
- 通過使用 [admin CLI 命令](../administration/command-line.md#admin)。
請記住，大多數命令還需要一個[全局標誌](../administration/command-line.md#global-options)來指向正確的配置。
請記住，大多數命令還需要一個[全域標誌](../administration/command-line.md#global-options)來指向正確的設定。
- 作為**用戶**，您可以更改它...
- 作為**使用者**，您可以更改它...
- 在您的帳戶 `設置 -> 帳戶` 頁面（此方法**需要**您知道當前密碼）。
- 通過使用 `忘記密碼` 連結。
如果 `忘記密碼/帳戶恢復` 頁面被禁用，請聯繫您的管理員配置[郵件服務](../administration/email-setup.md)。
如果 `忘記密碼/帳戶恢復` 頁面被禁用，請聯繫您的管理員設定[郵件服務](../administration/email-setup.md)。
## 數據庫啟動期間有關結構默認值的警告
## 資料庫啟動期間有關結構預設值的警告
有時在進行遷移時，舊列和默認值可能會保留在數據庫模式中。這可能會導致如下警告：
有時在進行遷移時，舊列和預設值可能會保留在資料庫模式中。這可能會導致如下警告：
```
2020/08/02 11:32:29 ...rm/session_schema.go:360:Sync() [W] Table user Column keep_activity_private db default is , struct default is 0
```
這些警告可以安全地忽略，但您可以通過讓 Gitea 重新創建這些表來停止這些警告：
這些警告可以安全地忽略，但您可以透過讓 Gitea 重新建立這些表來停止這些警告：
```
gitea doctor recreate-table user
```
這將使 Gitea 重新創建用戶表並將舊數據複製到新表中，並適當設置默認值。
這將使 Gitea 重新建立使用者表並將舊資料複製到新表中，並適當設定預設值。
您可以讓 Gitea 重新創建多個表：
您可以讓 Gitea 重新建立多個表：
```
gitea doctor recreate-table table1 table2 ...
```
如果您希望 Gitea 重新創建所有表，只需調用：
如果您希望 Gitea 重新建立所有表，只需調用：
```
gitea doctor recreate-table