Philip Withnall
philip@tecnocode.co.uk
Will Thompson
wjt@endlessos.org
Milan Crha
mcrha@redhat.com
Πώς το Software χρησιμοποιεί μεταδεδομένα

# Μεταδεδομένα Λογισμικού

# Στιγμιότυπα Οθόνης

Software displays the screenshots on the details page for an application. This typically should include screenshots of various windows / dialogs of the application, so the user would get a quick grasp of the application’s features, look and feel etc.

When more than one screenshot is present in the application’s metainfo file, Software will show the screenshots in a carousel.

In cases when the application’s metainfo file doesn’t contain any screenshot, then a placeholder icon as below with `No Screenshots` will be displayed:

Το εικονίδιο placeholder μπορεί να φαίνεται διαφορετικό αν χρησιμοποιείτε ένα προσαρμοσμένο θέμα εικονιδίων.

Screenshots might become outdated as the application’s UI changes. So, even if Software shows screenshots for an app, it’s important to check if these screenshots are up-to-date or outdated.

Μπορείτε να βελτιώσετε τις πληροφορίες στιγμιοτύπων οθόνης της εφαρμογής:

Πώς να προσθέσετε λείποντα στιγμιότυπα οθόνης εφαρμογής

# Γραμμή πλαισίου εφαρμογής

Η γραμμή πλαισίου εφαρμογής στο Software είναι μια συλλογή πλακιδίων στη σελίδα λεπτομερειών μιας εφαρμογής, που εμφανίζουν τις ακόλουθες λεπτομέρειες.

Αποθηκευτικός χώρος

Ασφάλεια

Υποστήριξη υλικού

Βαθμολογία ηλικίας

Αυτό δείχνει τη γραμμή πλαισίου εφαρμογής για την εφαρμογή Software:

Τα πλακίδια εμφανίζονται με τη σειρά που αναφέρεται παραπάνω (ξεκινώντας από το πλακίδιο `Αποθηκευτικός χώρος` στα αριστερά).

Κάθε πλακίδιο καλύπτεται λεπτομερώς παρακάτω.

# Αποθηκευτικός χώρος

Το Software εμφανίζει ένα πλακίδιο αποθηκευτικού χώρου στη σελίδα λεπτομερειών μιας εφαρμογής. Αν η εφαρμογή δεν είναι εγκατεστημένη, αυτό εμφανίζει το εκτιμώμενο μέγεθος λήψης που απαιτείται για την εγκατάστασή της. Αν η εφαρμογή είναι εγκατεστημένη, εμφανίζει τον αποθηκευτικό χώρο που χρησιμοποιεί η εφαρμογή.

The sizes are calculated from data provided by the Software backend (such as flatpak or an RPM), and are not specified in the metadata provided by the application. There is nothing you can do to affect this tile by editing an application’s metainfo file. It’s listed here for completeness.

# Ασφάλεια

Το Software εμφανίζει ένα πλακίδιο ασφάλειας στη σελίδα λεπτομερειών μιας εφαρμογής. Αυτό συνοψίζει πληροφορίες σχετικά με το αν η εφαρμογή μπορεί να θεωρηθεί ασφαλής για εγκατάσταση και εκτέλεση, ή αν μπορεί να απαιτείται προσοχή πριν την εμπιστευτείτε.

Αυτό το πλακίδιο συνδυάζει πληροφορίες σχετικά με τα δικαιώματα που ζητά η εφαρμογή όπου εκτελείται (όπως δικαίωμα ανάγνωσης των αρχείων σας), με πληροφορίες σχετικά με το πώς αναπτύχθηκε η εφαρμογή. Οι εφαρμογές ελεύθερου λογισμικού, όπου ο πηγαίος κώδικας είναι δημόσια διαβαστός, μπορεί να είναι πιο ασφαλείς από τις ιδιόκτητες, καθώς μπορούν να ελεγχθούν.

Ο διάλογος που εμφανίζεται όταν γίνεται κλικ στο πλακίδιο παραθέτει τα διάφορα δικαιώματα που ζητά η εφαρμογή, καθώς και κάποιες πληροφορίες σχετικά με την άδειά της και το περιβάλλον εκτέλεσης.

Μπορείτε να βελτιώσετε τις πληροφορίες ασφάλειας:

Πώς να διορθώσετε εσφαλμένες πληροφορίες ασφάλειας και δικαιωμάτων

# Υποστήριξη υλικού

Το Software εμφανίζει ένα πλακίδιο υποστήριξης υλικού στη σελίδα λεπτομερειών μιας εφαρμογής. Αυτό συνδυάζει πληροφορίες σχετικά με τις απαιτήσεις υλικού της εφαρμογής και τις δυνατότητες υλικού του υπολογιστή, με στόχο να επισημάνει ασυμβατότητες ή λείπουσες απαιτήσεις — ή να υποδείξει ότι η εφαρμογή θα πρέπει να λειτουργεί σωστά χωρίς ασυμβατότητες.

Ο κώδικας εξετάζει το ακόλουθο υλικό. Περισσότερα μπορεί να υποστηριχθούν στο μέλλον.

Εάν υπάρχει/απαιτείται touchpad, ποντίκι ή πληκτρολόγιο

Εάν απαιτείται gamepad

Το ελάχιστο και προτεινόμενο μέγεθος οθόνης στο οποίο μπορεί να κλιμακωθεί η εφαρμογή

It’s not possible to reliably detect whether a gamepad is present, as they are often left disconnected due to not being needed for normal computer use.

Ο διάλογος που εμφανίζεται όταν γίνεται κλικ στο πλακίδιο παραθέτει τις διάφορες απαιτήσεις υλικού της εφαρμογής και εάν κάποιες από αυτές δεν ικανοποιούνται.

Μπορείτε να βελτιώσετε τις πληροφορίες υλικού:

Πώς να προσθέσετε λείπουσες πληροφορίες υλικού

# Βαθμολογία ηλικίας

Το Software εμφανίζει ένα πλακίδιο βαθμολογίας ηλικίας στη σελίδα λεπτομερειών μιας εφαρμογής. Αυτό δείχνει για ποιο εύρος ηλικιών θα πρέπει να είναι κατάλληλη η εφαρμογή, με βάση διαφορετικά είδη περιεχομένου που η εφαρμογή έχει δηλώσει ότι περιέχει. Αυτές οι πληροφορίες συνοψίζονται σε μια μορφή παρόμοια με τα πιστοποιητικά βαθμολογίας παιχνιδιών ή ταινιών για τη χώρα σας.

Για παράδειγμα, αυτό θα επισημάνει εάν ένα παιχνίδι περιέχει βία, ή εάν μια εφαρμογή περιέχει διαφημίσεις εντός εφαρμογής.

Ο διάλογος που εμφανίζεται όταν γίνεται κλικ στο πλακίδιο παραθέτει τα διάφορα είδη περιεχομένου στην εφαρμογή και πόσο σοβαρό είναι αυτό το περιεχόμενο.

Μπορείτε να βελτιώσετε τις πληροφορίες βαθμολογίας ηλικίας:

Πώς να προσθέσετε λείπουσες πληροφορίες βαθμολογίας περιεχομένου

# Άδεια

Software displays a tile indicating whether an application is free software or whether its license is proprietary, special or unknown. This tile includes more detailed information about the project’s license. This tile also lists some of the benefits of free software. Learn more

Sometimes the license information isn’t correct for an application, and hence an application which is actually free software will be shown as ‘proprietary’. Similarly, sometimes the license information is unknown.

Το Software επισημαίνει τις ελεύθερες και ανοιχτού κώδικα αδειες με πράσινο, τις ιδιόκτητες και ειδικές άδειες με κίτρινο όπως φαίνεται εδώ. Οι άγνωστες άδειες επισημαίνονται με γκρι.

Μπορείτε να προσθέσετε ή να βελτιώσετε τις πληροφορίες άδειας:

Πώς να διορθώσετε εσφαλμένες πληροφορίες άδειας

# Σύνδεσμοι

Το Software εμφανίζει μια λίστα συνδέσμων πόρων εφαρμογής στο πλακίδιο συνδέσμων. Είναι οι ακόλουθοι:

| Σύνδεσμος ιστοτόπου
| Σύνδεσμος δωρεάς
| Σύνδεσμος συνεισφοράς μετάφρασης
| Σύνδεσμος αναφοράς σφαλμάτων
| Σύνδεσμος βοήθειας
| Σύνδεσμος επικοινωνίας

Some or all of these links may be present depending on whether they are listed in the application’s metainfo file.

In cases when the application’s metainfo file doesn’t contain any link, the following tile with a question mark will be displayed.

Μπορείτε να βελτιώσετε τους συνδέσμους:

Πώς να προσθέσετε λείποντες συνδέσμους

# Πλακίδιο καρουσελ

Applications which are featured by Software are displayed in a carousel at the top of the main window as shown here. Each carousel tile has a background color which is automatically extracted from the application’s icon. Sometimes this background color is not quite right for the application and needs to be specified explicitly by the application developer.

Το σύνολο των εφαρμογών που προβάλλονται αποφασίζεται από τους διατηρητές της διανομής Linux.

Μπορείτε να βελτιώσετε το πλακίδιο καρουσελ:

Πώς να ορίσετε το χρώμα φόντου του πλακιδίου καρουσελ

# Από πού προέρχονται τα μεταδεδομένα

Τα μεταδεδομένα που χρησιμοποιούνται για τον καθορισμό του υλικού που απαιτεί ένα λογισμικό, για ποιες ηλικίες χρηστών είναι κατάλληλο και παράγοντες που συμβάλλουν στο πόσο ασφαλές μπορεί να είναι η εγκατάστασή του, προέρχονται όλα από το αρχείο metainfo για αυτό το λογισμικό.

Το αρχείο metainfo είναι ένα αρχείο XML. Η μορφή αρχείου του καθορίζεται στην προδιαγραφή AppStream.

Δείτε το αρχείο metainfo για την εφαρμογή GNOME Files.

appdata είναι ο παλαιότερος όρος για metainfo.

# Τι συμβαίνει αν λείπουν μεταδεδομένα

If some metadata is missing for an application, Software can only guess what it might be, and hence can’t present much information in its interfaces. The guesses Software makes are based on the fact that most software is designed for desktop computers.

Μπορείτε να βοηθήσετε να βελτιωθούν τα μεταδεδομένα μιας εφαρμογής!

# Πώς να συνεισφέρετε λείπουσες πληροφορίες

If you find that an app’s page is missing information or has incorrect information, you can contribute in one of the two ways:

You can report the missing / incorrect metadata to the respective app’s bug tracker, so the app developer can fix it.

Μπορείτε να διορθώσετε τα λείποντα / εσφαλμένα μεταδεδομένα μόνοι σας. Δείτε τον οδηγό Πώς να παρακάτω για το πώς να το κάνετε αυτό.

For both, you first need to find the app’s project page. The link to the project page should typically be available in the app’s page as shown here. If not, you will need to find it with a simple search on Google.

Οι εφαρμογές φιλοξενούνται συνήθως στο GitLab ή στο GitHub. Για παράδειγμα, οι εφαρμογές GNOME φιλοξενούνται στο gitlab.gnome.org.

# Πώς να προσθέσετε λείποντα στιγμιότυπα οθόνης εφαρμογής

The screenshot information for an application is stored in the `<screenshots>` element within the application’s `<component>` in its metainfo file.

Ο συνιστώμενος αριθμός στιγμιοτύπων οθόνης για μια εφαρμογή είναι μεταξύ 5 και 10. Τα στιγμιότυπα οθόνης θα πρέπει ιδανικά να είναι σε μορφή PNG με αναλογία διαστάσεων 16:9 και ελάχιστο πλάτος 620 pixel.

Για παράδειγμα, εδώ είναι οι καταχωρήσεις στιγμιοτύπων οθόνης για την εφαρμογή Software:

<screenshots> <screenshot type="default"> <image>https://gitlab.gnome.org/GNOME/gnome-software/raw/HEAD/data/metainfo/ss-overview.png</image> <caption>Overview panel</caption> </screenshot> <screenshot> <image>https://gitlab.gnome.org/GNOME/gnome-software/raw/HEAD/data/metainfo/ss-details.png</image> <caption>Details panel</caption> </screenshot> </screenshots>

# Πώς να διορθώσετε εσφαλμένες πληροφορίες ασφάλειας και δικαιωμάτων

Οι πληροφορίες ασφάλειας και δικαιωμάτων για μια εφαρμογή προέρχονται από διαφορετικές πηγές ανάλογα με το πώς συσκευάζεται η εφαρμογή. Για παραδοσιακά συσκευασμένες εφαρμογές, για παράδειγμα σε μορφή RPM ή DEB, δεν υπάρχουν διαθέσιμες πληροφορίες ασφάλειας ή δικαιωμάτων και δεν μπορεί να γίνει τίποτα για να προστεθούν σε μια εφαρμογή.

For flatpak applications, the information comes from the application’s flatpak manifest, specifying what holes in the sandbox the application requires. Each of these holes typically contributes to lowering the displayed safety level of the application in Software — moving it from ‘safe’ to ‘potentially unsafe’ to ‘unsafe’.

In order to improve the safety level of an application, its sandboxing must be made as tight as possible, by removing sandbox permissions where they’re not needed, and using portals instead of sandbox permissions where possible. Use of portals does not lower the displayed safety level of an application in Software.

Για παράδειγμα, αν η εφαρμογή ζητά πρόσβαση ανάγνωσης/εγγραφής σε ολόκληρο το σύστημα αρχείων (`--filesystem=host`), χρειάζεται πραγματικά αυτό, ή χρειάζεται μόνο πρόσβαση σε αρχεία σε μερικές συγκεκριμένες τοποθεσίες; Αν ναι, θα μπορούσε να χρησιμοποιηθεί το file portal, ή θα μπορούσαν να καθοριστούν πιο συγκεκριμένα δικαιώματα συστήματος αρχείων.

Αν η εφαρμογή λειτουργεί στο Wayland, και χρειάζεται να λειτουργεί στο X11 μόνο ως εφεδρική λύση, χωρίς να χρησιμοποιεί ειδικές λειτουργίες X11, θα μπορούσε να χρησιμοποιήσει `--socket=fallback-x11` αντί για `--socket=x11`;

Οδηγίες σχετικά με συγκεκριμένα δικαιώματα, ή άλλες μορφές συσκευασίας, μπορεί να προστεθούν εδώ στο μέλλον.

Περαιτέρω ανάγνωση:

# Πώς να προσθέσετε λείπουσες πληροφορίες υλικού

The hardware information for an application is stored in the `<requires>`, `<recommends>` and `<supports>` elements within the application’s `<component>` in its metainfo file.

Το Software κατανοεί τα στοιχεία `<control>` και `<display_length>`.

Δείτε αυτή την ανάρτηση ιστολογίου ή αυτή την ανάρτηση ιστολογίου για παραδείγματα μεταδεδομένων.

# Πώς να προσθέσετε λείπουσες πληροφορίες βαθμολογίας περιεχομένου

The content rating information for an application is stored in the `<content_rating>` element within the application’s `<component>` in its metainfo file.

Applications should use the OARS 1.1 standard to fill in this element. If the `<content_rating>` element is not specified, the application’s content rating is unknown. If it’s specified but empty, the application has no content which might be unsuitable for any audience.

Χρησιμοποιήστε τον δημιουργό OARS για να παράγετε κατάλληλες πληροφορίες βαθμολογίας περιεχομένου για μια εφαρμογή.

# Πώς να διορθώσετε εσφαλμένες πληροφορίες άδειας

The licensing information for an application is stored in the `<project_license>` element within the application’s `<component>` in its metainfo file.

The content in this element should be an SPDX expression which describes the ‘main’ license for the project. This should typically be the license of the code, and not include the license of the documentation or ancillary content.

If the SPDX expression is a single license, or an ‘or’ combination of multiple licenses, which are all FSF or OSI approved, the application is considered ‘free software’ and the license tile says so. Otherwise, it’s considered ‘proprietary’.

If an application is being displayed as ‘proprietary’ when you think it shouldn’t be, it’s likely that the `<project_license>` element includes the documentation license for the project. Remove it.

Για παράδειγμα, αλλάξτε τα μεταδεδομένα άδειας από:

<project_license>GPL-2.0+ and CC-BY-SA-3.0</project_license>

σε

<project_license>GPL-2.0+</project_license>

Περαιτέρω ανάγνωση:

Don’t (generally) put documentation license in appdata

# Πώς να προσθέσετε λείποντες συνδέσμους

The links for an application are stored as `<url>` elements within the application’s `<component>` in its metainfo file.

Add as many of the link types documented in the appstream specification as are available for the application. If no suitable page exists for a given link type, it doesn’t have to be included.

Για παράδειγμα, εδώ είναι οι σύνδεσμοι πόρων για την εφαρμογή Software:

<url type="bugtracker">https://gitlab.gnome.org/GNOME/gnome-software/-/issues</url> <url type="contact">https://discourse.gnome.org/tag/gnome-software</url> <url type="contribute">https://welcome.gnome.org/app/Software/</url> <url type="donation">https://www.gnome.org/donate/</url> <url type="homepage">https://apps.gnome.org/Software</url> <url type="translate">https://l10n.gnome.org/module/gnome-software/</url> <url type="vcs-browser">https://gitlab.gnome.org/GNOME/gnome-software/</url>

# Πώς να ορίσετε το χρώμα φόντου του πλακιδίου καρουσελ

The carousel tile background color is normally extracted automatically from the application’s icon. If that color is unsatisfactory, however, it can be overridden by using the appstream’s `<branding/>` element with declared colors (since 47.x series). The advantage is that more clients can use the colors.

Για παράδειγμα, εδώ είναι μερικές καταχωρήσεις branding:

<branding> <color type="primary" scheme_preference="light">#ff00ff</color> <color type="primary" scheme_preference="dark">#993d3d</color> </branding>

Σημειώστε ότι το χαρακτηριστικό `scheme_preference` αγνοείται, το Software επιλέγει το καλύτερο χρώμα για το θέμα μόνο του.

There is left, for backward compatibility, the possibility to add the following XML to the application’s metainfo `<component>` element:

<custom> <value key="GnomeSoftware::key-colors">[(124, 53, 77), (99, 16, 0)]</value> </custom>

αλλά το στοιχείο `<branding/>` έχει προτεραιότητα.

Η τιμή του `GnomeSoftware::key-colors` είναι ένα GVariant σε μορφή κειμένου με τύπο `a(yyy)`, και αντιπροσωπεύει ένα μη διατεταγμένο σύνολο βασικών χρωμάτων για την εφαρμογή. Κάθε στοιχείο του συνόλου είναι ένα χρώμα σε μορφή RGB που κυμαίνεται από `(0, 0, 0)` έως `(255, 255, 255)`.

Τα χρώματα πρέπει να επιλέγονται έτσι ώστε:

Are identifiable to the application, matching the application’s branding in some way, if possible.

Contrast with the edge of the application’s icon, so that when they are used as a background behind it, the icon can be distinguished.

Να έχουν αντίθεση με το χρώμα κειμένου προσκηνίου στο θέμα Adwaita (`#2e3436`) και στη σκούρα παραλλαγή του (`#eeeeec`). Αυτό γενικά σημαίνει επιλογή ενός χρώματος με μέσο επίπεδο φωτεινότητας.

Η αντίθεση μπορεί να ελεγχθεί χρησιμοποιώντας την εφαρμογή Contrast.

At least one color should be specified. More can be specified if one color can’t satisfy all the requirements above, and Software will choose the most appropriate to use in the carousel tile. If exactly one color is specified, its brightness and saturation may be modified to improve contrast with the foreground color. If more than one color is specified, the one with the best contrast with the foreground color will be chosen, and its brightness and saturation will not be modified.

# Πώς να δοκιμάσετε αλλαγές χρώματος φόντου πλακιδίου καρουσελ

Τροποποιήστε το αρχείο metainfo για την εφαρμογή σας, και στη συνέχεια εκτελέστε το Software με:

gnome-software --show-metainfo=/διαδρομή/προς/app.metainfo.xml,icon=/διαδρομή/προς/app/icon.png

The details page for your application will be shown. If you navigate back to the overview page of Software, your application will be the only one in the ‘featured’ carousel.