desktop-background.page 3.75 KB
Newer Older
1
<page xmlns="http://projectmallard.org/1.0/"
2
      xmlns:its="http://www.w3.org/2005/11/its"
3
      type="topic" style="task"
4
      id="desktop-background">
5

6
  <info>
7
    <link type="guide" xref="appearance" />
8
    <link type="seealso" xref="backgrounds-extra" />
Petr Kovář's avatar
Petr Kovář committed
9
    <revision pkgversion="3.11" date="2014-01-29" status="draft"/>
10 11 12 13
    <revision pkgversion="3.14" date="2014-06-17" status="incomplete">
      <desc>All prose and instructions are up to par. Extra info needs
      to be provided on picture options, per comment below. --shaunm</desc>
    </revision>
14 15

    <credit type="author copyright">
16
      <name>Matthias Clasen</name>
17
      <email>matthias.clasen@gmail.com</email>
18 19
      <years>2012</years>
    </credit>
20 21
    <credit type="editor">
      <name>Jana Svarova</name>
22
      <email>jana.svarova@gmail.com</email>
23 24
      <years>2013</years>
    </credit>
Petr Kovář's avatar
Petr Kovář committed
25 26
    <credit type="editor">
      <name>Petr Kovar</name>
27
      <email>pknbe@volny.cz</email>
Petr Kovář's avatar
Petr Kovář committed
28 29
      <years>2014</years>
    </credit>
30 31
    <credit type="editor">
      <name>David King</name>
32
      <email>davidk@gnome.org</email>
33 34
      <years>2014</years>
    </credit>
Kat's avatar
Kat committed
35 36
    <credit type="editor">
      <name>Ekaterina Gerasimova</name>
37
      <email>kittykat3756@gmail.com</email>
Kat's avatar
Kat committed
38 39
      <years>2014</years>
    </credit>
40

41 42
    <desc>Change the default desktop background for all users.</desc>
  </info>
43

Kat's avatar
Kat committed
44
  <title>Set custom background</title>
Petr Kovář's avatar
Petr Kovář committed
45

Kat's avatar
Kat committed
46 47 48
  <p>You can change the default desktop background to one that you want to use.
  For example, you may want to use a background with your company or university
  logo instead of the default GNOME background.</p>
49

Petr Kovář's avatar
Petr Kovář committed
50 51
  <steps>
    <title>Set the default background</title>
52
    <include href="dconf-snippets.xml"
Kat's avatar
Kat committed
53 54 55 56 57
             xpointer="xpointer(/*/*[@xml:id='dconf-profile-user'])"
             xmlns="http://www.w3.org/2001/XInclude"/>
    <include href="dconf-snippets.xml"
             xpointer="xpointer(/*/*[@xml:id='dconf-profile-user-dir'])"
             xmlns="http://www.w3.org/2001/XInclude"/>
Petr Kovář's avatar
Petr Kovář committed
58
    <item>
Kat's avatar
Kat committed
59 60 61 62
      <p>Create the key file
      <file>/etc/dconf/db/local.d/00-background</file> to provide
      information for the <sys>local</sys> database.</p>
      <listing>
63 64 65
        <title><file>/etc/dconf/db/local.d/00-background</file></title>
<code>
# Specify the dconf path
Petr Kovář's avatar
Petr Kovář committed
66
[org/gnome/desktop/background]
67

Petr Kovář's avatar
Petr Kovář committed
68 69
# Specify the path to the desktop background image file
picture-uri='file:///usr/local/share/backgrounds/wallpaper.jpg'
Kat's avatar
Kat committed
70

Petr Kovář's avatar
Petr Kovář committed
71 72
# Specify one of the rendering options for the background image:
picture-options='scaled'
Kat's avatar
Kat committed
73

Petr Kovář's avatar
Petr Kovář committed
74 75
# Specify the left or top color when drawing gradients, or the solid color
primary-color='000000'
Kat's avatar
Kat committed
76

Petr Kovář's avatar
Petr Kovář committed
77
# Specify the right or bottom color when drawing gradients
78 79
secondary-color='FFFFFF'
</code>
Kat's avatar
Kat committed
80
      </listing>
81 82 83 84 85 86
      <comment>
	<cite date="2014-06-18">shaunm</cite>
	<p>Provide information about the different picture-options
	values. Possibly also about when and how colors are used
	and what the gradient does.</p>
      </comment>
Petr Kovář's avatar
Petr Kovář committed
87 88
    </item>
    <item>
Kat's avatar
Kat committed
89 90 91 92 93
      <p>To prevent the user from overriding these settings, create the file
      <file>/etc/dconf/db/local.d/locks/background</file> with the following
      content:</p>
      <listing>
        <title><file>/etc/dconf/db/local.d/locks/background</file></title>
94 95
<code>
# Lock desktop background settings
Petr Kovář's avatar
Petr Kovář committed
96 97 98
/org/gnome/desktop/background/picture-uri
/org/gnome/desktop/background/picture-options
/org/gnome/desktop/background/primary-color
99 100
/org/gnome/desktop/background/secondary-color
</code>
Kat's avatar
Kat committed
101
      </listing>
Petr Kovář's avatar
Petr Kovář committed
102
    </item>
103
    <include href="dconf-snippets.xml"
Kat's avatar
Kat committed
104 105 106 107 108
             xpointer="xpointer(/*/*[@xml:id='dconf-update'])"
             xmlns="http://www.w3.org/2001/XInclude"/>
    <include href="dconf-snippets.xml"
             xpointer="xpointer(/*/*[@xml:id='dconf-logoutin'])"
             xmlns="http://www.w3.org/2001/XInclude"/>
Petr Kovář's avatar
Petr Kovář committed
109
  </steps>
110 111

</page>