Bug: splitting pages after using Access Aide

oston · 04-07-2024, 09: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-07-2024, 11:10 PM

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, 12: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, 07: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, 07: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, 09:37 PM	#1
oston Enthusiast Posts: 44 Karma: 2137668 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	116	12-21-2023 02:10 PM
[Editor Plugins] Access Aide	wolf123	Plugins	5	07-08-2023 01:10 PM
access-aide failure	oston	Sigil	5	06-27-2023 03:42 PM
Splitting pages gives me an undesired beutification	Iznogood	Editor	5	07-08-2019 08:17 AM
Images splitting over pages	JohnnyParker	Editor	5	06-10-2014 02:36 AM

04-07-2024, 11:10 PM	#2
KevinH Sigil Developer Posts: 7,661 Karma: 5433388 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, 12:04 AM	#3
oston Enthusiast Posts: 44 Karma: 2137668 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, 07:51 AM	#4
KevinH Sigil Developer Posts: 7,661 Karma: 5433388 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, 07:59 AM	#5
oston Enthusiast Posts: 44 Karma: 2137668 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