View Single Post
Old 05-23-2025, 11:36 AM   #1
yogat3ch
Junior Member
yogat3ch began at the beginning.
 
yogat3ch's Avatar
 
Posts: 7
Karma: 10
Join Date: May 2025
Location: Mvskoke land, Milledgeville, GA
Device: Calibre Desktop
Lightbulb Annotations: HTML Output & eBook format selector

Hello Calibre Developers,

I'm joining this forum to discuss a potential enhancement for the Annotations/Highlights/Notes viewer and exporter within Calibre. My goal is to add a GUI selection for the eBook format when viewing or exporting annotations.

I'm currently using Calibre for a Dharma Teacher Training program and making extensive highlights and notes. I've developed a JavaScript function (Node.js) that combines Calibre's annotations with Markdown to create a more robust HTML output, preserving highlight colors and clearly distinguishing between notes and highlights. You can find the code on my new repository here.

During this process, I've consistently encountered an issue where it's unclear which eBook format's annotations are being exported when multiple formats (e.g., EPUB and PDF) are associated with the same book. This makes it difficult to manage and verify annotations from specific versions.

My intent is to develop a feature that allows users to select the specific eBook format from which annotations should be displayed and exported in the GUI. I believe this would significantly improve the usability and precision of Calibre's annotation features.

Seeking Collaboration
I'm looking for assistance and guidance from experienced Calibre developers. While I have a background in R and JavaScript, and some familiarity with Python, I'm new to the specifics of Calibre's codebase, particularly its annotation export engine and APIs.

If you have insights into:

Calibre's Python architecture for handling annotations and eBook formats.
The best approach for adding a GUI element for format selection.
Integrating external tools or scripts (like my HTML output function) into Calibre.
Please reach out! I'm eager to contribute and collaborate on implementing this feature.
yogat3ch is offline   Reply With Quote