<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" style="task" id="backgrounds-extra" lang="tr">

  <info>
    <link type="guide" xref="appearance"/>
    <revision pkgversion="3.30" date="2019-02-08" status="draft"/>

    <credit type="author copyright">
      <name>Matthias Clasen</name>
      <email>matthias.clasen@gmail.com</email>
      <years>2012</years>
    </credit>
    <credit type="editor">
      <name>Jana Svarova</name>
      <email>jana.svarova@gmail.com</email>
      <years>2013</years>
    </credit>
    <credit type="editor">
      <name>Petr Kovar</name>
      <email>pknbe@volny.cz</email>
      <years>2019</years>
    </credit>

    <license xmlns="http://projectmallard.org/1.0/" href="https://creativecommons.org/licenses/by-sa/3.0/">
  <p>This work is licensed under a <link href="https://creativecommons.org/licenses/by-sa/3.0/">Creative
  Commons Attribution-ShareAlike 3.0 Unported License</link>.</p>
</license>

    <desc>How do I make extra backgrounds available to my users?</desc>
  </info>

  <title>Add extra backgrounds</title>

  <p>You can make extra backgrounds available to users on your system by
  following the steps below.</p>

  <steps>
  <title>Set extra backgrounds</title>
  <item>
  <p>Create an XML file, for example <file><var>filename</var>.xml</file>.
  In this file, use keys from the <sys>org.gnome.desktop.background</sys>
  GSettings schema to specify extra backgrounds and their appearance.</p>

  <p>Below is a list of the most frequently used keys:</p>

  <table frame="top bottom" rules="all" shade="rows">
    <title>org.gnome.desktop.background schemas GSettings keys</title>
    <tbody>
    <tr>
      <td><p>Key name</p></td>
      <td><p>Possible values</p></td>
      <td><p>Description</p></td>
    </tr>
    <tr>
      <td><p>picture-options</p></td>
      <td><p>"none", "wallpaper", "centered", "scaled", "stretched", "zoom", "spanned"</p></td>
      <td><p>Determines how the image set by <var>wallpaper_filename</var> is rendered.</p></td>
    </tr>
    <tr>
      <td><p>color-shading-type</p></td>
      <td><p>"horizontal", "vertical", and "solid"</p></td>
      <td><p>How to shade the background color.</p></td>
    </tr>
    <tr>
      <td><p>primary-color</p></td>
      <td><p>default: #023c88</p></td>
      <td><p>Left or top color when drawing gradients, or the solid color.</p></td>
    </tr>
    <tr>
      <td><p>secondary-color</p></td>
      <td><p>default: #5789ca</p></td>
      <td><p>Right or bottom color when drawing gradients, not used for solid color.</p></td>
    </tr>
  </tbody>
  </table>

  <p>You can view a complete list of <sys>org.gnome.desktop.background</sys>
  keys and possible values using <app>dconf-editor</app> or the <cmd>gsettings</cmd>
  command-line utility. See <link xref="gsettings-browse"/> for more information.
  </p>
  <p>Below is a sample <file><var>filename</var>.xml</file> file:</p>

<code mime="application/xml">
&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;!DOCTYPE wallpapers SYSTEM "gnome-wp-list.dtd"&gt;
&lt;wallpapers&gt;
  &lt;wallpaper deleted="false"&gt;
    &lt;name&gt;Company Background&lt;/name&gt;
    &lt;name xml:lang="de"&gt;Firmenhintergrund&lt;/name&gt;
    &lt;filename&gt;/usr/local/share/backgrounds/company-wallpaper.jpg&lt;/filename&gt;
    &lt;options&gt;zoom&lt;/options&gt;
    &lt;shade_type&gt;solid&lt;/shade_type&gt;
    &lt;pcolor&gt;#ffffff&lt;/pcolor&gt;
    &lt;scolor&gt;#000000&lt;/scolor&gt;
  &lt;/wallpaper&gt;
&lt;/wallpapers&gt;

</code>

  </item>
  <item>
  <p>Place the <file><var>filename</var>.xml</file> file in the
  <file>/usr/share/gnome-background-properties/</file> directory.</p>
  <p>Users will have the extra backgrounds available for configuration from
  <guiseq><gui>Settings</gui> <gui>Background</gui></guiseq>.</p>
  </item>
  </steps>


  <section id="backgrounds-extra-two-wallpapers">
  <title>Specify multiple backgrounds</title>
  <p>In one configuration file, you can specify multiple
  <code>&lt;wallpaper&gt;</code> elements to add more backgrounds.</p>
  <p>See the following example with two <code>&lt;wallpaper&gt;</code> elements,
  adding two different backgrounds:</p>

<code mime="application/xml">
&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;!DOCTYPE wallpapers SYSTEM "gnome-wp-list.dtd"&gt;
&lt;wallpapers&gt;
  &lt;wallpaper deleted="false"&gt;
    &lt;name&gt;Company Background&lt;/name&gt;
    &lt;name xml:lang="de"&gt;Firmenhintergrund&lt;/name&gt;
    &lt;filename&gt;/usr/local/share/backgrounds/company-wallpaper.jpg&lt;/filename&gt;
    &lt;options&gt;zoom&lt;/options&gt;
    &lt;shade_type&gt;solid&lt;/shade_type&gt;
    &lt;pcolor&gt;#ffffff&lt;/pcolor&gt;
    &lt;scolor&gt;#000000&lt;/scolor&gt;
  &lt;/wallpaper&gt;
  &lt;wallpaper deleted="false"&gt;
    &lt;name&gt;Company Background 2&lt;/name&gt;
    &lt;name xml:lang="de"&gt;Firmenhintergrund 2&lt;/name&gt;
    &lt;filename&gt;/usr/local/share/backgrounds/company-wallpaper-2.jpg&lt;/filename&gt;
    &lt;options&gt;zoom&lt;/options&gt;
    &lt;shade_type&gt;solid&lt;/shade_type&gt;
    &lt;pcolor&gt;#ff0000&lt;/pcolor&gt;
    &lt;scolor&gt;#00ffff&lt;/scolor&gt;
  &lt;/wallpaper&gt;
&lt;/wallpapers&gt;
</code>

</section>
</page>
