Bug: splitting pages after using Access Aide

oston · 04-07-2024, 10:37 PM

I think this appears to be a bug in the file renaming process after splitting pages.

If I split pages, after running Access Aide, there are two references in the Guide section of the opf file that were not updated with the renamed file.
They are the links for the TOC reference and Beginning reference.

These are the only two items that do not get updated when html files are renamed after splitting.

Jim

KevinH · 04-08-2024, 12:10 AM

AccessAide use is probably unrelated. I will investigate why the guide section of the opf was not updated by the splitting.

One question, is this by chance an epub3? If so did you use the epub3 tool to generate a NCX and update the guide? If not, please do that. Any existing guide section, and NCX are NOT updated by splitting as under epub3 these are replaced by the NAV and not used.

To force them to sync with the NAV you must use that tool to rebuild the guide and NCX.

On epub2, this would be a bug as both the guide and ncx should be updated.

oston · 04-08-2024, 01:04 AM

Many thanks, Kevin.
Yes this is Epub3, and I never thought to generate the NCX and update the guide.
When I did that the guide was update and problem solved.

Thanks again
Jim

KevinH · 04-08-2024, 08:51 AM

Yes, I typically use Sigil's epub3 tools to remove both the guide and the ncx as epub3's do *NOT* use them.

If, after all editing is done, I decide I want an epub3 that is backwards compatible with an old epub2 only e-reader, then I use the Sigil's epub3 tools to create them as they will then be properly synced with the final Nav.

Luckily the days of older epub2 only e-readers are fast coming to a close.

FWIW, I also run the Sigil epub3 tool to check and update all the OPF manifest properties once just before the final save especially if I add remote resources, javascript, or mathml.

Those are all tools that need to be run by the user only once just before running a final epubcheck and final save.

oston · 04-08-2024, 08:59 AM

Many thanks, Kevin.
I don't have any data about the e-readers used by readers of these books, so for now I will just run those checks and updates as you suggest.
Jim

04-07-2024, 10:37 PM	#1
oston Connoisseur Posts: 78 Karma: 2138296 Join Date: Nov 2016 Device: ipad, Kindle Scribe, Kobo Libra 2	Bug: splitting pages after using Access Aide I think this appears to be a bug in the file renaming process after splitting pages. If I split pages, after running Access Aide, there are two references in the Guide section of the opf file that were not updated with the renamed file. They are the links for the TOC reference and Beginning reference. These are the only two items that do not get updated when html files are renamed after splitting. Jim

Similar Threads
Thread	Thread Starter	Forum	Replies	Last Post
[Plugin] Access-Aide - help improve epub accessibility	KevinH	Plugins	147	10-15-2024 11:25 AM
[Editor Plugins] Access Aide	wolf123	Plugins	5	07-08-2023 02:10 PM
access-aide failure	oston	Sigil	5	06-27-2023 04:42 PM
Splitting pages gives me an undesired beutification	Iznogood	Editor	5	07-08-2019 09:17 AM
Images splitting over pages	JohnnyParker	Editor	5	06-10-2014 03:36 AM

04-08-2024, 12:10 AM	#2
KevinH Sigil Developer Posts: 8,160 Karma: 5450818 Join Date: Nov 2009 Device: many	AccessAide use is probably unrelated. I will investigate why the guide section of the opf was not updated by the splitting. One question, is this by chance an epub3? If so did you use the epub3 tool to generate a NCX and update the guide? If not, please do that. Any existing guide section, and NCX are NOT updated by splitting as under epub3 these are replaced by the NAV and not used. To force them to sync with the NAV you must use that tool to rebuild the guide and NCX. On epub2, this would be a bug as both the guide and ncx should be updated.

04-08-2024, 01:04 AM	#3
oston Connoisseur Posts: 78 Karma: 2138296 Join Date: Nov 2016 Device: ipad, Kindle Scribe, Kobo Libra 2	Many thanks, Kevin. Yes this is Epub3, and I never thought to generate the NCX and update the guide. When I did that the guide was update and problem solved. Thanks again Jim

04-08-2024, 08:51 AM	#4
KevinH Sigil Developer Posts: 8,160 Karma: 5450818 Join Date: Nov 2009 Device: many	Yes, I typically use Sigil's epub3 tools to remove both the guide and the ncx as epub3's do NOT use them. If, after all editing is done, I decide I want an epub3 that is backwards compatible with an old epub2 only e-reader, then I use the Sigil's epub3 tools to create them as they will then be properly synced with the final Nav. Luckily the days of older epub2 only e-readers are fast coming to a close. FWIW, I also run the Sigil epub3 tool to check and update all the OPF manifest properties once just before the final save especially if I add remote resources, javascript, or mathml. Those are all tools that need to be run by the user only once just before running a final epubcheck and final save.

04-08-2024, 08:59 AM	#5
oston Connoisseur Posts: 78 Karma: 2138296 Join Date: Nov 2016 Device: ipad, Kindle Scribe, Kobo Libra 2	Many thanks, Kevin. I don't have any data about the e-readers used by readers of these books, so for now I will just run those checks and updates as you suggest. Jim