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

View File

@@ -4,83 +4,83 @@ slug: "upgrade-from-gitea"
sidebar_position: 100
---
# 从旧版 Gitea 升
# 從舊版 Gitea 升
在升之前,您需要做如下的准备工作。
在升之前,您需要做如下的準備工作。
## 重大变更检查更新日
## 重大變更檢查更新日
为了让 Gitea 得更好,行重大更是不可避免的,尤其是一些里程碑更新的发布
在更新前, [在 Gitea 博客上阅读更新日](https://blog.gitea.com/)
并检查重大更是否会影响你的 Gitea 例。
為了讓 Gitea 得更好,行重大更是不可避免的,尤其是一些里程碑更新的發佈
在更新前, [在 Gitea 部落格上閱讀更新日](https://blog.gitea.com/)
並檢查重大更是否會影響你的 Gitea 例。
## 在控制面板中检查过期的配置项
## 在控制面板中檢查過期的設定項
一些配置项可能会在后续版本中期,你需要在控制面板中查他。如果不解决过期的配置项
Gitea也许会在升级后无法重。你可以访问 https://docs.gitea.com 得要升的版本
对应的文档来修改你的配置文件。
一些設定項可能會在後續版本中期,你需要在控制面板中查他。如果不解決過期的設定項
Gitea也許會在升級後無法重。你可以訪問 https://docs.gitea.com 得要升的版本
對應的文件來修改你的設定文件。
## 降前的
## 降前的
Gitea 保留首二位版本相同的版本的容性 (`a.b.x` -> `a.b.y`)
些版本有相同的数据库结构,可以自由升或降
其他情 (`a.b.?` -> `a.c.?`)下,
新版 Gitea 可能将会将数据库升级到与旧版数据库不同的结构
Gitea 保留首二位版本相同的版本的容性 (`a.b.x` -> `a.b.y`)
些版本有相同的資料庫結構,可以自由升或降
其他情 (`a.b.?` -> `a.c.?`)下,
新版 Gitea 可能將會將資料庫升級到與舊版資料庫不同的結構
举个例子:
舉個例子:
| 前 | 目 | 果 |
| 前 | 目 | 果 |
| --- | --- | --- |
| 1.4.0 | 1.4.1 | ✅ |
| 1.4.1 | 1.4.0 | ⚠️ 不建议,后果自负!尽管数据库结构可能不会变更,它可以正常工作。我们强烈建议降级前进行完全的份。 |
| 1.4.x | 1.5.y | ✅ 数据库会被自动升级。你可以直接 1.4.x 升到最新的 1.5.y。 |
| 1.5.y | 1.4.x | ❌ 数据库已被升级且无法用于旧版本Gitea使用备份来进行降。 |
| 1.4.1 | 1.4.0 | ⚠️ 不建議,後果自負!儘管資料庫結構可能不會變更,它可以正常工作。我們強烈建議降級前進行完全的份。 |
| 1.4.x | 1.5.y | ✅ 資料庫會被自動升級。你可以直接 1.4.x 升到最新的 1.5.y。 |
| 1.5.y | 1.4.x | ❌ 資料庫已被升級且無法用於舊版本Gitea使用備份來進行降。 |
**因你不能基于升级后的数据库运行旧版 Gitea所以你应该在数据库升级前完成数据备份。**
**因你不能基於升級後的資料庫運行舊版 Gitea所以你應該在資料庫升級前完成資料備份。**
如果你在生产环境下使用 Gitea应该在升前做好份,哪怕只是小版本的丁更新。
如果你在生產環境下使用 Gitea應該在升前做好份,哪怕只是小版本的丁更新。
份步:
份步:
* 停止 Gitea
* 备份数据库
* 份 Gitea 配置文件
* 份 Gitea 在 `APP_DATA_PATH` 中的数据文件
* 份 Gitea 的外部存 (例如: S3/MinIO 或被使用的其他存)
* 停止 Gitea
* 備份資料庫
* 份 Gitea 設定文件
* 份 Gitea 在 `APP_DATA_PATH` 中的資料文件
* 份 Gitea 的外部存 (例如: S3/MinIO 或被使用的其他存)
如果你在使用云服务或拥有快照功能的文件系
最好 Gitea 的数据盘及相关资料存储进行一次快照。
如果你在使用雲服務或擁有快照功能的文件系
最好 Gitea 的資料盤及相關資料儲存進行一次快照。
在所有上述步骤准备妥当之后,要升 Gitea只需要下新版,停止运行旧版,进行数据备份,然后运行新版就好。
每次 Gitea 实例启动时,它都会检查是否要进行数据库迁移。
如果需要进行数据库迁Gitea 花一些时间完成升级然后继续服务
在所有上述步驟準備妥當之後,要升 Gitea只需要下新版,停止運行舊版,進行資料備份,然後運行新版就好。
每次 Gitea 實例啟動時,它都會檢查是否要進行資料庫遷移。
如果需要進行資料庫遷Gitea 花一些時間完成升級然後繼續服務
## Docker 升
## Docker 升
* `docker pull` 拉取 Gitea 的最新布版。
* 停止行中的例,备份数据
* 使用 `docker``docker-compose` 启动较新的 Gitea Docker 容器.
* `docker pull` 拉取 Gitea 的最新布版。
* 停止行中的例,備份資料
* 使用 `docker``docker-compose` 啟動較新的 Gitea Docker 容器.
## 包升
## 包升
* 停止行中的例,备份数据
* 使用你的管理器更新 Gitea 到最新版本。
* 启动 Gitea 例。
* 停止行中的例,備份資料
* 使用你的套件管理器更新 Gitea 到最新版本。
* 啟動 Gitea 例。
## 从二进制升
## 從二進制升
*最新的 Gitea 二制文件到临时文件中。
* 停止行中的例,备份数据
* 将旧的 Gitea 二制文件覆成新的。
* 启动 Gitea 例。
*最新的 Gitea 二制文件到臨時文件中。
* 停止行中的例,備份資料
* 將舊的 Gitea 二制文件覆成新的。
* 啟動 Gitea 例。
在 Linux 系上自动执行以上步骤的脚本可在 [Gitea 的 source tree 中找到 `contrib/upgrade.sh` 来获](https://github.com/go-gitea/gitea/blob/main/contrib/upgrade.sh).
在 Linux 系上自動執行以上步驟的腳本可在 [Gitea 的 source tree 中找到 `contrib/upgrade.sh` 來獲](https://github.com/go-gitea/gitea/blob/main/contrib/upgrade.sh).
## 小心你的自定义模板
## 小心你的自模板
Gitea 的模板结构与变量可能会随着各个版本的发布发生变化,如果你使用了自定义模板,
你得注意你的模板你使用的 Gitea 版本的容性。
Gitea 的模板結構與變量可能會隨著各個版本的發佈發生變化,如果你使用了自模板,
你得注意你的模板你使用的 Gitea 版本的容性。
如果自定义模板 Gitea 版本不容,你可能遇到:
`50x` 服务器错误,页面元素失或故障,莫名其妙的页面布局,等等…
移除或更新不容的模板Gitea Web 可以正常工作。
如果自模板 Gitea 版本不容,你可能遇到:
`50x` 伺服器錯誤,頁面元素失或故障,莫名其妙的頁面佈局,等等…
移除或更新不容的模板Gitea Web 可以正常工作。