জিম্মিৰ ব্লগ

Next.js 15+ ভিত্তিত নিৰ্মিত এটা সৰল ব্যক্তিগত ব্লগ ব্যৱস্থা, অনলাইন সৃষ্টি আৰু স্থিৰ ডেপ্লয়মেন্টৰ সহায়ত।

প্ৰযুক্তি স্তৰ

• ফ্ৰেমৱৰ্ক: Next.js 15+ (App Router)
• ভাষা: TypeScript
• শৈলী: Tailwind CSS
• চিহ্ন: Lucide Icons
• সমগ্ৰী: Markdown + Gray Matter + Remark
• প্ৰমাণীকৰণ: GitHub OAuth
• ডিপ্লয়মেণ্ট: Vercel

ফিচাৰ বৈশিষ্ট্য

পঢ়োঁতা ফাল

• 📝 Markdown + GFM প্ৰবন্ধ ৰেণ্ডাৰিং (গণিত সূত্ৰ সহ দেখুৱাব)
• 🏷️ টেগ চয়ন, পৃষ্ঠাবিভাজন, সংৰক্ষণ (বৰ্ষ/টেগ অনুসৰি)
• 📚 প্ৰবন্ধৰ সূচীপত্ৰ নেভিগেশন (TOC) আৰু ক'ড ব্লক এটা ক্লিকত কপি কৰা
• 📱 প্ৰতিত্ত্বাত্মক লেআউট আৰু ডাৰ্ক/লাইট থিম পৰিবৰ্তন
• 🔥 ভৱমান সৃষ্টিৰ কেলেণ্ডাৰ হিটম্যাপ (প্ৰবন্ধ + চিত্ৰ)
• 📡 RSS চাবনীৰ আউটপুট (/rss.xml)

সৃষ্টি ফাল (প্ৰশাসনিক ডেশ্ব'ৰ্ড)

• 🔐 GitHub OAuth লগইন (মালিক/সহকাৰী অনুমতি যাচাই)
• ✍️ প্ৰবন্ধ/চিত্ৰ অনলাইন সৃষ্টি, সম্পাদনা, মচা
• 🆔 কাষ্টম ফাইল ID + স্বয়ংক্ৰিয় সংঘাত এৰাই চলা
• 👀 সম্পাদনা / পূৰ্বদর্শন / বিভাজিত স্ক্ৰীণ তিনিধৰণৰ লেখা ম'ড
• 📊 সৃষ্টি পৰিসংখ্যা পেনেল (মুঠ, সপ্তাহ/মাহ উৎপাদন, জনপ্ৰিয় টেগ)

ইঞ্জিনিয়াৰিং ফাল

• ⚡ বহু পৃষ্ঠা স্থায়ীভাৱে আউটপুট (force-static) কাৰ্যক্ষমতা আৰু স্থিৰতা বৃদ্ধি
• 🧭 অন্তর্নির্মিত sitemap আৰু robots
• 🧩 সমগ্ৰ পঢ়া কেশ্ব আৰু মডুলাৰ API গঠন

প্ৰকল্পৰ গঠন

.
├── app/               # 页面、API 路由、Server Actions
│   ├── api/           # 接口（OAuth、统计、校验、Markdown 等）
│   ├── actions/       # 内容管理相关服务端动作
│   ├── posts/         # 文章详情页
│   └── page.tsx       # 首页
├── content/
│   ├── notes/         # 随笔
│   └── posts/         # 文章
├── components/        # React 组件
├── public/            # 静态资源
└── styles/            # 全局样式

সংস্থাপন আৰু চলোৱা

• প্ৰকল্পটো ক্লোন কৰক

git clone https://github.com/Lily-404/blog.git
cd jimmy-blog

• নিৰ্ভৰশীলতা সমূহ স্থাপন কৰক

npm install

• উন্নয়ন চাৰ্ভাৰ চলাও

npm run dev

• উৎপাদন সংস্কৰণ নিৰ্মাণ কৰক

npm run build

নতুন প্ৰবন্ধ যোগ কৰক

পদ্ধতি ১: অনলাইন পৰিচালনা ব্যাকএণ্ড (পৰামৰ্শযোগ্য)

• /admin পৃষ্ঠা খুলক
• GitHub OAuth ব্যৱহাৰ কৰি প্ৰৱেশ কৰক
• প্ৰবন্ধৰ তথ্য পূৰণ কৰি জমা দিয়ক
• প্ৰবন্ধটো স্বচালিতভাৱে GitHub API ৰ জৰিয়তে সৃষ্টি হ'ব, আৰু Vercel স্বয়ংক্ৰিয়ভাৱে পুনৰ ডিপ্লয় কৰিব

পদ্ধতি ২: ফাইল হাতেহাতে যোগ কৰা

• content/posts ফোল্ডাৰত নতুন Markdown ফাইল সৃষ্টি কৰক
• ফাইলৰ নামকৰণ ধৰণ: xxx.md
• ফাইলৰ মূৰত মেটাডাটা যোগ কৰক:

---
title: 文章标题
date: YYYY-MM-DD
tags: ["标签1","标签2","标签3"]
---

স্মৰণী যোগ কৰক

• content/notes ডিৰেক্টৰীত নতুন Markdown ফাইল সৃষ্টি কৰক
• ফাইল নামাকৰণৰ ধৰণ: YYYY-MM-DD-title.md
• ফাইলৰ মুৰত মেটাডাটা যোগ কৰক:

---
date: YYYY-MM-DD
---

ব্যৱস্থাপনা পটভূমি কনফিগাৰ কৰক

ব্যৱস্থাপনা পটভূমি GitHub OAuth ব্যৱহাৰ কৰি চিনাক্তকৰণ কৰে, কেৱল ৰিপজিটৰী মালিক অথবা সহকৰ্মীয়ে প্ৰৱেশ কৰিব পাৰে।

1. GitHub OAuth App সৃষ্টি কৰক

• GitHub Settings > Developer settings > OAuth Apps লৈ যাওক
• "New OAuth App" ক্লিক কৰক
• তথ্য পূৰণ কৰক:
• Application name: Jimmy Blog Admin (অথবা যিকোনো নাম)
• Homepage URL: https://আপোনাৰ-ডমেইন.com (প্ৰডাকশ্যন) অথবা http://localhost:3000 (স্থানীয় উন্নয়ন)
• Authorization callback URL:
• প্ৰডাকশ্যন: https://আপোনাৰ-ডমেইন.com/api/auth/github/callback
• স্থানীয় উন্নয়ন: http://localhost:3000/api/auth/github/callback
• "Register application" ক্লিক কৰক
• Client ID টো লিখি ৰাখক
• "Generate a new client secret" ক্লিক কৰি Client secret টো লিখি ৰাখক

2. পৰিবেশ ভেৰিয়েবল কনফিগাৰ কৰক

Vercel প্ৰকল্পৰ ছেটিংছত তলত দিয়া পৰিবেশ ভেৰিয়েবলসমূহ যোগ কৰক:

• GITHUB_CLIENT_ID: আপোনাৰ GitHub OAuth App Client ID
• GITHUB_CLIENT_SECRET: আপোনাৰ GitHub OAuth App Client Secret
• GITHUB_OWNER: GitHub ব্যৱহাৰকাৰী নাম (ডিফল্ট: Lily-404, ব্যৱহাৰকাৰীৰ অধিকাৰ যাচাই কৰিবলৈ)
• GITHUB_REPO: ৰিপজিটৰী নাম (ডিফল্ট: blog)
• GITHUB_REDIRECT_URI: OAuth কলব্যাক URL (ঐচ্ছিক, ডিফল্ট স্বয়ংক্ৰিয়ভাৱে সৃষ্টি হয়)
• NEXT_PUBLIC_BASE_URL: আপোনাৰ ৱেবছাইটৰ URL (কলব্যাক URL সৃষ্টি কৰিবলৈ, প্ৰডাকশ্যনত স্থাপন কৰাটো বাধ্যতামূলক)
• প্ৰডাকশ্যন: https://www.jimmy-blog.top
• স্থানীয় উন্নয়ন: http://localhost:3000

3. স্থানীয় উন্নয়ন কনফিগাৰ

প্ৰকল্পৰ মূল ডাইৰেক্টৰিত .env.local ফাইল সৃষ্টি কৰক:

GITHUB_CLIENT_ID=你的Client_ID
GITHUB_CLIENT_SECRET=你的Client_Secret
GITHUB_OWNER=Lily-404
GITHUB_REPO=blog
NEXT_PUBLIC_BASE_URL=http://localhost:3000

৪. উৎপাদন পৰিবেশৰ সংৰক্ষণ (Vercel)

Vercel প্ৰকল্পৰ সংৰক্ষণত, নিশ্চিত কৰক:

NEXT_PUBLIC_BASE_URL=https://www.jimmy-blog.top

⚠️ সতৰ্কবাণী:

• .env.local ফাইলটো .gitignore ত যোগ কৰা হৈছে, Git ত দাখিল নহ’ব
• স্থানীয় ডেভেলপমেন্টত, নিশ্চিত কৰক যে OAuth App ৰ ৰিডাইৰেক্ট URL http://localhost:3000/api/auth/github/callback হিচাপে ছেট কৰা হৈছে
• প্ৰডাকশ্যন পৰিবেশত NEXT_PUBLIC_BASE_URL ক https://www.jimmy-blog.top হিচাপে ছেট কৰা বাধ্যতামূলক
• প্ৰডাকশ্যনৰ OAuth App ৰ ৰিডাইৰেক্ট URL ছেট হ’ব লাগে: https://www.jimmy-blog.top/api/auth/github/callback

ডিপ্লয়মেণ্ট

প্ৰকল্পটো Vercel ডিপ্লয়ৰ বাবে কনফিগাৰ কৰা হৈছে, স্বয়ংক্ৰিয় ডিপ্লয় সমৰ্থিত। কেৱল কোডটো GitHub ৰেপ’ত পুশ কৰক, Vercel এ স্বয়ংক্ৰিয়ভাৱে বিল্ড আৰু ডিপ্লয় কৰিব।

মেনেজমেণ্ট বেকএণ্ড ব্যৱহাৰৰ সুবিধাসমূহ

• ✅ স্থানীয় ডেভেলপমেণ্ট এনভাইৰনমেণ্টৰ প্ৰয়োজন নাই
• ✅ যিকোনো ঠাইৰ পৰা যিকোনো সময়ত লিপি যোগ কৰিব পাৰি
• ✅ স্বয়ংক্ৰিয়ভাৱে Vercel ৰি-ডিপ্লয় ট্রিগাৰ কৰে
• ✅ সম্পূৰ্ণৰূপে মাফ (GitHub OAuth আৰু Vercel দুয়ো মাফ সীমাৰ ভিতৰত)
• ✅ নিৰাপদ (GitHub OAuth ভেৰিফিকেশ্বন, কেৱল ৰেপ’ৰ মালিক/সহযোগীয়ে প্ৰৱেশ কৰিব পাৰে)
• ✅ পাছৱাৰ্ড ব্যৱস্থাপনা কৰাৰ প্ৰয়োজন নাই, কেৱল GitHub একাউণ্ট ব্যৱহাৰ কৰি লগইন কৰিব পাৰি
• ✅ ইতিমধ্যে থকা সমগ্ৰী অনলাইন সম্পাদনা সমৰ্থন (নতুন যুক্তিৰে সীমাবদ্ধ নহয়)
• ✅ ফাইল ID কনফ্লিক্ট স্বয়ংক্ৰিয়ভাৱে হেণ্ডল কৰে, অভাৰলেপ আৰু হস্তচালিত পুনৰ নামকৰণ এৰাই যায়
• ✅ বেকএণ্ডত ক্ৰিয়েটিভ ষ্টেটিসটিক্স উপলব্ধ, ধাৰাবাহিক কনটেণ্ট অপাৰেশ্যন সহজ

প্ৰকল্প বিশ্লেষণ আৰু ভৱিষ্যৎ পৰিকল্পনা

• প্ৰকল্প বিশ্লেষণ নথি: docs/project-analysis.md
• Future পৰিকল্পনা নথি: docs/future-roadmap.md

অৱদান

Issue আৰু Pull Request দাখিল কৰিবলৈ স্বাগতম!

লাইচেন্স

MIT License

--- Tranlated By Open Ai Tx | Last indexed: 2026-04-03 ---