mkdocs-heti-plugin 0.1.6

Creator: bradpython12

Last updated:

Add to Cart

Description:

mkdocshetiplugin 0.1.6

mkdocs-heti-plugin
一个使用 heti 来优化 mkdocs 中文正文排版的插件。
具体表现在:

中西文混排间使用四分宽空格

注:与 heti 不同,此时复制得到的是带半角空格的文本,而 heti 原脚本复制下来不带空格


进行连续标点的挤压

预览:https://note.tonycrane.cc/
提示
heti 原本是跑在前端的,不过在加载出页面到 heti 处理好之间有一小段时间间隔,感觉有些不爽,就写了这个插件,将这个任务直接放到网站生成的时候来做。
不过嘛,效率是极低的,我的 note 用上之后需要三分多钟才能完成网站构建。
如果可以忍受在前端处理的话可以看这个 commit:TonyCrane/note@5a0259
安装
可以通过 pypi 直接安装:
$ pip install mkdocs-heti-plugin

也可以从源码安装
$ git clone https://github.com/TonyCrane/mkdocs-heti-plugin.git
$ cd mkdocs-heti-plugin
$ pip install . # or pip install -e .

使用

在 mkdocs.yml 中启用插件即可:
plugins:
- heti


由于效率实在是太低,所以默认在 serve 的时候不进行处理,想要处理的话这样写:
plugins:
- heti:
disable_serve: false



目前配置项配置的不多,用法啥的也以后再完善(咕咕咕
开发
mkdocs_heti_plugin/utils/finder.py 是我对着 padolsey/findAndReplaceDOMText 的 js 代码扒出来的,我也不敢说我看懂了,反正它目前确实能跑,能用就行了。
mkdocs_heti_plugin/utils/heti.py 里面有一些用很不优雅的方式解决的一些不想深究的 bug,有时间再细看看。
有想修改、改进的我非常且热烈欢迎,尽管 PR 就好(
TODO

与 mkdocs-encryptcontent-plugin 加密页面兼容
支持 pymdownx.arithmatex

注意事项
与 mkdocs-encryptcontent-plugin 还没兼容,加密的页面目前不做处理(处理的话目前会卡死)。
参考 & 鸣谢

sivan/heti
padolsey/findAndReplaceDOMText

License

For personal and professional use. You cannot resell or redistribute these repositories in their original state.

Customer Reviews

There are no reviews.