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

  <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>Как „<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>Когато в metainfo файлa на програмата има повече от една снимка на екрана, „<app>Програми</app>“ ще покаже снимките на екрана във въртележка.</p>
    <p>В случаите, когато metainfo файлът на програмата не съдържа никаква снимка на екрана, ще бъде показана иконка на мястото, както е посочено по—долу, с <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>“ (като flatpak или RPM), и не са посочени в метаданните, предоставени от програмата. Не може да направите нищо, за да повлияете на тази плочка, като редактирате файла metainfo на програмата. Тя е посочена тук за пълнота.</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>В случаите, когато metainfo файлът на програмата не съдържа никаква връзка, ще се покаже следната плочка с въпросителен знак.</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>Наборът от програми, които са включени, се определя от поддръжниците на Linux дистрибуцията.</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>Файлът metainfo е 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">metainfo файла за програмата „Файлове“</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>. Ако това не е така, ще трябва да я намерите, като търсите с Google.</p>

    <p>Програмите обикновено се хостват в <link href="https://gitlab.com/explore?sort=stars_desc">GitLab</link> или <link href="https://github.com/explore">GitHub</link>. Например приложенията на GNOME се хостват в <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>За flatpak програмите информацията идва от flatpak манифеста на програмата, в който се посочва какви дупки в ограничения режим изисква програмата. Всяка от тези дупки обикновено допринася за понижаване на показаното ниво на сигурност на програмата в „<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>Ако програмата работи на Wayland и трябва да работи на X11 само като резервен вариант, без да използва специални функции на X11, може ли да използва <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> елемента на програмата в неговия metainfo файл.</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> елемента на програмата в неговия metainfo файл.</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> елемента на програмата в неговия metainfo файл.</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/">Не поставяйте (обикновено) лиценз за документация в 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">appstream описанието</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">appstream елемента <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 към metainfo елемента <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>Да има контраст с цвета на текста на преден план в Adwaita темата (<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>Променете metainfo файла за вашата програмата и след това стартирайте „<app>Програми</app>“ с:</p>
    <p><cmd>gnome-software --show-metainfo=<var>/път/към/app.metainfo.xml</var>,icon=<var>/път/към/програмата/иконка.png</var></cmd></p>
    <p>Ще бъде показана страницата с подробна информация за вашата програма. Ако преминете обратно към страницата за общ преглед на „<app>Програми</app>“, вашата програма ще бъде единственото в „избрани“ въртележката.</p>
  </section>


</page>
