Improve MDHelper themes and packaging

This commit is contained in:
shenw
2026-05-25 22:00:37 +08:00
parent 2d896a618f
commit 0d2f62817b
41 changed files with 3729 additions and 86 deletions
+18 -6
View File
@@ -7,10 +7,12 @@ MDHelper 是一个用 Python 和 Markdown 文件组成的本地帮助文档阅
- 浏览根目录 `sample.md` 和 `docs/` 下的 Markdown 文档
- 显示文字、表格、引用、列表和链接
- 使用 Pygments 高亮代码块和伪代码
- 支持任务列表和 `[!TIP]`、`[!WARNING]` 等提示块
- 支持任务列表和 `[!NOTE]`、`[!TIP]`、`[!IMPORTANT]`、`[!WARNING]`、`[!CAUTION]` 提示块
- 支持离线 Mermaid 图表
- 支持 KaTeX 和 MathJax 数学公式渲染,默认使用 KaTeX,可在“编辑 > 公式引擎”切换
- 显示图片和 GIF 动画
- 内嵌播放音频和视频
- 支持 Markdown 文档间跳转、外部链接打开、字号调整、浅色/深色主题
- 支持 Markdown 文档间跳转、外部链接打开、字号调整、Office 风格主题颜色和背景
- 支持多标签页阅读
- 单击本地 `.md` 和网页文件链接会在 MDHelper 标签页内展示
- 单击其他本地文件链接时,会先询问是否用本地默认软件打开
@@ -21,21 +23,23 @@ MDHelper 是一个用 Python 和 Markdown 文件组成的本地帮助文档阅
- 状态栏显示当前文档阅读进度
- 搜索框支持标题、文件名和正文全文搜索
- 全文搜索使用内存索引缓存,避免输入时反复读取磁盘
- 搜索时显示匹配文档结果列表,并保留文档树过滤
- 搜索时显示匹配文档结果列表、命中类型和命中数量,并保留文档树过滤
- 点击搜索结果后自动在当前页查找并高亮命中词
- 支持当前页查找
- 支持当前页查找,并显示当前命中序号/总命中数
- 自动刷新当前文档和已引用的本地媒体文件
- 鼠标悬停链接时在状态栏显示目标地址
- 表格支持横向滚动和一键复制
- 图片点击放大,支持缩放、旋转、重置,按 `Esc` 或点击遮罩关闭
- 图片点击放大,支持缩放、旋转、适应窗口、原始大小、保存图片、在文件夹中显示和重置
- 代码块提供一键复制按钮
- 代码块支持行号,长代码块可折叠/展开
- 支持添加、打开、重命名和删除书签
- 自动恢复上次阅读位置
- 自动恢复上次阅读位置,后退/前进时保留文档滚动位置
- 可将当前文档导出为 PDF
- 可将当前文档导出为 HTML
- 自动保存窗口状态、字号、主题和最近文件
- 支持导入/导出配置 JSON,便于迁移书签、最近文件、阅读位置和外部程序映射
- 提供设置窗口,可配置主题、字号、自动刷新和其他本地文件处理策略
- 关于窗口和启动日志显示当前版本
- 提供文档检查命令,可扫描缺失的本地链接和媒体资源
- 运行日志保存到 `logs/mdhelper.log`
- 可打开任意本地 Markdown 文件
@@ -83,6 +87,14 @@ MDHelper 是一个用 Python 和 Markdown 文件组成的本地帮助文档阅
.\mdhelper_env\Scripts\python.exe .\tests\gui_smoke.py
```
打包为单文件 exe:
```powershell
.\mdhelper_env\Scripts\python.exe -m PyInstaller .\MDHelper.spec --noconfirm --clean
```
生成文件位于 `dist\MDHelper.exe`。exe 启动日志写入 `dist\logs\mdhelper.log`。
## 依赖
核心依赖已写入 `requirements.txt`: