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

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

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

کدام مخزن؟

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

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

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

قدم به قدم

اینها مراحل کلی هستند که هر زمان که تغییری ایجاد کنید از آنها پیروی خواهید کرد.

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