-
-
Notifications
You must be signed in to change notification settings - Fork 1.4k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
docs: add Traditional Chinese language docs (#1465)
- Loading branch information
Showing
6 changed files
with
230 additions
and
3 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -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 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -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 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,129 @@ | ||
| <br /> | ||
| <img src="../../assets/images/logo-transparent.png" width="80"/> | ||
|
|
||
| ### Bruno - 探索和測試 API 的開源 IDE 工具 | ||
|
|
||
| [](https://badge.fury.io/gh/usebruno%bruno) | ||
| [](https://github.com/usebruno/bruno/workflows/unit-tests.yml) | ||
| [](https://github.com/usebruno/bruno/pulse) | ||
| [](https://twitter.com/use_bruno) | ||
| [](https://www.usebruno.com) | ||
| [](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) | ||
|
|
||
|  <br /><br /> | ||
|
|
||
| ### 安装 | ||
|
|
||
| 可以在我們的 [網站上下載](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 | ||
| ``` | ||
|
|
||
| ### 跨多個平台運行 🖥️ | ||
|
|
||
|  <br /><br /> | ||
|
|
||
| ### 透過 Git 進行協作 👩💻🧑💻 | ||
|
|
||
| 您選擇的任何版本管理軟體 | ||
|
|
||
|  <br /><br /> | ||
|
|
||
| ### 重要連結 📌 | ||
|
|
||
| - [我們的長期願景](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) <br /> | ||
| [Website](https://www.usebruno.com) <br /> | ||
| [Discord](https://discord.com/invite/KgcZUncpjq) <br /> | ||
| [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 及新的實作需求。 | ||
|
|
||
| ### 作者們 | ||
|
|
||
| <div align="center"> | ||
| <a href="https://github.com/usebruno/bruno/graphs/contributors"> | ||
| <img src="https://contrib.rocks/image?repo=usebruno/bruno" /> | ||
| </a> | ||
| </div> | ||
|
|
||
| ### 授權許可 📄 | ||
|
|
||
| [MIT](../../license.md) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters