N مستندات Novira مشاهده دمو صفحه اصلی قالب

اجرای محلی

بازگشت به فهرست

نسخه HTML قالب برای اجرا نیازی به npm یا بیلد ندارد. فایل assets/css/output.css از قبل با Tailwind v4 کامپایل شده است.

اگر می‌خواهید نسخه Next.js را اجرا کنید، بخش انتهای همین صفحه را ببینید.

روش ۱ — باز کردن مستقیم فایل

  1. به پوشه قالب بروید
  2. index.html را در Chrome یا Firefox باز کنید

مزیت: سریع، بدون نصب

محدودیت: برخی مرورگرها برای file:// محدودیت دارند؛ برای توسعه جدی روش ۲ بهتر است

روش ۲ — Live Server در VS Code

  1. افزونه Live Server را نصب کنید
  2. روی index.html راست‌کلیک → Open with Live Server
  3. آدرس معمولاً http://127.0.0.1:5500/index.html است

روش ۳ — Python HTTP Server

در ترمینال، داخل پوشه قالب:

# Python 3
python -m http.server 8080

سپس در مرورگر: http://localhost:8080/index.html

روش ۴ — PHP Built-in Server

اگر PHP نصب است:

php -S localhost:8080

فایل‌های لازم برای اجرا

این پوشه‌ها و فایل‌ها باید کنار HTMLها باشند:

assets/
├── css/    (output.css, novira*.css, swiper)
├── js/     (novira.js, alpine.js, swiper, main.js)
└── images/ (novira/, product/, fashion-banners/)

فایل‌هایی که برای اجرا لازم نیستند

پوشه/فایلتوضیح
node_modules/وابستگی توسعه؛ در HTML استفاده نمی‌شود
help/فقط مستندات
.cursor/تنظیمات IDE
theme.zipآرشیو (در صورت وجود)

اتصال اینترنت

فونت Vazirmatn از Google Fonts CDN لود می‌شود. بدون اینترنت فونت fallback سیستم نمایش داده می‌شود. برای آفلاین کامل → شخصی‌سازی فونت.

اجرای محلی نسخه Next.js

نسخه Next.js برخلاف نسخه HTML به Node.js نیاز دارد.

node -v          # باید ۲۰ یا بالاتر باشد
npm install      # بار اول چند دقیقه طول می‌کشد
npm run dev      # http://localhost:3000

با ذخیره هر فایل، مرورگر خودش به‌روز می‌شود.

برای دیدن خروجی نهایی به‌شکلی که روی هاست اجرا می‌شود:

npm run build:static     # خروجی در پوشه out/
npm run preview          # http://localhost:3030

فایل out/index.html را با دابل‌کلیک باز نکنید؛ بدون وب‌سرور، استایل و تصویرها لود نمی‌شوند. توضیح کامل در فصل ۱۴.

گام بعدی