From f1fb667dcb82d1b35917f242843215bb46435e90 Mon Sep 17 00:00:00 2001 From: Rayiumir Date: Tue, 18 Aug 2026 03:44:56 +0330 Subject: [PATCH 1/3] docs: added Persian README translation --- README.fa.md | 120 +++++++++++++++++++++++++++++++++++++++++++++++++++ README.md | 2 +- 2 files changed, 121 insertions(+), 1 deletion(-) create mode 100644 README.fa.md diff --git a/README.fa.md b/README.fa.md new file mode 100644 index 00000000000..8ef4c68ada7 --- /dev/null +++ b/README.fa.md @@ -0,0 +1,120 @@ +

+
+

+ +

+ ساخت برنامه‌های دسکتاپ با استفاده از Go و فناوری‌های وب +

+ +## فهرست مطالب + +- [مقدمه](#مقدمه) +- [ویژگی‌ها](#ویژگیها) +- [نقشه راه](#نقشه-راه) +- [شروع کار](#شروع-کار) +- [حامیان مالی](#حامیان-مالی) +- [پرسش‌های متداول](#پرسشهای-متداول) +- [ستاره‌های GitHub در طول زمان](#ستارههای-github-در-طول-زمان) +- [مشارکت‌کنندگان](#مشارکتکنندگان) +- [مجوز](#مجوز) +- [منابع الهام](#منابع-الهام) + +## مقدمه + +روش سنتی ارائه رابط‌های وب برای برنامه‌های Go، استفاده از یک وب‌سرور داخلی است. **Wails** رویکرد متفاوتی دارد: این فریم‌ورک امکان بسته‌بندی کد Go و رابط کاربری وب را در قالب **یک فایل اجرایی واحد** فراهم می‌کند. + +فریم‌ ورک ویِلز یکی از بهترین ابزارهایی ارائه می‌دهد که ایجاد پروژه، کامپایل و بسته‌بندی برنامه را ساده می‌کنند. تنها چیزی که باقی می‌ماند، خلاقیت شماست! + +## ویژگی‌ها + +- استفاده از Go استاندارد برای بخش Backend +- امکان استفاده از هر فناوری Frontend که با آن آشنا هستید +- ساخت سریع رابط‌های کاربری غنی برای برنامه‌های Go با استفاده از قالب‌های آماده +- فراخوانی آسان متدهای Go از JavaScript +- تولید خودکار تعریف‌های TypeScript برای Structها و متدهای Go +- پشتیبانی از دیالوگ‌ها و منوهای Native +- پشتیبانی Native از حالت تاریک و روشن +- پشتیبانی از شفافیت مدرن و افکت‌های پنجره‌ای Frosted +- سیستم یکپارچه مدیریت رویداد بین Go و JavaScript +- ابزار خط فرمان قدرتمند برای ایجاد و Build سریع پروژه‌ها +- پشتیبانی از چندین سیستم‌عامل +- استفاده از موتورهای رندر Native و **بدون مرورگر Embedded** + +### نقشه راه + +نقشه راه پروژه در [اینجا](https://github.com/wailsapp/wails/discussions/1484) قرار دارد. + +قابلیت‌های جدید و تغییرات عمومی در رفتار Wails از طریق **WEP (Wails Enhancement Proposal)** پیشنهاد می‌شوند. این پیشنهادها به‌صورت Pull Request پیش‌نویس ارائه می‌شوند، نه به شکل Issue مربوط به درخواست قابلیت. + +## شروع کار + +Wails در حال حاضر دو نسخه فعال دارد: + +| نسخه | وضعیت | نصب | مستندات | +|---|---|---|---| +| **v2** | پایدار | `go install github.com/wailsapp/wails/v2/cmd/wails@latest` | [wails.io](https://wails.io/) | +| **v3** | بتا | `go install github.com/wailsapp/wails/v3/cmd/wails3@latest` | [v3.wails.io](https://v3.wails.io/) | + +دستورالعمل کامل نصب برای [نسخه v2](https://wails.io/docs/gettingstarted/installation) و [نسخه v3](https://v3.wails.io) در مستندات رسمی موجود است. + +## حامیان مالی + +این پروژه توسط افراد و شرکت‌هایی که از آن حمایت می‌کنند توسعه می‌یابد. + + + +## Powered By + +[![JetBrains logo.](https://resources.jetbrains.com/storage/products/company/brand/logos/jetbrains.svg)](https://jb.gg/OpenSource) + +## پرسش‌های متداول + +### آیا Wails جایگزینی برای Electron است؟ + +بستگی به نیاز شما دارد. Wails با هدف ساده‌کردن ساخت برنامه‌های دسکتاپ سبک برای برنامه‌نویسان Go طراحی شده است و همچنین می‌تواند برای افزودن یک رابط کاربری Frontend به برنامه‌های موجود Go استفاده شود. + +Wails امکاناتی مانند منوها و دیالوگ‌های Native را نیز ارائه می‌دهد؛ بنابراین می‌توان آن را یک **جایگزین سبک‌تر برای Electron** در نظر گرفت. + +### Wails برای چه کسانی ساخته شده است؟ + +برای برنامه‌نویسان Go که می‌خواهند یک رابط HTML/JS/CSS را همراه با برنامه خود بسته‌بندی کنند، بدون اینکه مجبور باشند یک سرور ایجاد کرده و برای نمایش رابط کاربری، مرورگر جداگانه‌ای باز کنند. + +### نام Wails از کجا آمده است؟ + +زمانی که سازنده پروژه با مفهوم WebView مواجه شد، به این فکر کرد که چیزی شبیه Rails برای Ruby، اما برای ساخت برنامه‌های WebView ایجاد کند. + +به همین دلیل نام اولیه آن بازی با عبارت **Webview on Rails** بود. این نام از نظر تلفظ با نام انگلیسی کشور [Wales](https://en.wikipedia.org/wiki/Wales) نیز مشابه است؛ کشوری که سازنده پروژه اهل آن است. در نهایت همین نام باقی ماند. + +## ستاره‌های گیت هاب در طول زمان + + + نمودار تاریخچه ستاره‌های Wails + + +## مشارکت‌کنندگان + +تعداد مشارکت‌کنندگان پروژه آن‌قدر زیاد شده است که دیگر امکان قرار دادن فهرست همه آن‌ها در README وجود ندارد. + +همه افرادی که در توسعه پروژه مشارکت داشته‌اند، در [صفحه مشارکت‌کنندگان](https://wails.io/credits#contributors) معرفی شده‌اند. + +## مجوز + +[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fwailsapp%2Fwails.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2Fwailsapp%2Fwails?ref=badge_large) + +## منابع الهام + +این پروژه عمدتاً با الهام از آلبوم‌های زیر توسعه داده شده است: + +- [Manic Street Preachers - Resistance Is Futile](https://open.spotify.com/album/1R2rsEUqXjIvAbzM0yHrxA) +- [Manic Street Preachers - This Is My Truth, Tell Me Yours](https://open.spotify.com/album/4VzCL9kjhgGQeKCiojK1YN) +- [The Midnight - Endless Summer](https://open.spotify.com/album/4Krg8zvprquh7TVn9OxZn8) +- [Gary Numan - Savage (Songs from a Broken World)](https://open.spotify.com/album/3kMfsD07Q32HRWKRrpcexr) +- [Steve Vai - Passion & Warfare](https://open.spotify.com/album/0oL0OhrE2rYVns4IGj8h2m) +- [Ben Howard - Every Kingdom](https://open.spotify.com/album/1nJsbWm3Yy2DW1KIc1OKle) +- [Ben Howard - Noonday Dream](https://open.spotify.com/album/6astw05cTiXEc2OvyByaPs) +- [Adwaith - Melyn](https://open.spotify.com/album/2vBE40Rp60tl7rNqIZjaXM) +- [Gwidaith Hen Fran - Cedors Hen Wrach](https://open.spotify.com/album/3v2hrfNGINPLuDP0YDTOjm) +- [Metallica - Metallica](https://open.spotify.com/album/2Kh43m04B1UkVcpcRa1Zug) +- [Bloc Party - Silent Alarm](https://open.spotify.com/album/6SsIdN05HQg2GwYLfXuzLB) +- [Maxthor - Another World](https://open.spotify.com/album/3tklE2Fgw1hCIUstIwPBJF) +- [Alun Tan Lan - Y Distawrwydd](https://open.spotify.com/album/0c32OywcLpdJCWWMC6vB8v) diff --git a/README.md b/README.md index 6c40b1e2511..5b67b26f08d 100644 --- a/README.md +++ b/README.md @@ -43,7 +43,7 @@ [English](README.md) · [简体中文](README.zh-Hans.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Español](README.es.md) · [Português](README.pt-br.md) · [Русский](README.ru.md) · [Francais](README.fr.md) · [Uzbek](README.uz.md) · [Deutsch](README.de.md) · -[Türkçe](README.tr.md) · [Bahasa Indonesia](README.id.md) +[Türkçe](README.tr.md) · [Bahasa Indonesia](README.id.md) · [Persian](README.fa.md) From eeae7a42a0200ccd88a42ecc536c2a53ef85d909 Mon Sep 17 00:00:00 2001 From: Rayiumir Date: Tue, 18 Aug 2026 03:48:52 +0330 Subject: [PATCH 2/3] docs: added Armenian README translation --- README.hy.md | 120 +++++++++++++++++++++++++++++++++++++++++++++++++++ README.md | 2 +- 2 files changed, 121 insertions(+), 1 deletion(-) create mode 100644 README.hy.md diff --git a/README.hy.md b/README.hy.md new file mode 100644 index 00000000000..b1f8538cba4 --- /dev/null +++ b/README.hy.md @@ -0,0 +1,120 @@ +

+
+

+ +

+ Սեղանի հավելվածների ստեղծում Go-ի և վեբ տեխնոլոգիաների միջոցով։ +

+ +## Բովանդակություն + +- [Ներածություն](#ներածություն) +- [Հնարավորություններ](#հնարավորություններ) + - [Զարգացման ճանապարհային քարտեզ](#զարգացման-ճանապարհային-քարտեզ) +- [Սկսել աշխատանքը](#սկսել-աշխատանքը) +- [Հովանավորներ](#հովանավորներ) +- [Հաճախ տրվող հարցեր](#հաճախ-տրվող-հարցեր) +- [GitHub-ի աստղերը ժամանակի ընթացքում](#github-ի-աստղերը-ժամանակի-ընթացքում) +- [Մասնակիցներ](#մասնակիցներ) +- [Լիցենզիա](#լիցենզիա) +- [Ոգեշնչման աղբյուրներ](#ոգեշնչման-աղբյուրներ) + +## Ներածություն + +Go ծրագրերին վեբ ինտերֆեյս տրամադրելու ավանդական եղանակը ներկառուցված վեբ սերվերի օգտագործումն է։ **Wails**-ը առաջարկում է այլ մոտեցում․ այն հնարավորություն է տալիս Go կոդը և վեբ Frontend-ը փաթեթավորել **մեկ միասնական գործարկվող ֆայլի** մեջ։ + +Wails-ը տրամադրում է գործիքներ, որոնք հեշտացնում են նախագծի ստեղծումը, կոմպիլյացիան և փաթեթավորումը։ Մնում է միայն օգտագործել ձեր ստեղծագործական հնարավորությունները։ + +## Հնարավորություններ + +- Backend-ի համար օգտագործել ստանդարտ Go +- Օգտագործել ցանկացած Frontend տեխնոլոգիա, որին արդեն ծանոթ եք +- Նախապես պատրաստված ձևանմուշների միջոցով արագ ստեղծել հարուստ ինտերֆեյսներ Go ծրագրերի համար +- JavaScript-ից հեշտությամբ կանչել Go-ի մեթոդները +- Go-ի Struct-ների և մեթոդների համար TypeScript-ի սահմանումների ավտոմատ ստեղծում +- Native երկխոսությունների և մենյուների աջակցություն +- Native մութ և լուսավոր ռեժիմների աջակցություն +- Ժամանակակից թափանցիկության և «Frosted Glass» պատուհանային էֆեկտների աջակցություն +- Go-ի և JavaScript-ի միջև իրադարձությունների միասնական համակարգ +- Հզոր CLI գործիք՝ նախագծերի արագ ստեղծման և Build-ի համար +- Բազմահարթակ աջակցություն +- Native ռենդերինգային շարժիչների օգտագործում՝ **առանց ներկառուցված բրաուզերի** + +### Զարգացման ճանապարհային քարտեզ + +Նախագծի ճանապարհային քարտեզը հասանելի է [այստեղ](https://github.com/wailsapp/wails/discussions/1484)։ + +Նոր հնարավորությունները և հանրային վարքագծի փոփոխությունները առաջարկվում են **WEP (Wails Enhancement Proposal)** մեխանիզմի միջոցով։ Դրանք ներկայացվում են որպես Draft Pull Request, այլ ոչ թե Feature Request Issue։ + +## Սկսել աշխատանքը + +Wails-ն այժմ ունի երկու ակտիվ տարբերակ. + +| Տարբերակ | Կարգավիճակ | Տեղադրում | Փաստաթղթեր | +|---|---|---|---| +| **v2** | Կայուն | `go install github.com/wailsapp/wails/v2/cmd/wails@latest` | [wails.io](https://wails.io/) | +| **v3** | Բետա | `go install github.com/wailsapp/wails/v3/cmd/wails3@latest` | [v3.wails.io](https://v3.wails.io/) | + +Տեղադրման ամբողջական հրահանգները հասանելի են [v2](https://wails.io/docs/gettingstarted/installation) և [v3](https://v3.wails.io) տարբերակների համար։ + +## Հովանավորներ + +Նախագիծը աջակցվում է այն մարդկանց և ընկերությունների կողմից, որոնք նպաստում են դրա զարգացմանը։ + + + +## Powered By + +[![JetBrains logo.](https://resources.jetbrains.com/storage/products/company/brand/logos/jetbrains.svg)](https://jb.gg/OpenSource) + +## Հաճախ տրվող հարցեր + +### Արդյո՞ք Wails-ը Electron-ի այլընտրանք է։ + +Կախված է ձեր պահանջներից։ Wails-ը նախատեսված է Go ծրագրավորողների համար, ովքեր ցանկանում են հեշտությամբ ստեղծել թեթև Desktop հավելվածներ կամ իրենց գոյություն ունեցող Go ծրագրերին ավելացնել Frontend։ + +Wails-ը տրամադրում է նաև Native տարրեր, ինչպիսիք են մենյուները և երկխոսությունները, ուստի այն կարելի է դիտարկել որպես **Electron-ի թեթև այլընտրանք**։ + +### Ո՞ւմ համար է նախատեսված այս նախագիծը։ + +Go ծրագրավորողների համար, ովքեր ցանկանում են HTML/JS/CSS Frontend-ը փաթեթավորել իրենց հավելվածի հետ՝ առանց սերվեր ստեղծելու և ինտերֆեյսը ցուցադրելու համար առանձին բրաուզեր բացելու։ + +### Որտեղի՞ց է առաջացել Wails անվանումը։ + +Երբ նախագծի հեղինակը ծանոթացավ WebView-ի գաղափարին, նա մտածեց, որ ցանկանում է ստեղծել WebView հավելվածներ կառուցելու գործիքակազմ՝ մոտավորապես այնպես, ինչպես Rails-ը Ruby-ի համար։ + +Սկզբնական շրջանում անվանումը բառախաղ էր՝ **Webview on Rails**։ Պատահականորեն այն նաև հնչյունականորեն նման էր այն երկրի անգլերեն անվանը՝ [Wales](https://en.wikipedia.org/wiki/Wales), որտեղից նախագիծը ստեղծողն է։ Այդպես էլ անվանումը պահպանվեց։ + +## GitHub-ի աստղերը ժամանակի ընթացքում + + + Wails-ի աստղերի պատմության գրաֆիկ + + +## Մասնակիցներ + +Մասնակիցների ցանկն այնքան է մեծացել, որ այն այլևս հնարավոր չէ ամբողջությամբ տեղադրել README-ում։ + +Բոլոր այն մարդիկ, ովքեր ներդրում են ունեցել նախագծի զարգացման գործում, ներկայացված են [մասնակիցների էջում](https://wails.io/credits#contributors)։ + +## Լիցենզիա + +[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fwailsapp%2Fwails.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2Fwailsapp%2Fwails?ref=badge_large) + +## Ոգեշնչման աղբյուրներ + +Այս նախագիծը հիմնականում մշակվել է հետևյալ ալբոմների ոգեշնչմամբ. + +- [Manic Street Preachers - Resistance Is Futile](https://open.spotify.com/album/1R2rsEUqXjIvAbzM0yHrxA) +- [Manic Street Preachers - This Is My Truth, Tell Me Yours](https://open.spotify.com/album/4VzCL9kjhgGQeKCiojK1YN) +- [The Midnight - Endless Summer](https://open.spotify.com/album/4Krg8zvprquh7TVn9OxZn) +- [Gary Numan - Savage (Songs from a Broken World)](https://open.spotify.com/album/3kMfsD07Q32HRWKRrpcexr) +- [Steve Vai - Passion & Warfare](https://open.spotify.com/album/0oL0OhrE2rYVns4IGj8h2m) +- [Ben Howard - Every Kingdom](https://open.spotify.com/album/1nJsbWm3Yy2DW1KIc1OKle) +- [Ben Howard - Noonday Dream](https://open.spotify.com/album/6astw05cTiXEc2OvyByaPs) +- [Adwaith - Melyn](https://open.spotify.com/album/2vBE40Rp60tl7rNqIZjaXM) +- [Gwidaith Hen Fran - Cedors Hen Wrach](https://open.spotify.com/album/3v2hrfNGINPLuDP0YDTOjm) +- [Metallica - Metallica](https://open.spotify.com/album/2Kh43m04B1UkVcpcRa1Zug) +- [Bloc Party - Silent Alarm](https://open.spotify.com/album/6SsIdN05HQg2GwYLfXuzLB) +- [Maxthor - Another World](https://open.spotify.com/album/3tklE2Fgw1hCIUstIwPBJF) +- [Alun Tan Lan - Y Distawrwydd](https://open.spotify.com/album/0c32OywcLpdJCWWMC6vB8v) \ No newline at end of file diff --git a/README.md b/README.md index 5b67b26f08d..eea57f19b63 100644 --- a/README.md +++ b/README.md @@ -43,7 +43,7 @@ [English](README.md) · [简体中文](README.zh-Hans.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Español](README.es.md) · [Português](README.pt-br.md) · [Русский](README.ru.md) · [Francais](README.fr.md) · [Uzbek](README.uz.md) · [Deutsch](README.de.md) · -[Türkçe](README.tr.md) · [Bahasa Indonesia](README.id.md) · [Persian](README.fa.md) +[Türkçe](README.tr.md) · [Bahasa Indonesia](README.id.md) · [Persian](README.fa.md) . [Armenian](README.hy.md) From 009c294d3bff8f9c8b714b803e1fb167b72438fe Mon Sep 17 00:00:00 2001 From: Raymond Baghumian Date: Tue, 18 Aug 2026 03:51:09 +0330 Subject: [PATCH 3/3] Update README.fa.md --- README.fa.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.fa.md b/README.fa.md index 8ef4c68ada7..72b53686099 100644 --- a/README.fa.md +++ b/README.fa.md @@ -73,9 +73,9 @@ Wails در حال حاضر دو نسخه فعال دارد: بستگی به نیاز شما دارد. Wails با هدف ساده‌کردن ساخت برنامه‌های دسکتاپ سبک برای برنامه‌نویسان Go طراحی شده است و همچنین می‌تواند برای افزودن یک رابط کاربری Frontend به برنامه‌های موجود Go استفاده شود. -Wails امکاناتی مانند منوها و دیالوگ‌های Native را نیز ارائه می‌دهد؛ بنابراین می‌توان آن را یک **جایگزین سبک‌تر برای Electron** در نظر گرفت. +فریم ورک Wails امکاناتی مانند منوها و دیالوگ‌های Native را نیز ارائه می‌دهد؛ بنابراین می‌توان آن را یک **جایگزین سبک‌تر برای Electron** در نظر گرفت. -### Wails برای چه کسانی ساخته شده است؟ +### فریم ورک Wails برای چه کسانی ساخته شده است؟ برای برنامه‌نویسان Go که می‌خواهند یک رابط HTML/JS/CSS را همراه با برنامه خود بسته‌بندی کنند، بدون اینکه مجبور باشند یک سرور ایجاد کرده و برای نمایش رابط کاربری، مرورگر جداگانه‌ای باز کنند.