Skip to content

Latest commit

 

History

History
95 lines (60 loc) · 5.01 KB

README.md

File metadata and controls

95 lines (60 loc) · 5.01 KB

supermemo-toolkit(smtk)

SuperMemo 增强工具(CLI命令行)。包含图链整理、EPUB图书转换导入、Latex公式转图片等。

PathPix

supermemo图链整理工具。

PathPix:任意类型的网络图片整理为受支持的五种格式的图片,并网络和本地图片收集起来转换为相对路径,存放在elements文件夹中。

其中,网页内嵌图片由pathpix管理,元素注册表图片由图片注册表管理。pathpix管理的图片文件,可以导入图片注册表中。

旧版Pathpix:功能说明、下载安装使用文档:https://docs.qq.com/doc/DQnRpb0VNUEVvR3dl

致谢:●兰迥 ●Merlin ●水流众生 ●st ●aicling

E2SM

从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阅读点使用更佳。)

latex2img

latex 公式转图片。

smtk imtex <formula_text> <outpath>
smtk imtex "$\sum_{i=0}^\infty x_i$" ./a.png

Install

pipx:python whl格式软件包安装管理器。pipx安装应用请务必联网。

安装步骤:

  1. 安装Python最新版,目前版本是3.12.2
  2. 安装pipx最终独立Python应用安装管理器,通过pip(要求版本 ≥ v19.0):python3 -m pip install --user pipx
    1. 配置pipx,执行ensurepath。
    2. pipx程序所在文件夹:<USER folder>\AppData\Roaming\Python\Python3x\Scripts
    3. 转到上述文件夹,执行.\pipx.exe ensurepath,将上述路径和文件夹添加到您的搜索路径中。
    4. 重新启动您的终端会话并输入pipx命令验证是否运行。
  3. 下载supermemo_toolkit-py3-none-any.whl
  4. 执行pipx install supermemo_toolkit-py3-none-any.whl等待安装成功。
  5. 安装成功后,可以执行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显示成功后即可更新成功。

LICENSE

本软件遵守开源协议,协议类型为:GPLv2。

Star History

Star History Chart

赞助

如果你喜欢这个工具,并对我表示感谢,你可以在这里请我喝一杯奶茶!