SuperMemo 增强工具(CLI命令行)。包含图链整理、EPUB图书转换导入、Latex公式转图片等。
supermemo图链整理工具。
PathPix:任意类型的网络图片整理为受支持的五种格式的图片,并网络和本地图片收集起来转换为相对路径,存放在elements文件夹中。
其中,网页内嵌图片由pathpix管理,元素注册表图片由图片注册表管理。pathpix管理的图片文件,可以导入图片注册表中。
旧版Pathpix:功能说明、下载安装使用文档:https://docs.qq.com/doc/DQnRpb0VNUEVvR3dl
致谢:●兰迥 ●Merlin ●水流众生 ●st ●aicling
从epub图书生成xml格式的sm-book图书。
需要生成的书籍图片文件夹放到SM集合的your_collection/elements/local_pic
文件夹下,如果你不需要的图片显示的话,可以不用放。
一般情况下集合默认全路径为:Root_SuperMemo/systems/your_collection
。
使用方法:例如我想将“如何阅读一本书.epub”文件转换为可导入的supermemo集合文件(XML+图片附件文件夹),那么,首先推荐的安装方式是pipx,pipx可以理解为Android系统的应用程序管理器,负责安装管理apk应用。那么,pipx也是一样的道理,pipx可以安装管理whl格式的python软件包。其次,你可以下载源代码的方式,本地构建一个软件开发环境运行,蛋我不推荐这样做,这样做的任务复杂度带来的试错成本略高。使用pipx安装软件可以参考下方的 Install。
当成功安装好的软件包后,就可以开始使用了,使用非常简单,对于win10及以上版本的系统,可以在桌面又单击-使用终端打开,在终端中输入smtk e2sm --linear 如何阅读一本书.epub C:\Users\Name\Desktop
并执行此命令(这个命令的含义是使用线性相同层级topic转换图书),稍后会在桌面生成一个XML文件和对应的文件夹。文件夹需要放置到上文说的指定的位置,因为程序在处理过程会自动将绝对路径转换为固定的相对路径,这个路径在转换后的XML文件中是写好的。所以第一步是把“书籍图片文件夹”放到对应的位置,第二步是导入图书,打开supermome软件,点击菜单按钮:File - Import - XML,在打开的对话框中选择转换好的电纸书XML集合文件,点击导入。导入成功的同时就可以看到最终的效果了。
smtk e2sm --toc epub_file out_folder #(需要图书有良好的目录,没有需使用calibre生成并整理目录)
smtk e2sm --linear epub_file out_folder #(有书即可,不按照EPUB目录文件生成,而是按照EPUB图书内文档文件的线性顺序生成,比较适合PDF版epub,效果查看文件:./docs/Snipaste_2024-03-24_09-17-23.png)
smtk e2sm --topic epub_file out_folder #(有书即可,EPUB转换为一个SuperMemo Topic,一本书即是一篇文章,配合SuperMemo阅读点使用更佳。)
latex 公式转图片。
smtk imtex <formula_text> <outpath>
smtk imtex "$\sum_{i=0}^\infty x_i$" ./a.png
pipx:python whl格式软件包安装管理器。pipx安装应用请务必联网。
- 安装Python最新版,目前版本是3.12.2
- 安装pipx最终独立Python应用安装管理器,通过pip(要求版本 ≥ v19.0):
python3 -m pip install --user pipx
- 配置pipx,执行ensurepath。
- pipx程序所在文件夹:
<USER folder>\AppData\Roaming\Python\Python3x\Scripts
- 转到上述文件夹,执行
.\pipx.exe ensurepath
,将上述路径和文件夹添加到您的搜索路径中。 - 重新启动您的终端会话并输入pipx命令验证是否运行。
- 下载
supermemo_toolkit-py3-none-any.whl
- 执行
pipx install supermemo_toolkit-py3-none-any.whl
等待安装成功。 - 安装成功后,可以执行
smtk
命令验证是否安装成功。
问题1:若出现ERROR: No matching distribution found for XXX,一般是网络问题,切换PYPI源即可,可以使用下列方式切换PYPI源。
# 切换阿里源
pip config set global.index-url http://mirrors.aliyun.com/pypi/simple/
pip config set install.trusted-host mirrors.aliyun.com
# 换回默认源
pip config unset global.index-url
问题2:执行python3 -m pip
报错:No module named 'pip',可以通过下列方式解决。
python -m ensurepip
python -m pip install --upgrade pip
同样使用pipx应用安装管理器,执行pipx install save-path/your-app.whl --force
显示成功后即可更新成功。
本软件遵守开源协议,协议类型为:GPLv2。
如果你喜欢这个工具,并对我表示感谢,你可以在这里请我喝一杯奶茶!