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

  <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>Hur <app>Programvara</app> använder metadata</desc>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Anders Jonsson</mal:name>
      <mal:email>anders.jonsson@norsjovallen.se</mal:email>
      <mal:years>2024</mal:years>
    </mal:credit>
  </info>

  <title>Metadata för program</title>
  <links type="section"/>

  <section id="screenshots">
    <title>Skärmbilder</title>
    <media type="image" src="figures/app-screenshot.png" style="floatend floatright" mime="image/png" its:translate="no"/>
    <p><app>Programvara</app> visar skärmbilderna på detaljsidan för ett program. Detta ska typiskt inkludera skärmbilder för diverse fönster / dialogrutor för programmet, så användaren får en snabb överblick över programmets funktioner, utseende o.s.v.</p>
    <p>När mer än en skärmbild finns i programmets metainfo-fil kommer <app>Programvara</app> visa skärmbilderna i en karusell.</p>
    <p>I fall då programmets metainfo-fil inte innehåller någon skärmbild kommer en platshållarikon visas som nedan med <code>Inga skärmbilder</code>:</p>
    <media type="image" src="figures/scalable/symbolic/image-missing-symbolic.svg" width="96" mime="image/svg" its:translate="no"/>
    <note>
      <p>Platshållarikonen kan se annars ut om du använder ett anpassat ikontema.</p>
    </note>
    <p>Skärmbilder kan bli inaktuella då programmets användargränssnitt ändras. Så även om <app>Programvara</app> visar skärmbilder för ett program så är det viktigt att kontrollera om dessa skärmbilder är uppdaterade eller inaktuella.</p>
    <p>Du kan förbättra skärmbildsinformation för program:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-app-screenshots">Hur du lägger till saknade skärmbilder för program</link></p>
      </item>
    </list>
  </section>

  <section id="app-context-bar">
    <title>Programkontextrad</title>
    <p>Programkontextraden i <app>Programvara</app> är en samling rutor på detaljsidan för ett program, vilka visar följande detaljer.</p>
    <list>
      <item>
	<p><link xref="#storage">Lagring</link></p>
      </item>
      <item>
	<p><link xref="#safety">Säkerhet</link></p>
      </item>
      <item>
	<p><link xref="#hardware-support">Hårdvarustöd</link></p>
      </item>
      <item>
	<p><link xref="#age-rating">Åldersklassificering</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.">Detta visar programkontextraden för programmet <app>Programvara</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.">Rutorna visas i ordningen listad ovan (med start på rutan <code>Lagring</code> till vänster).</p>
    <p>Varje ruta beskrivs i detalj nedan.</p>
  </section>

  <section id="storage">
    <title>Lagring</title>
    <p><app>Programvara</app> visar en lagringsruta på detaljsidan för ett program. Om programmet inte är installerat visar denna den beräknade hämtningsstorleken som behövs för att installera det. Om programmet är installerat visar den lagringsutrymmet som används av programmet.</p>
    <p>Storlekarna beräknas från data som tillhandahålls av bakänden till <app>Programvara</app> (såsom flatpak eller en RPM), och specificeras inte i metadata som tillhandahålls av programmet. Det finns inget du kan göra för att påverka denna ruta genom att redigera ett programs metainfo-fil. Den listas här för fullständighets skull.</p>
  </section>

  <section id="safety">
    <title>Säkerhet</title>
    <p><app>Programvara</app> visar en säkerhetsruta på detaljsidan för ett program. Denna sammanfattar information om huruvida programmet kan anses säkert att installera och köra, eller om varsamhet kan behövas innan du litar på det.</p>
    <p>Denna ruta kombinerar information om rättigheterna som programmet begär när det körs (såsom rättighet att läsa dina filer), med information om hur programmet utvecklats. Fri programvara, där källkoden finns att läsa offentligt, kan vara säkrare än proprietär sådan, eftersom den kan granskas.</p>
    <p>Dialogrutan som dyker upp när rutan klickas på listar de olika rättigheterna som programmet begär, samt viss information om dess licens och exekveringsmiljö.</p>
    <p>Du kan förbättra säkerhetsinformationen:</p>
    <list>
      <item>
	<p><link xref="#how-to-fix-incorrect-safety-and-permissions-information">Hur du fixar felaktig säkerhets- och rättighetsinformation</link></p>
      </item>
    </list>
  </section>

  <section id="hardware-support">
    <title>Hårdvarustöd</title>
    <p><app>Programvara</app> visar en hårdvarustödruta på detaljsidan för ett program. Denna kombinerar information om hårdvarukraven för programmet och datorns hårdvaruförmågor, med målet att belysa ej kompatibla saker eller saknade krav — eller för att indikera att programmet bör fungera korrekt utan några kompatibilitetsproblem.</p>

    <p>Koden tittar på följande hårdvara. Stöd för fler kan läggas till i framtiden.</p>
    <list>
      <item><p>Huruvida en styrplatta, en mus eller ett tangentbord är närvarande/behövs</p></item>
      <item><p>Huruvida en spelkontroll behövs</p></item>
      <item><p>Den minsta och rekommenderade visningsstorleken som programmet kan skalas till</p></item>
    </list>

    <p>Det är inte möjligt att på ett tillförlitligt sätt avgöra huruvida en spelkontroll är <em>närvarande</em>, då de ofta kopplas från för att de inte behövs vid normal datoranvändning.</p>
    <p>Dialogrutan som dyker upp när rutan klickas på listar de olika hårdvarukraven för programmet, samt huruvida något av dem inte uppfylls.</p>
    <p>Du kan förbättra hårdvaruinformationen:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-hardware-information">Hur du lägger till saknad hårdvaruinformation</link></p>
      </item>
    </list>
  </section>

  <section id="age-rating">
    <title>Åldersklassificering</title>
    <p><app>Programvara</app> visar en åldersklassificeringsruta på detaljsidan för ett program. Denna visar vilket åldersintervall programmet bör vara lämpligt för, baserat på olika sorters innehåll som programmet har deklarerat att det innehåller. Denna information sammanfattas i ett format liknande spel- eller filmåldersgränserna för ditt land.</p>
    <p>Detta kommer exempelvisa markera huruvida ett spel innehåller våld, eller huruvida ett program innehåller reklam.</p>
    <p>Dialogrutan som dyker upp när rutan klickas på listar de olika typerna av innehåll i programmet, samt hur grovt det innehållet är.</p>
    <p>Du kan förbättra åldersklassificeringsinformationen:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-content-rating-information">Hur du lägger till saknad innehållsklassificeringsinformation</link></p>
      </item>
    </list>
  </section>

  <section id="license">
    <title>Licens</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>Programvara</app> visar en ruta som indikerar huruvida ett program är <link href="https://en.wikipedia.org/wiki/Free_and_open-source_software">fri programvara</link> eller om dess licens är proprietär, speciell eller okänd. Denna ruta innehåller mer detaljerad information om projektets licens. Denna ruta listar också några av fördelarna med fri programvara. <link xref="software-licensing#introduction">Läs mer</link></p>
    <p>Ibland är licensinformationen inte korrekt för ett program, så ett program som faktiskt är fri programvara kommer visas som ”proprietärt”. På liknande sätt är ibland licensinformationen okänd.</p>
    <p><app>Programvara</app> markerar fria och öppna källkodslicenser i grönt, proprietära och speciella licenser i gult som visas här. Okända licenser markeras grått.</p>
    <p>Du kan lägga till eller förbättra licensinformationen:</p>
    <list>
      <item>
	<p><link xref="#how-to-fix-incorrect-licensing-information">Hur du fixar felaktig licensinformation</link></p>
      </item>
    </list>
  </section>

  <section id="links">
    <title>Länkar</title>
    <media type="image" src="figures/scalable/links.svg" style="floatend floatright" mime="image/svg" its:translate="no"/>
    <p><app>Programvara</app> visar en lista över programresurslänkar i länkrutan. De är följande:</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>Webbplatslänk</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>Donationslänk</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>Länk för att bidra med översättningar</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>Felrapporteringslänk</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>Länk till hjälp</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>Kontaktlänk</p></td>
      </tr>
    </table>
    <p>Några eller alla av dessa länkar kan vara närvarande beroende på huruvida de listas i programmets metainfo-fil.</p>
    <p>I fall där programmets metainfo-fil inte innehåller någon länk så kommer följande ruta med ett frågetecken att visas.</p>
    <media type="image" src="figures/scalable/no-links.svg" style="floatend floatright" mime="image/svg" its:translate="no"/>
    <p>Du kan förbättra länkarna:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-links">Hur du lägger till saknade länkar</link></p>
      </item>
    </list>
  </section>

  <section id="carousel-tile">
    <title>Karusellruta</title>
    <media type="image" src="figures/carousel.png" style="floatend floatright" mime="image/png" its:translate="no"/>
    <p>Program som föreslås av <app>Programvara</app> visas i en karusell högst upp i huvudfönstret, som kan ses här. Varje karusellruta har en bakgrundsfärg som extraheras automatiskt från programmets ikon. Ibland är denna bakgrundsfärg inte riktigt rätt för programmet och behöver anges explicit av programutvecklaren.</p>
    <p>Uppsättningen föreslagna program bestäms av de ansvariga för Linux-distributionen.</p>
    <p>Du kan förbättra karusellrutan:</p>
    <list>
      <item>
	<p><link xref="#how-to-set-the-carousel-tile-background-colour">Hur du ställer in karusellrutans bakgrundsfärg</link></p>
      </item>
    </list>
  </section>

  <section id="where-metadata-comes-from">
    <title>Var metadata kommer från</title>
    <p>Metadata som används för att specificera vilken hårdvara en programvara kräver, vilka åldrars användare den är lämplig för, och faktorer som bidrar till hur säker den kan vara att installera, kommer från metainfo-filen för programvaran.</p>
    <p>metainfo-filen är en XML-fil. Dess filformat anges i <link href="https://www.freedesktop.org/software/appstream/docs/">AppStream-specifikationen</link>.</p>
    <p>Se <link href="https://gitlab.gnome.org/GNOME/nautilus/-/blob/main/data/org.gnome.Nautilus.metainfo.xml.in.in">metainfo-filen för programmet GNOME Filer</link>.</p>
    <note style="tip">
      <p><em>appdata</em> är den tidigare termen för <em>metainfo</em>.</p>
    </note>
  </section>

  <section id="what-happens-if-metadata-is-missing">
    <title>Vad händer om metadata saknas</title>
    <p>Om några metadata saknas för ett program kan <app>Programvara</app> bara gissa vad de borde vara, och kan därför inte presentera mycket information i sina gränssnitt. Gissningarna som <app>Programvara</app> gör baseras på faktum att den mesta programvara designas för skrivbordsdatorer.</p>
    <p><em style="strong">Du kan hjälpa till att förbättra metadata för ett program!</em></p>
  </section>

  <section id="how-to-contribute-missing-information">
    <title>Hur du bidrar med saknad information</title>
    <p>Om du upptäcker att ett programs sida saknar information eller innehåller felaktig information så kan du bidra på ett av följande två sätt:</p>
    <list type="numbered">
      <item>
	<p>Du kan rapportera saknade / felaktiga metadata till respektive programs felhanteringssystem, så programmets utvecklare kan fixa det.</p>
      </item>
      <item>
	<p>Du kan fixa saknade / felaktiga metadata själv. Se <em style="strong">guiden</em> nedan för att lära dig hur.</p>
      </item>
    </list>

    <p>För båda behöver du först hitta programmets projektsida. Länken till projektsidan bör typiskt finnas på programmets sida <link xref="#links">som visas här</link>. Om inte kommer du behöva hitta den med en enkel Google-sökning.</p>

    <p>Program lagras typiskt på <link href="https://gitlab.com/explore?sort=stars_desc">GitLab</link> eller <link href="https://github.com/explore">GitHub</link>. Exempelvis lagras GNOME-program på <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>Hur du lägger till saknade skärmbilder för program</title>
    <p>Skärmbildsinformationen för ett program lagras i <link href="https://www.freedesktop.org/software/appstream/docs/sect-Metadata-Application.html#tag-dapp-screenshots"><code>&lt;screenshots&gt;</code></link>-elementet i programmets <code>&lt;component&gt;</code> i dess metainfo-fil.</p>
    <p>Rekommenderat antal skärmbilder för ett program är mellan 5 och 10. Skärmbilder ska idealiskt vara i formatet PNG med bildförhållandet 16:9 och en minsta bredd på 620 bildpunkter.</p>
    <p>Här är exempelvis skärmbildsposterna för programmet <app>Programvara</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>Hur du fixar felaktig säkerhets- och rättighetsinformation</title>
    <p>Säkerhets- och rättighetsinformation för ett program kommer från olika källor beroende på hur programmet paketeras. För traditionellt paketerade program, exempelvis i RPM- eller DEB-format, så finns det ingen säkerhets- och rättighetsinformation tillgänglig och inget kan göras för att lägga till den till ett program.</p>
    <p>För flatpak-program kommer informationen från programmets <link href="https://docs.flatpak.org/en/latest/manifests.html">flatpak-manifest</link>, vilket anger vilka hål i sandlådan som programmet kräver. Vart och ett av dess hål bidrar typiskt till att sänka den visade säkerhetsnivån för programmet i <app>Programvara</app> — och flyttar det från ”säkert” till ”potentiellt osäkert” eller ”osäkert”.</p>
    <p>För att förbättra säkerhetsnivån för ett program behöver dess sandlåda göras så trång som möjligt genom att ta bort <link href="https://docs.flatpak.org/en/latest/sandbox-permissions.html">sandlåderättigheter</link> där de inte behövs, och använda <link href="https://docs.flatpak.org/en/latest/desktop-integration.html#portals">portaler</link> i stället för sandlåderättigheter där möjligt. Användning av portaler sänker inte den visade säkerhetsnivån för ett program i <app>Programvara</app>.</p>
    <p>Om programmet exempelvis begär läs/skrivåtkomst till hela filsystemet (<code>--filesystem=host</code>), behöver det verkligen det, eller behöver det bara komma åt filer på några få specifika platser? Om så är fallet skulle <link href="https://docs.flatpak.org/en/latest/desktop-integration.html#portals">filportalen</link> kunna användas, eller så skulle mer specifika <link href="https://docs.flatpak.org/en/latest/sandbox-permissions.html#filesystem-access">filsystemsrättigheter</link> kunna användas.</p>
    <p>Om programmet fungerar i Wayland, och bara behöver fungera i X11 som en reserv, utan att använda speciella X11-funktioner, skulle det kanske kunna använda <code>--socket=fallback-x11</code> snarare än <code>--socket=x11</code>?</p>
    <p>Guider kring specifika rättigheter eller andra paketformat kan läggas till här i framtiden.</p>
    <p>Vidare läsning:</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>Hur du lägger till saknad hårdvaruinformation</title>
    <p>Hårdvaruinformationen för ett program lagras i <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-relations"><code>&lt;requires&gt;</code>-, <code>&lt;recommends&gt;</code>- och <code>&lt;supports&gt;</code></link>-element i programmets <code>&lt;component&gt;</code> i dess metainfo-fil.</p>
    <p><app>Programvara</app> förstår elementen <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-relations-control"><code>&lt;control&gt;</code></link> och <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>Se <link href="https://tecnocode.co.uk/2021/07/12/add-metadata-to-your-app-to-say-what-inputs-and-display-sizes-it-supports/">den här bloggposten</link> eller <link href="https://blogs.gnome.org/tbernard/2021/09/07/ready-for-software-41/#device-support">den här bloggposten</link> för exempel på metadata.</p>
  </section>

  <section id="how-to-add-missing-content-rating-information">
    <title>Hur du lägger till saknad innehållsklassificeringsinformation</title>
    <p>Innehållsklassificeringsinformationen för ett program lagras i <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-content_rating"><code>&lt;content_rating&gt;</code></link>-elementet i programmets <code>&lt;component&gt;</code> i dess metainfo-fil.</p>
    <p>Program bör använda OARS 1.1-standarden för att fylla i detta element. Om <code>&lt;content_rating&gt;</code>-elementet inte angivits så är programmets innehållsklassificering okänd. Om det angivits men är tomt så har programmet inte något innehåll som skulle kunna vara olämpligt för någon publik.</p>
    <p>Använd <link href="https://hughsie.github.io/oars/">OARS-generatorn</link> för att producera lämplig innehållsklassificeringsinformation för ett program.</p>
  </section>

  <section id="how-to-fix-incorrect-licensing-information">
    <title>Hur du fixar felaktig licensinformation</title>
    <p>Licensinformationen för ett program lagras i <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-project_license"><code>&lt;project_license&gt;</code></link>-elementet i programmets <code>&lt;component&gt;</code> i dess metainfo-fil.</p>
    <p>Innehållet i detta element ska vara ett <link href="https://spdx.org/specifications">SPDX-uttryck</link> som beskriver den ”huvudsakliga” licensen för projektet. Detta ska typiskt vara licensen för koden, och inte inkludera licensen för dokumentationen eller sekundärt innehåll.</p>
    <p>Om SPDX-uttrycket är en ensam licens, eller en ”or”-kombination av flera licenser, vilka alla är <link href="https://spdx.org/licenses/">godkända av FSF eller OSI</link>, så anses programmet vara ”fri programvara” och licensrutan säger det. Annars anses det vara ”proprietärt”.</p>
    <p>Om ett program visas som ”proprietärt” trots att du tycker det inte borde vara det så är det troligt att <code>&lt;project_license&gt;</code>-elementet inkluderar licensen för projektets dokumentation. Ta bort den.</p>
    <p><link href="https://gitlab.gnome.org/GNOME/meld/-/issues/579">Till exempel</link>, ändra licensmetadata från:</p>
    <code its:translate="no" mime="application/xml"><![CDATA[<project_license>GPL-2.0+ and CC-BY-SA-3.0</project_license>]]></code>
    <p>till</p>
    <code its:translate="no" mime="application/xml"><![CDATA[<project_license>GPL-2.0+</project_license>]]></code>
    <p>Vidare läsning:</p>
    <list>
      <item>
	<p><link href="https://tecnocode.co.uk/2021/07/05/dont-generally-put-cc-by-sa-in-appdata/">Sätt (allmänt) inte dokumentationslicensen i 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>Hur du lägger till saknade länkar</title>
    <p>Länkarna för ett program lagras som <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-url"><code>&lt;url&gt;</code></link>-element i programmets <code>&lt;component&gt;</code> i dess metainfo-fil.</p>
    <p>Lägg till så många av länktyperna dokumenterade i <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-url">appstream-specifikationen</link> som finns tillgängliga för programmet. Om ingen lämplig sida finns för en viss länktyp så behöver den inte inkluderas.</p>
    <p>Här är exempelvis resurslänkarna för programmet <app>Programvara</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>Hur du ställer in karusellrutans bakgrundsfärg</title>
    <p>Karusellrutans bakgrundsfärg extraheras vanligen automatiskt från programmets ikon. Om den färgen inte är till belåtenhet kan den dock åsidosättas genom att använda <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-branding">appstreams <code>&lt;branding/&gt;</code>-element</link> med deklarerade färger (sedan 47.x-serien). Fördelen är att fler klienter kan använda färgerna.</p>
    <p>Här är exempelvis några branding-poster:</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>Observera att attributet <code>scheme_preference</code> ignoreras, <app>Programvara</app> väljer själv den bästa färgen för temat.</p>
    </note>
    <p>För bakåtkompatibilitet finns möjligheten kvar att lägga till följande XML till programmets <code>&lt;component&gt;</code>-element i metainfo:</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>men <code>&lt;branding/&gt;</code>-elementet har prioritet.</p>
    <p>Värdet på <code>GnomeSoftware::key-colors</code> är en GVariant av textformat med typ <code>a(yyy)</code>, och representerar en oordnad mängd nyckelfärger för programmet. Varje element i mängden är en färg i RGB-format i intervallet <code>(0, 0, 0)</code> till <code>(255, 255, 255)</code>.</p>
    <p>Färger ska väljas så att de:</p>
    <list>
      <item>
	<p>Är identifierbara till programmet, matchande programmets färgtema på något sätt om möjligt.</p>
      </item>
      <item>
	<p>Har kontrast med kanten på programmets ikon, så att när de används som en bakgrund bakom ikonen så kan ikonen urskiljas.</p>
      </item>
      <item>
	<p>Har kontrast med förgrundstextfärgen i Adwaita-temat (<code>#2e3436</code>) och i dess mörka variant (<code>#eeeeec</code>). Detta betyder generellt att välja en färg med en medelnivå av ljushet.</p>
      </item>
      <item>
	<p>Kontrast kan kontrolleras med <link href="https://flathub.org/apps/org.gnome.design.Contrast/">programmet Kontrast</link>.</p>
      </item>
    </list>
    <p>Minst en färg bör anges. Fler kan anges om inte en färg kan uppfylla alla kraven ovan, så kommer <app>Programvara</app> välja den lämpligaste att använda i karusellrutan. Om exakt en färg anges kan dess ljusstyrka och mättnad modifieras för att förbättra kontrast mot förgrundsfärgen. Om mer än en färg anges kommer den med bäst kontrast mot förgrundsfärgen att väljas, och dess ljusstyrka och mättnad kommer inte modifieras.</p>
  </section>

  <section id="how-to-test-carousel-tile-background-colour-changes">
    <title>Hur du testar ändringar i karusellrutans bakgrundsfärg</title>
    <p>Modifiera metainfo-filen för ditt program, och kör sedan <app>Programvara</app> med:</p>
    <p><cmd>gnome-software --show-metainfo=<var>/sökväg/till/app.metainfo.xml</var>,icon=<var>/sökväg/till/programmets/ikon.png</var></cmd></p>
    <p>Detaljsidan för ditt program kommer visas. Om du navigerar tillbaka till översiktssidan för <app>Programvara</app> kommer ditt program vara det enda i karusellen ”i blickfånget”.</p>
  </section>


</page>
