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

  <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>Hvordan <app>Software</app> bruger metadata</desc>
  </info>

  <title>Softwaremetadata</title>
  <links type="section"/>

  <section id="screenshots">
    <title>Skærmbilleder</title>
    <media type="image" src="figures/app-screenshot.png" style="floatend floatright" mime="image/png" its:translate="no"/>
    <p><app>Software</app> viser skærmbilleder på detaljesiden for et program. Dette bør typisk omfatte skærmbilleder af forskellige vinduer/dialogbokse i programmet, så brugeren hurtigt kan danne sig et overblik over programmets funktioner, udseende og funktionalitet osv.</p>
    <p>Når der er mere end ét skærmbillede i programmets metainfofil, viser <app>Software</app> skærmbillederne i en karrusel.</p>
    <p>I tilfælde hvor programmets metainfofil ikke indeholder noget skærmbillede, vises et erstatningsikon som nedenfor med <code>Ingen skærmbilleder</code>:</p>
    <media type="image" src="figures/scalable/symbolic/image-missing-symbolic.svg" width="96" mime="image/svg" its:translate="no"/>
    <note>
      <p>Erstatningsikonet kan se anderledes ud, hvis du amvender et brugerdefineret ikontema.</p>
    </note>
    <p>Skærmbilleder kan blive forældede, når programmets brugergrænseflade ændres. Så selvom <app>Software</app> viser skærmbilleder for et program, er det vigtigt at kontrollere, om disse skærmbilleder er opdaterede eller forældede.</p>
    <p>Du kan forbedre programmets skærmbilledoplysninger:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-app-screenshots">Sådan tilføjes manglende programskærmbilleder</link></p>
      </item>
    </list>
  </section>

  <section id="app-context-bar">
    <title>Programmets kontekstbjælke</title>
    <p>Programmets kontekstbjælke i <app>Software</app> er en samling fliser på programmets detaljeside, som viser følgende detaljer.</p>
    <list>
      <item>
	<p><link xref="#storage">Lager</link></p>
      </item>
      <item>
	<p><link xref="#safety">Sikkerhed</link></p>
      </item>
      <item>
	<p><link xref="#hardware-support">Understøttelse af hardware</link></p>
      </item>
      <item>
	<p><link xref="#age-rating">Aldersvurdering</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.">Dette viser programmets kontekstbjælke for programmet <app>Software</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.">Fliserne vises i ovenstående rækkefølge (startende med flisen <code>Lager</code> til venstre).</p>
    <p>Hver flise er beskrevet i detaljer nedenfor.</p>
  </section>

  <section id="storage">
    <title>Lager</title>
    <p><app>Software</app> viser en lagerflise på et programs detaljeside. Hvis programmet ikke er installeret, vises den anslåede downloadstørrelse, der er nødvendig for at installere den. Hvis programmet er installeret, vises den lagerplads, som programmet bruger.</p>
    <p>Størrelserne beregnes ud fra data fra <app>Software</app>-backend (f.eks. flatpak eller RPM) og er ikke angivet i de metadata, der leveres af programmet. Du kan ikke ændre denne flise ved at redigere et programs metainfofil. Den er angivet her for fuldstændighedens skyld.</p>
  </section>

  <section id="safety">
    <title>Sikkerhed</title>
    <p><app>Software</app> viser en sikkerhedsflise på et programs detaljeside. Denne opsummerer oplysninger om, hvorvidt programmet kan betragtes som sikkert at installere og køre, eller om der er grund til at udvise forsigtighed, før man stoler på det.</p>
    <p>Denne flise kombinerer oplysninger om de tilladelser, som programmet anmoder om, når det kører (f.eks. tilladelse til at læse dine filer), med oplysninger om, hvordan programmet er udviklet. Frie softwareprogrammer, hvor kildekoden er offentligt tilgængelig, kan være mere sikre end proprietære programmer, da de kan undersøges.</p>
    <p>Den dialog, der vises, når du klikker på flisen, viser de forskellige tilladelser, som programmer anmoder om, samt nogle oplysninger om dets licens og kørselstid.</p>
    <p>Du kan forbedre sikkerhedsoplysningerne:</p>
    <list>
      <item>
	<p><link xref="#how-to-fix-incorrect-safety-and-permissions-information">Sådan rettes forkerte oplysninger om sikkerhed og tilladelser</link></p>
      </item>
    </list>
  </section>

  <section id="hardware-support">
    <title>Understøttelse af hardware</title>
    <p><app>Software</app> viser en flise med hardwareunderstøttelse på et programs detaljeside. Denne flise kombinerer oplysninger om programmets hardwarekrav og computerens hardwarefunktioner med det formål at fremhæve inkompatibilitet eller manglende krav — eller for at angive, at programmet bør fungere korrekt uden inkompatibiliteter.</p>

    <p>Koden leder efter følgende hardware. Understøttelse af mere kan ske i fremtiden.</p>
    <list>
      <item><p>Om en pegeplade, mus eller tastatur er til stede/nødvendig</p></item>
      <item><p>Om en gamepad er nødvendig</p></item>
      <item><p>Den mindste og anbefalede skærmstørrelse programmet kan skaleres til</p></item>
    </list>

    <p>Det er ikke muligt at registrere pålideligt, om en gamepad er <em>til stede</em>, da de ofte er frakoblede, fordi de ikke er nødvendige til normal brug af computeren.</p>
    <p>Dialogen, der vises, når du klikker på flisen, viser programmets forskellige hardwarekrav og angiver, om nogle af dem ikke er opfyldt.</p>
    <p>Du kan forbedre oplysningerne om hardware:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-hardware-information">Sådan tilføjes manglende oplysninger om hardware</link></p>
      </item>
    </list>
  </section>

  <section id="age-rating">
    <title>Aldersvurdering</title>
    <p><app>Software</app> viser en flise indeholdende aldersvurdering på programmets detaljeside. Denne viser, hvilken aldersgruppe programmet er egnet til, baseret på de forskellige typer indhold, som programmet har angivet at indeholde. Disse oplysninger er sammenfattet i et format, der ligner de spil- eller filmklassificeringscertifikater, der findes i dit land.</p>
    <p>Dette vil f.eks. fremhæve, om et spil indeholder vold, eller om et program indeholder reklamer i appen.</p>
    <p>Dialogen, der vises, når du klikker på flisen, viser de forskellige typer indhold i programmet, og hvor alvorligt dette indhold er.</p>
    <p>Du kan forbedre oplysningerne om aldersvurdering:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-content-rating-information">Sådan tilføjes oplysninger om indholdsvurdering</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>Software</app> viser en flise, der angiver, om et program er <link href="https://https://da.wikipedia.org/wiki/Free/Libre_and_Open_Source_Software">fri software</link>, eller om dets licens er proprietær, speciel eller ukendt. Denne flise indeholder mere detaljerede oplysninger om projektets licens. Flisen viser også nogle af fordelene ved fri software. <link xref="software-licensing#introduction">Læs mere her</link>.</p>
    <p>Nogle gange er licensoplysningerne ikke korrekte for et program, og derfor vil et program, der faktisk er fri software, blive vist som “proprietært”. Tilsvarende er licensoplysningerne nogle gange ukendte.</p>
    <p><app>Software</app> fremhæver licenser for programmer, der er frie og open source med grønt, og proprietære og specielle licenser med gult, som vist her. Ukendte licenser fremhæves med gråt.</p>
    <p>Du kan tilføje eller forbedre licensoplysningerne:</p>
    <list>
      <item>
	<p><link xref="#how-to-fix-incorrect-licensing-information">Sådan rettes forkerte licensoplysninger</link></p>
      </item>
    </list>
  </section>

  <section id="links">
    <title>Links</title>
    <media type="image" src="figures/scalable/links.svg" style="floatend floatright" mime="image/svg" its:translate="no"/>
    <p><app>Software</app> viser en liste over links til applikationsressourcer i linkflisen. De er som følger:</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>Webstedslink</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>Donationslink</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>Oversættelsesbidragslink</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>Fejlrapporteringslink</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>Hjælpelink</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>Kontaktlink</p></td>
      </tr>
    </table>
    <p>Nogle eller alle disse links kan være til stede, afhængigt af om de er angivet i programmets metainfofil.</p>
    <p>I tilfælde, hvor programmets metainfofil ikke indeholder noget link, vises følgende flise med et spørgsmålstegn.</p>
    <media type="image" src="figures/scalable/no-links.svg" style="floatend floatright" mime="image/svg" its:translate="no"/>
    <p>Du kan forbedre linksene:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-links">Sådan tilføjes manglende links</link></p>
      </item>
    </list>
  </section>

  <section id="carousel-tile">
    <title>Karruselflise</title>
    <media type="image" src="figures/carousel.png" style="floatend floatright" mime="image/png" its:translate="no"/>
    <p>Programmer, der er udvalgt af <app>Software</app>, vises i en karrusel øverst i hovedvinduet, som vist her. Hver karruselflise har en baggrundsfarve, der automatisk udtrækkes fra programmets ikon. Nogle gange passer denne baggrundsfarve ikke helt til programmet og skal derfor angives eksplicit af programmets udvikler.</p>
    <p>Det sæt programmer, der vises, bestemmes af Linux-distributionsadministratorerne.</p>
    <p>Du kan forbedre karruselflisen:</p>
    <list>
      <item>
	<p><link xref="#how-to-set-the-carousel-tile-background-colour">Sådan indstilles karruselflisens baggrundsfarve</link></p>
      </item>
    </list>
  </section>

  <section id="where-metadata-comes-from">
    <title>Hvor kommer metadata fra?</title>
    <p>Metadataene, der bruges til at angive, hvilken hardware et stykke software kræver, hvilken aldersgruppe det er egnet til, og faktorer, der bidrager til, hvor sikkert det er at installere, kommer alle fra metainfofilen for den pågældende software.</p>
    <p>Metainfofilen er en XML-fil. Dens filformat er specificeret 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">metainfofilen for GNOME Filer</link>.</p>
    <note style="tip">
      <p><em>appdata</em> er en ældre betegnelse for <em>metainfo</em>.</p>
    </note>
  </section>

  <section id="what-happens-if-metadata-is-missing">
    <title>Hvad sker der, hvis metadata mangler?</title>
    <p>Hvis nogle metadata mangler for et program, kan <app>Software</app> kun gætte på, hvad det kan være, og kan derfor ikke præsentere meget information i sine grænseflader. De gæt, som <app>Software</app> foretager, er baseret på det faktum, at de fleste programmer er designet til skrivebordscomputere.</p>
    <p><em style="strong">Du kan hjælpe med at forbedre et programs metadata!</em></p>
  </section>

  <section id="how-to-contribute-missing-information">
    <title>Bidrag med manglende information</title>
    <p>Hvis du opdager, at et programs side mangler oplysninger eller indeholder forkerte oplysninger, kan du bidrage på en af to måder:</p>
    <list type="numbered">
      <item>
	<p>Du kan rapportere de manglende/forkerte metadata til det pågældende programs fejlsporingssystem, så udvikleren kan rette fejlen.</p>
      </item>
      <item>
	<p>Du kan selv rette de manglende/forkerte metadata. Se vejledningen <em style="strong">Sådan gør du</em> nedenfor for at se, hvordan du gør.</p>
      </item>
    </list>

    <p>I begge tilfælde skal du først finde programmets projektside. Linket til projektsiden skal normalt være tilgængeligt på programmets side <link xref="#links">som vist her</link>. Hvis ikke, skal du finde det ved hjælp af en simpel søgning f.eks. med brug af en søgemaskine som Qwant eller Ecosia.</p>

    <p>Programmer har typisk hjemme hos <link href="https://gitlab.com/explore?sort=stars_desc">GitLab</link> eller <link href="https://github.com/explore">GitHub</link>. GNOME-programmer ligger for eksempel 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>Sådan tilføjes manglende programskærmbilleder</title>
    <p>Skærmbilledoplysningerne for et program gemmes i elementet <link href="https://www.freedesktop.org/software/appstream/docs/sect-Metadata-Application.html#tag-dapp-screenshots"><code>&lt;screenshots&gt;</code></link> inden for programmets <code>&lt;component&gt;</code> i dets metainfofil.</p>
    <p>Det anbefalede antal skærmbilleder for et program er mellem 5 og 10. Skærmbilleder bør helst være i PNG-formatet med højde-breddeforholdet 16:9 og en minimumsbredde på 620 pixels.</p>
    <p>Her er for eksempel skærmbillederne for programmet <app>Software</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>Sådan rettes forkerte oplysninger om sikkerhed og tilladelser</title>
    <p>Oplysninger om sikkerhed og tilladelser for et program kommer fra forskellige kilder, afhængigt af hvordan programmet distribueres. For traditionelt distribuerede programmer, f.eks. i RPM- eller DEB-format, findes der ingen sikkerheds- eller tilladelsesoplysninger, og der kan ikke gøres noget for at tilføje dem til et program.</p>
    <p>For flatpak-programmer kommer oplysningerne fra programmets <link href="https://docs.flatpak.org/en/latest/manifests.html">flatpak-manifest</link>, der angiver, hvilke huller i sandkassen programmet kræver. Hvert af disse huller bidrager typisk til at sænke det viste sikkerhedsniveau for programmet i <app>Software</app> — fra “sikker” til “potentielt usikker” til “usikker”.</p>
    <p>For at forbedre sikkerhedsniveauet for et program skal dets sandkassetilstand gøres så streng som muligt ved at fjerne <link href="https://docs.flatpak.org/en/latest/sandbox-permissions.html ">sandkassetilladelser</link>, hvor de ikke er nødvendige, og ved at bruge <link href="https://docs.flatpak.org/en/latest/desktop-integration.html#portals">portaler</link> i stedet for sandkassetilladelser, hvor det er muligt. Brug af portaler sænker ikke det viste sikkerhedsniveau for et program i <app>Software</app>.</p>
    <p>Hvis programmet f.eks. anmoder om læse-/skriveadgang til hele filsystemet (<code>--filesystem=host</code>), har den så virkelig brug for det, eller behøver den kun at få adgang til filer på nogle få specifikke steder? I så fald kan <link href="https://docs.flatpak.org/en/latest/desktop-integration.html#portals">filportalen</link> bruges, eller der kan angives mere specifikke <link href="https://docs.flatpak.org/en/latest/sandbox-permissions.html#filesystem-access">filsystemtilladelser</link>.</p>
    <p>Hvis programmet fungerer på Wayland og kun skal fungere på X11 i nødstilfælde uden at bruge specielle X11-funktioner, kan den så bruge <code>--socket=fallback-x11</code> i stedet for <code>--socket=x11</code>?</p>
    <p>Vejledning om specifikke tilladelser eller andre pakkeformater kan blive tilføjet her i fremtiden.</p>
    <p>Yderligere læsestof:</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>Sådan tilføjes manglende oplysninger om hardware</title>
    <p>Hardwareoplysningerne for et program gemmes i elementerne <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-relations"><code>&lt;requires&gt;</code>, <code>&lt;recommends&gt;</code> og <code>&lt;supports&gt; </code></link> i programmets <code>&lt;component&gt;</code> i dets metainfofil.</p>
    <p><app>Software</app> forstår elementerne <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-relations-control"><code>&lt;control&gt; </code></link> og <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>Du kan finde eksempler på metadata i <link href="https://tecnocode.co.uk/2021/07/12/add-metadata-to-your-app-to-say-what-inputs-and-display-sizes-it-supports/">dette blogindlæg</link> eller <link href="https://blogs.gnome.org/tbernard/2021/09/07/ready-for-software-41/#device-support">dette blogindlæg</link>.</p>
  </section>

  <section id="how-to-add-missing-content-rating-information">
    <title>Sådan tilføjes oplysninger om indholdsvurdering</title>
    <p>Oplysningerne om indholdsvurdering for et program gemmes i elementet <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-content_rating"><code>&lt;content_rating&gt;</code></link> inden for programmets <code>&lt;component&gt;</code> i dets metainfofil.</p>
    <p>Programmer bør bruge OARS 1.1-standarden til at udfylde dette element. Hvis elementet <code>&lt;content_rating&gt;</code> ikke er angivet, er programmets indholdsvurdering ukendt. Hvis det er angivet, men tomt, har applikationen ikke noget indhold, der kan være uegnet for nogen målgruppe.</p>
    <p>Brug <link href="https://hughsie.github.io/oars/">OARS-generatoren</link> til at generere passende indholdsvurderingsoplysninger til et program.</p>
  </section>

  <section id="how-to-fix-incorrect-licensing-information">
    <title>Sådan rettes forkerte licensoplysninger</title>
    <p>Et programs licensoplysninger gemmes i elementet <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-project_license">&lt;project_license&gt;</link> inden for programmets <code>&lt;component&gt;</code> i dets metainfofil.</p>
    <p>Indholdet i dette element skal være et <link href="https://spdx.org/specifications">SPDX-udtryk</link>, der beskriver projektets “hovedlicens”. Dette bør typisk være kildekodens licens og må ikke omfatte licensen for dokumentationen eller supplerende indhold.</p>
    <p>Hvis SPDX-udtrykket er en enkelt licens eller en “eller”-kombination af flere licenser, som alle er <link href="https://spdx.org/licenses/">godkendt af FSF eller OSI</link>, betragtes programmet som “fri software”, og det fremgår af licensflisen. I modsat fald betragtes det som “proprietært”.</p>
    <p>Hvis et program vises som “proprietært”, selvom du mener, det ikke burde være det, er det sandsynligt, at elementet <code>&lt;project_license&gt;</code> indeholder projektets dokumentationslicens. Fjern det.</p>
    <p>Ændr <link href="https://gitlab.gnome.org/GNOME/meld/-/issues/579">for eksempel</link> licensmetadata fra:</p>
    <code its:translate="no" mime="application/xml"><![CDATA[<project_license>GPL-2.0+ and CC-BY-SA-3.0</project_license>]]></code>
    <p>til</p>
    <code its:translate="no" mime="application/xml"><![CDATA[<project_license>GPL-2.0+</project_license>]]></code>
    <p>Yderligere læsestof:</p>
    <list>
      <item>
	<p><link href="https://tecnocode.co.uk/2021/07/05/dont-generally-put-cc-by-sa-in-appdata/">Du bør (generelt) ikke placere 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>Sådan tilføjes manglende links</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>Tilføj så mange af de linktyper, der er beskrevet i <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-url">appstream-specifikationen</link>, som findes til programmet. Hvis der ikke findes en passende side til en given linktype, behøver den ikke at blive medtaget.</p>
    <p>Her er for eksempel links til ressourcerne for programmet <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>Sådan indstilles karruselflisens baggrundsfarve</title>
    <p>Karruselflisens baggrundsfarve hentes normalt automatisk fra programmets ikon. Hvis den farve ikke er tilfredsstillende, kan den dog tilsidesættes ved at bruge <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-branding">appstreams <code>&lt;branding/&gt;</code>-element</link> med angivne farver (siden 47.x-serien). Fordelen er, at flere klienter kan bruge farverne.</p>
    <p>Her er nogle eksempler på 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>Bemærk, at attributten <code>scheme_preference</code> ignoreres; <app>Software</app> vælger selv den bedste farve til temaet.</p>
    </note>
    <p>Af hensyn til bagudkompatibilitet er det stadig muligt at tilføje følgende XML til programmets metainfo-<code>&lt;component&gt;</code>-element:</p>
    <code its:translate="no" mime="application/xml"><![CDATA[
<custom>
  <value key="GnomeSoftware::key-colors">[(124, 53, 77), (99, 16, 0)]</value>
</custom>]]></code>
    <p>men <code>&lt;branding/&gt;</code>-elementet har forrang.</p>
    <p>Værdien af <code>GnomeSoftware::key-colors</code> er en GVariant i tekstformat af typen <code>a(yyy)</code>, der repræsenterer en uordnet mængde af tastefarver til programmet. Hvert element i mængden er en farve i RGB-format, der spænder fra <code>(0, 0, 0)</code> til <code>(255, 255, 255)</code>.</p>
    <p>Farver bør vælges så de:</p>
    <list>
      <item>
	<p>Kan genkendes i forbindelse med programmet og om muligt på en eller anden måde matcher programmets branding.</p>
      </item>
      <item>
	<p>Står i kontrast til kanten af programmets ikon, så ikonet kan skelnes, når farverne bruges som baggrund bag det.</p>
      </item>
      <item>
	<p>Står i kontrast til forgrundstekstfarven i Adwaita-temaet (<code>#2e3436</code>) og i dets mørke variant (<code>#eeeeec</code>). Det betyder som regel, at man skal vælge en farve med en middel lysstyrke.</p>
      </item>
      <item>
	<p>Kontrasten kan kontrolleres ved hjælp af programmet <link href="https://flathub.org/apps/org.gnome.design.Contrast/">Contrast</link>.</p>
      </item>
    </list>
    <p>Der skal angives mindst én farve. Der kan angives flere, hvis én farve ikke kan opfylde alle ovenstående krav, og <app>Software</app> vælger den mest passende til brug i karruselflisen. Hvis der angives nøjagtigt én farve, kan dens lysstyrke og mætning ændres for at forbedre kontrasten til forgrundsfarven. Hvis der angives mere end én farve, vælges den med den bedste kontrast til forgrundsfarven, og dens lysstyrke og mætning ændres ikke.</p>
  </section>

  <section id="how-to-test-carousel-tile-background-colour-changes">
    <title>Sådan testes ændringer i karruselflisens baggrundsfarve</title>
    <p>Redigér dit programs metainfofil, og kør derefter <app>Software</app> med:</p>
    <p><cmd>gnome-software --show-metainfo=<var>/sti/til/app.metainfo.xml</var>,icon=<var>/sti/til/app/icon.png</var></cmd></p>
    <p>Dit programs detaljeside vises. Hvis du går tilbage til oversigtssiden for <app>Software</app>, vil dit program være den eneste i karrusellen “Udvalgte”.</p>
  </section>


</page>
