Repository navigation
Releases: bufan1024/obsidian-inkstone
Release list
Inkstone 1.5.0 · Comic shelves and reading layouts
Inkstone 1.5.0 adds comic presentation and reading layouts while retaining its quiet, light-only reading style.
新增漫画展示与阅读
- 封面书架：封面、简介、章节入口和窄分栏布局。
- 作品详情与按卷目录：串联书架、作品简介和章节阅读。
- 连续阅读与无缝条漫：完整图片、显式尺寸与图注。
- 双页对照：按阅读区实际宽度切换双列／单列，保留原有页序与原生折叠。
- 四篇可复制的本地示例、原创 SVG 素材、双语说明及实际 Obsidian 截图。
主题为纯 CSS，无新增运行依赖。标注插件仍为 1.2.0，运行文件未改变。
验证
macOS Obsidian 1.14.5 原生检查 36/36、JavaScript 150/150、Python 安装／导出测试 38/38 通过，发行包文件清单与字节校验通过。手机原生应用、实体墨水屏、最低声明版本与实际漫画 PDF 分页未验证。
安装与更新
- 市场用户在 Obsidian「设置 → 外观 → 主题 → 管理」中更新 Inkstone；市场同步／审核状态以主题页面为准。
- 手动安装可下载
Inkstone-Reading-Kit-1.5.0.zip，运行安装器时使用--update；仅更新主题可加--theme-only。 - 漫画示例位于主题 ZIP 的
examples/，或合集的themes/Inkstone/examples/。把四篇示例和comics/放入笔记库的同一目录；市场主题安装不会自动复制示例笔记。 - 本 Release 直接附带
theme.css和manifest.json供市场安装，同时提供主题／插件／合集 ZIP 与 SHA-256 校验和。
Inkstone 1.4.0 · Reading workflow upgrade
主题 1.4.0 与阅读合集发布，内含标注插件 1.2.0。
- 搜索当前笔记的摘录和想法，组合颜色／仅有想法筛选；新增上一条与下一条标注命令。
- 会话内想法草稿可查看和复制恢复；新保存仍需重新选择当前原文。
- 摘录增加时间与章节来源，支持手动汇总选中的笔记或文件夹；2,000 标题长文档采用批量校验。
- 可自定义颜色显示含义，提供显式中英文界面设置；标注 HTML 和脚注格式保持兼容。
- 收窄动画规则、完善打印长代码和宽表格，补充 Windows 安装器 CI 与设备检查表。
- 同时包含上一轮选区校验性能、零用例验收失败和安装失败恢复提示修复。
安装：市场中的主题和插件需分别更新。GitHub 用户可使用 Inkstone-Reading-Kit-1.4.0.zip；更新前关闭 Obsidian，运行安装器时使用 --update，保留 data.json 与阅读偏好。主题单独安装仍无需插件。
验证：150 项 JS、38 项 Python、独立插件 144 项测试；隔离 Obsidian 1.14.5 原生交互 37/37、工作流 8/8、主题 29/29。PDF 排版检查采用真实原生 DOM/CSS 的独立 Chromium 回退。移动端与实体墨水屏未实测；GitHub 发布不代表新版本市场已同步或完成审核。
SHA256SUMS 包含本次附件校验值。历史版本和附件保持不变。
主题本体与分别更新 · 2026-10-23
主题 1.4.0 收窄动画抑制范围，保留第三方普通控件自身动画；改善宽表格、长代码及多页打印的换行与分页样式。侧栏搜索、标注导航、会话草稿和摘录汇总由配套插件 1.2.0 提供，需要单独更新插件。
- 主题更新：设置 → 外观 → 主题 → 管理 → Inkstone → 检查更新 → 更新。
- 插件更新：设置 → 第三方插件 → 检查更新 → Inkstone Annotations → 更新。
- 更新保留已有标注、插件 data.json 和个人阅读偏好。手动更新前退出 Obsidian，使用合集安装器时加 --update；无需卸载重装。
GitHub Release 已发布不等同于市场已完成同步或审核；请以各自市场页的当前版本与审核状态为准。
Inkstone 1.3.8 · Reading layout refinement
Inkstone 1.3.8 refines the reading layout and native UI behavior. Select Light mode; the theme remains standalone CSS and does not require the annotation plugin.
- Note margins adapt to each pane in Reading, Live Preview, and Source modes.
- Native Obsidian font and size preferences remain the default.
- Internal links use dotted underlines, distinct from annotation underlines.
- Explicit embedded image heights are preserved.
- Native loading indicators remain visible, and notice actions keep readable text.
Requires Obsidian 1.10.6 or later. Install or update Inkstone from Settings → Appearance → Themes → Manage after the Community Directory picks up this release. For manual theme-only installation, replace theme.css and manifest.json in .obsidian/themes/Inkstone/ while Obsidian is closed.
The direct theme.css and manifest.json attachments support Obsidian installation. The three ZIP packages are also provided: theme 1.3.8, annotation plugin 1.1.8, and the reading kit containing both. SHA256SUMS covers all five runtime and ZIP files. Keep plugin data.json when updating the optional plugin.
Validation: 107 JavaScript tests, 35 Python tests, and ZIP integrity/content checks passed. The existing native verification record covers 37 interaction groups and 22 theme checks on macOS Obsidian; native checks were not rerun for this release. Mobile apps, physical e-ink devices, and the minimum supported 1.10.6 version have not been verified on-device.
Inkstone 1.3.7 · English guides and community plugin preparation
Adds English project and annotation guides, language links, and both usage GIFs to the release packages. Plugin 1.1.7 uses the Basic Latin display name Inkstone Annotations, native settings headings, and delegates registered-view cleanup to Obsidian. Existing plugin ID and saved annotation format are unchanged.
The community-directory distribution is published separately at https://github.com/bufan1024/obsidian-inkstone-annotations with directly downloadable plugin runtime files. GitHub availability does not mean community-directory approval.
Validation: 96 JavaScript tests, 35 Python tests, 33 native interaction groups plus 4 lifecycle checks on macOS Obsidian 1.14.4; three ZIPs checked byte for byte, 117 local documentation links verified, and the extracted kit installation/update preserves notes, data and preferences. Mobile apps and physical e-ink devices have not been tested.
For updates, quit Obsidian and run the kit installer with --update. The theme manifest is 1.3.7; annotation plugin manifest is 1.1.7.
Inkstone 1.3.7 · Obsidian community theme release
Inkstone light theme 1.3.7, prepared for the Obsidian community theme directory. The exact 1.3.7 tag and direct theme.css / manifest.json attachments allow installation through Obsidian. This release uses the same source commit and runtime bytes as v1.3.7; the existing v1.3.7 release is retained.
The theme uses a white background, dark text, and quiet spacing for long reading sessions and e-ink use. It is standalone CSS with no network resources, scripts, or plugin dependencies. Select Light mode. Mobile apps and physical e-ink devices have not been tested.
The original theme ZIP, annotation plugin ZIP, reading kit ZIP, and SHA256SUMS are also included with identical bytes, so the latest-release download remains useful for combined installations. Annotation plugin version is 1.1.7.
For theme-only manual installation, copy theme.css and manifest.json into .obsidian/themes/Inkstone/. In Obsidian, select Inkstone under Settings → Appearance and use Light mode. See README.en.md or README.md for full instructions and demonstrations.
Inkstone 1.3.6 · 侧栏编辑小浮层
侧栏「编辑」现在会在按钮旁打开与正文标注相同的小菜单。主题 1.3.6，标注插件 1.1.6。
- 首层可改颜色、切换下划线、写／编辑想法或删除标注。
- 想法与样式在同一浮层中编辑，保存后一起生效；取消不改写笔记。
- 支持键盘打开、Escape 关闭与返回按钮，复用已有菜单的焦点、快捷键和视口避让。
- 保留完整笔记快照与侧栏来源校验，过期内容不会误写到新笔记。
- 更新 README 教程、插件说明与合集安装文案。
已有用户关闭 Obsidian 后，在解压的合集目录运行：
python3 scripts/install.py --vault "/你的笔记库路径" --update更新保留阅读偏好、已启用插件列表、插件数据和笔记正文。完整安装说明见 INSTALL.md。
Inkstone 1.3.5 · 标注侧栏与按钮优化
标注侧栏改为更紧凑的阅读索引，突出摘录和想法。主题 1.3.5，标注插件 1.1.5。
- 顶部显示笔记名和标注数量，目录弱化显示，悬停可查看完整路径。
- 筛选与导出入口固定在顶部，标注列表独立滚动；同一笔记刷新后保留列表位置。
- 摘录、想法和样式标签分层排列，用细分隔线替代大块卡片。
- 「定位原文」使用细描边，「编辑」使用文字按钮，「删除」靠右弱化；支持键盘焦点和触控尺寸。
- 更新侧栏效果图与 README 的筛选、导出 GIF。
已有用户关闭 Obsidian 后，在解压的合集目录运行：
python3 scripts/install.py --vault "/你的笔记库路径" --update更新保留阅读偏好、已启用插件列表、插件数据和笔记正文。完整安装说明见 INSTALL.md。
Inkstone 1.3.4 · 想法与样式一起保存
主题 1.3.4 · 标注插件 1.1.4
写想法的小浮层内可同时选择四色高亮或下划线，保存后样式与想法一起生效。
- 支持黄、绿、蓝、粉色高亮与下划线，所选样式有明确提示。
- 切换样式只修改草稿，保留输入内容与焦点；点击保存或 Cmd+Enter / Ctrl+Enter 时一次写入样式和想法。
- 新选区默认下划线，已有标注默认原样式；未改样式的旧无色高亮保持原样。
- 保存失败保留草稿与所选样式，取消不写入笔记。
- 已有标注菜单首层的改色仍即时生效。README 同步使用步骤与原生效果截图。
关闭 Obsidian，解压新版 Reading Kit，保留个人偏好更新：
python3 scripts/install.py --vault "/你的笔记库路径" --update旧运行文件会自动备份，保留插件数据与启用列表。手机原生应用与实体墨水屏尚未实测。
Inkstone 1.3.3 · 选区写想法小浮层
主题 1.3.3 · 标注插件 1.1.3
选中文字后点击快捷条「写想法」，直接在原文旁的小浮层输入，与已有标注的想法编辑保持一致。
- 原文预览、多行想法、保存与取消；支持 Cmd+Enter / Ctrl+Enter。
- 打开与取消均不写入笔记。新选区保存为下划线和脚注，已有标注保留原颜色与样式。
- 新想法为空白时提示填写；过期选区拒绝保存；浮层内的保存错误保留草稿供查看。
- 阅读、实时预览及源码模式沿用捕获时的原文范围，保存使用一次原子事务。
- README 新增教程与原生 Obsidian 效果截图。
关闭 Obsidian，解压新版 Reading Kit，保留个人偏好更新：
python3 scripts/install.py --vault "/你的笔记库路径" --update旧运行文件会自动备份，保留插件数据与启用列表。手机原生应用与实体墨水屏尚未实测。
Inkstone 1.3.2 · 已有标注小菜单
主题 1.3.2 · 标注插件 1.1.2
点击已有高亮或下划线时，在原文旁打开小菜单：
- 直接切换黄、绿、蓝、粉色或下划线，当前样式显示选中状态。
- 「写想法 / 编辑想法」在同一浮层内输入，支持 Cmd+Enter / Ctrl+Enter 保存；修改想法保留现有样式。
- 「删除标注」保留原文及其他位置仍引用的共享脚注。
- 阅读视图与实时预览使用一致操作；点击外部、Escape、滚动或切换笔记时收起。
- 保留原笔记来源、快照及原子修改保护。侧栏「编辑」和右键编辑入口继续提供完整面板。
README 新增使用步骤与原生 Obsidian 效果截图。
关闭 Obsidian，解压新版 Reading Kit，保留个人偏好更新：
python3 scripts/install.py --vault "/你的笔记库路径" --update旧运行文件会自动备份，保留插件数据与启用列表。手机原生应用与实体墨水屏尚未实测。