このプロジェクトについて

Numbasは、ブラウザ上で完全に動作するテスト作成のためのオープンソースシステムで、ニューカッスル大学の数学・統計・物理学部によって開発されました。特に数学の評価に重点を置いています。 このリポジトリには、スタンドアロンのPython 3として実行されるNumbasコンパイラが含まれています。コンパイラはエコシステムのコマンドラインの中核です。`python bin/numbas.py`を実行すると利用可能なオプションが表示され、`.exam`ファイルの名前を渡すか、標準入力からパイプで渡します。ただし、Numbasを最も便利に使う方法は、numbas GitHub組織内の別リポジトリにあるWebベースのエディタを通じてであり、拡張機能や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ラベルで管理されており、エディタリポジトリにも対応するリストがあります。JavaScriptランタイムを変更する際は、`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)に帰属します。Numbasを使用して作成されたコンテンツの著作権は著者に残ります。