इस प्रोजेक्ट के बारे में

नम्बस ब्राउज़र में पूरी तरह चलने वाले परीक्षण बनाने के लिए एक ओपन-सोर्स प्रणाली है, जिसे न्यूकैसल विश्वविद्यालय के स्कूल ऑफ़ मैथमेटिक्स, स्टैटिस्टिक्स एंड फ़िज़िक्स द्वारा विकसित किया गया है। यह गणित मूल्यांकन पर विशेष जोर देती है। इस रिपॉज़िटरी में नम्बस कंपाइलर शामिल है, जो स्टैंडअलोन पायथन 3 के रूप में चलता है। कंपाइलर इस पारिस्थितिकी तंत्र का कमांड-लाइन कोर है: उपलब्ध विकल्प देखने के लिए `python bin/numbas.py` चलाएँ, और इसे किसी `.exam` फ़ाइल का नाम दें या एक को पाइप करें। हालाँकि, नम्बस का उपयोग करने का सबसे सुविधाजनक तरीका वेब-आधारित एडिटर है, जो numbas GitHub संगठन के भीतर एक अलग रिपॉज़िटरी में रहता है, साथ ही एक्सटेंशन और VLE एकीकरण भी। बिना किसी सेटअप की आवश्यकता वाला एक सार्वजनिक रूप से उपलब्ध एडिटर numbas.mathcentre.ac.uk पर होस्ट किया गया है। जो उपयोगकर्ता अपना स्वयं का इंस्टेंस चलाना पसंद करते हैं, वे Windows, Mac, या Ubuntu के लिए परियोजना के इंस्टॉलेशन निर्देशों का पालन कर सकते हैं। कंपाइलर निर्भरताएँ `pip install -r requirements.txt` से इंस्टॉल की जाती हैं। उपयोगकर्ताओं के लिए दस्तावेज़ीकरण docs.numbas.org.uk पर प्रकाशित है। डेवलपर API दस्तावेज़ीकरण JSDoc का उपयोग करके एक कस्टम टेम्पलेट के साथ जनरेट किया जाता है और numbas.github.io/Numbas पर उपलब्ध है; `make docs` इसे `../numbas-docs` में पुनर्निर्मित करता है। योगदानकर्ताओं के लिए, परियोजना बग रिपोर्ट, सुविधा सुझावों और कोड का स्वागत करती है। मुद्दे GitHub ट्रैकर पर दर्ज किए जा सकते हैं या [email protected] पर ईमेल किए जा सकते हैं। नए लोगों के लिए लक्षित कार्यों की एक सूची good-first-issue लेबल के अंतर्गत बनाए रखी जाती है, साथ ही एडिटर रिपॉज़िटरी में एक संबंधित सूची भी। जावास्क्रिप्ट रनटाइम में बदलाव करते समय, परियोजना योगदानकर्ताओं से `tests` निर्देशिका में यूनिट परीक्षण चलाने के लिए कहती है, जो या तो ब्राउज़र में या कमांड लाइन पर चल सकते हैं। ब्राउज़र परीक्षण `python -m http.server` शुरू करके और http://localhost:8000/tests पर जाकर परोसे जाते हैं; `tests/jme` JME प्रणाली को कवर करता है और `tests/parts` भाग मार्किंग एल्गोरिदम को कवर करता है। कमांड-लाइन परीक्षण node.js का उपयोग करते हैं: `tests` के अंदर `npm install` से निर्भरताएँ इंस्टॉल करें, फिर `npm test` चलाएँ। एक Makefile यूनिट परीक्षणों और API दस्तावेज़ीकरण बिल्ड के लिए स्क्रिप्ट एकत्र करता है; Windows उपयोगकर्ता cygwin के माध्यम से `make` प्राप्त कर सकते हैं। सॉफ़्टवेयर Apache License, Version 2.0 के अंतर्गत लाइसेंस प्राप्त है, जिसका कॉपीराइट न्यूकैसल विश्वविद्यालय (2011-18) के पास है। नम्बस का उपयोग करके उत्पादित सामग्री में कॉपीराइट लेखक के पास ही रहता है।