مستنداتنسخهٔ ۲٫۰نمونهٔ زنده
مستنداتشروعنصب و راه‌اندازی

نصب و راه‌اندازی

چند گام برای رساندن کیت از حالت نمایشی به صفحه‌های آمادهٔ انتشار.

نصب گام‌به‌گام#

  1. فایل‌ها را کپی کنید

    فایل zip را باز کنید و پوشهٔ mehmannavaz را در بخش عمومی پروژه (مثلاً public/ یا ریشهٔ هاست) قرار دهید. همهٔ مسیرها نسبی هستند، بنابراین پوشه را می‌توان زیر هر زیرمسیری گذاشت.

  2. پیش‌نمایش بگیرید

    برای دیدن صفحه‌ها کافی است index.html را در مرورگر باز کنید. هنگام اتصال به سرور، پوشه را با یک وب‌سرور محلی اجرا کنید تا fetch درست کار کند:

    Terminal
    python3 -m http.server 8080
# یا
npx serve .
  3. فونت را اضافه کنید

    فایل Vazirmatn-Variable.woff2 را در assets/fonts/ بگذارید. جزئیات در بخش [فونت](#font).

  4. تنظیمات را بنویسید

    در assets/js/config.js مقدار demo را false کنید و نشانی سرویس‌ها را بنویسید ([مرجع تنظیمات](javascript.html#config)).

  5. پیوندهای مقصد را جایگزین کنید

    پیوندهای بازگشت به صفحهٔ اصلی و داشبورد را با نشانی‌های برنامهٔ خود عوض کنید ([فهرست پیوندها](#links)).

  6. فایل‌های غیرضروری را حذف کنید

    برای انتشار فقط pages/ و assets/ لازم است. پوشهٔ docs/، فایل index.html و فایل‌های متنی ریشه را حذف کنید.

فونت#

فونت پیش‌فرض Vazirmatn است. mehmannavaz.css ابتدا فونت نصب‌شده روی دستگاه، سپس فایل assets/fonts/Vazirmatn-Variable.woff2 و در نهایت Tahoma و فونت سیستم را امتحان می‌کند.

صفحه‌ها یک شیوه‌نامهٔ اختیاری از Google Fonts هم بارگذاری می‌کنند که بدون مسدود کردن نمایش صفحه لود می‌شود. اگر فایل فونت را خودتان میزبانی می‌کنید و به آن نیازی ندارید، این چهار تگ را از <head> صفحه‌ها حذف کنید:

HTML
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Vazirmatn:wght@300..800&display=swap" media="print" onload="this.media='all'">
<noscript><link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Vazirmatn:wght@300..800&display=swap"></noscript>

برای استفاده از فونت دیگر، [بخش فونت در رنگ و تم](theme.html#fonts) را ببینید.

چند پیوند به صفحهٔ نمایشی کیت اشاره می‌کنند و باید به نشانی‌های برنامهٔ شما تغییر کنند:

فایلعنصرمقدار پیش‌فرض
همهٔ صفحه‌هالوگوی بالای صفحه (.topbar .logo)../index.html
success.htmlدکمهٔ «ورود به داشبورد»../index.html
error.htmlدکمهٔ «بازگشت به خانه»../index.html
locked.htmlدکمهٔ بازیابی و بازگشتforgot-password.html و login.html

مقصد پس از موفقیت هر فرم با صفت data-next تعیین می‌شود؛ [صفحه‌ها و مسیر حرکت](pages.html#flow) را ببینید.

انتشار#

کیت فایل ایستا است و روی هر وب‌سرور یا CDN اجرا می‌شود. اگر صفحه‌ها را از سرور برنامهٔ خود سرو می‌کنید، موارد زیر را در نظر داشته باشید:

صفحهٔ قبل→ مقدمهصفحهٔ بعدساختار فایل‌ها ←
مهمان‌نواز نسخهٔ ۲٫۰ · مهر ۱۴۰۵فهرست تغییرات