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

عیب‌یابی

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

صفحه سفید یا بدون محتوا

علت محتمل: خطای Alpine.js — تابع x-data تعریف نشده.

راه‌حل:

  1. F12 → Console — خطای ... is not defined را بخوانید
  2. ترتیب اسکریپت را بررسی کنید:
        
    
 
  1. نام تابع در x-data با نام function در JS یکی باشد:

function noviraFashion() { ... }

استایل اعمال نمی‌شود / صفحه بدون قالب

علت: مسیر CSS اشتباه یا فایل آپلود نشده.

بررسی:

  1. F12 → Network → فیلتر CSS
  2. وضعیت 404 برای novira.css یا output.css؟
  3. ساختار پوشه: assets/css/ کنار index.html
  4. روی هاست: حساس به حروف بزرگ/کوچک (Linux) — Novira.cssnovira.css

تصاویر نمایش داده نمی‌شوند (404)

مسیرهای رایج:

نوعمسیر
بنرassets/images/novira/banners/
لوگوassets/images/novira/logo.svg
محصولassets/images/product/electronic/
دموassets/images/novira/demo/
lookbookassets/images/fashion-banners/

پوشه assets/images/ را کامل آپلود کنید.

اسلایدر کار نمی‌کند

چک‌لیست:

  • [ ] swiper-bundle.min.js لود شده
  • [ ] swiper-bundle.min.css در head
  • [ ] main.js قبل از alpine.js لود شده
  • [ ] المان دارای class="swiper" و data-swiper='{...}' است
  • [ ] JSON داخل data-swiper معتبر است (بدون خطای syntax)

منو یا drawer باز نمی‌شود

  • Alpine باید بدون خطا لود شود
  • x-data باید شامل mobileMenuOpen (از noviraShared) باشد
  • attributeهای @click روی دکمه‌ها درست باشند

فونت فارسی درست نیست

علتراه‌حل
Google Fonts فیلترفونت محلی — شخصی‌سازی
offlineاتصال اینترنت یا فونت local
cacheCtrl+Shift+R (hard refresh)

خطای CORS در حالت file://

باز کردن مستقیم index.html گاهی محدودیت دارد.

راه‌حل: از سرور محلی استفاده کنید → اجرای محلی

صفحه پروفایل منوی اشتباه فعال است

پارامتر noviraProfile() باید با صفحه مطابقت داشته باشد:



ورود کاربر نمایش داده نمی‌شود

احراز هویت mock با sessionStorage:

sessionStorage.getItem('dsAuth') === '1'
  • از login-singup.html وارد شوید
  • یا در Console: sessionStorage.setItem('dsAuth', '1') سپس refresh

پس از آپلود هاست کار نمی‌کند

  1. چک‌لیست استقرار
  2. .htaccess — اگر خطای 500 داد، موقتاً حذف کنید
  3. مسیر نصب در زیرپوشه — لینک‌ها نسبی هستند و باید کار کنند
  4. SSL mixed content — همه assetها باید https یا نسبی باشند

خطاهای رایج Console

خطاعلتراه‌حل
noviraShared is not definednovira.js لود نشده یا بعد از ماژولترتیب اسکریپت
novira is not definedalpine قبل از novira.jsalpine را آخر بگذارید
Swiper is not definedswiper لود نشدهاضافه کردن swiper-bundle
Unexpected token در data-swiperJSON نامعتبرکوتیشن و کاما را چک کنید

مشکلات نسخه Next.js

نشانهراه‌حل
npm install خطا می‌دهدنسخه Node باید ۲۰ یا بالاتر باشد؛ با node -v بررسی کنید
out/index.html بدون استایل باز می‌شودخروجی استاتیک با file:// کار نمی‌کند؛ npm run preview بزنید
سایت در زیرپوشه بدون استایل استNOVIRA_BASE_PATH تنظیم نشده؛ فصل ۱۴ را ببینید
خطای Missing parameter name هنگام بیلدمقدار NOVIRA_BASE_PATH را بدون اسلش ابتدایی بدهید
همه مسیرها جز صفحه اصلی ۴۰۴ می‌دهندفایل مخفی .htaccess از پوشه out/ آپلود نشده است

فهرست کامل‌تر در عیب‌یابی استقرار نسخه Next.js.

دریافت کمک بیشتر

  1. Console و Network را اسکرین‌شات بگیرید
  2. نام فایل HTML و هاست را ذکر کنید
  3. بگویید تغییرات شخصی‌سازی چه بوده

لینک‌های مرتبط