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 編寫的。

其他庫和工具可以在 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運行。