প্রকল্প সম্পর্কে

GitHub Languages Card হলো একটি Node.js/Express ওয়েব পরিষেবা যা একটি GitHub ব্যবহারকারীর সর্বাধিক ব্যবহৃত প্রোগ্রামিং ভাষা দেখানো SVG কার্ড তৈরি করে, যা প্রোফাইল README, পোর্টফোলিও এবং ডকুমেন্টেশনে এমবেড করার জন্য ডিজাইন করা হয়েছে। একটি হোস্ট করা ডেমো github-languages-card.vercel.app-এ উপলব্ধ, এবং প্রকল্পটি স্ব-হোস্টও করা যায়। মূল কার্যকারিতা: GET /api/top-languages এন্ডপয়েন্ট একটি আবশ্যক username প্যারামিটার এবং একটি ঐচ্ছিক theme প্যারামিটার (ডিল্ট pink) গ্রহণ করে, একটি SVG ছবি ফেরত দেয় যা সরাসরি Markdown-এ এমবেড করা যায়। কার্ডটি শতাংশসহ শীর্ষ ভাষাগুলি প্রদর্শন করে, সাথে GitHub পরিসংখ্যান যেমন রিপোজিটরি, ফলোয়ার, স্টার এবং ফর্ক, এবং ঐচ্ছিকভাবে ব্যবহারকারীর অ্যাভাটার। README-তে বলা হয়েছে যে কোনো ডেটা সংরক্ষণ করা হয় না এবং অনুরোধগুলি সরাসরি GitHub API-তে যায়। থিম: README-তে ১৮+ নামযুক্ত থিমের তালিকা রয়েছে, যার মধ্যে pink, dark, mint, purple, ocean, sunset, graphite, coffee, lavender, peach, neon, strawberry, darkNeon, fire, snow, hacker, white এবং golden অন্তর্ভুক্ত। README-তে থিমগুলির একটি র‍্যা্ক করা "top picks" তালিকা উপস্থাপন করা হয়েছে, যা লেখকের নিজস্ব উপস্থাপনা, কোনো স্বাধীন মূল্যায়ন নয়। স্ব-হোস্টিং: Node.js 18+ এবং npm/yarn প্রয়োজন। ধাপগুলি হলো রিপোজিটরি ক্লোন করা, npm install চালানো, .env.example কে .env-এ কপি করা, এবং node server.js দিয়ে শুরু করা, এরপর অ্যাপটি localhost:3000-এ উপলব্ধ হয়। node:18-alpine-ভিত্তিক একটি নমুনা Dockerfile প্রদান করা হয়েছে। পরিবেশ ভেরিয়েবলের মধ্যে রয়েছে PORT (ডিফল্ট 3000), GITHUB_TOKEN (ঐচ্ছিক, উচ্চতর API রেট সীমার জন্য), NODE_ENV এবং RENDER_EXTERNAL_URL। প্রকল্প কাঠামো: server.js হলো প্রধান Express সার্ভার; public/ ল্যান্ডিং পেজ এবং ডকুমেন্টেশন ছবি ধারণ করে; utils/ এ রয়েছে github.js (GitHub API ইন্টিগ্রেশন), svgBuilder.js (SVG কার্ড বিল্ডার) এবং helpers.js; themes/ এ প্রতি-থিম সংজ্ঞা রয়েছে। উল্লিখিত টেক স্ট্যাক হলো Node.js, Express, Axios এবং SVG জেনারেশন। লেখকদের উল্লেখিত পরিচিত সীমাবদ্ধতা: GitHub API রেট-সীমাবদ্ধ (টোকেন ছাড়া ঘণ্টায় ৬০ অনুরোধ, GITHUB_TOKEN সহ ঘণ্টায় ৫০০০), এবং GitHub API প্রতিক্রিয়া সময়ের কারণে প্রথম অনুরোধ ধীর হতে পারে। প্রকল্পটি MIT লাইসেন্সপ্রাপ্ত এবং fork/branch/pull-request ওয়ার্কফ্লোর মাধ্যমে অবদানকে স্বাগত জানায়। README-তে আরও উল্লেখ করা হয়েছে যে সীমাবদ্ধ অঞ্চলের ব্যবহারকারীদের Vercel-হোস্ট করা ডেমোতে পৌঁছাতে VPN প্রয়োজন হতে পারে।