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

  <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>Wie <app>Software</app> Metadaten verwendet</desc>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Tim Sabsch</mal:name>
      <mal:email>tim@sabsch.com</mal:email>
      <mal:years>2024</mal:years>
    </mal:credit>
  </info>

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

  <section id="screenshots">
    <title>Bildschirmfotos</title>
    <media type="image" src="figures/app-screenshot.png" style="floatend floatright" mime="image/png" its:translate="no"/>
    <p><app>Software</app> zeigt die Bildschirmfotos auf der Detailseite einer Anwendung an. Diese sollten typischerweise Bildschirmfotos von verschiedenen Fenstern/Dialogen der Anwendung enthalten, damit der Benutzer einen schnellen Überblick über die Funktionen, das Aussehen, die Bedienung usw. der Anwendung erhält.</p>
    <p>Wenn mehr als ein Bildschirmfoto in der metainfo-Datei der Anwendung vorhanden ist, zeigt <app>Software</app> die Fotos in einem Karussell.</p>
    <p>In Fällen, in denen die metainfo-Datei der Anwendung kein Bildschirmfoto enthält, wird ein Platzhaltersymbol mit der Meldung <code>Keine Bildschirmfotos</code> angezeigt:</p>
    <media type="image" src="figures/scalable/symbolic/image-missing-symbolic.svg" width="96" mime="image/svg" its:translate="no"/>
    <note>
      <p>Das Platzhaltersymbol kann bei Ihnen anders aussehen, wenn Sie ein anderes Symbolthema verwenden.</p>
    </note>
    <p>Bildschirmfotos können veraltet sein, wenn sich die Benutzeroberfläche der Anwendung ändert. Auch wenn <app>Software</app> Bildschirmfotos für eine Anwendung anzeigt, ist es wichtig zu prüfen, ob diese Fotos aktuell oder veraltet sind.</p>
    <p>Sie können Informationen zu den Bildschirmfotos einer Anwendung verbessern:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-app-screenshots">So fügen Sie fehlende Anwendungs-Bildschirmfotos hinzu</link></p>
      </item>
    </list>
  </section>

  <section id="app-context-bar">
    <title>Anwendungskontextleiste</title>
    <p>Die Anwendungskontextleiste in <app>Software</app> ist eine Sammlung von Kacheln auf der Detailseite einer Anwendung, die die folgenden Details anzeigen.</p>
    <list>
      <item>
	<p><link xref="#storage">Speicher</link></p>
      </item>
      <item>
	<p><link xref="#safety">Sicherheit</link></p>
      </item>
      <item>
	<p><link xref="#hardware-support">Hardware-Unterstützung</link></p>
      </item>
      <item>
	<p><link xref="#age-rating">Altersfreigabe</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.">Dies zeigt die Anwendungskontextleiste für die <app>Software</app> Anwendung:</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.">Die Kacheln werden in der oben aufgeführten Reihenfolge angezeigt (beginnend mit der <code>Speicher</code>-Kachel auf der linken Seite).</p>
    <p>Jede Kachel wird im Folgenden beschrieben.</p>
  </section>

  <section id="storage">
    <title>Speicher</title>
    <p><app>Software</app> zeigt eine Speicherkachel auf der Detailseite für eine Anwendung an. Wenn die Anwendung nicht installiert ist, wird die geschätzte Downloadgröße angezeigt, die für die Installation benötigt wird. Wenn die Anwendung installiert ist, wird der von der Anwendung belegte Speicherplatz angezeigt.</p>
    <p>Die Größen werden aus Daten berechnet, die vom <app>Software</app>-Backend (z. B. flatpak oder ein RPM) bereitgestellt werden, und sind nicht in den Metadaten der Anwendung angegeben. Sie können diese Kachel nicht beeinflussen, indem Sie die metainfo-Datei einer Anwendung bearbeiten. Sie ist hier nur der Vollständigkeit halber aufgeführt.</p>
  </section>

  <section id="safety">
    <title>Sicherheit</title>
    <p><app>Software</app> zeigt eine Sicherheitskachel auf der Detailseite für eine Anwendung an. Diese fasst Informationen darüber zusammen, ob die Anwendung als sicher für die Installation und Ausführung betrachtet werden kann oder ob Vorsicht geboten ist, bevor man ihr vertraut.</p>
    <p>Diese Kachel kombiniert Informationen über die Berechtigungen, die die Anwendung bei ihrer Ausführung anfordert (z. B. die Erlaubnis, Ihre Dateien zu lesen), mit Informationen darüber, wie die Anwendung entwickelt wurde. Freie Softwareanwendungen, bei denen der Quellcode öffentlich ist, können sicherer sein als proprietäre Anwendungen, da sie überprüft werden können.</p>
    <p>Das Dialogfeld, das beim Anklicken der Kachel erscheint, listet die verschiedenen Berechtigungen auf, die die Anwendung anfordert, sowie einige Informationen über die Lizenz und die Laufzeitumgebung.</p>
    <p>Sie können die Sicherheitsinformationen verbessern:</p>
    <list>
      <item>
	<p><link xref="#how-to-fix-incorrect-safety-and-permissions-information">So korrigieren Sie falsche Sicherheits- und Berechtigungsinformationen</link></p>
      </item>
    </list>
  </section>

  <section id="hardware-support">
    <title>Hardware-Unterstützung</title>
    <p><app>Software</app> zeigt eine Kachel zur Hardware-Unterstützung auf der Detailseite einer Anwendung an. Diese kombiniert Informationen über die Hardware-Anforderungen der Anwendung und die Hardware-Fähigkeiten des Rechners mit dem Ziel, Inkompatibilitäten oder fehlende Anforderungen hervorzuheben — oder anzuzeigen, dass die Anwendung ohne Inkompatibilitäten korrekt funktionieren sollte.</p>

    <p>Der Code berücksichtigt die folgende Hardware. In Zukunft wird möglicherweise Weiteres unterstützt.</p>
    <list>
      <item><p>Ob ein Tastfeld, eine Maus oder eine Tastatur vorhanden/benötigt wird</p></item>
      <item><p>Ob ein Gamepad benötigt wird</p></item>
      <item><p>Die minimale und empfohlene Anzeigegröße, auf die die Anwendung skaliert werden kann</p></item>
    </list>

    <p>Es ist nicht möglich, zuverlässig zu erkennen, ob ein Gamepad <em>vorhanden</em> ist, da es oft nicht angeschlossen wird, weil es für die normale Rechnernutzung nicht benötigt wird.</p>
    <p>Der Dialog, der beim Anklicken der Kachel erscheint, listet die verschiedenen Hardware-Anforderungen der Anwendung auf und gibt an, ob eine davon nicht erfüllt ist.</p>
    <p>Sie können die Hardware-Informationen verbessern:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-hardware-information">So fügen Sie fehlende Hardware-Informationen hinzu</link></p>
      </item>
    </list>
  </section>

  <section id="age-rating">
    <title>Altersfreigabe</title>
    <p><app>Software</app> zeigt eine Kachel zur Alterseinstufung auf der Detailseite einer Anwendung an. Diese zeigt an, für welche Altersgruppe die Anwendung geeignet sein sollte, basierend auf verschiedenen Arten von Inhalten, die die Anwendung als enthalten deklariert hat. Diese Informationen werden in einem Format zusammengefasst, das den Altersfreigabe-Bescheinigungen für Spiele oder Filme in Ihrem Land ähnelt.</p>
    <p>So wird beispielsweise angezeigt, ob ein Spiel Gewalt enthält oder ob eine Anwendung In-App-Werbung enthält.</p>
    <p>Das Dialogfeld, das beim Anklicken der Kachel erscheint, listet die verschiedenen Arten von Inhalten in der Anwendung auf und gibt an, wie schwerwiegend diese Inhalte sind.</p>
    <p>Sie können die Informationen zur Altersfreigabe verbessern:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-content-rating-information">So fügen Sie fehlende Informationen zur Inhaltsbewertung hinzu</link></p>
      </item>
    </list>
  </section>

  <section id="license">
    <title>Lizenz</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> zeigt eine Kachel an, die angibt, ob es sich bei einer Anwendung um <link href="https://de.wikipedia.org/wiki/Free/Libre_Open_Source_Software">freie Software</link> handelt oder ob die Lizenz proprietär, speziell oder unbekannt ist. Diese Kachel enthält genauere Informationen über die Lizenz des Projekts. Diese Kachel listet auch einige der Vorteile von freier Software auf. <link xref="software-licensing#introduction">Weitere Informationen</link></p>
    <p>Manchmal sind die Lizenzinformationen für eine Anwendung nicht korrekt, sodass eine Anwendung, die eigentlich freie Software ist, als »proprietär« angezeigt wird. Ebenso sind die Lizenzinformationen manchmal unbekannt.</p>
    <p><app>Software</app> hebt freie und quelloffene Lizenzen in Grün hervor, proprietäre und spezielle Lizenzen in Gelb, wie hier gezeigt. Unbekannte Lizenzen sind grau hinterlegt.</p>
    <p>Sie können die Lizenzinformationen ergänzen oder verbessern:</p>
    <list>
      <item>
	<p><link xref="#how-to-fix-incorrect-licensing-information">So korrigieren Sie falsche Lizenzierungsinformationen</link></p>
      </item>
    </list>
  </section>

  <section id="links">
    <title>Verweise</title>
    <media type="image" src="figures/scalable/links.svg" style="floatend floatright" mime="image/svg" its:translate="no"/>
    <p><app>Software</app> zeigt eine Liste an Verweisen zu Ressourcen der Anwendung in der Link-Kachel an. Sie sind wie folgt:</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>Verweis auf die Webseite</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>Verweis auf Spenden</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>Verweis auf das Beitragen von Übersetzungen</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>Verweis auf eine Fehlerberichterstattung</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>Verweis auf Hilfe</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>Verweis auf Kontaktmöglichkeiten</p></td>
      </tr>
    </table>
    <p>Einige oder alle dieser Verweise können vorhanden sein, je nachdem, ob sie in der metainfo-Datei der Anwendung aufgeführt sind.</p>
    <p>Wenn die metainfo-Datei der Anwendung keinen Verweis enthält, wird die folgende Kachel mit einem Fragezeichen angezeigt.</p>
    <media type="image" src="figures/scalable/no-links.svg" style="floatend floatright" mime="image/svg" its:translate="no"/>
    <p>Sie können die Verweise verbessern:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-links">So fügen Sie fehlende Verweise hinzu</link></p>
      </item>
    </list>
  </section>

  <section id="carousel-tile">
    <title>Karussellkachel</title>
    <media type="image" src="figures/carousel.png" style="floatend floatright" mime="image/png" its:translate="no"/>
    <p>Anwendungen, die von <app>Software</app> vorgestellt werden, werden in einem Karussell am oberen Rand des Hauptfensters angezeigt. Jede Kachel des Karussells hat eine Hintergrundfarbe, die automatisch aus dem Symbol der Anwendung extrahiert wird. Manchmal ist diese Hintergrundfarbe nicht ganz passend für die Anwendung und muss vom Anwendungsentwickler explizit angegeben werden.</p>
    <p>Die vorgestellten Anwendungen wird von den Betreuern der Linux-Distributionen ausgewählt.</p>
    <p>Sie können die Karussellkachel verbessern:</p>
    <list>
      <item>
	<p><link xref="#how-to-set-the-carousel-tile-background-colour">So stellen Sie die Hintergrundfarbe der Karussellkachel ein</link></p>
      </item>
    </list>
  </section>

  <section id="where-metadata-comes-from">
    <title>Woher die Metadaten kommen</title>
    <p>Die Metadaten, die angeben, welche Hardware eine Software benötigt, für welche Altersgruppen sie geeignet ist und welche Faktoren dazu beitragen, dass die Installation sicher ist, stammen alle aus der metainfo-Datei für diese Software.</p>
    <p>Die metainfo-Datei ist eine XML-Datei. Ihr Dateiformat ist in der <link href="https://www.freedesktop.org/software/appstream/docs/">AppStream-Spezifikation</link> angegeben.</p>
    <p>Siehe die <link href="https://gitlab.gnome.org/GNOME/nautilus/-/blob/main/data/org.gnome.Nautilus.metainfo.xml.in.in">metainfo-Datei für GNOME Dateien</link>.</p>
    <note style="tip">
      <p><em>appdata</em> ist der alte Name für <em>metainfo</em>.</p>
    </note>
  </section>

  <section id="what-happens-if-metadata-is-missing">
    <title>Was passiert, wenn die Metadaten fehlen?</title>
    <p>Wenn einige Metadaten für eine Anwendung fehlen, kann <app>Software</app> nur raten, was es sein könnte, und kann daher nicht viele Informationen präsentieren. Die Annahmen, die <app>Software</app> trifft, beruhen auf der Tatsache, dass die meiste Software für Desktop-Rechner konzipiert ist.</p>
    <p><em style="strong">Sie können helfen, die Metadaten für eine Anwendung zu verbessern!</em></p>
  </section>

  <section id="how-to-contribute-missing-information">
    <title>So steuern Sie fehlende Informationen bei</title>
    <p>Wenn Sie feststellen, dass auf der Seite einer Anwendung Informationen fehlen oder falsch sind, können Sie auf eine der beiden Arten dazu beitragen:</p>
    <list type="numbered">
      <item>
	<p>Sie können die fehlenden/falschen Metadaten im Fehlerberichterstattungssystem der jeweiligen Anwendung melden, damit der Anwendungsentwickler das Problem beheben kann.</p>
      </item>
      <item>
	<p>Sie können die fehlenden/falschen Metadaten selbst korrigieren. Lesen Sie dazu die unten stehende Anleitung <em style="strong">Hinweise</em>.</p>
      </item>
    </list>

    <p>Für beides müssen Sie zunächst die Projektseite der Anwendung finden. Der Verweis auf die Projektseite sollte normalerweise auf der Seite der Anwendung zu finden sein, <link xref="#links">wie hier gezeigt</link>. Falls nicht, müssen Sie ihn mit einer einfachen Google-Suche finden.</p>

    <p>Anwendungen werden normalerweise in <link href="https://gitlab.com/explore?sort=stars_desc">GitLab</link> oder <link href="https://github.com/explore">GitHub</link> verwaltet. GNOME-Anwendungen werden zum Beispiel in <link href="https://gitlab.gnome.org/GNOME?sort=stars_desc">gitlab.gnome.org</link> verwaltet.</p>
  </section>

  <section id="how-to-add-missing-app-screenshots">
    <title>So fügen Sie fehlende Anwendungs-Bildschirmfotos hinzu</title>
    <p>Die Bildschirm-Informationen für eine Anwendung werden im <link href="https://www.freedesktop.org/software/appstream/docs/sect-Metadata-Application.html#tag-dapp-screenshots"><code>&lt;screenshots&gt;</code></link>-Element innerhalb der <code>&lt;component&gt;</code> der Anwendung in deren metainfo-Datei gespeichert.</p>
    <p>Es werden zwischen 5 und 10 Bildschirmfotos für eine Anwendung empfohlen. Fotos sollten idealerweise im PNG-Format mit einem Seitenverhältnis von 16:9 und einer Mindestbreite von 620 Pixeln vorliegen.</p>
    <p>Hier sind zum Beispiel die Bildschirmfoto-Einträge für die <app>Software</app>-Anwendung:</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>So korrigieren Sie falsche Sicherheits- und Berechtigungsinformationen</title>
    <p>Die Sicherheits- und Berechtigungsinformationen für eine Anwendung stammen aus unterschiedlichen Quellen, je nachdem, wie die Anwendung gepackt ist. Für traditionell gepackte Anwendungen, z. B. im RPM- oder DEB-Format, sind keine Sicherheits- oder Berechtigungsinformationen verfügbar, und es ist auch nicht möglich, sie zu einer Anwendung hinzuzufügen.</p>
    <p>Bei Flatpak-Anwendungen stammen die Informationen aus dem <link href="https://docs.flatpak.org/de/latest/manifests.html">Flatpak-Manifest</link> der Anwendung, das angibt, welche Löcher in der Sandbox die Anwendung benötigt. Jedes dieser Löcher trägt typischerweise dazu bei, die angezeigte Sicherheitsstufe der Anwendung in <app>Software</app> zu senken — sie wird von »sicher« über »potenziell unsicher« zu »unsicher«.</p>
    <p>Um das Sicherheitsniveau einer Anwendung zu verbessern, muss ihr Sandboxing so eng wie möglich gestaltet werden, indem <link href="https://docs.flatpak.org/de/latest/sandbox-permissions.html">Sandbox-Berechtigungen</link> dort entfernt werden, wo sie nicht benötigt werden, und <link href="https://docs.flatpak.org/de/latest/desktop-integration.html#portals">Portale</link> anstelle von Sandbox-Berechtigungen verwendet werden, wo dies möglich ist. Die Verwendung von Portalen senkt nicht die angezeigte Sicherheitsstufe einer Anwendung in <app>Software</app>.</p>
    <p>Wenn die Anwendung beispielsweise Lese-/Schreibzugriff auf das gesamte Dateisystem (<code>--filesystem=host</code>) verlangt: Braucht sie das tatsächlich, oder muss sie nur auf Dateien an einigen bestimmten Stellen zugreifen? Wenn ja, könnte das <link href="https://docs.flatpak.org/de/latest/desktop-integration.html#portals">Dateiportal</link> verwendet werden, oder es könnten spezifischere <link href="https://docs.flatpak.org/de/latest/sandbox-permissions.html#filesystem-access">Dateisystemberechtigungen</link> angegeben werden.</p>
    <p>Wenn die Anwendung auf Wayland läuft und nur als Fallback auf X11 laufen muss, ohne spezielle X11-Funktionen zu verwenden, könnte sie <code>--socket=fallback-x11</code> statt <code>--socket=x11</code> verwenden?</p>
    <p>In Zukunft können hier Hinweise zu bestimmten Berechtigungen oder anderen Verpackungsformaten hinzugefügt werden.</p>
    <p>Weiterer Lesestoff:</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>So fügen Sie fehlende Hardware-Informationen hinzu</title>
    <p>Die Hardware-Informationen für eine Anwendung werden in den <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-relations"><code>&lt;requires&gt;</code>, <code>&lt;recommends&gt;</code> und <code>&lt;supports&gt;</code></link> Elementen innerhalb der <code>&lt;component&gt;</code> in der metainfo-Datei der Anwendung gespeichert.</p>
    <p><app>Software</app> versteht die <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-relations-control"><code>&lt;control&gt;</code></link> und <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-relations-display_length"><code>&lt;display_length&gt;</code></link> Elemente.</p>
    <p>Beispiele für Metadaten finden Sie unter <link href="https://tecnocode.co.uk/2021/07/12/add-metadata-to-your-app-to-say-what-inputs-and-display-sizes-it-supports/">diesem Blogbeitrag</link> oder <link href="https://blogs.gnome.org/tbernard/2021/09/07/ready-for-software-41/#device-support">diesem Blogbeitrag</link>.</p>
  </section>

  <section id="how-to-add-missing-content-rating-information">
    <title>So fügen Sie fehlende Informationen zur Inhaltsbewertung hinzu</title>
    <p>Die Informationen zur Inhaltsbewertung einer Anwendung werden im <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-content_rating"><code>&lt;content_rating&gt;</code></link>-Element innerhalb der <code>&lt;component&gt;</code> der Anwendung in deren metainfo-Datei gespeichert.</p>
    <p>Anwendungen sollten den OARS-1.1-Standard verwenden, um dieses Element auszufüllen. Wenn das <code>&lt;content_rating&gt;</code>-Element nicht angegeben ist, ist die Inhaltsbewertung der Anwendung unbekannt. Wenn es angegeben, aber leer ist, hat die Anwendung keinen Inhalt, der für eine bestimmte Zielgruppe ungeeignet sein könnte.</p>
    <p>Verwenden Sie <link href="https://hughsie.github.io/oars/">den OARS-Generator</link>, um geeignete Informationen zur Inhaltsbewertung für eine Anwendung zu erstellen.</p>
  </section>

  <section id="how-to-fix-incorrect-licensing-information">
    <title>So korrigieren Sie falsche Lizenzierungsinformationen</title>
    <p>Die Lizenzierungsinformationen für eine Anwendung werden im <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-project_license"><code>&lt;project_license&gt;</code></link>-Element innerhalb der <code>&lt;component&gt;</code> der Anwendung in deren metainfo-Datei gespeichert.</p>
    <p>Der Inhalt dieses Elements sollte ein <link href="https://spdx.org/specifications">SPDX-Ausdruck</link> sein, der die »Hauptlizenz« für das Projekt beschreibt. Dies sollte in der Regel die Lizenz des Codes sein und nicht die Lizenz der Dokumentation oder zusätzlicher Inhalte umfassen.</p>
    <p>Handelt es sich bei dem SPDX-Ausdruck um eine Einzellizenz oder um eine »oder«-Kombination mehrerer Lizenzen, die alle <link href="https://spdx.org/licenses/">FSF- oder OSI-genehmigt</link> sind, gilt die Anwendung als »freie Software«, was auch in der Lizenzkachel angegeben ist. Andernfalls gilt sie als »proprietär«.</p>
    <p>Wenn eine Anwendung als »proprietär« angezeigt wird, obwohl dies Ihrer Meinung nach nicht der Fall sein sollte, ist es wahrscheinlich, dass das <code>&lt;project_license&gt;</code>-Element die Dokumentationslizenz für das Projekt enthält. Entfernen Sie es.</p>
    <p><link href="https://gitlab.gnome.org/GNOME/meld/-/issues/579">Zum Beispiel</link>, ändern Sie die Lizenz-Metadaten von:</p>
    <code its:translate="no" mime="application/xml"><![CDATA[<project_license>GPL-2.0+ and CC-BY-SA-3.0</project_license>]]></code>
    <p>zu</p>
    <code its:translate="no" mime="application/xml"><![CDATA[<project_license>GPL-2.0+</project_license>]]></code>
    <p>Weiterer Lesestoff:</p>
    <list>
      <item>
	<p><link href="https://tecnocode.co.uk/2021/07/05/dont-generally-put-cc-by-sa-in-appdata/">Don’t (generally) put documentation license 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>So fügen Sie fehlende Verweise hinzu</title>
    <p>Die Verweise einer Anwendung werden als <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-url"><code>&lt;url&gt;</code></link>-Elemente innerhalb der <code>&lt;component&gt;</code> der Anwendung in ihrer metainfo-Datei gespeichert.</p>
    <p>Fügen Sie so viele der in der <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-url">Appstream-Spezifikation</link> dokumentierten Verweis-Typen hinzu, wie für die Anwendung verfügbar sind. Wenn für einen bestimmten Verweistyp keine geeignete Seite existiert, muss er nicht aufgenommen werden.</p>
    <p>Hier sind zum Beispiel die Ressourcenverweise für die <app>Software</app>-Anwendung:</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>So stellen Sie die Hintergrundfarbe der Karussellkachel ein</title>
    <p>Die Hintergrundfarbe der Karussellkacheln wird normalerweise automatisch aus dem Symbol der Anwendung extrahiert. Wenn diese Farbe jedoch nicht zufriedenstellend ist, kann sie durch Verwendung des <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-branding">Appstream <code>&lt;branding/&gt;</code> Elements</link> mit deklarierten Farben überschrieben werden (seit der 47.x Veröffentlichung). Der Vorteil ist, dass auch andere Anwendungen die Farben verwenden können.</p>
    <p>Hier sind zum Beispiel einige branding-Einträge:</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>Beachten Sie, dass das <code>scheme_preference</code>-Attribut ignoriert wird, <app>Software</app> wählt die bessere Farbe für das Thema selbst aus.</p>
    </note>
    <p>Aus Gründen der Abwärtskompatibilität besteht weiterhin die Möglichkeit, das folgende XML-Element in das metainfo-Element <code>&lt;component&gt;</code> der Anwendung einzufügen:</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>aber das <code>&lt;branding/&gt;</code>-Element hat Vorrang.</p>
    <p>Der Wert von <code>GnomeSoftware::key-colors</code> ist eine GVariant im Textformat mit dem Typ <code>a(yyy)</code> und repräsentiert eine ungeordnete Menge von Schlüsselfarben für die Anwendung. Jedes Element der Menge ist eine Farbe im RGB-Format im Bereich von <code>(0, 0, 0)</code> bis <code>(255, 255, 255)</code>.</p>
    <p>Die Farben sollten so gewählt werden, dass sie:</p>
    <list>
      <item>
	<p>Mit der Anwendung identifizierbar sind und nach Möglichkeit der Marke der Anwendung entsprechen.</p>
      </item>
      <item>
	<p>Mit dem Rand des Anwendungssymbols in Kontrast stehen, sodass das Symbol erkennbar ist, wenn sie als Hintergrund verwendet werden.</p>
      </item>
      <item>
	<p>Mit der Vordergrund-Textfarbe im Adwaita-Thema (<code>#2e3436</code>) und in seiner dunklen Variante (<code>#eeeeec</code>) in Kontrast stehen. Dies bedeutet im Allgemeinen, dass Sie eine Farbe mit mittlerer Helligkeit wählen.</p>
      </item>
      <item>
	<p>Der Kontrast kann mit der <link href="https://flathub.org/apps/org.gnome.design.Contrast/">Kontrast-Anwendung</link> überprüft werden.</p>
      </item>
    </list>
    <p>Es sollte mindestens eine Farbe angegeben werden. Es können mehrere Farben angegeben werden, wenn eine Farbe nicht alle oben genannten Anforderungen erfüllen kann. <app>Software</app> wählt dann die am besten geeignete Farbe für die Karussellkachel aus. Wenn genau eine Farbe angegeben wird, können Helligkeit und Sättigung der Farbe verändert werden, um den Kontrast zur Vordergrundfarbe zu verbessern. Wenn mehr als eine Farbe angegeben wird, wird die Farbe mit dem besten Kontrast zur Vordergrundfarbe gewählt, und ihre Helligkeit und Sättigung werden nicht verändert.</p>
  </section>

  <section id="how-to-test-carousel-tile-background-colour-changes">
    <title>So testen Sie die Änderung der Hintergrundfarbe von Karussellkacheln</title>
    <p>Ändern Sie die metainfo-Datei für Ihre Anwendung, und führen Sie dann <app>Software</app> aus mit:</p>
    <p><cmd>gnome-software --show-metainfo=<var>/pfad/zur/anwendung.metainfo.xml</var>,icon=<var>/pfad/zur/anwendung/icon.png</var></cmd></p>
    <p>Die Detailseite für Ihre Anwendung wird angezeigt. Wenn Sie zurück zur Übersichtsseite von <app>Software</app> navigieren, ist Ihre Anwendung die einzige im »Vorgestellt«-Karussell.</p>
  </section>


</page>
