Localization of appstream metainfo files

Ole Streicher <[email protected]> Wed, 13 Nov 2024 10:53:23 +0100
Newsgroups gmane.linux.debian.devel.desktop
Message-ID <[email protected]>
Hi,

I am looking to "somehow" generate useful appstream metainfo files for 
my desktop applications; the one I am working on is saods9. Taking the 
info from 
https://appstream.debian.org/data/sid/main/Components-amd64.yml.gz and 
converting the relevant section to XML gives me a file like

<?xml version="1.0" encoding="utf-8"?>
<component type="desktop-application">
...
   <description><p>...</p>...</description>
   <description xml:lang="da"><p>...</p>...</description>
   ...
</component>

When trying to validate this with appstreamcli, I get errors like

E: edu.si.ds9:37: metainfo-localized-description-tag description

so I decided to look up the documentation on 
https://freedesktop.org/software/appstream/docs/chap-Validation.html:

metainfo-localized-description-tag
     Severity: error
     A <description/> tag must not be localized in metainfo files
     (upstream metadata). Localize the individual paragraphs instead.

catalog-localized-description-section
     Severity: error
     This element (paragraph, list, etc.) of a <description/> tag must
     not be localized individually in catalog metadata. Localize the
     whole <description/> tag instead. (...)

which sounds a bit contradictionary? So, shall one localize individual 
paragraphs or the whole section? What is the correct way?

Please Cc the answer to me as I am not subscribed.

Best

Ole