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).
• ScalallyTyped لتعريف نوع تبعيات 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 والموارد الثابتة من المكتبات الخارجية.

  • سرك/الرئيسية/الأصول/

    الدليل الجذر لمصادر الأصول الثابتة.

    • Index.html

      الصفحة الرئيسية في وضع الإصدار، والتي تشير إلى موارد CSS وJS القبيحة.

    • devMod.html

      الصفحة الرئيسية في وضع التطوير، والتي تشير إلى موارد CSS وJS ذات مسافة بادئة.

    • style.scss

      ورقة الأنماط المستخدمة بواسطة الصفحة الرئيسية في بناء جملة SCSS، والتي سيتم تجميعها إلى style.css بواسطة خط أنابيب sbt-web.

  • الهدف/الويب/العامة/الرئيسية/

    الدليل الجذر لمخرجات الأصول الثابتة.

    • ليب/

      دليل الإخراج لتبعيات Webjars.

• شبيبة /

  مشروع Scala.js لإنشاء مخرجات JS المستخدمة في مشروع sbt-web.

  • build.sbt

    إعدادات Sbt لمشروع Scala.js، الذي يحتوي على إعدادات Scala.js وتبعيات NPM وتعريفات النوع.

  • سرك/الرئيسية/سكالا/

    يحتوي الدليل على ملفات مصدر Scala.js.

• مشروع/

  • plugins.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.