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

  <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>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Ser82-png</mal:name>
      <mal:email>asvmail.as@gmail.com</mal:email>
      <mal:years>2024</mal:years>
    </mal:credit>
  </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 приложения присутствует более одного снимка, то <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>Представлены могут быть сразу все или только некоторые ссылки в зависимости от того, что указано в метафайле приложения.</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>Набор предлагаемых приложений определяется разработчиками дистрибутива 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 для приложения GNOME Files</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 информация берется из <link href="https://docs.flatpak.org/en/latest/manifests.html">манифеста flatpak</link>, в котором указывается, какие дыры в изолированной среде требуются приложению. Каждая из этих дыр, как правило, приводит к снижению уровня безопасности приложения, отображаемого в <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 представлена одна лицензия или комбинация нескольких лицензий через «and», все из которых <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">спецификации 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’s <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> файла metainfo:</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> является параметром типа <code>a(yyy)</code> в текстовым формате GVariant и представляет собой неупорядоченный набор ключевых цветов для приложения. Каждый элемент набора представляет собой цвет в формате 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>Измените метафайл своего приложения, а затем запустите <app>Центр приложений</app> используя:</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>Откроется страница с подробной информацией о вашем приложении. Если вы вернетесь на страницу обзора <app>Центра приложений</app>, ваше приложение будет единственным в «Избранном» карусели.</p>
  </section>


</page>
