[kde] [Bug 474198] New: "check-tp-kde" from pology detects some false positive errors for reStructuredText markup

[Josep Ma. Ferrer]

https://bugs.kde.org/show_bug.cgi?id=474198

            Bug ID: 474198
           Summary: "check-tp-kde" from pology detects some false positive
                    errors for reStructuredText markup
    Classification: I don't know
           Product: kde
           Version: unspecified
          Platform: Other
                OS: Linux
            Status: REPORTED
          Severity: normal
          Priority: NOR
         Component: general
          Assignee: unassigned-bugs at kde.org
          Reporter: txemaq at saragata.net
  Target Milestone: ---

SUMMARY
***
"posieve check-tp-kde" command from pology detects some false positive errors
for reStructuredText markup.

Example:
$ cd kde-trunk-kf5/l10n-kf5/ca/messages/documentation-docs-kdenlive-org/
$ posieve check-tp-kde .
docs_kdenlive_org_effects_and_compositions___video_effects___blur_and_sharpen___contrast_adaptive_sharpen.po:70(#9)[msgstr:34:"<plane>"]:
KDE4 markup: unrecognized tag 'plane'.
docs_kdenlive_org_effects_and_compositions___video_effects___blur_and_sharpen___contrast_adaptive_sharpen.po:70(#9)[msgstr:175]:
KDE4 markup: mismatched tag.
[...]

Message #9 (line 70) in this file reads:

msgid ""
"**Planes** - Set the :term:`plane` the effect is to be applied to. Options "
"are: **Alpha**, **Y** (default), **U**, **V**, **Red**, **Green**, **Blue** "
"and **All**."

And the translated message is:

msgstr ""
"**Plans**: Establiu el :term:`pla <plane>` al qual s'aplicarà l'efecte. Les "
"opcions són: **Alfa**, **Y** (predeterminat), **U**, **V**, **Red**, "
"**Green**, **Blue** i **All**."

The problem is on the translation of "plane" to Catalan. We translate "plane"
as "pla", but we need to add the English term to match the reStructuredText
markup. 
So, the English text :term:`plane` becomes Catalan text :term:`pla <plane>`.
This is valid Sphinx/reStructuredText syntax to set custom link text for
cross-reference links, instead of using the normal title of the referenced page
or section: 
https://www.sphinx-doc.org/en/master/usage/restructuredtext/roles.html#ref-role

But "posieve check-tp-kde" thinks that "<plane>" is an invalid KDE4 markup, and
throws the above errors.

This issue happens in other languages (sl-Slovenian, at least).

So, it's necessary to modify the pololgy/posieve/check-tp-kde code to avoid
this false positive error.
***


STEPS TO REPRODUCE
1. Download a directory with po files with this especial reStructuredText
markup. For example:
https://websvn.kde.org/trunk/l10n-kf5/ca/messages/documentation-docs-kdenlive-org/
2. Download and install pology from: https://invent.kde.org/sdk/pology
3. Run the pology command: 
$ posieve check-tp-kde .

OBSERVED RESULT
docs_kdenlive_org_effects_and_compositions___video_effects___blur_and_sharpen___contrast_adaptive_sharpen.po:70(#9)[msgstr:34:"<plane>"]:
KDE4 markup: unrecognized tag 'plane'.
docs_kdenlive_org_effects_and_compositions___video_effects___blur_and_sharpen___contrast_adaptive_sharpen.po:70(#9)[msgstr:175]:
KDE4 markup: mismatched tag.
[...and many more...]

EXPECTED RESULT
(not a single message)

SOFTWARE/OS VERSIONS (not relevant)
Windows: 
macOS: 
Linux/KDE Plasma: Debian GNU/Linux 12
(available in About System)
KDE Plasma Version: 5.27.5
KDE Frameworks Version: 5.103.0
Qt Version: 5.15.8

ADDITIONAL INFORMATION

-- 
You are receiving this mail because:
You are the assignee for the bug.