jolt-jni-docs

يوفر jolt-jni-docs توثيقًا وتطبيقات سطح مكتب نموذجية لمكتبة Jolt-JNI للفيزياء ثلاثية الأبعاد. يتنظم المستودع في 12 مشروعًا فرعيًا: مجموعة توثيق خارجية قائمة على Antora تتضمن برنامجًا تعليميًا؛ و27 تطبيقًا نموذجيًا مكتوبًا بـ Java؛ ونُسخ منقولة من تلك النماذج إلى Jython (Python)، وScala، وClojure (9 نماذج)، وKotlin (9)، وNashorn JavaScript (8)، وJRuby (4)، وGroovy المُجمَّع ساكنًا (3)، وGroovy النصي (3)، وLuaj (1)، وLuajava (1). تستخدم العديد من النماذج محرك الرسومات المنفصل SPORT الخاص بـ Jolt لتصور مشاهد الفيزياء. يتطلب بناء النماذج (باستثناء Clojure) إصدار JDK 21 أو أعلى، مع توجيه JAVA_HOME إلى مجلد التثبيت. يُستنسخ الكود المصدري من GitHub ويُبنى باستخدام غلاف Gradle المضمّن (./gradlew build على Bash أو Fish أو PowerShell أو Zsh؛ .\gradlew build على موجّه أوامر Windows). تُشغَّل النماذج الفردية عبر مهام Gradle، على سبيل المثال ./gradlew :java-apps:HelloJoltJni. أما نماذج Clojure فتتطلب بدلًا من ذلك JDK وأداة البناء Leiningen، وتُشغَّل عبر lein HelloJoltJni. يُولَّد توثيق Antora باستخدام Node.js وnpx antora docs/playbook.yml بعد تحرير docs/playbook.yml لاستبدال مسار الاستنساخ المطلق الخاص بالمؤلف. تعيد مهمة ./gradlew clean المشروع إلى حالته الأصلية النظيفة. يُقدَّم جميع الكود المصدري بموجب ترخيص BSD ثلاثي البنود. يوثّق ملف README خطوات الإعداد ومتغيرات البيئة والأوامر بدلًا من نتائج القياسات أو مقارنات الميزات.