Skip to main content

Kolibri plugin for rendering Khan Academy Perseus style exercises

Project description

Kolibri Exercise Renderer for Perseus
=====================================

What is Kolibri?
----------------

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. A user can install Kolibri and serve the app on a local
network, without an internet connection. Kolibri installations can be linked to one another, so that user data and
content can be shared. Users can create content for Kolibri and share it when there is network access to another
Kolibri installation or the internet.

See https://learningequality.org/kolibri/ for more info.

What is Perseus?
----------------

Khan Academy's exercise question editor and renderer.

See https://github.com/Khan/perseus for more info.

What is this plugin?
--------------------

A Perseus renderer wrapper for Kolibri that can track learning progress and save to the database.

How can I install this plugin?
------------------------------

1. Inside your Kolibri virtual environment:
``pip install kolibri-perseus-exercise-plugin``

2. Activate the plugin:

``kolibri plugin exercise_perseus_renderer enable``

3. Restart Kolibri.

How can I install this plugin for development?
------------------------------

1. Download this repo.
2. Open terminal in your Kolibri repo.
4. run the following commands:

``pip install -e <KOLIBRI-PERSEUS-PLUGIN-LOCAL-PATH>``

``kolibri plugin exercise_perseus_renderer enable``

5. Then run the commands to install frontend packages in Kolibri, this plugin will have its recursively installed.

6. If you have updated the version of Perseus in the repo, run the following command:

``./update_perseus.sh``

How to publish to PyPi?
------------------------------

1. Follow the instructions above to installing the plugin for development.
2. From the Kolibri directory run the frontend build command.
3. update `setup.py` to a newer version.
4. Terminal move to the root level of repo dir and run the following command to publish to PyPi:

``make release``


How can I contribute?
---------------------

* `Documentation <http://kolibri.readthedocs.org/en/latest/>`_ is available online, and in the ``docs/`` directory.
* Mailing list: `Google groups <https://groups.google.com/a/learningequality.org/forum/#!forum/dev>`_.
* IRC: #kolibri on Freenode


Project details


Release history Release notifications | RSS feed

This version

0.3.2

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Built Distribution

kolibri_exercise_perseus_plugin-0.3.2-py2.py3-none-any.whl (3.7 MB view details)

Uploaded Python 2 Python 3

File details

Details for the file kolibri-exercise-perseus-plugin-0.3.2.tar.gz.

File metadata

File hashes

Hashes for kolibri-exercise-perseus-plugin-0.3.2.tar.gz
Algorithm Hash digest
SHA256 c8f1f59c87ed760adfb47d12acf5f4c599b28b0cd3e3e659704f36780a8af3d6
MD5 e331eb3d1e7e68aa11424b4922144d80
BLAKE2b-256 76d0b013e24818998d1c5902758e635b7f0d7a5b8a459c2f12966ac33debbb2b

See more details on using hashes here.

Provenance

File details

Details for the file kolibri_exercise_perseus_plugin-0.3.2-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for kolibri_exercise_perseus_plugin-0.3.2-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 749e16adab933aa81fdf770a2a3b3cb92ae27d082c559ab8ba014a9831afa8bb
MD5 eabb5c8ab7840a7e2e590cd5e65f8c7d
BLAKE2b-256 fd5fdf04dc543547b9f121d1dac7f93deb2e66cce3a5b2fd6990cc9c78d4d56b

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page