নমুনা অবদান

ব্লকলি নমুনাগুলিতে ব্লকলি সম্পর্কিত অতিরিক্ত সামগ্রী রয়েছে যা প্লাগইন, কোডল্যাব এবং উদাহরণ কোড সহ মূল সংগ্রহস্থলের অংশ নয়৷ এগুলির প্রতিটি সম্পর্কে আরও বিশদ বিবরণের জন্য, সংগ্রহস্থলের কাঠামো পৃষ্ঠাটি দেখুন।

জানা দরকার

এখানে ব্লকলি-নমুনা সম্পর্কে তথ্যগুলির একটি দ্রুত ওভারভিউ রয়েছে যা একটি PR তৈরি করার জন্য আপনাকে জানতে হবে।

  • কর্মরত শাখা মাস্টার এবং সমস্ত পিআর মাস্টারের বিরুদ্ধে করা উচিত।
  • ব্লকলি-স্যাম্পলের রুট লেভেলে npm install চালান, পৃথক প্লাগইন লেভেলে নয়। Blockly-samples হল একটি monorepo, যার অর্থ একই সংগ্রহস্থলে একাধিক প্যাকেজ রয়েছে এবং রুট স্তরে ইনস্টল করা Lerna-এর সাথে মনোরেপো পরিচালনার জন্য কর্মপ্রবাহের অংশ।
  • কোডটি অবশ্যই ব্যবহৃত ভাষার উপর নির্ভর করে Google-এর জাভাস্ক্রিপ্ট স্টাইল গাইড বা টাইপস্ক্রিপ্ট স্টাইল গাইডের সাথে সঙ্গতিপূর্ণ হতে হবে।
  • আপনার প্রতিশ্রুতি বার্তাগুলিতে প্রচলিত প্রতিশ্রুতি ব্যবহার করুন এবং অনুরোধের শিরোনাম টানুন।

  • যেকোন নতুন কোড ফাইলের সাথে Apache License v2.0 এর উপসর্গ থাকতে হবে:

    /**
 *   @license
 *   Copyright <Current YYYY> Google LLC
 *   SPDX-License-Identifier: Apache-2.0
 */

একটি পরিবর্তন করুন এবং যাচাই করুন

  1. নির্ভরতা ইনস্টল করতে ব্লকলি-নমুনার রুট স্তরে npm install চালান।
  2. প্লাগইনের পরীক্ষার পৃষ্ঠায় চলমান একটি সার্ভার তৈরি এবং শুরু করতে একটি প্লাগইন ডিরেক্টরিতে npm run start চালান। আপনি একটি প্লাগইনের বিদ্যমান আচরণ দেখতে এই পৃষ্ঠাটি ব্যবহার করতে পারেন, অথবা যদি আপনি একটি নতুন প্লাগইন যোগ করেন তবে আপনাকে এটি একটি দরকারী পরীক্ষা পৃষ্ঠা তৈরি করতে হবে যাতে অন্যরা দেখতে পারে আপনার প্লাগইন কি করে৷ আরও তথ্যের জন্য খেলার মাঠ পৃষ্ঠা দেখুন।
  3. প্লাগইনের কোডে যেকোনো প্রয়োজনীয় পরিবর্তন করুন।
  4. আপনি সার্ভার চলমান রেখে থাকলে, আপনার পরিবর্তনগুলি স্বয়ংক্রিয়ভাবে লোড হবে৷ অন্যথায়, সার্ভারটি পুনরায় চালু করুন এবং প্লাগইনটি প্রত্যাশিতভাবে আচরণ করে এবং কনসোলে কোন ত্রুটি বা সতর্কতা নেই তা যাচাই করুন।
  5. npm run build চালান এবং নিশ্চিত করুন যে কোনও বিল্ড ত্রুটি নেই।
  6. test/ ডিরেক্টরিতে স্বয়ংক্রিয় মোচা পরীক্ষা লিখুন।
  7. স্বয়ংক্রিয় পরীক্ষা চালানোর জন্য npm run test চালান।
  8. npm run lint:fix । যেকোন অবশিষ্ট সতর্কতা বা ত্রুটির সমাধান করুন।
  9. অটোফরম্যাটার চালানোর জন্য npm run format চালান।
  10. সমস্ত পরীক্ষায় উত্তীর্ণ হলে, আপনি আপনার পরিবর্তনের সাথে মাস্টারের বিরুদ্ধে পিআর খুলতে প্রস্তুত।