-
-
Notifications
You must be signed in to change notification settings - Fork 1.8k
Added: Persian and Armenian languages were added for documentation. #5996
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Open
Rayiumir
wants to merge
3
commits into
wailsapp:master
Choose a base branch
from
Rayiumir:master
base: master
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
Changes from all commits
Commits
Show all changes
3 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or 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,120 @@ | ||
| <p align="center" style="text-align: center"> | ||
| <img src="./assets/images/logo-universal.png" width="55%"><br/> | ||
| </p> | ||
|
|
||
| <p align="center"> | ||
| ساخت برنامههای دسکتاپ با استفاده از Go و فناوریهای وب | ||
| </p> | ||
|
|
||
| ## فهرست مطالب | ||
|
|
||
| - [مقدمه](#مقدمه) | ||
| - [ویژگیها](#ویژگیها) | ||
|
Rayiumir marked this conversation as resolved.
|
||
| - [نقشه راه](#نقشه-راه) | ||
| - [شروع کار](#شروع-کار) | ||
| - [حامیان مالی](#حامیان-مالی) | ||
| - [پرسشهای متداول](#پرسشهای-متداول) | ||
| - [ستارههای 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) در مستندات رسمی موجود است. | ||
|
|
||
| ## حامیان مالی | ||
|
|
||
| این پروژه توسط افراد و شرکتهایی که از آن حمایت میکنند توسعه مییابد. | ||
|
|
||
| <img src="website/static/img/sponsors.svg" style="width:100%;max-width:800px;"/> | ||
|
|
||
| ## Powered By | ||
|
|
||
| [](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) نیز مشابه است؛ کشوری که سازنده پروژه اهل آن است. در نهایت همین نام باقی ماند. | ||
|
|
||
| ## ستارههای گیت هاب در طول زمان | ||
|
|
||
| <a href="https://github.com/wailsapp/wails/stargazers"> | ||
| <img alt="نمودار تاریخچه ستارههای Wails" src="website/static/img/star-history.svg" width="800" /> | ||
| </a> | ||
|
|
||
| ## مشارکتکنندگان | ||
|
|
||
| تعداد مشارکتکنندگان پروژه آنقدر زیاد شده است که دیگر امکان قرار دادن فهرست همه آنها در README وجود ندارد. | ||
|
|
||
| همه افرادی که در توسعه پروژه مشارکت داشتهاند، در [صفحه مشارکتکنندگان](https://wails.io/credits#contributors) معرفی شدهاند. | ||
|
|
||
| ## مجوز | ||
|
|
||
| [](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) | ||
This file contains hidden or 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,120 @@ | ||
| <p align="center" style="text-align: center"> | ||
| <img src="./assets/images/logo-universal.png" width="55%"><br/> | ||
| </p> | ||
|
|
||
| <p align="center"> | ||
| Սեղանի հավելվածների ստեղծում Go-ի և վեբ տեխնոլոգիաների միջոցով։ | ||
| </p> | ||
|
|
||
| ## Բովանդակություն | ||
|
|
||
| - [Ներածություն](#ներածություն) | ||
| - [Հնարավորություններ](#հնարավորություններ) | ||
| - [Զարգացման ճանապարհային քարտեզ](#զարգացման-ճանապարհային-քարտեզ) | ||
| - [Սկսել աշխատանքը](#սկսել-աշխատանքը) | ||
| - [Հովանավորներ](#հովանավորներ) | ||
| - [Հաճախ տրվող հարցեր](#հաճախ-տրվող-հարցեր) | ||
| - [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) տարբերակների համար։ | ||
|
|
||
| ## Հովանավորներ | ||
|
|
||
| Նախագիծը աջակցվում է այն մարդկանց և ընկերությունների կողմից, որոնք նպաստում են դրա զարգացմանը։ | ||
|
|
||
| <img src="website/static/img/sponsors.svg" style="width:100%;max-width:800px;"/> | ||
|
|
||
| ## Powered By | ||
|
|
||
| [](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-ի աստղերը ժամանակի ընթացքում | ||
|
|
||
| <a href="https://github.com/wailsapp/wails/stargazers"> | ||
| <img alt="Wails-ի աստղերի պատմության գրաֆիկ" src="website/static/img/star-history.svg" width="800" /> | ||
| </a> | ||
|
|
||
| ## Մասնակիցներ | ||
|
|
||
| Մասնակիցների ցանկն այնքան է մեծացել, որ այն այլևս հնարավոր չէ ամբողջությամբ տեղադրել README-ում։ | ||
|
|
||
| Բոլոր այն մարդիկ, ովքեր ներդրում են ունեցել նախագծի զարգացման գործում, ներկայացված են [մասնակիցների էջում](https://wails.io/credits#contributors)։ | ||
|
|
||
| ## Լիցենզիա | ||
|
|
||
| [](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) | ||
|
Rayiumir marked this conversation as resolved.
|
||
| - [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) | ||
This file contains hidden or 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
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.