Skip to content
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

Keywords required for the (Gnome) software center #1175

Closed
Ablu opened this issue Jan 10, 2016 · 2 comments
Closed

Keywords required for the (Gnome) software center #1175

Ablu opened this issue Jan 10, 2016 · 2 comments

Comments

@Ablu
Copy link
Contributor

Ablu commented Jan 10, 2016

I got an automatic mail from Richard Hughes about missing keywords in the .desktop file.

I can add the keywords, just adding it here because I would probably forget about it...


So, what do I want you to do? Basically, I would like you to add some keywords in the tiled.desktop
file or the tiled.appdata.xml AppData file. If you want the keywords to be used by GNOME Shell as
well (which you probably do), the best place to put any search terms is in the keywords section [1] of
the desktop file. This can also be marked as translatable so non-English users can search in their
own language. This would looks something like Keywords=3D;printer; (remember the trailing
semicolon!)

The alternative is to put the keywords in the AppData file so that they are only used by the software
center and not the desktop shell. You can of course combine putting keywords in both places. The
AppData keywords can also be translated, and would look like this:

<keywords>
<keyword>3D</keyword>
<keyword>printer</keyword>
</keywords>

Of course, you don't have to do a release with this fix straight away, and if you have a stable branch it would be a good thing to backport this as well if it does not add translated strings or you have no string freeze policy. Nothing bad will happen if you ignore this email, but please be aware that matches from keywords are ordered higher in the search results than other partial matches from the name or summary. You also don't have to add keywords that are the same as the application name or package name, as these are automatically added as case insensitive search tokens.

When you've changed the file(s) and committed, please email me back and I'll mark your application as completed. If you don't want to hear from me ever again just edit the <update_contact> in the AppData file and change it to somebody else. I'm not planning on emailing more than once every 6 months, so don't worry about me spamming you with even more work to do. If you don't add the keywords then your application will still be visible in the various software centers, but it may be harder to find.

Thanks,

Richard

[1] http://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html#recognized-keys

@Ablu
Copy link
Contributor Author

Ablu commented Jan 10, 2016

If you have suggestions for keywords you can drop them here. Then I will add them :)

@bjorn
Copy link
Member

bjorn commented Jan 10, 2016

Hmm, the docs for Keywords say "A list of strings which may be used in addition to other metadata to describe this entry. This can be useful e.g. to facilitate searching through entries. The values are not meant for display, and should not be redundant with the values of Name or GenericName."

Since he has "3D" as example, at least we could add "2D".

Ablu pushed a commit to Ablu/tiled that referenced this issue Sep 25, 2016
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants