عیب‌یابی
اول کنسول مرورگر را باز کنید (F12، تب Console). بیشتر مشکل‌ها یک خطای قرمز آنجا دارند.
صفحه خالی است یا x-text خام دیده می‌شود
- ترتیب اسکریپت‌ها را بررسی کنید:
premium.js، سپس فایل صفحه، سپسalpine.jsباdefer(راهنمای صفحه‌ها). - نام تابع در
x-dataبا نام تابع فایل JS یکی باشد؛ مثلاًpremiumCart()درpremium-cart.js. - خطای
premiumShared is not definedیعنیpremium.jsلود نشده یا مسیرش اشتباه است.
فونت فارسی نمایش داده نمی‌شود
- در تب Network، فایل‌های
.woff2باید وضعیت 200 داشته باشند. اگر 404 است، پوشهassets/fonts/کامل آپلود نشده. - روی Apache،
.htaccessنمونه نوعfont/woff2را تنظیم می‌کند. روی سرورهای قدیمی بدون آن، فونت ممکن است رد شود. - اگر صفحه را از دیسک باز کرده‌اید و فونت نیامده، مسیر پوشه را بررسی کنید؛ فایل‌های HTML باید کنار پوشه
assets/باشند.
شمارنده سبد به‌روز نمی‌شود
شیء صفحه را با dsData({...}) برگردانید، نه با پخش ساده ...premiumShared() (معماری جاوااسکریپت). پخش ساده getter cartCount را منجمد می‌کند.
سبد بعد از بستن مرورگر خالی می‌شود
عمدی است: سبد نمایشی در sessionStorage است و با بستن تب پاک می‌شود. برای سبد ماندگار، dsLoadCart و dsSaveCart را به سرور وصل کنید یا در آن‌ها localStorage بگذارید.
هدر یا فوتر یک صفحه قدیمی است
بعد از ویرایش _partials/، از ریشه پروژه اجرا کنید:
node scripts/sync-partials.mjs
سه صفحه اول هدر و فوتر خودشان را دارند و باید جداگانه ویرایش شوند.
چیزی در صفحه ظاهر نمی‌شود (نیمه‌شفاف می‌ماند)
عناصر data-reveal پس از رسیدن به صفحه ظاهر می‌شوند. اگر pc.js لود نشده باشد ممکن است پنهان بمانند؛