Updates required to the AppData file
@jeff
Submitted by Jeff F.T. Assigned to Alex Băluț @aleb
Description
Email received from Richard Hughes autohughski@gmail.com, I don't have time to do it so maybe you could (and if you have questions, you can probably ping me on IRC as I'm not really looking at the bug mail these days):
I would like you to add some keywords in the pitivi.desktop file or the pitivi.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>
Some of the newest features include a way to make it easy for translators to contribute new translations of your applications by specifying a URL in the pitivi.appdata.xml AppData file that tells them where to start looking. This can be specified by adding:
<url type="translate">
http://the-web-site-with-translation-instructions/</url>
Another useful tag to add is to tell end-users where to donate, for instance:
<url type="donation">
http://www.gnome.org/friends/</url>
Also, by including keywords into either the desktop file or the AppData file you can increase the number of search matches you get in the software center. Adding application-specific keywords like "editor" or "vhdl" means that we can provide better search results for common queries. Keywords are also stemmed, so searching for "edit" will also match "editor" and "edits" so there's no need to add every variant. You can add keywords using:
<keywords>
<keyword>
something</keyword>
<keyword>
anotherthing</keyword>
</keywords>
If it's been some time since you updated the AppData file (and hey, you've got an app to write!) you can get add the latest metadata fields by doing
appstream-util upgrade pitivi.appdata.xml
and then replacing any FIXMEs in the file with actual data. We'll be putting more functionality into the software center in the future that uses this extra data, but we need more upstream software to opt-in before we can enable features, for instance, providing a button for users to donate to specific apps.You can also use
appstream-util validate-relax
on your AppData file to check the various fields meet our style guidelines. If you disagree with any of the validation warnings, please let me know!When you've changed the file(s) and committed, please email me back and I'll mark your application as completed.