Repository navigation
Releases
MarginPack 0.1.2 — faithful offline reading
MarginPack 0.1.2 improves reading exports of existing Zotero webpage annotations.
- Correctly verifies quotations spanning HTML line breaks and paragraphs while keeping the recorded UTF-16 range. Changed words and inline word boundaries remain unresolved; no fuzzy relocation is used.
- Keeps same-page contents and footnote links inside the offline file, preserves source language/right-to-left direction, and returns keyboard focus when closing external-link previews.
- Suggests a portable snapshot-title filename. Existing files are still never replaced.
- Adds an opt-in troubleshooting summary with version, counts and numbered type/status records. Source content, comments, URLs, identifiers and source hashes are excluded; copying is manual and nothing is sent. Filters do not redact the reading file.
- Adds English and Chinese first-export and troubleshooting guides.
Validation: 18 adapter cases and 18 reader scenarios in each of Chromium/Firefox. Actual Zotero 10.0.7 reader-derived annotations and real library selection passed on macOS, Windows and Linux (50 API/filesystem checks per platform). Windows/Linux additionally passed 43 native-save checks and 31 production-menu-command checks with real dialogs. Local macOS native UI automation could not connect this round; its 0.1.2 native-menu interaction remains unverified. See the validation record for the exact seams and environments.
Download the XPI to install through Zotero's Tools → Plugins window, or open the original synthetic demo locally without installation. See the validation record for tested platforms, real application checks and remaining seams.
This remains experimental and targets Zotero 10.0.x. Single-file UTF-8 HTML snapshots only; PDF/EPUB, original CSS/scripts, arbitrary live resources, editing/importing exports and complete printing are outside the supported boundary. The source snapshot and annotations remain the editable originals.
Independent MIT-licensed project, built with AI coding assistance; unaffiliated with Zotero or SingleFile. Source and feedback · 中文说明
MarginPack 0.1.1 — verified desktop saving
MarginPack exports an existing Zotero webpage snapshot and its annotations into one offline HTML reader. Share the saved page, highlights and comments with someone who does not use Zotero.
This experimental patch improves native-save feedback and adds desktop application validation.
- A failure to initialize or open the system save dialog now identifies the dialog problem and confirms that no file was saved.
- 16 adapter cases and 16 Chromium/Firefox exported-file cases passed on Windows, Linux and macOS.
- Real Zotero 10.0.7 checks passed on all three tested platforms: 36 API/filesystem checks and 30 native-save checks per platform. Native scenarios cover a Unicode path, cancellation and an existing-file replacement confirmation followed by MarginPack refusing to overwrite it.
- The installed XPI, source/stored attachment bytes, annotations and existing files are checked. Exact environments, sanitized evidence and limitations distinguish real native dialogs from headless picker seams.
Try marginpack-demo.html locally for a no-install preview with original synthetic content. Install marginpack-0.1.1.xpi through Zotero's Tools → Plugins window to export your own downloaded HTML snapshot. Choose a new filename and review annotation statuses and private notes before sharing.
The adapter targets Zotero 10.0.x. PDF/EPUB, original page scripts/CSS, live resource fetching, editing exports and importing back into Zotero remain outside this release. Native checks use a selected-real-item seam and captured notification alerts; they do not simulate selecting or annotating text interactively in Zotero's reader.
Independent MIT-licensed project, built with AI coding assistance; unaffiliated with Zotero or SingleFile. 中文说明 · Source and feedback
MarginPack 0.1.0 — portable Zotero webpage annotations
MarginPack keeps a saved Zotero webpage and its existing annotations together in one offline HTML file. Send the file to someone who does not use Zotero: they can read the page, jump from a comment to its passage and toggle highlights.
This is the first experimental release of an independent MIT-licensed project.
- Exports one downloaded UTF-8 HTML snapshot with highlights, underlines, comments and tags.
- Shows matched, unresolved and unsupported annotations explicitly. Stale quotes are not silently relocated.
- Uses a static reading layout, preserves supported embedded raster images and blocks automatic network requests.
- Creates a new destination file without modifying the source snapshot or library annotations.
Try it: download marginpack-demo.html and open it locally. Its content and annotations are original synthetic examples. To export your own snapshot, install marginpack-0.1.0.xpi through Zotero's Tools → Plugins menu, select one HTML snapshot and choose “Export annotated snapshot with MarginPack…”. Use a new filename.
Validation: 9 adapter tests and 16 Chromium/Firefox exported-file tests passed locally. The actual Zotero 10.0.7 macOS ARM64 harness passed 12 checks using controlled selection/save seams; native save-dialog interaction and Windows/Linux Zotero are unverified. Full validation and limits.
The adapter targets Zotero 10.0.x. PDF/EPUB, original website CSS/scripts, external-resource fetching, export editing and import back into Zotero are outside this release. Review private notes and redistribution rights before sharing an export.
Built with AI coding assistance. Unaffiliated with Zotero or SingleFile. Feedback with small synthetic reproductions is welcome through GitHub Issues.