How to generate bookmarks correctly

Spiral · 04-09-2023, 11:20 AM

I am learning to produce epub files using sigil, and I am working on a file of format epub3. I want the defined a epub file so that bookmarks are generated when viewed by, say, Okular.

I have tried all I can but the file defined just go with bookmarks. I have compared files thoroughly with the .epub downloaded from https://www.mobileread.com/forums/sh...82&postcount=8.

I have studied the downloaded file and found:

the bookmarks is generated from `toc.ncx` instead of `nav.xhtml`
the bookmarks of my working file is generated from the guide section of content.opf
The only difference I can find is that the downloaded file is opened by epub3.0-Sigil[std] and my working file epub3.0-Sigil

A further question, is it possible to generate bookmarks from nav.xhtml, as toc.ncx is not needed for a epub3 file?

KevinH · 04-09-2023, 12:46 PM

Your use of the term bookmarks confused me. The actual terms are a Table of Contents (TOC) and Landmarks (Guide items). A bookmark is a user generated remembered location.

In an epub3, no toc.ncx is needed. Both its role and the opf guide are subsumed into the nav.xhtml document. But if you want older epub2 only readers to show a table of contents and guide/landmarks in your epub3 you can add them back.

In Sigil under epub3, the Table of Contents (TOC) tools work with the nav, not the toc.ncx.

There are tools in Sigil to create a TOC from the h1-h6 tags in the files. There are also tools to edit the TOC, promote/demote, and edit titles.

To set Landmarks/Guide items you use the Set Semantics tools by right clicking on a file in Sigil's BookBrowser.

Once you are happy with the TOC and have set appropriate file level semantics (which fills in the Nav landmarks info). You should be good to go for epub3.

If you want to create an epub3 that is more backwards compatible with older epub2 ereaders, there is an Epub3 Tools menu on Sigil that will create an equivalent toc.ncx and fill in the opf guide items.

There is also an epub3 tool menu to remove the toc.ncx and the opf guide if you do not care about being backwards compatible with epub2 only readers.

All of this is explained in the Sigil Users Guide.

Hope simething here helps.

Spiral · 04-14-2023, 05:43 AM

Thanks for your reply! It does help me clear some of my confussions.

Whay I mean by "bookmarks" is something that is shown by the reader to quickly jump among the parts of the content. I use it by the convention of the Okular reader.

My question has been solved by Tools -> Restructure Epub To Sigial Norm.

04-09-2023, 11:20 AM	#1
Spiral Junior Member Posts: 3 Karma: 10 Join Date: Apr 2023 Device: kindle	How to generate bookmarks correctly I am learning to produce epub files using sigil, and I am working on a file of format epub3. I want the defined a epub file so that bookmarks are generated when viewed by, say, Okular. I have tried all I can but the file defined just go with bookmarks. I have compared files thoroughly with the .epub downloaded from https://www.mobileread.com/forums/sh...82&postcount=8. I have studied the downloaded file and found: the bookmarks is generated from `toc.ncx` instead of `nav.xhtml` the bookmarks of my working file is generated from the guide section of content.opf The only difference I can find is that the downloaded file is opened by epub3.0-Sigil[std] and my working file epub3.0-Sigil A further question, is it possible to generate bookmarks from nav.xhtml, as toc.ncx is not needed for a epub3 file? Last edited by Spiral; 04-09-2023 at 11:22 AM. Reason: typos

Similar Threads
Thread	Thread Starter	Forum	Replies	Last Post
Generate eBook from Bookmarks Archive	vaniaspeedy	Workshop	4	01-05-2013 06:58 PM
Generate eBook from Bookmarks Archive	vaniaspeedy	General Discussions	0	01-01-2013 11:44 PM
Bookmarks don't seem to be loading correctly...	pokee	Kobo Tablets	12	01-25-2012 01:37 PM
Generate Cover	Mythlandia	Calibre	27	06-27-2010 09:02 PM
instapaper.com - Bookmarks service that generate epub and mobi books	celson	Ectaco jetBook	3	03-14-2010 12:10 AM

04-09-2023, 12:46 PM	#2
KevinH Sigil Developer Posts: 8,160 Karma: 5450818 Join Date: Nov 2009 Device: many	Your use of the term bookmarks confused me. The actual terms are a Table of Contents (TOC) and Landmarks (Guide items). A bookmark is a user generated remembered location. In an epub3, no toc.ncx is needed. Both its role and the opf guide are subsumed into the nav.xhtml document. But if you want older epub2 only readers to show a table of contents and guide/landmarks in your epub3 you can add them back. In Sigil under epub3, the Table of Contents (TOC) tools work with the nav, not the toc.ncx. There are tools in Sigil to create a TOC from the h1-h6 tags in the files. There are also tools to edit the TOC, promote/demote, and edit titles. To set Landmarks/Guide items you use the Set Semantics tools by right clicking on a file in Sigil's BookBrowser. Once you are happy with the TOC and have set appropriate file level semantics (which fills in the Nav landmarks info). You should be good to go for epub3. If you want to create an epub3 that is more backwards compatible with older epub2 ereaders, there is an Epub3 Tools menu on Sigil that will create an equivalent toc.ncx and fill in the opf guide items. There is also an epub3 tool menu to remove the toc.ncx and the opf guide if you do not care about being backwards compatible with epub2 only readers. All of this is explained in the Sigil Users Guide. Hope simething here helps.

04-14-2023, 05:43 AM	#3
Spiral Junior Member Posts: 3 Karma: 10 Join Date: Apr 2023 Device: kindle	Thanks for your reply! It does help me clear some of my confussions. Whay I mean by "bookmarks" is something that is shown by the reader to quickly jump among the parts of the content. I use it by the convention of the Okular reader. My question has been solved by Tools -> Restructure Epub To Sigial Norm.