التوليد الثابت

تصيّر حزمة ‎@carats/ssg‎ تطبيق Carats مسبقًا إلى HTML ثابت، وهو مفيد للمواقع التي لا تحتاج خادمًا حيًا.

السكربت

أضف سكربت البناء الثابت إلى package.json. فهو يشغّل الملف التنفيذي carats-ssg مع ‎NODE_ENV=production‎، لذا تُنتج خط البناء نفسه المخرجات الثابتة.

{
  "scripts": {
    "build:static": "cross-env NODE_ENV=production carats-ssg"
  }
}

يأتي الملف التنفيذي ‎`carats-ssg`‎ من حزمة ‎`@carats/ssg`‎، ولهذا هو اعتمادية تشغيل لا اعتمادية تطوير: المخرجات المُصيَّرة مسبقًا هي مُخرَج نشر.

متى تستخدمه

محتوى متطابق لكل زائر، مثل صفحات التسويق والتوثيق.

• عمليات نشر لا تحتاج سوى CDN أو مستضيف ملفات.
• المواقع التي ما زالت تحتاج بيانات لكل طلب ينبغي أن تستخدم التكامل مع Express بدلًا من ذلك، لأن الدالة الخادمية قد تعتمد على الطلب.

لا يأتي الملف التنفيذي carats-ssg بإعلانات TypeScript خاصة به؛ تعامل معه كأداة سطر أوامر واحتفظ بأنواع الإطار في ‎@carats/ssr‎.

قد تقرأ الدالة الخادمية الكوكيز أو الترويسات أو سلسلة الاستعلام. ولا يمكن تصيير أي مسار يعتمد على دالة خادمية كذلك مسبقًا بصورة ذات معنى، لأن المخرجات ستُجمَّد ببيانات زائر واحد. أبقِ تلك المسارات في بناء SSR، أو علِّم المكوّن المستهلك بـ ‎{ recast: true }‎ واقبل أن يحمل المخرج الثابت بيانات نائبة.