aboutsummaryrefslogtreecommitdiffstats
path: root/docs/content/doc/features
diff options
context:
space:
mode:
authorkevinlin18 <7793728+kevinlin18@users.noreply.github.com>2021-01-29 08:57:58 +0800
committerGitHub <noreply@github.com>2021-01-29 01:57:58 +0100
commit0e4a9dbcb90ff80356e51cffb81e2b8717ea035d (patch)
treee9119c9707eb942faf3440dbfd5928d81d6eb248 /docs/content/doc/features
parent2ebe609d65f16b67ee54fe123f226bcd737be79e (diff)
downloadgitea-0e4a9dbcb90ff80356e51cffb81e2b8717ea035d.tar.gz
gitea-0e4a9dbcb90ff80356e51cffb81e2b8717ea035d.zip
[docs] Add zh-tw Translations (#14507)
Diffstat (limited to 'docs/content/doc/features')
-rw-r--r--docs/content/doc/features/comparison.zh-tw.md131
-rw-r--r--docs/content/doc/features/localization.zh-tw.md16
-rw-r--r--docs/content/doc/features/webhooks.zh-tw.md176
3 files changed, 317 insertions, 6 deletions
diff --git a/docs/content/doc/features/comparison.zh-tw.md b/docs/content/doc/features/comparison.zh-tw.md
new file mode 100644
index 0000000000..666e82d3c9
--- /dev/null
+++ b/docs/content/doc/features/comparison.zh-tw.md
@@ -0,0 +1,131 @@
+---
+date: "2018-05-07T13:00:00+02:00"
+title: "比較 Gitea 和其它自託管 Git 服務"
+slug: "comparison"
+weight: 5
+toc: false
+draft: false
+menu:
+ sidebar:
+ parent: "features"
+ name: "比較"
+ weight: 5
+ identifier: "comparison"
+---
+
+# 比較 Gitea 和其它自託管 Git 服務
+
+**目錄**
+
+{{< toc >}}
+
+為了幫助您判斷 Gitea 是否適合您的需求，這裡列出了它和其它自託管 Git 服務的比較。
+
+請注意我們不會經常檢查其它產品的功能異動，所以這份清單可能過期，如果您在下方表格中找到需要更新的資料，請在 [GitHub 的 Issue](https://github.com/go-gitea/gitea/issues) 回報。
+
+表格中使用的符號：
+
+- ✓ - 支援
+
+- ⁄ - 有限度的支援
+
+- ✘ - 不支援
+
+## 一般功能
+
+| 功能 | Gitea | Gogs | GitHub EE | GitLab CE | GitLab EE | BitBucket | RhodeCode CE |
+| ------------------------ | -------------------------------------------------- | ---- | --------- | --------- | --------- | --------- | ------------ |
+| 免費及開放原始碼 | ✓ | ✓ | ✘ | ✓ | ✘ | ✘ | ✓ |
+| 低資源使用 (RAM/CPU) | ✓ | ✓ | ✘ | ✘ | ✘ | ✘ | ✘ |
+| 支援多種資料庫 | ✓ | ✓ | ✘ | ⁄ | ⁄ | ✓ | ✓ |
+| 支援多種作業系統 | ✓ | ✓ | ✘ | ✘ | ✘ | ✘ | ✓ |
+| 簡單的升級程序 | ✓ | ✓ | ✘ | ✓ | ✓ | ✘ | ✓ |
+| 支援 Markdown | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| 支援 Orgmode | ✓ | ✘ | ✓ | ✘ | ✘ | ✘ | ? |
+| 支援 CSV | ✓ | ✘ | ✓ | ✘ | ✘ | ✓ | ? |
+| 支援第三方渲染工具 | ✓ | ✘ | ✘ | ✘ | ✘ | ✓ | ? |
+| Git 驅動的靜態頁面 | [✘](https://github.com/go-gitea/gitea/issues/302) | ✘ | ✓ | ✓ | ✓ | ✘ | ✘ |
+| Git 驅動的整合 wiki | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✘ |
+| 部署 Token | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| 有寫入權限的儲存庫 Token | ✓ | ✘ | ✓ | ✓ | ✓ | ✘ | ✓ |
+| 內建 Container Registry | [✘](https://github.com/go-gitea/gitea/issues/2316) | ✘ | ✘ | ✓ | ✓ | ✘ | ✘ |
+| 對外部 Git 鏡像 | ✓ | ✓ | ✘ | ✘ | ✓ | ✓ | ✓ |
+| FIDO U2F (2FA) | ✓ | ✘ | ✓ | ✓ | ✓ | ✓ | ✘ |
+| 內建 CI/CD | ✘ | ✘ | ✓ | ✓ | ✓ | ✘ | ✘ |
+| 子群組: 群組中的群組 | ✘ | ✘ | ✘ | ✓ | ✓ | ✘ | ✓ |
+
+## 程式碼管理
+
+| 功能 | Gitea | Gogs | GitHub EE | GitLab CE | GitLab EE | BitBucket | RhodeCode CE |
+| ----------------------------------------- | ------------------------------------------------ | ---- | --------- | --------- | --------- | --------- | ------------ |
+| 儲存庫主題描述 | ✓ | ✘ | ✓ | ✓ | ✓ | ✘ | ✘ |
+| 儲存庫程式碼搜尋 | ✓ | ✘ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| 全域程式碼搜尋 | ✓ | ✘ | ✓ | ✘ | ✓ | ✓ | ✓ |
+| Git LFS 2.0 | ✓ | ✘ | ✓ | ✓ | ✓ | ⁄ | ✓ |
+| 群組里程碑 | ✘ | ✘ | ✘ | ✓ | ✓ | ✘ | ✘ |
+| 精細的使用者權限（程式碼, 問題, Wiki 等） | ✓ | ✘ | ✘ | ✓ | ✓ | ✘ | ✘ |
+| 驗證提交者 | ⁄ | ✘ | ? | ✓ | ✓ | ✓ | ✘ |
+| GPG 簽署提交 | ✓ | ✘ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| 拒絕未經簽署的提交 | [✓](https://github.com/go-gitea/gitea/pull/9708) | ✘ | ✓ | ✓ | ✓ | ✘ | ✓ |
+| 儲存庫動態頁 | ✓ | ✘ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| 分支管理 | ✓ | ✘ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| 建立新分支 | ✓ | ✘ | ✓ | ✓ | ✓ | ✘ | ✘ |
+| 網頁程式碼編輯器 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| 提交線圖 | ✓ | ✘ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| 儲存庫範本 | [✓](https://github.com/go-gitea/gitea/pull/8768) | ✘ | ✓ | ✘ | ✓ | ✓ | ✘ |
+
+## 問題追蹤器
+
+| 功能 | Gitea | Gogs | GitHub EE | GitLab CE | GitLab EE | BitBucket | RhodeCode CE |
+| -------------------- | -------------------------------------------------- | --------------------------------------------- | --------- | ----------------------------------------------------------------------- | --------- | --------- | ------------ |
+| 問題追蹤器 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✘ |
+| 問題範本 | ✓ | ✓ | ✓ | ✓ | ✓ | ✘ | ✘ |
+| 標籤 | ✓ | ✓ | ✓ | ✓ | ✓ | ✘ | ✘ |
+| 時間追蹤 | ✓ | ✘ | ✓ | ✓ | ✓ | ✘ | ✘ |
+| 指派問題給多個成員 | ✓ | ✘ | ✓ | ✘ | ✓ | ✘ | ✘ |
+| 相關問題 | ✘ | ✘ | ⁄ | [✓](https://docs.gitlab.com/ce/user/project/issues/related_issues.html) | ✓ | ✘ | ✘ |
+| 機密問題 | [✘](https://github.com/go-gitea/gitea/issues/3217) | ✘ | ✘ | ✓ | ✓ | ✘ | ✘ |
+| 對留言的反應 | ✓ | ✘ | ✓ | ✓ | ✓ | ✘ | ✘ |
+| 鎖定對話 | ✓ | ✘ | ✓ | ✓ | ✓ | ✘ | ✘ |
+| 批次處理問題 | ✓ | ✘ | ✓ | ✓ | ✓ | ✘ | ✘ |
+| 問題看板（看板方法） | [✓](https://github.com/go-gitea/gitea/pull/8346) | ✘ | ✘ | ✓ | ✓ | ✘ | ✘ |
+| 從問題建立新分支 | ✘ | ✘ | ✘ | ✓ | ✓ | ✘ | ✘ |
+| 問題搜尋 | ✓ | ✘ | ✓ | ✓ | ✓ | ✓ | ✘ |
+| 全域問題搜尋 | [✘](https://github.com/go-gitea/gitea/issues/2434) | ✘ | ✓ | ✓ | ✓ | ✓ | ✘ |
+| 問題相依 | ✓ | ✘ | ✘ | ✘ | ✘ | ✘ | ✘ |
+| 從電子郵件建立問題 | [✘](https://github.com/go-gitea/gitea/issues/6226) | [✘](https://github.com/gogs/gogs/issues/2602) | ✘ | ✘ | ✓ | ✓ | ✘ |
+| 服務台 | [✘](https://github.com/go-gitea/gitea/issues/6219) | ✘ | ✘ | [✓](https://gitlab.com/groups/gitlab-org/-/epics/3103) | ✓ | ✘ | ✘ |
+
+## 拉取/合併請求
+
+| 功能 | Gitea | Gogs | GitHub EE | GitLab CE | GitLab EE | BitBucket | RhodeCode CE |
+| -------------------------- | -------------------------------------------------- | ---- | --------- | --------------------------------------------------------------------------------- | --------- | ------------------------------------------------------------------------ | ------------ |
+| 拉取/合併請求 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| Squash 合併 | ✓ | ✘ | ✓ | [✓](https://docs.gitlab.com/ce/user/project/merge_requests/squash_and_merge.html) | ✓ | ✓ | ✓ |
+| Rebase 合併 | ✓ | ✓ | ✓ | ✘ | ⁄ | ✘ | ✓ |
+| 拉取/合併請求的行內留言 | ✓ | ✘ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| 拉取/合併請求的核可 | ✓ | ✘ | ⁄ | ✓ | ✓ | ✓ | ✓ |
+| 解決合併衝突 | [✘](https://github.com/go-gitea/gitea/issues/5158) | ✘ | ✓ | ✓ | ✓ | ✓ | ✘ |
+| 限制某些使用者的推送及合併 | ✓ | ✘ | ✓ | ⁄ | ✓ | ✓ | ✓ |
+| 還原指定的提交或合併請求 | [✘](https://github.com/go-gitea/gitea/issues/5158) | ✘ | ✓ | ✓ | ✓ | ✓ | ✘ |
+| 拉取/合併請求範本 | ✓ | ✓ | ✓ | ✓ | ✓ | ✘ | ✘ |
+| Cherry-picking 變更 | [✘](https://github.com/go-gitea/gitea/issues/5158) | ✘ | ✘ | ✓ | ✓ | ✘ | ✘ |
+| 下載 Patch | ✓ | ✘ | ✓ | ✓ | ✓ | [/](https://jira.atlassian.com/plugins/servlet/mobile#issue/BCLOUD-8323) | ✘ |
+
+## 第三方整合
+
+| 功能 | Gitea | Gogs | GitHub EE | GitLab CE | GitLab EE | BitBucket | RhodeCode CE |
+| ------------------------- | ------------------------------------------------ | ---- | --------- | --------- | --------- | --------- | ------------ |
+| 支援 Webhook | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| 自訂 Git Hook | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| 整合 AD / LDAP | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| 支援多重 LDAP / AD 伺服器 | ✓ | ✓ | ✘ | ✘ | ✓ | ✓ | ✓ |
+| 同步 LDAP 使用者 | ✓ | ✘ | ✓ | ✓ | ✓ | ✓ | ✓ |
+| 支援 OpenId Connect | ✓ | ✘ | ✓ | ✓ | ✓ | ? | ✘ |
+| 整合 OAuth 2.0 (外部驗證) | ✓ | ✘ | ⁄ | ✓ | ✓ | ? | ✓ |
+| 成為 OAuth 2.0 提供者 | [✓](https://github.com/go-gitea/gitea/pull/5378) | ✘ | ✓ | ✓ | ✓ | ✓ | ✘ |
+| 兩步驟驗證 (2FA) | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✘ |
+| 整合 Mattermost/Slack | ✓ | ✓ | ⁄ | ✓ | ✓ | ⁄ | ✓ |
+| 整合 Discord | ✓ | ✓ | ✓ | ✓ | ✓ | ✘ | ✘ |
+| 整合 Microsoft Teams | ✓ | ✘ | ✓ | ✓ | ✓ | ✓ | ✘ |
+| 顯示外部 CI/CD 狀態 | ✓ | ✘ | ✓ | ✓ | ✓ | ✓ | ✓ |
diff --git a/docs/content/doc/features/localization.zh-tw.md b/docs/content/doc/features/localization.zh-tw.md
index b311cc543c..e100063606 100644
--- a/docs/content/doc/features/localization.zh-tw.md
+++ b/docs/content/doc/features/localization.zh-tw.md
@@ -13,6 +13,18 @@ menu:
identifier: "localization"
---
-# Localization
+# 在地化
-## TBD
+我們在 [Crowdin 專案](https://crowdin.com/project/gitea)上進行在地化工作。
+
+**英語系**的翻譯，可在修改[英文語言檔](https://github.com/go-gitea/gitea/blob/master/options/locale/locale_en-US.ini)後提出合併請求。
+
+**非英語系**的翻譯，請前往上述的 Crowdin 專案。
+
+## 已支援的語言
+
+上述 Crowdin 專案中列出的語言在翻譯超過 25% 後將被支援。
+
+翻譯被認可後將在下次 Crowdin 同步後進入到主儲存庫，通常是在任何合併請求被合併之後。
+這表示更改的翻譯要到下次 Gitea 發佈後才會出現。
+如果您使用的是最新建置，它將會在同步完成、您更新後出現。
diff --git a/docs/content/doc/features/webhooks.zh-tw.md b/docs/content/doc/features/webhooks.zh-tw.md
index fe9008717a..0d1c564f6d 100644
--- a/docs/content/doc/features/webhooks.zh-tw.md
+++ b/docs/content/doc/features/webhooks.zh-tw.md
@@ -1,6 +1,6 @@
---
date: "2016-12-01T16:00:00+02:00"
-title: "Webhooks"
+title: "Webhook"
slug: "webhooks"
weight: 10
toc: false
@@ -8,11 +8,179 @@ draft: false
menu:
sidebar:
parent: "features"
- name: "Webhooks"
+ name: "Webhook"
weight: 30
identifier: "webhooks"
---
-# Webhooks
+# Webhook
-## TBD
+Gitea 的儲存庫事件支援 web hook。這可以有儲存庫管理員在設定頁 `/:username/:reponame/settings/hooks` 中調整。Webhook 也可以按照組織調整或按照全系統調整。
+所有的事件推送都是 POST 請求。此方法目前被下列服務支援：
+
+- Gitea (也可以是 GET 請求)
+- Gogs
+- Slack
+- Discord
+- Dingtalk
+- Telegram
+- Microsoft Teams
+- Feishu
+
+### 事件資訊
+
+**警告**： Payload 中的 `secret` 欄位已經在 Gitea 1.13.0 棄用，並且將在 1.14.0 移除： https://github.com/go-gitea/gitea/issues/11755
+
+下面是一個將由 Gitea 發送到 Payload URL 的事件資訊的範例：
+
+```
+X-GitHub-Delivery: f6266f16-1bf3-46a5-9ea4-602e06ead473
+X-GitHub-Event: push
+X-Gogs-Delivery: f6266f16-1bf3-46a5-9ea4-602e06ead473
+X-Gogs-Event: push
+X-Gitea-Delivery: f6266f16-1bf3-46a5-9ea4-602e06ead473
+X-Gitea-Event: push
+```
+
+```json
+{
+ "secret": "3gEsCfjlV2ugRwgpU#w1*WaW*wa4NXgGmpCfkbG3",
+ "ref": "refs/heads/develop",
+ "before": "28e1879d029cb852e4844d9c718537df08844e03",
+ "after": "bffeb74224043ba2feb48d137756c8a9331c449a",
+ "compare_url": "http://localhost:3000/gitea/webhooks/compare/28e1879d029cb852e4844d9c718537df08844e03...bffeb74224043ba2feb48d137756c8a9331c449a",
+ "commits": [
+ {
+ "id": "bffeb74224043ba2feb48d137756c8a9331c449a",
+ "message": "Webhooks Yay!",
+ "url": "http://localhost:3000/gitea/webhooks/commit/bffeb74224043ba2feb48d137756c8a9331c449a",
+ "author": {
+ "name": "Gitea",
+ "email": "someone@gitea.io",
+ "username": "gitea"
+ },
+ "committer": {
+ "name": "Gitea",
+ "email": "someone@gitea.io",
+ "username": "gitea"
+ },
+ "timestamp": "2017-03-13T13:52:11-04:00"
+ }
+ ],
+ "repository": {
+ "id": 140,
+ "owner": {
+ "id": 1,
+ "login": "gitea",
+ "full_name": "Gitea",
+ "email": "someone@gitea.io",
+ "avatar_url": "https://localhost:3000/avatars/1",
+ "username": "gitea"
+ },
+ "name": "webhooks",
+ "full_name": "gitea/webhooks",
+ "description": "",
+ "private": false,
+ "fork": false,
+ "html_url": "http://localhost:3000/gitea/webhooks",
+ "ssh_url": "ssh://gitea@localhost:2222/gitea/webhooks.git",
+ "clone_url": "http://localhost:3000/gitea/webhooks.git",
+ "website": "",
+ "stars_count": 0,
+ "forks_count": 1,
+ "watchers_count": 1,
+ "open_issues_count": 7,
+ "default_branch": "master",
+ "created_at": "2017-02-26T04:29:06-05:00",
+ "updated_at": "2017-03-13T13:51:58-04:00"
+ },
+ "pusher": {
+ "id": 1,
+ "login": "gitea",
+ "full_name": "Gitea",
+ "email": "someone@gitea.io",
+ "avatar_url": "https://localhost:3000/avatars/1",
+ "username": "gitea"
+ },
+ "sender": {
+ "id": 1,
+ "login": "gitea",
+ "full_name": "Gitea",
+ "email": "someone@gitea.io",
+ "avatar_url": "https://localhost:3000/avatars/1",
+ "username": "gitea"
+ }
+}
+```
+
+### 範例
+
+此範例示範在發生推送事件時，如何使用 webhook 觸發 php 程式。
+使用下列參數在您的儲存庫設定 Webhook 中建立一個 Gitea webhook：
+
+- 目標 URL： http://mydomain.com/webhook.php
+- HTTP 請求方法：POST
+- POST Content Type：application/json
+- Secret：123
+- 觸發條件：推送事件
+- 啟用：勾選
+
+現在請到您的伺服器上建立 webhook.php 檔案
+
+```
+<?php
+
+$secret_key = '123';
+
+// check for POST request
+if ($_SERVER['REQUEST_METHOD'] != 'POST') {
+ error_log('FAILED - not POST - '. $_SERVER['REQUEST_METHOD']);
+ exit();
+}
+
+// get content type
+$content_type = isset($_SERVER['CONTENT_TYPE']) ? strtolower(trim($_SERVER['CONTENT_TYPE'])) : '';
+
+if ($content_type != 'application/json') {
+ error_log('FAILED - not application/json - '. $content_type);
+ exit();
+}
+
+// get payload
+$payload = trim(file_get_contents("php://input"));
+
+if (empty($payload)) {
+ error_log('FAILED - no payload');
+ exit();
+}
+
+// get header signature
+$header_signature = isset($_SERVER['HTTP_X_GITEA_SIGNATURE']) ? $_SERVER['HTTP_X_GITEA_SIGNATURE'] : '';
+
+if (empty($header_signature)) {
+ error_log('FAILED - header signature missing');
+ exit();
+}
+
+// calculate payload signature
+$payload_signature = hash_hmac('sha256', $payload, $secret_key, false);
+
+// check payload signature against header signature
+if ($header_signature !== $payload_signature) {
+ error_log('FAILED - payload signature');
+ exit();
+}
+
+// convert json to array
+$decoded = json_decode($payload, true);
+
+// check for json decode errors
+if (json_last_error() !== JSON_ERROR_NONE) {
+ error_log('FAILED - json decode - '. json_last_error());
+ exit();
+}
+
+// success, do something
+```
+
+Webhook 設定中有一個傳送測試資料按鈕，它可讓你測試您的設定並將結果顯示於最近傳送記錄。
generated by cgit v1.2.3 (git 2.39.1) at 2025-01-25 03:35:13 +0000