وبلاگ جیمی

یک سیستم وبلاگ شخصی مینیمال مبتنی بر 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 (اعتبارسنجی مالک/همکار)
• ✍️ ایجاد، ویرایش و حذف آنلاین مقاله/یادداشت
• 🆔 شناسه فایل سفارشی + جلوگیری خودکار از تداخل
• 👀 سه حالت نگارش: ویرایش / پیش‌نمایش / تقسیم صفحه
• 📊 داشبورد آمار تولید محتوا (کل، خروجی هفتگی/ماهانه، برچسب‌های محبوب)

سمت مهندسی

• ⚡ خروجی استاتیک چندصفحه‌ای (force-static) برای افزایش عملکرد و پایداری
• 🧭 نقشه سایت و 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 به طور خودکار دوباره مستقر می‌شود

روش دوم: افزودن فایل به صورت دستی

• یک فایل Markdown جدید در پوشه content/posts ایجاد کنید
• فرمت نام‌گذاری فایل: 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 برای احراز هویت استفاده می‌کند و فقط مالک مخزن یا همکاران می‌توانند به آن دسترسی داشته باشند.

۱. ایجاد 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 را یادداشت کنید

۲. پیکربندی متغیرهای محیطی

در تنظیمات پروژه Vercel متغیرهای محیطی زیر را اضافه کنید:

• GITHUB_CLIENT_ID: Client ID مربوط به GitHub OAuth App شما
• GITHUB_CLIENT_SECRET: Client Secret مربوط به GitHub OAuth App شما
• GITHUB_OWNER: نام کاربری GitHub (پیش‌فرض: Lily-404 برای اعتبارسنجی دسترسی کاربر)
• GITHUB_REPO: نام مخزن (پیش‌فرض: blog)
• GITHUB_REDIRECT_URI: آدرس بازگشت OAuth (اختیاری، به طور پیش‌فرض خودکار تولید می‌شود)
• NEXT_PUBLIC_BASE_URL: آدرس سایت شما (برای تولید آدرس بازگشت، باید در محیط تولید تنظیم شود)
• محیط تولید: https://www.jimmy-blog.top
• توسعه محلی: http://localhost:3000

۳. پیکربندی توسعه محلی

در ریشه پروژه یک فایل به نام .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

4. پیکربندی محیط تولید (Vercel)

در تنظیمات پروژه Vercel، اطمینان حاصل کنید که موارد زیر را تنظیم کنید:

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

⚠️ توجه:

• فایل .env.local به .gitignore اضافه شده و به Git ارسال نمی‌شود
• در توسعه محلی، مطمئن شوید که callback URL برنامه OAuth روی http://localhost:3000/api/auth/github/callback تنظیم شده باشد
• در محیط تولید باید NEXT_PUBLIC_BASE_URL را روی https://www.jimmy-blog.top تنظیم کنید
• callback URL برنامه OAuth در محیط تولید باید به این صورت باشد: https://www.jimmy-blog.top/api/auth/github/callback

استقرار

پروژه برای استقرار در Vercel پیکربندی شده و از استقرار خودکار پشتیبانی می‌کند. کافی است کد را به مخزن GitHub پوش کنید، Vercel به صورت خودکار می‌سازد و مستقر می‌کند.

مزایای استفاده از پنل مدیریت

• ✅ نیازی به محیط توسعه محلی نیست
• ✅ امکان افزودن مقاله در هر زمان و مکان
• ✅ فعال‌سازی خودکار بازاستقرار Vercel
• ✅ کاملاً رایگان (GitHub OAuth و Vercel هر دو در سهمیه رایگان قرار دارند)
• ✅ ایمن (تأیید هویت GitHub OAuth، فقط مالک/همکاران مخزن دسترسی دارند)
• ✅ نیازی به مدیریت رمز عبور نیست، با حساب GitHub وارد شوید
• ✅ پشتیبانی از ویرایش آنلاین محتوای موجود (نه فقط ایجاد جدید)
• ✅ مدیریت خودکار تضاد شناسه فایل برای جلوگیری از بازنویسی و تغییر نام دستی
• ✅ آمار تولید محتوا در پنل مدیریت، مناسب برای تداوم فعالیت محتوایی

تحلیل پروژه و برنامه‌های آینده

• سند تحلیل پروژه: docs/project-analysis.md
• سند برنامه آینده: docs/future-roadmap.md

مشارکت

ارسال Issue و Pull Request خوش‌آمد است!

مجوز

MIT License

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