https://bugs.kde.org/show_bug.cgi?id=439708
Bug ID: 439708
Summary: Sphinx incompatibility between Scripty i18n and
binary-factory builder (image and alt text not
translating correctly)
Product: krita
Version: git master (please specify the git hash!)
Platform: Other
OS: Other
Status: REPORTED
Severity: normal
Priority: NOR
Component: Documentation
Assignee: krita-bugs-n...@kde.org
Reporter: al...@alvinhc.com
Target Milestone: ---
I noticed an incompatibility with the Sphinx i18n process for `docs.krita.org`.
At the moment, the Binary Factory build is running Sphinx 4.0.x, but it appears
that Scripty is building the POT templates using a Sphinx version before 4.
In the Sphinx changelog for release 4.0.0
(https://www.sphinx-doc.org/en/master/changes.html#id18), these changes are
listed:
- #7784: i18n: The msgid for alt text of image is changed
- #7784: i18n: The alt text for image is translated by default (without
gettext_additional_targets setting)
The first change is breaking because it means the POT templates generated by
Sphinx <4 now contains image alt text in a format that does not get used by
Sphinx 4. This can be observed on the page https://docs.krita.org/ca/404.html
(check the `alt` attribute from HTML source or dev tools) -
https://invent.kde.org/documentation/docs-krita-org/-/blob/krita/4.3/locale/ca/LC_MESSAGES/404.po#L31
However, switching the POT generation to Sphinx 4 has its issues. It seems to
be outputting message entries for everything in `rst_epilog` into every single
POT files, instead of only in the files that uses them. I have opened an
upstream issue for this: https://github.com/sphinx-doc/sphinx/issues/9428
What would be the best course of action? I don't think we should downgrade
Sphinx on the builder (as there had been some HTML output changes), but
upgrading it for Scripty also poses some issues.
--
You are receiving this mail because:
You are watching all bug changes.
