Kolibri plugin for rendering Khan Academy Perseus style exercises
Project description
What is this?
Kolibri is a Learning Management System / Learning App designed to run on low-power devices, targeting the needs of learners and teachers in contexts with limited infrastructure. See learningequality.org/kolibri for more info.
Perseus is Khan Academy’s exercise question editor and renderer. See github.com/Khan/perseus for more info.
This package is a wrapper around Perseus which allows it to be embedded and used within Kolibri.
Installation
This plugin is bundled with Kolibri - it is unlikely that you need to install it.. If you are running a custom version, you can install it like this:
Inside your Kolibri virtual environment:
pip install kolibri-perseus-exercise-plugin
Activate the plugin:
kolibri plugin kolibri_exercise_perseus_plugin enable
Restart Kolibri.
Getting started with development
Clone this repo.
Open terminal in your Kolibri repo.
Run the following commands, with your Kolibri development virtual env enabled:
make clean pip install -e . pip install -e <KOLIBRI-PERSEUS-PLUGIN-LOCAL-PATH> kolibri plugin kolibri_exercise_perseus_plugin enable
Within the perseus plugin repo directory, run the following command, again using your kolibri dev virtualenv:
cd kolibri_exercise_perseus_plugin yarn install cd .. make dist
Updating translation strings
Follow the directions in our Kolibri i18n docs.
Release process and versioning
The versioning and releasing of this kolibri_exercise_perseus_plugin plugin is independent of both Kolibri and Perseus. We use semantic versioning, and create release branches for each minor release.
How to publish to PyPi?
When publishing, you’ll need a GPG key to sign the package and associate it with your identity. You’ll need to have gpg on your path. Some resources that might be helpful:
You’ll also need an account on PyPi with access to the kolibri-exercise-perseus-plugin package
Next, follow these steps carefully:
Follow the instructions above to installing the plugin for development.
Run pip install twine.
Update the version number in kolibri_exercise_perseus_plugin/__init__.py. Commit it to the perseus release branch. Tag a new release using github’s web UI.
Check out the tagged commit and ensure that you have no local changes.
Build the frontend assets and .whl file by running:
make dist
Check that there are CSS, JS, and JSON files when searching the wheel file for kolibri_exercise_perseus_plugin:
unzip -vl dist/[GENERATED WHEEL FILE NAME] | grep exercise_perseus_render_module
Sign and publish to PyPi:
make release
Known issues
Development installation version not active
If you ran make dist or make pex on Kolibri with kolibri-exercise-perseus-plugin==x.x.x present in kolibri/requirements/base.txt, Kolibri will generate an kolibri_exercise_perseus_plugin instance inside its kolibri/dist folder and bundle it for further distribution. That means manually installing kolibri_exercise_perseus_plugin for development won’t take any effects. One way to fix this issue is to run make clean on Kolibri.
How can I contribute?
Thanks for your interest! Please see the contributing section of our online developer documentation.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Hashes for kolibri_exercise_perseus_plugin-1.1.3-py2.py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 0dfd0b897f67f551bc64c8b82312e4059eacbc50ee7f3f18c2bcbcfcb8c7fd02 |
|
| MD5 | da2a1bfff54a4d2898673ab93b55472b |
|
| BLAKE2b-256 | c976dc273d857d6d14aa1738b5a9c312a5f2a71c69ed51e3713687f65127193a |
