|07-14-2013, 06:39 PM||#1|
Join Date: Apr 2013
Device: Kindle Paperwhite
[GUI Plugin] KiNotes
A UI plugin that retrieves annotations from Amazon Kindle readers and places them into the corresponding EPUB ebook for further editing.
Hi there, couldn't find the "how to publish a plugin" tutorial. But well - how hard can it be? Err... I'll just try to mimic some of the other plugin posts. Let's see what happens...
Never heard about KiNotes - what is it good for?
KiNotes helps to get annotations made on the Amazon Kindle ebook reader back into a form you can use for further editing. Annotations are highlights, notes or bookmarks you placed into a book while reading it on the Kindle. KiNotes contains tools that allow to read out these annotations and write them into an editable EPUB ebook on your computer. It appears Amazon did not design the Kindle with this application in mind, so KiNotes can not succeed in all scenarios.
Here is what I imagine to be the typical use workflow, which I call the "Proof Reader Scenario":
If all goes well up to and including step 6 (did you have a nice holiday?), you will have a new file with a name ending with " + KiNotes.epub" in the folder Calibre stores your book. Open it with your favorite EPUB editor. With most editors you will be able to use the tab key to walk through the annotations quickly in HTML view. Alternatively you can search the plain HTML text for square brackets [ ] or search the HTML text for tags containing 'class="KiNotes'.
Sigil would be a popular choice of editor. I designed KiNotes to work well enough with Sigil. While doing this I found that Sigil does a lot of reformatting and normalization to any EPUB it edits. Those changes are most certainly well intended, mostly harmless in many cases, but sometimes they change the book in unexpected ways. It may change the overall layout in an immediately obvious way; or it may cause local changes which are not so obvious and my go unnoticed for a long time. With this warning in mind, go ahead and use Sigil if you like it. (Personally I would prefer a more conservative editor. Let me know if you find a good one.)
KiNotes does not work with my ebook - why? What can I do?
Here are some known limitations of KiNotes:
Something is wrong with KiNotes and should be improved - how can I contact the author and why does this lazy *@$#$!!$* not reply?
As a first step I suggest you post your concern on the MobiRead forum here. Be as specific as possible. Specify which version of Kindle, KiNotes, Calibre, OS, etc., etc., etc. you use. If you found a bug, consider to create a short EPUB/MOBI pair for which the problem happens. Have a look for error messages in the job details and specify any error messages or warnings that have the slightest chance of being related to the problem. There are some smart and kind people around in the forum, so chances are you may get help there. The more specific you are, the better the chances for help.
I'll try to answer forum posts, but knowing myself I have to say there will be times when I just have to focus my full attention on other topics, with no energy left to answer even simple questions. Much of these distractions are caused by my job; should there come a day when I get enough donations to quit the job I promise to answer posts and emails on a daily basis; until then please allow me to be offline for some weeks or months until I get into the mood of working on KiNotes again for the fun of it.
If you find my contributions to Calibre useful, say thanks with PayPal
|Thread Tools||Search this Thread|
|Thread||Thread Starter||Forum||Replies||Last Post|
|[GUI Plugin] Hyphenate This!||SauliusP.||Plugins||300||04-02-2017 06:11 AM|
|[GUI Plugin] KindleUnpack - The Plugin||DiapDealer||Plugins||402||03-05-2017 10:31 AM|
|[GUI Plugin] SmartEject||JimmXinu||Plugins||34||10-12-2016 11:37 AM|
|[GUI Plugin] Astro-ph||iatheia||Plugins||14||07-25-2015 11:41 PM|
|[GUI Plugin] Plugin Updater **Deprecated**||kiwidude||Plugins||159||06-19-2011 12:27 PM|