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

  <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>Hoe <app>Software</app> metadata gebruikt</desc>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Marvin Parlevliet</mal:name>
      <mal:email>marvinparlevliet@msn.com</mal:email>
      <mal:years>2025</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Nathan Follens</mal:name>
      <mal:email>nfollens@gnome.org</mal:email>
      <mal:years>2025</mal:years>
    </mal:credit>
  </info>

  <title>Software-metadata</title>
  <links type="section"/>

  <section id="screenshots">
    <title>Schermafdrukken</title>
    <media type="image" src="figures/app-screenshot.png" style="floatend floatright" mime="image/png" its:translate="no"/>
    <p><app>Software</app> toont schermafdrukken op de detailpagina voor een toepassing. Deze zal normaal gesproken schermafdrukken van een aantal (dialoog)vensters van de toepassing moeten bevatten, zodat de gebruiker in een oogopslag de mogelijkheden van de toepassing kan zien, de look-en-feel, enz.</p>
    <p>Wanneer er meer dan één schermafdruk beschikbaar is in het metainfo-bestand van de toepassing, zal <app>Software</app> de schermafdrukken in een carrousel weergeven.</p>
    <p>In gevallen waar het metainfo-bestand van de toepassing geen schermafbeelding bevat, zal er een tijdelijk pictogram met <code>Geen schermafdrukken</code> getoond worden, zoals hieronder:</p>
    <media type="image" src="figures/scalable/symbolic/image-missing-symbolic.svg" width="96" mime="image/svg" its:translate="no"/>
    <note>
      <p>Het tijdelijke pictogram kan er anders uitzien wanneer u een aangepast pictogramthema gebruikt.</p>
    </note>
    <p>Schermafdrukken kunnen verouderd raken wanneer de gebruikersinterface van de toepassing verandert. Zelfs als <app>Software</app> schermafdrukken van een toepassing toont, is het belangrijk om te controleren of deze schermafdrukken bijgewerkt of verouderd geraakt zijn.</p>
    <p>U kunt de schermafdrukinformatie van toepassingen verbeteren:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-app-screenshots">Ontbrekende schermafdrukken toevoegen</link></p>
      </item>
    </list>
  </section>

  <section id="app-context-bar">
    <title>Toepassing-contextbalk</title>
    <p>De toepassing-contextbalk in <app>Software</app> is een collectie van tegels op de detailpagina voor een toepassing, die de volgende details toont.</p>
    <list>
      <item>
	<p><link xref="#storage">Opslag</link></p>
      </item>
      <item>
	<p><link xref="#safety">Veiligheid</link></p>
      </item>
      <item>
	<p><link xref="#hardware-support">Hardwareondersteuning</link></p>
      </item>
      <item>
	<p><link xref="#age-rating">Leeftijdsbeoordeling</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.">Dit toont de contextbalk voor de <app>Software</app>-toepassing:</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.">De tegels worden getoond in de volgorde zoals hierboven genoemd (beginnend met de <code>Opslag</code>-tegel aan de linkerkant).</p>
    <p>Elke tegel wordt hieronder in detail beschreven.</p>
  </section>

  <section id="storage">
    <title>Opslag</title>
    <p><app>Software</app> toont een opslagtegel op de detailpagina van een toepassing. Als de toepassing niet al geïnstalleerd is, toont deze een geschatte downloadgrootte benodigd om deze te installeren. Wanneer de toepassing geïnstalleerd is, toont deze de opslagruimte gebruikt door de toepassing.</p>
    <p>De groottes worden berekend gebaseerd op data afkomstig van de <app>Software</app>-back-end (zoals Flatpak of een RPM) en worden niet vastgesteld in de metadata van de toepassing. Er zijn geen veranderingen die u kunt maken aan deze tegel door het metainfo-bestand van een toepassing te bewerken. Dit wordt getoond ter volledigheid.</p>
  </section>

  <section id="safety">
    <title>Veiligheid</title>
    <p><app>Software</app> toont een veiligheidstegel op de detailpagina voor een toepassing. Dit toont een samenvatting van informatie in hoeverre een toepassing beschouwd kan worden als veilig om te installeren en uit te voeren, of dat voorzichtigheid wordt aangeraden alvorens deze te vertrouwen.</p>
    <p>Deze tegel combineert informatie over de machtigingen die de toepassing aanvraagt wanneer ze uitgevoerd wordt (zoals machtiging om uw bestanden te lezen), met informatie over hoe de toepassing ontwikkeld is. Vrije software, waarvan de broncode openbaar leesbaar is, kan veiliger zijn dan propriëtaire software, omdat deze gecontroleerd kan worden.</p>
    <p>Het dialoogvenster dat verschijnt wanneer de tegel aangeklikt wordt, toont de verschillende machtigingen die de toepassing aanvraagt, met wat informatie over de licentie en runtime ervan.</p>
    <p>U kunt de veiligheidsinformatie verbeteren:</p>
    <list>
      <item>
	<p><link xref="#how-to-fix-incorrect-safety-and-permissions-information">Foutieve veiligheids- en machtigingsinformatie aanvullen</link></p>
      </item>
    </list>
  </section>

  <section id="hardware-support">
    <title>Hardwareondersteuning</title>
    <p><app>Software</app> toont een hardwareondersteuningstegel op de detailpagina voor een toepassing. Deze combineert informatie over de hardware-eisen van de toepassing, en de hardwaremogelijkheden van de computer, met het doel om incompatibele of ontbrekende eisen aan te kaarten — of om te tonen dat de toepassing correct zou moeten werken zonder incompatibiliteiten.</p>

    <p>De code kijkt naar de volgende hardware. Meer ondersteuning kan in de toekomst toegevoegd worden.</p>
    <list>
      <item><p>Of er een touchpad, muis of toetsenbord aanwezig/nodig is</p></item>
      <item><p>Of er een gamepad nodig is</p></item>
      <item><p>De minimum en aanbevolen schermgrootte waarin de toepassing zich kan schalen</p></item>
    </list>

    <p>Het is niet mogelijk om met betrouwbaarheid te detecteren of er een gamepad <em>aanwezig</em> is, omdat deze vaak niet aangekoppeld zijn tijdens normaal computergebruik.</p>
    <p>Het dialoogvenster dat verschijnt wanneer de tegel aangeklikt wordt, toont de verschillende systeemeisen van de toepassing, en of er eisen zijn waaraan niet voldaan wordt.</p>
    <p>U kunt de hardware-informatie verbeteren:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-hardware-information">Ontbrekende hardware-informatie toevoegen</link></p>
      </item>
    </list>
  </section>

  <section id="age-rating">
    <title>Leeftijdsbeoordeling</title>
    <p><app>Software</app> toont een leeftijdsbeoordelingstegel op de detailpagina voor een toepassing. Dit toont de leeftijdsgroep voor wie de toepassing geschikt is, gebaseerd op de verschillende soorten inhoud waarvan de toepassing heeft aangegeven dat ze die bevat. Deze informatie wordt samengevat in een formaat vergelijkbaar met de spel- of filmkeuringscertificaten voor uw land.</p>
    <p>Er wordt bijvoorbeeld getoond of een spel geweld bevat, of dat een toepassing inge advertenties bevat.</p>
    <p>Het dialoogvenster dat getoond wordt wanneer er op de tegel geklikt wordt, toont de verschillende types van inhoud in de toepassing en de mate van ongepastheid van de inhoud.</p>
    <p>U kunt de leeftijdsbeoordelingsinformatie verbeteren:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-content-rating-information">Ontbrekende leeftijdsbeoordelingsinformatie toevoegen</link></p>
      </item>
    </list>
  </section>

  <section id="license">
    <title>Licentie</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> toont een tegel die aangeeft of een toepassing <link href="https://nl.wikipedia.org/wiki/Vrije_software">vrije software</link> is, of dat de licentie propriëtair, speciaal of onbekend is. Deze tegel bevat meer gedetailleerde informatie over de licentie van het project. Ook toont deze tegel een aantal voordelen van vrije software. <link xref="software-licensing#introduction">Meer informatie</link></p>
    <p>Soms kan het voorkomen dat de licentie-informatie van een toepassing onjuist is, waardoor vrije software getoond wordt als ‘propriëtair’. Soms kan de licentie-informatie ook onbekend zijn.</p>
    <p><app>Software</app> markeert vrije en opensourcelicenties in het groen, en propriëtaire en speciale licenties in het geel, zoals hier getoond. Onbekende licenties worden in het grijs gemarkeerd.</p>
    <p>U kunt de licentie-informatie verbeteren of toevoegen:</p>
    <list>
      <item>
	<p><link xref="#how-to-fix-incorrect-licensing-information">Foutieve licentie-informatie verbeteren</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> toont een lijst van bronverwijzingen gerelateerd aan de toepassing in de verwijzingstegel. Deze zijn als volgt:</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>Verwijzing naar de website</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>Verwijzing voor donaties</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>Verwijzing om vertalingen bij te dragen</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>Verwijzing om fouten te melden</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>Verwijzing voor hulp</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>Verwijzing om contact op te nemen</p></td>
      </tr>
    </table>
    <p>Een aantal of alle verwijzingen kunnen beschikbaar zijn, afhankelijk van of deze opgegeven zijn in het metainfo-bestand van de toepassing.</p>
    <p>In gevallen waar het metainfo-bestand van de toepassing geen verwijzing bevat, wordt de volgende tegel met een vraagteken getoond.</p>
    <media type="image" src="figures/scalable/no-links.svg" style="floatend floatright" mime="image/svg" its:translate="no"/>
    <p>U kunt de verwijzingen verbeteren:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-links">Ontbrekende verwijzingen toevoegen</link></p>
      </item>
    </list>
  </section>

  <section id="carousel-tile">
    <title>Carrouseltegel</title>
    <media type="image" src="figures/carousel.png" style="floatend floatright" mime="image/png" its:translate="no"/>
    <p>Toepassingen die uitgelicht zijn door <app>Software</app>, worden getoond in een carrousel aan de bovenkant van het venster zoals hier getoond. Elke carrouseltegel heeft een achtergrondtegel die automatisch uit het pictogram van de toepassing geëxtraheerd wordt. Soms klopt deze achtergrondkleur niet helemaal voor de toepassing en moet deze expliciet vastgesteld worden door de ontwikkelaar van de toepassing.</p>
    <p>De verzameling toepassingen die uitgelicht zijn, wordt bepaald door de beheerders van de Linux-distributie.</p>
    <p>U kunt de carrouseltegel verbeteren:</p>
    <list>
      <item>
	<p><link xref="#how-to-set-the-carousel-tile-background-colour">De achtergrondkleur van de carrousel instellen</link></p>
      </item>
    </list>
  </section>

  <section id="where-metadata-comes-from">
    <title>Waar metadata vandaan komt</title>
    <p>De metadata gebruikt voor het bepalen welke hardware een toepassing nodig heeft, voor welke leeftijd ze geschikt is, en factoren die meewegen in hoe veilig het kan zijn om te installeren, komen allemaal uit het metainfo-bestand voor die toepassing.</p>
    <p>Het metainfo-bestand is een XML-bestand. Het bestandsformaat is vastgesteld in de <link href="https://www.freedesktop.org/software/appstream/docs/">AppStream-specificatie</link>.</p>
    <p>Zie het <link href="https://gitlab.gnome.org/GNOME/nautilus/-/blob/main/data/org.gnome.Nautilus.metainfo.xml.in.in">metainfo-bestand voor de GNOME Bestanden-toepassing</link>.</p>
    <note style="tip">
      <p><em>appdata</em> is de oudere term voor <em>metainfo</em>.</p>
    </note>
  </section>

  <section id="what-happens-if-metadata-is-missing">
    <title>Wat er gebeurt als de metadata ontbreekt</title>
    <p>Als er metadata voor een toepassing ontbreekt, kan <app>Software</app> alleen speculeren wat het zou kunnen zijn, waardoor het niet veel informatie erover kan tonen in de interfaces. De speculaties gemaakt door <app>Software</app> zijn gebaseerd op het feit dat de meeste software ontworpen is voor desktopcomputers.</p>
    <p><em style="strong">U kunt de metadata van een toepassing verbeteren!</em></p>
  </section>

  <section id="how-to-contribute-missing-information">
    <title>Aanvullen van ontbrekende informatie</title>
    <p>Als u ondervindt dat een pagina van een toepassing ontbrekende of onjuiste informatie bevat, kunt u bijdragen op een van de volgende twee manieren:</p>
    <list type="numbered">
      <item>
	<p>U kunt de ontbrekende / onjuiste metadata rapporteren in de respectieve bugtracker van de toepassing, zodat de ontwikkelaar van de toepassing dit kan oplossen.</p>
      </item>
      <item>
	<p>U kunt de ontbrekende / onjuiste metadata zelf aanvullen. Zie de <em style="strong">How to</em>-handleiding hieronder hoe u dit kunt doen.</p>
      </item>
    </list>

    <p>In beide gevallen moet u eerst de projectpagina van de toepassing vinden. De link naar de projectpagina zal normaal gesproken op de pagina van de toepassing getoond moeten worden <link xref="#links">zoals hier getoond</link>. Als dit niet zo is, dan zal u deze kunnen vinden met een simpele zoekopdracht op Google.</p>

    <p>Toepassingen worden normaal gesproken gehost op <link href="https://gitlab.com/explore?sort=stars_desc">GitLab</link> of <link href="https://github.com/explore">GitHub</link>. GNOME-toepassingen worden bijvoorbeeld gehost op <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>Ontbrekende schermafdrukken toevoegen</title>
    <p>De schermafdrukinformatie van een toepassing wordt bewaard in het <link href="https://www.freedesktop.org/software/appstream/docs/sect-Metadata-Application.html#tag-dapp-screenshots"><code>&lt;screenshots&gt;</code></link>-element binnen de <code>&lt;component&gt;</code> in het metainfo-bestand van de toepassing.</p>
    <p>Het aanbevolen aantal schermafdrukken voor een toepassing ligt tussen 5 en 10. Schermafdrukken behoren idealiter in PNG-formaat te zijn met een verhouding van 16:9 en een minimumbreedte van 620 pixels.</p>
    <p>Hier zijn bijvoorbeeld een aantal schermafdrukken ingezonden voor de <app>Software</app>-toepassing:</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>Onjuiste veiligheids- en machtigingsinformatie oplossen</title>
    <p>De veiligheids- en machtigingsinformatie voor een toepassing komt van verschillende bronnen, afhankelijk van hoe de toepassing is verpakt. Voor traditioneel-verpakte toepassingen, bijvoorbeeld in RPM- of DEB-formaat, is er geen veiligheids- of machtigingsinformatie beschikbaar en is er geen manier om dit aan een toepassing toe te voegen.</p>
    <p>Voor Flatpak-toepassingen komt deze informatie van het <link href="https://docs.flatpak.org/en/latest/manifests.html">flatpak-manifest</link> van de toepassing, waarin staat welke openingen in de zandbak de toepassing nodig heeft. Elk van deze openingen leidt er doorgaans toe dat het weergegeven veiligheidsniveau van de toepassingen in <app>Software</app> verlaagd wordt — van ‘Veilig’ over ‘Mogelijk onveilig’ naar ‘Onveilig’.</p>
    <p>Om het veiligheidsniveau van een toepassing te verbeteren, moet de zandbak ervan zo strikt mogelijk gemaakt worden, door het verwijderen van <link href="https://docs.flatpak.org/en/latest/sandbox-permissions.html">zandbakmachtigingingen</link> wanneer deze niet benodigd zijn, en door het gebruik van <link href="https://docs.flatpak.org/en/latest/desktop-integration.html#portals">portalen</link> in plaats van zandbakmachtigingen waar mogelijk. Het gebruik van portalen verlaagt het getoonde veiligheidsniveau van een toepassing in <app>Software</app> niet.</p>
    <p>Als een toepassing bijvoorbeeld lees-/schrijfrechten aanvraagt voor het gehele bestandssysteem (<code>--filesystem=host</code>), heeft ze het dan echt nodig, of moet ze alleen bestanden benaderen in een paar specifieke locaties? In het laatste geval kan het <link href="https://docs.flatpak.org/en/latest/desktop-integration.html#portals">bestandsportaal</link> gebruikt worden, of meer specifieke <link href="https://docs.flatpak.org/en/latest/sandbox-permissions.html#filesystem-access">bestandssysteemmachtigingen</link> kunnen worden aangegeven.</p>
    <p>Als de toepassing op Wayland werkt, en alleen als terugvaloptie moet werken op X11 zonder het gebruik van speciale X11-mogelijkheden, zou het <code>--socket=fallback-x11</code> kunnen gebruiken in plaats van <code>--socket=x11</code>?</p>
    <p>Richtlijnen over specifieke machtigingen, of andere pakketformaten, kunnen hier in de toekomst toegevoegd worden.</p>
    <p>Verder lezen:</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>Ontbrekende hardware-informatie toevoegen</title>
    <p>De hardware-informatie voor een toepassing wordt bewaard in de <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-relations"><code>&lt;requires&gt;</code>-, <code>&lt;recommends&gt;</code>- en <code>&lt;supports&gt;</code></link>-elementen binnen de <code>&lt;component&gt;</code> van de toepassing in het metainfo-bestand.</p>
    <p><app>Software</app> begrijpt de <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-relations-control"><code>&lt;control&gt;</code></link>- en <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-relations-display_length"><code>&lt;display_length&gt;</code></link>-elementen.</p>
    <p>ZIe <link href="https://tecnocode.co.uk/2021/07/12/add-metadata-to-your-app-to-say-what-inputs-and-display-sizes-it-supports/">deze blogpost</link> of <link href="https://blogs.gnome.org/tbernard/2021/09/07/ready-for-software-41/#device-support">deze blogpost</link> voor voorbeelden van metadata.</p>
  </section>

  <section id="how-to-add-missing-content-rating-information">
    <title>Ontbrekende leeftijdsbeoordelingsinformatie toevoegen</title>
    <p>De leeftijdsbeoordelingsinformatie voor een toepassing wordt bewaard in het <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-content_rating"><code>&lt;content_rating&gt;</code></link>-element binnen de <code>&lt;component&gt;</code> in het metainfo-bestand van de toepassing.</p>
    <p>Toepassingen zullen de OARS 1.1-standaard moeten gebruiken om dit element in te vullen. Als het <code>&lt;content_rating&gt;</code>-element niet gespecificeerd is, dan is de leeftijdbeoordelingsinformatie onbekend. Als deze gespecificeerd maar leeg is, bevat de toepassing geen inhoud die mogelijk ongepast is voor een doelgroep.</p>
    <p>Gebruik <link href="https://hughsie.github.io/oars/">de OARS-generator</link> om passende leeftijdsbeoordelingsinformatie voor een toepassing te genereren.</p>
  </section>

  <section id="how-to-fix-incorrect-licensing-information">
    <title>Foutieve licentie-informatie oplossen</title>
    <p>De licentie-informatie voor een toepassing wordt bewaard in het <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-project_license"><code>&lt;project_license&gt;</code></link>-element binnen de <code>&lt;component&gt;</code> in het metainfo-bestand van de toepassing.</p>
    <p>De inhoud in dit element zou een <link href="https://spdx.org/specifications">SPDX-expressie</link> moeten zijn, die de ‘hoofdlicentie’ voor het project beschrijft. Deze zou normaal gesproken de licentie van de code moeten zijn, en niet de licentie van de documentatie of bijkomende inhoud mogen bevatten.</p>
    <p>Als de SPDX-expressie één licentie is, of een ‘of’-combinatie van meerdere licenties, die allen <link href="https://spdx.org/licenses/">door de FSF of het OSI goedgekeurd zijn</link>, dan wordt de toepassing als ‘vrije software’ beschouwd, en de tegel zal dit dan aangeven. Anders wordt ze als ‘propriëtair’ beschouwd.</p>
    <p>Als een toepassing wordt getoond als ‘propriëtair’ terwijl u denkt dat dit niet klopt, dan kan het zijn dat het <code>&lt;project_license&gt;</code>-element de documentatielicentie voor het project bevat. Verwijder deze.</p>
    <p>Verander <link href="https://gitlab.gnome.org/GNOME/meld/-/issues/579">bijvoorbeeld</link> de licentiemetadata van:</p>
    <code its:translate="no" mime="application/xml"><![CDATA[<project_license>GPL-2.0+ and CC-BY-SA-3.0</project_license>]]></code>
    <p>naar</p>
    <code its:translate="no" mime="application/xml"><![CDATA[<project_license>GPL-2.0+</project_license>]]></code>
    <p>Verder lezen:</p>
    <list>
      <item>
	<p><link href="https://tecnocode.co.uk/2021/07/05/dont-generally-put-cc-by-sa-in-appdata/">Zet (over het algemeen) geen documentatielicentie in 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>Ontbrekende verwijzingen toevoegen</title>
    <p>De verwijzingen voor een toepassing worden bewaard als <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-url"><code>&lt;url&gt;</code></link>-elementen binnen de <code>&lt;component&gt;</code> in het metainfo-bestand van de toepassing.</p>
    <p>Voeg zoveel verwijzingstypes gedocumenteerd in de <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-url">AppStream-specificatie</link> als er beschikbaar zijn voor de toepassing. Als er geen passende pagina bestaat voor een gegeven verwijzingstype, hoeft het niet toegevoegd te worden.</p>
    <p>Hier zijn bijvoorbeeld de bronverwijzingen voor de <app>Software</app>-toepassing:</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>Een achtergondkleur van de carrouseltegel instellen</title>
    <p>De achtergrondkleur van de carrouseltegel wordt normaal gesproken automatisch uit het pictogram van de toepassing gehaald. Als deze kleur echter ontoereikend is, kan deze overschreven worden met behulp van het <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-branding">AppStream<code>&lt;-branding/&gt;</code>-element</link> met gedeclareerde kleuren (sinds de 47.x-serie). Het voordeel hiervan is dat deze kleuren door meerdere cliënten gebruikt kunnen worden.</p>
    <p>Hier zijn bijvoorbeeld een aantal branding-inzendingen:</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>Merk op dat het<code>scheme_preference</code>-attribuut genegeerd wordt, en <app>Software</app> de betere kleur voor het thema zelf uitkiest.</p>
    </note>
    <p>Voor terugwaartse compatibiliteit is de mogelijkheid behouden om de volgende XML aan het metainfo-<code>&lt;component&gt;</code>-element van de toepassing toe te voegen:</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>maar het <code>&lt;branding/&gt;</code>-element neemt de voorrang.</p>
    <p>De waarde van <code>GnomeSoftware::key-colors</code> is een tekstformaat GVariant met het type <code>a(yyy)</code>, en stelt een ongeordende lijst van sleutelkleuren voor de toepassing voor. Elk element van de verzameling is een kleur in de RGB-notatie van  <code>(0, 0, 0)</code> tot <code>(255, 255, 255)</code>.</p>
    <p>Kleuren zouden zodanig gekozen moeten worden dat ze:</p>
    <list>
      <item>
	<p>Terug te kennen zijn naar de applicatie, waar mogelijk passend bij de merkidentiteit van de toepassing.</p>
      </item>
      <item>
	<p>Contrast bieden ten opzichte van de rand van het toepassingspictogram, zodat het pictogram van de achtergrond onderscheiden kan worden.</p>
      </item>
      <item>
	<p>Contrast met de voorgrondtekstkleur in het Adwaita-thema <code>#2e3436</code>) en zijn donkere variant (<code>#eeeeec</code>). Dit betekent over het algemeen een kleur te kiezen met een gemiddelde hoeveelheid helderheid.</p>
      </item>
      <item>
	<p>Het contrast kan gecontroleerd worden met behulp van de <link href="https://flathub.org/apps/org.gnome.design.Contrast/">Contrast-toepassing</link>.</p>
      </item>
    </list>
    <p>Minstens één kleur moet worden opgegeven. Meerdere kunnen worden opgegeven als één kleur niet aan alle eisen hierboven voldoet, <app>Software</app> zal dan kiezen welke het meest geschikt is voor gebruik in de carrouseltegel. Wanneer precies één kleur is opgegeven, kan de helderheid en verzadiging aangepast worden om contrast met de voorgrondkleur te verbeteren. Wanneer meer dan één kleur wordt opgegeven, dan zal de voorgrondkleur met het beste contrast gekozen worden, en zullen de helderheid en verzadiging niet aangepast worden.</p>
  </section>

  <section id="how-to-test-carousel-tile-background-colour-changes">
    <title>Testen van achtergrondkleurveranderingen in de carrouseltegel</title>
    <p>Bewerk het metainfo-bestand voor uw toepassing, en start <app>Software</app> met:</p>
    <p><cmd>gnome-software --show-metainfo=<var>/pad/naar/app.metainfo.xml</var>,icon=<var>/pad/naar/toepassing/pictogram.png</var></cmd></p>
    <p>De detailpagina voor uw toepassing zal nu getoond worden. Als u teruggaat naar de overzichtspagina van <app>Software</app>, zal uw toepassing als enige in de ‘Uitgelicht’-carrousel verschijnen.</p>
  </section>


</page>
