<?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, 2025.</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>Perangkat Lunak</app> menampilkan tangkapan layar di halaman detail untuk suatu aplikasi. Ini biasanya mesti menyertakan tangkapan layar dari berbagai jendela / dialog aplikasi, sehingga pengguna akan mendapatkan pemahaman cepat tentang fitur, tampilan dan nuansa aplikasi, dll.</p>
    <p>Ketika lebih dari satu tangkapan layar hadir dalam berkas metainfo aplikasi, <app>Perangkat Lunak</app> akan menampilkan tangkapan layar dalam komidi putar.</p>
    <p>Jika berkas metainfo aplikasi tidak berisi tangkapan layar apa pun, maka ikon pewakil seperti di bawah ini dengan <code>Tidak Ada Cuplikan Layar</code> akan ditampilkan:</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>Cuplikan layar mungkin menjadi usang karena UI aplikasi berubah. Jadi, meskipun <app>Perangkat Lunak</app> menampilkan tangkapan layar untuk aplikasi, penting untuk memeriksa apakah tangkapan layar ini terbaru atau kedaluwarsa.</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 https://gitlab.gnome.org/GNOME/gnome-software/-/wikis/Help-Translation-Notes for steps to localize 'figures/app-context-bar.png' image.">Ini menunjukkan bilah konteks aplikasi untuk aplikasi <app>Perangkat Lunak</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.">Ubin ditampilkan dalam urutan yang tercantum di atas (dimulai dengan ubin <code>Penyimpanan</code> di sebelah kiri).</p>
    <p>Setiap ubin dibahas secara rinci di bawah ini.</p>
  </section>

  <section id="storage">
    <title>Penyimpanan</title>
    <p><app>Perangkat Lunak</app> menampilkan ubin penyimpanan di halaman detail untuk aplikasi. Jika aplikasi tidak terpasang, ini akan menampilkan perkiraan ukuran unduhan yang diperlukan untuk memasangnya. Jika aplikasi terpasang, itu menampilkan ruang penyimpanan yang digunakan oleh aplikasi.</p>
    <p>Ukuran dihitung dari data yang disediakan oleh backend <app>Perangkat Lunak</app> (seperti flatpak atau RPM), dan tidak ditentukan dalam metadata yang disediakan oleh aplikasi. Tidak ada yang dapat Anda lakukan untuk memengaruhi ubin ini dengan menyunting berkas metainfo aplikasi. Ini tercantum di sini untuk kelengkapan.</p>
  </section>

  <section id="safety">
    <title>Keselamatan</title>
    <p><app>Perangkat Lunak</app> menampilkan ubin keselamatan di halaman detail untuk aplikasi. Ini merangkum informasi tentang apakah aplikasi dapat dianggap aman untuk dipasang dan dijalankan, atau apakah kehati-hatian mungkin diperlukan sebelum memercayainya.</p>
    <p>Ubin ini menggabungkan informasi tentang izin yang diminta aplikasi saat berjalan (seperti izin untuk membaca berkas Anda), dengan informasi tentang bagaimana aplikasi dikembangkan. Aplikasi perangkat lunak bebas, di mana kode sumbernya dapat dibaca secara publik, bisa lebih aman daripada yang berpemilik, karena dapat diaudit.</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>Perangkat Lunak</app> menampilkan ubin dukungan perangkat keras di halaman detail untuk aplikasi. Ini menggabungkan informasi tentang persyaratan perangkat keras aplikasi, dan kemampuan perangkat keras komputer, dengan tujuan menyoroti ketidakcocokan atau persyaratan yang kurang — atau untuk mengindikasikan bahwa aplikasi harus bekerja dengan benar tanpa ketidakcocokan.</p>

    <p>Kode ini mencari perangkat keras berikut. Lebih banyak lagi mungkin didukung di masa mendatang.</p>
    <list>
      <item><p>Apakah touchpad, tetikus, atau papan ketik ada/diperlukan</p></item>
      <item><p>Apakah gamepad diperlukan</p></item>
      <item><p>Ukuran tampilan minimum dan yang direkomendasikan yang aplikasi dapat diskalakan ke sana</p></item>
    </list>

    <p>Tidak mungkin untuk mendeteksi secara andal apakah gamepad <em>ada</em>, karena sering kali dibiarkan terputus karena tidak diperlukan untuk penggunaan komputer normal.</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>Perangkat Lunak</app> menampilkan ubin peringkat usia di halaman detail untuk aplikasi. Ini menunjukkan rentang usia apa yang mesti cocok untuk aplikasi, berdasarkan berbagai jenis konten yang telah dinyatakan dikandung dalam aplikasi. Informasi ini dirangkum dalam format yang serupa dengan sertifikat peringkat permainan atau film untuk negara Anda.</p>
    <p>Misalnya, ini akan menyoroti apakah suatu permainan mengandung kekerasan, atau apakah aplikasi berisi iklan dalam aplikasi.</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>Perangkat Lunak</app> menampilkan ubin yang menunjukkan apakah suatu aplikasi adalah <link href="https://en.wikipedia.org/wiki/Free_and_open-source_software">perangkat lunak bebas</link> atau apakah lisensinya proprietari, khusus, atau tidak diketahui. Ubin ini mencakup informasi lebih rinci tentang lisensi proyek. Ubin ini juga mencantumkan beberapa manfaat perangkat lunak bebas. <link xref="software-licensing#introduction">Pelajari lebih lanjut</link></p>
    <p>Kadang-kadang informasi lisensi tidak benar untuk suatu aplikasi, dan karenanya aplikasi yang sebenarnya adalah perangkat lunak bebas akan ditampilkan sebagai 'berpemilik'. Demikian pula, terkadang informasi lisensi tidak diketahui.</p>
    <p><app>Perangkat Lunak</app> menyoroti lisensi bebas dan sumber terbuka dalam warna hijau, lisensi proprietari dan khusus berwarna kuning seperti yang ditunjukkan di sini. Lisensi yang tidak dikenal disorot dengan warna abu-abu.</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>Perangkat lunak</app> menampilkan daftar tautan sumber daya aplikasi di ubin tautan. Mereka adalah sebagai berikut:</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>Dalam kasus ketika berkas metainfo aplikasi tidak berisi tautan apa pun, ubin berikut dengan tanda tanya akan ditampilkan.</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>Ubin komidi putar</title>
    <media type="image" src="figures/carousel.png" style="floatend floatright" mime="image/png" its:translate="no"/>
    <p>Aplikasi yang ditampilkan oleh <app>Perangkat Lunak</app> ditampilkan dalam komidi putar di bagian atas jendela utama seperti yang ditunjukkan di sini. Setiap ubin komidi putar memiliki warna latar yang secara otomatis diekstraksi dari ikon aplikasi. Terkadang warna latar ini tidak cukup tepat untuk aplikasi dan perlu ditentukan secara eksplisit oleh pengembang aplikasi.</p>
    <p>Kumpulan aplikasi unggulan diputuskan oleh para pengelola distribusi Linux.</p>
    <p>Anda dapat memperbaiki ubin komidi putar:</p>
    <list>
      <item>
	<p><link xref="#how-to-set-the-komidi putar-tile-background-colour">Cara menata warna latar ubin komidi putar</link></p>
      </item>
    </list>
  </section>

  <section id="where-metadata-comes-from">
    <title>Dari mana metadata berasal</title>
    <p>Metadata yang digunakan untuk menentukan perangkat keras apa yang dibutuhkan perangkat lunak, berapa usia pengguna yang cocok, dan faktor-faktor yang berkontribusi pada seberapa aman untuk memasang, semuanya berasal dari berkas metainfo untuk perangkat lunak itu.</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>Lihat <link href="https://gitlab.gnome.org/GNOME/nautilus/-/blob/main/data/org.gnome.Nautilus.metainfo.xml.in.in">berkas metainfo untuk aplikasi GNOME Berkas</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>Jika beberapa metadata hilang untuk suatu aplikasi, <app>Perangkat Lunak</app> hanya dapat menebak apa itu, dan karenanya tidak dapat menyajikan banyak informasi dalam antarmukanya. Tebakan yang dibuat <app>Perangkat Lunak</app> didasarkan pada fakta bahwa sebagian besar perangkat lunak dirancang untuk komputer desktop.</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>Jika Anda menemukan bahwa halaman suatu aplikasi kurang informasi atau memiliki informasi yang salah, Anda dapat berkontribusi dengan salah satu dari dua cara:</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>Untuk keduanya, Anda harus terlebih dahulu menemukan halaman proyek aplikasi. Tautan ke halaman proyek biasanya harus tersedia di halaman aplikasi <link xref="#links">seperti yang ditunjukkan di sini</link>. Jika tidak, Anda harus menemukannya dengan pencarian sederhana di 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>Informasi tangkapan layar untuk aplikasi disimpan pada elemen <link href="https://www.freedesktop.org/software/appstream/docs/sect-Metadata-Application.html#tag-dapp-screenshots"><code>&lt;screenshots&gt;</code></link> dalam <code>&lt;component&gt;</code> aplikasi di berkas metainfo-nya.</p>
    <p>Cacah tangkapan lahar yang disarankan untuk aplikasi adalah antara 5 hingga 10. Tangkapan layar idealnya dalam format PNG dengan rasio aspek 16:9 dan lebar minimum 620 piksel.</p>
    <p>Misalnya, berikut adalah entri tangkapan layar untuk aplikasi <app>Perangkat Lunak</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>Cara memperbaiki informasi keselamatan dan izin yang salah</title>
    <p>Informasi keselamatan dan izin untuk aplikasi berasal dari sumber yang berbeda tergantung pada bagaimana aplikasi dikemas. Untuk aplikasi yang dikemas secara tradisional, misalnya dalam format RPM atau DEB, tidak ada informasi keselamatan atau izin yang tersedia dan tidak ada yang dapat dilakukan untuk menambahkannya ke aplikasi.</p>
    <p>Untuk aplikasi flatpak, informasi berasal dari <link href="https://docs.flatpak.org/en/latest/manifests.html">manifes flatpak</link>, yang menentukan lubang apa di sandbox yang dibutuhkan aplikasi. Masing-masing lubang ini biasanya berkontribusi untuk menurunkan tingkat keselamatan aplikasi yang ditampilkan di <app>Perangkat Lunak</app> — memindahkannya dari 'aman' ke 'berpotensi tidak aman' menjadi 'tidak aman'.</p>
    <p>Untuk meningkatkan tingkat keselamatan aplikasi, sandboxing-nya harus dibuat seketat mungkin, dengan menghapus <link href="https://docs.flatpak.org/en/latest/sandbox-permissions.html">izin sandbox</link> yang tidak diperlukan, dan menggunakan <link href="https://docs.flatpak.org/en/latest/desktop-integration.html#portals">portal</link> alih-alih izin sandbox jika memungkinkan. Penggunaan portal tidak menurunkan tingkat keselamatan aplikasi yang ditampilkan di <app>Perangkat Lunak</app>.</p>
    <p>Misalnya, jika aplikasi meminta akses baca/tulis ke seluruh sistem berkas (<code>--filesystem=host</code>), apakah sebenarnya membutuhkannya, atau hanya perlu mengakses berkas di beberapa lokasi tertentu? Jika demikian, <link href="https://docs.flatpak.org/en/latest/desktop-integration.html#portals">portal berkas</link> dapat digunakan, atau <link href="https://docs.flatpak.org/en/latest/sandbox-permissions.html#filesystem-access">izin sistem berkas</link> yang lebih spesifik dapat ditentukan.</p>
    <p>Jika aplikasi bekerja di Wayland, dan hanya perlu bekerja pada X11 sebagai fallback, tanpa menggunakan fitur khusus X11, bisakah itu menggunakan <code>--socket=fallback-x11</code> daripada <code>--socket=x11</code>?</p>
    <p>Panduan tentang izin tertentu, atau format pengemasan lainnya, dapat ditambahkan di sini di masa mendatang.</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>Informasi perangkat keras untuk aplikasi disimpan di elemen <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-relations"><code>&lt;requires&gt;</code>, <code>&lt;recommends&gt;</code>, dan <code>&lt;supports&gt;</code></link> dalam <code>&lt;component&gt;</code> aplikasi di berkas metainfo-nya.</p>
    <p><app>Perangkat Lunak</app> memahami elemen <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-relations-control"><code>&lt;control&gt;</code></link> dan <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>Lihat <link href="https://tecnocode.co.uk/2021/07/12/add-metadata-to-your-app-to-say-what-inputs-and-display-sizes-it-supports/">artikel blog ini</link> atau <link href="https://blogs.gnome.org/tbernard/2021/09/07/ready-for-software-41/#device-support">artikel blog ini</link> untuk contoh metadata.</p>
  </section>

  <section id="how-to-add-missing-content-rating-information">
    <title>Cara menambahkan informasi peringkat konten yang kurang</title>
    <p>Informasi peringkat konten untuk aplikasi disimpan di elemen <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-content_rating"><code>&lt;content_rating&gt;</code></link> dalam <code>&lt;component&gt;</code> aplikasi di berkas metainfo-nya.</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>Informasi lisensi untuk aplikasi disimpan di elemen <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-project_license"><code>&lt;project_license&gt;</code></link> dalam <code>&lt;component&gt;</code> aplikasi di berkas metainfo-nya.</p>
    <p>Konten dalam elemen ini harus berupa <link href="https://spdx.org/specifications">ekspresi SPDX</link> yang menjelaskan lisensi 'utama' untuk proyek. Ini biasanya harus menjadi lisensi kode, dan tidak termasuk lisensi dokumentasi atau konten tambahan.</p>
    <p>Jika ekspresi SPDX adalah lisensi tunggal, atau kombinasi 'atau' dari beberapa lisensi, yang semuanya <link href="https://spdx.org/licenses/">disetujui FSF atau OSI</link>, aplikasi tersebut dianggap 'perangkat lunak bebas' dan ubin lisensi mengatakan demikian. Jika tidak, itu dianggap 'berpemilik'.</p>
    <p>Jika sebuah aplikasi ditampilkan sebagai 'berpemilik' ketika menurut Anda tidak seharusnya, kemungkinan elemen <code>&lt;project_license&gt;</code> tersebut menyertakan lisensi dokumentasi untuk proyek tersebut. Hapus itu.</p>
    <p><link href="https://gitlab.gnome.org/GNOME/meld/-/issues/579">Misalnya</link>, ubah metadata lisensi dari:</p>
    <code its:translate="no" mime="application/xml"><![CDATA[<project_license>GPL-2.0+ and CC-BY-SA-3.0</project_license>]]></code>
    <p>menjadi</p>
    <code its:translate="no" mime="application/xml"><![CDATA[<project_license>GPL-2.0+</project_license>]]></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>Tautan untuk aplikasi disimpan sebagai elemen <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-url"><code>&lt;url&gt;</code></link> dalam <code>&lt;component&gt;</code> aplikasi dalam berkas metainfo-nya.</p>
    <p>Tambahkan sebanyak mungkin tipe tautan yang didokumentasikan dalam <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-url">spesifikasi appstream</link> yang tersedia untuk aplikasi. Jika tidak ada halaman yang cocok untuk tipe tautan tertentu, halaman tersebut tidak harus disertakan.</p>
    <p>Misalnya, berikut adalah tautan sumber daya untuk aplikasi <app>Perangkat Lunak</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>Cara menata warna latar ubin komidi putar</title>
    <p>Warna latar ubin komidi putar biasanya diekstraksi secara otomatis dari ikon aplikasi. Namun, jika warna tersebut tidak memuaskan, warna tersebut dapat diganti dengan menggunakan elemen <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-branding"><code>&lt;branding/&gt;</code> appstream</link> dengan warna yang dideklarasikan (sejak seri 47.x). Keuntungannya adalah lebih banyak klien yang dapat menggunakan warna tersebut.</p>
    <p>Misalnya, berikut adalah beberapa entri branding:</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>Perhatikan atribut <code>scheme_preference</code> diabaikan, <app>Perangkat lunak</app> memilih sendiri warna yang lebih baik untuk tema.</p>
    </note>
    <p>Masih ada, untuk kompatibilitas mundur, kemungkinan untuk menambahkan XML berikut ke elemen metainfo <code>&lt;component&gt;</code> aplikasi:</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>tetapi elemen <code>&lt;branding/&gt;</code> memiliki preseden.</p>
    <p>Nilai dari <code>GnomeSoftware::key-colors</code> adalah suatu GVariant format teks dengan jenis <code>a(yyy)</code>, dan mewakili sekumpulan warna kunci yang tidak berurutan untuk aplikasi. Setiap elemen set adalah warna dalam bentuk RGB mulai dari <code>(0, 0, 0)</code> hingga <code>(255, 255, 255)</code>.</p>
    <p>Warna harus dipilih sehingga:</p>
    <list>
      <item>
	<p>Dapat diidentifikasi oleh aplikasi, cocok dengan branding aplikasi dalam beberapa cara, jika memungkinkan.</p>
      </item>
      <item>
	<p>Kontras dengan tepi ikon aplikasi, sehingga ketika digunakan sebagai latar belakang di belakangnya, ikon tersebut dapat dibedakan.</p>
      </item>
      <item>
	<p>Kontras dengan warna teks latar depan dalam tema Adwaita (<code>#2e3436</code>) dan dalam varian gelapnya (<code>#eeeeec</code>). Ini umumnya berarti memilih warna dengan tingkat kecerahan sedang.</p>
      </item>
      <item>
	<p>Kontras dapat diperiksa menggunakan <link href="https://flathub.org/apps/org.gnome.design.Contrast/">aplikasi Kontras</link>.</p>
      </item>
    </list>
    <p>Setidaknya satu warna harus ditentukan. Lebih banyak dapat ditentukan jika satu warna tidak dapat memenuhi semua persyaratan di atas, dan <app>Perangkat Lunak</app> akan memilih yang paling tepat untuk digunakan di ubin komidi putar. Jika tepat satu warna ditentukan, kecerahan dan saturasinya dapat dimodifikasi untuk meningkatkan kontras dengan warna latar depan. Jika lebih dari satu warna ditentukan, warna dengan kontras terbaik dengan warna latar depan akan dipilih, dan kecerahan serta saturasinya tidak akan dimodifikasi.</p>
  </section>

  <section id="how-to-test-carousel-tile-background-colour-changes">
    <title>Cara menguji perubahan warna latar ubin komidi putar</title>
    <p>Ubah berkas metainfo untuk aplikasi Anda, lalu jalankan <app>Perangkat Lunak</app> dengan:</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>
