mkdocs-heti-plugin
一个使用 heti 来优化 mkdocs 中文正文排版的插件。
具体表现在：
- 中西文混排间使用四分宽空格
- 注：与 heti 不同，此时复制得到的是带半角空格的文本，而 heti 原脚本复制下来不带空格
- 进行连续标点的挤压
提示
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 还没兼容，加密的页面目前不做处理（处理的话目前会卡死）。
参考 & 鸣谢
1 maintainer
Metadata
1 maintainer
Release files for mkdocs-heti-plugin 0.1.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mkdocs-heti-plugin-0.1.6.tar.gz | 11.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mkdocs_heti_plugin-0.1.6-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 21.4 kB
Release files / mkdocs-heti-plugin-0.1.6.tar.gz
| Download URL | mkdocs-heti-plugin-0.1.6.tar.gz |
|---|---|
| Size | 11.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d043fc6019b544f4bc5e58e6988dbb863134646ce3e70c41b2649ffd63c0a540
|
|
BLAKE2b-256 checksum How to use checksums |
db807e0a51a51830c537874a5877df3c043df9b78b5f309a0ff262987db6aa6e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.9.18
|
Release files / mkdocs_heti_plugin-0.1.6-py3-none-any.whl
| Download URL | mkdocs_heti_plugin-0.1.6-py3-none-any.whl |
|---|---|
| Size | 10.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d658392fecba11963684895b01b585607b3ac179453c98b5fd2f06702ba40a9d
|
|
BLAKE2b-256 checksum How to use checksums |
25b1f4e6446f27185e2eda5bbe550598d4c92b175c48e096b1e0840d52dfef50
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.9.18
|
