ساخت پروژه در گیت هاب GitHub

وب‌ سایت محبوب میزبانی کد GitHub، یک منبع عالی برای افرادی است که به دنبال توسعه نرم‌افزار در یک محیط باز و مشارکتی هستند، می باشد. GitHub راهی برای دانلود، استفاده و در نهایت مشارکت در پروژه شما برای افراد دیگر فراهم می کند و به شما امنیت بیشتری می دهد که بدانید یک نسخه از پروژتان در سرورهای خارجی GitHub ذخیره شده است. بنابراین هیچ وقت تمام کارهای خود را از دست نخواهید داد و می توانید همیشه یک نسخه دست نخورده از پروژه هایتان در اختیار داشته باشید.

علی رغم همه چیزهایی که GitHub ارائه می دهد، این ساده ترین منبع برای دستیابی به تازه واردان نیست. اگر با GitHub یا به طور کلی، کنترل نسخه آشنایی ندارید، ایجاد اولین پروژه GitHub و ایجاد اولین commit می تواند یک چالش باشد. تمام این موارد در آموزش گیت هاب به صورت مفصل مورد بررسی قرار گرفته اند و شما می توانید با مشاهده این آموزش، به صورت کامل گیت هاب را یاد بگیرید.

حتی اگر یک فرد مبتدی هستید که حساب GitHub ندارید، این مقاله شما را به نقطه ای می رساند که یک مخزن GitHub ایجاد کنید و اولین پروژه در گیت هاب را ساخته و با استفاده از آن فعالیت های خود را انجام دهید.

گردش کار GitHub Workflow

فرآیند انجام اولین تغییر در GitHub ممکن است طولانی و پیچیده به نظر برسد، اما هنگامی که محیط خود را به درستی تنظیم کردید، انجام فعالیت های بعدی بسیار ساده است. استفاده از GitHub به معنای دانلود سیستم کنترل نسخه Git و ایجاد دو مخزن است: یکی در وب سایت GitHub و دیگری در رایانه شما. پس از آن، روی پروژه خود همانطور که در مخزن محلی شما وجود دارد کار خواهید کرد. در حالی که به صورت دوره ای کار خود را به مخزن GitHub مربوطه خود متصل می کنید.

مخزن محلی شما از طریق Git با همتای GitHub خود ارتباط برقرار می کند، بنابراین ما با دانلود و پیکربندی نرم افزار کنترل نسخه Git شروع می کنیم. برای بررسی مفصل نصب گیت در سیستم عامل های مختلف می توانید مطالب زیر را مطالعه کنید:

• نصب گیت در ویندوز
• نصب گیت در مک
• نصب گیت در اوبونتو
• نصب گیت در لینوکس

نصب و راه اندازی Git

به http://git-scm.com/downloads بروید و Git را دانلود کنید. توجه داشته باشید، اگرچه معمولاً می‌توانید نسخه جدیدتری از Git را با ساختن آن از روی کد منبع دریافت کنید، اما گرفتن نسخه‌ای که برای دانلود بسته‌ بندی شده است بسیار سریع‌ تر و آسان‌ تر است. در حالی که Git دانلود می شود، اگر قبلاً پروژه در گیت هاب نداشتید یا حساب کاربری ندارید، این فرصت عالی برای ایجاد یک حساب GitHub است.

پس از پایان دانلود Git، باید به آن اطلاع دهید که چه کسی هستید، تا بتواند این اطلاعات را به تمام commits های شما اضافه کند. برنامه Mac’s Terminal را باز کنید (معمولاً در پوشه /Applications/Utilities یافت می شود) و دستور زیر را وارد کنید:

git config — global user.name “Name”

در مرحله بعد، آدرس ایمیلی را که باید به commit های شما اضافه کند به Git بگویید:

git config — global user.email “email@example.com”

اگرچه در حال حاضر ترفندهای دیگری برای پیکربندی Git وجود دارد (به عنوان مثال، می‌توانید به آن بگویید نام کاربری و رمز عبور GitHub شما را ذخیره کند تا نیازی به وارد کردن این اطلاعات نداشته باشید)، این تنها چیزی است که برای شروع ساخت پروژه در گیت هاب و استفاده از Git لازم است.

ساخت مخزن گیت هاب

GitHub هر پروژه را در مخزن آنلاین خود ذخیره می کند، بنابراین قدم بعدی ایجاد این مخزن است. مرورگر وب انتخابی خود را باز کنید، وارد حساب GitHub شوید و کارهای زیر را انجام دهید (آموزش ساخت مخزن گیت هاب):

• در گوشه سمت راست بالای GitHub، روی نماد «+» کلیک کنید و «مخزن جدید» را انتخاب کنید.
• به مخزن خود یک نام بدهید و یک توضیح وارد کنید.
• تصمیم بگیرید که مخزن شما باید عمومی باشد یا خصوصی. در بیشتر موارد، شما می‌خواهید که مخزن شما عمومی باشد، بنابراین افراد دیگر می‌توانند آن را مشاهده کنند، استفاده کنند و حتی ممکن است در آن مشارکت داشته باشند. مخازن خصوصی فقط برای شما و سایر افرادی که به مخزن اضافه می کنید قابل مشاهده هستند. اگر می‌خواهید یک مخزن خصوصی ایجاد کنید، باید یک حساب «Micro» یا بالاتر تهیه کنید. در زمان نوشتن، یک حساب Micro 7.00 دلار در ماه هزینه دارد.
• با باز کردن منوی کشویی «افزودن مجوز» مجوز پروژه خود را انتخاب کنید. اگر مطمئن نیستید که کدام مجوز برای شما مناسب است، Choose a License اطلاعات مفید زیادی در مورد گزینه های مختلف مجوز دارد.
• شما متوجه گزینه “Initialize this repository with a README” خواهید شد. هر پروژه GitHub به یک فایل README نیاز دارد، زیرا این اولین جایی است که کاربران و مشارکت کنندگان، در آن به دنبال اطلاعات در مورد پروژه شما می گردند. از آنجایی که این فایل بسیار مهم است، GitHub پیشنهاد می کند آن را به صورت خودکار برای شما ایجاد کند. فقط کافی است «Initialize this repository…» را انتخاب کنید و GitHub یک فایل خالی README تولید می کند، بنابراین تنها کاری که باید انجام دهید این است که متنی را در این بخش وارد کنید. به طور معمول، انتخاب این گزینه منطقی است، زیرا به هر حال باید یک فایل README ایجاد کنید. با این حال، ایجاد، افزودن و انجام یک فایل README به صورت دستی، مقدمه خوبی برای گردش کار GitHub است. بنابراین این دقیقاً همان کاری است که ما در این آموزش انجام خواهیم داد. «Initialize this repository….» را خالی بگذارید، اما توجه داشته باشید که وقتی می‌خواهید مخازن بعدی را ایجاد کنید، GitHub می‌تواند فایل README شما را برای شما تولید کند.
• روی «ایجاد مخزن» کلیک کنید. اکنون یک مخزن GitHub خالی دارید و می توانید فعالیت های دیگر را انجام دهید.

ساخت فایل README.md در گیت هاب

به عنوان یک کاربر GitHub، بیشتر وقت خود را صرف کار روی پروژه در یک مخزن محلی خواهید کرد و کار را در فواصل زمانی منظم به مخزن مربوطه GitHub پروژه اضافه (commit) خواهید کرد. در این بخش، با ایجاد یک فایل README.md، این commit را برای اولین بار تجربه خواهید کرد.

قبل از شروع، باید یک مخزن کد محلی ایجاد کنید، که اساساً فقط یک پوشه است که در آن پروژه خود را ذخیره خواهید کرد. برای اهداف این آموزش، ما از یک پوشه “NewRepo” در دسکتاپ خود استفاده خواهم کرد، اما شما می توانید از نام پوشه و مکان متفاوتی استفاده کنید. فقط توجه داشته باشید که دستورات Git کمی متفاوت خواهد بود.

ترمینال خود را باز کنید و دایرکتوری پیش فرض را طوری تغییر دهید که به سمت مخزن/پوشه محلی شما باشد. این کار تضمین می کند که ترمینال به طور خودکار تمام دستورات شما را در پوشه “NewRepo” اعمال کند، بدون اینکه مجبور باشید هر بار مسیر کامل آن را تایپ کنید. برای ایجاد تغییر مورد نظر، دستور «cd» («تغییر دایرکتوری») را اجرا کنید، به‌عنوان مثال مسیر مخزن محلی خود را دنبال کنید:

cd /Users/amirrasooli/Desktop/NewRepo

در این مرحله، “NewRepo” هنوز فقط یک پوشه بی فایده در رایانه شما است. برای تبدیل “NewRepo” به یک مخزن محلی، باید یک زیرشاخه .git ایجاد کنید که حاوی تمام ابرداده های مخزن شما باشد. این کار نیز ممکن است پیچیده به نظر برسد، اما در واقع با اجرای یک فرمان انجام می شود:

git init

پوشه “NewRepo” شما اکنون یک مخزن اولیه است که این قدرت را دارد تا محتویات خود را مستقیماً در یک مخزن GitHub ارسال کند. با این حال، هنوز به مخزن محلی خود نگفتید که با کدام مخزن GitHub باید ارتباط برقرار کند. برای اینکه به مخزن محلی خود در مورد معادل GitHub بگویید، موارد زیر را اجرا کنید:

git remote add origin https://github.com/your_username/repo_name.git

user_name را با نام کاربری GitHub خود جایگزین کنید و repo_name را با مخزنی که می خواهید commit های خود را به آن بفرستید جایگزین کنید، به عنوان مثال:

git remote add origin https://github.com/amirrasooli/newrepo.git

از این مرحله به بعد، مخزن محلی شما به خاطر می‌آورد که به کدام مخزن GitHub نیاز دارد تا تغییراتی را ارسال کند، بنابراین نیازی به اجرای مجدد «افزودن از راه دور» ندارید. در حال حاضر، شما هنوز چیزی برای کامیت ندارید، بنابراین مرحله بعدی ایجاد فایل README است:

touch README.md

«touch» به سادگی به معنای «ایجاد» است، بنابراین اگر می‌خواهید فایل‌های بیشتری را به پروژه خود اضافه کنید، اکنون زمان مناسبی است، برای مثال:

touch CONTRIBUTING.md

touch LICENSE.md

touch USER GUIDE.md

مطالب مرتبط: گیت LFS چیست؟

پوشه “NewRepo” را بررسی کنید، مشاهده خواهید کرد که یک فایل README.md ظاهر شده است. این فایل را باز کنید و هر متنی را که می خواهید با استفاده از ویرایشگر متن معمولی خود اضافه کنید.

هنگامی که آماده انجام کار هستید، باید با استفاده از دستور “git add” به Git اطلاع دهید که کدام فایل ها را باید در commit قرار دهد. وقتی فایلی را «git add» می‌کنید، به Git می‌گویید که این فایل را به یک ناحیه مرحله‌ بندی اضافه کند، که مانند یک داک بارگیری است و در آن فایل‌هایی را که قرار است به GitHub ارسال شوند، انتخاب می‌کنید. همه فایل‌های جدید و هر فایل موجودی که به‌روزرسانی کرده‌اید، قبل از اینکه بتوانید آن‌ها را به GitHub اختصاص دهید، باید «مرحله‌سازی» شوند. برای مرحله بندی فایل README، دستور زیر را اجرا کنید:

git add README.md

اگر علاوه بر README.md فایل‌های بیشتری ایجاد کرده‌اید، مطمئن شوید که این فایل‌ها را نیز «git add» کنید. هنگامی که به Git گفتید که کدام فایل ها را باید در commit بعدی خود قرار دهد، باید در واقع commit گفته شده را ایجاد کنید:

git commit -m “creating a README.md file”

بخش ‘git commit’ این دستور به خودی خود توضیحی است، اما بخش دوم به Git اجازه می دهد تا بداند که یک پیام log به همراه این commit (-m) و به دنبال آن خود پیام log (در این مثال، “ایجاد یک فایل README.md”). یک پیام گزارش تغییراتی را که در commit گنجانده شده است را توصیف می‌کند، که در صورت نیاز به جستجو در تاریخچه پروژه خود برای زمانی که یک تغییر خاص رخ داده است، بسیار مهم خواهد بود. اگر در پروژه‌ای با افراد دیگر همکاری می‌کنید، پیام‌های کامیت، راهی برای اطمینان از اینکه همه می‌دانند در کل پروژه چه می‌گذرد، هستند.

مرحله آخر ارسال این commit به مخزن GitHub است. همانطور که پروژه خود را توسعه می دهید، به احتمال زیاد چندین branches ایجاد خواهید کرد، اما همیشه یک شاخه اصلی یا “master” خواهید داشت که نشان دهنده نسخه پایدار پروژه شما است. از آنجایی که هنوز هیچ شاخه ای ایجاد نکرده اید، این مرحله بعدی بسیار ساده است، زیرا تنها گزینه شما ارسال commit به شاخه اصلی است:

git push -u origin master

نام کاربری و رمز عبور GitHub خود را وارد کنید و Git README.md را به مخزن GitHub شما منتقل می کند. برای بررسی اینکه همه چیز به خوبی پیش رفته است، مرورگر خود را باز کنید و به مخزن GitHub خود بروید. اکنون حاوی فایل README.md شما خواهد بود.

جمع بندی مطلب

در این مقاله از سری آموزش های گیت، آموزش ساخت پروژه در گیت هاب را مورد بررسی قرار دادیم. در این آموزش نحوه ساخت پروژه در گیت هاب از صفر تا صد مورد بررسی قرار گرفت و در حال حاضر شما می توانید هر نوع پروژه در گیت هاب را بسازید و با گزینه های بیشتری در گیت هاب کار کنید. در نظر داشته باشید که برای تسلط کامل بر روی گیت و گیت هاب، بهتر است که از بخش آموزش های سایت امیر رسولی، آموزش گیت و گیت هاب را تهیه و مشاهده کنید.