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

  <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>Jak <app>Software</app> používá metadata</desc>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Daniel Rusek</mal:name>
      <mal:email>mail@asciiwolf.com</mal:email>
      <mal:years>2025</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Dagobert Janota</mal:name>
      <mal:email>janotadag@gmail.com</mal:email>
      <mal:years>2025</mal:years>
    </mal:credit>
  </info>

  <title>Metadata softwaru</title>
  <links type="section"/>

  <section id="screenshots">
    <title>Snímky obrazovky</title>
    <media type="image" src="figures/app-screenshot.png" style="floatend floatright" mime="image/png" its:translate="no"/>
    <p><app>Software</app> zobrazuje snímky obrazovky na stránce detailů aplikace. To často zahrnuje snímky různých oken či dialogových oken aplikace, aby uživatel mohl pochytit rychlý přehled o funkcích aplikace, vzhledu, prožitku z užívání atd.</p>
    <p>Pokud se v souboru metainfo aplikace nachází více než jeden snímek obrazovky, <app>Software</app> zobrazí sled snímků.</p>
    <p>V případě, že soubor metainfo aplikace neobsahuje žádný snímek obrazovky, bude zobrazena tato zástupná ikona s popiskem <code>Žádné snímky obrazovky</code>:</p>
    <media type="image" src="figures/scalable/symbolic/image-missing-symbolic.svg" width="96" mime="image/svg" its:translate="no"/>
    <note>
      <p>Pokud používáte vlastní motiv ikon, tak zástupná ikona může vypadat jinak.</p>
    </note>
    <p>Snímky obrazovky se mohou stát zastaralými se změnami uživatelského rozhraní aplikace. Takže i přestože <app>Software</app> zobrazuje snímky obrazovky aplikace, je důležité si zkontrolovat, zda jsou tyto snímky obrazovky aktuální, nebo ne.</p>
    <p>Můžete vylepšit informace o snímcích obrazovky aplikace:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-app-screenshots">Jak přidat chybějící snímky obrazovky</link></p>
      </item>
    </list>
  </section>

  <section id="app-context-bar">
    <title>Panel informací o aplikaci</title>
    <p>Panel informací o aplikaci v <app>Software</app> je soubor polí na stránce detailů aplikace, které zobrazují následující podrobnosti.</p>
    <list>
      <item>
	<p><link xref="#storage">Úložiště</link></p>
      </item>
      <item>
	<p><link xref="#safety">Bezpečnost</link></p>
      </item>
      <item>
	<p><link xref="#hardware-support">Podpora hardwaru</link></p>
      </item>
      <item>
	<p><link xref="#age-rating">Vhodné od věku</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.">Takto vypadá panel informací v aplikaci <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.">Pole jsou zobrazeny v pořadí výše (počínaje polem <code>Úložiště</code> vlevo).</p>
    <p>Každé pole je detailně popsáno níže.</p>
  </section>

  <section id="storage">
    <title>Úložiště</title>
    <p><app>Software</app> zobrazuje pole úložiště na stránce detailů aplikace. Pokud aplikace není nainstalována, zobrazí předpokládanou velikost ke stažení pro instalaci. Pokud je aplikace již nainstalována, zobrazí velikost úložiště, které je zabráno aplikací.</p>
    <p>Velikost je spočítána z backendu <app>Software</app> (jako třeba z flatpaku nebo RPM) a není specifikována v metadatech poskytovaných aplikací. Tuto položku nemůžete změnit upravováním souboru metainfo aplikace. Úložiště je zde jen pro úplnost.</p>
  </section>

  <section id="safety">
    <title>Bezpečnost</title>
    <p><app>Software</app> zobrazuje pole bezpečnosti na stránce detailů aplikace. To shrne, zda může být aplikace považována za bezpečnou, nebo zda je nutné býti opatrnější před důvěřováním dané aplikaci.</p>
    <p>Toto pole kombinuje informace o oprávněních, které aplikace vyžaduje při spuštění (jako třeba čtení vašich souborů), s informacemi o vývoji aplikace. Svobodné aplikace, které mají zdrojový kód veřejně dostupný, mohou být bezpečnější než uzavřené, protože mohou být kontrolovány.</p>
    <p>Po kliknutí na toto pole se otevře dialogové okno s různými oprávněními, které aplikace vyžaduje a dalšími informacemi o licenci aplikace a jejím běhovém prostředí.</p>
    <p>Můžete vylepšit informace o bezpečnosti:</p>
    <list>
      <item>
	<p><link xref="#how-to-fix-incorrect-safety-and-permissions-information">Jak opravit špatné informace o bezpečnosti a oprávněních</link></p>
      </item>
    </list>
  </section>

  <section id="hardware-support">
    <title>Podpora hardwaru</title>
    <p><app>Software</app> zobrazuje pole podporovaného hardwaru na stránce detailů aplikace. To kombinuje informace o požadavcích na hardware aplikace a možnostech hardwaru počítače, snaží se zvýraznit rozdíly a nedostatky vůči požadovanému hardwaru – nebo zobrazit, že aplikace by měla fungovat správně bez problémů.</p>

    <p>Kód zjišťuje následující hardware. Více by mohlo být podporováno v budoucnosti.</p>
    <list>
      <item><p>Zda je touchpad, myš nebo klávesnice dostupná či potřebná</p></item>
      <item><p>Zda je gamepad potřebný</p></item>
      <item><p>Minimální a doporučená velikost displeje, na který se aplikace bude škálovat</p></item>
    </list>

    <p>Není možné spolehlivě zjistit, zda je gamepad <em>dostupný</em>, protože je často nechán odpojen, jelikož není potřeba pro běžnou práci s počítačem.</p>
    <p>Po kliknutí na toto pole se otevře dialogové okno s různými požadavky na hardware, které aplikace požaduje a zda jsou splněny.</p>
    <p>Můžete vylepšit informace o hardwaru:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-hardware-information">Jak přidat chybějící informace o hardwaru</link></p>
      </item>
    </list>
  </section>

  <section id="age-rating">
    <title>Vhodné od věku</title>
    <p><app>Software</app> zobrazuje pole věkové skupiny na stránce detailů aplikace. To zobrazí pro jakou věkovou skupinu je aplikace vhodná na základě různých druhů obsahu, který aplikace specifikovala, že obsahuje. Tato informace je shrnuta v podobném formátu věkové skupiny, jako mají hry či film ve vaší zemi.</p>
    <p>Například se zvýrazní informace o obsahu násilí ve hře, nebo zda aplikace obsahuje reklamy.</p>
    <p>Po kliknutí na toto pole se otevře dialogové okno s různými typy obsahu v aplikaci a jak závažný je daný obsah.</p>
    <p>Můžete vylepšit věkovou skupinu:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-content-rating-information">Jak přidat chybějící věkovou skupinu</link></p>
      </item>
    </list>
  </section>

  <section id="license">
    <title>Licence</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> obsahuje pole znázorňující, zda aplikace je <link href="https://cs.wikipedia.org/wiki/Svobodn%C3%BD_a_otev%C5%99en%C3%BD_software">svobodným/otevřeným softwarem (FOSS)</link>, uzavřená, speciální, nebo neznámá. Někdy toto pole také vypisuje <link href="https://cs.wikipedia.org/wiki/Svobodn%C3%BD_a_otev%C5%99en%C3%BD_software#V%C3%BDhody">výhody FOSS oproti uzavřenému softwaru</link></p>
    <p>Někdy informace o licenci není správná a svobodná aplikace se může zobrazit jako uzavřená. Podobně může někdy být informace o licenci neznámá.</p>
    <p><app>Software</app> zvýrazňuje svobodné licence a licence s otevřeným zdrojovým kódem zeleně, uzavřené a speciální licence žlutě, jako je zde zobrazeno. Neznámé licence jsou šedé.</p>
    <p>Můžete přidat nebo vylepšit informaci o licenci:</p>
    <list>
      <item>
	<p><link xref="#how-to-fix-incorrect-licensing-information">Jak opravit špatné informace o licenci</link></p>
      </item>
    </list>
  </section>

  <section id="links">
    <title>Odkazy</title>
    <media type="image" src="figures/scalable/links.svg" style="floatend floatright" mime="image/svg" its:translate="no"/>
    <p><app>Software</app> zobrazuje seznam odkazů pro aplikaci v poli s odkazy. Jsou to následující:</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>Odkaz na webové stránky</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>Odkaz pro přispění darem</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>Odkaz pro přispění s překladem</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>Odkaz pro nahlášení chyby</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>Odkaz pro nápovědu</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>Odkaz pro kontaktování vývojáře</p></td>
      </tr>
    </table>
    <p>Některé, nebo všechny z těchto odkazů mohou být zobrazeny, jestliže jsou definovány v souboru metainfo aplikace.</p>
    <p>V případě, že v souboru metainfo aplikace není žádný odkaz, zobrazí se pole s otazníkem.</p>
    <media type="image" src="figures/scalable/no-links.svg" style="floatend floatright" mime="image/svg" its:translate="no"/>
    <p>Můžete vylepšit odkazy:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-links">Jak přidat chybějící odkazy</link></p>
      </item>
    </list>
  </section>

  <section id="carousel-tile">
    <title>Pole doporučených aplikací</title>
    <media type="image" src="figures/carousel.png" style="floatend floatright" mime="image/png" its:translate="no"/>
    <p>Aplikace, které jsou doporučené <app>Software</app> jsou zobrazeny ve sledu v horní části hlavního okna, jako je ukázáno zde. Každé pole má barvu pozadí, která je automaticky vyhodnocena z ikony aplikace. Někdy barva pozadí není úplně správná pro aplikaci a musí být definována vývojářem aplikace.</p>
    <p>Seznam doporučených aplikací je spravován správci linuxové distribuce.</p>
    <p>Můžete vylepšit pole doporučených aplikací:</p>
    <list>
      <item>
	<p><link xref="#how-to-set-the-carousel-tile-background-colour">Jak nastavit barvu pozadí v poli doporučených aplikací</link></p>
      </item>
    </list>
  </section>

  <section id="where-metadata-comes-from">
    <title>Odkud se berou metadata</title>
    <p>Metadata používaná pro definování hardwaru, který aplikace potřebuje, pro jakou věkovou skupinu je vhodná a jaké vlastnosti přispívají k bezpečnosti instalace, všechna pocházejí ze souboru metainfo pro danou aplikaci.</p>
    <p>Soubor metainfo je soubor XML. Jeho formát je definován ve <link href="https://www.freedesktop.org/software/appstream/docs/">specifikaci AppStream</link>.</p>
    <p>Podívejte se na <link href="https://gitlab.gnome.org/GNOME/nautilus/-/blob/main/data/org.gnome.Nautilus.metainfo.xml.in.in">soubor metainfo aplikace Soubory</link>.</p>
    <note style="tip">
      <p><em>appdata</em> je starší termín pro <em>metainfo</em>.</p>
    </note>
  </section>

  <section id="what-happens-if-metadata-is-missing">
    <title>Co se děje pokud chybí informace</title>
    <p>Pokud nějaká metadata aplikaci chybí, <app>Software</app> může pouze hádat, jaká by mohla být a tak nemůže ukázat moc informací ve svém rozhraní. Předpoklady, které <app>Software</app> dělá jsou založeny na faktu, že většina aplikací je navržena pro stolní počítače.</p>
    <p><em style="strong">Můžete vylepšit metadata aplikace!</em></p>
  </section>

  <section id="how-to-contribute-missing-information">
    <title>Jak přidat chybějící informace</title>
    <p>Pokud zjistíte, že stránka aplikace postrádá nebo má špatné informace, můžete přispět jednou ze dvou možností:</p>
    <list type="numbered">
      <item>
	<p>Můžete nahlásit chybějící či nesprávná metadata do záznamu o chybách dané aplikace, takže vývojář dané aplikace je může opravit.</p>
      </item>
      <item>
	<p>Můžete opravit chybějící či nesprávná metadata sami. Podívejte se na část <em style="strong">Jak</em> níže, abyste věděli, jak to provést.</p>
      </item>
    </list>

    <p>Pro obojí musíte nejdříve najít stránku projektu. Odkaz na stránku projektu by měl být běžně na stránce aplikace <link xref="#links">jako je ukázáno zde</link>. Pokud tam není, budete muset jej najít jednoduchým vyhledáváním na Google.</p>

    <p>Aplikace často hostuje <link href="https://gitlab.com/explore?sort=stars_desc">GitLab</link> nebo <link href="https://github.com/explore">GitHub</link>. Například aplikace GNOME jsou hostované na <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>Jak přidat chybějící snímky obrazovky aplikace</title>
    <p>Informace o snímcích obrazovky aplikace je zaznamenána v prvku <link href="https://www.freedesktop.org/software/appstream/docs/sect-Metadata-Application.html#tag-dapp-screenshots"><code>&lt;screenshots&gt;</code></link> v prvku<code>&lt;component&gt;</code> aplikace v souboru metainfo.</p>
    <p>Doporučený počet snímků obrazovky pro aplikaci je mezi 5 a 10. Snímky obrazovky by měly být ve formátu PNG s poměrem stran 16:9 a minimální šířkou 620 pixelů.</p>
    <p>Například toto jsou záznamy snímků obrazovky pro aplikaci <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>Jak opravit špatné informace o bezpečnosti a oprávněních</title>
    <p>Informace o bezpečnosti a oprávněních aplikace pochází z různých zdrojů, které záleží na způsobu zabalení dané aplikace. Pro tradičně zabalené aplikace, například formáty RPM a DEB, neexistují žádné informace o bezpečnosti a oprávněních a nelze je nijak do aplikace přidat.</p>
    <p>Pro aplikace flatpak pochází informace z <link href="https://docs.flatpak.org/en/latest/manifests.html">manifestu flatpaku</link>, který specifikuje díry potřebné v izolovaném prostředí aplikace. Každá z těchto děr přispívá ke snižování úrovně zabezpečení aplikace v <app>Software</app> – posouvá se z „bezpečné“ přes „potenciálně nebezpečnou“ až do „nebezpečné“.</p>
    <p>Chcete-li zlepšit úroveň zabezpečení aplikace, musí být co nejpřísněji izolovaná, odstraněním <link href="https://docs.flatpak.org/en/latest/sandbox-permissions.html">oprávnění izolovaného prostředí</link> na místech, kde nejsou potřeba a používáním <link href="https://docs.flatpak.org/en/latest/desktop-integration.html#portals">portálů</link> místo oprávnění izolovaného prostředí. Používání portálů nesnižuje úroveň zabezpečení v <app>Software</app>.</p>
    <p>Například pokud vaše aplikace požaduje přístup ke čtení či zápisu do celého souborového systému (<code>--filesystem=host</code>), opravdu to potřebuje, nebo jen potřebuje přístup ke konkrétním souborům na několika specifických místech? Pokud to druhé, tak můžete použít <link href="https://docs.flatpak.org/en/latest/desktop-integration.html#portals">souborový portál</link> nebo specifičtější <link href="https://docs.flatpak.org/en/latest/sandbox-permissions.html#filesystem-access">oprávnění souborového systému</link>.</p>
    <p>Pokud aplikace funguje přes Wayland a pouze vyžaduje pracovat s X11 jako záložním řešením bez použití speciálních funkcí X11, mohli byste upřednostnit <code>--socket=fallback-x11</code> před <code>--socket=x11</code>?</p>
    <p>V budoucnu zde mohou být přidány pokyny ohledně specifických oprávnění a dalších balíčkovacích formátech.</p>
    <p>Další čtení:</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>Jak přidat chybějící informace o hardwaru</title>
    <p>Informace o požadavcích na hardware jsou uložené v prvcích <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-relations"><code>&lt;requires&gt;</code>, <code>&lt;recommends&gt;</code> a <code>&lt;supports&gt;</code></link> v prvku <code>&lt;component&gt;</code> aplikace v souboru metainfo.</p>
    <p><app>Software</app> zohledňuje prvky <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-relations-control"><code>&lt;control&gt;</code></link> a <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>Chcete-li více příkladů metadat, můžete se podívat na <link href="https://tecnocode.co.uk/2021/07/12/add-metadata-to-your-app-to-say-what-inputs-and-display-sizes-it-supports/">tento článek</link> nebo <link href="https://blogs.gnome.org/tbernard/2021/09/07/ready-for-software-41/#device-support">tento článek</link>.</p>
  </section>

  <section id="how-to-add-missing-content-rating-information">
    <title>Jak přidat chybějící věkovou skupinu</title>
    <p>Informace o věkové skupině jsou uložené v prvku <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-content_rating"><code>&lt;content_rating&gt;</code></link> v prvku <code>&lt;component&gt;</code> aplikace v souboru metainfo.</p>
    <p>Aplikace by měly v tomto prvku používat standard OARS 1.1. Pokud prvek <code>&lt;content_rating&gt;</code> není specifikován, věková skupina pro aplikaci je neznámá. Pokud je specifikován, ale prázdný, tak aplikace nemá žádný obsah, který by byl nevhodný pro jakoukoli věkovou skupinu.</p>
    <p>Chcete-li vytvořit informaci o vhodném obsahu, využijte <link href="https://hughsie.github.io/oars/">generátor OARS</link>.</p>
  </section>

  <section id="how-to-fix-incorrect-licensing-information">
    <title>Jak opravit špatné informace o licenci</title>
    <p>Informace o licencování aplikace je uložená v prvku <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-project_license"><code>&lt;project_license&gt;</code></link> v prvku <code>&lt;component&gt;</code> aplikace v souboru metainfo.</p>
    <p>Obsah tohoto prvku by měl být <link href="https://spdx.org/specifications">výraz SPDX</link>, který popisuje „hlavní“ licenci projektu. Obvykle by se mělo jednat o licenci kódu a neměl by zahrnovat licenci dokumentace a doplňkového obsahu.</p>
    <p>Pokud je výraz SPDX jedna licence, nebo používá „or“ (nebo) kombinaci několika licencí, které jsou všechny <link href="https://spdx.org/licenses/">schválené FSF nebo OSI</link>, aplikace je brána za „svobodný software“ a pole s licencí to říká. Jinak je brána za „uzavřený software“.</p>
    <p>Pokud aplikace se zobrazuje jako „uzavřený software“ a myslíte si, že by to tak nemělo být, je to často způsobené tím, že prvek <code>&lt;project_license&gt;</code> obsahuje licenci dokumentace projektu. Odstraňte ji.</p>
    <p><link href="https://gitlab.gnome.org/GNOME/meld/-/issues/579">Například</link> změňte metadata licence z:</p>
    <code its:translate="no" mime="application/xml"><![CDATA[<project_license>GPL-2.0+ and CC-BY-SA-3.0</project_license>]]></code>
    <p>na</p>
    <code its:translate="no" mime="application/xml"><![CDATA[<project_license>GPL-2.0+</project_license>]]></code>
    <p>Další čtení:</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>Jak přidat chybějící odkazy</title>
    <p>Odkazy aplikace jsou uložené v prvcích <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-url"><code>&lt;url&gt;</code></link> v prvku <code>&lt;component&gt;</code> aplikace v souboru metainfo.</p>
    <p>Přidejte co nejvíce typů odkazů, které jsou ve <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-url">specifikaci appstream</link> a dostupné pro aplikaci. Pokud neexistuje vhodná stránka pro daný typ odkazu, nemusí být přidána.</p>
    <p>Například toto jsou odkazy pro aplikaci <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>Jak nastavit barvu pozadí v poli doporučených aplikací</title>
    <p>Barva pozadí v poli doporučených aplikací je běžně vyhodnocena z barev ikony aplikace. Pokud vám taková barva nevyhovuje, může být nastavena použitím <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-branding">appstream prvku <code>&lt;branding/&gt;</code></link> s danými barvami (od vydání 47.x). Výhodou je, že tyto barvy může použít více klientů.</p>
    <p>Příklad položek o značce:</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>Vězte, že vlastnost <code>scheme_preference</code> je ignorována, <app>Software</app> vybere nejlepší barvu pro motiv podle sebe.</p>
    </note>
    <p>Pro zpětnou kompatibilitu je zde ponechána možnost přidat následující XML do prvku<code>&lt;component&gt;</code> aplikace v souboru metainfo do <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>ale prvek <code>&lt;branding/&gt;</code> má přednost.</p>
    <p>Hodnota <code>GnomeSoftware::key-colors</code> je textový formát GVariant typu <code>a(yyy)</code> a představuje neuspořádaný seznam barev pro aplikaci. Každý prvek seznamu je barva ve formátu RGB od <code>(0, 0, 0)</code> do <code>(255, 255, 255)</code>.</p>
    <p>Barvy by měly být vybrány tak, aby:</p>
    <list>
      <item>
	<p>Bylo možné je přiřadit k aplikaci a nějakým způsobem odpovídaly značce aplikace.</p>
      </item>
      <item>
	<p>Lišily se s hranami ikony aplikace, tak, aby bylo možné ikonu rozeznat při použití barvy pro pozadí za danou ikonou.</p>
      </item>
      <item>
	<p>Lišily se s barvou textu v motivu Adwaita (<code>#2e3436</code>) a její tmavou variantou (<code>#eeeeec</code>). To obvykle znamená výběr barvy se střední úrovní jasu.</p>
      </item>
      <item>
	<p>Kontrast může být zkontrolován pomocí <link href="https://flathub.org/cs/apps/org.gnome.design.Contrast/">aplikace Kontrast</link>.</p>
      </item>
    </list>
    <p>Měla by být definována minimálně jedna barva. Může jich být definováno více, pokud jedna barva nesplňuje požadavky výše, a <app>Software</app> vybere tu nejvhodnější pro použití v poli doporučených aplikací. Pokud je právě jedna definována, její jas a sytost mohou být upraveny za účelem vylepšení kontrastu s barvou textu. Pokud je více než jedna barva definována, tak se použije ta s nejlepším kontrastem s barvou textu a její jas a sytost se nezmění.</p>
  </section>

  <section id="how-to-test-carousel-tile-background-colour-changes">
    <title>Jak otestovat změnu barvy v poli doporučených aplikací</title>
    <p>Upravte soubor metainfo pro vaši aplikaci a poté spusťte <app>Software</app> s:</p>
    <p><cmd>gnome-software --show-metainfo=<var>/cesta/k/app.metainfo.xml</var>,icon=<var>/cesta/k/ikoně/aplikace.png</var></cmd></p>
    <p>Zobrazí se stránka detailů vaší aplikace. Když se vrátíte zpět na domovskou stránku <app>Software</app>, vaše aplikace bude jedinou v „doporučených“ aplikacích.</p>
  </section>


</page>
