Skip to content

Commit e8a8b5d

Browse files
authored
Merge pull request #6027 from sajadoncode/feature/add-farsi-readme
docs: add farsi translation
2 parents 2c399ca + bc3dfc5 commit e8a8b5d

File tree

6 files changed

+252
-0
lines changed

6 files changed

+252
-0
lines changed

contributing.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@
1616
| [日本語](docs/contributing/contributing_ja.md)
1717
| [हिंदी](docs/contributing/contributing_hi.md)
1818
| [Dutch](docs/contributing/contributing_nl.md)
19+
| [فارسی](docs/contributing/contributing_fa.md)
1920

2021
## Let's make Bruno better, together!!
2122

@@ -74,6 +75,7 @@ npm run build:bruno-filestore
7475
# bundle js sandbox libraries
7576
npm run sandbox:bundle-libraries --workspace=packages/bruno-js
7677
```
78+
7779
##### Option 2
7880

7981
```bash
@@ -94,18 +96,22 @@ npm run dev:electron
9496
```
9597

9698
##### Option 2
99+
97100
```bash
98101
# run electron and react app concurrently
99102
npm run dev
100103
```
101104

102105
#### Customize Electron `userData` path
106+
103107
If `ELECTRON_USER_DATA_PATH` env-variable is present and its development mode, then `userData` path is modified accordingly.
104108

105109
e.g.
110+
106111
```sh
107112
ELECTRON_USER_DATA_PATH=$(realpath ~/Desktop/bruno-test) npm run dev:electron
108113
```
114+
109115
This will create a `bruno-test` folder on your Desktop and use it as the `userData` path.
110116

111117
### Troubleshooting
Lines changed: 92 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,92 @@
1+
[English](../../contributing.md)
2+
3+
## با هم، Bruno را بهتر می‌کنیم!
4+
5+
خوشحالم که قصد دارید Bruno را بهبود ببخشید. در ادامه قوانین و راهنماها برای راه‌اندازی Bruno روی سیستم شما آورده شده است.
6+
7+
### فناوری‌های استفاده‌شده
8+
9+
به فارسی برونو Bruno با استفاده از Next.js و React ساخته شده است. همچنین از Electron برای بسته‌بندی نسخه دسکتاپ (که امکان مجموعه‌های محلی را فراهم می‌کند) استفاده می‌کنیم.
10+
11+
کتابخانه‌هایی که استفاده می‌کنیم:
12+
13+
- CSS - Tailwind استایل
14+
- Codemirror - ویرایشگر کد
15+
- Redux - مدیریت وضعیت
16+
- Tabler Icons - آیکون‌ها
17+
- formik - فرم‌ها
18+
- Yup اعتبارسنجی اسکیمـا
19+
- axios - کلاینت درخواست
20+
- chokidar - پایش‌گر سیستم فایل
21+
22+
### پیش‌نیازها
23+
24+
شما به [نود v20.x یا اخرین نسخه پایدار](https://nodejs.org/en/) و npm 8.x نیاز دارید. در این پروژه از فضای کاری npm (npm workspaces) استفاده می‌کنیم.
25+
26+
### شروع به کدنویسی
27+
28+
برای راه‌اندازی محیط توسعه محلی به فایل [مستندات توسعه](docs/development_fa.md) مراجعه کنید:
29+
30+
### ارسال Pull Request
31+
32+
1 - لطفاً Pull Requestها (PR) را کوتاه و متمرکز نگه دارید و تنها یک هدف مشخص را دنبال کنند. </br>
33+
2 - لطفاً از فرمت نام‌گذاری شاخه‌ها استفاده کنید:
34+
35+
- feature/[name]: این شاخه باید شامل یک قابلیت مشخص باشد.
36+
- feature/dark-mode : مثال
37+
- bugfix/[name]: این شاخه باید تنها شامل رفع یک باگ مشخص باشد.
38+
- bugfix/bug-1 : مثال
39+
40+
## توسعه
41+
42+
به فارسی برونو یا Bruno به‌صورت یک اپلیکیشن «سنگین» توسعه داده می‌شود. برای اجرا باید ابتدا Next.js را در یک پنجره ترمینال اجرا کنید و سپس اپلیکیشن Electron را در پنجره ترمینال دیگری راه‌اندازی نمایید.
43+
44+
### نیازمندی توسعه
45+
46+
- NodeJS v18
47+
48+
### اجرای محلی
49+
50+
```bash
51+
# از ورژن NodeJS 18 استفاده کنید
52+
nvm use
53+
54+
# نصب وابستگی‌ها
55+
npm i --legacy-peer-deps
56+
57+
# ساخت مستندات GraphQL
58+
npm run build:graphql-docs
59+
60+
# ساخت bruno-query
61+
npm run build:bruno-query
62+
63+
# اجرای اپ Next (ترمینال 1)
64+
npm run dev:web
65+
66+
# اجرای اپ Electron (ترمینال 2)
67+
npm run dev:electron
68+
```
69+
70+
### عیب‌یابی
71+
72+
ممکن است هنگام اجرای `npm install` خطای `Unsupported platform` ببینید. برای رفع این مشکل، پوشه `node_modules` و فایل `package-lock.json` را حذف کرده و سپس دوباره `npm install` را اجرا کنید. این کار معمولاً همه پکیج‌های لازم را نصب می‌کند.
73+
74+
```shell
75+
# حذف پوشه node_modules در زیردایرکتوری‌ها
76+
find ./ -type d -name "node_modules" -print0 | while read -d $'\0' dir; do
77+
rm -rf "$dir"
78+
done
79+
80+
# حذف فایل package-lock.json در زیردایرکتوری‌ها
81+
find . -type f -name "package-lock.json" -delete
82+
```
83+
84+
### تست‌ها
85+
86+
```bash
87+
# اجرای تست‌های schema مربوط به bruno
88+
npm test --workspace=packages/bruno-schema
89+
90+
# اجرای تست‌ها در همه فضاهای کاری (در صورت وجود)
91+
npm test --workspaces --if-present
92+
```

docs/publishing/publishing_fa.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
[English](../../publishing.md)
2+
3+
### انتشار Bruno در یک پکیج منیجر جدید
4+
5+
اگرچه کد ما متن‌باز است و همه می‌توانند از آن استفاده کنند، لطفاً قبل از انتشار Bruno در مدیر بسته‌های جدید با ما تماس بگیرید. به عنوان سازنده Bruno، علامت تجاری `Bruno` را برای این پروژه دارم و مایلم توزیع آن را مدیریت کنم. اگر دوست دارید Bruno را در یک مدیر بسته جدید ببینید، لطفاً یک issue در گیت‌هاب ثبت کنید.
6+
7+
اگرچه بیشتر قابلیت‌های ما رایگان و متن‌باز هستند (شامل REST و GraphQL Apis)،
8+
ما تلاش می‌کنیم بین اصول متن‌باز و توسعه پایدار تعادل مناسبی برقرار کنیم - https://github.com/usebruno/bruno/discussions/269

docs/readme/readme_fa.md

Lines changed: 143 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,143 @@
1+
<br />
2+
<img src="../../assets/images/logo-transparent.png" width="80"/>
3+
4+
### برونو یا Bruno - محیط توسعه متن باز برای تست و توسعه API ها
5+
6+
[![GitHub version](https://badge.fury.io/gh/usebruno%2Fbruno.svg)](https://badge.fury.io/gh/usebruno%bruno)
7+
[![CI](https://github.com/usebruno/bruno/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/usebruno/bruno/actions/workflows/tests.yml)
8+
[![Commit Activity](https://img.shields.io/github/commit-activity/m/usebruno/bruno)](https://github.com/usebruno/bruno/pulse)
9+
[![X](https://img.shields.io/twitter/follow/use_bruno?style=social&logo=x)](https://twitter.com/use_bruno)
10+
[![Website](https://img.shields.io/badge/Website-Visit-blue)](https://www.usebruno.com)
11+
[![Download](https://img.shields.io/badge/Download-Latest-brightgreen)](https://www.usebruno.com/downloads)
12+
13+
[English](../../readme.md)
14+
| [Українська](./readme_ua.md)
15+
| [Русский](./readme_ru.md)
16+
| [Türkçe](./readme_tr.md)
17+
| [Deutsch](./readme_de.md)
18+
| [Français](./readme_fr.md)
19+
| [Português (BR)](./readme_pt_br.md)
20+
| [한국어](./readme_kr.md)
21+
| [বাংলা](./readme_bn.md)
22+
| [Español](./readme_es.md)
23+
| **فارسی**
24+
| [Română](./readme_ro.md)
25+
| [Polski](./readme_pl.md)
26+
| [简体中文](./readme_cn.md)
27+
| [正體中文](./readme_zhtw.md)
28+
| [العربية](./readme_ar.md)
29+
| [日本語](./readme_ja.md)
30+
| [ქართული](./readme_ka.md)
31+
32+
برونو یک کلاینت API جدید و نوآورانه است که هدفش تغییر وضعیت فعلی ابزارهایی مانند Postman و سایر ابزارهای مشابه است.
33+
34+
برونو مجموعه‌های شما را مستقیماً در یک پوشه روی فایل‌سیستم شما ذخیره می‌کند. ما از یک زبان نشانه‌گذاری ساده به نام Bru برای ذخیره اطلاعات درخواست‌های API استفاده می‌کنیم.
35+
36+
شما می‌توانید برای همکاری روی مجموعه‌های API خود، از Git یا هر سیستم کنترل نسخه دلخواهتان استفاده کنید.
37+
38+
برونو فقط به صورت آفلاین کار می‌کند. هیچ برنامه‌ای برای اضافه کردن همگام‌سازی ابری به برونو در آینده وجود ندارد. ما به حریم خصوصی داده‌های شما اهمیت می‌دهیم و معتقدیم که باید روی دستگاه خودتان باقی بمانند. می‌توانید چشم‌انداز بلندمدت ما را مطالعه کنید. [اینجا (به انگلیسی)](https://github.com/usebruno/bruno/discussions/269)
39+
40+
📢 جدیدترین ارائه ما را در کنفرانس India FOSS 3.0 تماشا کنید.
41+
[اینجا](https://www.youtube.com/watch?v=7bSMFpbcPiY)
42+
43+
![bruno](/assets/images/landing-2.png) <br /><br />
44+
45+
### نصب
46+
47+
برونو به صورت یک فایل باینری برای دانلود در دسترس است. [بر روی وبسایت ما](https://www.usebruno.com/downloads) برای مک لینکوس و ویندوز.
48+
49+
همچنین می‌توانید برونو را از طریق مدیر بسته‌هایی مانند Homebrew، Chocolatey، Snap و Apt نصب کنید.
50+
51+
```sh
52+
# بر روی مک از طریق brew
53+
brew install bruno
54+
55+
# بر روی ویندوز از طریق Chocolatey
56+
choco install bruno
57+
58+
# بر روی لینوکس از طریق Snap
59+
snap install bruno
60+
61+
# بر روی لینوکس از طریق Apt
62+
sudo mkdir -p /etc/apt/keyrings
63+
sudo apt update && sudo apt install gpg curl
64+
curl -fsSL "https://keyserver.ubuntu.com/pks/lookup?op=get&search=0x9FA6017ECABE0266" \
65+
| gpg --dearmor \
66+
| sudo tee /etc/apt/keyrings/bruno.gpg > /dev/null
67+
sudo chmod 644 /etc/apt/keyrings/bruno.gpg
68+
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/bruno.gpg] http://debian.usebruno.com/ bruno stable" \
69+
| sudo tee /etc/apt/sources.list.d/bruno.list
70+
sudo apt update && sudo apt install bruno
71+
```
72+
73+
### روی پلتفرم‌های مختلف کار می‌کند 🖥️
74+
75+
![bruno](/assets/images/run-anywhere.png) <br /><br />
76+
77+
### همکاری از طریق گیت 👩‍💻🧑‍💻
78+
79+
یا هر سیستم کنترل نسخه‌ای که ترجیح می‌دهید
80+
81+
![bruno](/assets/images/version-control.png) <br /><br />
82+
83+
### لینک‌های مهم 📌
84+
85+
- [آخرین نسخه پایدار ما](https://github.com/usebruno/bruno/discussions/269)
86+
- [نقشه راه](https://github.com/usebruno/bruno/discussions/384)
87+
- [مستندات](https://docs.usebruno.com)
88+
- [وبسایت](https://www.usebruno.com)
89+
- [اشتراک ها](https://www.usebruno.com/pricing)
90+
- [دانلود](https://www.usebruno.com/downloads)
91+
92+
### ویدیوها 🎥
93+
94+
- [تجربه ها](https://github.com/usebruno/bruno/discussions/343)
95+
- [مرکز دانش](https://github.com/usebruno/bruno/discussions/386)
96+
- [اسکریپ مانیا](https://github.com/usebruno/bruno/discussions/385)
97+
98+
### حمایت ❤️
99+
100+
جوون! اگر این پروژه را دوست دارید، روی دکمه ⭐ کلیک کنید!
101+
102+
### تجربه‌های به اشتراک گذاشته‌شده 📣
103+
104+
اگر برونو به شما یا تیمتان کمک کرده است، لطفاً فراموش نکنید تجربه‌های خود را به اشتراک بگذارید. [تجربه‌های خود را در بحث گیت‌هاب ما به اشتراک بگذارید](https://github.com/usebruno/bruno/discussions/343).
105+
106+
### انتشار برونو در یک پکیچ منیجر جدید
107+
108+
لطفا چک بکنید [اینجارو](../../publishing.md) برای اطلاعات بیشتر.
109+
110+
### مشارکت 👩‍💻🧑‍💻
111+
112+
خوشحالم که می‌خواهید برونو را بهتر کنید. لطفا [راهنمای مشارکت را بررسی کنید](../contributing/contributing_fa.md).
113+
114+
حتی اگر نمی‌توانید از طریق کدنویسی مشارکت کنید، در گزارش باگ‌ها و درخواست قابلیت‌های جدید که به حل نیازهای شما کمک می‌کند تردید نکنید.
115+
116+
### نویسنده ها
117+
118+
<div align="center">
119+
<a href="https://github.com/usebruno/bruno/graphs/contributors">
120+
<img src="https://contrib.rocks/image?repo=usebruno/bruno" />
121+
</a>
122+
</div>
123+
124+
### در ارتباط باشید 🌐
125+
126+
[𝕏 (تویتر)](https://twitter.com/use_bruno) <br />
127+
[وبسایت](https://www.usebruno.com) <br />
128+
[دیسکورد](https://discord.com/invite/KgcZUncpjq) <br />
129+
[لینکدین](https://www.linkedin.com/company/usebruno)
130+
131+
### برند
132+
133+
**نام**
134+
135+
به فارسی برونو - `Bruno` یک علامت تجاری ثبت‌شده متعلق به [Anoop M D](https://www.helloanoop.com/)
136+
137+
**لوگو**
138+
139+
لوگو توسط [OpenMoji](https://openmoji.org/library/emoji-1F436/) ساخته شده است. مجوز: CC [BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/)
140+
141+
### مجوز 📄
142+
143+
[MIT](../../license.md)

publishing.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@
1010
| [正體中文](docs/publishing/publishing_zhtw.md)
1111
| [日本語](docs/publishing/publishing_ja.md)
1212
| [Nederlands](docs/publishing/publishing_nl.md)
13+
| [فارسی](docs/publishing/publishing_fa.md)
1314

1415
### Publishing Bruno to a new package manager
1516

readme.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,7 @@
2929
| [日本語](docs/readme/readme_ja.md)
3030
| [ქართული](docs/readme/readme_ka.md)
3131
| [Nederlands](docs/readme/readme_nl.md)
32+
| [فارسی](docs/readme/readme_fa.md)
3233

3334
Bruno is a new and innovative API client, aimed at revolutionizing the status quo represented by Postman and similar tools out there.
3435

@@ -52,6 +53,7 @@ We strive to strike a harmonious balance between [open-source principles and sus
5253
You can explore our [paid versions](https://www.usebruno.com/pricing) to see if there are additional features that you or your team may find useful! <br/>
5354

5455
## Table of Contents
56+
5557
- [Installation](#installation)
5658
- [Features](#features)
5759
- [Run across multiple platforms 🖥️](#run-across-multiple-platforms-%EF%B8%8F)

0 commit comments

Comments
 (0)