[GUI Plugin] EpubSplit

JimmXinu · 05-19-2012, 06:15 PM

Splitting omnibus eBooks into multiple eBooks seems to be a common request, but there haven't been many tools to do so without a lot of hand editing.

This plugin provides the ability to create new EPUBs by splitting off part of an existing (non-DRM) EPUB format eBook.

Main Features of EpubSplit Plugin:

Present the user with a list of 'split lines' in the existing EPUB. The beginning of each file listed in the manifest spine and each Table of Contents(TOC) entry. <guide> tagged files are also indicated.
'Preview' contents of each 'split line' as a tooltip over the HREF.
Allow user to edit the TOC entry(s) for each 'line'.
Select one or more of the offered lines to include in the new eBook,
Edit the metadata for the new split eBook, and then,
Extract only the selected contents of the source EPUB into the new EPUB,
Scan the selected content for CSS & image links for additional files to include,
Scan the selected content for internal links and anchors and update links that need to point to different filenames,
Use the metadata entered into calibre for the new eBook (including cover) as the metadata in the new EPUB.
Return to list of source EPUB sections after creating a new split EPUB.
New in version 2.1.0 - Select one or more of the offered lines and split each into a separate new book.
Configure which metadata from source EPUB to copy to new eBook, now offering more of the standard metadata and custom columns.
Configurably populate a custom column with the source book title/author/etc.
CLI via calibre-debug --run-plugin

Special Notes:

Requires Calibre v3.48.0 or later.

Languages:

This plugin has (at least partial) translations for:

Catalan
Chinese (Hong Kong)
Dutch
Estonian
French
German
Greek
Hebrew
Norwegian Bokmål
Polish
Portuguese (Brazil)
Romanian
Spanish
Swedish
Turkish
Ukrainian

Command Line Interface(CLI)

Starting with calibre v0.9.23, calibre offers a command-line interface (CLI) for calling plugins.

This plugin supports that option and allows the user to call the plugin's basic functionality from outside calibre without having to install Python or get the plugin's files separately.

Details:

Spoiler:

Installation Steps:

Download the attached zip file and install the plugin/add to context menu or toolbar/restart Calibre as described in the Introduction to plugins thread.

Version History:

Spoiler:

JSWolf · 05-19-2012, 06:26 PM

Quote:

Originally Posted by jackie_w

I take it you didn't read my previous post. Sigil is a very good tool for ad-hoc epub editing, but you will see that I listed a couple of things that Sigil didn't automatically clean up for me, namely css files which were no longer referenced and items in the opf <guide> which referenced deleted files. Nor did it automatically remove images which were no longer referenced, nor remove unwanted items from the .ncx file. Luckily, 'Modify epub' does both of the latter.

That's what FlightCrew is for. It will find these things so you can fix them. I know an automated tool can handle a lot of these things. But, what if you find out after you've split your ePub that you've left bits out because you didn't see the shared files. I've done splitting manually (before Sigil) and yes, most of the omnibus editions have shared files that are not obvious from the filenames. Unless this plugin supports viewing of files, it won't work well enough overall.

JSWolf · 05-19-2012, 06:30 PM

Quote:

Originally Posted by JimmXinu

I agree that it's not nearly as easy as epub merging was. But I think a useful tool can still be had from it for basic splitting.

My vision right now is to offer a list of 'split lines'--the beginning of each file and/or each TOC entry--and let the user click and choose which they want to include. I agree that trying to automatically decide where to split is beyond complex.

Then the program includes only those files (or partial files), scans them for included css & images, writes only those files, manifest and TOC. TOC gets flattened along the way (that way lies madness).

I have that much working in CLI already. (Still need to fix internal URLs, worry about cover image, etc.) I plan to offer & collect metadata using calibre's edit metadata dialog, similar to EpubMerge.

That sounds to me like a useful tool because to do it manually would take a number of steps in Sigil to split/delete files, clean up TOC, plus Modify ePub to remove unused img/css files.

People who are looking for absolutely perfect epubs will still need to hand edit, but I think this will be useful.

Can you make your tool do an after clean? So say someone uses Sigil to split things. Instead of then having to sort out things that will need to be sorted like broken links and such, ePubSplit be used to do just the cleaning up?

PeterT · 05-19-2012, 06:47 PM

Just tried splitting up an omnibus edition of the Game of Thrones that I had also split by hand. Seemed to work like a champ.

Now time to run it through KiwiDude's creation to see what it finds

JSWolf · 05-19-2012, 07:38 PM

Quote:

Originally Posted by PeterT

Just tried splitting up an omnibus edition of the Game of Thrones that I had also split by hand. Seemed to work like a champ.

Now time to run it through KiwiDude's creation to see what it finds

When you did the splitting with this tool, were you able to easily get the shared files so what you ended up with was complete?

JimmXinu · 05-19-2012, 07:40 PM

The plugin looks through the HTML it's keeping for style and img tags and includes those files.

If you find a case where it doesn't, I'd like to know about it.

PeterT · 05-19-2012, 08:58 PM

Quote:

Originally Posted by JSWolf

When you did the splitting with this tool, were you able to easily get the shared files so what you ended up with was complete?

Well so far no sign of any broken links, missing images, or extra image files. No reports of any unmanifested files

JimmXinu · 05-19-2012, 09:06 PM

Quote:

Originally Posted by JSWolf

Can you make your tool do an after clean? So say someone uses Sigil to split things. Instead of then having to sort out things that will need to be sorted like broken links and such, ePubSplit be used to do just the cleaning up?

Somewhat. You could use EpubSplit and select all files, that should remove any extra css/image files that aren't used.

It doesn't make any attempt to remove links to files that aren't in the source epub.

JimmXinu · 05-19-2012, 10:30 PM

Any suggestions for the icon for this?

Here's what I've been toying with.

jackie_w · 05-19-2012, 11:01 PM

Hi Jimm,

I just did a quick test with the 6-book bundle I split a few days ago. It seems to create clean and tidy epubs

I did notice one thing, though... the opf and ncx files had both had all their end-of-line characters removed after the split, which made them difficult to read. Was this deliberate?

Hopefully, I'll have more time tomorrow to test a few more bundles.

Thank you for your hard work

JimmXinu · 05-19-2012, 11:06 PM

@jackie_w - Thanks for testing--hopefully it continues to work for you.

As for the opf & ncx, they're being created completely anew, not copied and modified. While working on earlier projects, I found that trying to pretty print those files from my constructed DOM caused problems with excess whitespace in the text data, like ToC entries. At the time, I didn't judge it important enough to put more effort into.

JSWolf · 05-19-2012, 11:15 PM

Quote:

Originally Posted by PeterT

Well so far no sign of any broken links, missing images, or extra image files. No reports of any unmanifested files

Did you get all the files that went with the book including all the shared files/cover pages/copyright?

JimmXinu · 05-19-2012, 11:58 PM

If you select them, they get included. If you don't, they don't.

It doesn't look at any <guide> tags, if that's what you're asking.

If the source book has a cover in calibre, it will copy that to the new book record before presenting the metadata. If there's a cover in the metadata after it's been presented and accepted (from the original, downloaded, whatever), it will be included in the EPUB.

No other html files are given any special consideration.

JSWolf · 05-20-2012, 12:04 AM

Question, will there be a way to tell what files are what for the ones that don't have names that are obvious? Because if you cannot see the contents in some way, then it will be very difficult for some to be able to get all the files needed for a given eBook from an omnibus.

PeterT · 05-20-2012, 01:35 AM

What you see when you are doing the split is the chapter headings... So it's not picking files per se, rather a listing of HREFs (appears to be the full name of the files) and then their entries in the Table of Contents.

So all I did was to highlight the entries from the first portion of each book, through to the final TOC entry for that book. Images and CSS file names don'r appear in this list; they seem to get included based on what is needed.

05-19-2012, 10:30 PM	#9
JimmXinu Plugin Developer Posts: 6,597 Karma: 4600391 Join Date: Dec 2011 Location: Midwest USA Device: Kindle Paperwhite(10th)	Any suggestions for the icon for this? Here's what I've been toying with. Attached Thumbnails

Similar Threads
Thread	Thread Starter	Forum	Replies	Last Post
[GUI Plugin] EpubMerge	JimmXinu	Plugins	542	10-28-2024 02:40 PM
[GUI Plugin] KindleUnpack - The Plugin	DiapDealer	Plugins	495	10-19-2024 07:06 AM
[GUI Plugin] Open With	kiwidude	Plugins	403	04-01-2024 09:39 AM
[GUI Plugin] FanFictionDownLoader	JimmXinu	Plugins	3985	05-09-2015 12:18 AM
[GUI Plugin] Plugin Updater Deprecated	kiwidude	Plugins	159	06-19-2011 01:27 PM

05-19-2012, 06:47 PM	#4
PeterT Grand Sorcerer Posts: 12,774 Karma: 75242724 Join Date: Nov 2007 Location: Toronto Device: Libra H2O, Libra Colour	Just tried splitting up an omnibus edition of the Game of Thrones that I had also split by hand. Seemed to work like a champ. Now time to run it through KiwiDude's creation to see what it finds

05-19-2012, 07:40 PM	#6
JimmXinu Plugin Developer Posts: 6,597 Karma: 4600391 Join Date: Dec 2011 Location: Midwest USA Device: Kindle Paperwhite(10th)	The plugin looks through the HTML it's keeping for style and img tags and includes those files. If you find a case where it doesn't, I'd like to know about it.

05-19-2012, 11:01 PM	#10
jackie_w Grand Sorcerer Posts: 6,225 Karma: 16536676 Join Date: Sep 2009 Location: UK Device: Kobo: KA1, ClaraHD, Forma, Libra2, Clara2E. PocketBook: TouchHD3	Hi Jimm, I just did a quick test with the 6-book bundle I split a few days ago. It seems to create clean and tidy epubs I did notice one thing, though... the opf and ncx files had both had all their end-of-line characters removed after the split, which made them difficult to read. Was this deliberate? Hopefully, I'll have more time tomorrow to test a few more bundles. Thank you for your hard work

05-19-2012, 11:06 PM	#11
JimmXinu Plugin Developer Posts: 6,597 Karma: 4600391 Join Date: Dec 2011 Location: Midwest USA Device: Kindle Paperwhite(10th)	@jackie_w - Thanks for testing--hopefully it continues to work for you. As for the opf & ncx, they're being created completely anew, not copied and modified. While working on earlier projects, I found that trying to pretty print those files from my constructed DOM caused problems with excess whitespace in the text data, like ToC entries. At the time, I didn't judge it important enough to put more effort into.

05-19-2012, 11:58 PM	#13
JimmXinu Plugin Developer Posts: 6,597 Karma: 4600391 Join Date: Dec 2011 Location: Midwest USA Device: Kindle Paperwhite(10th)	If you select them, they get included. If you don't, they don't. It doesn't look at any <guide> tags, if that's what you're asking. If the source book has a cover in calibre, it will copy that to the new book record before presenting the metadata. If there's a cover in the metadata after it's been presented and accepted (from the original, downloaded, whatever), it will be included in the EPUB. No other html files are given any special consideration.

05-20-2012, 12:04 AM	#14
JSWolf Resident Curmudgeon Posts: 76,513 Karma: 136565488 Join Date: Nov 2006 Location: Roslindale, Massachusetts Device: Kobo Libra 2, Kobo Aura H2O, PRS-650, PRS-T1, nook STR, PW3	Question, will there be a way to tell what files are what for the ones that don't have names that are obvious? Because if you cannot see the contents in some way, then it will be very difficult for some to be able to get all the files needed for a given eBook from an omnibus.

05-20-2012, 01:35 AM	#15
PeterT Grand Sorcerer Posts: 12,774 Karma: 75242724 Join Date: Nov 2007 Location: Toronto Device: Libra H2O, Libra Colour	What you see when you are doing the split is the chapter headings... So it's not picking files per se, rather a listing of HREFs (appears to be the full name of the files) and then their entries in the Table of Contents. So all I did was to highlight the entries from the first portion of each book, through to the final TOC entry for that book. Images and CSS file names don'r appear in this list; they seem to get included based on what is needed.

Advert

Advert