Contents | Start | End | Previous: KB0401: Why does EpubCheck give a warning about reading order? | Next: KB0403: Can I add a back cover to a Jutoh project?


KB0402: Why do links to special sections not work in ODT?

If you are generating an ODT file, and have an advanced table of contents with Special table of contents formatting checked, and other special formatting enabled, such as an alphabetical index, you may find that after updating all the fields within LibreOffice, links to the special sections (such as index) do not work.

The problem is that special sections - table of contents, alphabetical index and bibliography - do not provide a bookmark that Jutoh can link to. Or rather they do - via the "text:name" attribute in the special field - but LibreOffice will not recognise this name, despite the name appearing in the Navigator (for example, "index_42" generated by Jutoh). Instead, when manually adding a hyperlink, LibreOffice suggests names such as "Alphabetical Index1" which is the default name supplied for an inserted index. This would appear to be a bug.

A workaround for advanced TOCs is to update the TOC last within LibreOffice, because the TOC will insert bookmarks inside the special section, which will be erased when the section updates itself.

For other links in your book to special sections, you can manually edit each hyperlink in LibreOffice, choosing "Document" in the hyperlink dialog, and selecting the appropriate region, such as "Alphabetical Index1".

Suggestions for better workarounds for this apparent bug are welcome!

Note that when Jutoh replaces a section with a special section field, it moves the first bookmark in the section (if it exists) to the section field, and uses it as the name of the field, such as "index_42" if you specified the bookmark "index". While this can suppress missing bookmark errors during the compile, it still doesn't create working links, as per the discussion above. However, if the only link to a special section is from the advanced TOC, then this may not matter because LibreOffice will create a link when it updates the TOC - so long as the TOC is the last thing updated.


Contents | Start | End | Previous: KB0401: Why does EpubCheck give a warning about reading order? | Next: KB0403: Can I add a back cover to a Jutoh project?