Skip to content

version 1.7.0

Choose a tag to compare

@warzoo warzoo released this 21 Jun 16:28

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 ^block id (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.py packaging script; release zips are no longer committed to the repo.
    新增 build.py 打包脚本;发布用的 zip 不再提交进仓库。

🙏 Acknowledgements / 致谢

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,然后重启。