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

  <info>
    <link type="guide" xref="index"/>

    <credit type="author">
      <name>Филип Витнал</name>
      <email its:translate="no">philip@tecnocode.co.uk</email>
    </credit>
    <credit type="author">
      <name>Вил Томпсон</name>
      <email its:translate="no">wjt@endlessos.org</email>
    </credit>
    <credit type="author">
      <name>Милан Црха</name>
      <email its:translate="no">mcrha@redhat.com</email>
    </credit>

    <include xmlns="http://www.w3.org/2001/XInclude" href="legal.xml"/>

    <desc>Како <app>Програми</app> користе метаподатке</desc>
  </info>

  <title>Метаподаци програма</title>
  <links type="section"/>

  <section id="screenshots">
    <title>Снимци екрана</title>
    <media type="image" src="figures/app-screenshot.png" style="floatend floatright" mime="image/png" its:translate="no"/>
    <p><app>Програми</app> приказују снимке екрана на страници са детаљима програма. Ово би обично требало да укључује снимке екрана различитих прозора / прозорчића програма, како би корисник брзо стекао увид у могућности, изглед и осећај програма итд.</p>
    <p>Када је у датотеци са метаподацима програма присутно више од једног снимка екрана, <app>Програми</app> ће приказати снимке екрана у вртуљку.</p>
    <p>У случајевима када датотека са метаподацима програма не садржи ниједан снимак екрана, биће приказана иконица чувара места као испод са натписом <code>Нема снимака екрана</code>:</p>
    <media type="image" src="figures/scalable/symbolic/image-missing-symbolic.svg" width="96" mime="image/svg" its:translate="no"/>
    <note>
      <p>Иконица чувара места може изгледати другачије ако користите произвољну тему иконица.</p>
    </note>
    <p>Снимци екрана могу застарети како се корисничко прочеље програма мења. Дакле, чак и ако <app>Програми</app> приказују снимке екрана за неки програм, важно је проверити да ли су ти снимци екрана ажурни или застарели.</p>
    <p>Можете побољшати податке о снимцима екрана програма:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-app-screenshots">Како додати недостајуће снимке екрана програма</link></p>
      </item>
    </list>
  </section>

  <section id="app-context-bar">
    <title>Трака контекста програма</title>
    <p>Трака контекста програма у <app>Програмима</app> је збирка плочица на страници са детаљима програма, које приказују следеће појединости.</p>
    <list>
      <item>
	<p><link xref="#storage">Складиште</link></p>
      </item>
      <item>
	<p><link xref="#safety">Безбедност</link></p>
      </item>
      <item>
	<p><link xref="#hardware-support">Хардверска подршка</link></p>
      </item>
      <item>
	<p><link xref="#age-rating">Оцена према узрасту</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.">Ово приказује траку контекста програма за апликацију <app>Програми</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.">Плочице су приказане редоследом наведеним изнад (почевши са плочицом <code>Складиште</code> на левој страни).</p>
    <p>Свака плочица је детаљно описана испод.</p>
  </section>

  <section id="storage">
    <title>Складиште</title>
    <p><app>Програми</app> приказују плочицу складишта на страници са детаљима апликације. Ако апликација није инсталирана, овде се приказује процењена величина преузимања потребна за њену инсталацију. Ако је апликација инсталирана, приказује се простор на диску који апликација користи.</p>
    <p>Величине се израчунавају на основу података које доставља позадинац <app>Програми</app> (као што је флетпек или RPM) и нису наведене у метаподацима које доставља апликација. Не можете ништа учинити да утичете на ову плочицу уређивањем датотеке са метаподацима апликације. Овде је наведена ради потпуности.</p>
  </section>

  <section id="safety">
    <title>Безбедност</title>
    <p><app>Програми</app> приказују плочицу безбедности на страници са детаљима апликације. Ово сажима информације о томе да ли се апликација може сматрати безбедном за инсталацију и покретање, или је потребан опрез пре него што јој се укаже поверење.</p>
    <p>Ова плочица комбинује информације о овлашћењима која апликација захтева приликом покретања (као што је дозвола за читање ваших датотека), са информацијама о томе како је апликација развијена. Апликације слободног софтвера, где је изворни код јавно доступан, могу бити безбедније од власничких, јер се могу проверити.</p>
    <p>Прозорче које се појављује када се кликне на плочицу наводи различита овлашћења која апликација захтева, уз неке информације о њеној лиценци и извршном окружењу.</p>
    <p>Можете побољшати информације о безбедности:</p>
    <list>
      <item>
	<p><link xref="#how-to-fix-incorrect-safety-and-permissions-information">Како исправити нетачне информације о безбедности и овлашћењима</link></p>
      </item>
    </list>
  </section>

  <section id="hardware-support">
    <title>Хардверска подршка</title>
    <p><app>Програми</app> приказују плочицу хардверске подршке на страници са детаљима апликације. Ово комбинује информације о хардверским захтевима апликације и хардверским могућностима рачунара, са циљем да истакне некомпатибилности или недостајуће захтеве — или да укаже на то да би апликација требало да ради исправно без некомпатибилности.</p>

    <p>Код разматра следећи хардвер. Више њих може бити подржано у будућности.</p>
    <list>
      <item><p>Да ли је додирна табла, миш или тастатура присутна/потребна</p></item>
      <item><p>Да ли је контролер за видео игре потребан</p></item>
      <item><p>Најмања и препоручена величина екрана на коју се програм може прилагодити</p></item>
    </list>

    <p>Није могуће поуздано открити да ли је контролер за видео игре <em>присутан</em>, јер су они често искључени пошто нису потребни за уобичајено коришћење рачунара.</p>
    <p>Прозорче које се појављује када се кликне на плочицу набраја различите хардверске захтеве програма, као и то да ли је неки од њих неиспуњен.</p>
    <p>Можете побољшати податке о хардверу:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-hardware-information">Како додати недостајуће податке о хардверу</link></p>
      </item>
    </list>
  </section>

  <section id="age-rating">
    <title>Оцена старосне прикладности</title>
    <p><app>Програми</app> приказују плочицу са оценом старосне прикладности на страници са детаљима програма. Ово показује за који узраст би програм требало да буде прикладан, на основу различитих врста садржаја за које је програм навео да их садржи. Ови подаци су сажети у формату сличном сертификатима за оцењивање игара или филмова у вашој држави.</p>
    <p>На пример, ово ће истаћи да ли игра садржи насиље или да ли апликација садржи оглашавање унутар програма.</p>
    <p>Прозорче које се појављује када се кликне на плочицу набраја различите врсте садржаја у програму и колико је тај садржај озбиљан.</p>
    <p>Можете побољшати податке о оцени старосне прикладности:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-content-rating-information">Како додати недостајуће податке о оцени садржаја</link></p>
      </item>
    </list>
  </section>

  <section id="license">
    <title>Лиценца</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>Програми</app> приказују плочицу која указује на то да ли је програм <link href="https://en.wikipedia.org/wiki/Free_and_open-source_software">слободан софтвер</link> или је његова лиценца власничка, посебна или непозната. Ова плочица укључује детаљније податке о лиценци пројекта. Такође набраја неке од предности слободног софтвера. <link xref="software-licensing#introduction">Сазнајте више</link></p>
    <p>Понекама подаци о лиценци нису тачни за програм, па се програм који је заправо слободан софтвер може приказати као „власнички“. Слично томе, понекад су подаци о лиценци непознати.</p>
    <p><app>Програми</app> истичу слободне лиценце и лиценце отвореног кода зеленом бојом, а власничке и посебне лиценце жутом бојом, као што је овде приказано. Непознате лиценце су истакнуте сивом бојом.</p>
    <p>Можете додати или побољшати податке о лиценци:</p>
    <list>
      <item>
	<p><link xref="#how-to-fix-incorrect-licensing-information">Како исправити нетачне податке о лиценцирању</link></p>
      </item>
    </list>
  </section>

  <section id="links">
    <title>Везе</title>
    <media type="image" src="figures/scalable/links.svg" style="floatend floatright" mime="image/svg" its:translate="no"/>
    <p><app>Програми</app> приказују списак веза ка ресурсима апликације у плочици са везама. Оне су следеће:</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>Веза ка веб сајту</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>Веза за донације</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>Веза за допринос преводу</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>Веза за пријављивање грешака</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>Веза ка помоћи</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>Веза за контакт</p></td>
      </tr>
    </table>
    <p>Неке или све ове везе могу бити присутне у зависности од тога да ли су наведене у датотеци са подацима о апликацији (metainfo).</p>
    <p>У случајевима када датотека са подацима о апликацији не садржи ниједну везу, биће приказана следећа плочица са знаком питања.</p>
    <media type="image" src="figures/scalable/no-links.svg" style="floatend floatright" mime="image/svg" its:translate="no"/>
    <p>Можете побољшати везе:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-links">Како додати недостајуће везе</link></p>
      </item>
    </list>
  </section>

  <section id="carousel-tile">
    <title>Плочица вртуљка</title>
    <media type="image" src="figures/carousel.png" style="floatend floatright" mime="image/png" its:translate="no"/>
    <p>Апликације које су издвојене у <app>Програмима</app> приказане су у вртуљку на врху главног прозора, као што је овде приказано. Свака плочица вртуљка има боју позадине која се аутоматски извлачи из иконице апликације. Понекад ова боја позадине није сасвим одговарајућа за апликацију и програмер апликације је мора изричито навести.</p>
    <p>Скуп апликација које су издвојене одређују одржаваоци Линукс дистрибуције.</p>
    <p>Можете побољшати плочицу вртуљка:</p>
    <list>
      <item>
	<p><link xref="#how-to-set-the-carousel-tile-background-colour">Како поставити боју позадине плочице вртуљка</link></p>
      </item>
    </list>
  </section>

  <section id="where-metadata-comes-from">
    <title>Одакле долазе метаподаци</title>
    <p>Метаподаци који се користе за навођење хардвера који је потребан неком софтверу, за који узраст корисника је прикладан и фактори који доприносе томе колико је безбедан за инсталирање, сви долазе из датотеке са метаподацима (metainfo) за тај софтвер.</p>
    <p>Датотека са метаподацима је XML датотека. Формат датотеке је наведен у <link href="https://www.freedesktop.org/software/appstream/docs/">AppStream спецификацији</link>.</p>
    <p>Погледајте <link href="https://gitlab.gnome.org/GNOME/nautilus/-/blob/main/data/org.gnome.Nautilus.metainfo.xml.in.in">датотеку са метаподацима за програм Гномова датотеке</link>.</p>
    <note style="tip">
      <p><em>appdata</em> је старији термин за <em>metainfo</em>.</p>
    </note>
  </section>

  <section id="what-happens-if-metadata-is-missing">
    <title>Шта се дешава ако метаподаци недостају</title>
    <p>Ако неки метаподаци недостају за апликацију, <app>Програми</app> могу само да нагађају шта би то могло бити, те стога не може да прикаже много информација у својим прочељима. Претпоставке које <app>Програми</app> праве засноване су на чињеници да је већина софтвера дизајнирана за стоне рачунаре.</p>
    <p><em style="strong">Можете помоћи у побољшању метаподатака за апликацију!</em></p>
  </section>

  <section id="how-to-contribute-missing-information">
    <title>Како допринети информацијама које недостају</title>
    <p>Ако откријете да на страници програма недостају подаци или су подаци нетачни, можете допринети на један од два начина:</p>
    <list type="numbered">
      <item>
	<p>Можете пријавити недостајуће / нетачне метаподатке пратиоцу грешака одговарајућег програма, како би програмер апликације могао то да поправи.</p>
      </item>
      <item>
	<p>Можете сами поправити недостајуће / нетачне метаподатке. Погледајте водич <em style="strong">Како да</em> испод о томе како то да урадите.</p>
      </item>
    </list>

    <p>За оба начина, прво треба да пронађете страницу пројекта апликације. Веза до странице пројекта би обично требало да буде доступна на страници програма <link xref="#links">као што је овде приказано</link>. Ако није, мораћете да је пронађете једноставном претрагом на Гуглу.</p>

    <p>Програми се обично налазе на <link href="https://gitlab.com/explore?sort=stars_desc">Гитлабу</link> или <link href="https://github.com/explore">Гитхабу</link>. На пример, Гномови програми се налазе на <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>Како додати снимке екрана програма који недостају</title>
    <p>Подаци о снимцима екрана за апликацију чувају се у елементу <link href="https://www.freedesktop.org/software/appstream/docs/sect-Metadata-Application.html#tag-dapp-screenshots"><code>&lt;screenshots&gt;</code></link> унутар <code>&lt;component&gt;</code> апликације у њеној metainfo датотеци.</p>
    <p>Препоручени број снимака екрана за програм је између 5 до 10. Снимци екрана би идеално требало да буду у PNG формату са односом ширине и висине 16:9 и минималном ширином од 620 пиксела.</p>
    <p>На пример, ево уноса снимака екрана за програм <app>Програми</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>Како поправити нетачне податке о безбедности и овлашћењима</title>
    <p>Подаци о безбедности и овлашћењима за неку апликацију долазе из различитих извора у зависности од тога како је апликација упакована. За традиционално упаковане апликације, на пример у RPM или DEB формату, подаци о безбедности или овлашћењима нису доступни и ништа се не може учинити да се они додају апликацији.</p>
    <p>За Флетпек апликације, подаци долазе из апликационог <link href="https://docs.flatpak.org/en/latest/manifests.html">флетпек манифеста</link>, који одређује које рупе у изолацији (sandbox) апликација захтева. Свака од ових рупа обично доприноси снижавању приказаног нивоа безбедности апликације у <app>Програмима</app> — померајући га са „безбедно“ на „потенцијално небезбедно“ до „небезбедно“.</p>
    <p>Како би се побољшао ниво безбедности апликације, њена изолација мора бити што је могуће строжа, уклањањем <link href="https://docs.flatpak.org/en/latest/sandbox-permissions.html">овлашћења изолације</link> тамо где нису потребна, и коришћењем <link href="https://docs.flatpak.org/en/latest/desktop-integration.html#portals">портала</link> уместо овлашћења изолације где год је то могуће. Коришћење портала не снижава приказани ниво безбедности апликације у <app>Програмима</app>.</p>
    <p>На пример, ако апликација захтева приступ за читање/писање читавом систему датотека (<code>--filesystem=host</code>), да ли јој је то заиста потребно, или јој је потребан приступ само датотекама на неколико специфичних места? Ако је тако, може се користити <link href="https://docs.flatpak.org/en/latest/desktop-integration.html#portals">портал датотека</link>, или се могу навести специфичнија <link href="https://docs.flatpak.org/en/latest/sandbox-permissions.html#filesystem-access">овлашћења система датотека</link>.</p>
    <p>Ако апликација ради на Вејленду, а потребан јој је рад на Икс-11 систему само као резерва, без коришћења посебних Икс-11 могућности, да ли би могла да користи <code>--socket=fallback-x11</code> уместо <code>--socket=x11</code>?</p>
    <p>Упутства о специфичним овлашћењима, или другим форматима паковања, могу бити додата овде у будућности.</p>
    <p>Даље читање:</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>Како додати недостајуће податке о хардверу</title>
    <p>Подаци о хардверу за апликацију се чувају унутар елемената <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-relations"><code>&lt;requires&gt;</code>, <code>&lt;recommends&gt;</code> и <code>&lt;supports&gt;</code></link> унутар <code>&lt;component&gt;</code> апликације у њеној датотеци метаподатака.</p>
    <p><app>Програми</app> разумеју елементе <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-relations-control"><code>&lt;control&gt;</code></link> и <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>Погледајте <link href="https://tecnocode.co.uk/2021/07/12/add-metadata-to-your-app-to-say-what-inputs-and-display-sizes-it-supports/">овај блог чланак</link> или <link href="https://blogs.gnome.org/tbernard/2021/09/07/ready-for-software-41/#device-support">овај блог чланак</link> за примере метаподатака.</p>
  </section>

  <section id="how-to-add-missing-content-rating-information">
    <title>Како додати недостајуће податке о оцени садржаја</title>
    <p>Подаци о оцени садржаја за апликацију се чувају у елементу <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-content_rating"><code>&lt;content_rating&gt;</code></link> унутар <code>&lt;component&gt;</code> апликације у њеној датотеци метаподатака.</p>
    <p>Апликације треба да користе OARS 1.1 стандард за попуњавање овог елемента. Ако елемент <code>&lt;content_rating&gt;</code> није наведен, оцена садржаја апликације је непозната. Ако је наведен али је празан, апликација нема садржај који би могао бити неприкладан за било коју публику.</p>
    <p>Користите <link href="https://hughsie.github.io/oars/">OARS генератор</link> за стварање прикладних података о оцени садржаја за апликацију.</p>
  </section>

  <section id="how-to-fix-incorrect-licensing-information">
    <title>Како поправити нетачне податке о лиценцирању</title>
    <p>Подаци о лиценцирању за апликацију се чувају у елементу <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-project_license"><code>&lt;project_license&gt;</code></link> унутар <code>&lt;component&gt;</code> апликације у њеној датотеци метаподатака.</p>
    <p>Садржај у овом елементу треба да буде <link href="https://spdx.org/specifications">SPDX израз</link> који описује „главну“ лиценцу пројекта. Ово би обично требало да буде лиценца кода, и не би требало да укључује лиценцу документације или пратећег садржаја.</p>
    <p>Ако је SPDX израз једна лиценца, или „или“ комбинација више лиценци, које су све <link href="https://spdx.org/licenses/">одобрене од стране FSF-а или OSI-ја</link>, апликација се сматра „слободним софтвером“ и поље за лиценцу то и каже. У супротном, сматра се „власничком“.</p>
    <p>Ако се апликација приказује као „власничка“ када мислите да не би требало, вероватно је да елемент <code>&lt;project_license&gt;</code> укључује лиценцу документације за пројекат. Уклоните га.</p>
    <p><link href="https://gitlab.gnome.org/GNOME/meld/-/issues/579">На пример</link>, промените метаподатке лиценце из:</p>
    <code its:translate="no" mime="application/xml"><![CDATA[<project_license>GPL-2.0+ and CC-BY-SA-3.0</project_license>]]></code>
    <p>у</p>
    <code its:translate="no" mime="application/xml"><![CDATA[<project_license>GPL-2.0+</project_license>]]></code>
    <p>Даље читање:</p>
    <list>
      <item>
	<p><link href="https://tecnocode.co.uk/2021/07/05/dont-generally-put-cc-by-sa-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>Како додати недостајуће везе</title>
    <p>Везе за апликацију се чувају као елементи <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-url"><code>&lt;url&gt;</code></link> унутар <code>&lt;component&gt;</code> апликације у њеној датотеци метаподатака (metainfo).</p>
    <p>Додајте онолико врста веза документованих у <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-url">апстрим спецификацији</link> колико је доступно за апликацију. Ако не постоји одговарајућа страница за дату врсту везе, она не мора бити укључена.</p>
    <p>На пример, ево веза ресурса за програм <app>Програми</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>Како поставити боју позадине плочице вртуљка</title>
    <p>Боја позадине плочице вртуљка се обично извлачи аутоматски из иконице апликације. Ако је та боја незадовољавајућа, међутим, може се преклопити коришћењем <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-branding">апстрим елемента <code>&lt;branding/&gt;</code></link> са објављеним бојама (од серије 47.x). Предност је што више клијената може користити те боје.</p>
    <p>На пример, ево неких уноса брендирања:</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>Имајте на уму да се атрибут <code>scheme_preference</code> занемарује, <app>Програми</app> сами бирају бољу боју за тему.</p>
    </note>
    <p>Остављена је, ради повратне компатибилности, могућност додавања следећег XML-а у елемент <code>&lt;component&gt;</code> метаподатака апликације:</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>али елемент <code>&lt;branding/&gt;</code> има предност.</p>
    <p>Вредност <code>GnomeSoftware::key-colors</code> је GVariant текстуалног формата са врстом <code>a(yyy)</code>, и представља неуређени скуп кључних боја за апликацију. Сваки елемент скупа је боја у RGB облику у распону од <code>(0, 0, 0)</code> до <code>(255, 255, 255)</code>.</p>
    <p>Боје треба изабрати тако да:</p>
    <list>
      <item>
	<p>Буду препознатљиве за апликацију, поклапајући се са брендирањем апликације на неки начин, ако је могуће.</p>
      </item>
      <item>
	<p>Буду у контрасту са ивицом иконице апликације, тако да када се користе као позадина иза ње, иконица може да се разликује.</p>
      </item>
      <item>
	<p>Буду у контрасту са бојом текста прочеља у теми Адвајта (<code>#2e3436</code>) и у њеној тамној варијанти (<code>#eeeeec</code>). Ово углавном значи бирање боје са средњим нивоом осветљености.</p>
      </item>
      <item>
	<p>Контраст се може проверити помоћу <link href="https://flathub.org/apps/org.gnome.design.Contrast/">програма Контраст</link>.</p>
      </item>
    </list>
    <p>Барем једна боја треба бити наведена. Више њих се може навести ако једна боја не може да задовољи све горенаведене захтеве, а <app>Програми</app> ће изабрати најприкладнију за коришћење у плочици вртуљка. Ако је наведена тачно једна боја, њено осветљење и засићеност могу бити измењени ради побољшања контраста са бојом прочеља. Ако је наведено више од једне боје, биће изабрана она са најбољим контрастом са бојом прочеља, а њено осветљење и засићеност неће бити мењани.</p>
  </section>

  <section id="how-to-test-carousel-tile-background-colour-changes">
    <title>Како тестирати промене боје позадине плочице вртуљка</title>
    <p>Измените метаподатке вашег програма, а затим покрените <app>Програме</app> помоћу:</p>
    <p><cmd>gnome-software --show-metainfo=<var>/путања/до/програма.metainfo.xml</var>,icon=<var>/путања/до/иконице/програма.png</var></cmd></p>
    <p>Биће приказана страница са детаљима вашег програма. Ако се вратите на страницу прегледа у <app>Програмима</app>, ваш програм ће бити једини у вртуљку „издвојено“.</p>
  </section>


</page>
