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

  <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>Hogyan használja a <app>Szoftver</app> a metaadatokat</desc>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Úr Balázs</mal:name>
      <mal:email>ur dot balazs at fsf dot hu</mal:email>
      <mal:years>2024.</mal:years>
    </mal:credit>
  </info>

  <title>Szoftverek metaadatai</title>
  <links type="section"/>

  <section id="screenshots">
    <title>Képernyőképek</title>
    <media type="image" src="figures/app-screenshot.png" style="floatend floatright" mime="image/png" its:translate="no"/>
    <p>A <app>Szoftver</app> megjeleníti a képernyőképeket egy alkalmazás részletes oldalán. Ennek jellemzően az alkalmazás különböző ablakainak vagy párbeszédablakainak képernyőképeit kell tartalmaznia, hogy a felhasználó gyorsan megismerhesse az alkalmazás funkcióit, megjelenését és egyebeket.</p>
    <p>Ha egynél több képernyőkép van az alkalmazás metainformációs fájljában, akkor a <app>Szoftver</app> a képernyőképeket körhinta módon jeleníti meg.</p>
    <p>Abban az esetben, ha az alkalmazás metainformációs fájlja nem tartalmaz képernyőképet, akkor egy helykitöltő ikon jelenik meg az alábbi <code>Nincsenek képernyőképek</code> szöveggel:</p>
    <media type="image" src="figures/scalable/symbolic/image-missing-symbolic.svg" width="96" mime="image/svg" its:translate="no"/>
    <note>
      <p>A helykitöltő ikon másképp nézhet ki, ha egyéni ikontémát használ.</p>
    </note>
    <p>A képernyőképek elavulhatnak, ahogy az alkalmazás felhasználói felülete változik. Tehát ha a <app>Szoftver</app> képernyőképeket jelenít meg egy alkalmazáshoz, fontos ellenőrizni, hogy ezek a képernyőképek naprakészek-e vagy elavultak.</p>
    <p>Javíthatja az alkalmazás képernyőképének információit:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-app-screenshots">Hogyan adhat hozzá hiányzó alkalmazás-képernyőképeket</link></p>
      </item>
    </list>
  </section>

  <section id="app-context-bar">
    <title>Alkalmazás környezetsávja</title>
    <p>A <app>Szoftver</app> alkalmazásban az alkalmazás környezetsávja csempék gyűjteménye az alkalmazás részletes oldalán, amelyek a következő részleteket jelenítik meg.</p>
    <list>
      <item>
	<p><link xref="#storage">Tárhely</link></p>
      </item>
      <item>
	<p><link xref="#safety">Biztonság</link></p>
      </item>
      <item>
	<p><link xref="#hardware-support">Hardvertámogatás</link></p>
      </item>
      <item>
	<p><link xref="#age-rating">Korhatár-besorolás</link></p>
      </item>
    </list>

    <p its:locNote="Translators: Refer below steps to localize 'figures/app-context-bar.png' image:              1. Run 'gnome-software --details=org.gnome.Software.desktop' in console (as normal user).              2. This should launch the Software app and automatically switch to Software app's details page.              3. It may take some time if some background tasks are running. Wait for the app's details page to load.              4. Scroll down to take the screenshot of the app context bar.">Ez az alkalmazás környezetsávját jeleníti meg a <app>Szoftver</app> alkalmazáshoz:</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.">A csempék a fenti sorrendben jelennek meg (a <code>Tárhely</code> csempével kezdve a bal oldalon).</p>
    <p>Az alábbiakban az egyes csempék részletes ismertetése következik.</p>
  </section>

  <section id="storage">
    <title>Tárhely</title>
    <p>A <app>Szoftver</app> egy tárhely csempét jelenít meg az alkalmazás részletes oldalán. Ha az alkalmazás nincs telepítve, akkor megjeleníti a telepítéséhez szükséges becsült letöltési méretet. Ha az alkalmazás telepítve van, akkor az alkalmazás által használt tárhelyet jeleníti meg.</p>
    <p>A méretek a <app>Szoftver</app> háttérprogramja (például flatpak vagy RPM) által szolgáltatott adatokból kerülnek kiszámításra, és nincsenek megadva az alkalmazás által biztosított metaadatokban. Semmit sem lehet tenni, hogy egy alkalmazás metainformációs fájljának szerkesztésével befolyásolni lehessen ezt a csempét. Ez a teljesség kedvéért van itt feltüntetve.</p>
  </section>

  <section id="safety">
    <title>Biztonság</title>
    <p>A <app>Szoftver</app> egy biztonság csempét jelenít meg az alkalmazás részletes oldalán. Ez összefoglalja az arra vonatkozó információkat, hogy az alkalmazás telepítése és futtatása biztonságosnak tekinthető-e, vagy óvatosságra lehet-e szükség, mielőtt megbízik benne.</p>
    <p>Ez a csempe egyesíti az alkalmazás által a futtatás során kért jogosultságokra vonatkozó információkat (például jogosultság a fájlok olvasásához), valamint az alkalmazás fejlesztésének módjára vonatkozó információkat. A szabad szoftveralkalmazások, amelyeknél a forráskód nyilvánosan olvasható, biztonságosabbak lehetnek, mint a tulajdonosi szoftverek, mivel felülvizsgálhatók.</p>
    <p>A csempére kattintva megjelenő párbeszédablak felsorolja az alkalmazás által kért különböző jogosultságokat, valamint néhány információt a licencről és a futtatókörnyezetről.</p>
    <p>Javíthatja a biztonsági információkat:</p>
    <list>
      <item>
	<p><link xref="#how-to-fix-incorrect-safety-and-permissions-information">Hogyan javíthatja a helytelen biztonsági és jogosultsági információkat</link></p>
      </item>
    </list>
  </section>

  <section id="hardware-support">
    <title>Hardvertámogatás</title>
    <p>A <app>Szoftver</app> egy hardvertámogatás csempét jelenít meg az alkalmazás részletes oldalán. Ez egyesíti az alkalmazás hardverkövetelményeire és a számítógép hardveres képességeire vonatkozó információkat azzal a céllal, hogy kiemelje az inkompatibilitásokat vagy a hiányzó követelményeket – vagy jelezze, hogy az alkalmazásnak megfelelően kell működnie inkompatibilitás nélkül.</p>

    <p>A kód a következő hardvereket vizsgálja. A jövőben több is támogatott lehet.</p>
    <list>
      <item><p>Van-e vagy szükség van-e érintőtáblára, egérre vagy billentyűzetre</p></item>
      <item><p>Szükség van-e játékvezérlőre</p></item>
      <item><p>A legkisebb és ajánlott kijelzőméret, amelyre az alkalmazás skálázható</p></item>
    </list>

    <p>Nem lehet megbízhatóan megállapítani, hogy egy játékvezérlő <em>jelen van-e</em>, mivel gyakran kihúzva maradnak, mert a normál számítógép-használathoz nincs rájuk szükség.</p>
    <p>A csempére kattintva megjelenő párbeszédablak felsorolja az alkalmazás különböző hardverkövetelményeit, és azt, hogy valamelyik nem teljesül-e.</p>
    <p>Javíthatja a hardverinformációkat:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-hardware-information">Hogyan adhat hozzá hiányzó hardverinformációkat</link></p>
      </item>
    </list>
  </section>

  <section id="age-rating">
    <title>Korhatár-besorolás</title>
    <p>A <app>Szoftver</app> egy korhatár-besorolás csempét jelenít meg az alkalmazás részletes oldalán. Ez megmutatja, hogy az alkalmazás milyen korosztály számára megfelelő az alkalmazás által deklarált különböző típusú tartalmak alapján. Ez az információ az Ön országa játék- vagy filmminősítő tanúsítványaihoz hasonló formátumban kerül összefoglalásra.</p>
    <p>Ez például kiemeli, hogy egy játék tartalmaz-e erőszakot, vagy hogy egy alkalmazás tartalmaz-e alkalmazáson belüli reklámot.</p>
    <p>A csempére kattintva megjelenő párbeszédablak felsorolja az alkalmazásban lévő különböző típusú tartalmakat és az adott tartalom súlyosságát.</p>
    <p>Javíthatja a korhatár-besorolási információkat:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-content-rating-information">Hogyan adhat hozzá hiányzó tartalomértékelési információkat</link></p>
      </item>
    </list>
  </section>

  <section id="license">
    <title>Licenc</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>A <app>Szoftver</app> egy olyan csempét jelenít meg, amely jelzi, hogy az alkalmazás <link href="https://hu.wikipedia.org/wiki/Szabad_szoftver">szabad szoftver</link>, vagy a licence tulajdonosi, különleges vagy ismeretlen. Ez a csempe részletesebb információkat tartalmaz a projekt licencéről. Ez a csempe felsorolja az ingyenes szoftverek néhány előnyét is. <link xref="software-licensing#introduction">Tudjon meg többet</link></p>
    <p>Néha a licencinformációk nem megfelelőek egy alkalmazásnál, és így egy valójában szabad szoftverként ismert alkalmazás „tulajdonosiként” jelenik meg. Hasonlóképpen, néha a licencinformációk ismeretlenek.</p>
    <p>A <app>Szoftver</app> zöld színnel emeli ki az ingyenes és nyílt forráskódú licenceket, sárgával pedig a tulajdonosi és különleges licenceket, ahogy itt látható. Az ismeretlen licencek szürkével vannak kiemelve.</p>
    <p>Hozzáadhatja vagy javíthatja a licencinformációkat:</p>
    <list>
      <item>
	<p><link xref="#how-to-fix-incorrect-licensing-information">Hogyan javíthatja a helytelen licencelési információkat</link></p>
      </item>
    </list>
  </section>

  <section id="links">
    <title>Hivatkozások</title>
    <media type="image" src="figures/scalable/links.svg" style="floatend floatright" mime="image/svg" its:translate="no"/>
    <p>A <app>Szoftver</app> megjeleníti az alkalmazás erőforrás-hivatkozásait a hivatkozás csempén. Ezek a következők:</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>Webhely hivatkozása</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>Adományozás hivatkozása</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>Fordítási közreműködés hivatkozása</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>Hibajelentés hivatkozása</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>Súgó hivatkozása</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>Kapcsolatfelvétel hivatkozása</p></td>
      </tr>
    </table>
    <p>Ezen hivatkozások némelyike vagy mindegyike jelen lehet attól függően, hogy szerepelnek-e az alkalmazás metainformációs fájljában.</p>
    <p>Abban az esetben, ha az alkalmazás metainformációs fájlja nem tartalmaz semmilyen hivatkozást, a következő kérdőjellel ellátott csempe jelenik meg.</p>
    <media type="image" src="figures/scalable/no-links.svg" style="floatend floatright" mime="image/svg" its:translate="no"/>
    <p>Javíthatja a hivatkozásokat:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-links">Hogyan adhat hozzá hiányzó hivatkozásokat</link></p>
      </item>
    </list>
  </section>

  <section id="carousel-tile">
    <title>Körhinta csempe</title>
    <media type="image" src="figures/carousel.png" style="floatend floatright" mime="image/png" its:translate="no"/>
    <p>A <app>Szoftver</app> által kiemelt alkalmazások a főablak tetején lévő körhintában jelennek meg, ahogy itt látható. Minden egyes körhinta csempének olyan háttérszíne van, amely az alkalmazás ikonjából kerül automatikusan kinyerésre. Néha ez a háttérszín nem teljesen megfelelő az alkalmazáshoz, és az alkalmazás fejlesztőjének kell kifejezetten megadnia.</p>
    <p>A kiemelt alkalmazások halmazát a Linux disztribúció karbantartói határozzák meg.</p>
    <p>Javíthatja a körhinta csempét:</p>
    <list>
      <item>
	<p><link xref="#how-to-set-the-carousel-tile-background-colour">Hogyan állíthatja be a körhinta csempe háttérszínét</link></p>
      </item>
    </list>
  </section>

  <section id="where-metadata-comes-from">
    <title>Honnan származnak a metaadatok</title>
    <p>A metaadatok, amelyekkel meghatározható, hogy egy szoftver milyen hardvert igényel, milyen korú felhasználók számára alkalmas, és azok a tényezők, amelyek hozzájárulnak ahhoz, hogy mennyire biztonságos a telepítése, mind az adott szoftver metainformációs fájljából származnak.</p>
    <p>A metainformációs fájl egy XML-fájl. A fájl formátuma az <link href="https://www.freedesktop.org/software/appstream/docs/">AppStream specifikációban</link> van megadva.</p>
    <p>Nézze meg a <link href="https://gitlab.gnome.org/GNOME/nautilus/-/blob/main/data/org.gnome.Nautilus.metainfo.xml.in.in">GNOME Fájlok alkalmazás metainformációs fájlját</link>.</p>
    <note style="tip">
      <p>Az <em>appdata</em> a <em>metainfo</em> régebbi elnevezése.</p>
    </note>
  </section>

  <section id="what-happens-if-metadata-is-missing">
    <title>Mi történik, ha a metaadatok hiányoznak</title>
    <p>Ha a metaadatok hiányoznak egy alkalmazásnál, akkor a <app>Szoftver</app> csak találgatni tudja, hogy mi lehet az, és ezért nem sok információt tud megjeleníteni a felületein. A <app>Szoftver</app> találgatásai azon a tényen alapulnak, hogy a legtöbb szoftvert asztali számítógépekre tervezik.</p>
    <p><em style="strong">Segíthet egy alkalmazás metaadatainak javításában!</em></p>
  </section>

  <section id="how-to-contribute-missing-information">
    <title>Hogyan adhat hozzá hiányzó információkat</title>
    <p>Ha úgy találja, hogy egy alkalmazás oldaláról hiányoznak vagy helytelenek az információk, akkor kétféleképpen járulhat hozzá:</p>
    <list type="numbered">
      <item>
	<p>Jelentheti a hiányzó vagy helytelen metaadatokat az adott alkalmazás hibakövetőjében, hogy az alkalmazás fejlesztője javíthassa azokat.</p>
      </item>
      <item>
	<p>A hiányzó vagy helytelen metaadatokat saját maga is kijavíthatja. Nézze meg az alábbi <em style="strong">hogyan</em> útmutatót, hogy hogyan kell ezt megtenni.</p>
      </item>
    </list>

    <p>Mindkettőhöz először meg kell találnia az alkalmazás projektoldalát. A projektoldalra mutató hivatkozásnak általában az alkalmazás oldalán elérhetőnek kell lennie, <link xref="#links">ahogy itt látható</link>. Ha nem, akkor egy egyszerű kereséssel kell megtalálnia az interneten.</p>

    <p>Az alkalmazások tárhelyét jellemzően a <link href="https://gitlab.com/explore?sort=stars_desc">GitLab</link> vagy a <link href="https://github.com/explore">GitHub</link> biztosítja. Például a GNOME alkalmazások tárhelye a <link href="https://gitlab.gnome.org/GNOME?sort=stars_desc">gitlab.gnome.org</link> címen érhető el.</p>
  </section>

  <section id="how-to-add-missing-app-screenshots">
    <title>Hogyan adhat hozzá hiányzó alkalmazás-képernyőképeket</title>
    <p>Egy alkalmazás képernyőkép-információi a metainformációs fájljában lévő <link href="https://www.freedesktop.org/software/appstream/docs/sect-Metadata-Application.html#tag-dapp-screenshots"><code>&lt;screenshots&gt;</code></link> elemben vannak tárolva az alkalmazás <code>&lt;component&gt;</code> elemén belül.</p>
    <p>Egy alkalmazáshoz ajánlott képernyőképek száma 5-10 között van. A képernyőképeknek ideális esetben PNG formátumúnak kell lenniük 16:9 képaránnyal és legalább 620 képpont szélességgel.</p>
    <p>Itt vannak például a <app>Szoftver</app> alkalmazás képernyőkép-bejegyzései:</p>
    <code mime="application/xml">
&lt;screenshots&gt;
  &lt;screenshot type="default"&gt;
    &lt;image&gt;https://gitlab.gnome.org/GNOME/gnome-software/raw/HEAD/data/metainfo/ss-overview.png&lt;/image&gt;
    &lt;caption&gt;Overview panel&lt;/caption&gt;
  &lt;/screenshot&gt;
  &lt;screenshot&gt;
    &lt;image&gt;https://gitlab.gnome.org/GNOME/gnome-software/raw/HEAD/data/metainfo/ss-details.png&lt;/image&gt;
    &lt;caption&gt;Details panel&lt;/caption&gt;
  &lt;/screenshot&gt;
&lt;/screenshots&gt;</code>
</section>

  <section id="how-to-fix-incorrect-safety-and-permissions-information">
    <title>Hogyan javíthatja a helytelen biztonsági és jogosultsági információkat</title>
    <p>Egy alkalmazás biztonsági és jogosultsági információi különböző forrásokból származnak, attól függően, hogy az alkalmazás hogyan van csomagolva. A hagyományosan csomagolt alkalmazások esetében, például az RPM vagy DEB formátumban lévőknél nem érhetők el biztonsági vagy jogosultsági információk, és semmit sem lehet tenni, hogy ezek hozzáadásra kerüljenek egy alkalmazáshoz.</p>
    <p>A flatpak-alkalmazások esetében az információk az alkalmazás <link href="https://docs.flatpak.org/en/latest/manifests.html">flatpak manifest</link> fájljából származnak, amely meghatározza, hogy az alkalmazásnak milyen lyukakra van szüksége a védett környezetben. Ezen lyukak mindegyike jellemzően hozzájárul az alkalmazásnak a <app>Szoftver</app> alkalmazásban megjelenített biztonsági szintje csökkentéséhez – a „biztonságos” besorolástól a „potenciálisan nem biztonságos” besoroláson keresztül a „nem biztonságos” besorolásig.</p>
    <p>Egy alkalmazás biztonsági szintjének javítása érdekében a védett környezetét a lehető legszigorúbbá kell tenni, eltávolítva a <link href="https://docs.flatpak.org/en/latest/sandbox-permissions.html">védett környezet engedélyeit</link> ott, ahol nincs rájuk szükség, és <link href="https://docs.flatpak.org/en/latest/desktop-integration.html#portals">portálokat</link> kell használni a védett környezet engedélyei helyett, ahol ez lehetséges. A portálok használata nem csökkenti egy alkalmazás megjelenített biztonsági szintjét a <app>Szoftver</app> alkalmazásban.</p>
    <p>Ha például az alkalmazás írási és olvasási hozzáférést kér a teljes fájlrendszerhez (<code>--filesystem=host</code>), akkor valóban szüksége van erre, vagy csak néhány meghatározott helyen lévő fájlhoz kell hozzáférnie? Ha ez a helyzet, akkor a <link href="https://docs.flatpak.org/en/latest/desktop-integration.html#portals">fájlportál</link> is használható, vagy a specifikusabb <link href="https://docs.flatpak.org/en/latest/sandbox-permissions.html#filesystem-access">fájlrendszer-jogosultságok</link> is megadhatók.</p>
    <p>Ha az alkalmazás Waylanden működik, és csak tartalékként kell működnie az X11-en, anélkül hogy különleges X11-funkciókat használna, használhatná a <code>--socket=fallback-x11</code> kapcsolót a <code>--socket=x11</code> helyett?</p>
    <p>A jövőben bizonyos jogosultságokra vagy más csomagolási formátumokra vonatkozó útmutatások kerülhetnek ide.</p>
    <p>További olvasnivaló:</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>Hogyan adhat hozzá hiányzó hardverinformációkat</title>
    <p>Egy alkalmazás hardverinformációi a metainformációs fájljában lévő <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-relations"><code>&lt;requires&gt;</code>, <code>&lt;recommends&gt;</code> és <code>&lt;supports&gt;</code></link> elemekben vannak tárolva az alkalmazás <code>&lt;component&gt;</code> elemén belül.</p>
    <p>A <app>Szoftver</app> megérti a <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-relations-control"><code>&lt;control&gt;</code></link> és a <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-relations-display_length"><code>&lt;display_length&gt;</code></link> elemeket.</p>
    <p>Metaadatok példájáért nézze meg <link href="https://tecnocode.co.uk/2021/07/12/add-metadata-to-your-app-to-say-what-inputs-and-display-sizes-it-supports/">ezt a blogbejegyzést</link> vagy <link href="https://blogs.gnome.org/tbernard/2021/09/07/ready-for-software-41/#device-support">ezt a blogbejegyzést</link>.</p>
  </section>

  <section id="how-to-add-missing-content-rating-information">
    <title>Hogyan adhat hozzá hiányzó tartalomértékelési információkat</title>
    <p>Egy alkalmazás tartalomértékelési információi a metainformációs fájljában lévő <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-content_rating"><code>&lt;content_rating&gt;</code></link> elemben vannak tárolva az alkalmazás <code>&lt;component&gt;</code> elemén belül.</p>
    <p>Az alkalmazásoknak az OARS 1.1 szabványt kell használniuk ennek az elemnek a kitöltéséhez. Ha a <code>&lt;content_rating&gt;</code> elem nincs megadva, akkor az alkalmazás tartalombesorolása ismeretlen. Ha meg van adva, de üres, akkor az alkalmazásnak nincs olyan tartalma, amely bármely közönség számára alkalmatlan lehet.</p>
    <p>Használja az <link href="https://hughsie.github.io/oars/">OARS előállítót</link> az alkalmazáshoz megfelelő tartalombesorolási információk előállításához.</p>
  </section>

  <section id="how-to-fix-incorrect-licensing-information">
    <title>Hogyan javíthatja a helytelen licencelési információkat</title>
    <p>Egy alkalmazás licencelési információi a metainformációs fájljában lévő <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-project_license"><code>&lt;project_license&gt;</code></link> elemben vannak tárolva az alkalmazás <code>&lt;component&gt;</code> elemén belül.</p>
    <p>Az ebben az elemben lévő tartalomnak <link href="https://spdx.org/specifications">SPDX-kifejezésnek</link> kell lennie, amely a projekt „fő” licencét írja le. Ez általában a kód licencét jelenti, és nem tartalmazza a dokumentáció vagy a kiegészítő tartalom licencét.</p>
    <p>Ha az SPDX-kifejezés egyetlen licenc vagy több licenc „vagy” kombinációja, amelyek mindegyike az <link href="https://spdx.org/licenses/">FSF vagy OSI által jóváhagyott</link>, akkor az alkalmazás „szabad szoftvernek” tekinthető, és a licenc csempe is ezt mondja róla. Ellenkező esetben „tulajdonosi” szoftvernek minősül.</p>
    <p>Ha egy alkalmazás „tulajdonosi” jelzéssel van megjelenítve, miközben úgy gondolja, hogy nem kellene, akkor valószínűleg a <code>&lt;project_license&gt;</code> elem tartalmazza a projekt dokumentációs licencét. Távolítsa el.</p>
    <p><link href="https://gitlab.gnome.org/GNOME/meld/-/issues/579">Például</link> változtassa meg a licenc metaadatait erről:</p>
    <code mime="application/xml">&lt;project_license&gt;GPL-2.0+ and CC-BY-SA-3.0&lt;/project_license&gt;</code>
    <p>erre:</p>
    <code mime="application/xml">&lt;project_license&gt;GPL-2.0+&lt;/project_license&gt;</code>
    <p>További olvasnivaló:</p>
    <list>
      <item>
	<p><link href="https://tecnocode.co.uk/2021/07/05/dont-generally-put-cc-by-sa-in-appdata/">Ne tegye (általában) a dokumentáció licencét az alkalmazásadatokba</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>Hogyan adhat hozzá hiányzó hivatkozásokat</title>
    <p>Egy alkalmazás hivatkozásai a metainformációs fájljában lévő <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-url"><code>&lt;url&gt;</code></link> elemben vannak tárolva az alkalmazás <code>&lt;component&gt;</code> elemén belül.</p>
    <p>Az <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-url">appstream specifikációjában</link> dokumentált hivatkozási típusok közül annyit adjon hozzá, amennyi az alkalmazáshoz elérhető. Ha egy adott hivatkozási típushoz nem létezik megfelelő oldal, akkor azt nem kell felvenni.</p>
    <p>Itt vannak például a <app>Szoftver</app> alkalmazás erőforrás-hivatkozásai:</p>
    <code mime="application/xml">
&lt;url type="bugtracker"&gt;https://gitlab.gnome.org/GNOME/gnome-software/-/issues&lt;/url&gt;
&lt;url type="contact"&gt;https://discourse.gnome.org/tag/gnome-software&lt;/url&gt;
&lt;url type="contribute"&gt;https://welcome.gnome.org/app/Software/&lt;/url&gt;
&lt;url type="donation"&gt;https://www.gnome.org/donate/&lt;/url&gt;
&lt;url type="homepage"&gt;https://apps.gnome.org/Software&lt;/url&gt;
&lt;url type="translate"&gt;https://l10n.gnome.org/module/gnome-software/&lt;/url&gt;
&lt;url type="vcs-browser"&gt;https://gitlab.gnome.org/GNOME/gnome-software/&lt;/url&gt;</code>
  </section>

  <section id="how-to-set-the-carousel-tile-background-colour">
    <title>Hogyan állíthatja be a körhinta csempe háttérszínét</title>
    <p>A körhinta csempe háttérszíne általában az alkalmazás ikonjából kerül automatikusan kinyerésre. Ha azonban ez a szín nem kielégítő, akkor az <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-branding">appstream <code>&lt;branding/&gt;</code> elemének</link> használatával felülbírálható a deklarált színekkel (a 47.x sorozat óta). Ennek előnye, hogy több ügyfél használhatja a színeket.</p>
    <p>Itt van például néhány arculati bejegyzés:</p>
    <code mime="application/xml">
&lt;branding&gt;
  &lt;color type="primary" scheme_preference="light"&gt;#ff00ff&lt;/color&gt;
  &lt;color type="primary" scheme_preference="dark"&gt;#993d3d&lt;/color&gt;
&lt;/branding&gt;</code>
    <note>
      <p>Ne feledje, hogy a <code>scheme_preference</code> attribútum figyelmen kívül marad, a <app>Szoftver</app> a legjobb színt maga választja ki a témához.</p>
    </note>
    <p>A visszafelé kompatibilitás érdekében megmaradt a lehetőség, hogy a következő XML-t hozzáadja az alkalmazás metainformációiban lévő <code>&lt;component&gt;</code> elemhez:</p>
    <code mime="application/xml">
&lt;custom&gt;
  &lt;value key="GnomeSoftware::key-colors"&gt;[(124, 53, 77), (99, 16, 0)]&lt;/value&gt;
&lt;/custom&gt;</code>
    <p>de a <code>&lt;branding/&gt;</code> elemnek elsőbbsége van.</p>
    <p>A <code>GnomeSoftware::key-colors</code> értéke egy <code>a(yyy)</code> típusú, szöveges formátumú GVariant, és az alkalmazás kulcsszíneinek rendezetlen halmazát jelenti. A halmaz minden eleme egy RGB formában lévő szín, amely a <code>(0, 0, 0)</code> és <code>(255, 255, 255)</code> közötti tartományban van.</p>
    <p>A színeket úgy kell megválasztani, hogy:</p>
    <list>
      <item>
	<p>Azonosíthatóak legyenek az alkalmazással, lehetőleg valamilyen módon illeszkedjenek az alkalmazás arculatához.</p>
      </item>
      <item>
	<p>Kontrasztosak legyenek az alkalmazás ikonjának szélével, hogy ha háttérként használják mögötte, akkor az ikon megkülönböztethető legyen.</p>
      </item>
      <item>
	<p>Kontrasztosak legyenek az Adwaita témában lévő előtér szövegszínében (<code>#2e3436</code>) és annak sötét változatában (<code>#eeeeec</code>). Ez általában egy közepes fényerősségszintű szín kiválasztását jelenti.</p>
      </item>
      <item>
	<p>A kontrasztot a <link href="https://flathub.org/apps/org.gnome.design.Contrast/">Kontraszt alkalmazás</link> használatával lehet ellenőrizni.</p>
      </item>
    </list>
    <p>Legalább egy színt meg kell adni. Több szín is megadható, ha egy szín nem elégíti ki a fenti követelményeket, és a <app>Szoftver</app> a legmegfelelőbbet fogja kiválasztani a körhinta csempében való használathoz. Ha pontosan egy szín van megadva, akkor annak fényereje és telítettsége módosítható, hogy javítsa a kontrasztot az előtér színével. Ha egynél több szín van megadva, akkor az előtérszínnel legjobban kontrasztos szín lesz kiválasztva, és annak fényereje és telítettsége nem kerül módosításra.</p>
  </section>

  <section id="how-to-test-carousel-tile-background-colour-changes">
    <title>Hogyan próbálhatja ki a körhinta csempe háttérszínének változtatásait</title>
    <p>Módosítsa az alkalmazás metainformációs fájlját, majd futtassa a <app>Szoftver</app> alkalmazást a következővel:</p>
    <p><cmd>gnome-software --show-metainfo=<var>/path/to/app.metainfo.xml</var>,icon=<var>/path/to/app/icon.png</var></cmd></p>
    <p>Az alkalmazás részletes oldala fog megjelenni. Ha visszanavigál a <app>Szoftver</app> áttekintő oldalára, akkor az Ön alkalmazása lesz az egyetlen a „kiemelt” körhintában.</p>
  </section>


</page>
