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

  <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>Come <app>Software</app> usa i metadati</desc>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Davide Ferracin</mal:name>
      <mal:email>davide.ferracin@protonmail.com</mal:email>
      <mal:years>2025</mal:years>
    </mal:credit>
  </info>

  <title>Metadati del software</title>
  <links type="section"/>

  <section id="screenshots">
    <title>Schermate</title>
    <media type="image" src="figures/app-screenshot.png" style="floatend floatright" mime="image/png" its:translate="no"/>
    <p><app>Software</app> mostra delle schermate nella pagina dei dettagli di un'applicazione. Ciò include solitamente schermate di varie finestre dell'applicazione, in modo che l'utente possa comprendere rapidamente le caratteristiche, l'aspetto e le funzionalità dell'applicazione.</p>
    <p>Quando nel file metainfo dell'applicazione è presente più di una schermata, <app>Software</app> mostrerà le schermate in un carosello.</p>
    <p>Nei casi in cui il file metainfo dell'applicazione non contenga alcuna schermata, verrà visualizzata un'icona segnaposto come quella riportata di seguito con la dicitura <code>Nessuna schermata</code>:</p>
    <media type="image" src="figures/scalable/symbolic/image-missing-symbolic.svg" width="96" mime="image/svg" its:translate="no"/>
    <note>
      <p>Se si utilizza un tema di icone personalizzato, l'icona segnaposto potrebbe apparire diversa.</p>
    </note>
    <p>Man mano che l'interfaccia utente dell'applicazione si evolve, le schermate potrebbero diventare obsoleti. Pertanto, anche se <app>Software</app> mostra le schermate di un'applicazione, è importante verificare se esse siano aggiornate o obsolete.</p>
    <p>Per migliorare le informazioni sulle schermate delle applicazioni:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-app-screenshots">Come aggiungere una schermata mancante dell'applicazione</link></p>
      </item>
    </list>
  </section>

  <section id="app-context-bar">
    <title>Barra contestuale dell'applicazione</title>
    <p>La barra contestuale dell'applicazione in <app>Software</app> è una raccolta di riquadri nella pagina dei dettagli, che visualizzano le seguenti informazioni.</p>
    <list>
      <item>
	<p><link xref="#storage">Archiviazione</link></p>
      </item>
      <item>
	<p><link xref="#safety">Sicurezza</link></p>
      </item>
      <item>
	<p><link xref="#hardware-support">Supporto hardware</link></p>
      </item>
      <item>
	<p><link xref="#age-rating">Classificazione per età</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.">Questo mostra la barra di contesto di <app>Software</app> stessa:</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.">I riquadri vengono mostrati nell'ordine sopra elencato (iniziando dal riquadro <code>Archiviazione</code> sulla sinistra).</p>
    <p>Ogni riquadro è descritto dettagliatamente di seguito.</p>
  </section>

  <section id="storage">
    <title>Archiviazione</title>
    <p><app>Software</app> mostra un riquadro di archiviazione nella pagina dei dettagli di un'applicazione. Se l'applicazione non è installata, viene visualizzata la dimensione stimata dello scaricamento necessario per installarla. Se l'applicazione è già installata, viene visualizzato lo spazio di archiviazione utilizzato dall'applicazione.</p>
    <p>Le dimensioni sono calcolate a partire dai dati forniti dal backend di <app>Software</app> (come flatpak o un RPM) e non sono specificate nei metadati forniti dall'applicazione. Non è possibile modificare questo riquadro modificando il file metainfo di un'applicazione. Viene elencato qui per completezza.</p>
  </section>

  <section id="safety">
    <title>Sicurezza</title>
    <p><app>Software</app> mostra un riquadro di sicurezza nella pagina dei dettagli di un'applicazione. Questo riquadro riassume le informazioni relative alla sicurezza dell'installazione e dell'esecuzione dell'applicazione, indicando se è necessario fare attenzione prima di considerarla affidabile.</p>
    <p>Il riquadro combina le informazioni relative alle autorizzazioni richieste dall'applicazione durante l'esecuzione (ad esempio l'autorizzazione a leggere i file dell'utente) con le informazioni relative al suo sviluppo. Il software gratuito, il cui codice sorgente è pubblicamente accessibile, può rivelarsi più sicuro di quello proprietario, in quanto può essere direttamente verificato.</p>
    <p>Quando si clicca sul riquadro appare una finestra di dialogo che elenca le diverse autorizzazioni richieste dall'applicazione, oltre ad alcune informazioni sulla sua licenza e sul suo runtime.</p>
    <p>Per migliorare le informazioni sulla sicurezza:</p>
    <list>
      <item>
	<p><link xref="#how-to-fix-incorrect-safety-and-permissions-information">Come correggere informazioni errate su sicurezza e autorizzazioni</link></p>
      </item>
    </list>
  </section>

  <section id="hardware-support">
    <title>Supporto hardware</title>
    <p><app>Software</app> mostra un riquadro relativo al supporto hardware nella pagina dei dettagli di un'applicazione. Questo riquadro combina le informazioni sui requisiti hardware dell'applicazione e sulle capacità hardware del computer, con l'obiettivo di evidenziare eventuali incompatibilità o requisiti mancanti, oppure di indicare che l'applicazione dovrebbe funzionare correttamente senza alcuna incompatibilità.</p>

    <p>Il codice prende in considerazione il seguente hardware. In futuro altri dispositivi potrebbero essere supportati.</p>
    <list>
      <item><p>Se sono presenti/necessari un touchpad, un mouse o una tastiera.</p></item>
      <item><p>Se è necessario un gamepad</p></item>
      <item><p>Le dimensioni dello schermo minime e consigliate alle quali l'applicazione può adattarsi</p></item>
    </list>

    <p>Non è possibile rilevare in modo affidabile se un gamepad è <em>presente</em> poiché spesso viene lasciato scollegato, non essendo necessario per il normale utilizzo del computer.</p>
    <p>La finestra di dialogo che appare quando si fa clic sul riquadro elenca i diversi requisiti hardware dell'applicazione e indica se qualcuno di essi non è soddisfatto.</p>
    <p>Per migliorare le informazioni sull'hardware:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-hardware-information">Come aggiungere informazioni mancanti sull'hardware</link></p>
      </item>
    </list>
  </section>

  <section id="age-rating">
    <title>Classificazione per età</title>
    <p><app>Software</app> mostra un riquadro con la classificazione per età nella pagina dei dettagli di un'applicazione. Questo riquadro indica la fascia d'età per cui si considera adatta l'applicazione, in base ai diversi tipi di contenuti che essa ha dichiarato di contenere. Queste informazioni sono riassunte in un formato simile ai certificati di classificazione dei giochi o dei film di ciascun Paese.</p>
    <p>Ad esempio, questo metterà in evidenza se un gioco contiene scene di violenza o se un'applicazione contiene pubblicità al suo interno.</p>
    <p>La finestra di dialogo che appare quando si clicca sul riquadro elenca i diversi tipi di contenuti presenti nell'applicazione e la loro gravità.</p>
    <p>Per migliorare le informazioni sulla classificazione per età:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-content-rating-information">Come aggiungere informazioni mancanti sulla classificazione per età</link></p>
      </item>
    </list>
  </section>

  <section id="license">
    <title>Licenza</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>Software</app> mostra un riquadro che indica se un'applicazione è <link href="https://en.wikipedia.org/wiki/Free_and_open-source_software">software libero</link> o se la sua licenza è proprietaria, speciale o sconosciuta. Questo riquadro include informazioni più dettagliate sulla licenza del progetto. Il riquadro elenca anche alcuni dei vantaggi del software libero. <link xref="software-licensing#introduction">Ulteriori informazioni</link></p>
    <p>A volte le informazioni sulla licenza non sono corrette per un'applicazione, e quindi un'applicazione che in realtà è software libero verrà visualizzata come “proprietaria”. Allo stesso modo, a volte le informazioni sulla licenza sono sconosciute.</p>
    <p><app>Software</app> evidenzia le licenze gratuite e open source in verde, e quelle proprietarie e speciali in giallo, come mostrato qui. Le licenze sconosciute sono evidenziate in grigio.</p>
    <p>Per aggiungere o migliorare le informazioni sulla licenza:</p>
    <list>
      <item>
	<p><link xref="#how-to-fix-incorrect-licensing-information">Come correggere informazioni errate sulla licenza</link></p>
      </item>
    </list>
  </section>

  <section id="links">
    <title>Collegamenti</title>
    <media type="image" src="figures/scalable/links.svg" style="floatend floatright" mime="image/svg" its:translate="no"/>
    <p><app>Software</app> mostra, nel riquadro dei collegamenti, un elenco di collegamenti alle risorse dell'applicazione. Essi sono:</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>Collegamento al sito 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>Collegamento per fare una donazione</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>Collegamento per contribuire alla traduzione</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>Collegamento per segnalare un problema</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>Collegamento per ottenere aiuto</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>Collegamento per entrare in contatto</p></td>
      </tr>
    </table>
    <p>Tutti o alcuni di questi collegamenti potrebbero essere presenti, in base a quali di essi sono elencati nel file metainfo dell'applicazione.</p>
    <p>Laddove il file metainfo dell'applicazione non contenga alcun collegamento, verrà mostrato il seguente riquadro con un punto di domanda.</p>
    <media type="image" src="figures/scalable/no-links.svg" style="floatend floatright" mime="image/svg" its:translate="no"/>
    <p>Per migliorare i collegamenti:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-links">Come aggiungere collegamenti mancanti</link></p>
      </item>
    </list>
  </section>

  <section id="carousel-tile">
    <title>Riquadro del carosello</title>
    <media type="image" src="figures/carousel.png" style="floatend floatright" mime="image/png" its:translate="no"/>
    <p>Le applicazioni presentate da <app>Software</app> vengono visualizzate in un carosello nella parte superiore della finestra principale, come mostrato qui. Ogni riquadro del carosello ha un colore di sfondo che viene estratto automaticamente dall'icona dell'applicazione. A volte questo colore di sfondo non è del tutto adatto all'applicazione e deve essere specificato esplicitamente dal suo sviluppatore.</p>
    <p>Sono i manutentori della distribuzione Linux che si usa a decidere quali applicazioni vengono presentate.</p>
    <p>Per migliorare il riquadro del carosello:</p>
    <list>
      <item>
	<p><link xref="#how-to-set-the-carousel-tile-background-colour">Come impostare il colore di sfondo del riquadro del carosello</link></p>
      </item>
    </list>
  </section>

  <section id="where-metadata-comes-from">
    <title>Da dove vengono i metadati</title>
    <p>I metadati utilizzati per specificare l'hardware richiesto da un software, l'età degli utenti ai quali è adatto e i fattori che contribuiscono alla sicurezza della sua installazione provengono tutti dal file metainfo di quel software.</p>
    <p>Il file metainfo è un file XML. Il suo formato è dettagliato nelle <link href="https://www.freedesktop.org/software/appstream/docs/">specifiche AppStream</link>.</p>
    <p>Consultare il <link href="https://gitlab.gnome.org/GNOME/nautilus/-/blob/main/data/org.gnome.Nautilus.metainfo.xml.in.in">file metainfo per l'applicazione File di GNOME</link>.</p>
    <note style="tip">
      <p>Il vecchio nome per <em>metainfo</em> è <em>appdata</em>.</p>
    </note>
  </section>

  <section id="what-happens-if-metadata-is-missing">
    <title>Cosa succede se mancano dei metadati</title>
    <p>Se mancano alcuni metadati di un'applicazione, <app>Software</app> può solo ipotizzare quali potrebbero essere, quindi non sarà in grado di presentare molte informazioni nelle sue interfacce. Le ipotesi formulate da <app>Software</app> si basano sul fatto che la maggior parte dei software è progettata per computer desktop.</p>
    <p><em style="strong">Si può aiutare a migliorare i metadati di un'applicazione!</em></p>
  </section>

  <section id="how-to-contribute-missing-information">
    <title>Come fornire le informazioni mancanti</title>
    <p>Se si ritiene che la pagina di un'applicazione sia incompleta o contenga informazioni errate, si può contribuire in uno dei due modi seguenti:</p>
    <list type="numbered">
      <item>
	<p>Segnalare i metadati mancanti o incorretti nel bug tracker dell'applicazione, così che gli sviluppatori possano correggerli.</p>
      </item>
      <item>
	<p>Correggere i metadati mancanti o incorretti da soli. Consultare la <em style="strong">guida</em> di seguito per scoprire come fare.</p>
      </item>
    </list>

    <p>Per entrambi, bisogna prima trovare la pagina del progetto dell'applicazione. Il collegamento alla pagina del progetto dovrebbe essere disponibile nella pagina dell'applicazione <link xref="#links">come mostrato qui</link>. In caso contrario, lo si dovrà cercare con una semplice ricerca su Google.</p>

    <p>Le applicazioni sono solitamente ospitate su <link href="https://gitlab.com/explore?sort=stars_desc">GitLab</link> o <link href="https://github.com/explore">GitHub</link>. Ad esempio, le applicazioni di GNOME sono ospitate su <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>Come aggiungere le schermate mancanti delle applicazioni</title>
    <p>Le informazioni sulle schermate per un'applicazione sono contenute nell'elemento <link href="https://www.freedesktop.org/software/appstream/docs/sect-Metadata-Application.html#tag-dapp-screenshots"><code>&lt;screenshots&gt;</code></link> all'interno dell'elemento <code>&lt;component&gt;</code> dell'applicazione nel suo file metainfo.</p>
    <p>È consigliato per le applicazioni un numero di schermate tra 5 e 10. Le schermate dovrebbero idealmente essere nel formato PNG con un rapporto 16:9 e una larghezza minima di 620 pixel.</p>
    <p>Ad esempio, queste sono le schermate per l'applicazione <app>Software</app> stessa:</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>Come correggere le informazioni sbagliate su sicurezza e autorizzazioni</title>
    <p>Le informazioni relative alla sicurezza e alle autorizzazioni di un'applicazione provengono da fonti diverse a seconda di come l'applicazione è stata impacchettata. Per le applicazioni impacchettate in modo tradizionale, ad esempio in formato RPM o DEB, non sono disponibili informazioni relative alla sicurezza o alle autorizzazioni e non è possibile aggiungerle all'applicazione.</p>
    <p>Per le applicazioni flatpak, le informazioni provengono dal <link href="https://docs.flatpak.org/en/latest/manifests.html">manifesto flatpak</link> dell'applicazione, che specifica quali aperture nella sandbox sono richieste all'applicazione. Ciascuna di queste aperture ha l'effetto in genere di abbassare il livello di sicurezza visualizzato dell'applicazione in <app>Software</app>, spostandolo da “sicuro” a “potenzialmente non sicuro” fino a “non sicuro”.</p>
    <p>Per migliorare il livello di sicurezza di un'applicazione, la sua sandbox deve essere la più rigorosa possibile, rimuovendo le <link href="https://docs.flatpak.org/en/latest/sandbox-permissions.html ">autorizzazioni sandbox</link> dove non sono necessarie e utilizzando al loro posto, dove possibile, i <link href="https://docs.flatpak.org/en/latest/desktop-integration.html#portals">portali</link>. L'uso dei portali non riduce il livello di sicurezza di un'applicazione mostrato in <app>Software</app>.</p>
    <p>Ad esempio, se l'applicazione richiede l'accesso in lettura/scrittura all'intero file system (<code>--filesystem=host</code>), ne ha effettivamente bisogno o deve solo accedere ai file in alcune posizioni specifiche? In tal caso, è possibile utilizzare il <link href="https://docs.flatpak.org/en/latest/desktop-integration.html#portals">portale dei file</link> oppure definire <link href="https://docs.flatpak.org/en/latest/sandbox-permissions.html#filesystem-access">permessi del file system</link> più specifici.</p>
    <p>Se l'applicazione funziona su Wayland, e ha bisogno di X11 solo come ripiego, senza far uso di sue funzionalità specifiche, potrebbe usare <code>--socket=fallback-x11</code> anziché <code>--socket=x11</code>?</p>
    <p>In futuro qui potrebbero essere aggiunte indicazioni relative a specifici permessi o altri formati di pacchetti.</p>
    <p>Ulteriori approfondimenti:</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>Come aggiungere informazioni mancanti sull'hardware</title>
    <p>Le informazioni sull'hardware per un'applicazione sono contenute negli elementi <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-relations"><code>&lt;requires&gt;</code>, <code>&lt;recommends&gt;</code> e <code>&lt;supports&gt;</code></link> all'interno dell'elemento <code>&lt;component&gt;</code> del suo file metainfo.</p>
    <p><app>Software</app> è in grado di leggere gli elementi <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-relations-control"><code>&lt;control&gt;</code></link> e <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>Consultare <link href="https://tecnocode.co.uk/2021/07/12/add-metadata-to-your-app-to-say-what-inputs-and-display-sizes-it-supports/">questo blog post</link> o <link href="https://blogs.gnome.org/tbernard/2021/09/07/ready-for-software-41/#device-support">questo blog post</link> per leggere alcuni esempi di metadati.</p>
  </section>

  <section id="how-to-add-missing-content-rating-information">
    <title>Come aggiungere informazioni mancanti sulla classificazione per età</title>
    <p>Le informazioni sulla classificazione per età di un'applicazione sono contenute nell'elemento <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-content_rating"><code>&lt;content_rating&gt;</code></link> all'interno dell'elemento <code>&lt;component&gt;</code> nel suo file metainfo.</p>
    <p>Per compilare questo elemento, le applicazioni devono utilizzare lo standard OARS 1.1. Se l'elemento <code>&lt;content_rating&gt;</code> non è specificato, la classificazione dei contenuti dell'applicazione è sconosciuta. Se è specificato ma è vuoto, significa che l'applicazione non ha contenuti che potrebbero essere inadatti a qualsiasi tipo di pubblico.</p>
    <p>Per produrre informazioni sulla classificazione per età adatte a un'applicazione, usare <link href="https://hughsie.github.io/oars/">il generatore OARS</link>.</p>
  </section>

  <section id="how-to-fix-incorrect-licensing-information">
    <title>Come correggere informazioni errate sulla licenza</title>
    <p>Le informazioni sulla licenza di un'applicazione sono contenute nell'elemento <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-project_license"><code>&lt;project_license&gt;</code></link> all'interno dell'elemento <code>&lt;component&gt;</code> nel suo file metainfo.</p>
    <p>Il contenuto di questo elemento deve essere un'espressione SPDX che descrive la licenza “principale” del progetto. In genere, dovrebbe trattarsi della licenza del codice, senza includere la licenza della documentazione o dei contenuti accessori.</p>
    <p>Se l'espressione SPDX è una licenza singola o una disgiunzione inclusiva di più licenze, tutte <link href="https://spdx.org/licenses/">approvate dalla FSF o dall'OSI</link>, l'applicazione è considerata “software libero” e il riquadro della licenza indica questo fatto. In caso contrario, è considerata “proprietaria”.</p>
    <p>Se un'applicazione viene visualizzata come “proprietaria” quando si ritiene che non dovrebbe esserlo, è probabile che l'elemento <code>&lt;project_license&gt;</code> includa la licenza della documentazione per il progetto. Rimuoverlo.</p>
    <p><link href="https://gitlab.gnome.org/GNOME/meld/-/issues/579">Per esempio</link>, cambiare i metadati della licenza da:</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>Ulteriori approfondimenti:</p>
    <list>
      <item>
	<p><link href="https://tecnocode.co.uk/2021/07/05/dont-generally-put-cc-by-sa-in-appdata/">Non inserire (in generale) la licenza della documentazione negli appdata</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>Come aggiungere collegamenti mancanti</title>
    <p>I collegamenti per un'applicazione sono contenuti negli elementi <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-url"><code>&lt;url&gt;</code></link> all'interno dell'elemento <code>&lt;component&gt;</code> nel suo file metainfo.</p>
    <p>Aggiungere tutti i tipi di collegamento documentati nelle <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-url">specifiche appstream</link> disponibili per l'applicazione. Se non esiste una pagina adatta ad un determinato tipo di collegamento, non è necessario includerlo.</p>
    <p>Per esempio, ecco i collegamenti alle risorse per l'applicazione <app>Software</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>Come impostare il colore di sfondo per il riquadro del carosello</title>
    <p>Normalmente il colore di sfondo del riquadro del carosello viene estratto automaticamente dall'icona dell'applicazione. Se tale colore non è soddisfacente, tuttavia, è possibile sovrascriverlo utilizzando l'elemento <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-branding"> <code>&lt;branding/&gt;</code> di appstream</link> con i colori dichiarati (a partire dalla serie 47.x). Il vantaggio è che un numero maggiore di client può utilizzare i colori.</p>
    <p>Ecco alcune voci di «branding»:</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>Notare che l'attributo <code>scheme_preference</code> viene ignorato, <app>Software</app> sceglie autonomamente il miglior colore per il tema.</p>
    </note>
    <p>Per garantire la retrocompatibilità, rimane la possibilità di aggiungere il seguente codice XML all'elemento <code>&lt;component&gt;</code> del metainfo dell'applicazione:</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>ma l'elemento <code>&lt;branding/&gt;</code> mantiene la precedenza.</p>
    <p>Il valore di <code>GnomeSoftware::key-colors</code> è un GVariant in formato testo con tipo <code>a(yyy)</code>, e rappresenta un insieme non ordinato di colori chiave per l'applicazione. Ciascun elemento dell'insieme è un colore in formato RGB nell'intervallo da <code>(0, 0, 0)</code> a <code>(255, 255, 255)</code>.</p>
    <p>I colori dovrebbero essere scelti in modo che:</p>
    <list>
      <item>
	<p>Siano associabili all'applicazione, corrispondendo in qualche modo, se possibile, al suo marchio.</p>
      </item>
      <item>
	<p>Contrastino con il bordo dell'icona dell'applicazione, in modo che quando vengono utilizzati come sfondo dietro di essa l'icona rimanga ben distinta.</p>
      </item>
      <item>
	<p>Contrastino con il colore del testo in primo piano del tema Adwaita (<code>#2e3436</code>) e con la sua variante scura (<code>#eeeeec</code>). Questo significa in generale scegliere un colore con un livello di luminosità medio.</p>
      </item>
      <item>
	<p>Il contrasto può essere controllato usando l'applicazione <link href="https://flathub.org/apps/org.gnome.design.Contrast/">Contrasto</link>.</p>
      </item>
    </list>
    <p>È necessario specificare almeno un colore. È possibile specificarne più di uno se un solo colore non soddisfa tutti i requisiti sopra indicati, in tal caso <app>Software</app> sceglierà quello più appropriato da utilizzare nel riquadro carosello. Se viene specificato un solo colore, la sua luminosità e la sua saturazione potrebbero venire modificate per migliorare il contrasto con il colore di primo piano. Se vengono specificati più colori, verrà scelto quello con il miglior contrasto con il colore di primo piano, e la sua luminosità e saturazione non verranno modificate.</p>
  </section>

  <section id="how-to-test-carousel-tile-background-colour-changes">
    <title>Come verificare i cambiamenti al colore di sfondo del riquadro del carosello</title>
    <p>Modificare il file metainfo della propria applicazione, quindi lanciare <app>Software</app> con:</p>
    <p><cmd>gnome-software --show-metainfo=<var>/posizione/del/file/app.metainfo.xml</var>,icon=<var>/posizione/del/file/icona-applicazione.png</var></cmd></p>
    <p>Verrà visualizzata la pagina dei dettagli della propria applicazione. Se si torna alla panoramica di <app>Software</app>, la propria applicazione sarà l'unica presente nel carosello “in primo piano”.</p>
  </section>


</page>
