Register Guidelines E-Books Search Today's Posts Mark Forums Read

Go Back   MobileRead Forums > E-Book Software > Calibre

Notices

Reply
 
Thread Tools Search this Thread
Old 09-24-2010, 11:00 AM   #1
GRiker
Comparer of the Ephemeris
GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.GRiker ought to be getting tired of karma fortunes by now.
 
Posts: 1,497
Karma: 424627
Join Date: Mar 2009
Device: iPad
[Old Thread] Tweak ePub - new feature (0.7.20)

Calibre now makes it possible to make small edits — tweaks — to ePubs in your library. You can use this feature to correct typos and formatting problems, or to edit CSS rules. This feature requires some knowledge of the ePub format — I would describe it as an intermediate user feature. If you need to learn more about the structure of ePubs, take a look at Liza Daly's Build a Digital Book with ePub or Liz Castro's EPUB Straight to the Point.

Begin by selecting a book in your library including an ePub format. Right-click to display the context menu, then select Tweak ePub. (You can also press the shortcut key 'T'). If you do not see the 'Tweak ePub' option, see If you have problems below. If the book does not currently include an ePub format, see Usage tips below.

The Tweak ePub dialog is displayed overlaying the top left corner of the calibre interface:


Click Explode ePub to open a file browser window showing the contents of the ePub. In the file browser window, right-click the file to be edited, then 'Open with...' your editor of choice. (The feature has been tested with BBEdit and Dreamweaver under OSX, and EditPad Pro under Windows.)

When your tweaks are complete, close the file browser window. Click Rebuild ePub. The tweaked ePub is rebuilt, and the rebuilt ePub replaces the original ePub in your calibre library.

Clicking Cancel discards all changes. The original ePub remains untweaked in your library.

Usage tips:
  • If you want to experiment with tweaking an ePub, use calibre's Save to disk to save a backup copy of your original ePub before you begin.
  • When editing HTML files, it may not be immediately apparent which file has the typo you're looking for. By default, HTML files normally open with a web browser, making it easier to figure out which file corresponds to which chapter. Double-click the file or use 'Open' from the context menu to view the files in your default browser.
  • If you need to make structural changes to your ePub, use Sigil or an ePub editor of your choosing. The 'Tweak ePub' feature is designed for light-weight touchups to ePub content.
  • When editing with an HTML design tool like Dreamweaver, changes made to the CSS can be previewed within the editor.
  • If the book you want to edit is not in ePub format:
    • Convert the book from its original format to ePub using Convert books
    • Explode, edit and rebuild the ePub as described above.
    • Convert the ePub back to your original format.

Under the hood:
  • Other than your edits, Tweak ePub does not modify the content of your ePub in any way.
  • Tweak ePub is a GUI-only feature. It is not available in the command line tools.

If you have problems:
  • I don't see the 'Tweak ePub' option when I right-click a book.
    • Open Preferences|Interface|Customize the toolbar
    • Select The context menu for books in the calibre library
    • In Available actions, select Tweak ePub
    • Click the right-pointing arrow, adding the Tweak ePub action to Current actions

Please post comments, questions, suggestions in this thread.

G

Last edited by GRiker; 09-24-2010 at 06:56 PM.
GRiker is offline   Reply With Quote
Old 09-24-2010, 11:29 AM   #2
edbro
Warthog Driver
edbro is fluent in JavaScript as well as Klingon.edbro is fluent in JavaScript as well as Klingon.edbro is fluent in JavaScript as well as Klingon.edbro is fluent in JavaScript as well as Klingon.edbro is fluent in JavaScript as well as Klingon.edbro is fluent in JavaScript as well as Klingon.edbro is fluent in JavaScript as well as Klingon.edbro is fluent in JavaScript as well as Klingon.edbro is fluent in JavaScript as well as Klingon.edbro is fluent in JavaScript as well as Klingon.edbro is fluent in JavaScript as well as Klingon.
 
edbro's Avatar
 
Posts: 632
Karma: 4911
Join Date: Jul 2007
Location: Grapevine, TX
Device: iPad4
The best just keeps getting better! Thank you to Kovid and all the developers.
edbro is offline   Reply With Quote
Old 09-24-2010, 12:16 PM   #3
Starson17
Wizard
Starson17 can program the VCR without an owner's manual.Starson17 can program the VCR without an owner's manual.Starson17 can program the VCR without an owner's manual.Starson17 can program the VCR without an owner's manual.Starson17 can program the VCR without an owner's manual.Starson17 can program the VCR without an owner's manual.Starson17 can program the VCR without an owner's manual.Starson17 can program the VCR without an owner's manual.Starson17 can program the VCR without an owner's manual.Starson17 can program the VCR without an owner's manual.Starson17 can program the VCR without an owner's manual.
 
Posts: 4,004
Karma: 177841
Join Date: Dec 2009
Device: WinMo: IPAQ; Android: HTC HD2, Archos 7o; Java:Gravity T
Quote:
Originally Posted by GRiker View Post
If you want to experiment with tweaking an ePub, use calibre's Save to disk to save a backup copy of your original ePub before you begin.
You may also prefer to duplicate the record inside Calibre and work on that record. Use Add Book to add an empty book record, select that record first, then select the book you want duplicated and press ALT-M to do a safe merge (merge-keep others) of the second book into the empty record. The order of selection is important. Note that merging does not duplicate ISBN, and the date field is updated to the date the new empty record was added, so it's not an exact copy of the first record. When you're done, you can delete the EPUB you don't like (from either the new record or the old one) and merge the two records to end up with a single record and your preferred EPUB.

Great feature GRiker!

Last edited by Starson17; 09-24-2010 at 12:20 PM.
Starson17 is offline   Reply With Quote
Old 09-25-2010, 12:22 PM   #4
Agama
Guru
Agama ought to be getting tired of karma fortunes by now.Agama ought to be getting tired of karma fortunes by now.Agama ought to be getting tired of karma fortunes by now.Agama ought to be getting tired of karma fortunes by now.Agama ought to be getting tired of karma fortunes by now.Agama ought to be getting tired of karma fortunes by now.Agama ought to be getting tired of karma fortunes by now.Agama ought to be getting tired of karma fortunes by now.Agama ought to be getting tired of karma fortunes by now.Agama ought to be getting tired of karma fortunes by now.Agama ought to be getting tired of karma fortunes by now.
 
Agama's Avatar
 
Posts: 667
Karma: 436517
Join Date: Jul 2010
Location: UK
Device: PRS-300 (R.I.P.), PW2, Nexus7
Many thanks! Just what I needed and avoids resorting to Sigil for minor ePub edits.

Quote:
Originally Posted by GRiker View Post
The feature has been tested with BBEdit and Dreamweaver under OSX, and EditPad Pro under Windows.
And it works with Notepad++ for Windows.

Last edited by Agama; 09-25-2010 at 12:27 PM.
Agama is offline   Reply With Quote
Old 09-25-2010, 01:03 PM   #5
omk3
Wizard
omk3 can name that ebook in five wordsomk3 can name that ebook in five wordsomk3 can name that ebook in five wordsomk3 can name that ebook in five wordsomk3 can name that ebook in five wordsomk3 can name that ebook in five wordsomk3 can name that ebook in five wordsomk3 can name that ebook in five wordsomk3 can name that ebook in five wordsomk3 can name that ebook in five wordsomk3 can name that ebook in five words
 
omk3's Avatar
 
Posts: 1,454
Karma: 37243
Join Date: Dec 2009
Location: Europe
Device: pocketbook 360, kindle 4
What a fantastic feature! I always avoided making changes to epubs unless absolutely necessary, because I was bored of the repackaging process. Thank you!
omk3 is offline   Reply With Quote
Old 09-25-2010, 02:53 PM   #6
theducks
Grand Sorcerer
theducks ought to be getting tired of karma fortunes by now.theducks ought to be getting tired of karma fortunes by now.theducks ought to be getting tired of karma fortunes by now.theducks ought to be getting tired of karma fortunes by now.theducks ought to be getting tired of karma fortunes by now.theducks ought to be getting tired of karma fortunes by now.theducks ought to be getting tired of karma fortunes by now.theducks ought to be getting tired of karma fortunes by now.theducks ought to be getting tired of karma fortunes by now.theducks ought to be getting tired of karma fortunes by now.theducks ought to be getting tired of karma fortunes by now.
 
theducks's Avatar
 
Posts: 15,098
Karma: 5939999
Join Date: Aug 2009
Location: (The original) Silicon Valley, USA
Device: Galaxy Tab 2, Astak Pocket Pro, K4NT
OOOH!
Spell check possible
Image substitution (keeping same name) possible.

Notepad++ is my friend
theducks is offline   Reply With Quote
Old 09-25-2010, 05:33 PM   #7
Rand Brittain
Bookmaker
Rand Brittain can eat soup with a fork.Rand Brittain can eat soup with a fork.Rand Brittain can eat soup with a fork.Rand Brittain can eat soup with a fork.Rand Brittain can eat soup with a fork.Rand Brittain can eat soup with a fork.Rand Brittain can eat soup with a fork.Rand Brittain can eat soup with a fork.Rand Brittain can eat soup with a fork.Rand Brittain can eat soup with a fork.Rand Brittain can eat soup with a fork.
 
Posts: 226
Karma: 9102
Join Date: Sep 2010
Device: Cybook Opus
This is an extremely useful feature. Thanks!
Rand Brittain is offline   Reply With Quote
Old 09-25-2010, 09:00 PM   #8
Zyzomys
Hooked on Phonics
Zyzomys began at the beginning.
 
Zyzomys's Avatar
 
Posts: 122
Karma: 24
Join Date: Jun 2010
Location: Ottawa, Canada
Device: Kobo, Kindle 3 Wi-Fi
This is great! Thank you.
Zyzomys is offline   Reply With Quote
Old 09-25-2010, 09:02 PM   #9
Top Tomato
Member
Top Tomato ought to be getting tired of karma fortunes by now.Top Tomato ought to be getting tired of karma fortunes by now.Top Tomato ought to be getting tired of karma fortunes by now.Top Tomato ought to be getting tired of karma fortunes by now.Top Tomato ought to be getting tired of karma fortunes by now.Top Tomato ought to be getting tired of karma fortunes by now.Top Tomato ought to be getting tired of karma fortunes by now.Top Tomato ought to be getting tired of karma fortunes by now.Top Tomato ought to be getting tired of karma fortunes by now.Top Tomato ought to be getting tired of karma fortunes by now.Top Tomato ought to be getting tired of karma fortunes by now.
 
Posts: 23
Karma: 1074640
Join Date: Jun 2008
Device: Kindle 3G
Fantastic! Just like Agama said, works great in Notepad++!

Thank you, thank you!
Top Tomato is offline   Reply With Quote
Old 09-25-2010, 09:06 PM   #10
DoctorOhh
US Navy, Retired
DoctorOhh ought to be getting tired of karma fortunes by now.DoctorOhh ought to be getting tired of karma fortunes by now.DoctorOhh ought to be getting tired of karma fortunes by now.DoctorOhh ought to be getting tired of karma fortunes by now.DoctorOhh ought to be getting tired of karma fortunes by now.DoctorOhh ought to be getting tired of karma fortunes by now.DoctorOhh ought to be getting tired of karma fortunes by now.DoctorOhh ought to be getting tired of karma fortunes by now.DoctorOhh ought to be getting tired of karma fortunes by now.DoctorOhh ought to be getting tired of karma fortunes by now.DoctorOhh ought to be getting tired of karma fortunes by now.
 
DoctorOhh's Avatar
 
Posts: 8,889
Karma: 12755553
Join Date: Feb 2009
Location: North Carolina
Device: Nexus 7
Thanks a bunch. I was using the tweak-epub by AWP but I was growing bored having to drill my way through the directory structure to the file even when using the "Open with" option.

This makes things much more convenient.
DoctorOhh is offline   Reply With Quote
Old 09-26-2010, 12:39 AM   #11
phenomshel
ZCD BombShel
phenomshel ought to be getting tired of karma fortunes by now.phenomshel ought to be getting tired of karma fortunes by now.phenomshel ought to be getting tired of karma fortunes by now.phenomshel ought to be getting tired of karma fortunes by now.phenomshel ought to be getting tired of karma fortunes by now.phenomshel ought to be getting tired of karma fortunes by now.phenomshel ought to be getting tired of karma fortunes by now.phenomshel ought to be getting tired of karma fortunes by now.phenomshel ought to be getting tired of karma fortunes by now.phenomshel ought to be getting tired of karma fortunes by now.phenomshel ought to be getting tired of karma fortunes by now.
 
phenomshel's Avatar
 
Posts: 4,737
Karma: 6180874
Join Date: Jan 2009
Location: The Frozen North (aka Illinois, USA)
Device: Dell Venue Pro 8
OMG!!! I did it!! Exploded an ePub, fixed a problem, rebuilt it, and it's perfect!!
phenomshel is offline   Reply With Quote
Old 09-26-2010, 07:05 AM   #12
Jonimeesermann
Connoisseur
Jonimeesermann began at the beginning.
 
Posts: 82
Karma: 12
Join Date: Apr 2010
Device: Nokia e71, Ipod Touch, Sony PRS 300
Great feature!! Really saves my time cause I like to play around with epub.

Interesting choice of name too, "explode epub" rather than unePub (such as zip and unzip).
Jonimeesermann is offline   Reply With Quote
Old 09-26-2010, 07:18 AM   #13
pvdv
Enthusiast
pvdv ought to be getting tired of karma fortunes by now.pvdv ought to be getting tired of karma fortunes by now.pvdv ought to be getting tired of karma fortunes by now.pvdv ought to be getting tired of karma fortunes by now.pvdv ought to be getting tired of karma fortunes by now.pvdv ought to be getting tired of karma fortunes by now.pvdv ought to be getting tired of karma fortunes by now.pvdv ought to be getting tired of karma fortunes by now.pvdv ought to be getting tired of karma fortunes by now.pvdv ought to be getting tired of karma fortunes by now.pvdv ought to be getting tired of karma fortunes by now.
 
pvdv's Avatar
 
Posts: 29
Karma: 300003
Join Date: Jan 2008
Location: Drachten, The Netherlands
Device: Kobo Aura HD, BeBook Neo, Cybook Gen3
Very happy with this new functionality.
I also used the AWP tweak-epub a lot, but since I switched to Linux (Mint) recently, I sorely missed being able to use it. (Wine made it an irritating experience...)
pvdv is offline   Reply With Quote
Old 10-05-2010, 04:16 PM   #14
kiermel
Enthusiast
kiermel began at the beginning.
 
kiermel's Avatar
 
Posts: 43
Karma: 10
Join Date: Apr 2009
Location: Malaga - Spain
Device: Kindle Touch, iPad, iPhone
Thanks a lot! Is a very useful feature
kiermel is offline   Reply With Quote
Old 10-24-2010, 06:40 PM   #15
jmolinuevo
Junior Member
jmolinuevo began at the beginning.
 
Posts: 2
Karma: 10
Join Date: Oct 2010
Device: kindle 3G + wifi
Problem exploding EPUB

When I explode an EPUB nothing happens. Calibre returns the following terminal message:

Code:
error: no assocations found for  cannot open `/home/username/file:/tmp/calibre_0.7.24_tmp_r07ZTh/calibre_0.7.24_LPg7xk_exploded' (No such file or directory)
I am running an archlinux machine with openbox. ¿Maybe a bad file association in my system? ¿what is called by calibre when I click "explode EPUB"?

Thanks.
jmolinuevo is offline   Reply With Quote
Reply

Thread Tools Search this Thread
Search this Thread:

Advanced Search

Forum Jump

Similar Threads
Thread Thread Starter Forum Replies Last Post
Feature/tweak/plugin request lathom Calibre 0 08-03-2011 10:09 AM
Tweak ePub Daniel0312 Calibre 6 06-26-2011 12:31 PM
Tweak ePub Error on Fedora 15 apastuszak Calibre 2 06-06-2011 10:15 AM
Setting Path for Tweak ePub Agama Calibre 6 12-03-2010 03:06 AM
Tweak epub and Simple CSS Editor Shadowman123 Calibre 11 09-30-2010 11:07 AM


All times are GMT -4. The time now is 08:36 AM.


MobileRead.com is a privately owned, operated and funded community.