|
4 | 4 | [](https://discord.gg/Gitea "Join the Discord chat at https://discord.gg/Gitea") |
5 | 5 | [](https://goreportcard.com/report/code.gitea.io/gitea "Go Report Card") |
6 | 6 | [](https://pkg.go.dev/code.gitea.io/gitea "GoDoc") |
7 | | -[](https://github.com/go-gitea/gitea/releases/latest "GitHub release") |
8 | | -[](https://www.codetriage.com/go-gitea/gitea "Help Contribute to Open Source") |
9 | | -[](https://opencollective.com/gitea "Become a backer/sponsor of gitea") |
| 7 | +[](https://github.com/go-gitea/gitea/releases/latest "GitHub 版本發布") |
| 8 | +[](https://www.codetriage.com/go-gitea/gitea "協助貢獻開源專案") |
| 9 | +[](https://opencollective.com/gitea "成為 gitea 的支持者/贊助商") |
10 | 10 | [](https://opensource.org/licenses/MIT "License: MIT") |
11 | | -[](https://gitpod.io/#https://github.com/go-gitea/gitea) |
| 11 | +[](https://gitpod.io/#https://github.com/go-gitea/gitea) |
12 | 12 | [](https://translate.gitea.com "Crowdin") |
13 | 13 |
|
14 | | -[English](./README.md) | [简体中文](./README.zh-cn.md) |
| 14 | +[English](./README.md) | [繁體中文](./README.zh-tw.md) |
15 | 15 |
|
16 | | -## 目的 |
| 16 | +## 專案目標 |
| 17 | +本專案的核心目標,是讓自建 Git 服務的過程,變得最簡單、最高效、最省心。 |
17 | 18 |
|
18 | | -這個項目的目標是提供最簡單、最快速、最無痛的方式來設置自託管的 Git 服務。 |
| 19 | +Gitea 基於 Go 語言開發,凡 Go 語言支持的平台與架構,它皆能適配,涵蓋 Linux、macOS、Windows 系統,以及 x86、amd64、ARM、PowerPC 架構。專案自 2016 年 11 月從[Gogs](https://gogs.io)[分叉](https://blog.gitea.com/welcome-to-gitea/)而來,如今已是煥然一新。 |
19 | 20 |
|
20 | | -由於 Gitea 是用 Go 語言編寫的,它可以在 Go 支援的所有平台和架構上運行,包括 Linux、macOS 和 Windows 的 x86、amd64、ARM 和 PowerPC 架構。這個項目自 2016 年 11 月從 [Gogs](https://gogs.io) [分叉](https://blog.gitea.com/welcome-to-gitea/) 而來,但已經有了很多變化。 |
| 21 | +- 線上體驗:造訪[demo.gitea.com](https://demo.gitea.com) |
| 22 | +- 免費服務(儲存庫數量有限):造訪[gitea.com](https://gitea.com/user/login) |
| 23 | +- 快速部署專屬實例:前往[cloud.gitea.com](https://cloud.gitea.com)開啟免費試用 |
21 | 24 |
|
22 | | -在線演示可以訪問 [demo.gitea.com](https://demo.gitea.com)。 |
23 | 25 |
|
24 | | -要訪問免費的 Gitea 服務(有一定數量的倉庫限制),可以訪問 [gitea.com](https://gitea.com/user/login)。 |
| 26 | +## 官方文件 |
| 27 | +你可在[官方文件網站](https://docs.gitea.com/)取得完整文件,內容涵蓋安裝部署、管理維護、使用指南、開發貢獻等,助你快速上手並充分探索所有功能。 |
25 | 28 |
|
26 | | -要快速部署您自己的專用 Gitea 實例,可以在 [cloud.gitea.com](https://cloud.gitea.com) 開始免費試用。 |
| 29 | +若有建議或想參與文檔編寫,可造訪[文檔倉庫](https://gitea.com/gitea/docs)。 |
27 | 30 |
|
28 | | -## 文件 |
29 | 31 |
|
30 | | -您可以在我們的官方 [文件網站](https://docs.gitea.com/) 上找到全面的文件。 |
| 32 | +## 建構方法 |
| 33 | +進入原始碼根目錄,執行以下命令建構: |
31 | 34 |
|
32 | | -它包括安裝、管理、使用、開發、貢獻指南等,幫助您快速入門並有效地探索所有功能。 |
| 35 | +``` |
| 36 | +TAGS="bindata" make build |
| 37 | +``` |
33 | 38 |
|
34 | | -如果您有任何建議或想要貢獻,可以訪問 [文件倉庫](https://gitea.com/gitea/docs) |
| 39 | +若需支持 SQLite 資料庫,執行: |
35 | 40 |
|
36 | | -## 構建 |
| 41 | + ``` |
| 42 | +TAGS="bindata sqlite sqlite_unlock_notify" make build |
| 43 | +``` |
37 | 44 |
|
38 | | -從源代碼樹的根目錄運行: |
| 45 | +`build`目標分為兩個子目標: |
39 | 46 |
|
40 | | - TAGS="bindata" make build |
| 47 | +- `make backend`:需依賴[Go Stable](https://go.dev/dl/),具體版本見[go.mod](/go.mod) |
| 48 | +- `make frontend`:需依賴[Node.js LTS](https://nodejs.org/en/download/)(及以上版本)和[pnpm](https://pnpm.io/installation) |
41 | 49 |
|
42 | | -如果需要 SQLite 支援: |
| 50 | +構建需聯網以下載 Go 和 npm 依賴套件。若使用包含預構建前端檔案的官方原始碼壓縮包,無需觸發`frontend`目標,無 Node.js 環境也可完成構建。 |
43 | 51 |
|
44 | | - TAGS="bindata sqlite sqlite_unlock_notify" make build |
| 52 | +更多細節:[https://docs.gitea.com/installation/install-from-source](https://docs.gitea.com/installation/install-from-source) |
45 | 53 |
|
46 | | -`build` 目標分為兩個子目標: |
47 | 54 |
|
48 | | -- `make backend` 需要 [Go Stable](https://go.dev/dl/),所需版本在 [go.mod](/go.mod) 中定義。 |
49 | | -- `make frontend` 需要 [Node.js LTS](https://nodejs.org/en/download/) 或更高版本。 |
| 55 | +## 使用方法 |
| 56 | +構建完成後,原始碼根目錄預設會產生 `gitea` 可執行檔案,執行命令: |
50 | 57 |
|
51 | | -需要互聯網連接來下載 go 和 npm 模塊。從包含預構建前端文件的官方源代碼壓縮包構建時,不會觸發 `frontend` 目標,因此可以在沒有 Node.js 的情況下構建。 |
| 58 | +``` |
| 59 | +./gitea web |
| 60 | +``` |
52 | 61 |
|
53 | | -更多信息:https://docs.gitea.com/installation/install-from-source |
| 62 | +> [!NOTE] |
| 63 | +> 若需調用 API,我們已提供實驗性支援,文件詳見[此處](https://docs.gitea.com/api)。 |
54 | 64 |
|
55 | | -## 使用 |
56 | 65 |
|
57 | | -構建後,默認情況下會在源代碼樹的根目錄生成一個名為 `gitea` 的二進制文件。要運行它,請使用: |
| 66 | +## 貢獻指南 |
| 67 | +標準流程:Fork → Patch → Push → Pull Request |
58 | 68 |
|
59 | | - ./gitea web |
| 69 | +> [!NOTE] |
| 70 | +> 1. 提交 Pull Request 前,務必閱讀[《貢獻者指南》](CONTRIBUTING.md)! |
| 71 | +> 2. 若發現項目漏洞,請通過郵件**[email protected]**私信反饋,感謝你的嚴謹! |
60 | 72 |
|
61 | | -> [!注意] |
62 | | -> 如果您對使用我們的 API 感興趣,我們提供了實驗性支援,並附有 [文件](https://docs.gitea.com/api)。 |
63 | 73 |
|
64 | | -## 貢獻 |
| 74 | +## 多語言翻譯 |
| 75 | +翻譯工作透過 [Crowdin](https://translate.gitea.com) 進行。若需新增翻譯語言,可聯絡 Crowdin 專案管理員新增;也可提交 issue 申請,或在 Discord 的 #translation 頻道諮詢。 |
65 | 76 |
|
66 | | -預期的工作流程是:Fork -> Patch -> Push -> Pull Request |
| 77 | +若需翻譯上下文或發現翻譯問題,可在對應文本下留言或透過 Discord 溝通。文件設有翻譯相關專區(目前內容待補充),將根據問題逐步完善。 |
67 | 78 |
|
68 | | -> [!注意] |
69 | | -> |
70 | | -> 1. **在開始進行 Pull Request 之前,您必須閱讀 [貢獻者指南](CONTRIBUTING.md)。** |
71 | | -> 2. 如果您在項目中發現了漏洞,請私下寫信給 **[email protected]**。謝謝! |
| 79 | +更多資訊:[翻譯貢獻文件](https://docs.gitea.com/contributing/localization) |
72 | 80 |
|
73 | | -## 翻譯 |
74 | 81 |
|
75 | | -[](https://translate.gitea.com) |
| 82 | +## 官方及第三方專案 |
76 | 83 |
|
77 | | -翻譯通過 [Crowdin](https://translate.gitea.com) 進行。如果您想翻譯成新的語言,請在 Crowdin 項目中請求管理員添加新語言。 |
| 84 | +- 官方工具:[go-sdk](https://gitea.com/gitea/go-sdk)、命令列工具[tea](https://gitea.com/gitea/tea)、Gitea Action 專用[執行器](https://gitea.com/gitea/act_runner) |
| 85 | +- 第三方專案清單:[gitea/awesome-gitea](https://gitea.com/gitea/awesome-gitea),含 SDK、外掛程式、主題等資源 |
78 | 86 |
|
79 | | -您也可以創建一個 issue 來添加語言,或者在 discord 的 #translation 頻道上詢問。如果您需要上下文或發現一些翻譯問題,可以在字符串上留言或在 Discord 上詢問。對於一般的翻譯問題,文檔中有一個部分。目前有點空,但我們希望隨著問題的出現而填充它。 |
80 | 87 |
|
81 | | -更多信息請參閱 [文件](https://docs.gitea.com/contributing/localization)。 |
82 | | - |
83 | | -## 官方和第三方項目 |
84 | | - |
85 | | -我們提供了一個官方的 [go-sdk](https://gitea.com/gitea/go-sdk),一個名為 [tea](https://gitea.com/gitea/tea) 的 CLI 工具和一個 Gitea Action 的 [action runner](https://gitea.com/gitea/act_runner)。 |
86 | | - |
87 | | -我們在 [gitea/awesome-gitea](https://gitea.com/gitea/awesome-gitea) 維護了一個 Gitea 相關項目的列表,您可以在那裡發現更多的第三方項目,包括 SDK、插件、主題等。 |
88 | | - |
89 | | -## 通訊 |
| 88 | +## 交流頻道 |
90 | 89 |
|
91 | 90 | [](https://discord.gg/Gitea "Join the Discord chat at https://discord.gg/Gitea") |
92 | 91 |
|
93 | | -如果您有任何文件未涵蓋的問題,可以在我們的 [Discord 服務器](https://discord.gg/Gitea) 上與我們聯繫,或者在 [discourse 論壇](https://forum.gitea.com/) 上創建帖子。 |
94 | 92 |
|
95 | | -## 作者 |
| 93 | +若文件未涵蓋你的問題,可透過[Discord 伺服器](https://discord.gg/Gitea)聯絡我們,或在[論壇](https://forum.gitea.com/)發布貼文。 |
| 94 | + |
96 | 95 |
|
| 96 | +## 專案成員 |
97 | 97 | - [維護者](https://github.com/orgs/go-gitea/people) |
98 | 98 | - [貢獻者](https://github.com/go-gitea/gitea/graphs/contributors) |
99 | | -- [翻譯者](options/locale/TRANSLATORS) |
| 99 | +- [譯者](options/locale/TRANSLATORS) |
100 | 100 |
|
101 | | -## 支持者 |
102 | 101 |
|
103 | | -感謝所有支持者! 🙏 [[成為支持者](https://opencollective.com/gitea#backer)] |
| 102 | +## 支持者 |
| 103 | +感謝所有支持者的鼎力相助!🙏 [[成為支持者](https://opencollective.com/gitea#backer)] |
104 | 104 |
|
105 | 105 | <a href="https://opencollective.com/gitea#backers" target="_blank"><img src="https://opencollective.com/gitea/backers.svg?width=890"></a> |
106 | 106 |
|
107 | 107 | ## 贊助商 |
108 | | - |
109 | | -通過成為贊助商來支持這個項目。您的標誌將顯示在這裡,並帶有鏈接到您的網站。 [[成為贊助商](https://opencollective.com/gitea#sponsor)] |
| 108 | +成為贊助商支持專案,你的 logo 將在此展示並連結至官網。[[成為贊助商](https://opencollective.com/gitea#sponsor)] |
110 | 109 |
|
111 | 110 | <a href="https://opencollective.com/gitea/sponsor/0/website" target="_blank"><img src="https://opencollective.com/gitea/sponsor/0/avatar.svg"></a> |
112 | 111 | <a href="https://opencollective.com/gitea/sponsor/1/website" target="_blank"><img src="https://opencollective.com/gitea/sponsor/1/avatar.svg"></a> |
|
120 | 119 | <a href="https://opencollective.com/gitea/sponsor/9/website" target="_blank"><img src="https://opencollective.com/gitea/sponsor/9/avatar.svg"></a> |
121 | 120 |
|
122 | 121 | ## 常見問題 |
| 122 | +### Q:Gitea 如何發音? |
| 123 | +A:發音為[/ɡɪ'ti:/](https://youtu.be/EM71-2uDAoY),類似「gi-tea」,「g」需發重音。 |
123 | 124 |
|
124 | | -**Gitea 怎麼發音?** |
125 | | - |
126 | | -Gitea 的發音是 [/ɡɪ’ti:/](https://youtu.be/EM71-2uDAoY),就像 "gi-tea" 一樣,g 是硬音。 |
127 | | - |
128 | | -**為什麼這個項目沒有託管在 Gitea 實例上?** |
129 | | - |
130 | | -我們正在 [努力](https://github.com/go-gitea/gitea/issues/1029)。 |
131 | | - |
132 | | -**在哪裡可以找到安全補丁?** |
| 125 | +### Q:為何專案代碼未託管在 Gitea 自身實例上? |
| 126 | +A:我們正推進此事,進展可查看[該 issue](https://github.com/go-gitea/gitea/issues/1029)。 |
133 | 127 |
|
134 | | -在 [發佈日誌](https://github.com/go-gitea/gitea/releases) 或 [變更日誌](https://github.com/go-gitea/gitea/blob/main/CHANGELOG.md) 中,搜索關鍵詞 `SECURITY` 以找到安全補丁。 |
| 128 | +### Q:哪裡可找到安全補丁? |
| 129 | +A:在[發布日誌](https://github.com/go-gitea/gitea/releases)或[更新日誌](https://github.com/go-gitea/gitea/blob/main/CHANGELOG.md)中,搜尋關鍵詞`SECURITY`即可找到。 |
135 | 130 |
|
136 | | -## 許可證 |
137 | 131 |
|
138 | | -這個項目是根據 MIT 許可證授權的。 |
139 | | -請參閱 [LICENSE](https://github.com/go-gitea/gitea/blob/main/LICENSE) 文件以獲取完整的許可證文本。 |
| 132 | +## 授權條款 |
| 133 | +本項目採用 MIT 授權條款,完整授權文本詳見 [LICENSE 檔案](https://github.com/go-gitea/gitea/blob/main/LICENSE)。 |
140 | 134 |
|
141 | | -## 進一步信息 |
142 | 135 |
|
| 136 | +## 更多資訊 |
143 | 137 | <details> |
144 | | -<summary>尋找界面概述?查看這裡!</summary> |
| 138 | +<summary>尋找介面概述?查看這裡!</summary> |
145 | 139 |
|
146 | | -### 登錄/註冊頁面 |
| 140 | +### 登入/註冊頁面 |
147 | 141 |
|
148 | 142 |  |
149 | 143 |  |
150 | 144 |
|
151 | | -### 用戶儀表板 |
| 145 | +### 使用者儀表板 |
152 | 146 |
|
153 | | - |
154 | | - |
155 | | - |
156 | | - |
| 147 | + |
| 148 | + |
| 149 | + |
| 150 | + |
157 | 151 |
|
158 | | -### 用戶資料 |
| 152 | +### 使用者資料 |
159 | 153 |
|
160 | 154 |  |
161 | 155 |
|
162 | 156 | ### 探索 |
163 | 157 |
|
164 | 158 |  |
165 | | - |
166 | | - |
| 159 | + |
| 160 | + |
167 | 161 |
|
168 | | -### 倉庫 |
| 162 | +### 儲存庫 |
169 | 163 |
|
170 | | - |
171 | | - |
172 | | - |
173 | | - |
174 | | - |
175 | | - |
176 | | - |
| 164 | + |
| 165 | + |
| 166 | + |
| 167 | + |
| 168 | + |
| 169 | + |
| 170 | + |
177 | 171 |
|
178 | | -#### 倉庫問題 |
| 172 | +#### 儲存庫議題 |
179 | 173 |
|
180 | | - |
181 | | - |
| 174 | + |
| 175 | + |
182 | 176 |
|
183 | | -#### 倉庫拉取請求 |
| 177 | +#### 儲存庫提取請求 |
184 | 178 |
|
185 | | - |
186 | | - |
| 179 | + |
| 180 | + |
187 | 181 |  |
188 | 182 |  |
189 | 183 |
|
190 | | -#### 倉庫操作 |
| 184 | +#### 儲存庫操作 |
191 | 185 |
|
192 | 186 |  |
193 | | - |
| 187 | + |
194 | 188 |
|
195 | | -#### 倉庫活動 |
| 189 | +#### 儲存庫活動 |
196 | 190 |
|
197 | | - |
198 | | - |
199 | | - |
200 | | - |
| 191 | + |
| 192 | + |
| 193 | + |
| 194 | + |
201 | 195 |
|
202 | 196 | ### 組織 |
203 | 197 |
|
204 | | - |
| 198 | + |
205 | 199 |
|
206 | 200 | </details> |
0 commit comments