how to use command line to automatically create ToC from all headings?

[Whip]

Hello,

I want to use the command line to convert an html book to epub and select the setting "Generate ToC from all headings." I don't see this option available in the command line interface in the documentation, but it is available in the calibre edit GUI.

Currently, I have to drag the html into calibre, convert to epub, click edit on the converted file, open the ToC GUI, delete the auto-generated ToC, then click "Generate ToC from all headings".

Can someone tell me how to automate this process from the command line with ebook-convert, ebook-edit, or some other tool?

Thank you!

[kovidgoyal]

https://manual.calibre-ebook.com/gen...le-of-contents

[Whip]

I looked at that documentation and I don't see an option for exactly what I'm looking for.

Is there a flag for "Generate ToC from all headings"? When I click that button in the GUI, the ToC comes out perfectly. I just don't see a command-line flag for that setting. Can you please point me to it?

[theducks]

ebook-convert input_file output_file [options]

Did you scroll down in the Help file? There is a TOC section with options

[Whip]

I do not see any setting described in the help documentation that does what I am asking for. I specifically want a command line option that matches the GUI button for "Generate ToC from all headings"

None of the flags in the documentation that I've found describe that option. Do you know how I could select that setting from the command line?

[kovidgoyal]

There is no such flag. You need to specify the level1 through level3 settings manually. The button in the GUI does just that under the hood. Read their docs to understand what you need to put there, or look at the conversion log of the GUI conversion to see what values those settings have.

[Whip]

Alright, thank you for clarifying.

Also, thanks for making Calibre and releasing it for free. I am a big fan of the software.

[Whip]

I hate to keep asking for help but - can you tell me where the conversion logs are stored?

I tried running calibre-debug --gui and calibre-debug --edit-book and those logs didn't contain the ToC conversion commands.

And I don't see a reference to conversion logs in the manual: https://manual.calibre-ebook.com/edit.html

I tried running calibre in debug mode as suggested here (https://www.mobileread.com/forums/sh...d.php?t=344814) but those logs didn't contain the conversion details.

How can I access the conversion logs? Thank you for your help!

[thiago.eec]

Originally Posted by Whip

How can I access the conversion logs? Thank you for your help!

After converting, look at the bottom right of calibre main window. There is a button to show the Jobs window. Click on the last conversion job, then click on 'Show job details'.

[theducks]

Originally Posted by thiago.eec

After converting, look at the bottom right of calibre main window. There is a button to show the Jobs window. Click on the last conversion job, then click on 'Show job details'.

I think the OP is doing everything from the command line.

[DNSB]

Originally Posted by theducks

I think the OP is doing everything from the command line.

A couple of message back, Kovid Goyal suggested running a GUI conversion and looking at the log from that to see what values the level1 to level3 settings were using.

The problem I see with that is that after the conversion, the OP was opening the ebook in calibre's ebook-editor, deleting the ToC generated in the GUI mode conversion and using the ebook-editor to recreate it with "Generate ToC from all headings" button.

I suspect that the OP might be able to do this by playing with the XPath for the levels so any h? tag would be used to create a ToC entry. Something like //*[name()='h1' or name()='h2' or name()='h3' or name()='h4' or name()='h5' or name()='h6'] though I haven't played enough with XPath to feel comfortable making recommendations.

[theducks]

Me neither
But looking at the CLI, I suspect that xpath needs to be separated into 3 because the CLI has a separate option for each level

ebook-convert input_file output_file --level1-toc <xpath> --level2-toc <xpath>--level3-toc <xpath>

[DNSB]

I think what I posted would handle multiple h? headings for testing. The OP might want to split out the various headings for other purposes but for testing, what I posted should work though I haven't tested it.