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

  <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>Cara <app>Perangkat Lunak</app> memakai metadata</desc>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Andika Triwidada</mal:name>
      <mal:email>andika@gmail.com</mal:email>
      <mal:years>2024.</mal:years>
    </mal:credit>
  </info>

  <title>Metadata Perangkat Lunak</title>
  <links type="section"/>

  <section id="screenshots">
    <title>Cuplikan Layar</title>
    <media type="image" src="figures/app-screenshot.png" style="floatend floatright" mime="image/png" its:translate="no"/>
    <p><app>Software</app> displays the screenshots on the details page for an application. This typically should include screenshots of various windows / dialogs of the application, so the user would get a quick grasp of the application’s features, look and feel etc.</p>
    <p>When more than one screenshot is present in the application’s metainfo file, <app>Software</app> will show the screenshots in a carousel.</p>
    <p>In cases when the application’s metainfo file doesn’t contain any screenshot, then a placeholder icon as below with <code>No Screenshots</code> will be displayed:</p>
    <media type="image" src="figures/scalable/symbolic/image-missing-symbolic.svg" width="96" mime="image/svg" its:translate="no"/>
    <note>
      <p>Ikon pewakil mungkin terlihat berbeda jika Anda menggunakan tema ikon ubahan.</p>
    </note>
    <p>Screenshots might become outdated as the application’s UI changes. So, even if <app>Software</app> shows screenshots for an app, it’s important to check if these screenshots are up-to-date or outdated.</p>
    <p>Anda dapat memperbaiki informasi tangkapan layar aplikasi:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-app-screenshots">Cara menambahkan tangkapan layar aplikasi yang kurang</link></p>
      </item>
    </list>
  </section>

  <section id="app-context-bar">
    <title>Bilah konteks aplikasi</title>
    <p>Bilah konteks aplikasi di <app>Perangkat Lunak</app> adalah kumpulan ubin pada halaman detail untuk aplikasi, yang menampilkan detail berikut.</p>
    <list>
      <item>
	<p><link xref="#storage">Penyimpanan</link></p>
      </item>
      <item>
	<p><link xref="#safety">Keselamatan</link></p>
      </item>
      <item>
	<p><link xref="#hardware-support">Dukungan perangkat keras</link></p>
      </item>
      <item>
	<p><link xref="#age-rating">Peringkat usia</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.">This shows the app context bar for the <app>Software</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.">The tiles are displayed in the order listed above (starting with <code>Storage</code> tile on the left).</p>
    <p>Each tile is covered in detail below.</p>
  </section>

  <section id="storage">
    <title>Penyimpanan</title>
    <p><app>Software</app> displays a storage tile on the details page for an application. If the application is not installed, this displays the estimated download size needed to install it. If the application is installed, it displays the storage space used by the application.</p>
    <p>The sizes are calculated from data provided by the <app>Software</app> backend (such as flatpak or an RPM), and are not specified in the metadata provided by the application. There is nothing you can do to affect this tile by editing an application’s metainfo file. It’s listed here for completeness.</p>
  </section>

  <section id="safety">
    <title>Keselamatan</title>
    <p><app>Software</app> displays a safety tile on the details page for an application. This summarizes information about whether the app can be considered safe to install and run, or whether caution may be required before trusting it.</p>
    <p>This tile combines information about the permissions which the app requests when it runs (such as permission to read your files), with information about how the app was developed. Free software applications, where the source code is publicly readable, can be more secure than proprietary ones, as they can be audited.</p>
    <p>Dialog yang muncul saat ubin diklik mencantumkan berbagai izin yang diminta aplikasi, ditambah beberapa informasi tentang lisensi dan runtimenya.</p>
    <p>Anda dapat memperbaiki informasi keselamatan:</p>
    <list>
      <item>
	<p><link xref="#how-to-fix-incorrect-safety-and-permissions-information">Cara memperbaiki informasi keselamatan dan izin yang salah</link></p>
      </item>
    </list>
  </section>

  <section id="hardware-support">
    <title>Dukungan perangkat keras</title>
    <p>
      <app>Software</app> displays a hardware support tile on the details page
      for an application. This combines information about the hardware
      requirements of the application, and the hardware capabilities of
      the computer, with the aim of highlighting incompatibilities or
      missing requirements — or to indicate that the application should
      work correctly with no incompatibilities.
    </p>

    <p>The code looks at the following hardware. More may be supported in future.</p>
    <list>
      <item><p>Apakah touchpad, tetikus, atau papan ketik ada/diperlukan</p></item>
      <item><p>Whether a gamepad is needed</p></item>
      <item><p>The minimum and recommended display size that the app can scale to</p></item>
    </list>

    <p>It’s not possible to reliably detect whether a gamepad is <em>present</em>, as they are often left disconnected due to not being needed for normal computer use.</p>
    <p>Dialog yang muncul saat ubin diklik mencantumkan persyaratan perangkat keras aplikasi yang berbeda, dan apakah salah satu dari mereka tidak terpenuhi.</p>
    <p>Anda dapat memperbaiki informasi perangkat keras:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-hardware-information">Cara menambahkan informasi perangkat keras yang kurang</link></p>
      </item>
    </list>
  </section>

  <section id="age-rating">
    <title>Peringkat usia</title>
    <p><app>Software</app> displays an age rating tile on the details page for an application. This shows what age range the application should be suitable for, based on different kinds of content which the application has declared it contains. This information is summarized in a format similar to the game or film rating certificates for your country.</p>
    <p>For example, this will highlight whether a game contains violence, or whether an application contains in-app advertising.</p>
    <p>Dialog yang muncul saat ubin diklik mencantumkan berbagai jenis konten dalam aplikasi dan seberapa parah konten tersebut.</p>
    <p>Anda dapat memperbaiki informasi peringkat usia:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-content-rating-information">Cara menambahkan informasi peringkat konten yang kurang</link></p>
      </item>
    </list>
  </section>

  <section id="license">
    <title>Lisensi</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>Software</app> displays a tile indicating whether an application is <link href="https://en.wikipedia.org/wiki/Free_and_open-source_software">free software</link> or whether its license is proprietary, special or unknown. This tile includes more detailed information about the project’s license. This tile also lists some of the benefits of free software. <link xref="software-licensing#introduction">Learn more</link></p>
    <p>Sometimes the license information isn’t correct for an application, and hence an application which is actually free software will be shown as ‘proprietary’. Similarly, sometimes the license information is unknown.</p>
    <p><app>Software</app> highlights free and open-source licenses in green, proprietary and special licenses in yellow as shown here. Unknown licenses are highlighted in grey.</p>
    <p>Anda dapat menambahkan atau memperbaiki informasi lisensi:</p>
    <list>
      <item>
	<p><link xref="#how-to-fix-incorrect-licensing-information">Cara memperbaiki informasi lisensi yang salah</link></p>
      </item>
    </list>
  </section>

  <section id="links">
    <title>Tautan</title>
    <media type="image" src="figures/scalable/links.svg" style="floatend floatright" mime="image/svg" its:translate="no"/>
    <p><app>Software</app> displays a list of application resource links in the link tile. They are as follows:</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>Tautan situs web</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>Tautan donasi</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>Tautan kontribusi terjemahan</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>Tautan pelaporan bug</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>Tautan bantuan</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>Tautan kontak</p></td>
      </tr>
    </table>
    <p>Beberapa atau semua tautan ini mungkin ada tergantung pada apakah tautan tersebut tercantum dalam berkas metainfo aplikasi.</p>
    <p>In cases when the application’s metainfo file doesn’t contain any link, the following tile with a question mark will be displayed.</p>
    <media type="image" src="figures/scalable/no-links.svg" style="floatend floatright" mime="image/svg" its:translate="no"/>
    <p>Anda dapat meningkatkan tautan:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-links">Cara menambahkan tautan yang kurang</link></p>
      </item>
    </list>
  </section>

  <section id="carousel-tile">
    <title>Carousel tile</title>
    <media type="image" src="figures/carousel.png" style="floatend floatright" mime="image/png" its:translate="no"/>
    <p>Applications which are featured by <app>Software</app> are displayed in a carousel at the top of the main window as shown here. Each carousel tile has a background color which is automatically extracted from the application’s icon. Sometimes this background color is not quite right for the application and needs to be specified explicitly by the application developer.</p>
    <p>The set of applications which are featured is decided by the Linux distribution maintainers.</p>
    <p>You can improve the carousel tile:</p>
    <list>
      <item>
	<p><link xref="#how-to-set-the-carousel-tile-background-colour">How to set the carousel tile background color</link></p>
      </item>
    </list>
  </section>

  <section id="where-metadata-comes-from">
    <title>Dari mana metadata berasal</title>
    <p>The metadata used to specify what hardware a piece of software requires, what ages of user it is suitable for, and factors which contribute to how safe it might be to install, all come from the metainfo file for that software.</p>
    <p>Berkas metainfo adalah suatu berkas XML. Format berkasnya ditentukan dalam <link href="https://www.freedesktop.org/software/appstream/docs/">spesifikasi AppStream</link>.</p>
    <p>See the <link href="https://gitlab.gnome.org/GNOME/nautilus/-/blob/main/data/org.gnome.Nautilus.metainfo.xml.in.in">metainfo file for GNOME Files app</link>.</p>
    <note style="tip">
      <p><em>appdata</em> adalah istilah lama untuk <em>metainfo</em>.</p>
    </note>
  </section>

  <section id="what-happens-if-metadata-is-missing">
    <title>Apa yang terjadi jika metadata hilang</title>
    <p>If some metadata is missing for an application, <app>Software</app> can only guess what it might be, and hence can’t present much information in its interfaces. The guesses <app>Software</app> makes are based on the fact that most software is designed for desktop computers.</p>
    <p><em style="strong">Anda dapat membantu memperbaiki metadata untuk sebuah aplikasi!</em></p>
  </section>

  <section id="how-to-contribute-missing-information">
    <title>Cara menyumbangkan informasi yang kurang</title>
    <p>If you find that an app’s page is missing information or has incorrect information, you can contribute in one of the two ways:</p>
    <list type="numbered">
      <item>
	<p>Anda dapat melaporkan metadata yang kurang / salah ke pelacak bug aplikasi masing-masing, sehingga pengembang aplikasi dapat memperbaikinya.</p>
      </item>
      <item>
	<p>Anda dapat memperbaiki sendiri metadata yang kurang / salah. Lihat panduan <em style="strong">Cara</em> di bawah ini tentang bagaimana melakukannya.</p>
      </item>
    </list>

    <p>For both, you first need to find the app’s project page. The link to the project page should typically be available in the app’s page <link xref="#links">as shown here</link>. If not, you will need to find it with a simple search on Google.</p>

    <p>Aplikasi biasanya diwadahi di <link href="https://gitlab.com/explore?sort=stars_desc">GitLab</link> atau <link href="https://github.com/explore">GitHub</link>. Misalnya, aplikasi GNOME diwadahi di <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>Cara menambahkan tangkapan layar aplikasi yang kurang</title>
    <p>The screenshot information for an application is stored in the <link href="https://www.freedesktop.org/software/appstream/docs/sect-Metadata-Application.html#tag-dapp-screenshots"><code>&lt;screenshots&gt;</code></link> element within the application’s <code>&lt;component&gt;</code> in its metainfo file.</p>
    <p>Recommended number of screenshots for an app is between 5 to 10. Screenshots should ideally be in the PNG format with 16:9 aspect ratio and minimum width of 620 pixels.</p>
    <p>For example, here are the screenshot entries for the <app>Software</app> app:</p>
    <code 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>Cara memperbaiki informasi keselamatan dan izin yang salah</title>
    <p>The safety and permissions information for an application comes from different sources depending on how the application is packaged. For traditionally packaged applications, for example in RPM or DEB format, there is no safety or permissions information available and nothing can be done to add it to an application.</p>
    <p>For flatpak applications, the information comes from the application’s <link href="https://docs.flatpak.org/en/latest/manifests.html">flatpak manifest</link>, specifying what holes in the sandbox the application requires. Each of these holes typically contributes to lowering the displayed safety level of the application in <app>Software</app> — moving it from ‘safe’ to ‘potentially unsafe’ to ‘unsafe’.</p>
    <p>In order to improve the safety level of an application, its sandboxing must be made as tight as possible, by removing <link href="https://docs.flatpak.org/en/latest/sandbox-permissions.html">sandbox permissions</link> where they’re not needed, and using <link href="https://docs.flatpak.org/en/latest/desktop-integration.html#portals">portals</link> instead of sandbox permissions where possible. Use of portals does not lower the displayed safety level of an application in <app>Software</app>.</p>
    <p>For example, if the application requests read/write access to the full file system (<code>--filesystem=host</code>), does it actually need that, or does it only need to access files in a few specific locations? If so, the <link href="https://docs.flatpak.org/en/latest/desktop-integration.html#portals">file portal</link> could be used, or more specific <link href="https://docs.flatpak.org/en/latest/sandbox-permissions.html#filesystem-access">file system permissions</link> could be specified.</p>
    <p>If the application works on Wayland, and only needs to work on X11 as a fallback, without using special X11 features, could it use <code>--socket=fallback-x11</code> rather than <code>--socket=x11</code>?</p>
    <p>Guidance about specific permissions, or other packaging formats, may be added here in future.</p>
    <p>Bacaan lebih lanjut:</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>Cara menambahkan informasi perangkat keras yang kurang</title>
    <p>The hardware information for an application is stored in the <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-relations"><code>&lt;requires&gt;</code>, <code>&lt;recommends&gt;</code> and <code>&lt;supports&gt;</code></link> elements within the application’s <code>&lt;component&gt;</code> in its metainfo file.</p>
    <p><app>Software</app> understands the <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-relations-control"><code>&lt;control&gt;</code></link> and <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-relations-display_length"><code>&lt;display_length&gt;</code></link> elements.</p>
    <p>See <link href="https://tecnocode.co.uk/2021/07/12/add-metadata-to-your-app-to-say-what-inputs-and-display-sizes-it-supports/">this blog post</link> or <link href="https://blogs.gnome.org/tbernard/2021/09/07/ready-for-software-41/#device-support">this blog post</link> for examples of metadata.</p>
  </section>

  <section id="how-to-add-missing-content-rating-information">
    <title>Cara menambahkan informasi peringkat konten yang kurang</title>
    <p>The content rating information for an application is stored in the <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-content_rating"><code>&lt;content_rating&gt;</code></link> element within the application’s <code>&lt;component&gt;</code> in its metainfo file.</p>
    <p>Aplikasi harus menggunakan standar OARS 1.1 untuk mengisi elemen ini. Jika elemen <code>&lt;content_rating&gt;</code> tidak ditentukan, peringkat konten aplikasi tidak diketahui. Jika ditentukan tetapi kosong, aplikasi tidak memiliki konten yang mungkin tidak cocok untuk audiens mana pun.</p>
    <p>Gunakan <link href="https://hughsie.github.io/oars/">generator OARS</link> untuk menghasilkan informasi peringkat konten yang sesuai untuk aplikasi.</p>
  </section>

  <section id="how-to-fix-incorrect-licensing-information">
    <title>Cara memperbaiki informasi lisensi yang salah</title>
    <p>The licensing information for an application is stored in the <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-project_license"><code>&lt;project_license&gt;</code></link> element within the application’s <code>&lt;component&gt;</code> in its metainfo file.</p>
    <p>The content in this element should be an <link href="https://spdx.org/specifications">SPDX expression</link> which describes the ‘main’ license for the project. This should typically be the license of the code, and not include the license of the documentation or ancillary content.</p>
    <p>If the SPDX expression is a single license, or an ‘or’ combination of multiple licenses, which are all <link href="https://spdx.org/licenses/">FSF or OSI approved</link>, the application is considered ‘free software’ and the license tile says so. Otherwise, it’s considered ‘proprietary’.</p>
    <p>If an application is being displayed as ‘proprietary’ when you think it shouldn’t be, it’s likely that the <code>&lt;project_license&gt;</code> element includes the documentation license for the project. Remove it.</p>
    <p><link href="https://gitlab.gnome.org/GNOME/meld/-/issues/579">Misalnya</link>, ubah metadata lisensi dari:</p>
    <code mime="application/xml">&lt;project_license&gt;GPL-2.0+ dan CC-BY-SA-3.0&lt;/project_license&gt;</code>
    <p>menjadi</p>
    <code mime="application/xml">&lt;project_license&gt;GPL-2.0+&lt;/project_license&gt;</code>
    <p>Bacaan lebih lanjut:</p>
    <list>
      <item>
	<p><link href="https://tecnocode.co.uk/2021/07/05/dont-generally-put-cc-by-sa-in-appdata/">Jangan (secara umum) memasukkan lisensi dokumentasi di 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>Cara menambahkan tautan yang kurang</title>
    <p>The links for an application are stored as <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-url"><code>&lt;url&gt;</code></link> elements within the application’s <code>&lt;component&gt;</code> in its metainfo file.</p>
    <p>Add as many of the link types documented in the <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-url">appstream specification</link> as are available for the application. If no suitable page exists for a given link type, it doesn’t have to be included.</p>
    <p>For example, here are the resource links for the <app>Software</app> app:</p>
    <code 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>How to set the carousel tile background color</title>
    <p>The carousel tile background color is normally extracted automatically from the application’s icon. If that color is unsatisfactory, however, it can be overridden by using the <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-branding">appstream’s <code>&lt;branding/&gt;</code> element</link> with declared colors (since 47.x series). The advantage is that more clients can use the colors.</p>
    <p>For example, here are some branding entries:</p>
    <code 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>Note the <code>scheme_preference</code> attribute is ignored, <app>Software</app> chooses the better color for the theme on its own.</p>
    </note>
    <p>There is left, for backward compatibility, the possibility to add the following XML to the application’s metainfo <code>&lt;component&gt;</code> element:</p>
    <code mime="application/xml"><![CDATA[
<custom>
  <value key="GnomeSoftware::key-colors">[(124, 53, 77), (99, 16, 0)]</value>
</custom>]]></code>
    <p>but the <code>&lt;branding/&gt;</code> element has a precedence.</p>
    <p>The value of <code>GnomeSoftware::key-colors</code> is a text-format GVariant with type <code>a(yyy)</code>, and represents an unordered set of key colors for the application. Each element of the set is a color in RGB form ranging from <code>(0, 0, 0)</code> to <code>(255, 255, 255)</code>.</p>
    <p>Colors should be chosen so that they:</p>
    <list>
      <item>
	<p>Are identifiable to the application, matching the application’s branding in some way, if possible.</p>
      </item>
      <item>
	<p>Contrast with the edge of the application’s icon, so that when they are used as a background behind it, the icon can be distinguished.</p>
      </item>
      <item>
	<p>Contrast with the foreground text color in the Adwaita theme (<code>#2e3436</code>) and in its dark variant (<code>#eeeeec</code>). This generally means choosing a color with a medium level of brightness.</p>
      </item>
      <item>
	<p>Contrast can be checked using the <link href="https://flathub.org/apps/org.gnome.design.Contrast/">Contrast app</link>.</p>
      </item>
    </list>
    <p>At least one color should be specified. More can be specified if one color can’t satisfy all the requirements above, and <app>Software</app> will choose the most appropriate to use in the carousel tile. If exactly one color is specified, its brightness and saturation may be modified to improve contrast with the foreground color. If more than one color is specified, the one with the best contrast with the foreground color will be chosen, and its brightness and saturation will not be modified.</p>
  </section>

  <section id="how-to-test-carousel-tile-background-colour-changes">
    <title>How to test carousel tile background color changes</title>
    <p>Modify the metainfo file for your application, and then run <app>Software</app> with:</p>
    <p><cmd>gnome-software --show-metainfo=<var>/path/ke/app.metainfo.xml</var>,icon=<var>/path/ke/app/icon.png</var></cmd></p>
    <p>Halaman detail untuk aplikasi Anda akan ditampilkan. Jika Anda menavigasi kembali ke halaman ikhtisar <app>Perangkat Lunak</app>, aplikasi Anda akan menjadi satu-satunya di komidi putar 'unggulan'.</p>
  </section>


</page>
