scalajs all in one template

Универсальный шаблон статического веб-проекта Scala.js

Этот репозиторий представляет собой шаблон базовой структуры веб-проекта Scala.js, содержит все лучшие технологии сообщества Scala.js до 2023 года:

• Sbt — это инструмент сборки.
• Scala.js для компиляции Scala в JavaScript.
• html.scala для реактивного HTML-шаблона.
• Binding.scala для привязки данных.
• sbt-sassify для компиляции Sass в CSS.
• Font Awesome как пример зависимости Sass.
• Bootstrap для адаптивных компонентов пользовательского интерфейса.
• sbt-scala-js-map для сопоставления источников.
• scalajs-bundler для веб-пакета и NPM (или YARN).
• ScalabilityTyped для определения типа зависимостей NPM.
• Pad как пример зависимости NPM.
• sbt-web для WebJars.
• sbt-buildinfo, чтобы предоставить настройки sbt во время выполнения.
• Курсьер для быстрой загрузки зависимостей Maven и Ivy.
• sbt-example для создания ScalaTest на основе примеров в комментариях Scaladoc.
• sbt-dynver для определения версии сборки по тегам git.

Обратите внимание, что ветка этого репозитория по умолчанию написана на Scala 3. Проверьте ветку scala-2.13 на наличие шаблона проекта в Scala 2.13.

Другие библиотеки и инструменты можно найти в настройках sbt.

Этот шаблон содержит настройки для статического веб-проекта, и вы можете дополнительно настроить HTTP-зависимости Play или Akka в web/build.sbt чтобы превратить его в динамический веб-проект.

Структура каталогов

• сеть/

  Проект sbt-web для веб-ресурсов

  • build.sbt

    Настройки Sbt для проекта sbt-web, который содержит конфигурации зависимостей WebJars, включая зависимости SASS/SCSS и статические ресурсы из внешних библиотек.

  • источник/основной/активы/

    Корневой каталог источников статических ресурсов.

    • index.html

      Главная страница в режиме выпуска, которая ссылается на уродливые ресурсы CSS и JS.

    • devMod.html

      Главная страница в режиме разработки, которая ссылается на ресурсы CSS и JS с отступом.

    • стиль.scss

      Таблица стилей, используемая главной страницей в синтаксисе SCSS, которая будет скомпилирована в style.css конвейером sbt-web.

  • целевой/веб/публичный/основной/

    Корневой каталог вывода статических ресурсов.

    • библиотека/

      Выходной каталог для зависимостей Webjars.

• js/

  Проект Scala.js для создания выходных данных JS, используемый в проекте sbt-web.

  • build.sbt

    Настройки Sbt для проекта Scala.js, который содержит настройки Scala.js, зависимости NPM и определения типов.

  • источник/основной/скала/

    Каталог содержит исходные файлы Scala.js.

• проект/

  • плагины.sbt

    Зависимости плагинов Sbt.

Требования

• Ява 8+
• СБТ пусковая установка
• 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 чтобы просмотреть главную страницу в режиме выпуска.

Тест

Выполните следующую команду:

sbt test

Затем примеры в комментариях Scaladoc будут запущены ScalaTest.