Obsidian Stats logoObsidian Stats

PDF Pager

by heptazero
5
4
3
2
1
Score: 50/100
Install Code

Description

Page-by-page PDF reading with mobile landscape paging, resume position, bookmarks, and width controls for Obsidian.

Reviews

No reviews yet.

Stats

0
stars
24
downloads
0
forks
1
days
1
days
1
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
19
commits

Latest Version

0.1.8
a day ago

Changelog

Fix Obsidian community scanner findings by using CSS helpers, vault-scoped local storage APIs, Obsidian DOM helpers, typed PDF events, and current-view APIs. Add the official Obsidian ESLint configuration.

See all version on GitHub

README file from

Github

PDF Pager

Read PDFs page by page in Obsidian, with mobile landscape paging, resume position, bookmarks, and page-width controls.

Features

  • Keeps one PDF page centered and restores the page and in-page position after rotation or reopening.
  • Splits tall pages into screen-sized stops on mobile landscape, recalculating stops after pinch zoom.
  • Provides compact mobile controls, keyboard paging, bookmarks, reading progress, and a minimum-width zoom floor.
  • Stores reading records per device inside the vault configuration folder so synced devices do not overwrite one another's progress.
  • Works offline and contains no network requests, accounts, advertisements, or telemetry.

The plugin uses Obsidian's internal PDF.js viewer interface. An Obsidian update may require a compatibility update to this plugin.

中文说明

在 Obsidian 原生 PDF 标签页上提供单页阅读、阅读进度、书签和页面显示宽度控制。插件不修改 PDF 文件。

  • 默认每次只显示一张 PDF 页面，横竖屏都居中；旋转后保持同一页和页内位置。
  • 移动端横屏时，较高的竖向 PDF 页面会按屏幕高度分成数个阅读屏；底部按钮先翻“上一屏/下一屏”，到页边后才进入相邻 PDF 页面。
  • 分屏按当前缩放后的实际像素位置计算，页面内会显示虚线分界和屏序号；捏合缩放后分界会重新计算。
  • 移动端默认用右侧窄控制栏导航：上方左箭头翻上一屏，中间显示当前屏数并可展开完整控制条，下方右箭头翻下一屏；长按约半秒可拖动控制栏，松手后保留位置；不在 PDF 正文上铺点击翻页层，避免影响划词。
  • 桌面端或连接键盘时，← / PageUp 翻上一屏（上一页），→ / PageDown 翻下一屏（下一页）；也可在 Obsidian 设置 → 快捷键中修改“PDF：上一屏/上一页”和“PDF：下一屏/下一页”。
  • 底部按钮翻页、输入页码、添加/查看/删除书签，显示阅读百分比和当前分屏位置。
  • 宽度滑块设置页面的最小显示宽度（当前适配方式为 100%）。双指可以继续放大，缩小到这个下限即停止；拖动滑块时保留高于下限的双指放大倍率。“适合整页”和“适合宽度”会重置到新的适配基准。移动端宽度面板会居中并隔离边缘拖动，避免误展开 Obsidian 侧边栏。
  • 普通打开 PDF 时恢复最近一次阅读页；显式 PDF 页码链接优先。
  • 仅在聚焦的 PDF 标签页实际翻页后保存进度，避免后台标签页关闭覆盖记录。

进度和书签按 PDF、按设备分别存放在 vault 配置目录的 plugins/pdf-pager-hz/records/*.json（默认位于 .obsidian/plugins/pdf-pager-hz/records/），读取时合并。同步软件需要包含 vault 配置目录和这些 JSON 文件。同时离线阅读同一 PDF 时，以设备记录的时间戳较新者为准，设备时钟严重不一致会影响判断。从 0.1.7 起，插件会自动读取并迁移旧版 99_assets/plugin-data/pdf-pager/ 中当前设备的记录。

本插件使用 Obsidian 未公开的 PDF.js 阅读器接口。Obsidian 更新后，如单页模式或页码获取失效，需要调整 src/native-viewer.ts。

安装

BRAT

在 BRAT 中选择“添加测试版插件”，仓库地址只输入 Heptazero/obsidian-PDF-pager。不要附带中文逗号、Markdown 链接格式或 /releases/tag/0.1.0。安装后在 Obsidian 的社区插件设置中启用 PDF Pager (hz)。

手动安装

从 GitHub Releases 下载 manifest.json、main.js 和 styles.css，放入 vault 的 .obsidian/plugins/pdf-pager-hz/，然后启用插件。更新时替换这三个文件并重新加载插件。

更新 Obsidian 后，建议用一份熟悉的 PDF 复查横竖屏切换、双指缩放、翻页居中和续读，因为插件依赖未公开的 PDF 阅读器接口。

开发：npm install && npm test && npm run build。

License

MIT

Sponsors