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

  <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>Қосымшаның метаақпарат файлында бірнеше скриншот болса, <app>Бағдарламалық қамтама</app> оларды карусель түрінде көрсетеді.</p>
    <p>Қосымшаның метаақпарат файлында скриншоттар болмаған жағдайда, төмендегідей <code>Скриншоттар жоқ</code> деген жазуы бар толтырғыш таңбашасы көрсетіледі:</p>
    <media type="image" src="figures/scalable/symbolic/image-missing-symbolic.svg" width="96" mime="image/svg" its:translate="no"/>
    <note>
      <p>Егер сіз өзгеше таңбашалар темасын пайдалансаңыз, толтырғыш таңбаша басқаша көрінуі мүмкін.</p>
    </note>
    <p>Қосымша интерфейсі өзгерген сайын скриншоттар ескіруі мүмкін. Сондықтан, <app>Бағдарламалық қамтама</app> қосымша үшін скриншоттарды көрсетсе де, бұл скриншоттардың жаңартылған немесе ескіргенін тексеру маңызды.</p>
    <p>Сіз қосымшаның скриншоты туралы ақпаратты жақсарта аласыз:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-app-screenshots">Жетіспейтін қосымша скриншоттарын қалай қосуға болады</link></p>
      </item>
    </list>
  </section>

  <section id="app-context-bar">
    <title>Қосымшаның контексттік панелі</title>
    <p><app>Бағдарламалық қамтамадағы</app> қосымшаның контексттік панелі — келесі мәліметтерді көрсететін қосымшаның мәліметтер бетіндегі плиткалар жиынтығы.</p>
    <list>
      <item>
	<p><link xref="#storage">Сақтау орны</link></p>
      </item>
      <item>
	<p><link xref="#safety">Қауіпсіздік</link></p>
      </item>
      <item>
	<p><link xref="#hardware-support">Аппараттық қолдау</link></p>
      </item>
      <item>
	<p><link xref="#age-rating">Жас рейтингі</link></p>
      </item>
    </list>

    <p its:locNote="Translators: Refer https://gitlab.gnome.org/GNOME/gnome-software/-/wikis/Help-Translation-Notes for steps to localize 'figures/app-context-bar.png' image.">Мұнда <app>Бағдарламалық қамтама</app> қосымшасы үшін контексттік панель көрсетілген:</p>
    <p><media type="image" src="figures/app-context-bar.png" mime="image/png" its:translate="yes"/></p>


    <p its:locNote="Translators: This text needs to be adjusted for RTL languages as the tiles will be reversed in the UI.">Плиткалар жоғарыда көрсетілген ретпен көрсетіледі (сол жақтан <code>Сақтау орны</code> плиткасынан бастап).</p>
    <p>Әрбір плитка төменде егжей-тегжейлі сипатталған.</p>
  </section>

  <section id="storage">
    <title>Сақтау орны</title>
    <p><app>Бағдарламалық қамтама</app> қосымша туралы мәліметтер бетінде сақтау орны плиткасын көрсетеді. Егер қосымша орнатылмаған болса, бұл оны орнату үшін қажетті болжалды жүктеп алу өлшемін көрсетеді. Егер қосымша орнатылған болса, ол қосымша алып жатқан орынды көрсетеді.</p>
    <p>Өлшемдер <app>Бағдарламалық қамтаманың</app> артқы жағынан (мысалы, flatpak немесе RPM) алынған деректер негізінде есептеледі және қосымша берген метадеректерде көрсетілмейді. Қосымшаның метаақпарат файлын түзету арқылы бұл плиткаға әсер ету үшін ештеңе істей алмайсыз. Ол мұнда толықтық үшін тізімделген.</p>
  </section>

  <section id="safety">
    <title>Қауіпсіздік</title>
    <p><app>Бағдарламалық қамтама</app> қосымша туралы мәліметтер бетінде қауіпсіздік плиткасын көрсетеді. Бұл қосымшаны орнату және іске қосу қауіпсіз деп санала ма, әлде оған сенбес бұрын сақ болу керек пе деген ақпаратты жинақтайды.</p>
    <p>Бұл плитка қосымша іске қосылғанда сұрайтын рұқсаттар (мысалы, файлдарыңызды оқуға рұқсат) туралы ақпаратты және қосымшаның қалай әзірленгені туралы ақпаратты біріктіреді. Бастапқы коды көпшілікке қолжетімді еркін бағдарламалық қамтама қосымшалары меншікті қосымшаларға қарағанда қауіпсіз болуы мүмкін, өйткені оларды тексеруге болады.</p>
    <p>Плитканы шерткенде пайда болатын сұхбат терезесінде қосымша сұрайтын түрлі рұқсаттар, сонымен қатар оның лицензиясы мен орындалу ортасы туралы кейбір ақпарат көрсетіледі.</p>
    <p>Сіз қауіпсіздік туралы ақпаратты жақсарта аласыз:</p>
    <list>
      <item>
	<p><link xref="#how-to-fix-incorrect-safety-and-permissions-information">Қате қауіпсіздік және рұқсаттар туралы ақпаратты қалай түзетуге болады</link></p>
      </item>
    </list>
  </section>

  <section id="hardware-support">
    <title>Аппараттық қолдау</title>
    <p><app>Бағдарламалық қамтама</app> қосымша туралы мәліметтер бетінде аппараттық қолдау плиткасын көрсетеді. Бұл сәйкессіздіктерді немесе жетіспейтін талаптарды көрсету немесе қосымшаның ешқандай сәйкессіздіксіз дұрыс жұмыс істейтінін білдіру мақсатында қосымшаның аппараттық талаптары мен компьютердің аппараттық мүмкіндіктері туралы ақпаратты біріктіреді.</p>

    <p>Код келесі аппараттық құралдарды тексереді. Болашақта көбірек қолдау көрсетілуі мүмкін.</p>
    <list>
      <item><p>Тачпад, тышқан немесе пернетақтаның бар болуы/қажеттілігі</p></item>
      <item><p>Геймпадтың қажеттілігі</p></item>
      <item><p>Қосымша бейімделе алатын минималды және ұсынылатын экран өлшемі</p></item>
    </list>

    <p>Геймпадтың <em>бар-жоғын</em> сенімді түрде анықтау мүмкін емес, өйткені олар әдетте компьютерді қалыпты пайдалану үшін қажет болмағандықтан ажыратылып тұрады.</p>
    <p>Плитканы шерткенде пайда болатын сұхбат терезесінде қосымшаның түрлі аппараттық талаптары және олардың орындалған-орындалмағаны көрсетіледі.</p>
    <p>Сіз аппараттық құралдар туралы ақпаратты жақсарта аласыз:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-hardware-information">Жетіспейтін аппараттық ақпаратты қалай қосуға болады</link></p>
      </item>
    </list>
  </section>

  <section id="age-rating">
    <title>Жас рейтингі</title>
    <p><app>Бағдарламалық қамтама</app> қосымша туралы мәліметтер бетінде жас рейтингі плиткасын көрсетеді. Бұл қосымшада мәлімделген мазмұн түрлеріне негізделген қосымшаның қай жас аралығына сәйкес келетінін көрсетеді. Бұл ақпарат сіздің еліңіздегі ойын немесе фильм рейтингі сертификаттарына ұқсас пішімде жинақталады.</p>
    <p>Мысалы, бұл ойында зорлық-зомбылық бар ма, әлде қосымшада ішкі жарнама бар ма дегенді көрсетеді.</p>
    <p>Плитканы шерткенде пайда болатын сұхбат терезесінде қосымшадағы мазмұнның түрлі түрлері және сол мазмұнның қаншалықты қатаң екендігі көрсетіледі.</p>
    <p>Сіз жас рейтингі туралы ақпаратты жақсарта аласыз:</p>
    <list>
      <item>
	<p><link xref="#how-to-add-missing-content-rating-information">Жетіспейтін мазмұн рейтингі туралы ақпаратты қалай қосуға болады</link></p>
      </item>
    </list>
  </section>

  <section id="license">
    <title>Лицензия</title>
    <media type="image" src="figures/scalable/license-community-built.svg" style="floatend floatright" mime="image/svg" its:translate="no"/>
    <media type="image" src="figures/scalable/license-proprietary-and-special.svg" style="floatend floatright" mime="image/svg" its:translate="no"/>
    <p><app>Бағдарламалық қамтама</app> қосымшаның <link href="https://en.wikipedia.org/wiki/Free_and_open-source_software">еркін бағдарламалық қамтама</link> екенін немесе оның лицензиясы меншікті, арнайы немесе белгісіз екенін көрсететін плитканы көрсетеді. Бұл плитка жобаның лицензиясы туралы толығырақ ақпаратты қамтиды. Сондай-ақ, бұл плиткада еркін бағдарламалық қамтаманың кейбір артықшылықтары тізімделген. <link xref="software-licensing#introduction">Көбірек білу</link></p>
    <p>Кейде қосымша үшін лицензия туралы ақпарат дұрыс болмайды, сондықтан іс жүзінде еркін бағдарламалық қамтама болып табылатын қосымша «меншікті» ретінде көрсетіледі. Сол сияқты, кейде лицензия туралы ақпарат белгісіз болады.</p>
    <p><app>Бағдарламалық қамтама</app> еркін және ашық бастапқы кодты лицензияларды жасыл түспен, ал меншікті және арнайы лицензияларды мұнда көрсетілгендей сары түспен белгілейді. Белгісіз лицензиялар сұр түспен белгіленеді.</p>
    <p>Сіз лицензия туралы ақпаратты қоса аласыз немесе жақсарта аласыз:</p>
    <list>
      <item>
	<p><link xref="#how-to-fix-incorrect-licensing-information">Қате лицензиялау ақпаратын қалай түзетуге болады</link></p>
      </item>
    </list>
  </section>

  <section id="links">
    <title>Сілтемелер</title>
    <media type="image" src="figures/scalable/links.svg" style="floatend floatright" mime="image/svg" its:translate="no"/>
    <p><app>Бағдарламалық қамтама</app> сілтемелер плиткасында қосымша ресурстарына сілтемелер тізімін көрсетеді. Олар келесідей:</p>
    <table>
      <tr>
	<td><p><media type="image" src="figures/scalable/symbolic/webpage-symbolic.svg" mime="image/svg" its:translate="no"/></p></td>
	<td><p>Веб-сайт сілтемесі</p></td>
      </tr>
      <tr>
	<td><p><media type="image" src="figures/scalable/symbolic/donate-symbolic.svg" mime="image/svg" its:translate="no"/></p></td>
	<td><p>Демеушілік ету сілтемесі</p></td>
      </tr>
      <tr>
	<td><p><media type="image" src="figures/scalable/symbolic/translations-symbolic.svg" mime="image/svg" its:translate="no"/></p></td>
	<td><p>Аудармаға үлес қосу сілтемесі</p></td>
      </tr>
      <tr>
	<td><p><media type="image" src="figures/scalable/symbolic/computer-fail-symbolic.svg" mime="image/svg" its:translate="no"/></p></td>
	<td><p>Қателер туралы хабарлау сілтемесі</p></td>
      </tr>
      <tr>
	<td><p><media type="image" src="figures/scalable/symbolic/help-link-symbolic.svg" mime="image/svg" its:translate="no"/></p></td>
	<td><p>Көмек сілтемесі</p></td>
      </tr>
      <tr>
	<td><p><media type="image" src="figures/scalable/symbolic/contact-symbolic.svg" mime="image/svg" its:translate="no"/></p></td>
	<td><p>Байланыс сілтемесі</p></td>
      </tr>
    </table>
    <p>Бұл сілтемелердің кейбіреулері немесе барлығы қосымшаның метаақпарат файлында тізімделгеніне байланысты болуы мүмкін.</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>Бағдарламалық қамтамаға қандай аппараттық құралдар қажет екенін, оның қай жастағы пайдаланушыларға сәйкес келетінін және оны орнатуның қаншалықты қауіпсіз екендігіне әсер ететін факторларды көрсету үшін пайдаланылатын метадеректердің барлығы сол бағдарламалық қамтаманың метаақпарат файлынан алынады.</p>
    <p>Метаақпарат файлы — XML файлы. Оның файл пішімі <link href="https://www.freedesktop.org/software/appstream/docs/">AppStream спецификациясында</link> көрсетілген.</p>
    <p><link href="https://gitlab.gnome.org/GNOME/nautilus/-/blob/main/data/org.gnome.Nautilus.metainfo.xml.in.in">GNOME Файлдар қосымшасының метаақпарат файлын</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>Қосымшаның скриншоттары туралы ақпарат оның метаақпарат файлындағы <code>&lt;component&gt;</code> ішіндегі <link href="https://www.freedesktop.org/software/appstream/docs/sect-Metadata-Application.html#tag-dapp-screenshots"><code>&lt;screenshots&gt;</code></link> элементінде сақталады.</p>
    <p>Қосымша үшін скриншоттардың ұсынылатын саны — 5-тен 10-ға дейін. Скриншоттар 16:9 арақатынасы бар және минималды ені 620 пиксель болатын PNG пішімінде болғаны дұрыс.</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=x11</code> орнына <code>--socket=fallback-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>Қосымша үшін аппараттық ақпарат оның метаақпарат файлындағы <code>&lt;component&gt;</code> ішіндегі <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> элементтерінде сақталады.</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>Қосымшаның мазмұн рейтингі туралы ақпарат оның метаақпарат файлындағы <code>&lt;component&gt;</code> ішіндегі <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-content_rating"><code>&lt;content_rating&gt;</code></link> элементінде сақталады.</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>Қосымшаның лицензиялау туралы ақпараты оның метаақпарат файлындағы <code>&lt;component&gt;</code> ішіндегі <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-project_license"><code>&lt;project_license&gt;</code></link> элементінде сақталады.</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>Қосымшаның сілтемелері оның метаақпарат файлындағы <code>&lt;component&gt;</code> ішіндегі <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-url"><code>&lt;url&gt;</code></link> элементтері ретінде сақталады.</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>Карусель плиткасының фон түсі әдетте қосымшаның таңбашасынан автоматты түрде алынады. Алайда, егер бұл түс көңілден шықпаса, оны мәлімделген түстері бар (47.x сериясынан бастап) <link href="https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html#tag-branding">appstream-ның <code>&lt;branding/&gt;</code> элементін</link> пайдалану арқылы қайта анықтауға болады. Артықшылығы — түстерді көбірек клиенттер пайдалана алады.</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>Кері үйлесімділік үшін қосымшаның метаақпарат <code>&lt;component&gt;</code> элементіне келесі XML-ді қосу мүмкіндігі қалды:</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 және ол қосымша үшін негізгі түстердің реттелмеген жиынтығын білдіреді. Жиынтықтың әрбір элементі <code>(0, 0, 0)</code> мен <code>(255, 255, 255)</code> аралығындағы RGB пішіміндегі түс болып табылады.</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/">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>
