<?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="ca">

  <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>Com utilitza el <app>Programari</app> les metadades</desc>
  </info>

  <title>Metadades del Programari</title>
  <links type="section"/>

  <section id="screenshots">
    <title>Captures de pantalla</title>
    <media type="image" src="figures/app-screenshot.png" style="floatend floatright" mime="image/png" its:translate="no"/>
    <p>El <app>Programari</app> mostra les captures de pantalla a la pàgina de detalls d'una aplicació. Això normalment hauria d'incloure captures de pantalla de diverses finestres i diàlegs de l'aplicació, de manera que l'usuari tingui una comprensió ràpida de les característiques de l'aplicació, l'aspecte i el comportament, etc.</p>
    <p>Quan hi hagi més d'una captura de pantalla al fitxer metainfo de l'aplicació, el <app>Programari</app> mostrarà les captures de pantalla en un carrusel.</p>
    <p>En els casos en què el fitxer metainfo de l'aplicació no contingui cap captura de pantalla, es mostrarà una icona de marcador de posició com el següent amb el missatge <code>Sense captures de pantalla</code>:</p>
    <media type="image" src="figures/scalable/symbolic/image-missing-symbolic.svg" width="96" mime="image/svg" its:translate="no"/>
    <note>
      <p>La icona de marcador de posició podria ser diferent si utilitzeu un tema d'icones personalitzat.</p>
    </note>
    <p>Les captures de pantalla poden quedar obsoletes a mesura que canvia la interfície d'usuari de l'aplicació. Per tant, fins i tot si el <app>Programari</app> mostra captures de pantalla per a una aplicació, és important comprovar si aquestes captures de pantalla estan actualitzades o obsoletes.</p>
    <p>Podeu millorar la informació de les captures de pantalla de l'aplicació:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-app-screenshots">Com afegir captures de pantalla de l'aplicació que falten</link></p>
      </item>
    </list>
  </section>

  <section id="app-context-bar">
    <title>Barra de context de l'aplicació</title>
    <p>La barra de context de l'aplicació <app>Programari</app> és una col·lecció de fitxes a la pàgina de detalls d'una aplicació, que mostra els següents detalls.</p>
    <list>
      <item>
	<p><link xref="#storage">Emmagatzematge</link></p>
      </item>
      <item>
	<p><link xref="#safety">Seguretat</link></p>
      </item>
      <item>
	<p><link xref="#hardware-support">Suport per al maquinari</link></p>
      </item>
      <item>
	<p><link xref="#age-rating">Valoració de l'edat</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.">Això mostra la barra de context de l'aplicació <app>Programari</app>:</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.">Les fitxes es mostren en l'ordre que s'indica a dalt (començant amb <code>Emmagatzematge</code> fitxa a l'esquerra).</p>
    <p>A continuació, es cobreix amb detall cada fitxa.</p>
  </section>

  <section id="storage">
    <title>Emmagatzematge</title>
    <p>El <app>Programari</app> mostra una fitxa d'emmagatzematge a la pàgina de detalls d'una aplicació. Si l'aplicació no està instal·lada, es mostrarà la mida de baixada estimada necessària per instal·lar-la. Si l'aplicació està instal·lada, mostra l'espai d'emmagatzematge utilitzat per l'aplicació.</p>
    <p>Les mides es calculen a partir de les dades proporcionades pel rerefons del <app>Programari</app> (com flatpak o un RPM), i no s'especifiquen a les metadades proporcionades per l'aplicació. No hi ha res que pugueu fer per afectar aquesta fitxa editant el fitxer «metainfo» d'una aplicació. S'enumera aquí per a la seva integritat.</p>
  </section>

  <section id="safety">
    <title>Seguretat</title>
    <p>El <app>Programari</app> mostra una fitxa de seguretat a la pàgina de detalls d'una aplicació. Això resumeix la informació sobre si l'aplicació es pot considerar segura per instal·lar i executar, o si es pot requerir precaució abans de confiar en ella.</p>
    <p>Aquesta fitxa combina informació sobre els permisos que demana l'aplicació quan s'executa (com ara permís per llegir els vostres fitxers), amb informació sobre com s'ha desenvolupat l'aplicació. Les aplicacions de programari lliure, on el codi font és llegible públicament, poden ser més segures que les privatives, ja que poden ser auditades.</p>
    <p>El diàleg que apareix quan es fa clic a la fitxa llista els diferents permisos que sol·licita l'aplicació, a més d'alguna informació sobre la seva llicència i temps d'execució.</p>
    <p>Podeu millorar la informació de seguretat:</p>
    <list>
      <item>
	<p><link xref="#how-to-fix-incorrect-safety-and-permissions-information">Com corregir la informació incorrecta de seguretat i permisos</link></p>
      </item>
    </list>
  </section>

  <section id="hardware-support">
    <title>Suport per al maquinari</title>
    <p>El <app>Programari</app> mostra una fitxa de suport de maquinari a la pàgina de detalls d'una aplicació. Això combina informació sobre els requisits de maquinari de l'aplicació, i les capacitats de maquinari de l'ordinador, amb l'objectiu de ressaltar les incompatibilitats o els requisits que falten; o per indicar que l'aplicació ha de funcionar correctament sense incompatibilitats.</p>

    <p>El codi mira el maquinari següent. En el futur es podrà donar més suport.</p>
    <list>
      <item><p>Si requereix de ratolí tàctil, ratolí o teclat</p></item>
      <item><p>Si es necessita un teclat de joc</p></item>
      <item><p>La mida mínima i recomanada de visualització a la que l'aplicació pot escalar</p></item>
    </list>

    <p>No és possible detectar de manera fiable si un comandament de joc és <em>present</em>, ja que sovint es deixen desconnectats a causa de no ser necessaris per a l'ús normal de l'ordinador.</p>
    <p>El diàleg que apareix quan es fa clic a la fitxa llista els diferents requisits de maquinari de l'aplicació, i si no es compleix algun d'ells.</p>
    <p>Podeu millorar la informació del maquinari:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-hardware-information">Com afegir la informació que falta del maquinari</link></p>
      </item>
    </list>
  </section>

  <section id="age-rating">
    <title>Valoració de l'edat</title>
    <p>El <app>Programari</app> mostra una fitxa de qualificació d'edat a la pàgina de detalls d'una aplicació. Això mostra per a quin rang d'edat ha de ser adequada l'aplicació, en funció de diferents tipus de contingut que l'aplicació ha declarat que conté. Aquesta informació es resumeix en un format similar als certificats de qualificació del joc o de la pel·lícula per al vostre país.</p>
    <p>Per exemple, això ressaltarà si un joc conté violència, o si una aplicació conté publicitat a l'aplicació.</p>
    <p>El diàleg que apareix quan es fa clic a la fitxa llista els diferents tipus de contingut de l'aplicació i la severitat d'aquest contingut.</p>
    <p>Podeu millorar la informació de la qualificació d'edat:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-content-rating-information">Com afegir la informació de valoració de l'edat del contingut que manca</link></p>
      </item>
    </list>
  </section>

  <section id="license">
    <title>Llicència</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>El <app>Programari</app> mostra una fitxa que indica si una aplicació és <link href="https://en.wikipedia.org/wiki/Free_and_open-source_software">programari lliure</link> o si la seva llicència és privativa, especial o desconeguda. Aquesta fitxa inclou informació més detallada sobre la llicència del projecte. Aquesta fitxa també enumera alguns dels beneficis del programari lliure. <link xref="software-licensing#introduction">Més informació</link></p>
    <p>De vegades la informació de la llicència no és correcta per a una aplicació, i per tant una aplicació que és en realitat programari lliure es mostrarà com a «privativa». De la mateixa manera, de vegades la informació de la llicència és desconeguda.</p>
    <p>El <app>Programari</app> destaca les llicències lliures i de codi obert en verd, les llicències privatives i especials en groc, com es mostra aquí. Les llicències desconegudes es destaquen en gris.</p>
    <p>Podeu afegir o millorar la informació de la llicència:</p>
    <list>
      <item>
	<p><link xref="#how-to-fix-incorrect-licensing-information">Com corregir la informació incorrecta de les llicències</link></p>
      </item>
    </list>
  </section>

  <section id="links">
    <title>Enllaços</title>
    <media type="image" src="figures/scalable/links.svg" style="floatend floatright" mime="image/svg" its:translate="no"/>
    <p>El <app>Programari</app> mostra una llista d'enllaços de recursos d'aplicacions a la fitxa d'enllaços. Són les següents:</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>Enllaç al lloc web</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>Enllaç de donació</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>Enllaç de contribucions de traducció</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>Enllaç d'informe d'error</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>Enllaç d'ajuda</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>Enllaç de contacte</p></td>
      </tr>
    </table>
    <p>Alguns o tots aquests enllaços poden estar presents en funció de si estan llistats en el fitxer metainfo de l'aplicació.</p>
    <p>En els casos en què el fitxer metainfo de l'aplicació no contingui cap enllaç, es mostrarà la següent fitxa amb un signe d'interrogació.</p>
    <media type="image" src="figures/scalable/no-links.svg" style="floatend floatright" mime="image/svg" its:translate="no"/>
    <p>Podeu millorar els enllaços:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-links">Com afegir enllaços que falten</link></p>
      </item>
    </list>
  </section>

  <section id="carousel-tile">
    <title>Tessel·la de carrusel</title>
    <media type="image" src="figures/carousel.png" style="floatend floatright" mime="image/png" its:translate="no"/>
    <p>Les aplicacions que apareixen al <app>Programari</app> es mostren en un carrusel a la part superior de la finestra principal, com es mostra aquí. Cada tessel·la de carrusel té un color de fons que s'extreu automàticament de la icona de l'aplicació. De vegades aquest color de fons no és del tot correcte per a l'aplicació i ha de ser especificat explícitament pel desenvolupador d'aplicacions.</p>
    <p>El conjunt d'aplicacions que apareixen és decidit pels mantenidors de la distribució Linux.</p>
    <p>Podeu millorar la tessel·la de carrusel:</p>
    <list>
      <item>
	<p><link xref="#how-to-set-the-carousel-tile-background-colour">Com establir el color de fons de la tessel·la de carrusel</link></p>
      </item>
    </list>
  </section>

  <section id="where-metadata-comes-from">
    <title>D'on venen les metadades</title>
    <p>Les metadades utilitzades per especificar quin maquinari requereix una peça de programari, per a quines edats d'usuari és adequat, i els factors que contribueixen a la seguretat en la instal·lació, tots provenen del fitxer metainfo per a aquest programari.</p>
    <p>El fitxer metainfo és un fitxer XML. El seu format de fitxer s'explica a l'especificació de l'<link href="https://www.freedesktop.org/software/appstream/docs/">AppStream</link>.</p>
    <p>Vegeu el <link href="https://gitlab.gnome.org/GNOME/nautilus/-/blob/main/data/org.gnome.Nautilus.metainfo.xml.in.in">fitxer metainfo per a l'aplicació Fitxers del GNOME</link>.</p>
    <note style="tip">
      <p><em>appdata</em> és el terme antic per a <em>metainfo</em>.</p>
    </note>
  </section>

  <section id="what-happens-if-metadata-is-missing">
    <title>Què passa si falten les metadades</title>
    <p>Si falten algunes metadades per a una aplicació, el <app>Programari</app> només pot endevinar el que podria ser, i per tant no pot presentar molta informació a les seves interfícies. Les conjectures del <app>Programari</app> es basen en el fet que la majoria del programari està dissenyat per a ordinadors d'escriptori.</p>
    <p><em style="strong">Podeu ajudar a millorar les metadades d'una aplicació.</em></p>
  </section>

  <section id="how-to-contribute-missing-information">
    <title>Com aportar la informació que falta</title>
    <p>Si trobeu que a la pàgina d'una aplicació hi falta informació o té informació incorrecta, podeu contribuir d'una de les dues maneres següents:</p>
    <list type="numbered">
      <item>
	<p>Podeu informar de les metadades que falten o son incorrectes al gestor d'incidències de la respectiva aplicació, de manera que el desenvolupador de l'aplicació pugui arreglar-ho.</p>
      </item>
      <item>
	<p>Podeu corregir les metadades que falten o son incorrectes. Vegeu la guia sobre <em style="strong">Com fer-ho</em> a continuació.</p>
      </item>
    </list>

    <p>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 <link xref="#links">as shown here</link>. If not, you will need to find it with a simple search on Google.</p>

    <p>Apps are typically hosted in <link href="https://gitlab.com/explore?sort=stars_desc">GitLab</link> or <link href="https://github.com/explore">GitHub</link>. For example, GNOME apps are hosted in <link href="https://gitlab.gnome.org/GNOME?sort=stars_desc">gitlab.gnome.org</link>.</p>
  </section>

  <section id="how-to-add-missing-app-screenshots">
    <title>Com afegir captures de pantalla de l'aplicació que falten</title>
    <p>The screenshot information for an application is stored in the <link href="https://www.freedesktop.org/software/appstream/docs/sect-Metadata-Application.html#tag-dapp-screenshots"><code>&lt;screenshots&gt;</code></link> element within the application’s <code>&lt;component&gt;</code> in its metainfo file.</p>
    <p>Recommended number of screenshots for an app is between 5 to 10. Screenshots should ideally be in the PNG format with 16:9 aspect ratio and minimum width of 620 pixels.</p>
    <p>For example, here are the screenshot entries for the <app>Software</app> app:</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>Com corregir la informació incorrecta de seguretat i permisos</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>If the application works on Wayland, and only needs to work on X11 as a fallback, without using special X11 features, could it use <code>--socket=fallback-x11</code> rather than <code>--socket=x11</code>?</p>
    <p>La guia sobre permisos específics, o altres formats de paquets, es pot afegir aquí en el futur.</p>
    <p>Lectura addicional:</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>Com afegir la informació del maquinari que falta</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>Com afegir la informació de valoració de l'edat del contingut que manca</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>Use <link href="https://hughsie.github.io/oars/">the OARS generator</link> to produce suitable content rating information for an application.</p>
  </section>

  <section id="how-to-fix-incorrect-licensing-information">
    <title>Com corregir la informació incorrecta de les llicències</title>
    <p>The licensing information for an application is stored in the <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-project_license"><code>&lt;project_license&gt;</code></link> element within the application’s <code>&lt;component&gt;</code> in its metainfo file.</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">Per exemple</link>, canvieu les metadades de la llicència de:</p>
    <code its:translate="no" mime="application/xml"><![CDATA[<project_license>GPL-2.0+ and CC-BY-SA-3.0</project_license>]]></code>
    <p>a</p>
    <code its:translate="no" mime="application/xml"><![CDATA[<project_license>GPL-2.0+</project_license>]]></code>
    <p>Lectura addicional:</p>
    <list>
      <item>
	<p><link href="https://tecnocode.co.uk/2021/07/05/dont-generally-put-cc-by-sa-in-appdata/">No afegiu (generalment) la llicència de documentació a les dades de l'aplicació</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>Com afegir enllaços que falten</title>
    <p>The links for an application are stored as <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-url"><code>&lt;url&gt;</code></link> elements within the application’s <code>&lt;component&gt;</code> in its metainfo file.</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>Per exemple, aquí teniu els enllaços de recursos per a l'aplicació <app>Programari</app>:</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>Com establir el color de fons de la tessel·la de carrusel</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>Per exemple, aquí teniu algunes entrades de marca:</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>Note the <code>scheme_preference</code> attribute is ignored, <app>Software</app> chooses the better color for the theme on its own.</p>
    </note>
    <p>Queda, per a la compatibilitat amb versions anteriors, la possibilitat d'afegir el següent XML a l'element de metainfo <code>&lt;component &gt;</code> de l'aplicació:</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>però l'element <code>&lt;branding/&gt;</code> té prioritat.</p>
    <p>El valor de <code>GnomeSoftware::key-colors</code> és un GVariant de format text amb el tipus <code>a(yyy)</code>, i representa un conjunt de colors clau no ordenats per a l'aplicació. Cada element del conjunt és un color en forma RGB que va des de <code>(0, 0, 0)</code> fins a <code>(255, 255, 255)</code>.</p>
    <p>Els colors s'han d'escollir de manera que:</p>
    <list>
      <item>
	<p>Siguin identificables amb l'aplicació, que coincideixin d'alguna manera amb la marca de l'aplicació, si és possible.</p>
      </item>
      <item>
	<p>Contrastin amb la vora de la icona de l'aplicació, de manera que quan s'utilitzen com a fons darrere d'ella, es pugui distingir la icona.</p>
      </item>
      <item>
	<p>Contrast with the foreground text color in the Adwaita theme (<code>#2e3436</code>) and in its dark variant (<code>#eeeeec</code>). This generally means choosing a color with a medium level of brightness.</p>
      </item>
      <item>
	<p>Contrast can be checked using the <link href="https://flathub.org/apps/org.gnome.design.Contrast/">Contrast app</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>Com provar els canvis de color de fons de les tessel·les de carrusel</title>
    <p>Modifiqueu el fitxer de metadades per a la vostra aplicació i executeu el <app>Programari</app> amb:</p>
    <p><cmd>gnome-software --show-metainfo=<var>/camí/a/app.metainfo.xml</var>,icon=<var>/camí/a/l'aplicació/icona.png</var></cmd></p>
    <p>Es mostrarà la pàgina de detalls de l'aplicació. Si torneu a navegar a la pàgina general del <app>Programari</app>, la vostra aplicació serà l'única en el carrusel «destacat».</p>
  </section>


</page>
