[gnome-user-docs] backgrounds-extra.page has been updated, ready for a review



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>&lt;wallpaper&gt;</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>&lt;wallpaper&gt;</code> elements to add more backgrounds.
-  </p>
+  <code>&lt;wallpaper&gt;</code> elements to add more backgrounds.</p>
   <p>See the following example which shows an <sys>XML</sys> file with two
-  <code>&lt;wallpaper&gt;</code> elements, adding two different backgrounds:
-  </p>
+  <code>&lt;wallpaper&gt;</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]