Skip to content

AppStream metadata fixes #391

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 4 commits into
base: master
Choose a base branch
from
Open

AppStream metadata fixes #391

wants to merge 4 commits into from

Conversation

suve
Copy link
Contributor

@suve suve commented Feb 5, 2025

This PR makes the following changes to the AppStream metadata file:

  1. Removes the xml:lang="en" attribute from description paragraph. While the AppStream specification doesn't really say anything about this1, it seems that appstreamcli treats translated descriptions as overrides, and expects the existence of a default description without a language marker.

  2. Adds the <launchable> tag to inform consumers how to launch the application2.

  3. Changes the ID to com.linuxmint.timeshift (and renames the file accordingly), as AppStream IDs are expected to follow a reverse-DNS {tld}.{vendor}.{product} scheme3.

Footnotes

  1. https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-description

  2. https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-launchable

  3. https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-id-generic

suve added 4 commits February 5, 2025 12:12
appstreamcli seems to require the existence of a description without
a 'xml:lang' attribute. This makes sense if you think about the
"lang-less" description as the default one, and the translated ones
as overrides.
The AppStream metadata spec states that the description "should be
translated by-paragraph". Looking at other metainfo files, it seems
that most treat this as meaning "translations should immediately
follow the non-translated paragraph".
This tag informs AppStream consumers how to launch the application.
AppStream IDs are recommended to follow an reverse-DNS scheme.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Development

Successfully merging this pull request may close these issues.

1 participant