উপরের লোগোটি তৈরি করেছেঃ CandidDeer 💖 এর সহিত।
আপনি কি আমাদের প্রকল্পে যুক্ত হয়ে আমাদের প্রকল্পটি পরিচালনা করতে এবং এটি বহাল রাখতে ইচ্ছুক?, তবে আমাদের পরিচালনা নির্দেশাবলি পরুন এবং আমাকে টুইটারে একটি বার্তা প্রেরণ করুন।
এই টিউটোরিয়ালটি অন্যান্য ভাষায়ও পাওয়া যাবে।
| ইংরেজি | বাংলা | | :---: | :---: | :---: |
আমাদের প্রকল্পের নথিগুলোর বিভিন্ন ভাষায় রুপান্তরকে আমরা আন্তরিকভাবে স্বাগত জানাই। অনুবাদ সম্বন্ধীয় অবদানের জন্যঃ
অনুবাদ সহায়ক-টি পরুন।
এখানে আমরা শিখব কিভাবে এই প্রজেক্টে অথবা GitHub/Git-এ টার্মিনাল এর মাধ্যমে অবদান রাখতে হয়। এটি গিটহাবে নতুনদের সহজ প্রকল্পে অংশগ্রহণ করতে সহায়তা করার জন্য একটি পথ প্রদর্শক।
- প্রস্তুতি!
- ধাপ ১ঃ এই রিপোজিটরি ফর্ক করুন
- ধাপ ২ঃ রিপোসিটরিটি ক্লোন করুন
- ধাপ ৩ঃ একটি নতুন শাখা তৈরি করুন
- ধাপ ৪ঃ index.html ফাইলটি খুলুন
- ধাপ ৫ঃ কার্ড এর টেম্পলেটটি কপি করুন
- ধাপ ৬ঃ প্রয়োজনীয় পরিবর্তন করুন
- ধাপ ৭ঃ আপনার পরিবর্তনগুলি কমিট করুন
- ধাপ ৮ঃ পরিবর্তনগুলো গিটহাবে পুশ করুন
- ধাপ ৯ঃ পুল রিকোয়েস্ট সাবমিট করুন
- ধাপ ১০ঃ আনন্দ উদযাপন করুন
- পরবর্তি ধাপসমুহ
- স্বীকৃতি
দ্রষ্টব্যঃ এই সহায়কটি টার্মিনাল এর জন্য নির্মান করা। আপনি যদি টার্মিনাল ব্যবহার করতে সাচ্ছন্দ্য বোধ না করেন এবং গ্রাফিকাল ইন্টারফেস এ কাজ করতে চান, তবে এখানে ক্লিক করুন।
এই সহজ ফ্রি সিরিজ এর মাধ্যমেও আপনি গিটহাব এর বিষয় জানতে পারবেনঃ কীভাবে গিটহাবের ওপেন সোর্স এ অবদান রাখতে হয়।
প্রথমে কাজটি করার জন্য প্রস্তুতি নেয়া যাক।
- আপনার যদি GIT না থাকে, তবে এখান থেকে ইন্সটল করে নিন।
- এখানে উদ্দেশ্য হল এই প্রকল্পের একটি অনুলিপি তৈরি করা এবং এটি আপনার অ্যাকাউন্টে রাখা।
- একটি রিপোজিটরি (রিপো) হল গিটহাবের একটি প্রকল্পক এবং একটি ফর্ক হল প্রকল্পের একটি অনুলিপি।
- নিশ্চিত করুন যে আপনি এই রিপোর মূল পৃষ্ঠায় আছেন।
| এই পৃষ্ঠার উপরের অংশে ফর্ক (fork) বাটনে ক্লিক করুন। |  |
|---|
-
এখন আপনার নিজের অ্যাকাউন্টে এই প্রকল্পের একটি সম্পূর্ণ অনুলিপি আছে।
এখন আমরা এই প্রকল্পের একটি স্থানীয় অনুলিপি করতে চাই। এটি আপনার নিজের কম্পিউটারে সংরক্ষিত একটি অনুলিপি।
- এখন আপনার মেশিনে এই রিপোটি ক্লোন করুন। ক্লোন বোতামে ক্লিক করুন এবং তারপর কপি টু ক্লিপবোর্ড আইকনে ক্লিক করুন।
- গিটহাবে হোস্ট করা প্রকল্পসমুহকে এক একটি রিপোজিটরি (রিপো) বলা হয় এবং একটি ফর্ক হল উক্ত রিপোর একটি অনুলিপি।
টার্মিনাল চালু করুন এবং নিচের কমান্ড/কোড টি লেখুন এবং কীবোর্ড এর Enter বোতাম চাপার মাধ্যমে কোডটি চালু করুন:
git clone "url you just copied"উদাহরনস্বরূপঃ
git clone https://github.com/$Username/Contribute-To-This-Project.gitযেখানে $Username হল আপনার গিটহাব একাউন্ট এর ইউজারনেম। এখানে আপনি গিটহাবে থাকা first-contributions রিপোটি আপনার কম্পিউটার এ ডাউনলোড করছেন।
- নিচের কোডটির মাধ্যমে টার্মিনালে আপনার রিপো এর ফোল্ডারটির ভেতরে যাওয়া যাবেঃ
cd Contribute-To-This-Project- এখন
git checkoutকোডটির সাহায্যে রিপোতে একটি শাখা খুলতে হবে। যার মধ্যে আমরা পরবর্তি পরিবর্তন সমুহ করব। সম্পুর্ন কোডটি হলঃ
git checkout -b your-new-branch-nameউদাহরনস্বরূপ:
git checkout -b add-$Username-cardদ্রষ্টব্যঃ $Username -টি আপনার গিটহাব ইউজারনেম দ্বারা পরিবর্তন করে নিন।
মাস্টার(master) শাখায় কাজ করবেন না।
-
মাস্টার(master)নামক প্রকল্পের মূল অংশ থেকে আপনার পরিবর্তনগুলিকে আলাদা রাখার একটি উপায় হল শাখা বা ব্রাঞ্চ (branch)। উদাহরণস্বরূপ, যদি কিছু ভুল হয়ে যায় এবং আপনি আপনার পরিবর্তনের সাথে খুশি না হন তবে আপনি কেবল শাখাটি বা ব্রাঞ্চটি মুছে ফেলতে পারেন এবং সেখানে মূল প্রকল্প প্রভাবিত হবে না। -
এখন আপনি
মাস্টার(master)থেকে আলাদা একটি নতুন শাখা তৈরি করেছেন। -
পরবর্তী পদক্ষেপের জন্য নিশ্চিত করুন যে আপনি এই শাখায় কাজ করছেন। আপনার কোড এডিটর এর নিচে বামদিকে আপনি যে শাখায় কাজ করছেন সে শাখার নাম লেখা থাকবে। যেমনঃ
$Username-card।
এখন আপনি যেই কোড এডিটর দিয়ে ফাইল সম্পাদনা করতে স্বাচ্ছন্দ্যবোধ করেন সেটি খুলতে হবে। আমাদের পছন্দের এডিটর হিসেবে আমরা VSCode ব্যাবহার করছি।
index.htmlফাইলটি সরাসরিContribute-To-This-Projectফোল্ডারে আছে।- ফোল্ডার এর ভেতর থাকাকালিন টার্মিনালে নিম্মের কোডটি চালনার মাধ্যমে এডিটরে
index.htmlফাইলটি খোলা যাবেঃ
code index.htmlদ্রষ্টব্যঃ এই টার্মিনাল কোডটি index.html ফাইলটি VSCode এর ভেতর চালু করবে।
-
এখন আপনি যে ফাইলটি সম্পাদনা করতে যাচ্ছেন সেটি আপনার কোড এডিটরে খোলা আছে এবং আপনি এটিতে পরিবর্তন আনার জন্য প্রস্তুত।
আমরা এটিতে কাজ শুরু করার জন্য কার্ড টেমপ্লেটের একটি অনুলিপি তৈরি করব:
htmlফাইলের উপরে,<head>এবং<header>বিভাগের অধীনে ৮৪ theke ১০৯ নং লাইনে আপনি== TEMPLATE ==লেবেলযুক্ত বিভাগটি পাবেন।Contributor card STARTকমেন্ট থেকেContributor card ENDকমেন্ট পর্যন্ত ছবিতে উল্লেখিত লাল বর্গক্ষেত্রের মধ্যে থাকা সবকিছু কপি করুন।
- ১১৬ নং লাইনের পরে যেখানে
Paste YOUR CARD directly BELOW this lineলেখা আছে তার সরাসরই নিচে কার্ড এর টেম্পলেটটি পেস্ট করুন। - আপনার কার্ডের শুরু এবং শেষে একটি কড়ে ফাঁকা লাইন নিশ্চিত করুন। আপনার কোডটি যতটা সম্ভব সুন্দর এবং পরিষ্কার রাখুন।
- কখনোই লিন্টার বা স্টাইল ফরম্যাটার ব্যবহার করবেন না। এই প্রকল্পের নিজস্ব ফরম্যাটার আছে।
- এটি এখন আপনার সম্পাদনা করার জন্য তৈরি বিশেষ কার্ড।
আমরা এখন html ফাইল এডিট করা শুরু করব, আমাদের কার্ডের পরিবর্তনযোগ্য স্থানগুলোকে পরিবর্তন করব।
Your Nameএর স্থলে আপনার নামটি বসান।- দ্রষ্টব্যঃ
class="name"পরিবর্তন করবেন না। href="Insert URL here"এর স্থলে আপনার টুইটার অ্যাকাউন্টের URL লিখুন।Your handleএর স্থলে @ দিয়ে আপনার টুইটার অ্যাকাউন্টের নাম লিখুন।
- আপনি যদি টুইটার ছাড়া অন্য কোনো পরিচিতি ব্যবহার করতে চান তাহলে আপনাকে টুইটার আইকনটি
<i class="fa fa-twitter"></i>প্রতিস্থাপন করতে হবে। Font Awesome Icons -এ গিয়ে সঠিক আইকন অনুসন্ধান করে এবং শুধুমাত্রfa-twitterঅংশটিকে নতুন আইকন যেমনfa-githubদিয়ে প্রতিস্থাপন করে, তারপর উপরের একই পদক্ষেপগুলি অনুসরণ করুন।
আপনার সম্পর্কে আমাদের কিছু বলুন
-
এটিকে ছোট এবং সহজ রাখুন। একটি ব্লগ পোস্টের চেয়ে একটি টুইটের মত কড়ে এটিকে সাজান।
-
ওয়েব ডেভেলপারদের জন্য দরকারী এমন ৩টি সংস্থানগুলির লিঙ্ক আমাদের সাথে শেয়ার করুন।
-
এটি যেকোনো কিছু হতে পারে, একটি ভিডিও, একটি আলোচনা, একটি পডকাস্ট, একটি নিবন্ধ, একটি রেফারেন্স বা একটি টুল৷
-
আপনি যদি একজন নবীন হয়ে থাকেন তবে এতে ভয় পাবেন না, আপনি যা জানেন তাই আমাদের সাথে শেয়ার করুন যদিও আপনি মনে করেন এটি প্রাথমিক পর্যায়ের। আপনার দ্বারা কতজন উপকৃত হবেন তা ভেবে আপনি অবাক হবেন।
-
লিঙ্ক:
#প্রতিস্থাপন করেhref="এখানে"লিঙ্কটি প্রবেশ করান। -
শিরোনাম: একটি সংক্ষিপ্ত বিবরণ লিখুন
title="এখানে" -
নাম: টেক্সট ফিল্ডে রিসোর্স্টির নাম লিখুন
>এখানে</a>। -
নিশ্চিত করুন যে আপনি আপনার সমস্ত পরিবর্তনগুলি সংরক্ষণ করেছেন।
-
আপনার পরিবর্তনগুলো যাচাই করুন। এটি খুবই গুরুত্বপূর্ণ! আপনার ব্রাউজারে html ফাইলটি খুলুন (উদাহরণস্বরূপ এটিতে ডাবল ক্লিক করে) এবং দেখুন আপনার কার্ডটি সাইটে দেখতে কেমন হবে। দেখুন যে পুরো পৃষ্ঠাটি এখনও একই রকম দেখাচ্ছে এবং কিছুই ভাঙা হয়নি। আপনার লিঙ্কগুলিতে ক্লিক করুন এবং নিশ্চিত করুন যে তা কাজ করছে। কনসোল খুলুন (Ctrl + Shift + J (Windows / Linux) বা Cmd + Opt + J (Mac)) এবং পরীক্ষা করুন যে সেখানে কোনও ত্রুটি বার্তা দেখাচ্ছে না।
-
দুর্দান্ত, আপনি আপনার কোড সম্পাদনা শেষ করেছেন! পরবর্তী পদক্ষেপগুলি আপনার পরিবর্তনগুলিকে GitHub-এ পাঠাবে এবং তারপরে সেগুলিকে মূল প্রকল্পের সাথে একত্রিত করার জন্য জমা দেবে।
- এখন প্রকল্পের ফোল্ডারে টার্মিনাল চালু করে
git statusকোডটি লিখলে আপনি দেখতে পাবেন যে সেখানে কিছু পরিবর্তন এসেছে। git-addকমান্ড/কোড এর মাধ্যমে সেই পরিবর্তনগুলো গিট এ যোগ করা যাবে।
git add index.htmlঅথবাঃ
git add .- এখন
git commitকমান্ড/কোড এর সাহায্যে পরিবর্তনগুলো গিট এ কমিট করতে হবে।
git commit -m "Add $Username card info"$Usernameটি আপনার গিটহাব ইউজারনেম এর দ্বারা পরিবর্তন করে নিতে হবে।
- আপনার পরিবর্তনগুলি এখন সংরক্ষিত বা প্রতিশ্রুতিবদ্ধ। কিন্তু তারা শুধুমাত্র স্থানীয়ভাবে আপনার কম্পিউটারে সংরক্ষিত হয়েছে।
- GitHub-এ আপনার সংগ্রহস্থলের সাথে স্থানীয় পরিবর্তনগুলিকে সিঙ্ক্রোনাইজ করাকে Push বলা হয়। আপনি GitHub-এ আপনার স্থানীয় সংগ্রহস্থল থেকে রিমোট রিপোজিটরিতে পরিবর্তনগুলিকে "push" দিচ্ছেন।
- আমরা
git pushকমান্ড/কোড এর সাহায্যে গিটহাবে পুশ করে থাকি।
git push -u origin $Username-card-
$Usernameটি আপনার গিটহাব ইউজারনেম এর দ্বারা পরিবর্তন করে নিতে হবে। -
কয়েক সেকেন্ডের পরে অপারেশনটি সম্পূর্ণ হয় এবং এখন আপনার মেশিনে এবং গিটহাবে এই শাখাটির ঠিক একই অনুলিপি রয়েছে।
-
এই মুহূর্তটির জন্য আপনি অপেক্ষা করছেন; একটি Pull Request (PR) জমা দেওয়া।
-
এখন পর্যন্ত আপনার করা সমস্ত কাজ গিটহাবের আপনার নিজের অ্যাকাউন্টে থাকা প্রকল্পের ফর্কে ছিল।
-
এখন আমাদের মূল প্রকল্পের সাথে আপনার পরিবর্তনগুলি একত্রিত করার সময়।
-
এটিকে Pull Request বলা হয় কারণ, আপনি মূল প্রকল্প রক্ষণাবেক্ষণকারীকে তাদের প্রকল্পে আপনার পরিবর্তনগুলিকে "পুল" করতে বলছেন৷
-
GitHub-এ আপনার ফর্ক-এর মূল পৃষ্ঠায় যান (এটির উপরে ফর্ক আইকন এবং আপনার নিজের নাম থাকবে)।
-
রিপোর উপরের দিকে আপনি একটি সবুজ বোতাম সহ একটি হাইলাইট করা পুল রিকোয়েস্ট বার্তা দেখতে পাবেন।
-
Compare and pull request-এ ক্লিক করুন। -
Open a pull requestপৃষ্ঠাটি দেখতে এইরকম। -
মনে রাখবেন আপনি আপনার শাখাটিকে মূল প্রকল্পের সাথে যুক্ত করার চেষ্টা করছেন, আপনার ফর্কে থাকা
মাস্টারশাখার সাথে নয়। -
আপনার পুল অনুরোধের শিরোনামটি কেমন হওয়া উচিত, সে বিষয়ে নীচের ছবিটি আমাদের একটি ধারণা দিচ্ছে।
-
বাম দিকে মূল প্রকল্প, মাস্টার শাখা নির্বাচন করা থাকে, এবং ডানদিকে আপনার ফর্ক এবং আপনার তৈরি করা শাখা।
- সমস্ত বিকল্প দ্বারা বিভ্রান্ত হবেন না. আপনাকে আপাতত এই তিনটি ধাপ অনুসরণ করতে হবে।
Allow edits from maintainersবিকল্পটি টিক দিন।- এখন, একটি Pull Request প্রজেক্ট রক্ষণাবেক্ষণকারীকে পাঠানো হবে। এটি পর্যালোচনা এবং গৃহীত হওয়ার সাথে সাথে আপনার পরিবর্তনগুলি প্রকল্পের ওয়েব পৃষ্ঠা এ প্রদর্শিত হবে।
এটাই. আপনি এটা করেছেন! আপনি এখন GitHub-এ ওপেন সোর্সে অবদান রেখেছেন।
আপনি একটি লাইভ ওয়েব পৃষ্ঠাতে কোড যোগ করেছেন: https://syknapse.github.io/Contribute-To-This-Project
আপনার পরিবর্তনগুলি তাৎক্ষণিকভাবে দৃশ্যমান হবে না; প্রথমে সেগুলিকে পর্যালোচনা করতে হবে, গ্রহণ করতে হবে এবং প্রকল্প রক্ষণাবেক্ষণকারীকে তা একত্রিত করতে হবে। একবার আপনার পরিবর্তনসমুহ গৃহীত হয়ে গেলে আপনার কার্ডটি আমাদের ওয়েব পেজ এ দৃশ্যমান হবে।
একজন পর্যালোচকের পক্ষে পিআর-এ পরিবর্তনের জন্য জিজ্ঞাসা করা খুবই স্বাভাবিক। এটি আপনার সাথে ঘটলে এটিকে ভাল অনুশীলন হিসাবে ভাবুন। মন্তব্য এবং অনুরোধ পরিবর্তনের জন্য চোখ রাখুন. একবার আপনি অনুরোধ করা পরিবর্তনগুলি (আপনার শাখায় ফিরে) করে ফেললে আপনাকে যা করতে হবে তা হল আপনার পরিবর্তনগুলিকে commit করা এবং push দেওয়া। নতুন পরিবর্তনের সাথে পিআর স্বয়ংক্রিয়ভাবে আপডেট হবে।
আমি প্রতিশ্রুতি দিচ্ছি যে, আমি যত তাড়াতাড়ি সম্ভব পর্যালোচনা এবং একত্রিত করার চেষ্টা করব। তবে আমি আমার অতিরিক্ত সময়ে এটি করি, তাই কয়েক দিনের বিলম্ব অনিবার্য।
- আপনার মার্জ করা পুল অনুরোধের জন্য কিছুদিন পর পর দেখুন।
- আপনার পরিবর্তনগুলি অনুমোদিত হলে বা অতিরিক্ত পরিবর্তনের অনুরোধ করা হলে অথবা পিআর অবশেষে মাস্টারের সাথে একত্রিত করা এবং আপনার কার্ড যোগ করা হলে আপনি GitHub থেকে একটি ইমেল পাবেন।
- আপনি যদি এই প্রকল্পটিকে উপযোগী খুঁজে পান তাহলে অনুগ্রহ করে এটিকে একটি ⭐ স্টার ⭐ দিন যা প্রকল্পটির উপরে রয়েছে এবং আমাদের কথা ছড়িয়ে দিতে টুইট করুন >
-এখানে ক্লিক করে।
- আপনি আমাকে অনুসরণ করতে পারেন এবং টুইটার অথবা এই অন্য কোন বিকল্প ব্যবহার করে যোগাযোগ করতে পারেন।
- এটি একটি ওপেন সোর্স প্রজেক্ট তাই আপনার কার্ডে অবদান রাখার পাশাপাশি বাগ, উন্নতি বা নতুন বৈশিষ্ট্যগুলি ঠিক করতে সাহায্য করার জন্য আপনাকে স্বাগত জানাই৷ এটি করতে একটি ইস্যু খুলুন অথবা একটি নতুন pull request পাঠান।
- আমাদের উন্নতিতে সাহায্য করার জন্য পুল রিকোয়েস্ট -এর পাশে অবস্থিত ট্যাব GitHub Discussions দেখুন। এই এলাকাটি নিজেকে পরিচয় করিয়ে দেওয়ার, ওপেন সোর্স নিয়ে গভীর আলোচনায় যাওয়ার এবং প্রকল্প রক্ষণাবেক্ষণকারীদের সাথে যোগাযোগ করার জায়গা। আপনি কি আমাদের এই বৈশিষ্ট্যটি তৈরি করতে এবং আমাদের উন্নত করতে সাহায্য করবেন?
- এই প্রকল্পে অবদান রাখার জন্য ধন্যবাদ। এখন আপনি এগিয়ে যেতে পারেন এবং অন্যান্য প্রকল্পে অবদান রাখার চেষ্টা করতে পারেন; শিক্ষানবিস-বান্ধব অবদানের বিকল্পগুলির জন্য
লেবেলটি সন্ধান করুন৷ - আমি PR পর্যালোচনা এবং মার্জ করার জন্য আমাকে সাহায্য করার জন্য সহযোগীদেরও খুঁজছি। আপনি যদি আরও উন্নত গিট অনুশীলন পেতে চান তাহলে অনুগ্রহ করে আমাকে টুইটারে একটি ডিএম পাঠান এবং পরিচালনা নির্দেশাবলি পড়ুন।
এই প্রজেক্টটি Roshan Jossey's এর দুর্দান্ত টিউটোরিয়াল সহ দুর্দান্ত first-contributions প্রকল্প দ্বারা ব্যাপকভাবে প্রভাবিত।
এটি বিশেষভাবে #GoogleUdacityScholars দ্য গুগল চ্যালেঞ্জ স্কলারশিপ: ফ্রন্ট-এন্ড ওয়েব ডেভ, 2017 ইউরোপের ক্লাসের দ্বারা অনুপ্রাণিত।