scalajs all in one template

Templat Proyek Web Statis Scala.js All-in-One

Repositori ini adalah templat struktur dasar untuk proyek web Scala.js, berisi semua teknologi terbaik di komunitas Scala.js hingga tahun 2023:

• Sbt adalah alat pembangunan.
• Scala.js untuk mengkompilasi Scala ke JavaScript.
• html.scala untuk templating HTML reaktif.
• Binding.scala untuk pengikatan data.
• sbt-sassify untuk mengkompilasi Sass ke CSS.
• Font Awesome sebagai contoh ketergantungan Sass.
• Bootstrap untuk komponen UI responsif.
• sbt-scala-js-map untuk pemetaan sumber.
• scalajs-bundler untuk webpack dan NPM (atau YARN).
• ScalablyTyped untuk definisi tipe dependensi NPM.
• pad sebagai contoh ketergantungan NPM.
• sbt-web untuk WebJars.
• sbt-buildinfo untuk mengekspos pengaturan sbt ke runtime.
• Kurir untuk mengunduh dependensi Maven dan ivy dengan cepat.
• sbt-example untuk menghasilkan ScalaTest dari contoh di komentar Scaladoc.
• sbt-dynver untuk menentukan versi build dari tag git.

Perhatikan bahwa cabang default repositori ini ditulis dalam Scala 3. Lihat cabang scala-2.13 untuk templat proyek di Scala 2.13.

Perpustakaan dan alat lain dapat ditemukan di pengaturan sbt.

Templat ini berisi pengaturan untuk proyek web statis, dan Anda juga dapat mengonfigurasi dependensi HTTP Play atau Akka di web/build.sbt untuk mengubahnya menjadi proyek web dinamis.

Struktur Direktori

• web/

  Proyek sbt-web untuk aset web

  • membangun.sbt

    Pengaturan sbt untuk proyek sbt-web, yang berisi konfigurasi dependensi WebJars, termasuk dependensi SASS/SCSS dan sumber daya statis dari perpustakaan eksternal.

  • src/utama/aset/

    Direktori akar sumber aset statis.

    • indeks.html

      Halaman utama dalam mode rilis, yang mereferensikan sumber daya CSS dan JS yang jelek.

    • devMod.html

      Halaman utama dalam mode pengembangan, yang mereferensikan sumber daya CSS dan JS yang diindentasi.

    • gaya.scss

      Style sheet yang digunakan oleh halaman utama dalam sintaks SCSS, yang akan dikompilasi ke style.css oleh pipeline sbt-web.

  • target/web/publik/utama/

    Direktori akar keluaran aset statis.

    • perpustakaan/

      Direktori keluaran untuk dependensi Webjars.

• js/

  Proyek Scala.js untuk membuat keluaran JS yang digunakan dalam proyek sbt-web.

  • membangun.sbt

    Pengaturan Sbt untuk proyek Scala.js, yang berisi pengaturan Scala.js, dependensi NPM, dan definisi tipe.

  • src/utama/skala/

    Direktori berisi file sumber Scala.js.

• proyek/

  • plugin.sbt

    Ketergantungan plugin sbt.

Persyaratan

• Jawa 8+
• Peluncur Sbt
• Node.js atau nodev

Bagaimana cara menggunakan templat ini?

Cukup kloning repositori ini, dan tugas sbt berikut tersedia.

Membangun

Jalankan perintah berikut:

sbt assets

Kemudian kunjungi web/target/web/public/main/devMod.html untuk menelusuri halaman utama.

Pembuatan mode rilis

Secara default, perintah assets membangun Scala.js dalam mode pengembangan. Untuk membangun proyek ini dalam mode rilis

sbt " set scalaJSStage := FullOptStage " assets

Kemudian kunjungi web/target/web/public/main/index.html untuk menelusuri halaman utama dalam mode rilis.

Tes

Jalankan perintah berikut:

sbt test

Kemudian contoh di komentar Scaladoc akan dijalankan oleh ScalaTest.