hasura · jackchan · Jun 7, 2025
diff --git a/translations/CONTRIBUTING.chinese_tc.md b/translations/CONTRIBUTING.chinese_tc.md
@@ -0,0 +1,175 @@
+# 為 Hasura GraphQL 引擎做出貢獻
+
+第一：如果您對如何開始為V2或V3做出貢獻感到沒有把握，請隨時向我們諮詢
+[Discord](https://discordapp.com/invite/hasura)在「#contrib」頻道。你也可以繼續你的
+貢獻，我們會給你回饋。別擔心，最糟糕的情況是，你會被禮貌地要求
+改變一些東西。我們感謝任何貢獻，我們不希望規則之牆阻礙這一點。
+
+然而，對於那些想要更多關於如何為專案做出貢獻的指導的人，請繼續閱讀
+這份文件將涵蓋我們正在尋找的內容。透過解決以下問題，我們可以快速合併或
+你的貢獻將會增加。
+
+## 目錄
+
+[1. 行為準則 ](#code-of-conduct)
+
+[2. git倉庫概述 ](#overview)
+
+[3. 歡迎首次貢獻者！ ](#first-timers)
+
+[4. 貢獻領域 ](#areas)
+
+[5. 貢獻方式 ](#ways)
+
+[6. git提交資訊 ](#commit-messages)
+
+[7. 翻譯 ](#translations)
+
+<a name="code-of-conduct"></a>
+
+## 1. 行為準則
+
+請關注我們的 [行為準則](code-of-conduct.chinese.md) 在對Hasura的任何貢獻的背景下。
+
+<a name="overview"></a>
+
+## 2. git倉庫概述
+
+[hasura/graphql-engine](https://github.com/hasura/graphql-engine) 是V2和V3的開源單倉庫Hasura版本。
+
+### V2
+
+這個V2部分由3個部分組成，每個部分都有自己的貢獻指南：
+
+1. [Server (Haskell)](server/CONTRIBUTING.md)
+
+2. [CLI (Go)](cli/CONTRIBUTING.md)
+
+3. [Console (JavaScript)](frontend/docs/generic-info.md#contributing-to-hasura-console)
+
+這三個元件都有一個版本，由git標籤或分支名稱和git的組合表示 提交SHA。
+
+對於所有貢獻，都需要簽署貢獻者許可協議 CLA（Contributor License Agreement）
+[這裡](https://cla-assistant.io/hasura/graphql-engine)在提交拉取請求之前（或之後）。如有必要機器人將
+透過PR註釋提示貢獻者簽署CLA。
+
+### V3
+
+V3部分完全是V3引擎，是Hasura的核心，用Rust編寫。
+
+1. [V3 引擎 (Rust)](v3/CONTRIBUTING.md)
+
+查看 [V3 README 在這](/v3/README.md).
+
+<a name="first-timers"></a>
+
+## 3. 歡迎首次貢獻者！
+
+我們感謝首次貢獻者，我們很樂意幫助您開始。如有疑問，請聯絡我們！
+
+您發現所有問題都適合首次貢獻者[這裡](https://github.com/hasura/graphql-engine/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22).
+
+<a name="areas"></a>
+
+## 4. 貢獻領域
+
+當然，我們感謝對Hasura所有組成部分的貢獻。然而，我們已經確定了三個領域 特別適合開源貢獻。
+
+### V2 文檔
+
+我們的目標是保持文件的全面性和更新性。如果您願意幫助我們這樣做，我們將感謝任何形式的貢獻：
+
+- 報告缺失內容
+
+- 修復現有文件中的錯誤
+
+- 幫助我們新增文檔
+
+文件的貢獻指南可以在以下網址找到 [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md).
+
+### V2 社群內容
+
+自從我們推出[學習頁面](https://hasura.io/learn/)，我們對貢獻感到高興：
+
+- 修復現有學習教程中的錯誤
+
+-新增教學（如果您有避免重複單字的想法，請聯絡我們）
+
+學習庫的README可以在[點擊此處](https://github.com/hasura/learn-graphql).
+
+除了學習內容，我們還確定了三種其他方式來貢獻技術社群內容：
+
+- [範本程式碼](https://github.com/hasura/graphql-engine/tree/master/community/boilerplates)
+
+- [範例應用程式](https://github.com/hasura/sample-apps/tree/main)
+
+- [工具](community/tools)
+
+如果你想透過以下方式為社群做出貢獻
+
+- 寫一篇技術博客
+
+- 在活動中發言
+
+- 組織工作坊
+
+查看我們的 [社群維基](https://github.com/hasura/graphql-engine/wiki/Community-Wiki).
+
+如果你有什麼要添加的，即使它與上述任何內容都無關，也可以隨時提交拉取請求。
+
+### V2 CLI
+
+我們在CLI上遇到了一些適合開源貢獻的問題。如果你知道如何使用Go或你想透過學習使用，請查看以下內容
+[問題](https://github.com/hasura/graphql-engine/issues?q=is%3Aopen+is%3Aissue+label%3Ac%2Fcli+label%3A%22help+wanted%22).
+
+CLI 倉庫的 README 可以在[這裡](https://github.com/hasura/graphql-engine/tree/master/cli)找到。
+
+<a name="ways"></a>
+
+## 5. 貢獻方式
+
+### 回報問題
+
+- 確保您針對最新發布版本進行測試。我們可能已經修復了您遇到的 bug。
+
+- 提供重現問題的步驟，包括 Postgres 版本、graphql-engine 版本以及您正在運行的提供者（如 Heroku、Docker 等）。
+
+- 如果相關，請包含伺服器的日誌。
+
+- 建立一個 [問題](https://github.com/hasura/graphql-engine/issues/new/choose).
+
+### 處理一個問題 (issue)
+
+- 我們使用[叉庫與分支的 Git 工作流程](https://blog.scottlowe.org/2015/01/27/using-fork-branch-git-workflow/).
+
+- 請確保您正在進行的工作有相關問題。
+
+- 如果您正在處理某個問題，請評論您這樣做是為了防止其他人重複工作。
+
+- 壓縮您的提交，並在提交訊息末尾使用 `fix #<issue-no>` 或 `close #<issue-no>` 引用問題。 
+例如：`resolve answers to everything (fix #42)` 或`resolve answers to everything, fix #42`
+
+- 在提交拉取請求之前，將主分支與您的分支進行變基。
+
+<a name="commit-messages"></a>
+
+## 6. git提交訊息
+
+- 第一行應為更改的摘要，且不超過 50 個字符，後面可以跟著一個可選的正文，詳細說明更改內容。有關編寫良好提交信息的更多信息，請參考
+ [此連結](https://github.com/erlang/otp/wiki/writing-good-commit-messages)
+
+- 使用命令式現在式(imperative present tense): "add/fix/change", not "added/fixed/changed" nor "adds/fixes/changes".
+
+- 不要將摘要行的第一個字母大寫。
+
+- 不要在摘要行的末尾加上句號/點（.）。
+
+<a name="translations"></a>
+
+## 7. 翻譯
+
+本文檔有以下翻譯版本：
+
+- [French 🇫🇷](translations/CONTRIBUTING.french.md)
+
+(致謝：部分章節改編自 https://github.com/PostgREST/postgrest/blob/master/.github/CONTRIBUTING.md)
diff --git a/translations/README.chinese_tc.md b/translations/README.chinese_tc.md
@@ -0,0 +1,207 @@
+# Hasura GraphQL引擎
+
+[![文檔](https://img.shields.io/badge/docs-v1.0-brightgreen.svg?style=flat)](https://hasura.io/docs)
+[![CircleCI](https://circleci.com/gh/hasura/graphql-engine.svg?style=shield)](https://circleci.com/gh/hasura/graphql-engine)
+
+<a href="https://discord.gg/vBPpJkS"><img src="https://img.shields.io/badge/chat-discord-brightgreen.svg?logo=discord&style=flat"></a>
+<a href="https://twitter.com/intent/follow?screen_name=HasuraHQ"><img src="https://img.shields.io/badge/Follow-HasuraHQ-blue.svg?style=flat&logo=twitter"></a>
+<a href="https://eepurl.com/dBUfJ5"><img src="https://img.shields.io/badge/newsletter-subscribe-yellow.svg?style=flat"></a>
+
+Hasura GraphQL 應用程式 **Postgres 應用程式 API**，回應資料庫事件的 [**Webhook觸發器**](../event-triggers.md)。
+
+Hasura 已建立 GraphQL 的 Postgres 版本、新版本的 Postgres 和新版本的 GraphQL。
+
+請參閱 [hasura.io](https://hasura.io) 和 [文件](https://hasura.io/docs) 以了解更多內容。
+
+------------------
+
+![Hasura GraphQL 引擎示範](../assets/demo.gif)
+
+------------------
+
+![Hasura GraphQL 引擎即時性示範](../assets/realtime.gif)
+
+-------------------
+
+## 特性
+
+* **強大的查詢功能**：內建過濾，分頁，模式搜索，批量插入，更新，刪除
+* **即時**：透過訂閱將任何 GraphQL 查詢轉換為即時查詢
+* **繪製圖表**：透過單一GraphQL端點存取其他負責業務邏輯的GraphQL端點 ([了解更多](../remote-schemas.md))
+* **Webhooks與Serverless函數**: 在發生Postgres插入/更新/刪除事件時觸發函數 ([了解更多](../event-triggers.md))
+* **使用現有的資料庫**：關於 PostgresGraphQL API
+* **細粒度的存取控制**：與您的認證系統整合的動態存取控制（例如auth0，firebase-auth）
+* **效能與低記憶體佔用**：約15MB的docker映像；〜50MB RAM @ 1000請求/秒； 多核心友好
+* **管理介面和模式遷移**: 管理介面和受Rails 模式的遷移
+* **Postgres** ❤️: 支援Postgres資料類型（PostGIS / geo-location 等），將表格視圖轉換為*圖*，透過GraphQL變更觸發儲存函數或流程
+
+請造訪 [hasura.io](https://hasura.io) 和 [文件](https://hasura.io/docs) 以了解更多
+
+## 目錄
+<!-- markdown-toc start - Don't edit this section. Run M-x markdown-toc-refresh-toc -->
+**目錄**
+
+- [快速開始](#快速開始)
+- [一鍵部署到Heroku](#一鍵部署到Heroku)
+- [其他配置方法](#其他配置方法)
+- [架構](#架構)
+- [客戶端工具](#客戶端工具)
+- [新增業務邏輯](#新增業務邏輯)
+- [端點Schema](#端點Schema)
+- [透過資料庫事件觸發Webhooks](#透過資料庫事件觸發Webhooks)
+- [演示](#演示)
+- [即時應用](#即時應用)
+- [影片](#影片)
+- [支援與故障排除](#支援與故障排除)
+- [貢獻](#貢獻)
+- [品牌資料](#品牌資料)
+- [許可證](#許可證)
+- [翻譯](#翻譯)
+
+<!-- markdown-toc end -->
+
+##
+
+### 一鍵到部署Heroku
+
+部署到 Heroku 正在嘗試 Hasura 最快的方法
+
+1.點擊以下按鈕，在有免費Postgres附加元件的Heroku上設定GraphQL引擎：
+
+[![部署到Heroku](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/hasura/graphql-engine-heroku)
+
+2.打開Hasura控制台
+
+造訪 `https://<app-name>.herokuapp.com` (*更換 \<應用程式名稱\> 使用您的應用程式名稱*) 開啟管理控制台。
+
+3.進行第一個GraphQL查詢
+
+###
+
+以下一鍵式配置選項的說明：
+
+| **基礎設施建設** | **一鍵式連結** | **附加資訊** |
+|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| DigitalOcean | [![部署到 DigitalOcean](https://graphql-engine-cdn.hasura.io/img/create_hasura_droplet_200px.png)](https://marketplace.digitalocean.com/apps/hasuraactionaction=deploy&refcode=c4d9092m"pignc [文件](https://hasura.io/docs/latest/graphql/core/guides/deployment/digital-ocean-one-click.html#hasura-graphql-engine-digitalocean-one-click-app) |
+| Azure | [![部署到Azure](http://azuredeploy.net/deploybutton.png)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3a%2f%2f raw.githubusercontent.com%2fhasura%2fgraphql-engine%2fmaster%2finstall-manifests%2fazure-container-with-pg%2fazuredeploy.json) | [文檔](https://hasura.io/docs/latest/graphql/core/guides/deployment/azure-container-instances-postgres.html) |
+
+### 其它部署方法
+
+關於基於 Docker 的部署和其它高級配置選項，請參閱 [部署指南](https://hasura.io/docs/latest/graphql/core/getting-started/index.html) 或者  
+[安裝清單](../install-manifests)。
+
+## 架構
+
+Hasura GraphQL 引擎位於 Postgres 資料庫實例的前端，並且可以接受來自客戶端應用程式的 GraphQL 調用。您可以將其設定為與現有的身份驗證系統一同使用，並可根據驗證系統中的動態變數來實現欄位級別的存取控制。
+
+您還可以合併遠端的 GraphQL Schema，以提供統一的 GraphQL API。
+
+![Hasura GraphQL 引擎架構](../assets/hasura-arch.svg)
+
+## 客戶端工具
+
+Hasura 可與任何 GraphQL 客戶端一起使用。我們建議使用 [Apollo Client](https://github.com/apollographql/apollo-client)。  
+請參見 [awesome-graphql](https://github.com/chentsulin/awesome-graphql) 瞭解其他客戶端工具。
+
+## 添加商業邏輯
+
+GraphQL Engine 提供了易用、可擴展、高效能的方式將自定義業務邏輯插入後端。
+
+### 遠端 Schema
+
+您可以在遠端 Schema 中編寫自定義的 resolver，然後與 Hasura 基於 Postgres 的 GraphQL Schema 合併。適用於實現支付 API 或查詢資料庫中不存在的資料等場景 - [閱讀更多](../remote-schemas.md)。
+
+### 透過資料庫事件觸發 Webhooks
+
+新增基於資料庫事件觸發的非同步業務邏輯。  
+非常適合通知、來源於 Postgres 的資料處理流程或非同步任務處理  
+[閱讀更多](../event-triggers.md)。
+
+### 衍生資料或資料處理
+
+在 Postgres 中處理資料或套用業務邏輯來匯出另一套可由 GraphQL Engine 處理的資料集 - [閱讀更多](https://hasura.io/docs/latest/graphql/core/queries/derived-data.html)。
+
+## 示範
+
+請造訪 [hasura/sample-apps](https://github.com/hasura/sample-apps/tree/main) 目錄以查看所有示範專案
+
+### 即時應用
+
+- 使用 React 建構的群聊應用，包含輸入中指示器、線上用戶與新訊息通知
+  - [試用連結](https://realtime-chat.demo.hasura.io/)
+  - [教學說明](https://github.com/hasura/sample-apps/tree/main/realtime-chat)
+  - [瀏覽 API](https://realtime-chat.demo.hasura.io/console)
+
+- 即時位置追蹤應用，展示行駛中車輛持續變更的 GPS 座標並於地圖上移動
+  - [試用連結](https://realtime-location-tracking.demo.hasura.io/)
+  - [教學說明](https://github.com/hasura/sample-apps/tree/main/realtime-location-tracking)
+  - [瀏覽 API](https://realtime-location-tracking.demo.hasura.io/console)
+
+- 即時儀表板，用於聚合不斷變化的資料
+  - [試用連結](https://realtime-poll.demo.hasura.io/)
+  - [教學說明](https://github.com/hasura/sample-apps/tree/main/realtime-poll)
+  - [瀏覽 API](https://realtime-poll.demo.hasura.io/console)
+
+### 影片
+
+* [為自託管 GitLab 實例新增 GraphQL](https://www.youtube.com/watch?v=a2AhxKqd82Q) (*3:44 分鐘*)
+* [基於 Auth0 與 GraphQL 後端的 Todo 應用](https://www.youtube.com/watch?v=15ITBYnccgc) (*4:00 分鐘*)
+* [整合 GitLab 身份驗證的 GraphQL 實作](https://www.youtube.com/watch?v=m1ChRhRLq7o) (*4:05 分鐘*)
+* [千萬次騎行位置資料的儀表板（PostGIS、Timescale）](https://www.youtube.com/watch?v=tsY573yyGWA) (*3:06 分鐘*)
+
+
+## 支援與故障排除
+
+文件與社群將幫助您解決大多數問題。如果您遇到錯誤或需要聯繫我們，可以透過以下任一方式與我們聯繫：
+* 支援與回饋：[Discord](https://discord.gg/vBPpJkS)
+* 問題與錯誤追蹤：[GitHub issues](https://github.com/hasura/graphql-engine/issues)
+* 關注產品更新：[HasuraHQ Twitter](https://twitter.com/hasurahq)
+* 與我們對話：[網站即時聊天](https://hasura.io)
+
+我們致力於在社群中營造開放且友善的環境。請參閱 [行為準則](../code-of-conduct.md)。
+
+若您要回報安全性問題，請參考 [此文件](../SECURITY.md)。
+
+## 貢獻
+
+請參考我們的 [貢獻指南](../CONTRIBUTING.md) 以了解更多細節。
+
+## 品牌素材
+
+您可以在 [assets/brand](../assets/brand) 資料夾中找到 Hasura 的品牌素材（如 Logo、吉祥物、Powered-by 徽章等）。歡迎在您的應用程式/網站等地方使用它們！若能在您的 Hasura 應用中看到 "Powered by Hasura" 徽章，我們將感到非常開心。❤️
+
+<div style="display: flex;">
+  <img src="../assets/brand/hasura_logo_primary_darkbg.svg" width="150px"/>
+  <img src="../assets/brand/hasura_logo_primary_lightbg.svg" width="150px"/>
+</div>
+
+```html
+<!-- For light backgrounds -->
+<a href="https://hasura.io">
+  <img width="150px" src="https://res.cloudinary.com/dh8fp23nd/image/upload/v1711457032/main-web/hasura_logo_primary_lightbg_n0xhz8.svg" />
+</a>
+
+<!-- For dark backgrounds -->
+<a href="https://hasura.io">
+  <img width="150px" src="https://res.cloudinary.com/dh8fp23nd/image/upload/v1711457033/main-web/hasura_logo_primary_darkbg_nussjm.svg" />
+</a>
+```
+
+## 許可證
+
+核心 GraphQL 引擎使用 [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0) (Apache-2.0)。
+
+所有**其他內容**([`server`](../server), [`cli`](../cli) 和
+[`console`](../console) 目錄) 使用 [MIT 許可證](../LICENSE-community).
+其中包括 [`docs`](../docs) 和 [`community`](../community) 目錄。
+
+## 翻譯
+
+自述文件
+
+- [日文:jp:](../translations/README.japanese.md) (:pray: [@moksahero](https://github.com/moksahero))
+- [法文:fr:](../translations/README.french.md) (:pray: [@l0ck3](https://github.com/l0ck3))
+- [中文:cn:](../translations/README.chinese.md) (:pray: [@jagreetdg](https://github.com/jagreetdg) & [@johnbanq](https://github.com/johnbanq))
+
+
+可以在[這裡](../translations)找到其他文件的翻譯
diff --git a/translations/README.md b/translations/README.md
@@ -2,9 +2,9 @@
 
 | File            | Language      |
 |-----------------|---------------|
-| Readme          | [:uk: English](../README.md) ￨ [:fr: Français](README.french.md) ￨ [:jp: 日本語](README.japanese.md) ￨ [🇬🇷 Ελληνικά](README.greek.md) ￨ [🇲🇽 Spanish](README.mx_spanish.md) ￨ [:brazil: Português](README.portuguese_br.md) ￨ [🇩🇪 Deutsch](README.german.md) ￨ [:ru: Русский](README.russian.md) ￨ [:indonesia: Indonesian](README.indonesian.md) ￨ [:bosnia_herzegovina: Bosnian](README.bosnian.md) ￨ [:cn: 中文](README.chinese.md) ￨ [:tr: Türkçe](README.turkish.md) ￨ [:kr: 한국어](README.korean.md)
-| Event Triggers  | [:uk: English](../event-triggers.md)  ￨ [:fr: Français](event-triggers.french.md) ￨ [:cn: 中文](event-triggers.chinese.md) 
-| Remote Schemas  | [:uk: English](../remote-schemas.md)  ￨ [:fr: Français](remote-schemas.french.md) ￨ [:india: Hindi](remote-schemas.hindi.md)  ￨ [:india: Kannada](remote-schemas.kannada.md)                   
-| Contributing    | [:uk: English](../CONTRIBUTING.md)    ￨ [:fr: Français](CONTRIBUTING.french.md) ￨ [:cn: 中文](CONTRIBUTING.chinese.md) 
-| Security        | [:uk: English](../SECURITY.md)        ￨ [:fr: Français](SECURITY.french.md)  ￨ [:india: Hindi](SECURITY.hindi.md)￨ [:india: Kannada](SECURITY.kannada.md)
-| Code of Conduct | [:uk: English](../code-of-conduct.md) ￨ [:fr: Français](code-of-conduct.french.md)￨ [:cn: 中文](code-of-conduct.chinese.md) 
+| Readme          | [:uk: English](../README.md) ￨ [:fr: Français](README.french.md) ￨ [:jp: 日本語](README.japanese.md) ￨ [🇬🇷 Ελληνικά](README.greek.md) ￨ [🇲🇽 Spanish](README.mx_spanish.md) ￨ [:brazil: Português](README.portuguese_br.md) ￨ [🇩🇪 Deutsch](README.german.md) ￨ [:ru: Русский](README.russian.md) ￨ [:indonesia: Indonesian](README.indonesian.md) ￨ [:bosnia_herzegovina: Bosnian](README.bosnian.md) ￨ [:cn: 中文](README.chinese.md) ￨ [:tr: Türkçe](README.turkish.md) ￨ [:kr: 한국어](README.korean.md)  ￨ [:hong_kong: 繁體中文](README.chinese_tc.md) 
+| Event Triggers  | [:uk: English](../event-triggers.md)  ￨ [:fr: Français](event-triggers.french.md) ￨ [:cn: 中文](event-triggers.chinese.md) ￨ [:hong_kong: 繁體中文](event-triggers.chinese_tc.md) 
+| Remote Schemas  | [:uk: English](../remote-schemas.md)  ￨ [:fr: Français](remote-schemas.french.md) ￨ [:india: Hindi](remote-schemas.hindi.md)  ￨ [:india: Kannada](remote-schemas.kannada.md)  ￨ [:hong_kong: 繁體中文](remote-schemas.chinese_tc.md)   
+| Contributing    | [:uk: English](../CONTRIBUTING.md)    ￨ [:fr: Français](CONTRIBUTING.french.md) ￨ [:cn: 中文](CONTRIBUTING.chinese.md) | [:cn: 繁體中文](CONTRIBUTING.chinese_tc.md) 
+| Security        | [:uk: English](../SECURITY.md)        ￨ [:fr: Français](SECURITY.french.md)  ￨ [:india: Hindi](SECURITY.hindi.md)￨ [:india: Kannada](SECURITY.kannada.md) | [:hong_kong: 繁體中文](SECURITY.chinese_tc.md)
+| Code of Conduct | [:uk: English](../code-of-conduct.md) ￨ [:fr: Français](code-of-conduct.french.md)￨ [:cn: 中文](code-of-conduct.chinese.md) | [:hong_kong: 繁體中文](code-of-conduct.chinese_tc.md)