mirror of
https://github.com/iiab/iiab.git
synced 2025-02-13 11:42:08 +00:00
49 lines
2.5 KiB
ReStructuredText
49 lines
2.5 KiB
ReStructuredText
==============
|
|
KA Lite README
|
|
==============
|
|
|
|
This role installs KA Lite, an offline version of the Khan Academy (https://www.khanacademy.org) created by Learning Equality
|
|
(https://learningequality.org/ka-lite/).
|
|
|
|
KA Lite downloads Khan Academy videos for offline use, with exercises and accounts if students wanting to track their own progress.
|
|
|
|
[Originally KA Lite had two servers, a light httpd server that serves Khan Academy videos, and a cron server that sets up cron jobs to download language packs and KA videos from the internet. There were separate flags to enable these two servers.]
|
|
|
|
Using It
|
|
--------
|
|
|
|
If enabled and with the default settings KA Lite should be accessible at http://box:8008 or http://box.lan:8008
|
|
|
|
Log in to KA Lite::
|
|
|
|
Username: Admin
|
|
Password: changeme
|
|
|
|
Bulk Loading Videos
|
|
-------------------
|
|
|
|
Videos and their corresponding png images can be copied into /library/ka-lite/content and will be recognized the next time kalite is started. Please see http://FAQ.IIAB.IO ("KA Lite Administration: What tips & tricks exist?") to use BitTorrent to download compressed KA Lite videos, that are much smaller than the ones downloaded with KA Lite's administrative interface.
|
|
|
|
As of August 2018, please also consider the `"Transmission" BitTorrent tool <https://github.com/iiab/iiab/tree/master/roles/transmission#transmission-readme>`_ that will automatically download thousands of KA Lite videos for you, if install and enable it and set the language(s) you want within /etc/iiab/local_vars.yml
|
|
|
|
Configuration Parameters
|
|
------------------------
|
|
|
|
Look at `role/kalite/defaults/main.yml <https://github.com/iiab/iiab/blob/master/roles/kalite/defaults/main.yml>`_ for the default values of the various install parameters.
|
|
|
|
Troubleshooting
|
|
---------------
|
|
|
|
Starting with KA Lite 0.15 (October 2015) you can run the server manually with the following commands:
|
|
|
|
* systemctl stop kalite-serve (make sure the systemd service is not running)
|
|
* export KALITE_HOME=/library/ka-lite (point kalite to the right environment)
|
|
* kalite start (start the server; can take more than 10 minutes in some environments)
|
|
|
|
To return to using the systemd unit:
|
|
|
|
* export KALITE_HOME=/library/ka-lite (point kalite to the right environment)
|
|
* kalite stop
|
|
* systemctl start kalite-serve
|
|
|
|
*In late 2017, Internet-in-a-Box added a virtual environment (/usr/local/kalite/venv/) to keep KA Lite's Python and PHP package risks under control. As such the command* `/usr/bin/kalite <https://github.com/iiab/iiab/blob/master/roles/kalite/templates/kalite.sh.j2>`_ *is a wrapper to this virtualenv.*
|