Kolibri插件，用于渲染可汗学院Perseus风格的练习
项目描述
这是什么？
科利布里是一款专为在低功耗设备上运行而设计的课程管理系统/学习应用程序，旨在满足基础设施有限的环境下学习者和教师的需求。更多信息请参阅learningequality.org/kolibri。
珀尔修斯是可汗学院的练习题编辑器和渲染器。更多信息请参阅github.com/Khan/perseus。
此软件包是珀尔修斯的包装器，允许其在科利布里中嵌入和使用。
安装
此插件包含在科利布里中 - 您很可能不需要安装它。如果您正在运行自定义版本，可以按以下方式安装
在您的科利布里虚拟环境中
pip install kolibri-perseus-exercise-plugin
激活插件
kolibri plugin enable kolibri_exercise_perseus_plugin
重启科利布里。
开始开发
克隆此仓库。
在您的科利布里仓库中打开终端。
运行以下命令，同时启用您的科利布里开发虚拟环境
make clean pip install -e . pip install -e <KOLIBRI-PERSEUS-PLUGIN-LOCAL-PATH> kolibri plugin enable kolibri_exercise_perseus_plugin
在珀尔修斯插件仓库目录中，运行以下命令，再次使用您的 kolibri dev 虚拟环境
cd kolibri_exercise_perseus_plugin yarn install cd .. make dist
更新翻译字符串
请参阅我们科利布里 i18n 文档中的说明。
发布流程和版本控制
此kolibri_exercise_perseus_plugin插件的版本控制和发布独立于科利布里和珀尔修斯。我们使用语义版本控制，并为每个次要版本创建发布分支。
如何发布到 PyPi？
发布时，您需要一个 GPG 密钥来签署软件包并将其与您的身份关联。您需要在您的路径中安装 gpg。以下是一些可能有用的资源
您还需要在 PyPi 上拥有一个账户，并且可以访问kolibri-exercise-perseus-plugin 软件包
接下来，请仔细按照以下步骤操作
按照上述说明安装插件以进行开发。
运行 pip install twine。
在 kolibri_exercise_perseus_plugin/__init__.py 中更新版本号。将其提交到 perseus 发布分支。使用 github 的 Web UI 标记新版本。
检出标记的提交并确保您没有本地更改。
通过运行以下命令构建前端资源和 .whl 文件
make dist
在 wheel 文件中搜索 kolibri_exercise_perseus_plugin 时，确保存在 CSS、JS 和 JSON 文件
unzip -vl dist/[GENERATED WHEEL FILE NAME] | grep exercise_perseus_render_module
签名并发布到 PyPi
make release
已知问题
开发安装版本未激活
如果您在包含 kolibri-exercise-perseus-plugin==x.x.x 的 kolibri/requirements/base.txt 中使用 make dist 或 make pex 运行科利布里，科利布里将在其 kolibri/dist 文件夹中生成一个 kolibri_exercise_perseus_plugin 实例并将其捆绑以供进一步分发。这意味着手动安装 kolibri_exercise_perseus_plugin 进行开发不会产生任何效果。修复此问题的方法之一是在科利布里上运行 make clean。
如何贡献？
哈希值 for kolibri_exercise_perseus_plugin-1.3.5-py2.py3-none-any.whl
| 算法 | 哈希摘要 | |
|---|---|---|
| SHA256 | 4b704899fad554181689187cccc1db74d113cd2fcacc9d02a23ee43f9da6d4a0 |
|
| MD5 | cc0fd6cfbb683e8a3d3846187a478131 |
|
| BLAKE2b-256 | 59a52e6f5c37c6837ceb56ec60d237d9ea58f21653599a8f7fe5228b9fa08695 |
