SD راهنمای سوپردوپر مارکت صفحه معرفی صفحه اصلی قالب

اجرای محلی

آیا سرور محلی لازم است؟

نه الزاماً. قالب عمداً طوری ساخته شده که با دابل‌کلیک و پروتکل file:// هم کار کند:

  • داده‌ی کالاها از assets/data/products.js می‌آید که window.SUPERIUM_PRODUCTS را مقدار می‌دهد - یعنی یک <script> معمولی، نه fetch. بنابراین محدودیت CORS مرورگر برای فایل‌های محلی مشکلی ایجاد نمی‌کند.
  • فونت‌ها، CSS و JS همه داخل بسته‌اند.

اما با سرور محلی همه‌چیز دقیقاً مثل هاست واقعی رفتار می‌کند و توصیه می‌شود.

روش ۱ - پایتون (بدون نصب چیز اضافه)

اگر پایتون دارید:

cd superdouper-market
python -m http.server 8000

سپس در مرورگر: http://localhost:8000/demo.html

روش ۲ - VS Code + افزونه Live Server

  1. افزونه‌ی Live Server را نصب کنید.
  2. روی demo.html راست‌کلیک کنید → Open with Live Server.
  3. با هر ذخیره‌ی فایل، مرورگر خودکار رفرش می‌شود.

روش ۳ - Node.js

اگر Node نصب دارید:

npx serve .
# یا
npx http-server -p 8000

Node فقط برای همین سرور ساده است. قالب هیچ وابستگی npm ندارد و package.json نمی‌خواهد.

تفاوت‌های file:// با سرور

موردبا file://با سرور
صفحات و استایلکار می‌کندکار می‌کند
داده‌ی کالا و سبد خریدکار می‌کندکار می‌کند
نقشه (کاشی OpenStreetMap)نیاز به اینترنتنیاز به اینترنت
localStorageکار می‌کند ولی برای همه‌ی فایل‌های محلی مشترک استمثل سایت واقعی، مخصوص همان دامنه
مسیرهای مطلق (/assets/...)کار نمی‌کندکار می‌کند

قالب همه‌جا از مسیر نسبی استفاده می‌کند (assets/... نه /assets/...) تا هم روی file:// و هم داخل زیرپوشه‌ی هاست کار کند. اگر مسیرها را به مطلق تغییر دادید، دیگر از file:// باز نمی‌شود.

ویرایش هم‌زمان با اجرا

هیچ مرحله‌ی build و watch لازم نیست:

  1. فایل .html یا .css را ویرایش کنید.
  2. ذخیره کنید.
  3. مرورگر را رفرش کنید (Ctrl+Shift+R برای رد کردن کش).

اگر ترجیح می‌دهید به‌جای فایل‌های HTML، مولدهای پایتون را ویرایش کنید، به ابزارهای ساخت بروید.

گام بعدی