<page xmlns="http://projectmallard.org/1.0/"
      xmlns:its="http://www.w3.org/2005/11/its"
      type="topic" style="task"
      id="login-logo">

  <info>
    <link type="guide" xref="login#appearance"/>
    <link type="seealso" xref="login-banner"/>
    <!--<link type="seealso" xref="gdm-restart"/>-->
    <revision pkgversion="3.11" date="2014-01-29" status="draft"/>

    <credit type="author copyright">
      <name>Matthias Clasen</name>
      <email>[email protected]</email>
      <years>2012</years>
    </credit>
    <credit type="author copyright">
      <name>Michael Hill</name>
      <email>[email protected]</email>
      <years>2012</years>
    </credit>
    <credit type="author copyright editor">
      <name>Ekaterina Gerasimova</name>
      <email>[email protected]</email>
      <years>2013</years>
    </credit>
    <credit type="editor">
      <name>Petr Kovar</name>
      <email>[email protected]</email>
      <years>2013</years>
    </credit>

    <desc>Edit a <sys its:translate="no">GDM</sys>
     <sys its:translate="no">dconf</sys>
     profile to display an image on the login screen.</desc>
   </info>

  <title>Add a greeter logo to the login screen</title>

  <comment>
    <cite date="2012-11-07" href="mailto:[email protected]">Michael Hill</cite>
    <p>Adapted from l-g-o SysAdminGuide page.</p>
  </comment>

  <p>The greeter logo on the login screen is controlled by the
  <sys>org.gnome.login-screen.logo</sys> 
  
  GSettings key. Since <sys>GDM</sys> uses its own
  <sys>dconf</sys> profile, you can add a greeter logo by changing
  the settings in that profile.</p>
  
  <p>When choosing an appropriate picture for the logo to your login screen, 
  consider the following picture requirements:</p>
  
  <list>
  <item><p>All the major formats are supported: ANI, BPM, GIF, ICNS, ICO, 
  JPEG, JPEG 2000, PCX, PNM, PBM, PGM, PPM, GTIFF, RAS, TGA, TIFF, XBM, 
  WBMP, XPM, and SVG.</p></item>
  <item><p>The size of the picture scales proportionally to the height of 
  48 pixels. So, if you set the logo to 1920x1080, for example, it changes 
  into an 85x48 thumbnail of the original picture.</p></item>
  </list>
  
  <steps>
  <title>Set the org.gnome.login-screen.logo key</title>
    <include href="dconf-snippets.xml"
      xpointer="xpointer(/*/*[@xml:id='dconf-profile-gdm'])"
      xmlns="http://www.w3.org/2001/XInclude"/>
  <item><p>Create a <sys>gdm</sys> database for machine-wide settings in
  <file>/etc/dconf/db/gdm.d/<var>01-logo</var></file>:</p>
  <code>[org/gnome/login-screen]
  logo='<var>/usr/share/pixmaps/logo/greeter-logo.png</var>'
  </code>
  <p>Replace <var>/usr/share/pixmaps/logo/greeter-logo.png</var>
  with the path to the image file you want to use as the greeter logo.
  </p></item>
    <include href="dconf-snippets.xml"
      xpointer="xpointer(/*/*[@xml:id='dconf-update'])"
      xmlns="http://www.w3.org/2001/XInclude"/>
  </steps>

  <section id="login-logo-not-update">
  <title>What if the logo does not update?</title>

  <p>Make sure that you have run the <cmd>dconf update</cmd>
  command to update the system databases.</p>

  <p>In case the logo does not update, try restarting <sys>GDM</sys>.
  <!--For more information, see <link xref="gdm-restart"/>.--></p>
  </section>

</page>