Introducing new tool: "Edit ToC"

kovidgoyal · 03-15-2013, 04:47 AM

Hi all,

This week's calibre release contains a new tool "Edit ToC" designed to allow you to easily create/edit the Table of Contents in EPUB and AZW3 files.

You can edit the entries in the ToC, delete them, re-arrange them and even change the location they point to by simply clicking on the corresponding place in the book.

To use this feature go to Preferences->Toolbars and add the "Edit ToC" tool to your main toolbar, then just select a book and click the Edit ToC button. The rest is hopefully self explanatory.

In the future I will be adding the ability to auto-generate the ToC from headings and/or links (something you can do easily with conversions).

This is completely new code, so there may be bugs, feel free to point them out

Enjoy.

HarryT · 03-15-2013, 05:24 AM

This sounds like an extremely useful tool. Thanks, Kovid!

Apache · 03-15-2013, 07:11 AM

A nice new feature. Thank you.
Apache

jersysman · 03-15-2013, 01:45 PM

The ability to auto-generate ToC will be greatly appreciated. I can't wait for that feature!

Divingduck · 03-15-2013, 03:14 PM

A nice feature. Something I was missing in Calibre. I like it.
One thing I saw, when you start the tool you have first the menu option create a new entry. If you select an existing toc the options change to a set of actions but you can't go back to this first menu option. It’s maybe a bit inconsistent for a book what have already a toc.
By playing around, some when the wish came up to combine this tool with xpath expression from the conversion toc dialog. It would be nice to have something like a preselected toc where I can define what entries I like to see (e.g. for books with long chapter listings).
Only a thought and may be something for future enhancements.

kovidgoyal · 03-15-2013, 03:36 PM

@Divingduck: You can add new entries from the individual entry screens as well, so there is no need to go back to the start screen. The start screen is mostly there for introducing the tool and for books that have empty tocs.

As I said I will be adding the feature to create ToC automatically from the book based on headings/links/etc. No reason I can't add a XPath based add as well.

Divingduck · 03-16-2013, 06:48 AM

@Kovid, I didn't read your first post carefully enough and reading over this paragraph

carlberger · 03-18-2013, 01:50 PM

Thanks Kovid. Am Reading the "Game of Thrones" Series. ToC is by numbers only and chapter heading by name of character only. This will help to put them together (such as 42. Jon V).

Divingduck · 03-22-2013, 03:44 AM

Just seen the update. Nice! Now I need to play a bit to pick up the extended functionality. Thanks

PatNY · 03-24-2013, 09:26 AM

Thanks Kovid and all the other good people who work on Calibre. When I updated 2 days ago I just found out about this new goodie. It's awesome and adds yet another super-convenient feature to one of the best free software programs ever developed.

Calibre, along with Sigil, now make it so easy to edit an epub compared to two years ago when I first started tweaking epubs. It's like night and day. Both programs have progressed tremendously.

Again, thanks to those who work on both programs for a job exceptionally done.

--Pat

Divingduck · 03-29-2013, 04:02 AM

What a nice surprise. The TOC Editor becomes more and more very useful functionality. Thanks again, Kovid.

Agama · 04-01-2013, 03:36 PM

Just used this for the first time to tidy up a really messy TOC in a purchased book and must say it proved very useful - thanks.

One minor enhancement which would be nice would be the option to "Proper Case" TOC entries. The book in question had long chapter titles all in UPPER case which looked "loud" and had to be cropped by my Sony reader.

kovidgoyal · 04-02-2013, 12:32 AM

Quote:

Originally Posted by Agama

One minor enhancement which would be nice would be the option to "Proper Case" TOC entries. The book in question had long chapter titles all in UPPER case which looked "loud" and had to be cropped by my Sony reader.

Sure, next release, via a right click menu.

theducks · 04-02-2013, 09:23 AM

jackie_w · 04-02-2013, 02:26 PM

I have a problem when trying to nest entries when the current TOC is already flattened. As an example if the TOC looks like this

Code:

Part 1
Chapter 1
Chapter 2
Chapter 3
Part 2
...

I want to select Chapters 1-3 as a block and drag-drop onto Part 1. The drag-drop action seems to be catered for, but unfortunately the chapter entries end up reversed, like this

Code:

Part 1
    Chapter 3
    Chapter 2
    Chapter 1
Part 2
...

Am I doing something wrong? Calibre 0.9.25 (x86) on Win 7 (x64) PC.

I should also probably add that I can work round it by drag-dropping the 3 chapters a second time, which un-reverses them.

03-15-2013, 04:47 AM	#1
kovidgoyal creator of calibre Posts: 43,860 Karma: 22666666 Join Date: Oct 2006 Location: Mumbai, India Device: Various	Introducing new tool: "Edit ToC" Hi all, This week's calibre release contains a new tool "Edit ToC" designed to allow you to easily create/edit the Table of Contents in EPUB and AZW3 files. You can edit the entries in the ToC, delete them, re-arrange them and even change the location they point to by simply clicking on the corresponding place in the book. To use this feature go to Preferences->Toolbars and add the "Edit ToC" tool to your main toolbar, then just select a book and click the Edit ToC button. The rest is hopefully self explanatory. In the future I will be adding the ability to auto-generate the ToC from headings and/or links (something you can do easily with conversions). This is completely new code, so there may be bugs, feel free to point them out Enjoy. Last edited by kovidgoyal; 03-15-2013 at 04:49 AM.

03-18-2013, 01:50 PM	#8
carlberger Retired Reader Posts: 4 Karma: 10 Join Date: Sep 2008 Location: St George, Utah Device: iPad	Thanks Kovid. Am Reading the "Game of Thrones" Series. ToC is by numbers only and chapter heading by name of character only. This will help to put them together (such as 42. Jon V). Last edited by carlberger; 03-18-2013 at 01:51 PM. Reason: typo

04-02-2013, 02:26 PM	#15
jackie_w Grand Sorcerer Posts: 6,212 Karma: 16534894 Join Date: Sep 2009 Location: UK Device: Kobo: KA1, ClaraHD, Forma, Libra2, Clara2E. PocketBook: TouchHD3	I have a problem when trying to nest entries when the current TOC is already flattened. As an example if the TOC looks like this Code: Part 1 Chapter 1 Chapter 2 Chapter 3 Part 2 ... I want to select Chapters 1-3 as a block and drag-drop onto Part 1. The drag-drop action seems to be catered for, but unfortunately the chapter entries end up reversed, like this Code: Part 1 Chapter 3 Chapter 2 Chapter 1 Part 2 ... Am I doing something wrong? Calibre 0.9.25 (x86) on Win 7 (x64) PC. I should also probably add that I can work round it by drag-dropping the 3 chapters a second time, which un-reverses them.

Similar Threads
Thread	Thread Starter	Forum	Replies	Last Post
Introducing New tool: "Polish" Books	kovidgoyal	Calibre	131	01-29-2023 04:41 PM
New Edit ToC tool	library addict	Calibre	2	03-15-2013 04:49 AM
Release : New Tool to Edit ePubs TOC, Edit with Sigil and keep you TOC	Nigol	ePub	105	10-29-2012 11:40 AM
Getting calibre to detect "Prologue" and "Epilogue" for TOC	sherman	Calibre	2	09-20-2010 02:21 AM

03-15-2013, 05:24 AM	#2
HarryT eBook Enthusiast Posts: 85,544 Karma: 93383043 Join Date: Nov 2006 Location: UK Device: Kindle Oasis 2, iPad Pro 10.5", iPhone 6	This sounds like an extremely useful tool. Thanks, Kovid!

03-15-2013, 07:11 AM	#3
Apache Readaholic Posts: 5,140 Karma: 90000000 Join Date: Sep 2011 Location: South Georgia Device: Surface Pro 6 / Galaxy Tab A 8"	A nice new feature. Thank you. Apache

03-15-2013, 01:45 PM	#4
jersysman Wizard Posts: 1,747 Karma: 3761220 Join Date: Mar 2011 Location: Pennsylvania Device: T1 Red, Kindle Fire, Kindle PW, PW2, Nook HD+, Kobo Mini, Aura HD	The ability to auto-generate ToC will be greatly appreciated. I can't wait for that feature!

03-15-2013, 03:14 PM	#5
Divingduck Wizard Posts: 1,161 Karma: 1404241 Join Date: Nov 2010 Location: Germany Device: Sony PRS-650	A nice feature. Something I was missing in Calibre. I like it. One thing I saw, when you start the tool you have first the menu option create a new entry. If you select an existing toc the options change to a set of actions but you can't go back to this first menu option. It’s maybe a bit inconsistent for a book what have already a toc. By playing around, some when the wish came up to combine this tool with xpath expression from the conversion toc dialog. It would be nice to have something like a preselected toc where I can define what entries I like to see (e.g. for books with long chapter listings). Only a thought and may be something for future enhancements.

03-15-2013, 03:36 PM	#6
kovidgoyal creator of calibre Posts: 43,860 Karma: 22666666 Join Date: Oct 2006 Location: Mumbai, India Device: Various	@Divingduck: You can add new entries from the individual entry screens as well, so there is no need to go back to the start screen. The start screen is mostly there for introducing the tool and for books that have empty tocs. As I said I will be adding the feature to create ToC automatically from the book based on headings/links/etc. No reason I can't add a XPath based add as well.

03-16-2013, 06:48 AM	#7
Divingduck Wizard Posts: 1,161 Karma: 1404241 Join Date: Nov 2010 Location: Germany Device: Sony PRS-650	@Kovid, I didn't read your first post carefully enough and reading over this paragraph

03-22-2013, 03:44 AM	#9
Divingduck Wizard Posts: 1,161 Karma: 1404241 Join Date: Nov 2010 Location: Germany Device: Sony PRS-650	Just seen the update. Nice! Now I need to play a bit to pick up the extended functionality. Thanks

03-24-2013, 09:26 AM	#10
PatNY Zennist Posts: 1,022 Karma: 47809468 Join Date: Jul 2010 Device: iPod Touch, Sony PRS-350, Nook HD+ & HD	Thanks Kovid and all the other good people who work on Calibre. When I updated 2 days ago I just found out about this new goodie. It's awesome and adds yet another super-convenient feature to one of the best free software programs ever developed. Calibre, along with Sigil, now make it so easy to edit an epub compared to two years ago when I first started tweaking epubs. It's like night and day. Both programs have progressed tremendously. Again, thanks to those who work on both programs for a job exceptionally done. --Pat

03-29-2013, 04:02 AM	#11
Divingduck Wizard Posts: 1,161 Karma: 1404241 Join Date: Nov 2010 Location: Germany Device: Sony PRS-650	What a nice surprise. The TOC Editor becomes more and more very useful functionality. Thanks again, Kovid.

04-01-2013, 03:36 PM	#12
Agama Guru Posts: 776 Karma: 2751519 Join Date: Jul 2010 Location: UK Device: PW2, Nexus7	Just used this for the first time to tidy up a really messy TOC in a purchased book and must say it proved very useful - thanks. One minor enhancement which would be nice would be the option to "Proper Case" TOC entries. The book in question had long chapter titles all in UPPER case which looked "loud" and had to be cropped by my Sony reader.

Advert

Advert

04-02-2013, 09:23 AM	#14
theducks Well trained by Cats Posts: 29,807 Karma: 54830978 Join Date: Aug 2009 Location: The Central Coast of California Device: Kobo Libra2,Kobo Aura2v1, K4NT(Fixed: New Bat.), Galaxy Tab A