مستندات قالب Novira (نوویرا)
نسخه HTML این مستندات: برای مشاهده در مرورگر، help/index.html را باز کنید.
Novira (نوویرا) یک قالب RTL فروشگاه اینترنتی است با بیش از ۳۳ صفحه آماده، طراحی الهامگرفته از مارکتپلیسهای بزرگ و پشتیبانی کامل از فارسی و راستچین.
بسته شامل دو نسخه است
| نسخه | چیست | برای چه کسی |
|---|---|---|
| HTML | فایلهای آماده HTML، CSS و JS با Alpine.js؛ بدون npm و بدون بیلد | آپلود مستقیم روی هاست، تبدیل به قالب وردپرس یا هر CMS |
| Next.js | همان قالب بهصورت اپلیکیشن React با App Router و TypeScript | ادامه پروژه با React، اتصال به API واقعی |
هر دو نسخه دقیقاً همان ظاهر و همان صفحات را دارند. تفاوت فقط در ساختار پروژه است.
از کجا شروع کنم؟
اگر نسخه HTML را میخواهید
- شروع سریع و باز کردن
index.html - اجرای محلی
- نصب روی هاست
اگر نسخه Next.js را میخواهید
- راهنمای نسخه Next.js و اجرای
npm installسپسnpm run dev - استقرار نسخه Next.js
فصلهای ۵ تا ۱۲ (ساختار، صفحات، شخصیسازی، CSS و عیبیابی) عمدتاً درباره نسخه HTML هستند، اما مفاهیم طراحی و متغیرهای CSS در هر دو نسخه یکسان است.
نقطه شروع فایلها
| هدف | نسخه HTML | نسخه Next.js |
|---|---|---|
| پیشنمایش و معرفی قالب | demo.html | مسیر / و /demo |
| صفحه اصلی فروشگاه | index.html | مسیر /shop |
| داده و منطق مشترک | assets/js/novira.js | lib/data/ و components/providers/novira-provider.tsx |
| استایل پایه | assets/css/novira.css | styles/novira.css |
فهرست مطالب
| # | موضوع | فایل |
|---|---|---|
| 1 | معرفی قالب، مخاطب و محدودیتها | 01-overview.html |
| 2 | شروع سریع (۵ دقیقه) | 02-quick-start.html |
| 3 | اجرای محلی | 03-local-setup.html |
| 4 | نصب روی هاست (نسخه HTML) | 04-hosting-deployment.html |
| 5 | ساختار پوشهها | 05-folder-structure.html |
| 6 | راهنمای صفحات | 06-pages-guide.html |
| 7 | تکنولوژیها | 07-technologies.html |
| 8 | شخصیسازی | 08-customization.html |
| 9 | معماری JavaScript | 09-javascript-architecture.html |
| 10 | CSS و استایل | 10-css-and-styling.html |
| 11 | اسنیپتهای قابل کپی | 11-snippets.html |
| 12 | عیبیابی | 12-troubleshooting.html |
| 13 | نسخه Next.js | 13-nextjs-version.html |
| 14 | استقرار نسخه Next.js | 14-nextjs-deployment.html |
منابع اضافی
پیشنیازهای حداقلی
نسخه HTML
- مرورگر مدرن (Chrome، Firefox، Edge، Safari)
- ویرایشگر متن یا IDE (VS Code پیشنهاد میشود)
- برای استقرار: هاست با پشتیبانی HTML استاتیک (Apache/Nginx)
- بدون نیاز به npm یا Node.js
نسخه Next.js
- Node.js نسخه ۲۰ یا بالاتر بههمراه npm
- ویرایشگر با پشتیبانی TypeScript
- برای استقرار: همان هاست استاتیک (با
npm run build:static) یا هاست با پشتیبانی Node
پشتیبانی
قبل از تماس با پشتیبانی، بخش عیبیابی را مطالعه کنید. برای استقرار نسخه HTML راهنمای نصب روی هاست و برای نسخه Next.js استقرار نسخه Next.js را دنبال کنید.