<?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ó de jocs o pel·lícules 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 el nivell 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 destacades al <app>Programari</app> es mostren en un carrusel a la part superior de la finestra principal, com es mostra aquí. Cada tessel·la del 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 de l'aplicació.</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 del 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 suposicions 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 hi ha 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'errors de la respectiva l'aplicació, de manera que el desenvolupador de l'aplicació ho pugui resoldre.</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>Per a ambdues opcions, primer heu de trobar la pàgina del projecte de l'aplicació. L'enllaç a la pàgina del projecte normalment hauria d'estar disponible a la pàgina de l'aplicació <link xref="#links">com es mostra aquí</link>. Si no, haureu de trobar-la amb una simple cerca a Google.</p>

    <p>Les aplicacions s'allotgen normalment al <link href="https://gitlab.com/explore?sort=stars_desc">GitLab</link> o al <link href="https://github.com/explore">GitHub</link>. Per exemple, les aplicacions del GNOME estan allotjades a <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>La informació de les captures de pantalla d'una aplicació s'emmagatzema en l'element <link href="https://www.freedesktop.org/software/appstream/docs/sect-Metadata-Application.html#tag-dapp-screenshots"><code>&lt;screenshots&gt;</code></link> dins de l'element<code>&lt;component&gt;</code>en el seu fitxer metainfo.</p>
    <p>El nombre recomanat de captures de pantalla per a una aplicació és d'entre 5 i 10. Les captures de pantalla haurien d'estar en el format PNG amb una relació d'aspecte 16:9 i una amplada mínima de 620 píxels.</p>
    <p>Per exemple, aquí teniu les entrades de captura de pantalla de l'aplicació <app>Programari</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>La informació de seguretat i permisos d'una aplicació prové de diferents fonts depenent de com s'empaqueta l'aplicació. Per a aplicacions empaquetades de la forma tradicional, per exemple en format RPM o DEB, no hi ha informació de seguretat o permisos disponible i no es pot fer res per afegir-la a una aplicació.</p>
    <p>Per a les aplicacions flatpak, la informació prové del <link href="https://docs.flatpak.org/en/latest/manifests.html">manifest de flatpak</link>, especificant quins forats en l'aïllament requereix l'aplicació. Cadascun d'aquests forats normalment contribueix a baixar el nivell de seguretat mostrat de l'aplicació en el <app>Programari</app>, canviant-lo de «segur» a «potencialment insegur» o «insegur».</p>
    <p>Per tal de millorar el nivell de seguretat d'una aplicació, el seu aïllament s'ha de fer el més ajustat possible, eliminant <link href="https://docs.flatpak.org/en/latest/sandbox-permissions.html">permisos de l'aïllament</link> que no són necessaris, i utilitzant <link href="https://docs.flatpak.org/en/latest/desktop-integration.html#portals">portals</link> en lloc de permisos d'aïllament quan sigui possible. L'ús de portals no redueix el nivell de seguretat mostrat d'una aplicació al <app>Programari</app>.</p>
    <p>Per exemple, si l'aplicació sol·licita accés de lectura/escriptura al sistema de fitxers complet (<code>--filesystem=host</code>), realment necessita això, o només necessita accedir als fitxers en algunes ubicacions específiques? Si és així, es podria utilitzar el <link href="https://docs.flatpak.org/en/latest/desktop-integration.html#portals">portal de fitxers</link>, o es podrien especificar més <link href="https://docs.flatpak.org/en/latest/sandbox-permissions.html#filesystem-access">permisos del sistema de fitxers </link>.</p>
    <p>Si l'aplicació funciona al Wayland, i només necessita treballar en X11 com a alternativa, sense utilitzar funcions especials de X11, podria utilitzar <code>--socket=fallback-x11</code> en lloc de <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>La informació del maquinari d'una aplicació s'emmagatzema en els elements <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-relations"><code>&lt;requires&gt;</code>,<code>&lt;recommends&gt;</code>i<code>&lt;supports&gt;</code></link> dins dels<code>&lt;component&gt;</code>en el seu fitxer metainfo.</p>
    <p>El <app>Programari</app> entén els elements <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-relations-control"><code>&lt;control&gt;</code></link> i <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-relations-display_length"><code>&lt;display_length&gt;</code></link>.</p>
    <p>Vegeu <link href="https://tecnocode.co.uk/2021/07/12/add-metadata-to-your-app-to-say-what-inputs-and-display-sizes-it-supports/">aquesta entrada del blog</link> o <link href="https://blogs.gnome.org/tbernard/2021/09/07/ready-for-software-41/#device-support">aquesta entrada del blog</link> per a exemples de metadades.</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>La informació de qualificació de contingut d'una aplicació s'emmagatzema en l'element <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-content_rating"><code>&lt;content_rating&gt;</code></link> dins de l'element<code>&lt;component&gt;</code> de l'aplicació en el seu fitxer metainfo.</p>
    <p>Les aplicacions han d'utilitzar l'estàndard OARS 1.1 per omplir aquest element. Si no s'especifica l'element <code>&lt;content_rating&gt;</code>, es desconeix la qualificació del contingut de l'aplicació. Si s'especifica però està buit, l'aplicació no té contingut que pugui ser inadequat per a qualsevol audiència.</p>
    <p>Utilitzeu <link href="https://hughsie.github.io/oars/">el generador OARS</link> per produir informació adequada de qualificació de contingut per a una aplicació.</p>
  </section>

  <section id="how-to-fix-incorrect-licensing-information">
    <title>Com corregir la informació incorrecta de les llicències</title>
    <p>La informació de llicència d'una aplicació s'emmagatzema en l'element <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-project_license"><code>&lt;project_license&gt;</code></link> dins de l'element<code>&lt;component&gt;</code>de l'aplicació en el seu fitxer metainfo.</p>
    <p>El contingut d'aquest element hauria de ser una <link href="https://spdx.org/specifications">expressió SPDX</link> que descriu la llicència «principal» per al projecte. Això hauria de ser normalment la llicència del codi, i no incloure la llicència de la documentació o del contingut auxiliar.</p>
    <p>Si l'expressió SPDX és una única llicència, o una combinació de múltiples llicències, que són totes <link href="https://spdx.org/licenses/">aprovades per la FSF o l'OSI</link>, l'aplicació es considera «programari lliure» i la fitxa de llicència ho diu. En cas contrari, es considera «privativa».</p>
    <p>Si una aplicació es mostra com a «privativa» quan creieu que no ho hauria de ser, és probable que l'element <code>&lt;project_license&gt;</code> inclogui la llicència de documentació per al projecte. Elimineu-lo.</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>Els enllaços per a una aplicació s'emmagatzemen com a elements <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-url"><code>&lt;url&gt;</code></link> dins del <code>&lt;component&gt;</code> de l'aplicació en el seu fitxer metainfo.</p>
    <p>Afegiu tants dels tipus d'enllaç documentats a l'<link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-url">especificació de l'appstream</link> com estiguin disponibles per a l'aplicació. Si no hi ha cap pàgina adequada per a un tipus d'enllaç donat, no s'ha d'incloure.</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>El color de fons de la tessel·la de carrusel normalment s'extreu automàticament de la icona de l'aplicació. Si aquest color és insatisfactori, però, es pot anul·lar utilitzant l'element <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-branding"><code>&lt;branding/&gt;</code> de l'appstream</link> amb colors declarats (des de la sèrie 47.x). L'avantatge és que més clients poden utilitzar els 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>Tingueu en compte que l'atribut <code>scheme_preference</code> és ignorat, el <app>Programari</app> tria el millor color per al tema pel seu compte.</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 amb el color del text de primer pla en el tema Adwaita (<code> #2e3436</code>) i en la seva variant fosca (<code>#eeeeec</code>). Això generalment significa triar un color amb un nivell mitjà de brillantor.</p>
      </item>
      <item>
	<p>Es pot comprovar el contrast utilitzant l'aplicació <link href="https://flathub.org/apps/org.gnome.design.Contrast/">Contrast</link>.</p>
      </item>
    </list>
    <p>S'ha d'especificar almenys un color. Es pot especificar més si un color no pot satisfer tots els requisits anteriors, i el <app>Programari</app> triarà el més adequat per utilitzar en la tessel·la de carrusel. Si s'especifica exactament un color, la seva brillantor i saturació es poden modificar per millorar el contrast amb el color de primer pla. Si s'especifica més d'un color, s'escollirà el que tingui millor contrast amb el color de primer pla, i no es modificarà la seva brillantor i saturació.</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>
