<page xmlns="http://projectmallard.org/1.0/" xmlns:its="http://www.w3.org/2005/11/its" type="topic" style="task" id="dev-launching-desktop" xml:lang="cs">

  <info>

    <link type="next" xref="dev-launching-icons"/>

    <revision version="0.1" date="2014-01-28" status="draft"/>

    <credit type="author">

      <name>David King</name>

      <email its:translate="no">davidk@gnome.org</email>

      <years>2014</years>

    </credit>

    <include xmlns="http://www.w3.org/2001/XInclude" href="cc-by-sa-3-0.xml"/>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">

      <mal:name>Lucas Lommer</mal:name>

      <mal:email>llommer@svn.gnome.org</mal:email>

      <mal:years>2009.</mal:years>

    </mal:credit>

    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">

      <mal:name>Marek Černocký</mal:name>

      <mal:email>marek@manet.cz</mal:email>

      <mal:years>2015.</mal:years>

    </mal:credit>

  </info>

  <title>Instalace souboru .desktop</title>

  <links type="series" style="floatend">

    <title>Spuštění vaší aplikace</title>

  </links>

  
Napiště a nainstalujte soubor .desktop, aby uživatelé mohli vaši aplikaci najít a spustit.

  
GNOME používá k popisu spouštěčů aplilací <link href="http://standards.freedesktop.org/desktop-entry-spec/latest/index.html">položky pracovní plochy podle freedesktop.org</link> a <link href="http://standards.freedesktop.org/menu-spec/latest/">specifikací nabídky pracovní plochy</link>. Instalace souboru .desktop je standardní způsob, jak zaregistrovat svou aplikaci v GNOME a dalších pracovních prostředích.

  
Soubor .desktop specifikuje spustitelný soubor vaší aplikace, její název a typ. Navíc může uvádět její ikonu, popis a některé další doplňující informace ohledně spuštění aplikace.

  
Pro hypotetickou aplikaci <app>My Application</app> by mohl soubor .desktop vypadat nějak takto:

  <example>

    <listing>

      <title><file>myapplication.desktop</file></title>

[Desktop Entry]

Name=My Application

Exec=myapplication

Type=Application

Icon=myapplication

Comment=Do the thing that the application does

Categories=GTK;GNOME;Utility;

    </listing>

  </example>

  
Řádek [Desktop Entry] říká, že se jedná o soubor .desktop. Následují jednotlivé klíče, které popisují, jak spustit aplikaci. Klíč Name je název aplikace přívětivý pro člověka a zobrazuje se v uživatelském rozhraní. Klíč se sepustitelným souborem je Exec a může být uveden včetně celé cesty nebo jen jako název souboru a pak se vyhledává v cestách podle PATH. Posledním povinným klíčem je Type, který má pro aplikaci vždy hodnodu Application. Ostatní typy jsou uvedeny ve specifikaci souborů .desktop.

  
Ostatní pole v souboru .desktop jsou volitelná, ale doporučená. Aplikace by měla mít nainstalovanou ikonu a název ikony (bez přípony) uvést v klíči Icon. Comment je stručný popis aplikace. Při hledání aplikace může uživateli pomoci klíč Categories šířený se seznamem kategorií oddělených středníkem podle specifikace nabídky pracovní plochy.

  
Ve specifikaci položky pracovní plochy je uvedeno a popsáno i několik dalších klíčů, které je možné do souboru .desktop přidat.

</page>