jss

Sitecore JavaScript Rendering SDK (JSS)

يحتوي هذا المستودع على رمز مصدر لجميع حزم وقوالب Sitecore JSS لمساعدتك في البدء باستخدام Sitecore JSS.

البدء مع JSS

لتطوير تطبيق JSS ، تحتاج إلى:

• نظام تشغيل تدعمه العقدة (Mac ، Windows ، Linux).
• العقدة. نوصي باستخدام أحدث إصدار دعم طويل الأجل (LTS).

لتشغيل تطبيق JSS في الإنتاج أو التطوير باستخدام بيانات Sitecore ، تحتاج إلى توصيل التطبيق الخاص بك بمثيل Sitecore مع وحدة الخدمات المطلوبة المثبتة (يتطلب ترخيص Sitecore Headless Services ). يتطلب Sitecore Windows ، لكن مثيل Sitecore لا يحتاج إلى أن يكون محليًا. يمكنك استخدام مثيل Sitecore مثبت في جهاز افتراضي أو على خادم بعيد.

حدد إصدار JSS لإصدار Sitecore الخاص بك

تقترن إصدارات JSS بإصدارات Sitecore. إصدار JSS الحالي متوافق مع أحدث إصدار من Sitecore.

إذا كنت تستخدم إصدارًا أقدم من Sitecore ، قبل إنشاء مشروع JSS ، فأنت بحاجة إلى تحديد إصدار JSS المتوافق مع إصدار Sitecore XP.

لتحديد إصدار JSS الصحيح لإصدار Sitecore XP الخاص بك:

• بالنسبة إلى Sitecore XP 7.5–9.3 ، في جدول توافق وحدات Sitecore لـ Sitecore XP 7.5 - 9.3 ، في القسم ، حدد إصدار خدمات JavaScript الصحيح لإصدار Sitecore الخاص بك.
• بالنسبة إلى Sitecore XP 10.0 وبعد ذلك ، في جدول توافق وحدات Sitecore لـ Sitecore XP 10.0 والإصدارات اللاحقة ، في القسم الخدمات المطلوبة ، حدد إصدار خدمات JavaScript الصحيح لإصدار Sitecore الخاص بك.

البدء مع أحدث إصدار من JSS

لإنشاء مشروع JSS:

1. في محطة ، قم بتشغيل أحد الأوامر التالية واتبع المطالبات:

    npm init sitecore-jss
   

   أو

    npx create-sitecore-jss
   

2. تغيير الدليل إلى مجلد التطبيق الخاص بك:

    cd my-first-jss-app
   

3. ابدأ خادم التطوير:

    jss start
   

العمل مع الإصدارات القديمة

إذا كنت بحاجة إلى استخدام إصدار أقدم من JSS ، فيجب عليك تثبيت JSS CLI الإصدار 19.x أو أكبر.

لإنشاء مشروع JSS لإصدار أقدم من JSS و Sitecore:

1. حدد إصدار JSS الصحيح لإصدار Sitecore XP الخاص بك.

2. قم بتشغيل أمر تثبيت JSS CLI:

    npm i @sitecore-jss/sitecore-jss-cli@<version>
   

   استبدل <version> بإصدارك المطلوب. على سبيل المثال ، npm i @sitecore-jss/[email protected] .

3. في محطة ، قم بإنشاء مشروع JSS الخاص بك عن طريق تشغيل الأمر التالي:

    jss create my-jss-app react --branch release/13.0.0
   

   يستخدم الأمر خيار --branch وتحتاج إلى توفير اسم فرع في مستودع JSS. يمكنك استخدام فرع الإصدار أو أي فرع آخر من المستودع.

4. تغيير الدليل إلى مجلد التطبيق الخاص بك:

    cd my-first-jss-app
   

5. ابدأ خادم التطوير:

    jss start
   

الوثائق وموارد المجتمع

• وثائق JSS الرسمية:
  • سحابة XM
  • XP
• stackexchange
• المجتمع الركود
• منتدى مجتمع Sitecore

مساهمات

نحن ممتنون للغاية للمجتمع للمساهمة في إصلاحات الأخطاء والتحسينات. نرحب بكل الجهود المبذولة لتطوير وتحسين STECORE JavaScript Prendering SDK ؛ اقرأ أدناه لمعرفة كيفية المشاركة في تلك الجهود.

مدونة لقواعد السلوك

اعتمدت Sitecore مدونة قواعد سلوك نتوقع من المشاركين في المشروع الالتزام بها. يرجى قراءة النص الكامل حتى تتمكن من فهم الإجراءات التي ستحملها ولن يتم التسامح معها.

دليل المساهمة

اقرأ دليلنا المساهمين للتعرف على عملية التطوير الخاصة بنا ، وكيفية اقتراح إصلاحات الأخطاء والتحسينات ، وكيفية بناء واختبار التغييرات الخاصة بك للرد.

رخصة

تستخدم Sitecore JavaScript Services ترخيص Apache 2.0.

يدعم