darktable-org / dtdocs

darktable user manual
GNU General Public License v3.0
74 stars 74 forks source link

EPUB version of manual 4.4 seems "broken" #577

Open diefau opened 1 year ago

diefau commented 1 year ago

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"?

github-actions[bot] commented 1 year ago

This issue has not had any activity in the past 60 days and will be closed in 365 days if not updated.

paperdigits commented 5 months ago

I can't replicate this issue. Is it still a problem?

diefau commented 5 months ago

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 found

epubcheck: 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". ....

github-actions[bot] commented 3 months ago

This issue has not had any activity in the past 60 days and will be closed in 365 days if not updated.