Philip Withnall
philip@tecnocode.co.uk
Will Thompson
wjt@endlessos.org
Milan Crha
mcrha@redhat.com
Softwareak
nola erabiltzen dituen metadatuak

# Software-metadatuak

# Pantaila-argazkiak

Softwareak aplikazioen xehetasun-orrietan erakusten ditu pantaila-argazkiak. Gehienetan aplikazioaren leiho eta elkarrizketa-koadroen pantaila-argazkiak dira, erabiltzaileak aplikazioaren eginbideen, itxuraren eta beste antzeko kontu batzuen ikuspegi azkarra eduki dezan.

Aplikazioaren metainformazio-fitxategian pantaila-argazki bat baino gehiago badago, Softwareak ikuspegi birakari gisa erakutsiko ditu.

Aplikazioaren metainformazio-fitxategiak ez duenean pantaila-argazkirk, leku-marka gisa funtzionatzen duen ikono bat bistaratuko da, `Pantaila-argazkirik ez`dioena:

Leku-markako ikonoak beste itxura bat izan dezake ikono-gai pertsonalizatua erabiltzen baduzu.

Pantaila-argazkiak zaharkituta geratu daitezke aplikazioak interfazea aldatzen badu. Beraz, Softwareak aplikazio baten pantaila-argazkiak erakutsi arren, beti egiaztatu behar da pantaila-argazki horiek eguneratuta dauden.

Pantaila-argazkiaren informazioa hobetzeko:

Nola gehitu falta diren pantaila-argazkiak

# Aplikazioaren testuinguru-barra

Aplikazioen testuinguru-barra, Softwarean, aplikazio bakoitzaren xehetasun-orrian erakusten diren lauzen bilduma bat da. Honako xehetasunak erakusten ditu:

Tamaina

Segurtasuna

Hardware-euskarria

Adinaren araberako balorazioa

Honek Softwarea aplikazioaren testuinguru-barra erakusten du:

Lauzak goian zerrendatutako ordenan bistaratzen dira (ezkerretik hasita, lehenengo `Tamaina`).

Lauza bakoitza xeheago azaltzen da behean.

# Tamaina

Softwareak tamaina erakusten du lauza batean, aplikazioen xehetasunen orrian. Aplikazioa ez badago instalatuta, hura instalatzeko gutxi gorabehera zein tamainako fitxategia deskargatu behar den erakusten du. Aplikazioa instalatuta badago, hurak erabiltzen duen biltegiratze-espazioa erakusten du.

Tamainak kalkulatzeko, Softwarea aplikazioaren motorrak (adibidez flatpak edo RPM) ematen dituen datuak erabiltzeko dira, eta ez daude zehaztuta aplikazioak eskainitako metadatuetan. Ezin da ezer egin lauza hori moldatzeko, ezta aplikazioaren metainformazio-fitxategia aldatu ere.

# Segurtasuna

Softwareak segurtasuna erakusten du lauza batean, aplikazioen xehetasunen orrian. Aplikazioa instalatzeko eta exekutatzeko segurua den ala kontuz aritu behar den adierazten da lauza horretan.

Lauza horrek aplikazioak exekutatzeko eskatzen dituen baimenei buruzko informazioa ematen da (adibidez, fitxategiak irakurtzeko baimena). Horrez gain, aplikazioa nola garatu den ere adierazten da. Software libreko aplikazioak, iturburu-kodea irakurgarria izanik, jabedun aplikazioak baino seguruagoak izan daitezke.

Lauzan klik egitean agertzen den elkarrizketa-koadroan aplikazioak eskatu dituen baimenak zerrendatzen dira, gehi bere lizentziari eta exekuzio-denborari buruzko informazioa.

Segurtasun-informazioa hobetzeko:

Nola konpondu segurtasun- eta baimen-informazio okerra

# Hardware-euskarria

Softwareak hardware-euskarriaren informazioa erakusten du lauza batean, aplikazioen xehetasunen orrian. Aplikazioak dituen hardware-eskakizunei buruzko informazioa eta ordenagailuaren hardware-kapazitateei buruzkoa ematen da bertan, horrela bateraezintasunak edo falta diren eskakizunak nabarmen geratu daitezen - edo aplikazioak bateraezintasunik gabe eta ongi funtzionatuko duela adierazteko.

Kodeak ondoren adierazitako hardwarea begiratzen du. Etorkizunean informazio gehiago emango da.

Ukipen-panel bat, sagu bat edo teklatu bat dagoen edo beharrezkoa den

Joko-aginte bat beharrezkoa den

Aplikazioaren gutxieneko eta gomendatutako pantaila-tamainak

Ezin da joko-aginte bat badagoela modu fidagarrian detektatu, sarritan deskonektatuta uzten baita, normalean ez baita beharrezkoa ordenagailua erabiltzeko.

Lauzan klik egitean agertzen den elkarrizketa-koadroan aplikazioak dituen hardware-eskakizunak zerrendatzen dira, eta haietako guztiak betetzen diren ala ez.

Hardware-informazioa hobetzeko:

Nola gehitu falta den hardware-informazioa

# Adinaren araberako balorazioa

Softwareak adinaren araberako balorazioaren informazioa erakusten du lauza batean, aplikazioen xehetasunen orrian. Aplikazioa zein adinetarako den egokia adierazten du horrek, aplikazioak berak daukala adierazi duen edukiaren arabera. Informazio hori zure herrialdean jokoak edo filmak baloratzeko erabiltzen den modu berean ematen da.

Adibidez, joko batek indarkeria duen ala ez nabarmenduko da, edo iragarkiak dituen ala ez.

Lauzan klik egitean agertzen den elkarrizketa-koadroan aplikazioak dituen eduki mota desberdinak zerrendatzen dira eta zein gogortasun-mailakoak diren.

Adinaren araberako balorazioa hobetzeko:

Nola gehitu adinaren araberako balorazioan falta den informazioa

# Lizentzia

Softwareak aplikazio bat software librea den ala jabeduna, berezia edo ezezaguna den adierazten duen izenburu bat erakusten du. Izenburu horrek proiektuaren lizentziari buruzko informazio xehea eskaintzen du. Software librearen onuretako batzuk ere zerrendatzen ditu. Ikasi gehiago

Batzuetan lizentziaren informazioa ez da zuzena aplikazio baterako, eta software librea den aplikazioa bat jabedun gisa agertzen da. Beste batzuetan, gerta daiteke lizentziaren informazioa ezezaguna izatea.

Softwarea aplikazioak lizentzia libre eta kode irekikoak berdez margotzen ditu, jabedunak eta bereziak horiz. Lizentzia ezezagunak grisez nabarmenduta agertzen dira.

Lizentzia-informazioa hobetzeko:

Nola konpondu lizentzia-informazio okerra

# Estekak

Softwareak aplikazioaren baliabideen esteken zerrenda bat erakusten du esteen lauzan. Honakoak dirasof:

| Webgunearen esteka
| Diruz laguntzeko esteka
| Itzulpenetan laguntzeko esteka
| Akatsak jakinarazteko esteka
| Laguntzarako esteka
| Harremanetarako esteka

Esteka horietako batzuk soilik edo den-denak agertu daitezke, aplikazioaren metainformazio-fitxategian adierazitakoaren arabera.

Aplikazioaren metainformazio-fitxategiak ez badu inolako estekarik, galdera-ikurra duen lauza bat bistaratuko da.

Estekak hobetzeko:

Nola gehitu falta diren estekak

# Ikuspegi birakariaren izenburua

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.

Nabarmenduta ageri diren aplikazioen multzoa Linux banaketa bakoitzaren garatzaileek erabakitzen dute.

Ikuspegi birakariaren lauza hobetzeko:

Nola ezarri ikuspegi birakariaren lauzaren atzeko planoa

# Metadatuak nondik datozen

Software batek zein harware behar duen, zein adinetarako den egokia, eta zein segurua den zehazteko erabiltzen diren metadatuak software horren metainformazio-fitxategian daude.

Metainformazioa XML fitxategi bat da. Bere fitxategi-formatua AppStream espezifikazioan dago zehaztuta.

Ikusi GNOME Fitxategiak aplikazioaren metainformazio-fitxategia.

Lehen metainfo elementuari appdata esaten zitzaion.

# Zer gertatzen da metadatuak falta badira

Aplikazio batek ez baditu metadatuetako batzuk, Softwareak horiek asmatzen saiatu daiteke, baina ezin izango du informazio askorik eman bere interfazeetan. Softwareak ulertuko du software gehiena mahaigaineko ordenagailuetarako sortu dela.

Aplikazio baten metadatuak hobetzen lagundu dezakezu.

# Nola lagundu falta den informazioa osatzen

Aplikazio baten orrian informazioa falta dela edo informazioa okerra dela ikusten baduzu, honela lagundu dezakezu:

Falta den edo okerra den metadatua aplikazioak akatsak jakinarazteko duen aztarnarian argitaratu dezakezu, garatzaileak hutsunea konpondu dezan.

Falta den edo okerra den metadatua zuk zeuk konpondu dezakezu. Ikusi Nola egin gida hori nola egiten den ikasteko.

Bi kasuetan, lehenengo aplikazioaren proiektu-orria aurkitu behar duzu. Proiektu-orriaren esteka normalean aplikazioaren orrian agertuko da, hemen erakusten den moduan. Ez badago, bilatzaile baten bidez bilatu beharko duzu interneten.

Aplikazioak normalean GitLab edo GitHub gune batean daude. Adibidez, GNOMEren aplikazioak gitlab.gnome.org gunean daude.

# Nola gehitu falta diren pantaila-argazkiak

Aplikazioen pantaila-argazkiak `<screenshots>` elementuan gordetzen dira, aplikazioaren metainformazio-fitxategiko `<component>` osagaian.

Aplikazioek 5 eta 10 pantaila-argazki artean eduki ditzaten gomendatzen dugu. Hobe da PNG formatua erabiltzea, 16:9 aspektu-erlazioa eta gutxienez 620 pixeleko zabalera.

Adibidez, hona hemen Softwarea aplikazioaren beraren pantaila-argazkiak:

<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>

# Nola konpondu segurtasun- eta baimen-informazio okerra

The safety and permissions information for an application comes from different sources depending on how the application is packaged. For traditionally packaged applications, for example in RPM or DEB format, there is no safety or permissions information available and nothing can be done to add it to an application.

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.

For example, if the application requests read/write access to the full file system (`--filesystem=host`), does it actually need that, or does it only need to access files in a few specific locations? If so, the file portal could be used, or more specific file system permissions could be specified.

Aplikazioak Wayland ingurunean funtzionatzen badu eta X11 solik arazoak daudenean behar badu, eta X11 eginbide bereziak behar ez baditu, `--socket=fallback-x11` erabili al dezake, `--socket=x11` erabili ordez?

Baimen bereziei edo beste paketatze-formatu batzuei buruzko gidalerroak eman daitezke hemen etorkizunean.

Informazio gehiago:

# Nola gehitu falta den harware-informazioa

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 understands the `<control>` and `<display_length>` elements.

See this blog post or this blog post for examples of metadata.

# Nola gehitu eduki-balorazioari buruz falta den informazioa

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.

Erabili OARS sortzailea aplikazioaren balorazio-informazio egokia sortzeko.

# Nola konpondu lizentzia-informazio okerra

Aplikazioen lizentzia-informazioa `<project_license>` elementuan gordetzen da, aplikazioaren metainformazio-fitxategiko `<component>` elementuan.

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.

Adibidez, aldatu hemengo lizentzia-metadatuak:

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

-

<project_license>GPL-2.0+</project_license>

Informazio gehiago:

Ez jarri (orokorrean) dokumentazioaren lizentzia appdata-n

# Nola gehitu falta diren estekak

Aplikazioen estekak `<url>` elementuan gordetzen da, aplikazioaren metainformazio-fitxategiko `<component>` elementuan.

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.

Adibidez, hona hemen Softwarea aplikazioaren baliabide-estekak:

<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>

# Nola ezarri ikuspegi birakariaren lauzaren atzeko planoaren kolorea

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.

Adibidez, hona hemen marka ezartzeko sarrera batzuk:

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

Ikusi nola `scheme_preference` atributuari ez ikusiarena egiten zaiola, Softwarea aplikazioak berak aukeratzen du gairako kolorerik onena.

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>

baina `<branding/>` elementuak lehentasuna du.

The value of `GnomeSoftware::key-colors` is a text-format GVariant with type `a(yyy)`, and represents an unordered set of key colors for the application. Each element of the set is a color in RGB form ranging from `(0, 0, 0)` to `(255, 255, 255)`.

Koloreak hautatzeko, kontuan izan:

Aplikazioa ongi identifikatzen dutela eta aplikazioaren markarekin bat datozela, posible bada.

Aplikazioaren ikonoaren ertzarekin kontraste egokia duela, haren atzeko plano gisa erabiltzen denean ikonoa ongi bereiztu dadin.

Adwaita gaiaren aurreko planoko testuen kolorearekin (`#2e3436`) kontraste egokia duela, baita aldaera ilunean ere (`#eeeeec`). Horrek esan nahi du oro har argitasun-maila ertaina duen kolore bat aukeratu behar dela.

Kontrastea egiaztatzeko, erabili Kontrastea izeneko aplikazioa.

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.

# Nola probatu ikuspegi birakariaren lauzaren atzeko planoaren kolore-aldaketak

Aldatu zure aplikazioaren metainformazio-fitxategia eta, ondoren, exekutatu Softwarea aplikazioa honela:

gnome-software --show-metainfo=/path/to/app.metainfo.xml,icon=/path/to/app/icon.png

Zure aplikazioaren xehetasun-orria erakutsiko da. Softwareko ikuspegi orokorreko orrira itzultzen bazara, zure aplikazioa ikuspegi birakariko aplikazio 'nabarmendu' bakarra izango da.