scalajs all in one template

Modèle de projet Web statique tout-en-un Scala.js

Ce référentiel est un modèle de la structure de base d'un projet Web Scala.js, contient toutes les meilleures technologies de la communauté Scala.js jusqu'en 2023 :

• Sbt est l'outil de construction.
• Scala.js pour compiler Scala en JavaScript.
• html.scala pour les modèles HTML réactifs.
• Binding.scala pour la liaison de données.
• sbt-sassify pour compiler Sass en CSS.
• Font Awesome comme exemple de dépendance Sass.
• Bootstrap pour les composants d'interface utilisateur réactifs.
• sbt-scala-js-map pour le mappage des sources.
• scalajs-bundler pour webpack et NPM (ou YARN).
• ScalablyTyped pour la définition de type des dépendances NPM.
• pad comme exemple de dépendance NPM.
• sbt-web pour les WebJars.
• sbt-buildinfo pour exposer les paramètres sbt au runtime.
• Coursier pour le téléchargement rapide des dépendances Maven et Ivy.
• sbt-example pour générer ScalaTest à partir d'exemples dans les commentaires Scaladoc.
• sbt-dynver pour déterminer la version de build à partir des balises git.

Notez que la branche par défaut de ce référentiel est écrite en Scala 3. Consultez la branche scala-2.13 pour un modèle de projet dans Scala 2.13.

D'autres bibliothèques et outils peuvent être trouvés dans les paramètres sbt.

Ce modèle contient les paramètres d'un projet Web statique et vous pouvez également configurer les dépendances HTTP Play ou Akka dans web/build.sbt pour le transformer en un projet Web dynamique.

Structure du répertoire

• Internet/

  Le projet sbt-web pour les ressources Web

  • construire.sbt

    Paramètres Sbt pour le projet sbt-web, qui contient les configurations de dépendances WebJars, y compris les dépendances SASS/SCSS et les ressources statiques des bibliothèques externes.

  • src/main/actifs/

    Le répertoire racine des sources d'actifs statiques.

    • index.html

      La page principale en mode release, qui référence des ressources CSS et JS uglifiées.

    • devMod.html

      La page principale en mode développement, qui référence les ressources CSS et JS en retrait.

    • style.scss

      La feuille de style utilisée par la page principale dans la syntaxe SCSS, qui sera compilée en style.css par un pipeline sbt-web.

  • cible/web/public/main/

    Le répertoire racine de la sortie des actifs statiques.

    • lib/

      Le répertoire de sortie pour les dépendances Webjars.

• js/

  Le projet Scala.js pour créer une sortie JS utilisée dans le projet sbt-web.

  • construire.sbt

    Paramètres Sbt pour le projet Scala.js, qui contient les paramètres Scala.js, les dépendances NPM et les définitions de type.

  • src/main/scala/

    Le répertoire contient les fichiers sources Scala.js.

• projet/

  • plugins.sbt

    Dépendances des plugins Sbt.

Exigences

• Java8+
• Lanceur SBT
• Node.js ou nodenv

Comment utiliser ce modèle ?

Clonez simplement ce référentiel et les tâches sbt suivantes sont disponibles.

Construire

Exécutez la commande suivante :

sbt assets

Visitez ensuite web/target/web/public/main/devMod.html pour parcourir la page principale.

Construction en mode version

Par défaut, la commande assets construit Scala.js en mode développement. Pour construire ce projet en mode release

sbt " set scalaJSStage := FullOptStage " assets

Visitez ensuite web/target/web/public/main/index.html pour parcourir la page principale en mode release.

Test

Exécutez la commande suivante :

sbt test

Ensuite, les exemples contenus dans les commentaires Scaladoc seront exécutés par ScalaTest.