scalajs all in one template

Plantilla de proyecto web estático Scala.js todo en uno

Este repositorio es una plantilla de la estructura básica para un proyecto web Scala.js, contiene las mejores tecnologías de la comunidad Scala.js hasta 2023:

• Sbt es la herramienta de construcción.
• Scala.js para compilar Scala a JavaScript.
• html.scala para plantillas HTML reactivas.
• Binding.scala para enlace de datos.
• sbt-sassify para compilar Sass en CSS.
• Font Awesome como ejemplo de dependencia de Sass.
• Bootstrap para componentes de interfaz de usuario responsivos.
• sbt-scala-js-map para mapeo de origen.
• scalajs-bundler para webpack y NPM (o YARN).
• ScalablyTyped para la definición de tipos de dependencias de NPM.
• pad como ejemplo de dependencia de NPM.
• sbt-web para WebJars.
• sbt-buildinfo para exponer la configuración de sbt al tiempo de ejecución.
• Coursier para descargar rápidamente dependencias de Maven e Ivy.
• sbt-example para generar ScalaTest a partir de ejemplos en los comentarios de Scaladoc.
• sbt-dynver para determinar la versión de compilación a partir de etiquetas git.

Tenga en cuenta que la rama predeterminada de este repositorio está escrita en Scala 3. Consulte la rama scala-2.13 para obtener una plantilla de proyecto en Scala 2.13.

Se pueden encontrar otras bibliotecas y herramientas en la configuración de sbt.

Esta plantilla contiene configuraciones para un proyecto web estático y, además, puede configurar las dependencias HTTP de Play o Akka en web/build.sbt para convertirlo en un proyecto web dinámico.

Estructura del directorio

• web/

  El proyecto sbt-web para activos web

  • construir.sbt

    Configuración de sbt para el proyecto sbt-web, que contiene configuraciones de dependencia de WebJars, incluidas dependencias SASS/SCSS y recursos estáticos de bibliotecas externas.

  • src/principal/activos/

    El directorio raíz de fuentes de activos estáticos.

    • índice.html

      La página principal en modo de lanzamiento, que hace referencia a recursos CSS y JS feos.

    • devMod.html

      La página principal en modo de desarrollo, que hace referencia a recursos CSS y JS sangrados.

    • estilo.scss

      La hoja de estilo utilizada por la página principal en la sintaxis SCSS, que será compilada en style.css mediante una canalización sbt-web.

  • destino/web/público/principal/

    El directorio raíz de la salida de activos estáticos.

    • biblioteca/

      El directorio de salida para las dependencias de Webjars.

• js/

  El proyecto Scala.js para crear resultados JS utilizados en el proyecto sbt-web.

  • construir.sbt

    Configuración de SBT para el proyecto Scala.js, que contiene configuraciones de Scala.js, dependencias de NPM y definiciones de tipos.

  • src/principal/scala/

    El directorio contiene archivos fuente de Scala.js.

• proyecto/

  • complementos.sbt

    Dependencias de complementos de sbt.

Requisitos

• Java 8+
• lanzador sbt
• Node.js o nodenv

¿Cómo utilizar esta plantilla?

Simplemente clone este repositorio y las siguientes tareas sbt estarán disponibles.

Construir

Ejecute el siguiente comando:

sbt assets

Luego visite web/target/web/public/main/devMod.html para navegar por la página principal.

Construcción del modo de lanzamiento

De forma predeterminada, el comando assets compila Scala.js en modo de desarrollo. Para construir este proyecto en modo de lanzamiento

sbt " set scalaJSStage := FullOptStage " assets

Luego visite web/target/web/public/main/index.html para navegar por la página principal en modo de lanzamiento.

Prueba

Ejecute el siguiente comando:

sbt test

Luego, ScalaTest ejecutará los ejemplos en los comentarios de Scaladoc.