scalajs all in one template

Modelo de projeto da Web estático Scala.js multifuncional

Este repositório é um modelo de estrutura básica para um projeto web Scala.js, contém todas as melhores tecnologias da comunidade Scala.js até 2023:

• Sbt é a ferramenta de construção.
• Scala.js para compilar Scala para JavaScript.
• html.scala para modelos HTML reativos.
• Binding.scala para ligação de dados.
• sbt-sassify para compilar Sass para CSS.
• Font Awesome como exemplo de dependência de Sass.
• Bootstrap para componentes de UI responsivos.
• sbt-scala-js-map para mapeamento de origem.
• scalajs-bundler para webpack e NPM (ou YARN).
• ScalablyTyped para definição de tipo de dependências NPM.
• pad como um exemplo de dependência do NPM.
• sbt-web para WebJars.
• sbt-buildinfo para expor as configurações do sbt em tempo de execução.
• Cursor para download rápido de dependências Maven e ivy.
• sbt-example para gerar ScalaTest a partir de exemplos em comentários do Scaladoc.
• sbt-dynver para determinar a versão de compilação a partir de tags git.

Observe que a ramificação padrão deste repositório é escrita em Scala 3. Verifique a ramificação scala-2.13 para obter um modelo de projeto em Scala 2.13.

Outras bibliotecas e ferramentas podem ser encontradas nas configurações do sbt.

Este modelo contém configurações para um projeto web estático, e você também pode configurar dependências HTTP Play ou Akka em web/build.sbt para transformá-lo em um projeto web dinâmico.

Estrutura de diretório

• rede/

  O projeto sbt-web para ativos da web

  • construir.sbt

    Configurações SBT para o projeto sbt-web, que contém configurações de dependências WebJars, incluindo dependências SASS/SCSS e recursos estáticos de bibliotecas externas.

  • src/principal/ativos/

    O diretório raiz das fontes de ativos estáticos.

    • index.html

      A página principal em modo de lançamento, que faz referência a recursos CSS e JS feios.

    • devMod.html

      A página principal em modo de desenvolvimento, que faz referência a recursos CSS e JS recuados.

    • estilo.scss

      A folha de estilo usada pela página principal na sintaxe SCSS, que será compilada em style.css por um pipeline sbt-web.

  • alvo/web/público/principal/

    O diretório raiz da saída de ativos estáticos.

    • biblioteca/

      O diretório de saída para dependências de Webjars.

• js/

  O projeto Scala.js para criar a saída JS usada no projeto sbt-web.

  • construir.sbt

    Configurações Sbt para o projeto Scala.js, que contém configurações de Scala.js, dependências NPM e definições de tipo.

  • src/principal/escala/

    O diretório contém arquivos de origem Scala.js.

• projeto/

  • plugins.sbt

    Dependências de plug-ins SBT.

Requisitos

• Java 8+
• Lançador SBT
• Node.js ou nodenv

Como usar este modelo?

Basta clonar este repositório e as seguintes tarefas sbt estarão disponíveis.

Construir

Execute o seguinte comando:

sbt assets

Em seguida, visite web/target/web/public/main/devMod.html para navegar na página principal.

Compilação do modo de liberação

Por padrão, o comando assets cria Scala.js no modo de desenvolvimento. Para construir este projeto no modo de lançamento

sbt " set scalaJSStage := FullOptStage " assets

Em seguida, visite web/target/web/public/main/index.html para navegar na página principal no modo de lançamento.

Teste

Execute o seguinte comando:

sbt test

Em seguida, os exemplos nos comentários do Scaladoc serão executados pelo ScalaTest.