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

  <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>Ako <app>Softvér</app> používa metadáta</desc>
  </info>

  <title>Metadáta softvéru</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>Softvér</app> zobrazuje snímky obrazovky na podrobnej stránke aplikácie. Toto by typicky malo zahŕňať snímky rôznych okien / dialógových okien aplikácie, aby si používateľ rýchlo osvojil funkcie, vzhľad a správanie aplikácie atď.</p>
    <p>Keď je v súbore metainfo aplikácie prítomných viac ako jedna snímka obrazovky, <app>Softvér</app> zobrazí snímky sériu snímok.</p>
    <p>V prípadoch, keď súbor metainfo aplikácie neobsahuje žiadnu snímku obrazovky, zobrazí sa náhradná ikona ako nižšie s <code>Žiadne 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>Náhradná ikona sa môže líšiť, ak používate vlastnú tému ikon.</p>
    </note>
    <p>Snímky obrazovky môžu zastarať v dôsledku zmien používateľského rozhrania aplikácie. Preto, aj keď <app>Softvér</app> zobrazuje snímky aplikácie, je dôležité skontrolovať, či tieto snímky obrazovky ešte platia alebo sú už neaktuálne.</p>
    <p>Môžete vylepšiť informácie o snímkach obrazovky aplikácie:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-app-screenshots">Ako pridať chýbajúce snímky obrazovky aplikácie</link></p>
      </item>
    </list>
  </section>

  <section id="app-context-bar">
    <title>Kontextová lišta aplikácie</title>
    <p>Kontextová lišta aplikácie v <app>Softvéri</app> je zbierka dlaždíc na podrobnej stránke aplikácie, ktoré zobrazujú nasledujúce podrobnosti.</p>
    <list>
      <item>
	<p><link xref="#storage">Úložisko</link></p>
      </item>
      <item>
	<p><link xref="#safety">Bezpečnosť</link></p>
      </item>
      <item>
	<p><link xref="#hardware-support">Podpora hardvéru</link></p>
      </item>
      <item>
	<p><link xref="#age-rating">Vekové hodnotenie</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.">Toto zobrazuje kontextovú lištu aplikácie pre aplikáciu <app>Softvér</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.">Dlaždice sa zobrazujú v poradí uvedenom vyššie (začínajúc dlaždicou <code>Úložisko</code> zľava).</p>
    <p>Každá dlaždica je podrobne popísaná nižšie.</p>
  </section>

  <section id="storage">
    <title>Úložisko</title>
    <p><app>Softvér</app> zobrazuje dlaždicu úložiska na podrobnej stránke aplikácie. Ak nie je aplikácia nainštalovaná, zobrazí sa odhadovaná veľkosť sťahovania potrebná na jej inštaláciu. Ak je aplikácia nainštalovaná, zobrazuje sa úložný priestor používaný aplikáciou.</p>
    <p>Veľkosti sa vypočítavajú z údajov poskytnutých backendom <app>Softvéru</app> (napr. flatpak alebo RPM) a nie sú špecifikované v metadátach poskytnutých aplikáciou. Nie je možné ovplyvniť túto dlaždicu úpravou súboru metainfo aplikácie. Je tu uvedená pre úplnosť.</p>
  </section>

  <section id="safety">
    <title>Bezpečnosť</title>
    <p><app>Softvér</app> zobrazuje dlaždicu bezpečnosti na podrobnej stránke aplikácie. Toto zhrňuje informácie o tom, či je aplikácia považovaná za bezpečnú na inštaláciu a spustenie, alebo či môže byť potrebná opatrnosť pred tým, než jej začnete dôverovať.</p>
    <p>Táto dlaždica kombinuje informácie o oprávneniach, ktoré aplikácia vyžaduje pri svojom spustení (napr. povolenie na čítanie vašich súborov), s informáciami o tom, ako bola aplikácia vyvinutá. Aplikácie slobodného softvéru, kde je zdrojový kód verejne čitateľný, môžu byť bezpečnejšie než proprietárne, pretože ich možno auditovať.</p>
    <p>Dialógové okno, ktoré sa objaví po kliknutí na dlaždicu, uvádza rôzne oprávnenia, ktoré aplikácia vyžaduje, spolu s niektorými informáciami o jej licencii a runtime.</p>
    <p>Môžete vylepšiť informácie o bezpečnosti:</p>
    <list>
      <item>
	<p><link xref="#how-to-fix-incorrect-safety-and-permissions-information">Ako opraviť nesprávne informácie o bezpečnosti a oprávneniach</link></p>
      </item>
    </list>
  </section>

  <section id="hardware-support">
    <title>Podpora hardvéru</title>
    <p><app>Softvér</app> zobrazuje dlaždicu podpory hardvéru na podrobnej stránke aplikácie. Toto kombinuje informácie o hardvérových požiadavkách aplikácie a hardvérových možnostiach počítača s cieľom zvýrazniť nekompatibility alebo chýbajúce požiadavky — alebo naznačiť, že by mala aplikácia fungovať správne bez akýchkoľvek nekompatibilít.</p>

    <p>Kód sa pozerá na nasledujúci hardvér. V budúcnosti môže byť podporovaný aj ďalší.</p>
    <list>
      <item><p>Či je prítomný alebo potrebný touchpad, myš alebo klávesnica</p></item>
      <item><p>Či je potrebný herný ovládač</p></item>
      <item><p>Minimálna a odporúčaná veľkosť displeja, na ktorú sa aplikácia dokáže škálovať</p></item>
    </list>

    <p>Nemožno spoľahlivo zistiť, či je herný ovládač <em>prítomný</em>, pretože sa často nechávajú odpojené, keďže nie sú potrebné pre bežné používanie počítača.</p>
    <p>Dialógové okno, ktoré sa objaví po kliknutí na dlaždicu, uvádza rôzne hardvérové požiadavky aplikácie a či sú niektoré z nich nesplnené.</p>
    <p>Môžete vylepšiť informácie o hardvéri:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-hardware-information">Ako pridať chýbajúce informácie o hardvéri</link></p>
      </item>
    </list>
  </section>

  <section id="age-rating">
    <title>Vekové hodnotenie</title>
    <p><app>Softvér</app> zobrazuje dlaždicu vekového hodnotenia na podrobnej stránke aplikácie. Toto ukazuje, pre akú vekovú kategóriu by mala byť aplikácia vhodná, na základe rôznych druhov obsahu, ktoré aplikácia vyhlásila, že obsahuje. Tieto informácie sú zhrnuté vo formáte podobnom certifikátom hodnotenia hier alebo filmov vo vašej krajine.</p>
    <p>Napríklad to zdôrazní, či hra obsahuje násilie alebo či zobrazuje reklamu priamo v aplikácii.</p>
    <p>Dialógové okno, ktoré sa objaví po kliknutí na dlaždicu, uvádza rôzne typy obsahu v aplikácii a ako závažný je tento obsah.</p>
    <p>Môžete vylepšiť informácie o vekovom hodnotení:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-content-rating-information">Ako pridať chýbajúce informácie o hodnotení obsahu</link></p>
      </item>
    </list>
  </section>

  <section id="license">
    <title>Licencia</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>Softvér</app> zobrazuje dlaždicu, ktorá naznačuje, či je aplikácia <link href="https://en.wikipedia.org/wiki/Free_and_open-source_software">slobodným softvérom</link>, alebo či je jej licencia proprietárna, špeciálna alebo neznáma. Táto dlaždica obsahuje podrobnejšie informácie o licencii projektu. Táto dlaždica tiež uvádza niektoré výhody slobodného softvéru. <link xref="software-licensing#introduction">Zistiť viac</link></p>
    <p>Niekedy nie sú informácie o licencii pre aplikáciu správne, a preto sa aplikácia, ktorá je v skutočnosti slobodným softvérom, zobrazí ako „proprietárna“. Podobne niekedy sú informácie o licenciách neznáme.</p>
    <p><app>Softvér</app> zvýrazňuje slobodné a otvorené licencie zelenou farbou, proprietárne a špeciálne licencie žltou farbou, ako je znázornené tu. Neznáme licencie sú zvýraznené sivou farbou.</p>
    <p>Môžete pridať alebo vylepšiť informácie o licenciách:</p>
    <list>
      <item>
	<p><link xref="#how-to-fix-incorrect-licensing-information">Ako opraviť nesprávne informácie o licenciách</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>Softvér</app> zobrazuje zoznam odkazov na zdroje aplikácie v dlaždici odkazov. Sú nasledujúce:</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ánku</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 na darovanie</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 na príspevok do prekladu</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 na hlásenie chýb</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 na pomoc</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 na kontakt</p></td>
      </tr>
    </table>
    <p>Niektoré alebo všetky tieto odkazy môžu byť prítomné v závislosti od toho, či sú uvedené v súbore metainfo aplikácie.</p>
    <p>V prípadoch, keď súbor metainfo aplikácie neobsahuje žiadny odkaz, zobrazí sa nasledujúca dlaždica s otáznikom.</p>
    <media type="image" src="figures/scalable/no-links.svg" style="floatend floatright" mime="image/svg" its:translate="no"/>
    <p>Môžete vylepšiť odkazy:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-links">Ako pridať chýbajúce odkazy</link></p>
      </item>
    </list>
  </section>

  <section id="carousel-tile">
    <title>Pole odporúčaných aplikácií</title>
    <media type="image" src="figures/carousel.png" style="floatend floatright" mime="image/png" its:translate="no"/>
    <p>Aplikácie, ktoré sú odporúčané <app>Softvérom</app>, sú zobrazené v slede polí na vrchu hlavného okna, ako je znázornené tu. Každé pole používa farbu pozadia, ktorá je automaticky extrahované z ikony aplikácie. Niekedy toto farebné pozadie nie je pre aplikáciu úplne vhodné a musí byť explicitne špecifikované vývojárom aplikácie.</p>
    <p>O sade aplikácii, ktoré sú prezentované, rozhodujú správci Linuxovej distribúcie.</p>
    <p>Môžete vylepšiť pole odporúčaných aplikácií:</p>
    <list>
      <item>
	<p><link xref="#how-to-set-the-carousel-tile-background-colour">Ako nastaviť farbu pozadia v poli odporúčaných aplikácií</link></p>
      </item>
    </list>
  </section>

  <section id="where-metadata-comes-from">
    <title>Odkiaľ pochádzajú metadáta</title>
    <p>Metadáta používané na špecifikáciu hardvéru, ktorý softvér vyžaduje, vekových kategórií používateľov, pre ktoré je vhodný, a faktorov prispievajúcich k tomu, ako bezpečné môže byť jeho inštalovanie, všetky pochádzajú zo súboru metainfo pre tento softvér.</p>
    <p>Súbor metainfo je súbor XML. Jeho formát súboru je špecifikovaný v <link href="https://www.freedesktop.org/software/appstream/docs/">špecifikácii AppStream</link>.</p>
    <p>Pozri <link href="https://gitlab.gnome.org/GNOME/nautilus/-/blob/main/data/org.gnome.Nautilus.metainfo.xml.in.in">súbor metainfo pre aplikáciu Súbory GNOME</link>.</p>
    <note style="tip">
      <p><em>appdata</em> je starší výraz pre <em>metainfo</em>.</p>
    </note>
  </section>

  <section id="what-happens-if-metadata-is-missing">
    <title>Čo sa stane, ak chýbajú metadáta</title>
    <p>Ak pre aplikáciu chýbajú niektoré metadáta, <app>Softvér</app> môže len hádať, čo to môže byť, a preto nemôže v svojich rozhraniach prezentovať veľa informácií. Odhady, ktoré <app>Softvér</app> robí, sú založené na skutočnosti, že väčšina softvéru je navrhnutá pre stolné počítače.</p>
    <p><em style="strong">Môžete pomôcť vylepšiť metadáta pre aplikáciu!</em></p>
  </section>

  <section id="how-to-contribute-missing-information">
    <title>Ako prispieť chýbajúce informácie</title>
    <p>Ak zistíte, že stránka aplikácie obsahuje chýbajúce informácie alebo má nesprávne informácie, môžete prispieť jedným z týchto dvoch spôsobov:</p>
    <list type="numbered">
      <item>
	<p>Môžete nahlásiť chýbajúce / nesprávne metadáta do príslušného sledovača chýb aplikácie, aby ich vývojár aplikácie mohol opraviť.</p>
      </item>
      <item>
	<p>Môžete opraviť chýbajúce / nesprávne metadáta sami. Pozrite si sprievodcu <em style="strong">Ako na to</em> nižšie, ako to urobiť.</p>
      </item>
    </list>

    <p>Pre oboje musíte najprv nájsť stránku projektu aplikácie. Odkaz na stránku projektu by mal byť typicky dostupný na stránke aplikácie <link xref="#links">ako je znázornené tu</link>. Ak nie, budete ho musieť nájsť pomocou jednoduchého hľadania na Google.</p>

    <p>Aplikácie sú typicky hostované v <link href="https://gitlab.com/explore?sort=stars_desc">GitLabe</link> alebo <link href="https://github.com/explore">GitHube</link>. Napríklad aplikácie GNOME sú 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>Ako pridať chýbajúce snímky obrazovky aplikácie</title>
    <p>Informácie o snímkach obrazovky pre aplikáciu sú uložené 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 rámci <code>&lt;component&gt;</code> aplikácie v jej súbore metainfo.</p>
    <p>Odporúčaný počet snímok obrazovky pre aplikáciu je medzi 5 až 10. Snímky obrazovky by mali byť ideálne vo formáte PNG s pomerom strán 16:9 a minimálnou šírkou 620 pixelov.</p>
    <p>Napríklad tu sú záznamy snímok obrazovky pre aplikáciu <app>Softvér</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>Ako opraviť nesprávne informácie o bezpečnosti a oprávneniach</title>
    <p>Informácie o bezpečnosti a oprávneniach pre aplikáciu pochádzajú z rôznych zdrojov v závislosti od toho, ako je aplikácia zabalená. Pre tradične balené aplikácie, napríklad vo formáte RPM alebo DEB, nie sú k dispozícii žiadne informácie o bezpečnosti ani oprávneniach a nič sa nedá urobiť na ich pridanie k aplikácii.</p>
    <p>Pre aplikácie flatpak pochádzajú informácie z <link href="https://docs.flatpak.org/en/latest/manifests.html">manifestu flatpak</link> aplikácie, ktorý špecifikuje, aké diery v pieskovisku aplikácia vyžaduje. Každá z týchto dier typicky prispieva k zníženiu zobrazovanej úrovne bezpečnosti aplikácie v <app>Softvéri</app> — posúvaním od „bezpečnej“ na „potenciálne nebezpečnú“ až po „nebezpečnú“.</p>
    <p>Aby sa zlepšila úroveň bezpečnosti aplikácie, jej izolácia musí byť čo najprísnejšia odstránením <link href="https://docs.flatpak.org/en/latest/sandbox-permissions.html">oprávnení sandboxu</link>, kde nie sú potrebné a použitím <link href="https://docs.flatpak.org/en/latest/desktop-integration.html#portals">portálov</link> namiesto oprávnení sandboxu, kde je to možné. Používanie portálov neznižuje zobrazovanú úroveň bezpečnosti aplikácie v <app>Softvéri</app>.</p>
    <p>Napríklad, ak aplikácia vyžaduje prístup na čítanie/zápis k celému súborovému systému (<code>--filesystem=host</code>), potrebuje to naozaj, alebo stačí prístup k súborom v niekoľkých konkrétnych lokalitách? Ak áno, mohol by sa použiť <link href="https://docs.flatpak.org/en/latest/desktop-integration.html#portals">súborový portál</link>, alebo by mohli byť špecifikované konkrétnejšie <link href="https://docs.flatpak.org/en/latest/sandbox-permissions.html#filesystem-access">oprávnenia súborového systému</link>.</p>
    <p>Ak aplikácia funguje na Waylande a potrebuje iba pracovať na X11 ako náhrada bez použitia špeciálnych funkcií X11, mohla by použiť <code>--socket=fallback-x11</code> namiesto <code>--socket=x11</code>?</p>
    <p>Sprievodné informácie o konkrétnych oprávneniach alebo iných formátoch balenia sem môžu v budúcnosti pribudnúť.</p>
    <p>Ďalšie čítanie:</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>Ako pridať chýbajúce informácie o hardvéri</title>
    <p>Informácie o hardvéri pre aplikáciu sú uložené v prvkoch <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 rámci <code>&lt;component&gt;</code> aplikácie v jej súbore metainfo.</p>
    <p><app>Softvér</app> rozumie prvkom <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>Pozri <link href="https://tecnocode.co.uk/2021/07/12/add-metadata-to-your-app-to-say-what-inputs-and-display-sizes-it-supports/">tento blogový príspevok</link> alebo <link href="https://blogs.gnome.org/tbernard/2021/09/07/ready-for-software-41/#device-support">tento blogový príspevok</link> s príkladmi metadát.</p>
  </section>

  <section id="how-to-add-missing-content-rating-information">
    <title>Ako pridať chýbajúce informácie o hodnotení obsahu</title>
    <p>Informácie o hodnotení obsahu pre aplikáciu sú 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 rámci <code>&lt;component&gt;</code> aplikácie v jej súbore metainfo.</p>
    <p>Aplikácie by mali použiť štandard OARS 1.1 na vyplnenie tohto prvku. Ak nie je špecifikovaný prvok <code>&lt;content_rating&gt;</code>, hodnotenie obsahu aplikácie je neznáme. Ak je špecifikované, ale prázdne, aplikácia nemá žiadny obsah, ktorý by mohol byť nevhodný pre akúkoľvek cieľovú skupinu.</p>
    <p>Použite <link href="https://hughsie.github.io/oars/">generátor OARS</link> na vytvorenie vhodných informácií o hodnotení obsahu pre aplikáciu.</p>
  </section>

  <section id="how-to-fix-incorrect-licensing-information">
    <title>Ako opraviť nesprávne informácie o licenciách</title>
    <p>Informácie o licenciách pre aplikáciu sú 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 rámci <code>&lt;component&gt;</code> aplikácie v jej súbore metainfo.</p>
    <p>Obsah tohto prvku by malo byť <link href="https://spdx.org/specifications">výrazom SPDX</link>, ktorý opisuje „hlavnú“ licenciu projektu. Toto by typicky mal byť licenciou kódu a nemalo by zahŕňať licenciu dokumentácie alebo vedľajšieho obsahu.</p>
    <p>Ak je výraz SPDX jednou licenciou alebo kombináciou viacerých licencií „alebo“, ktoré sú všetky <link href="https://spdx.org/licenses/">schválené FSF alebo OSI</link>, aplikácia sa považuje za „slobodný softvér“ a dlaždica licencie to hovorí. Inak sa považuje za „proprietárny“.</p>
    <p>Ak sa aplikácia zobrazuje ako „proprietárna“, keď si myslíte, že by nemala byť, je pravdepodobné, že prvok <code>&lt;project_license&gt;</code> zahŕňa licenciu dokumentácie projektu. Odstráňte ju.</p>
    <p><link href="https://gitlab.gnome.org/GNOME/meld/-/issues/579">Napríklad</link> zmeňte metadáta licencie 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>Ďalšie čítanie:</p>
    <list>
      <item>
	<p><link href="https://tecnocode.co.uk/2021/07/05/dont-generally-put-cc-by-sa-in-appdata/">Neumiestňujte (všeobecne) licenciu dokumentácie do 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>Ako pridať chýbajúce odkazy</title>
    <p>Odkazy pre aplikáciu sú uložené ako prvky <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-url"><code>&lt;url&gt;</code></link> v rámci <code>&lt;component&gt;</code> aplikácie v jej súbore metainfo.</p>
    <p>Pridajte toľko typov odkazov dokumentovaných v <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-url">špecifikácii appstream</link>, koľko je pre aplikáciu dostupných. Ak pre daný typ odkazu neexistuje vhodná stránka, nemusí byť zahrnutá.</p>
    <p>Napríklad tu sú odkazy na zdroje pre aplikáciu <app>Softvér</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>Ako nastaviť farbu pozadia v poli odporúčaných aplikácií</title>
    <p>Farba pozadia v poli odporúčaných aplikácií sa zvyčajne automaticky extrahuje z ikony aplikácie. Ak je však táto farba nevyhovujúca, môžete ju prepísať použitím <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-branding">prvku appstream <code>&lt;branding/&gt;</code></link> s vyhlásenými farbami (od verzie 47.x). Výhodou je, že toeto farby môže použiť viac klientov.</p>
    <p>Napríklad tu sú niektoré záznamy značenia:</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>Poznámka: atribút <code>scheme_preference</code> sa ignoruje, <app>Softvér</app> si vyberie lepšiu farbu pre tému sám.</p>
    </note>
    <p>Pre spätnú kompatibilitu zostáva možnosť pridať nasledujúci XML do prvku <code>&lt;component&gt;</code> metainfo aplikácie:</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 prvok <code>&lt;branding/&gt;</code> má prednosť.</p>
    <p>Hodnota <code>GnomeSoftware::key-colors</code> je textový formát GVariant s typom <code>a(yyy)</code> a predstavuje neusporiadanú sadu kľúčových farieb pre aplikáciu. Každý prvok sady je farba v tvare RGB od <code>(0, 0, 0)</code> až po <code>(255, 255, 255)</code>.</p>
    <p>Farby by mali byť vybrané tak, aby:</p>
    <list>
      <item>
	<p>nejakým spôsobom identifikovali aplikáciu a, ak je to možné, zodpovedali jej brandingu.</p>
      </item>
      <item>
	<p>boli v kontraste s okrajom ikony aplikácie, aby sa pri použití ako pozadia za ňou dala ikona ľahko rozoznať.</p>
      </item>
      <item>
	<p>kontrastovala s farbou textu popredia v téme Adwaita (<code>#2e3436</code>) a v jej tmavej verzii (<code>#eeeeec</code>). Toto zvyčajne znamená výber farby so strednou úrovňou jasu.</p>
      </item>
      <item>
	<p>Kontrast sa môže skontrolovať pomocou aplikácie <link href="https://flathub.org/apps/org.gnome.design.Contrast/">Contrast</link>.</p>
      </item>
    </list>
    <p>Mala by byť špecifikovaná aspoň jedna farba. Ak jedna farba nemôže spĺňať všetky vyššie uvedené požiadavky, môže byť špecifikovaných viac a <app>Softvér</app> si vyberie tú najvhodnejšiu na použitie v dlaždici karuselu. Ak je špecifikovaná presne jedna farba, jej jas a sýtosť sa môžu upraviť pre zlepšenie kontrastu s farbou popredia. Ak je špecifikovaných viac ako jedna farba, vyberie sa tá s najlepším kontrastom s farbou popredia a jej jas a sýtosť sa nebudú upravovať.</p>
  </section>

  <section id="how-to-test-carousel-tile-background-colour-changes">
    <title>Ako otestovať zmeny farby v poli odporúčaných aplikácií</title>
    <p>Upravte súbor metainfo pre vašu aplikáciu a potom spustite <app>Softvér</app> pomocou:</p>
    <p><cmd>gnome-software --show-metainfo=<var>/cesta/k/aplikácii.metainfo.xml</var>,icon=<var>/cesta/k/ikone/aplikácie.png</var></cmd></p>
    <p>Zobrazí sa podrobná stránka vašej aplikácie. Ak sa vrátite na prehľadovú stránku <app>Softvéru</app>, vaša aplikácia bude jedinou v „odporúčaných aplikáciach“.</p>
  </section>


</page>
