scalajs all in one template

多合一 Scala.js 静态 Web 项目模板

该存储库是 Scala.js Web 项目基本结构的模板，包含 Scala.js 社区截至 2023 年的所有最佳技术：

• Sbt 是构建工具。
• Scala.js 将 Scala 编译为 JavaScript。
• html.scala 用于反应式 HTML 模板。
• Binding.scala 用于数据绑定。
• sbt-sassify 用于将 Sass 编译为 CSS。
• Font Awesome 作为 Sass 依赖项的示例。
• 用于响应式 UI 组件的 Bootstrap。
• sbt-scala-js-map 用于源映射。
• 用于 webpack 和 NPM（或 YARN）的 scalajs-bundler。
• ScalivelyTyped 用于 NPM 依赖项的类型定义。
• pad 作为 NPM 依赖项的示例。
• 用于 WebJars 的 sbt-web。
• sbt-buildinfo 将 sbt 设置公开给运行时。
• Coursier 用于快速下载 Maven 和 ivy 依赖项。
• sbt-example 从 Scaladoc 注释中的示例生成 ScalaTest。
• sbt-dynver 从 git 标签确定构建版本。

请注意，此存储库的默认分支是用 Scala 3 编写的。查看 scala-2.13 分支以获取 Scala 2.13 中的项目模板。

其他库和工具可以在 sbt 设置中找到。

该模板包含静态 Web 项目的设置，您还可以在web/build.sbt中配置 Play 或 Akka HTTP 依赖项，将其转换为动态 Web 项目。

目录结构

• 网络/

  用于网络资产的 sbt-web 项目

  • 构建.sbt

    sbt-web 项目的 sbt 设置，其中包含 WebJars 依赖项配置，包括 SASS / SCSS 依赖项和来自外部库的静态资源。

  • src/主/资产/

    静态资源源的根目录。

    • 索引.html

      发布模式下的主页面，引用了丑化的CSS和JS资源。

    • devMod.html

      开发模式下的主页面，引用了缩进的CSS和JS资源。

    • 样式.scss

      SCSS语法中主页面使用的样式表，将通过sbt-web管道编译为style.css 。

  • 目标/网络/公共/主要/

    静态资源输出的根目录。

    • 库/

      Webjar 依赖项的输出目录。

• js/

  Scala.js 项目用于创建 sbt-web 项目中使用的 JS 输出。

  • 构建.sbt

    Scala.js 项目的 Sbt 设置，其中包含 Scala.js 设置、NPM 依赖项和类型定义。

  • src/main/scala/

    该目录包含 Scala.js 源文件。

• 项目/

  • 插件.sbt

    Sbt 插件依赖项。

要求

• Java 8+
• SBT启动器
• Node.js 或 NodeNV

如何使用这个模板？

只需克隆此存储库，即可使用以下 sbt 任务。

建造

运行以下命令：

sbt assets

然后访问web/target/web/public/main/devMod.html浏览主页。

发布模式构建

默认情况下， assets命令在开发模式下构建 Scala.js。以发布模式构建此项目

sbt " set scalaJSStage := FullOptStage " assets

然后访问web/target/web/public/main/index.html以release模式浏览主页面。

测试

运行以下命令：

sbt test

然后Scaladoc注释中的示例将由ScalaTest运行。