[gnome-user-docs] backgrounds-extra.page has been updated, ready for a review
- From: Jana Svarova <jsvarova src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gnome-user-docs] backgrounds-extra.page has been updated, ready for a review
- Date: Wed, 18 Jun 2014 16:39:07 +0000 (UTC)
commit 13bc217f6afcd7e8fffdbbda620c20775c7827e0
Author: Jana Svarova <jsvarova redhat com>
Date: Wed Jun 18 11:32:55 2014 +0200
backgrounds-extra.page has been updated, ready for a review
system-admin-guide/C/backgrounds-extra.page | 62 +++++++++++++++++++++++----
1 files changed, 53 insertions(+), 9 deletions(-)
---
diff --git a/system-admin-guide/C/backgrounds-extra.page b/system-admin-guide/C/backgrounds-extra.page
index dce4743..becaa6a 100644
--- a/system-admin-guide/C/backgrounds-extra.page
+++ b/system-admin-guide/C/backgrounds-extra.page
@@ -21,13 +21,59 @@
</info>
<title>Add extra backgrounds</title>
+ <p>You can make extra backgrounds available to users on your system:</p>
- <p>You can make extra backgrounds available to users on your system.</p>
-
- <p>To do so, create an <sys>XML</sys> file describing your extra backgrounds
- in the <file>/usr/share/gnome-background-properties/</file> directory.
- Below is a simple example:</p>
+<steps>
+ <title>Set your extra background</title>
+ <item>
+ <p>Create a <var>filename</var>.xml file specifying your extra
+ background's appearance using the <em>org.gnome.desktop.background schemas</em>.
+ Here is a list of the most frequently used schemas; the full range of options
+ is to be found in the <sys>dconf-editor</sys> GUI or <sys>gsettings</sys> command-line utility.</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>
+ </item>
+ <item>
+ <p>Store the <var>filename</var>.xml file in the
+ <file>/usr/share/gnome-background-properties/</file> directory.</p>
+ </item>
+</steps>
+ <p>When you click on your name in the top right corner and choose
+ <guiseq><gui>Settings</gui><gui>Personal</gui><gui>Background</gui></guiseq>,
+ you will see the new background available.</p>
+ <p>Look at the example and see how <em>org.gnome.desktop.background</em> GSettings keys
+ are implemented practically. Here is a sample <code><wallpaper></code> element.</p>
+
<code><![CDATA[
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE wallpapers SYSTEM "gnome-wp-list.dtd">
@@ -47,11 +93,9 @@
<section id="backgrounds-extra-two-wallpapers">
<title>Specify multiple backgrounds</title>
<p>In one configuration file, you can specify multiple
- <code><wallpaper></code> elements to add more backgrounds.
- </p>
+ <code><wallpaper></code> elements to add more backgrounds.</p>
<p>See the following example which shows an <sys>XML</sys> file with two
- <code><wallpaper></code> elements, adding two different backgrounds:
- </p>
+ <code><wallpaper></code> elements, adding two different backgrounds:</p>
<code><![CDATA[
<?xml version="1.0" encoding="UTF-8"?>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]