عیبیابی
صفحه سفید یا بدون محتوا
علت محتمل: خطای Alpine.js — تابع x-data تعریف نشده.
راهحل:
- F12 → Console — خطای
... is not definedرا بخوانید - ترتیب اسکریپت را بررسی کنید:
- نام تابع در
x-dataبا نامfunctionدر JS یکی باشد:
function noviraFashion() { ... }
استایل اعمال نمیشود / صفحه بدون قالب
علت: مسیر CSS اشتباه یا فایل آپلود نشده.
بررسی:
- F12 → Network → فیلتر CSS
- وضعیت 404 برای
novira.cssیاoutput.css؟ - ساختار پوشه:
assets/css/کنارindex.html - روی هاست: حساس به حروف بزرگ/کوچک (Linux) —
Novira.css≠novira.css
تصاویر نمایش داده نمیشوند (404)
مسیرهای رایج:
| نوع | مسیر |
|---|---|
| بنر | assets/images/novira/banners/ |
| لوگو | assets/images/novira/logo.svg |
| محصول | assets/images/product/electronic/ |
| دمو | assets/images/novira/demo/ |
| lookbook | assets/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 |
| cache | Ctrl+Shift+R (hard refresh) |
خطای CORS در حالت file://
باز کردن مستقیم index.html گاهی محدودیت دارد.
راهحل: از سرور محلی استفاده کنید → اجرای محلی
صفحه پروفایل منوی اشتباه فعال است
پارامتر noviraProfile() باید با صفحه مطابقت داشته باشد:
ورود کاربر نمایش داده نمیشود
احراز هویت mock با sessionStorage:
sessionStorage.getItem('dsAuth') === '1'
- از
login-singup.htmlوارد شوید - یا در Console:
sessionStorage.setItem('dsAuth', '1')سپس refresh
پس از آپلود هاست کار نمیکند
- چکلیست استقرار
.htaccess— اگر خطای 500 داد، موقتاً حذف کنید- مسیر نصب در زیرپوشه — لینکها نسبی هستند و باید کار کنند
- SSL mixed content — همه assetها باید
httpsیا نسبی باشند
خطاهای رایج Console
| خطا | علت | راهحل |
|---|---|---|
noviraShared is not defined | novira.js لود نشده یا بعد از ماژول | ترتیب اسکریپت |
novira is not defined | alpine قبل از novira.js | alpine را آخر بگذارید |
Swiper is not defined | swiper لود نشده | اضافه کردن swiper-bundle |
Unexpected token در data-swiper | JSON نامعتبر | کوتیشن و کاما را چک کنید |
مشکلات نسخه 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.
دریافت کمک بیشتر
- Console و Network را اسکرینشات بگیرید
- نام فایل HTML و هاست را ذکر کنید
- بگویید تغییرات شخصیسازی چه بوده