diff --git a/contributing.md b/contributing.md index 310d9b210..a41267159 100644 --- a/contributing.md +++ b/contributing.md @@ -1,5 +1,5 @@ **English** | [Українська](docs/contributing/contributing_ua.md) | [Русский](docs/contributing/contributing_ru.md) | [Türkçe](docs/contributing/contributing_tr.md) | [Deutsch](docs/contributing/contributing_de.md) | [Français](docs/contributing/contributing_fr.md) | [Português (BR)](docs/contributing/contributing_pt_br.md) | [বাংলা](docs/contributing/contributing_bn.md) | [Español](docs/contributing/contributing_es.md) | [Română](docs/contributing/contributing_ro.md) | [Polski](docs/contributing/contributing_pl.md) - | [简体中文](docs/contributing/contributing_cn.md) + | [简体中文](docs/contributing/contributing_cn.md) | [正體中文](docs/contributing/contributing_zhtw.md) ## Let's make bruno better, together !! We are happy that you are looking to improve bruno. Below are the guidelines to get started bringing up bruno on your computer. diff --git a/docs/contributing/contributing_zhtw.md b/docs/contributing/contributing_zhtw.md new file mode 100644 index 000000000..5b7fc5ec6 --- /dev/null +++ b/docs/contributing/contributing_zhtw.md @@ -0,0 +1,91 @@ +[English](/contributing.md) | [Українська](./contributing_ua.md) | [Русский](./contributing_ru.md) | [Türkçe](./contributing_tr.md) | [Deutsch](./contributing_de.md) | [Français](./contributing_fr.md) | [Português (BR)](./contributing_pt_br.md) | [বাংলা](./contributing_bn.md) | [Español](./contributing_es.md) | [Română](./contributing_ro.md) | [Polski](./contributing_pl.md) | [简体中文](./contributing_cn.md) | **正體中文** + +## 讓我們一起來讓 Bruno 變得更好！ + +我們很高興您希望一同改善 Bruno。以下是在您的電腦上開始運行 Bruno 的規則及指南。 + +### 技術細節 + +Bruno 使用 Next.js 和 React 構建。我們使用 Electron 來封裝及發佈桌面版本。 + +我們使用的函式庫： + +- CSS - Tailwind +- 程式碼編輯器 - Codemirror +- 狀態管理 - Redux +- Icons - Tabler Icons +- 表單 - formik +- 結構驗證- Yup +- 請求用戶端 - axios +- 檔案系統監測 - chokidar + +### 依賴關係 + +您需要使用 [Node v18.x 或最新的 LTS 版本](https://nodejs.org/en/) 和 npm 8.x。我們在這個專案中使用 npm 工作區（_npm workspaces_）。 + + +## 開發 + +Bruno 正以桌面應用程式的形式開發。您需要在一個終端機中執行 Next.js 來載入應用程式，然後在另一個終端機中執行 electron 應用程式。 + + +### 開發依賴 + +- NodeJS v18 + +### 本地開發 + +```bash +# 使用 nodejs 第 18 版 +nvm use + +# 安裝相依套件（使用--legacy-peer-deps 解決套件相依性問題） +npm i --legacy-peer-deps + +# 建立 graphql 文件 +npm run build:graphql-docs + +# 建立 bruno 查詢 +npm run build:bruno-query + +# 執行 next 應用程式（終端機 1） +npm run dev:web + +# 執行 electron 應用程式（終端機 2） +npm run dev:electron +``` + +### 故障排除 + +在執行 `npm install` 時，您可能會遇到 `Unsupported platform` 的錯誤訊息。爲了解決這個問題，您需要刪除 `node_modules` 資料夾和 `package-lock.json` 檔案，然後再執行一次 `npm install`。這應該能重新安裝應用程式所需的套件。 + +```shell +# 刪除子資料夾中的 node_modules 資料夾 +find ./ -type d -name "node_modules" -print0 | while read -d $'\0' dir; do + rm -rf "$dir" +done + +# 刪除子資料夾中的 package-lock.json 檔案 +find . -type f -name "package-lock.json" -delete +``` + + +### 測試 + +```bash +# bruno-schema +npm test --workspace=packages/bruno-schema + +# bruno-lang +npm test --workspace=packages/bruno-lang +``` + + +### 發送 Pull Request + +- 請保持 PR 精簡並專注於一個目標 +- 請遵循建立分支的格式： + - feature/[feature name]：該分支應包含特定功能的更改 + - 範例：feature/dark-mode + - bugfix/[bug name]：該分支應僅包含特定 bug 的修復 + - 範例：bugfix/bug-1 diff --git a/docs/publishing/publishing_zhtw.md b/docs/publishing/publishing_zhtw.md new file mode 100644 index 000000000..367ea0ad0 --- /dev/null +++ b/docs/publishing/publishing_zhtw.md @@ -0,0 +1,7 @@ +[English](/publishing.md) | [Português (BR)](docs/publishing/publishing_pt_br.md) | [Română](docs/publishing/publishing_ro.md) | [Polski](docs/publishing/publishing_pl.md) | [বাংলা](docs/publishing/publishing_bn.md) | [Français](docs/publishing/publishing_fr.md) | **正體中文** + +### 將 Bruno 發佈到新的套件管理器 + +雖然我們的程式碼是開源的並且可供所有人使用，但我們懇請您在考慮在新的套件管理器上發布之前與我們聯繫。作為 Bruno 的創建者，我擁有這個專案的 Bruno 商標並希望管理其發行。如果您希望看到 Bruno 使用新的套件管理器，請提出一個 GitHub issue。 + +雖然我們的大部分功能都是免費和開源（涵蓋 REST 和 GraphQL APIs），但我們努力在開源的原則和永續性之間，取得和諧的平衡 - https://github.com/usebruno/bruno/discussions/269 diff --git a/docs/readme/readme_zhtw.md b/docs/readme/readme_zhtw.md new file mode 100644 index 000000000..f39677b09 --- /dev/null +++ b/docs/readme/readme_zhtw.md @@ -0,0 +1,129 @@ +
+ + +### Bruno - 探索和測試 API 的開源 IDE 工具 + +[![GitHub version](https://badge.fury.io/gh/usebruno%2Fbruno.svg)](https://badge.fury.io/gh/usebruno%bruno) +[![CI](https://github.com/usebruno/bruno/actions/workflows/unit-tests.yml/badge.svg?branch=main)](https://github.com/usebruno/bruno/workflows/unit-tests.yml) +[![Commit Activity](https://img.shields.io/github/commit-activity/m/usebruno/bruno)](https://github.com/usebruno/bruno/pulse) +[![X](https://img.shields.io/twitter/follow/use_bruno?style=social&logo=x)](https://twitter.com/use_bruno) +[![网站](https://img.shields.io/badge/Website-Visit-blue)](https://www.usebruno.com) +[![下载](https://img.shields.io/badge/Download-Latest-brightgreen)](https://www.usebruno.com/downloads) + +[English](../../readme.md) | [Українська](./readme_ua.md) | [Русский](./readme_ru.md) | [Türkçe](./readme_tr.md) | [Deutsch](./readme_de.md) | [Français](./readme_fr.md) | [Português (BR)](./readme_pt_br.md) | [한국어](./readme_kr.md) | [বাংলা](./readme_bn.md) | [Español](./readme_es.md) | [Italiano](./readme_it.md) | [Română](./readme_ro.md) | [Polski](./readme_pl.md) | [简体中文](./readme_cn.md) | **正體中文** + +Bruno 是一個全新且有創新性的 API 用戶端，目的在徹底改變以 Postman 和其他類似工具的現況。 + +Bruno 將您的 API 集合直接儲存在檔案系統上的資料夾中。我們以純文本標記語言- Bru，來儲存和 API 有關的資訊。 + +您可以使用 Git 或您選擇的任何版本管理軟體，來管理及協作 API 集合。 + +Bruno 僅能夠離線使用，永遠不會計劃為 Bruno 增加雲端同步的功能。我們重視您的資料隱私，並相信它應該保留在您的裝置上。瞭解我們的長期願景 [連結](https://github.com/usebruno/bruno/discussions/269) + +📢 觀看我們最近在 India FOSS 3.0 研討會上的演講 [連結](https://www.youtube.com/watch?v=7bSMFpbcPiY) + +![bruno](../../assets/images/landing-2.png)

+ +### 安装 + +可以在我們的 [網站上下載](https://www.usebruno.com/downloads) 跨平臺（Mac、Windows 和 Linux）的 Bruno 程式檔。 + +您也可以透過套件管理程式來安裝 Bruno，如：Homebrew、Chocolatey、Scoop、Snap 和 Apt。 + +```shell +# 在 Mac 上使用 Homebrew 安裝 +brew install bruno + +# 在 Windows 上使用 Chocolatey 安裝 +choco install bruno + +# 在 Windows 上使用 Scoop 安裝 +scoop bucket add extras +scoop install bruno + +# 在 Linux 上使用 Snap 安裝 +snap install bruno + +# 在 Linux 上使用 Apt 安裝 +sudo mkdir -p /etc/apt/keyrings +sudo gpg --no-default-keyring --keyring /etc/apt/keyrings/bruno.gpg --keyserver keyserver.ubuntu.com --recv-keys 9FA6017ECABE0266 + +echo "deb [signed-by=/etc/apt/keyrings/bruno.gpg] http://debian.usebruno.com/ bruno stable" | sudo tee /etc/apt/sources.list.d/bruno.list + +sudo apt update +sudo apt install bruno +``` + +### 跨多個平台運行 🖥️ + +![bruno](../../assets/images/run-anywhere.png)

+ +### 透過 Git 進行協作 👩‍💻🧑‍💻 + +您選擇的任何版本管理軟體 + +![bruno](../../assets/images/version-control.png)

+ +### 重要連結 📌 + +- [我們的長期願景](https://github.com/usebruno/bruno/discussions/269) +- [藍圖](https://github.com/usebruno/bruno/discussions/384) +- [說明文件](https://docs.usebruno.com) +- [Stack Overflow](https://stackoverflow.com/questions/tagged/bruno) +- [網站](https://www.usebruno.com) +- [定價](https://www.usebruno.com/pricing) +- [下載](https://www.usebruno.com/downloads) +- [Github 贊助](https://github.com/sponsors/helloanoop). + +### 展示 🎥 + +- [Testimonials](https://github.com/usebruno/bruno/discussions/343) +- [Knowledge Hub](https://github.com/usebruno/bruno/discussions/386) +- [Scriptmania](https://github.com/usebruno/bruno/discussions/385) + +### 贊助支持 ❤️ + +如果您喜歡 Bruno 和希望支持我們在開源上的工作，請考慮使用 [Github Sponsors](https://github.com/sponsors/helloanoop) 來贊助我們。 + +### 分享感想 📣 + +如果 Bruno 在工作和您的團隊中為您提供了幫助，請不要忘記在我們的 [GitHub 討論區](https://github.com/usebruno/bruno/discussions/343) 中分享您的感想。 + +### 發佈到新的套件管理器 + +更多資訊，請參考這個 [連結](../publishing/publishing_zhtw.md) 。 + +### 持續關注 🌐 + +[𝕏 (Twitter)](https://twitter.com/use_bruno)
+[Website](https://www.usebruno.com)
+[Discord](https://discord.com/invite/KgcZUncpjq)
+[LinkedIn](https://www.linkedin.com/company/usebruno) + +### 商標 + +**名稱** + +`Bruno` 是 [Anoop M D](https://www.helloanoop.com/) 持有的商標。 + +**Logo** + +Logo 源自於 [OpenMoji](https://openmoji.org/library/emoji-1F436/)。授權: CC [BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/) + +### 提供貢獻 👩‍💻🧑‍💻 + +我很高興您希望一同改善 Bruno。請參考 [貢獻指南](../contributing/contributing_zhtw.md)。 + +即使您無法透過程式碼做出貢獻，我們仍然歡迎您提出 Bug 及新的實作需求。 + +### 作者們 + +
+ + + +
+ +### 授權許可 📄 + +[MIT](../../license.md) diff --git a/publishing.md b/publishing.md index 3ef5d40b5..126d7b017 100644 --- a/publishing.md +++ b/publishing.md @@ -1,4 +1,4 @@ -**English** | [Português (BR)](docs/publishing/publishing_pt_br.md) | [Română](docs/publishing/publishing_ro.md) | [Polski](docs/publishing/publishing_pl.md) | [বাংলা](docs/publishing/publishing_bn.md) | [Français](docs/publishing/publishing_fr.md) +**English** | [Português (BR)](docs/publishing/publishing_pt_br.md) | [Română](docs/publishing/publishing_ro.md) | [Polski](docs/publishing/publishing_pl.md) | [বাংলা](docs/publishing/publishing_bn.md) | [Français](docs/publishing/publishing_fr.md) | [正體中文](docs/publishing/publishing_zhtw.md) ### Publishing Bruno to a new package manager diff --git a/readme.md b/readme.md index 8be6b1f1d..fbdd6557d 100644 --- a/readme.md +++ b/readme.md @@ -10,7 +10,7 @@ [![Website](https://img.shields.io/badge/Website-Visit-blue)](https://www.usebruno.com) [![Download](https://img.shields.io/badge/Download-Latest-brightgreen)](https://www.usebruno.com/downloads) -**English** | [Українська](docs/readme/readme_ua.md) | [Русский](docs/readme/readme_ru.md) | [Türkçe](docs/readme/readme_tr.md) | [Deutsch](docs/readme/readme_de.md) | [Français](docs/readme/readme_fr.md) | [Português (BR)](docs/readme/readme_pt_br.md) | [한국어](docs/readme/readme_kr.md) | [বাংলা](docs/readme/readme_bn.md) | [Español](docs/readme/readme_es.md) | [Italiano](docs/readme/readme_it.md) | [Română](docs/readme/readme_ro.md) | [Polski](docs/readme/readme_pl.md) | [简体中文](docs/readme/readme_cn.md) +**English** | [Українська](docs/readme/readme_ua.md) | [Русский](docs/readme/readme_ru.md) | [Türkçe](docs/readme/readme_tr.md) | [Deutsch](docs/readme/readme_de.md) | [Français](docs/readme/readme_fr.md) | [Português (BR)](docs/readme/readme_pt_br.md) | [한국어](docs/readme/readme_kr.md) | [বাংলা](docs/readme/readme_bn.md) | [Español](docs/readme/readme_es.md) | [Italiano](docs/readme/readme_it.md) | [Română](docs/readme/readme_ro.md) | [Polski](docs/readme/readme_pl.md) | [简体中文](docs/readme/readme_cn.md) | [正體中文](docs/readme/readme_zhtw.md) Bruno is a new and innovative API client, aimed at revolutionizing the status quo represented by Postman and similar tools out there.