<?xml version="1.0" encoding="utf-8"?>
<!--
  SPDX-License-Identifier: CC-BY-SA-3.0
  SPDX-FileCopyrightText: 2021, 2022, 2023 Philip Withnall <philip@tecnocode.co.uk>
  SPDX-FileCopyrightText: 2021, 2022, 2024 Will Thompson <wjt@endlessos.org>
  SPDX-FileCopyrightText: 2024 Milan Crha <mcrha@redhat.com>
  SPDX-FileCopyrightText: 2024 Sid <sidtosh4@gmail.com>
-->
<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" type="topic" id="software-metadata" xml:lang="eu">

  <info>
    <link type="guide" xref="index"/>

    <credit type="author">
      <name>Philip Withnall</name>
      <email its:translate="no">philip@tecnocode.co.uk</email>
    </credit>
    <credit type="author">
      <name>Will Thompson</name>
      <email its:translate="no">wjt@endlessos.org</email>
    </credit>
    <credit type="author">
      <name>Milan Crha</name>
      <email its:translate="no">mcrha@redhat.com</email>
    </credit>

    <include xmlns="http://www.w3.org/2001/XInclude" href="legal.xml"/>

    <desc><app>Softwareak</app> nola erabiltzen dituen metadatuak</desc>
  </info>

  <title>Software-metadatuak</title>
  <links type="section"/>

  <section id="screenshots">
    <title>Pantaila-argazkiak</title>
    <media type="image" src="figures/app-screenshot.png" style="floatend floatright" mime="image/png" its:translate="no"/>
    <p><app>Softwareak</app> 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.</p>
    <p>Aplikazioaren metainformazio-fitxategian pantaila-argazki bat baino gehiago badago, <app>Softwareak</app> ikuspegi birakari gisa erakutsiko ditu.</p>
    <p>Aplikazioaren metainformazio-fitxategiak ez duenean pantaila-argazkirk, leku-marka gisa funtzionatzen duen ikono bat bistaratuko da, <code>Pantaila-argazkirik ez</code>dioena:</p>
    <media type="image" src="figures/scalable/symbolic/image-missing-symbolic.svg" width="96" mime="image/svg" its:translate="no"/>
    <note>
      <p>Leku-markako ikonoak beste itxura bat izan dezake ikono-gai pertsonalizatua erabiltzen baduzu.</p>
    </note>
    <p>Pantaila-argazkiak zaharkituta geratu daitezke aplikazioak interfazea aldatzen badu. Beraz, <app>Softwareak</app> aplikazio baten pantaila-argazkiak erakutsi arren, beti egiaztatu behar da pantaila-argazki horiek eguneratuta dauden.</p>
    <p>Pantaila-argazkiaren informazioa hobetzeko:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-app-screenshots">Nola gehitu falta diren pantaila-argazkiak</link></p>
      </item>
    </list>
  </section>

  <section id="app-context-bar">
    <title>Aplikazioaren testuinguru-barra</title>
    <p>Aplikazioen testuinguru-barra, <app>Softwarean</app>, aplikazio bakoitzaren xehetasun-orrian erakusten diren lauzen bilduma bat da. Honako xehetasunak erakusten ditu:</p>
    <list>
      <item>
	<p><link xref="#storage">Tamaina</link></p>
      </item>
      <item>
	<p><link xref="#safety">Segurtasuna</link></p>
      </item>
      <item>
	<p><link xref="#hardware-support">Hardware-euskarria</link></p>
      </item>
      <item>
	<p><link xref="#age-rating">Adinaren araberako balorazioa</link></p>
      </item>
    </list>

    <p its:locNote="Translators: Refer https://gitlab.gnome.org/GNOME/gnome-software/-/wikis/Help-Translation-Notes for steps to localize 'figures/app-context-bar.png' image.">Honek <app>Softwarea</app> aplikazioaren testuinguru-barra erakusten du:</p>
    <p><media type="image" src="figures/app-context-bar.png" mime="image/png" its:translate="yes"/></p>


    <p its:locNote="Translators: This text needs to be adjusted for RTL languages as the tiles will be reversed in the UI.">Lauzak goian zerrendatutako ordenan bistaratzen dira (ezkerretik hasita, lehenengo <code>Tamaina</code>).</p>
    <p>Lauza bakoitza xeheago azaltzen da behean.</p>
  </section>

  <section id="storage">
    <title>Tamaina</title>
    <p><app>Softwareak</app> 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.</p>
    <p>Tamainak kalkulatzeko, <app>Softwarea</app> 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.</p>
  </section>

  <section id="safety">
    <title>Segurtasuna</title>
    <p><app>Softwareak</app> segurtasuna erakusten du lauza batean, aplikazioen xehetasunen orrian. Aplikazioa instalatzeko eta exekutatzeko segurua den ala kontuz aritu behar den adierazten da lauza horretan.</p>
    <p>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.</p>
    <p>Lauzan klik egitean agertzen den elkarrizketa-koadroan aplikazioak eskatu dituen baimenak zerrendatzen dira, gehi bere lizentziari eta exekuzio-denborari buruzko informazioa.</p>
    <p>Segurtasun-informazioa hobetzeko:</p>
    <list>
      <item>
	<p><link xref="#how-to-fix-incorrect-safety-and-permissions-information">Nola konpondu segurtasun- eta baimen-informazio okerra</link></p>
      </item>
    </list>
  </section>

  <section id="hardware-support">
    <title>Hardware-euskarria</title>
    <p><app>Softwareak</app> 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.</p>

    <p>Kodeak ondoren adierazitako hardwarea begiratzen du. Etorkizunean informazio gehiago emango da.</p>
    <list>
      <item><p>Ukipen-panel bat, sagu bat edo teklatu bat dagoen edo beharrezkoa den</p></item>
      <item><p>Joko-aginte bat beharrezkoa den</p></item>
      <item><p>Aplikazioaren gutxieneko eta gomendatutako pantaila-tamainak</p></item>
    </list>

    <p>Ezin da joko-aginte bat <em>badagoela</em> modu fidagarrian detektatu, sarritan deskonektatuta uzten baita, normalean ez baita beharrezkoa ordenagailua erabiltzeko.</p>
    <p>Lauzan klik egitean agertzen den elkarrizketa-koadroan aplikazioak dituen hardware-eskakizunak zerrendatzen dira, eta haietako guztiak betetzen diren ala ez.</p>
    <p>Hardware-informazioa hobetzeko:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-hardware-information">Nola gehitu falta den hardware-informazioa</link></p>
      </item>
    </list>
  </section>

  <section id="age-rating">
    <title>Adinaren araberako balorazioa</title>
    <p><app>Softwareak</app> 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.</p>
    <p>Adibidez, joko batek indarkeria duen ala ez nabarmenduko da, edo iragarkiak dituen ala ez.</p>
    <p>Lauzan klik egitean agertzen den elkarrizketa-koadroan aplikazioak dituen eduki mota desberdinak zerrendatzen dira eta zein gogortasun-mailakoak diren.</p>
    <p>Adinaren araberako balorazioa hobetzeko:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-content-rating-information">Nola gehitu adinaren araberako balorazioan falta den informazioa</link></p>
      </item>
    </list>
  </section>

  <section id="license">
    <title>Lizentzia</title>
    <media type="image" src="figures/scalable/license-community-built.svg" style="floatend floatright" mime="image/svg" its:translate="no"/>
    <media type="image" src="figures/scalable/license-proprietary-and-special.svg" style="floatend floatright" mime="image/svg" its:translate="no"/>
    <p><app>Softwareak</app> aplikazio bat <link href="https://eu.wikipedia.org/wiki/Software_libre">software librea</link> 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. <link xref="software-licensing#introduction">Ikasi gehiago</link></p>
    <p>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.</p>
    <p><app>Softwarea</app> aplikazioak lizentzia libre eta kode irekikoak berdez margotzen ditu, jabedunak eta bereziak horiz. Lizentzia ezezagunak grisez nabarmenduta agertzen dira.</p>
    <p>Lizentzia-informazioa hobetzeko:</p>
    <list>
      <item>
	<p><link xref="#how-to-fix-incorrect-licensing-information">Nola konpondu lizentzia-informazio okerra</link></p>
      </item>
    </list>
  </section>

  <section id="links">
    <title>Estekak</title>
    <media type="image" src="figures/scalable/links.svg" style="floatend floatright" mime="image/svg" its:translate="no"/>
    <p><app>Softwareak</app> aplikazioaren baliabideen esteken zerrenda bat erakusten du esteen lauzan. Honakoak dirasof:</p>
    <table>
      <tr>
	<td><p><media type="image" src="figures/scalable/symbolic/webpage-symbolic.svg" mime="image/svg" its:translate="no"/></p></td>
	<td><p>Webgunearen esteka</p></td>
      </tr>
      <tr>
	<td><p><media type="image" src="figures/scalable/symbolic/donate-symbolic.svg" mime="image/svg" its:translate="no"/></p></td>
	<td><p>Diruz laguntzeko esteka</p></td>
      </tr>
      <tr>
	<td><p><media type="image" src="figures/scalable/symbolic/translations-symbolic.svg" mime="image/svg" its:translate="no"/></p></td>
	<td><p>Itzulpenetan laguntzeko esteka</p></td>
      </tr>
      <tr>
	<td><p><media type="image" src="figures/scalable/symbolic/computer-fail-symbolic.svg" mime="image/svg" its:translate="no"/></p></td>
	<td><p>Akatsak jakinarazteko esteka</p></td>
      </tr>
      <tr>
	<td><p><media type="image" src="figures/scalable/symbolic/help-link-symbolic.svg" mime="image/svg" its:translate="no"/></p></td>
	<td><p>Laguntzarako esteka</p></td>
      </tr>
      <tr>
	<td><p><media type="image" src="figures/scalable/symbolic/contact-symbolic.svg" mime="image/svg" its:translate="no"/></p></td>
	<td><p>Harremanetarako esteka</p></td>
      </tr>
    </table>
    <p>Esteka horietako batzuk soilik edo den-denak agertu daitezke, aplikazioaren metainformazio-fitxategian adierazitakoaren arabera.</p>
    <p>Aplikazioaren metainformazio-fitxategiak ez badu inolako estekarik, galdera-ikurra duen lauza bat bistaratuko da.</p>
    <media type="image" src="figures/scalable/no-links.svg" style="floatend floatright" mime="image/svg" its:translate="no"/>
    <p>Estekak hobetzeko:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-links">Nola gehitu falta diren estekak</link></p>
      </item>
    </list>
  </section>

  <section id="carousel-tile">
    <title>Ikuspegi birakariaren izenburua</title>
    <media type="image" src="figures/carousel.png" style="floatend floatright" mime="image/png" its:translate="no"/>
    <p>Applications which are featured by <app>Software</app> 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.</p>
    <p>Nabarmenduta ageri diren aplikazioen multzoa Linux banaketa bakoitzaren garatzaileek erabakitzen dute.</p>
    <p>Ikuspegi birakariaren lauza hobetzeko:</p>
    <list>
      <item>
	<p><link xref="#how-to-set-the-carousel-tile-background-colour">Nola ezarri ikuspegi birakariaren lauzaren atzeko planoa</link></p>
      </item>
    </list>
  </section>

  <section id="where-metadata-comes-from">
    <title>Metadatuak nondik datozen</title>
    <p>Software batek zein harware behar duen, zein adinetarako den egokia, eta zein segurua den zehazteko erabiltzen diren metadatuak software horren metainformazio-fitxategian daude.</p>
    <p>Metainformazioa XML fitxategi bat da. Bere fitxategi-formatua <link href="https://www.freedesktop.org/software/appstream/docs/">AppStream espezifikazioan</link> dago zehaztuta.</p>
    <p>Ikusi <link href="https://gitlab.gnome.org/GNOME/nautilus/-/blob/main/data/org.gnome.Nautilus.metainfo.xml.in.in">GNOME Fitxategiak aplikazioaren metainformazio-fitxategia</link>.</p>
    <note style="tip">
      <p>Lehen <em>metainfo</em> elementuari <em>appdata</em> esaten zitzaion.</p>
    </note>
  </section>

  <section id="what-happens-if-metadata-is-missing">
    <title>Zer gertatzen da metadatuak falta badira</title>
    <p>Aplikazio batek ez baditu metadatuetako batzuk, <app>Softwareak</app> horiek asmatzen saiatu daiteke, baina ezin izango du informazio askorik eman bere interfazeetan. <app>Softwareak</app> ulertuko du software gehiena mahaigaineko ordenagailuetarako sortu dela.</p>
    <p><em style="strong">Aplikazio baten metadatuak hobetzen lagundu dezakezu.</em></p>
  </section>

  <section id="how-to-contribute-missing-information">
    <title>Nola lagundu falta den informazioa osatzen</title>
    <p>Aplikazio baten orrian informazioa falta dela edo informazioa okerra dela ikusten baduzu, honela lagundu dezakezu:</p>
    <list type="numbered">
      <item>
	<p>Falta den edo okerra den metadatua aplikazioak akatsak jakinarazteko duen aztarnarian argitaratu dezakezu, garatzaileak hutsunea konpondu dezan.</p>
      </item>
      <item>
	<p>Falta den edo okerra den metadatua zuk zeuk konpondu dezakezu. Ikusi <em style="strong">Nola egin</em> gida hori nola egiten den ikasteko.</p>
      </item>
    </list>

    <p>Bi kasuetan, lehenengo aplikazioaren proiektu-orria aurkitu behar duzu. Proiektu-orriaren esteka normalean aplikazioaren orrian agertuko da, <link xref="#links">hemen erakusten den moduan</link>. Ez badago, bilatzaile baten bidez bilatu beharko duzu interneten.</p>

    <p>Aplikazioak normalean <link href="https://gitlab.com/explore?sort=stars_desc">GitLab</link> edo <link href="https://github.com/explore">GitHub</link> gune batean daude. Adibidez, GNOMEren aplikazioak <link href="https://gitlab.gnome.org/GNOME?sort=stars_desc">gitlab.gnome.org</link> gunean daude.</p>
  </section>

  <section id="how-to-add-missing-app-screenshots">
    <title>Nola gehitu falta diren pantaila-argazkiak</title>
    <p>Aplikazioen pantaila-argazkiak <link href="https://www.freedesktop.org/software/appstream/docs/sect-Metadata-Application.html#tag-dapp-screenshots"><code>&lt;screenshots&gt;</code></link> elementuan gordetzen dira, aplikazioaren metainformazio-fitxategiko <code>&lt;component&gt;</code> osagaian.</p>
    <p>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.</p>
    <p>Adibidez, hona hemen <app>Softwarea</app> aplikazioaren beraren pantaila-argazkiak:</p>
    <code its:translate="no" mime="application/xml"><![CDATA[
<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>]]></code>
</section>

  <section id="how-to-fix-incorrect-safety-and-permissions-information">
    <title>Nola konpondu segurtasun- eta baimen-informazio okerra</title>
    <p>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.</p>
    <p>For flatpak applications, the information comes from the application’s <link href="https://docs.flatpak.org/en/latest/manifests.html">flatpak manifest</link>, 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 <app>Software</app> — moving it from ‘safe’ to ‘potentially unsafe’ to ‘unsafe’.</p>
    <p>In order to improve the safety level of an application, its sandboxing must be made as tight as possible, by removing <link href="https://docs.flatpak.org/en/latest/sandbox-permissions.html">sandbox permissions</link> where they’re not needed, and using <link href="https://docs.flatpak.org/en/latest/desktop-integration.html#portals">portals</link> instead of sandbox permissions where possible. Use of portals does not lower the displayed safety level of an application in <app>Software</app>.</p>
    <p>For example, if the application requests read/write access to the full file system (<code>--filesystem=host</code>), does it actually need that, or does it only need to access files in a few specific locations? If so, the <link href="https://docs.flatpak.org/en/latest/desktop-integration.html#portals">file portal</link> could be used, or more specific <link href="https://docs.flatpak.org/en/latest/sandbox-permissions.html#filesystem-access">file system permissions</link> could be specified.</p>
    <p>Aplikazioak Wayland ingurunean funtzionatzen badu eta X11 solik arazoak daudenean behar badu, eta X11 eginbide bereziak behar ez baditu, <code>--socket=fallback-x11</code> erabili al dezake, <code>--socket=x11</code> erabili ordez?</p>
    <p>Baimen bereziei edo beste paketatze-formatu batzuei buruzko gidalerroak eman daitezke hemen etorkizunean.</p>
    <p>Informazio gehiago:</p>
    <list>
      <item>
	<p><link href="https://docs.flatpak.org/en/latest/sandbox-permissions.html"/></p>
      </item>
      <item>
	<p><link href="https://docs.flatpak.org/en/latest/manifests.html"/></p>
      </item>
      <item>
	<p><link href="https://docs.flatpak.org/en/latest/desktop-integration.html#portals"/></p>
      </item>
    </list>
  </section>

  <section id="how-to-add-missing-hardware-information">
    <title>Nola gehitu falta den harware-informazioa</title>
    <p>The hardware information for an application is stored in the <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-relations"><code>&lt;requires&gt;</code>, <code>&lt;recommends&gt;</code> and <code>&lt;supports&gt;</code></link> elements within the application’s <code>&lt;component&gt;</code> in its metainfo file.</p>
    <p><app>Software</app> understands the <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-relations-control"><code>&lt;control&gt;</code></link> and <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-relations-display_length"><code>&lt;display_length&gt;</code></link> elements.</p>
    <p>See <link href="https://tecnocode.co.uk/2021/07/12/add-metadata-to-your-app-to-say-what-inputs-and-display-sizes-it-supports/">this blog post</link> or <link href="https://blogs.gnome.org/tbernard/2021/09/07/ready-for-software-41/#device-support">this blog post</link> for examples of metadata.</p>
  </section>

  <section id="how-to-add-missing-content-rating-information">
    <title>Nola gehitu eduki-balorazioari buruz falta den informazioa</title>
    <p>The content rating information for an application is stored in the <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-content_rating"><code>&lt;content_rating&gt;</code></link> element within the application’s <code>&lt;component&gt;</code> in its metainfo file.</p>
    <p>Applications should use the OARS 1.1 standard to fill in this element. If the <code>&lt;content_rating&gt;</code> 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.</p>
    <p>Erabili <link href="https://hughsie.github.io/oars/">OARS sortzailea</link> aplikazioaren balorazio-informazio egokia sortzeko.</p>
  </section>

  <section id="how-to-fix-incorrect-licensing-information">
    <title>Nola konpondu lizentzia-informazio okerra</title>
    <p>Aplikazioen lizentzia-informazioa <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-project_license"><code>&lt;project_license&gt;</code></link> elementuan gordetzen da, aplikazioaren metainformazio-fitxategiko <code>&lt;component&gt;</code> elementuan.</p>
    <p>The content in this element should be an <link href="https://spdx.org/specifications">SPDX expression</link> 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.</p>
    <p>If the SPDX expression is a single license, or an ‘or’ combination of multiple licenses, which are all <link href="https://spdx.org/licenses/">FSF or OSI approved</link>, the application is considered ‘free software’ and the license tile says so. Otherwise, it’s considered ‘proprietary’.</p>
    <p>If an application is being displayed as ‘proprietary’ when you think it shouldn’t be, it’s likely that the <code>&lt;project_license&gt;</code> element includes the documentation license for the project. Remove it.</p>
    <p><link href="https://gitlab.gnome.org/GNOME/meld/-/issues/579">Adibidez</link>, aldatu hemengo lizentzia-metadatuak:</p>
    <code its:translate="no" mime="application/xml"><![CDATA[<project_license>GPL-2.0+ and CC-BY-SA-3.0</project_license>]]></code>
    <p>-</p>
    <code its:translate="no" mime="application/xml"><![CDATA[<project_license>GPL-2.0+</project_license>]]></code>
    <p>Informazio gehiago:</p>
    <list>
      <item>
	<p><link href="https://tecnocode.co.uk/2021/07/05/dont-generally-put-cc-by-sa-in-appdata/">Ez jarri (orokorrean) dokumentazioaren lizentzia appdata-n</link></p>
      </item>
      <item>
	<p><link href="https://github.com/ximion/appstream/issues/312"/></p>
      </item>
    </list>
  </section>

  <section id="how-to-add-missing-links">
    <title>Nola gehitu falta diren estekak</title>
    <p>Aplikazioen estekak <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-url"><code>&lt;url&gt;</code></link> elementuan gordetzen da, aplikazioaren metainformazio-fitxategiko <code>&lt;component&gt;</code> elementuan.</p>
    <p>Add as many of the link types documented in the <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-url">appstream specification</link> as are available for the application. If no suitable page exists for a given link type, it doesn’t have to be included.</p>
    <p>Adibidez, hona hemen <app>Softwarea</app> aplikazioaren baliabide-estekak:</p>
    <code its:translate="no" mime="application/xml"><![CDATA[
<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>]]></code>
  </section>

  <section id="how-to-set-the-carousel-tile-background-colour">
    <title>Nola ezarri ikuspegi birakariaren lauzaren atzeko planoaren kolorea</title>
    <p>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 <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-branding">appstream’s <code>&lt;branding/&gt;</code> element</link> with declared colors (since 47.x series). The advantage is that more clients can use the colors.</p>
    <p>Adibidez, hona hemen marka ezartzeko sarrera batzuk:</p>
    <code its:translate="no" mime="application/xml"><![CDATA[
<branding>
  <color type="primary" scheme_preference="light">#ff00ff</color>
  <color type="primary" scheme_preference="dark">#993d3d</color>
</branding>]]></code>
    <note>
      <p>Ikusi nola <code>scheme_preference</code> atributuari ez ikusiarena egiten zaiola, <app>Softwarea</app> aplikazioak berak aukeratzen du gairako kolorerik onena.</p>
    </note>
    <p>There is left, for backward compatibility, the possibility to add the following XML to the application’s metainfo <code>&lt;component&gt;</code> element:</p>
    <code its:translate="no" mime="application/xml"><![CDATA[
<custom>
  <value key="GnomeSoftware::key-colors">[(124, 53, 77), (99, 16, 0)]</value>
</custom>]]></code>
    <p>baina <code>&lt;branding/&gt;</code> elementuak lehentasuna du.</p>
    <p>The value of <code>GnomeSoftware::key-colors</code> is a text-format GVariant with type <code>a(yyy)</code>, and represents an unordered set of key colors for the application. Each element of the set is a color in RGB form ranging from <code>(0, 0, 0)</code> to <code>(255, 255, 255)</code>.</p>
    <p>Koloreak hautatzeko, kontuan izan:</p>
    <list>
      <item>
	<p>Aplikazioa ongi identifikatzen dutela eta aplikazioaren markarekin bat datozela, posible bada.</p>
      </item>
      <item>
	<p>Aplikazioaren ikonoaren ertzarekin kontraste egokia duela, haren atzeko plano gisa erabiltzen denean ikonoa ongi bereiztu dadin.</p>
      </item>
      <item>
	<p>Adwaita gaiaren aurreko planoko testuen kolorearekin (<code>#2e3436</code>) kontraste egokia duela, baita aldaera ilunean ere (<code>#eeeeec</code>). Horrek esan nahi du oro har argitasun-maila ertaina duen kolore bat aukeratu behar dela.</p>
      </item>
      <item>
	<p>Kontrastea egiaztatzeko, erabili <link href="https://flathub.org/apps/org.gnome.design.Contrast/">Kontrastea izeneko aplikazioa</link>.</p>
      </item>
    </list>
    <p>At least one color should be specified. More can be specified if one color can’t satisfy all the requirements above, and <app>Software</app> 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.</p>
  </section>

  <section id="how-to-test-carousel-tile-background-colour-changes">
    <title>Nola probatu ikuspegi birakariaren lauzaren atzeko planoaren kolore-aldaketak</title>
    <p>Aldatu zure aplikazioaren metainformazio-fitxategia eta, ondoren, exekutatu <app>Softwarea</app> aplikazioa honela:</p>
    <p><cmd>gnome-software --show-metainfo=<var>/path/to/app.metainfo.xml</var>,icon=<var>/path/to/app/icon.png</var></cmd></p>
    <p>Zure aplikazioaren xehetasun-orria erakutsiko da. <app>Softwareko</app> ikuspegi orokorreko orrira itzultzen bazara, zure aplikazioa ikuspegi birakariko aplikazio 'nabarmendu' bakarra izango da.</p>
  </section>


</page>
