چگونه میتوان در این پروژه همکاری نمود
# چگونه میتوان در این پروژه همکاری نمود
برای این کار کافیه شما git را روی سیستم خود نصب نمایید.
## نصب git روی سیستم
بر اساس سیستم عامل خود یکی از موارد زیر را باز نمایید.
در اکثر توزیعهای سیستم عامل لینوکس git به صورت دیفالت نصب است و نیاز نیست کار خاصی بکنید. اما اگر به هر دلیلی نیاز بود آن را نصب نمایید باید سرچ بزنید و کامند مناسب مربوط به آن توزیع را پیدا کنید. در ادامه کامند نصب مربوط به ند توزیع معروف قرار میگیرد.
## استفاده از git جهت توسعه پروژه هیدیفای
- ابتدا باید پروژه را fork کنید. برای این کار اگر قصد fork کردن پنل را دارید کامند زیر را اجرا کنید.
- اندکی صبر کنید تا فایلهای پروژه کپی شود.
ویندوز
- ابتدا به [اینجا](https://git-scm.com/download/win) بروید و نسخه مخصوص ویندوز را دانلود کنید. - سپس فایل دانلود شده را از حالت فشرده خارج نمایید و برای نصب آن را ارا نمایید.
![location-git-windows-download](https://github.com/hiddify/hiddify-config/assets/125398461/cd883726-f340-441c-bbca-df98f0389de2)
- سپس wizard نصب را تا انتها با next و yes دنبال کنید. پیشنهاد میشود تنظیمات دیفالت را تغییر ندهید.
![read-and-accept-git-license-agreement](https://github.com/hiddify/hiddify-config/assets/125398461/c8220a90-4f88-451f-ac60-ca6280feef20)
به صورت دیفالت محل نصب git در این مسیر است.
یعنی در مراحل بعد، پروژهها در این مسیر قرار میگیرند. کار تمام است.
- برای چک کردن ورژن `git` نصب شده، `command prompt` را باز نمایید و دستور زیر را اجرا کنید.
- به صورت دیفالت `git` در پوشه `Home` کاربر نصب میگردد.
مک
- ابتدا از [اینجا](https://sourceforge.net/projects/git-osx-installer/files/git-2.23.0-intel-universal-mavericks.dmg/download?use_mirror=autoselect) فایل نصب را دانلود کنید. - سپس آن را جارا نمایید. نصب خیلی سادهای دارد. - بعد از نصب برای چک کردن ورژن `git` نصب شده، `terminal` را باز نمایید و دستور زیر را اجرا کنید.لینوکس
در اکثر توزیعهای سیستم عامل لینوکس git به صورت دیفالت نصب است و نیاز نیست کار خاصی بکنید. اما اگر به هر دلیلی نیاز بود آن را نصب نمایید باید سرچ بزنید و کامند مناسب مربوط به آن توزیع را پیدا کنید. در ادامه کامند نصب مربوط به ند توزیع معروف قرار میگیرد.
**Debian/Ubuntu**
**Fedora**
**Arch**
در همه توزیعها git در مسیر Home کاربر نصب میگردد.
- برای چک کردن نسخه git نصب شده در ترمیال این دستور را اجرا کنید.
![Screenshot_20230807_172554](https://github.com/hiddify/hiddify-config/assets/125398461/b4730f3a-3f86-4792-8ccc-6a5789056c1d)
- حالا باید یک شاخه یا branch از پروژه درست کنید تا روی آن کار کنید. برای این کار ابتدا برای شاخه یک اسم انتخاب کنید. مثلا فرض کنیم اسم شاخه را `Hiddify-develop` انتخاب میکنیم. حالا دستورات زیر را اجرا کنید.
- حالا تغییرات مورد نظر خود را روی فایلها با استفاده از هر ابزاری اعمال کنید. توصیه میشود از `VSCode` استفاده نمایید.
- یادتون نره مسیر تمامی فایلها در پوشههای گفته شده در مرحله نصب است.
-
- حالا وقتی تغییرات مورد نظر خود را اعمال نمودید باید تغییرات را در `git` نیز ثبت کنید. بنابراین در ترمینال کامندهای زیر را به ترتیب اجرا نمایید.
- ابتدا با کامند زیر انجام تغییرات را به `git` اعلام کنید.
- سپس تغییرات را کامیت نمایید. نیاز است که در اینجا یک توضیح برای تغییرات اعلام نمایید.
مثلا اگر تغییرات مدنظر شما مربوط به بخش توسعه بات باشد میتوان چنین توضیحی نوشت.
هیچ مشکلی ندارد که توضیحات این بخش زیاد باشد و اتفاقا توصیه میشود تا جای ممکن توضیحات کامل و جامع باشد.
در این مرحله تغییرات با موفقیت وارد سیستم git شد. حالا باید تغییرات را به سمت GitHub بفرستید. برای این کار دستور زیر را اجرا کنید.
در اینجا مشخصات اکانت شما در گیتهاب پرسیده میشود. نیاز است `username` و `password` خود در گیتهاب را وارد نمایید.
- حالا وارد اکانت خود در گیتهاب شوید و پروژه فورک شده را باز نمایید.
مسیری به شکل زیر دارد:
**این برنامه با استفاده از [Flutter](https://flutter.dev/) و [Go](https://go.dev/) توسعه یافته است. برای اطلاعات بیشتر در خصوص توسعه میتوانید [دستورالعملهای مشارکت](https://github.com/hiddify/hiddify-next/blob/main/CONTRIBUTING.md) در پروژه ما را مطالعه نمایید.** *[HTML]: Hyper Text Markup Language *[W3C]: World Wide Web Consortium
`https://github.com//hiddify-next`
- حالا یک banner مشاهده میکنید که به شما اعلام میکند که branch شما از پروژه اصلی یک مرحله جلوتر است. برای اینکه تغییرات با پروژه اصلی merge یا ادغام شود `Contribute` را کلیک کنید و `Open a pull request` را بزنید.
- کار تمام است تغییرات به پروژه ارسال شد. حالا پس از تایید مدیر پروژه تغییرات شما به پروژه اضافه میگردد.
**این برنامه با استفاده از [Flutter](https://flutter.dev/) و [Go](https://go.dev/) توسعه یافته است. برای اطلاعات بیشتر در خصوص توسعه میتوانید [دستورالعملهای مشارکت](https://github.com/hiddify/hiddify-next/blob/main/CONTRIBUTING.md) در پروژه ما را مطالعه نمایید.** *[HTML]: Hyper Text Markup Language *[W3C]: World Wide Web Consortium
اخرین بروزرسانی:
29 ژوئن 2024