scalajs all in one template

เทมเพลตโครงการเว็บแบบคงที่ Scala.js แบบ All-in-One

พื้นที่เก็บข้อมูลนี้เป็นเทมเพลตของโครงสร้างพื้นฐานสำหรับโปรเจ็กต์เว็บ Scala.js ซึ่งมีเทคโนโลยีที่ดีที่สุดในชุมชน Scala.js จนถึงปี 2023:

• Sbt เป็นเครื่องมือสร้าง
• Scala.js เพื่อรวบรวม Scala เป็น JavaScript
• html.scala สำหรับการสร้างเทมเพลต HTML แบบโต้ตอบ
• Binding.scala สำหรับการผูกข้อมูล
• sbt-sassify สำหรับรวบรวม Sass เป็น CSS
• Font Awesome เป็นตัวอย่างของการพึ่งพา Sass
• Bootstrap สำหรับส่วนประกอบ UI ที่ตอบสนอง
• sbt-scala-js-map สำหรับการแมปแหล่งที่มา
• scalajs-bundler สำหรับ webpack และ NPM (หรือ YARN)
• ScalableTyped สำหรับคำจำกัดความประเภทของการขึ้นต่อกันของ NPM
• pad เป็นตัวอย่างของการพึ่งพา NPM
• sbt-web สำหรับ WebJars
• sbt-buildinfo เพื่อแสดงการตั้งค่า sbt ให้กับรันไทม์
• Coursier สำหรับการดาวน์โหลดการพึ่งพา Maven และ ivy อย่างรวดเร็ว
• sbt-example เพื่อสร้าง ScalaTest จากตัวอย่างในความคิดเห็น Scaladoc
• sbt-dynver เพื่อกำหนดเวอร์ชันบิลด์จากแท็ก git

โปรดทราบว่าสาขาเริ่มต้นของพื้นที่เก็บข้อมูลนี้เขียนใน Scala 3 ตรวจสอบสาขา scala-2.13 เพื่อดูเทมเพลตโครงการใน Scala 2.13

ไลบรารีและเครื่องมืออื่นๆ สามารถพบได้ในการตั้งค่า sbt

เทมเพลตนี้มีการตั้งค่าสำหรับโปรเจ็กต์เว็บแบบคงที่ และคุณสามารถกำหนดค่าการพึ่งพา Play หรือ Akka HTTP เพิ่มเติมใน web/build.sbt เพื่อเปลี่ยนให้เป็นโปรเจ็กต์เว็บแบบไดนามิกได้

โครงสร้างไดเร็กทอรี

• เว็บ/

  โครงการ sbt-web สำหรับเนื้อหาเว็บ

  • build.sbt

    การตั้งค่า Sbt สำหรับโปรเจ็กต์ sbt-web ซึ่งมีการกำหนดค่าการพึ่งพา WebJars รวมถึงการพึ่งพา SASS / SCSS และทรัพยากรแบบคงที่จากไลบรารีภายนอก

  • src/หลัก/สินทรัพย์/

    ไดเรกทอรีรากของแหล่งที่มาของสินทรัพย์คงที่

    • ดัชนี.html

      หน้าหลักในโหมดเผยแพร่ ซึ่งอ้างอิงถึงทรัพยากร CSS และ JS ที่น่าเกลียด

    • devMod.html

      หน้าหลักในโหมดการพัฒนา ซึ่งอ้างอิงถึงทรัพยากร CSS และ JS ที่เยื้องไว้

    • สไตล์.scss

      สไตล์ชีตที่ใช้โดยหน้าหลักในรูปแบบ SCSS ซึ่งจะถูกคอมไพล์เป็น style.css โดยไปป์ไลน์ sbt-web

  • เป้าหมาย/เว็บ/สาธารณะ/หลัก/

    ไดเร็กทอรีรากของเอาต์พุตสินทรัพย์คงที่

    • ลิบ/

      ไดเร็กทอรีเอาต์พุตสำหรับการขึ้นต่อกันของ Webjars

• เจเอส/

  โปรเจ็กต์ Scala.js เพื่อสร้างเอาต์พุต JS ที่ใช้ในโปรเจ็กต์ sbt-web

  • build.sbt

    การตั้งค่า Sbt สำหรับโปรเจ็กต์ Scala.js ซึ่งประกอบด้วยการตั้งค่า Scala.js การพึ่งพา NPM และคำจำกัดความประเภท

  • src/หลัก/สกาล่า/

    ไดเร็กทอรีประกอบด้วยไฟล์ต้นฉบับ Scala.js

• โครงการ/

  • Plugins.sbt

    การพึ่งพาปลั๊กอิน Sbt

ความต้องการ

• จาวา 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 เพื่อเรียกดูหน้าหลักในโหมดเผยแพร่

ทดสอบ

รันคำสั่งต่อไปนี้:

sbt test

จากนั้นตัวอย่างในความคิดเห็น Scaladoc จะถูกรันโดย ScalaTest