مشارکت در Blockly را شروع کنید

Blockly متن‌باز است و عمدتاً توسط یک تیم کوچک نگهداری می‌شود. ما از مشارکت توسعه‌دهندگان خارج از تیم اصلی استقبال می‌کنیم؛ بدون جامعه خود، هیچ راهی برای ساخت هر ویژگی درخواستی یا رفع هر اشکال گزارش‌شده وجود ندارد. این بخش شامل راهنماهای کلی است که ممکن است برای شما مفید باشد، به‌ویژه اگر در توسعه متن‌باز تازه‌کار هستید.

برای اطلاعات خاص Blockly که باید قبل از مشارکت مطالعه کنید، به بخش‌های مشارکت در هسته و مشارکت در نمونه‌ها مراجعه کنید.

کدام مخزن؟

یک مخزن شامل تمام فایل‌های یک پروژه واحد است. Blockly دو مخزن دارد: blockly core و blockly-samples.

هسته Blockly مخزن کتابخانه Blockly است. اگر می‌خواهید تغییری در رفتار هسته Blockly ایجاد کنید که برای همه کاربران کتابخانه اعمال شود، از این مخزن استفاده کنید.

نمونه‌های Blockly مخزنی برای نمونه‌ها، افزونه‌ها و آزمایشگاه‌های کد است. اگر می‌خواهید یک افزونه ایجاد یا اصلاح کنید؛ یک آزمایشگاه کد بنویسید؛ یا یک نمونه ایجاد یا اصلاح کنید، از این مخزن استفاده کنید.

گام به گام

اینها مراحل کلی هستند که هر زمان که تغییری ایجاد می‌کنید، دنبال خواهید کرد.

  1. گیت و نود را با دنبال کردن لینک‌های موجود در بخش ابزارها نصب کنید .
  2. مخزن را فورک و کلون کنید. گیت‌هاب یک آموزش فوق‌العاده در مورد فورک کردن یک مخزن دارد. برای اعمال آن به blockly، فقط هر نمونه از octocat/Spoon-Knife را با RaspberryPiFoundation/blockly یا RaspberryPiFoundation/blockly-samples ، بسته به اینکه می‌خواهید در کدام مخزن کار کنید، جایگزین کنید.
  3. چنگال خود را همگام‌سازی کنید. گیت‌هاب یک آموزش برای همگام‌سازی چنگال نیز ارائه می‌دهد.
  4. به شاخه اصلی (main branch) نگاهی بیندازید. در blockly core، این شاخه develop است. در blockly-samples، این شاخه master است.
  5. با اجرای دستور npm install در دایرکتوری ریشه، وابستگی‌ها را نصب کرده و ابزارها را بسازید.
  6. با اجرای دستور git checkout -b myBranchName در ترمینال، یک شاخه جدید ایجاد کنید . نام شاخه باید به شما کمک کند تا به خاطر بیاورید روی چه چیزی کار می‌کنید.
  7. تغییرات خود را اعمال کنید.
  8. تغییرات خود را با دنبال کردن راهنمای مربوط به هسته یا نمونه‌ها ، اعتبارسنجی کنید.
  9. تغییرات خود را با git commit -am "fix: My commit message" ذخیره کنید. درباره پیام‌های commit بیشتر بخوانید .
  10. تغییرات خود را با git push origin myBranchName به گیت‌هاب ارسال کنید.
  11. وقتی کد شما آماده شد، یک درخواست pull باز کنید . یکی از اعضای تیم Blockly تغییرات شما را بررسی کرده و در صورت تأیید، آنها را در Blockly ادغام می‌کند. برای اطلاعات بیشتر به فرآیند بررسی PR مراجعه کنید.