version 1.7.0
Highlights to Obsidian v1.7.0
A feature release with new formatting options, multi-user support, sturdier error handling, and a bilingual user guide.
本次为功能更新:新增格式化选项、多用户支持、更稳健的错误处理,以及双语使用指南。
⚠️ Behavior change / 行为变更
- Clicking the H2O toolbar button now sends new highlights directly instead of opening the full menu. All actions are still available from the button's dropdown arrow.
点击 H2O 工具栏按钮现在会直接发送新增高亮,不再弹出整个菜单;全部操作仍在按钮的下拉箭头里。
✨ New features / 新功能
{if_notes}...{end_if_notes}conditional blocks — include part of the body only for highlights that have notes.
{if_notes}...{end_if_notes}条件块 —— 让 body 的某部分仅在高亮有批注时出现。{blockid}placeholder — the highlight's uuid sanitized for use as an Obsidian^blockid (fixes block ids broken by_). Put^{blockid}at the end of a highlight.
{blockid}占位符 —— 把 uuid 处理成可用的 Obsidian^块id(修复_导致的块 id 异常);在高亮末尾放^{blockid}。{user}/{usertype}placeholders + "Send highlights from ALL users" option (default off: only your own are sent). Useful when several people annotate via the content server.
{user}/{usertype}占位符 + 「发送全部用户」选项(默认关闭,只发本人)。适合多人通过内容服务器各自批注的场景。
🔧 Improvements / 改进
- Clearer error dialogs — separate messages for configuration problems, vault-write failures, and Obsidian-URI errors, instead of one generic error.
更清晰的错误提示 —— 配置问题 / 写入失败 / URI 错误分别给出针对性提示。 - Logging — sends and failures (with full tracebacks) are written to calibre's debug output and a rotating log file (
<calibre config>/plugins/highlights_to_obsidian.log).
日志 —— 发送过程与失败(含完整堆栈)写入 calibre 调试输出和滚动日志文件。 - Clarified the "Obsidian vault name" vs "Vault folder path" settings.
厘清「Obsidian vault name」与「Vault folder path」两个设置。
📖 Docs / 文档
- New bilingual (EN/中文) user guide:
docs/user-guide.md.
新增中英双语使用指南:docs/user-guide.md。
🛠 Internal / 内部
- Added a
build.pypackaging script; release zips are no longer committed to the repo.
新增build.py打包脚本;发布用的 zip 不再提交进仓库。
🙏 Acknowledgements / 致谢
- Fork of jm289765/highlights-to-obsidian (MIT).
本项目 fork 自 jm289765/highlights-to-obsidian(MIT)。 - The
{if_notes},{blockid}, error-handling, and multi-user ideas were inspired by gmcheck's v1.5.1 fork.
{if_notes}、{blockid}、错误处理与多用户等想法受 gmcheck 的 v1.5.1 fork 启发。
Install / 安装
Download highlights-to-obsidian-1.7.0.zip below, then in calibre: Preferences → Plugins → Load plugin from file, and restart.
下载下方的 highlights-to-obsidian-1.7.0.zip,在 calibre 里:Preferences → Plugins → Load plugin from file,然后重启。