jss

Sitecore JavaScript Rendering SDK (JSS)

Repositori ini berisi kode sumber untuk semua paket dan templat Sitecore JSS untuk membantu Anda memulai menggunakan Sitecore JSS.

Memulai dengan JSS

Untuk mengembangkan aplikasi JSS, Anda perlu:

• Sistem operasi yang didukung oleh Node (Mac, Windows, Linux).
• Node. Kami merekomendasikan menggunakan rilis Dukungan Jangka Panjang (LTS) terbaru.

Untuk menjalankan aplikasi JSS dalam produksi atau mengembangkan menggunakan data Sitecore, Anda perlu menghubungkan aplikasi Anda ke instance Sitecore dengan modul Layanan Headless yang diinstal (memerlukan lisensi Layanan Kepala Sitecore ). Sitecore membutuhkan Windows , tetapi instance Sitecore tidak perlu lokal. Anda dapat menggunakan instance Sitecore yang diinstal di mesin virtual atau di server jarak jauh.

Identifikasi versi JSS untuk versi Sitecore Anda

Versi JSS digabungkan dengan versi Sitecore. Rilis JSS saat ini kompatibel dengan versi Sitecore terbaru.

Jika Anda menggunakan versi Sitecore yang lebih lama, sebelum membuat proyek JSS, Anda perlu menentukan versi JSS mana yang kompatibel dengan versi Sitecore XP Anda.

Untuk mengidentifikasi versi JSS yang benar untuk versi XP Sitecore Anda:

• Untuk Sitecore XP 7.5—9.3, dalam tabel kompatibilitas modul Sitecore untuk Sitecore XP 7.5—9.3, di bagian Layanan Tanpa Kepala , identifikasi versi layanan JavaScript yang benar untuk versi Sitecore Anda.
• Untuk Sitecore XP 10.0 dan yang lebih baru, dalam tabel kompatibilitas modul Sitecore untuk Sitecore XP 10.0 dan versi yang lebih baru, di bagian Layanan Headless , identifikasi versi layanan JavaScript yang benar untuk versi Sitecore Anda.

Memulai dengan versi terbaru JSS

Untuk membuat proyek JSS:

1. Di terminal, jalankan salah satu perintah berikut dan ikuti petunjuknya:

    npm init sitecore-jss
   

   atau

    npx create-sitecore-jss
   

2. Ubah direktori ke folder aplikasi Anda:

    cd my-first-jss-app
   

3. Mulai server pengembangan:

    jss start
   

Bekerja dengan versi yang lebih lama

Jika Anda perlu menggunakan JSS versi yang lebih lama, Anda harus menginstal JSS CLI versi 19.x atau lebih tua.

Untuk membuat proyek JSS untuk versi JSS dan Sitecore yang lebih lama:

1. Identifikasi versi JSS yang benar untuk versi XP Sitecore Anda.

2. Jalankan perintah instalasi JSS CLI:

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

   Ganti <version> dengan versi yang Anda inginkan. Misalnya, npm i @sitecore-jss/[email protected] .

3. Di terminal, buat proyek JSS Anda dengan menjalankan perintah berikut:

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

   Perintah ini menggunakan opsi --branch dan Anda perlu memberikan nama cabang di repositori JSS. Anda dapat menggunakan cabang rilis atau cabang lain dari repositori.

4. Ubah direktori ke folder aplikasi Anda:

    cd my-first-jss-app
   

5. Mulai server pengembangan:

    jss start
   

Dokumentasi dan Sumber Daya Komunitas

• Dokumentasi JSS Resmi:
  • XM Cloud
  • Xp
• StackExchange
• Slack komunitas
• Forum Komunitas Sitecore

Kontribusi

Kami sangat berterima kasih kepada masyarakat karena berkontribusi perbaikan dan perbaikan bug. Kami menyambut semua upaya untuk mengembangkan dan meningkatkan Sitecore JavaScript Rendering SDK; Baca di bawah untuk mempelajari cara berpartisipasi dalam upaya tersebut.

Kode Etik

Sitecore telah mengadopsi kode etik yang kami harapkan untuk dipatuhi peserta proyek. Harap baca teks lengkapnya sehingga Anda dapat memahami tindakan apa yang akan dan tidak akan ditoleransi.

Panduan Kontribusi

Baca panduan berkontribusi kami untuk mempelajari tentang proses pengembangan kami, cara mengusulkan perbaikan dan perbaikan bug, dan cara membangun dan menguji perubahan Anda untuk bereaksi.

Lisensi

Layanan Sitecore JavaScript menggunakan lisensi Apache 2.0.

Mendukung