در 4 دقیقه

به یک همیار پروژه منبع آزاد در Github تبدیل شوید

-div>

 عکس پروفایل نویسنده

@ jamie1023 نمودار نبول

نمودار سحابی یک پایگاه داده نمودار توزیع شده منبع باز است: https://github.com / vesoft-inc / nebula

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

اگر حساب GitHub ندارید یا از Git مطمئن نیستید ، لطفاً ابتدا به وب سایت رسمی مراجعه کنید.

در به طور کلی ، 9 مرحله برای مشارکت در یک پروژه منبع باز وجود دارد:

  • انبار را به حساب GitHub خود منتقل کنید
  • شبیه سازی repo را در دستگاه محلی خود انجام دهید
  • تعریف قلاب قبل از تعهد
  • ایجاد شاخه
  • بررسی کد و سبک اسناد
  • توسعه
  • تغییرات فشار به repo GitHub
  • ایجاد درخواست جلب
  • بررسی یک کد

    در زیر جزئیات تصویر گام به گام آورده شده است.

    چگونه می توان یک مشارکت کننده در GitHub بود

    Fork the Repo

    با کلیک بر روی دکمه انبار نمودار سحابی ، انشعاب کنید دکمه چنگال در بالای صفحه اصلی. با این کار نسخه ای از این مخزن در حساب شما ایجاد می شود.

    می توانید ببینید مخزن سحابی در لیست مخازن شماست. لطفاً توجه داشته باشید اطلاعاتی که این شاخه 117 تعهد پشت vesoft-inc: master است ، نشانگر احترام بین شاخه شما و استاد است. اگر فقط مخزن را فورک کردید ، اطلاعات باید این شاخه حتی با vesoft-inc باشد: master.

    <" = "p"> > “” = “>” شبیه سازی Repo

    مخزن را در دستگاه محلی خود شبیه سازی کنید. روی دکمه Clone یا بارگیری کلیک کنید و سپس نماد کپی به کلیپ بورد را کلیک کنید. به repo از راه دور شما در Github مبدا گفته می شود.

    دستور زیر را باز کنید: <زیر <و> دستور زیر را باز کنید: <زیر را بسازید: < class = "code-container" readability = "7"> it git clone “url you just copied”

    کجا ” url شما فقط کپی کرده اید ”(بدون علامت های نقل قول) url به مخزن Nebula Grap h است. برای بدست آوردن آدرس اینترنتی به تصویر قبلی مراجعه کنید. به عنوان مثال:

    it git clone git @ https: //github.com/nebula-package/nebula.git < / div>

    جایی که

    بسته بندی سحابی نام کاربری است.

    # افزودن بالادست
    sp cd $ working_dir / سحابی
    ~ از راه دور اضافه کردن بالادست https://github.com/vesoft-inc/nebula.git # هرگز به استاد بالادستی فشار نیاورید زیرا دسترسی نوشتاری ندارید
    sp از راه دور تنظیم کنید -url – فشار بالادست no_push # تأیید کنید که کنترل از راه دور شما منطقی است:
    # قالب مناسب: است
    # مبدا [email protected]: $ (کاربر) /nebula.git (واکشی)
    # مبدا [email protected]: $ (کاربر) /nebula.git (فشار)
    # بالادست https://github.com/vesoft-inc/nebula (واکشی)
    # بالادست بدون_ فشار (فشار)
    remote از راه دور git -v

    قلاب قبل از تعهد را تعریف کنید

    لطفاً قلاب پیش از انجام Nebula Graph را به .git. این قلاب تعهدات شما را در زمینه قالب بندی ، ساخت ، تولید سند و غیره بررسی می کند.

    تعریف قلاب Pre-Commit
    لطفاً قلاب Nebula Graph را از قبل انجام دهید و به فهرست .git خود پیوند دهید. این قلاب متعهدات شما را برای قالب بندی ، ساختمان ، تولید اسناد و غیره بررسی می کند. sp cd $ working_dir /nebula/.git/hooks
    ln -s ../../cpplint/bin/pre-commit.sh.

    ایجاد شاخه

    به فهرست مخزن Nebula Graph بروید و شاخه جدیدی به نام myfeature برای کار!

    sp cd سحابی // اگر چنگال خود را در حالی که ایجاد کردید ، مطمئن شوید که تغییرات بالادستی را در مخزن محلی خود قرار دهید
    it گرفتن بالادست
    ~ git checkout master
    it git rebase / master // یک شعبه از master ایجاد کنید و به شاخه خود بروید
    ~ git checkout -b myfeature

    کد و سبک مستندات را بررسی کنید

    شما می توانید ویژگی خود را پیاده سازی یا اصلاح کنید ، کد خود را در

    شعبه myfeature اکنون. لطفاً سبک راهنمای سبک Google ++ C و راهنمای سبک مستندات را دنبال کنید.

    ما از قالب clang-format برای قالب بندی کد استفاده می کنیم. توصیه می شود که آن را مطابق IDE / ویرایشگری که استفاده می کنید پیکربندی کنید. پیوندهای زیر نحوه پیکربندی قالب clang با vim / emacs / vscode را نشان می دهد.

    vim:

    https://github.com / rhysd / vim-clang-format

    emacs:

    https://github.com/llvm-mirror/clang/blob/ master / tools / clang-format / clang-format.el

    کد VS:

    https://code.visualstudio.com/ docs / cpp / cpp-ide # _code-formatting

    توسعه

    کد خود را ویرایش کنید و تغییرات را انجام دهید با دستور زیر.

    it git commit -m ‘ویژگی جدید’

    تغییر تغییرات در Repo

    هنگامی که آماده بررسی هستید (یا فقط برای ایجاد نسخه پشتیبان از خارج از سایت یا کار خود) ، شاخه خود را به چنگال خود فشار دهید

    github.com:

    it git push -f origin myfeature

    ایجاد Pul l درخواست

  • از چنگال خود در https://github.com/$user/nebula دیدن کنید (بدیهی است $ user را جایگزین کنید).
  • کلیک کنید دکمه مقایسه و کشیدن درخواست را در کنار شاخه myfeature خود قرار دهید.

    دریافت بررسی کد

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

    پس از تأیید و درخواست ادغام ، می توانید تغییرات را از بالادست به repo محلی خود را حذف کرده و شاخه (های) اضافی خود را حذف کنید.

    چگونه می توان یک کمک کننده نمودار سحابی بود

    شما می توانید با مشارکت در کد یا مستندات به یک همکار Nebula Graph تبدیل شوید. این بخش به شما نشان می دهد که چگونه می توانید doc را به عنوان مشارکت کننده ما مطرح کنید تصویر زیر doc toc را نشان می دهد و می توانید در هر پرونده .md doc تغییراتی ایجاد کنید. سند شروع را به عنوان مثال در نظر بگیرید.

    مثال: شروع کنید

    > “= 32 =” = “=” = “=” = “=” “> c =”> c = “> ccc>>” “> c =”> “> c =”> “> c =”> “> c =”> c = “> تصویر بالا ثبت تغییرات سند را نشان می دهد. می توانید جزئیات را اضافه کنید ، خطاها را برطرف کنید یا حتی کل سند را دوباره مرتب کنید تا منظم تر و خواناتر شود.

    لطفاً برای دیدن تمام اسناد نمودار سحابی به Documentation Toc مراجعه کنید.

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

    همچنین در اینجا منتشر شده است.