EPUB version of manual 4.4 seems "broken"
I tried to read https://docs.darktable.org/usermanual/4.4/en/darktable_user_manual.epub with atril but only get this:
`/tmp/atril-41186/darktable_user_manual_de-4.4.epub2D8461/OEBPS/toc.ncx:10: parser error : Opening and ending tag mismatch: meta line 5 and head
^ /tmp/atril-41186/darktable_user_manual_de-4.4.epub2D8461/OEBPS/toc.ncx:2125: parser error : Opening and ending tag mismatch: head line 4 and ncx ^ /tmp/atril-41186/darktable_user_manual_de-4.4.epub2D8461/OEBPS/toc.ncx:2126: parser error : Premature end of data in tag ncx line 2^
[5] + 41186 segmentation fault atril darktable_user_manual_de-4.4.epub `
Okluar shows it but with these errors:
`TOC:10: parser error : Opening and ending tag mismatch: meta line 5 and head
^ libepub (EE): failed to parse toc no toc found Error: no block found for "overview/user-interface/map.html" Error: no block found for "special-topics/module-reference.html" Error: no block found for "overview/user-interface/tethering.html" Error: no block found for "overview/workflow/lighttable.html" Error: no block found for "module-reference/utility-modules/print/print.html" Error: no block found for "special-topics/preferences-settings.html" Error: no block found for "module-reference/utility-modules/shared/map.html" Error: no block found for "module-reference/utility-modules/lighttable/lua.html" Error: no block found for "darktable_user_manual.epub" Error: no block found for "special-topics/midi-device-support.html#additional-midi-configuration" Error: no block found for "preferences-settings/tethering.html" Error: no block found for "module-reference/processing-modules/dithering.md" Error: no block found for "module-reference/processing-modules/dithering.md" Error: no block found for "module-reference/utility-modules/lighttable/tethering.html" Error: no block found for "print/lighttable.html" Error: no block found for "module-reference/utility-modules/shared/lighttable.html" Error: no block found for "special-topics/memory.md" Error: no block found for "special-topics/memory.md" Error: no block found for "overview/user-interface/slideshow.html" Error: no block found for "overview/user-interface/lighttable.html" Error: no block found for "preferences-settings/slideshow.html" Error: no block found for "module-reference/processing-modules/lighttable.html" Error: no block found for "tethering/lighttable.html" Error: no block found for "overview/workflow/darkroom.html" Error: no block found for "overview/user-interface/preferences-settings.html" Error: no block found for "module-reference/utility-modules/shared/collection-filters.html#color-label" Error: no block found for "overview/user-interface/print.html" Error: no block found for "overview/user-interface/darkroom.html" Error: no block found for "darktable_user_manual.pdf" Error: no block found for "darkroom/lighttable.html"`
epubcheck shows many errors (and a lot of warnings (not shown here) too):
`epubcheck darktable_user_manual_en-4.4.epub 2>& 1 | grep -E "^(FATAL|ERROR)"
ERROR(RSC-005): darktable_user_manual_en-4.4.epub/OEBPS/content.opf(23,44): Error while parsing file: character content of element "meta" invalid; must be a string with length at least 1 (actual length was 0) ERROR(RSC-005): darktable_user_manual_en-4.4.epub/OEBPS/toc.ncx(6,53): Error while parsing file: element "meta" not allowed here; expected the element end-tag ERROR(RSC-005): darktable_user_manual_en-4.4.epub/OEBPS/toc.ncx(7,46): Error while parsing file: element "meta" not allowed here; expected the element end-tag ERROR(RSC-005): darktable_user_manual_en-4.4.epub/OEBPS/toc.ncx(8,55): Error while parsing file: element "meta" not allowed here; expected the element end-tag ERROR(RSC-005): darktable_user_manual_en-4.4.epub/OEBPS/toc.ncx(9,54): Error while parsing file: element "meta" not allowed here; expected the element end-tag FATAL(RSC-016): darktable_user_manual_en-4.4.epub/OEBPS/toc.ncx(10,5): Fatal Error while parsing file: The element type "meta" must be terminated by the matching end-tag "". ERROR(RSC-005): darktable_user_manual_en-4.4.epub/OEBPS/toc.ncx(-1,-1): Error while parsing file: The element type "meta" must be terminated by the matching end-tag "". ERROR(RSC-005): darktable_user_manual_en-4.4.epub/OEBPS/toc.xhtml(6,10): Error while parsing file: element "title" not allowed here; expected the element end-tag ERROR(RSC-005): darktable_user_manual_en-4.4.epub/OEBPS/toc.xhtml(11,59): Error while parsing file: element "link" not allowed here; expected the element end-tag FATAL(RSC-016): darktable_user_manual_en-4.4.epub/OEBPS/toc.xhtml(13,4): Fatal Error while parsing file: The element type "meta" must be terminated by the matching end-tag "". ERROR(RSC-005): darktable_user_manual_en-4.4.epub/OEBPS/toc.xhtml(-1,-1): Error while parsing file: The element type "meta" must be terminated by the matching end-tag "". ERROR(RSC-005): darktable_user_manual_en-4.4.epub/OEBPS/index.html(10,59): Error while parsing file: element "link" not allowed here; expected the element end-tag FATAL(RSC-016): darktable_user_manual_en-4.4.epub/OEBPS/index.html(12,3): Fatal Error while parsing file: The element type "meta" must be terminated by the matching end-tag "". ERROR(RSC-005): darktable_user_manual_en-4.4.epub/OEBPS/index.html(-1,-1): Error while parsing file: The element type "meta" must be terminated by the matching end-tag "". ERROR(RSC-005): darktable_user_manual_en-4.4.epub/OEBPS/front-cover.html(3,30): Error while parsing file: value of attribute "xml:lang" is invalid; must be an RFC 3066 language identifier or must be equal to "" ERROR(RSC-005): darktable_user_manual_en-4.4.epub/OEBPS/front-cover.html(4,11): Error while parsing file: element "body" not allowed yet; missing required element "head" ERROR(CSS-008): darktable_user_manual_en-4.4.epub/OEBPS/style.css(146,3): An error occurred while parsing the CSS: Token "@top-left-corner" not allowed here, expecting a property name. ERROR(CSS-008): darktable_user_manual_en-4.4.epub/OEBPS/style.css(165,22): An error occurred while parsing the CSS: Token "}" not allowed here. ERROR(CSS-008): darktable_user_manual_en-4.4.epub/OEBPS/style.css(212,3): An error occurred while parsing the CSS: Token "@top-left-corner" not allowed here, expecting a property name. ERROR(CSS-008): darktable_user_manual_en-4.4.epub/OEBPS/style.css(231,20): An error occurred while parsing the CSS: Token "}" not allowed here. FATAL(RSC-016): darktable_user_manual_en-4.4.epub/OEBPS/module-reference/utility-modules/shared/metadata-editor.html(25,129): Fatal Error while parsing file: Attribute name "unchanged" associated with an element type "leave" must be followed by the ' = ' character. ERROR(RSC-005): darktable_user_manual_en-4.4.epub/OEBPS/module-reference/utility-modules/shared/metadata-editor.html(-1,-1): Error while parsing file: Attribute name "unchanged" associated with an element type "leave" must be followed by the ' = ' character. ERROR(RSC-008): darktable_user_manual_en-4.4.epub/OEBPS/style.css(137,5): Referenced resource "OEBPS/darktable-logo.svg" is not declared in the OPF manifest. ERROR(RSC-007): darktable_user_manual_en-4.4.epub/OEBPS/lighttable/digital-asset-management/thumbnails.html(31,343): Referenced resource "special-topics/memory.md" could not be found in the EPUB. ERROR(RSC-007): darktable_user_manual_en-4.4.epub/OEBPS/lighttable/digital-asset-management/thumbnails.html(52,267): Referenced resource "special-topics/memory.md" could not be found in the EPUB. ERROR(RSC-007): darktable_user_manual_en-4.4.epub/OEBPS/module-reference/processing-modules/vignetting.html(49,398): Referenced resource "OEBPS/module-reference/processing-modules/dithering.md" could not be found in the EPUB. ERROR(RSC-012): darktable_user_manual_en-4.4.epub/OEBPS/module-reference/utility-modules/shared/collection-filters.html(29,96): Fragment identifier is not defined. ERROR(RSC-012): darktable_user_manual_en-4.4.epub/OEBPS/preferences-settings/miscellaneous.html(42,386): Fragment identifier is not defined. `
I think the converter fo r the EPUB format seems not to be very "pedantic"?
This issue has not had any activity in the past 60 days and will be closed in 365 days if not updated.
I can't replicate this issue. Is it still a problem?
Yes but at another place: atril: /tmp/atril-8414/darktable_user_manual.epub0XZQO2/OEBPS/toc.ncx:10: parser error : Opening and ending tag mismatch: meta line 5 and head
^ /tmp/atril-8414/darktable_user_manual.epub0XZQO2/OEBPS/toc.ncx:2245: parser error : Opening and ending tag mismatch: head line 4 and ncx ^ /tmp/atril-8414/darktable_user_manual.epub0XZQO2/OEBPS/toc.ncx:2246: parser error : Premature end of data in tag ncx line 2^ [1] 8414 segmentation fault atril darktable_user_manual.epub
okular: ... TOC:10: parser error : Opening and ending tag mismatch: meta line 5 and head
^ libepub (EE): failed to parse toc no toc foundepubcheck: Validating using EPUB version 3.2 rules. ERROR(RSC-005): darktable_user_manual.epub/OEBPS/content.opf(23,44): Error while parsing file: character content of element "meta" invalid; must be a string with length at least 1 (actual length was 0) WARNING(HTM-014a): darktable_user_manual.epub/OEBPS/content.opf(237,81): XHTML Content Document file name "OEBPS/index.html" should have the extension ".xhtml". WARNING(HTM-014a): darktable_user_manual.epub/OEBPS/content.opf(239,88): XHTML Content Document file name "OEBPS/front-cover.html" should have the extension ".xhtml". ....
This issue has not had any activity in the past 60 days and will be closed in 365 days if not updated.