|
| 1 | +# گیتی |
| 2 | + |
| 3 | +[](https://github.com/go-gitea/gitea/actions/workflows/release-nightly.yml?query=branch%3Amain "Release Nightly") |
| 4 | +[](https://discord.gg/Gitea "Join the Discord chat at https://discord.gg/Gitea") |
| 5 | +[](https://goreportcard.com/report/code.gitea.io/gitea "Go Report Card") |
| 6 | +[](https://pkg.go.dev/code.gitea.io/gitea "GoDoc") |
| 7 | +[](https://github.com/go-gitea/gitea/releases/latest "GitHub release") |
| 8 | +[](https://www.codetriage.com/go-gitea/gitea "Help Contribute to Open Source") |
| 9 | +[](https://opencollective.com/gitea "Become a backer/sponsor of gitea") |
| 10 | +[](https://opensource.org/licenses/MIT "License: MIT") |
| 11 | +[](https://gitpod.io/#https://github.com/go-gitea/gitea) |
| 12 | +[](https://translate.gitea.com "Crowdin") |
| 13 | + |
| 14 | +[English](./README.md) | [繁體中文](./README.zh-tw.md) | [简体中文](./README.zh-cn.md) |
| 15 | + |
| 16 | +## هدف |
| 17 | + |
| 18 | +هدف این پروژه، ساختن آسانترین، سریعترین و کمدردسرترین راه برای ارائهٔ خدمت خودمیزبانی گیت است. |
| 19 | + |
| 20 | +گیتی به زبان گو نوشته شده و در **تمام** سکوها و معماریهایی که تحت پشتیبانی گو هستند، مثل گنو+لینوکس، مکاواس و ویندوز بر روی معماریهای ۳۲بیتی، ۶۴بیتی، آرم و پاورپیسی پشتیبانی میشود. |
| 21 | +این پروژه، از پروژهٔ [Gogs](https://gogs.io)، [انشعاب گرفته شده](https://blog.gitea.com/welcome-to-gitea/) و پس از آن، به شدّت تغییر کرده است. |
| 22 | + |
| 23 | +برای نمونهٔ برخط، [demo.gitea.com](https://demo.gitea.com) را مشاهده کنید. |
| 24 | + |
| 25 | +برای دسترسی به خدمت رایگان گیتی (با تعداد محدودی مخزن) میتوانید به [gitea.com](https://gitea.com/user/login) مراجعه کنید. |
| 26 | + |
| 27 | +برای استقرار سریع مخزن گیتی اختصاصی شما بر روی فضای ابری گیتی، [cloud.gitea.com](https://cloud.gitea.com) را ببینید. |
| 28 | + |
| 29 | +## مستندات |
| 30 | + |
| 31 | +شما میتوانید مستندات جامع ما را در [وبگاه رسمی مستندات گیتی](https://docs.gitea.com/)، دنبال کنید. |
| 32 | + |
| 33 | +مستندات ما، شامل نصب، مدیریت، استفاده، توسعه، راهنمای مشارکت و غیره است تا به شما در شروع گشتوگذار تمامی ویژگیها، به طور مؤثر، کمک کند. |
| 34 | + |
| 35 | +اگر پیشنهادی در این رابطه دارید و یا میخواهید که به مستندات، مشارکت کنید، آدرس [documentation repository](https://gitea.com/gitea/docs) را پیگیری کنید. |
| 36 | + |
| 37 | +## ساختن |
| 38 | + |
| 39 | +از شاخهٔ ریشهٔ کدمنبع، دستور زیر را اجرا کنید: |
| 40 | + |
| 41 | + TAGS="bindata" make build |
| 42 | + |
| 43 | +یا اگر پشتیبانی از SQLite را نیاز دارید، دستور زیر را اجرا کنید: |
| 44 | + |
| 45 | + TAGS="bindata sqlite sqlite_unlock_notify" make build |
| 46 | + |
| 47 | +هدف ساختن، به دو زیرهدف تقسیم شده است: |
| 48 | + |
| 49 | +- `make backend` که نیازمند [گولنگ پایدار](https://go.dev/dl/) است. نسخهٔ مورد نیاز، در پروندهٔ [go.mod](/go.mod تعریف شده است. |
| 50 | +- `make frontend` که نیازمند [نود جیاس LTS](https://nodejs.org/en/download/ یا بالاتر است. |
| 51 | + |
| 52 | +اتّصال اینترنتی برای بارگیری پیمانههای گو و npm، مورد نیاز است. هنگام ساختن از بایگانی بانهای رسمی، که پروندههای ساخته شدهٔ فرانتاند را داراست، هدف `frontend` اجرا نمیشود و ساختن میتواند بدون نیاز به نود جیاس، انجام شود. |
| 53 | + |
| 54 | +اطّلاعات بیشتر: https://docs.gitea.com/installation/install-from-source |
| 55 | + |
| 56 | +## استفاده |
| 57 | + |
| 58 | +بعد از ساختن، به طور پیشفرض، یک پروندهٔ دوگانی به نام `gitea` در ریشهٔ درخت کدمنبع، ساخته میشود. برای اجرای آن، از دستور |
| 59 | + |
| 60 | + ./gitea web |
| 61 | + |
| 62 | +استفاده کنید. |
| 63 | + |
| 64 | +> [!نکته] |
| 65 | +> اگر به استفاده از APIهای ما علاقهمندید، ما پشتیبانی تجربی را در [مستندات مربوطه](https://docs.gitea.com/api)، شرح دادهایم. |
| 66 | +
|
| 67 | +## مشارکت |
| 68 | + |
| 69 | +روال مورد انتظار، انشعابگیری، وصله کردن، اعمال و بعد درخواست ادغام است. |
| 70 | + |
| 71 | +> [!نکته] |
| 72 | +> |
| 73 | +> ۱. **شما باید [راهنمای مشارکت](CONTRIBUTING.md) را قبل از کار کردن بر روی یک درخواست ادغام، مطالعه کنید.** |
| 74 | +> ۲. اگر شما یک آسیبپذیری در پروژه یافتید، لطفاً به شکل محرمانه آن را به **[email protected]**، بفرستید. متشکریم! |
| 75 | +
|
| 76 | +## ترجمه |
| 77 | + |
| 78 | +[](https://translate.gitea.com) |
| 79 | + |
| 80 | +ترجمههای از طریق سکّوی [Crowdin](https://translate.gitea.com) انجام میشوند. اگر میخواهید که به زبان جدیدی ترجمه کنید، از یکی از مدیران پروژه در Crowdin، بخواهید که زبان جدیدی به این سکّو، اضافه کند. |
| 81 | + |
| 82 | +شما همچنین میتوانید که یک مشکل جدید ایجاد کنید و یا در بخش #translation در دیسکورد، درخواست افزودن زبان جدید را، مطرح کنید. اگر به مشکلات محتوایی یا مشکل در ترجمه برخوردید، میتوانید بر روی همان رشته نظر خود را قرار داده و یا در دیسکورد، مطرح نمایید. برای سؤالات عمومی در رابطه با ترجمه، یک بخش در مستندات وجود دارد ولی در حال حاضر، تکمیل نشده و ما امیدواریم که در آینده با افزودن سؤالات جدید مشارکتکنندگان به آن، آن بخش را تکمیل کنیم. |
| 83 | + |
| 84 | +برای اطّلاعات بیشتر در بحث ترجمه، [مستندات](https://docs.gitea.com/contributing/localization) ما را ببینید. |
| 85 | + |
| 86 | +## پروژههای رسمی و شخص ثالث |
| 87 | + |
| 88 | +ما [رابط کاربری توسعهٔ گولنگمحور](https://gitea.com/gitea/go-sdk)، یک ابزار رابط کاربری خط فرمان به نام [tea](https://gitea.com/gitea/tea) و همچنین یک [اجرا کنندهٔ «کنش گیتی»](https://gitea.com/gitea/act_runner) برای کنشهای گیتی داریم. |
| 89 | + |
| 90 | +ما لیستی از پروژههای مرتبط با گیتی را در مخزن [gitea/awesome-gitea](https://gitea.com/gitea/awesome-gitea) نگهداری میکنیم. در آنجا شما میتوانید پروژههای شخص ثالث بیشتری مثل رابط کاربری توسعه، افزونهها و زمینهها را بیابید. |
| 91 | + |
| 92 | +## ارتباط |
| 93 | + |
| 94 | +[](به گفتگوی دیسکورد ما در https://discord.gg/Gitea بپیوندید!) |
| 95 | + |
| 96 | +اگر هر سؤالی دارید که در [مستندات](https://docs.gitea.com/) پوشش داده نشده، با ما در [دیسکورد](https://discord.gg/Gitea) ارتباط بگیرید و یا یک فرسته در [تالار گفتگوی دیسکورس ما](https://forum.gitea.com/) بفرستید. |
| 97 | + |
| 98 | +## سازندگان |
| 99 | + |
| 100 | +- [نگهدارندگان](https://github.com/orgs/go-gitea/people) |
| 101 | +- [مشارکتکنندگان](https://github.com/go-gitea/gitea/graphs/contributors) |
| 102 | +- [مترجمان](options/locale/TRANSLATORS) |
| 103 | + |
| 104 | +## پشتیبانهای مالی |
| 105 | + |
| 106 | +از تمامی پشتیبانهای مالیمان تشکّر میکنیم! 🙏 [[پشتیبان ما شوید!](https://opencollective.com/gitea#backer)] |
| 107 | + |
| 108 | +<a href="https://opencollective.com/gitea#backers" target="_blank"><img src="https://opencollective.com/gitea/backers.svg?width=890"></a> |
| 109 | + |
| 110 | +## حامیان مالی |
| 111 | + |
| 112 | +با حامی شدن، پروژهٔ گیتی را حمایت کنید. در اینجا، نماد شما به همراه پیوندی به وبگاه شما، نمایان میشود. [[حامی شوید!](https://opencollective.com/gitea#sponsor)] |
| 113 | + |
| 114 | +<a href="https://opencollective.com/gitea/sponsor/0/website" target="_blank"><img src="https://opencollective.com/gitea/sponsor/0/avatar.svg"></a> |
| 115 | +<a href="https://opencollective.com/gitea/sponsor/1/website" target="_blank"><img src="https://opencollective.com/gitea/sponsor/1/avatar.svg"></a> |
| 116 | +<a href="https://opencollective.com/gitea/sponsor/2/website" target="_blank"><img src="https://opencollective.com/gitea/sponsor/2/avatar.svg"></a> |
| 117 | +<a href="https://opencollective.com/gitea/sponsor/3/website" target="_blank"><img src="https://opencollective.com/gitea/sponsor/3/avatar.svg"></a> |
| 118 | +<a href="https://opencollective.com/gitea/sponsor/4/website" target="_blank"><img src="https://opencollective.com/gitea/sponsor/4/avatar.svg"></a> |
| 119 | +<a href="https://opencollective.com/gitea/sponsor/5/website" target="_blank"><img src="https://opencollective.com/gitea/sponsor/5/avatar.svg"></a> |
| 120 | +<a href="https://opencollective.com/gitea/sponsor/6/website" target="_blank"><img src="https://opencollective.com/gitea/sponsor/6/avatar.svg"></a> |
| 121 | +<a href="https://opencollective.com/gitea/sponsor/7/website" target="_blank"><img src="https://opencollective.com/gitea/sponsor/7/avatar.svg"></a> |
| 122 | +<a href="https://opencollective.com/gitea/sponsor/8/website" target="_blank"><img src="https://opencollective.com/gitea/sponsor/8/avatar.svg"></a> |
| 123 | +<a href="https://opencollective.com/gitea/sponsor/9/website" target="_blank"><img src="https://opencollective.com/gitea/sponsor/9/avatar.svg"></a> |
| 124 | + |
| 125 | +## سؤالات پرتکرار |
| 126 | + |
| 127 | +**گیتی را چگونه تلفّظ میکنید؟** |
| 128 | + |
| 129 | +گیتی به شکل [/ɡɪ’ti:/](https://youtu.be/EM71-2uDAoY) تلفّظ میشود. |
| 130 | + |
| 131 | +**چرا خود این پروژه بر روی یک نمونهٔ گیتی، میزبانی نمیشود؟** |
| 132 | + |
| 133 | +ما مشغول [کار بر روی آن](https://github.com/go-gitea/gitea/issues/1029)، هستیم. |
| 134 | + |
| 135 | +**کجا میتوانم وصلههای امنیتی را بیابم؟** |
| 136 | + |
| 137 | +در [گزارش انتشار](https://github.com/go-gitea/gitea/releases)، [گزارش تغییرات](https://github.com/go-gitea/gitea/blob/main/CHANGELOG.md) و یا با جستجو کردن کلیدواژهٔ `SECURITY`، میتوانید وصلههای امنیتی را پیدا کنید. |
| 138 | + |
| 139 | +## پروانه |
| 140 | + |
| 141 | +این پروژه تحت پروانهٔ MIT ارائه میشود. |
| 142 | +پروندهٔ [LICENSE](https://github.com/go-gitea/gitea/blob/main/LICENSE) را برای متن کامل پروانه، مشاهده کنید. |
| 143 | + |
| 144 | +## اطّلاعات بیشتر |
| 145 | + |
| 146 | +<details> |
| 147 | +<summary>به دنبال تصاویری از رابط کاربری گیتی هستید؟ این بخش را ببینید!</summary> |
| 148 | + |
| 149 | +### صفحهٔ ثبتنام و ورود |
| 150 | + |
| 151 | + |
| 152 | + |
| 153 | + |
| 154 | +### پنل کاربری |
| 155 | + |
| 156 | + |
| 157 | + |
| 158 | + |
| 159 | + |
| 160 | + |
| 161 | +### نمایهٔ کاربر |
| 162 | + |
| 163 | + |
| 164 | + |
| 165 | +### کاوش |
| 166 | + |
| 167 | + |
| 168 | + |
| 169 | + |
| 170 | + |
| 171 | +### مخزن |
| 172 | + |
| 173 | + |
| 174 | + |
| 175 | + |
| 176 | + |
| 177 | + |
| 178 | + |
| 179 | + |
| 180 | + |
| 181 | +#### مشکلات مخزن |
| 182 | + |
| 183 | + |
| 184 | + |
| 185 | + |
| 186 | +#### درخواستهای ادغام مخزن |
| 187 | + |
| 188 | + |
| 189 | + |
| 190 | + |
| 191 | + |
| 192 | + |
| 193 | +#### کنشهای مخزن |
| 194 | + |
| 195 | + |
| 196 | + |
| 197 | + |
| 198 | +#### فعّالیّتهای مخزن |
| 199 | + |
| 200 | + |
| 201 | + |
| 202 | + |
| 203 | + |
| 204 | + |
| 205 | +### سازمان |
| 206 | + |
| 207 | + |
| 208 | + |
| 209 | +</details> |
0 commit comments