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
File details
Details for the file kolibri_exercise_perseus_plugin-1.1.3-py2.py3-none-any.whl.
File metadata
- Download URL: kolibri_exercise_perseus_plugin-1.1.3-py2.py3-none-any.whl
- Upload date:
- Size: 8.8 MB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.1 pkginfo/1.5.0.1 requests/2.21.0 setuptools/39.0.1 requests-toolbelt/0.8.0 tqdm/4.19.6 CPython/2.7.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 0dfd0b897f67f551bc64c8b82312e4059eacbc50ee7f3f18c2bcbcfcb8c7fd02 |
|
| MD5 | da2a1bfff54a4d2898673ab93b55472b |
|
| BLAKE2b-256 | c976dc273d857d6d14aa1738b5a9c312a5f2a71c69ed51e3713687f65127193a |
