[gnome-user-docs] New topic sys-admin:dconf-favorite-applications



commit 55f1509bdc7a7669a5cbaacaeec8959e3b979b35
Author: Aruna Sankaranarayanan <arunasank src gnome org>
Date:   Sun Apr 28 22:30:34 2013 +0530

    New topic sys-admin:dconf-favorite-applications
    
    Added a new topic to explain how to set default favorite
    applications for different users.
    Edited sys-admin/makefile.am
    Solves bug 694571

 .../C/dconf-favorite-applications.page             |  134 ++++++++++++++++++++
 system-admin-guide/Makefile.am                     |    1 +
 2 files changed, 135 insertions(+), 0 deletions(-)
---
diff --git a/system-admin-guide/C/dconf-favorite-applications.page 
b/system-admin-guide/C/dconf-favorite-applications.page
new file mode 100644
index 0000000..da565c7
--- /dev/null
+++ b/system-admin-guide/C/dconf-favorite-applications.page
@@ -0,0 +1,134 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:its="http://www.w3.org/2005/11/its";
+      type="topic" style="task"
+      id="dconf-favorite-applications">
+
+  <info>
+    <revision pkgversion="3.8" version="0.1" date="2013-04-28" status="draft"/>
+    <link type="guide" xref="index" group="user"/>
+
+    <credit type="author">
+      <name>Aruna Sankaranarayanan</name>
+      <email its:translate="no">aruna evam gmail com</email>
+    </credit>
+
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+    <desc>Use <sys its:translate="no">dconf</sys> profiles to set default
+    favorite applications.</desc>
+
+  </info>
+
+  <title>Set default favorite applications</title>
+
+  <p>Favorite applications are those visible on the
+  <link href="help:gnome-help/shell-terminology">dash</link>. You can use
+  <sys its:translate="no">dconf</sys> to set favorite applications
+  for one user, or to set the same favorite applications
+  for all users. For both cases, you must first edit the
+  <sys its:translate="no">dconf</sys> profile found in
+  <file its:translate="no">/etc/dconf/profile</file>.</p>
+
+<section id="per-user">
+  <title>Set different favorite applications for different users</title>
+
+  <p>You can set the default favorite applications for each user by modifying
+  their user database file found in
+  <file its:translate="no">~/.config/dconf/user</file>. The following example
+  snippet uses <sys its:translate="no">dconf</sys> to set <app>gedit</app>,
+  <app>Terminal</app> and <app>Nautilus</app> as default favorites for a user.
+  The example code allows users to modify the list later, if they wish to do
+  so.</p>
+
+  <!--The code itself need not be translated but the comments withing the
+  code have to be translated.-Aruna-->
+
+  <listing>
+    <title>Contents of <file its:translate="no">/etc/dconf/profile</file>:</title>
+      <code>
+      #This line allows the user to change the default favorites later.
+      user-db:user
+      </code>
+  </listing>
+
+  <listing>
+    <title>Contents of <file its:translate="no">~/.config/dconf/user</file>:</title>
+      <code>
+      #Set gedit, terminal and nautilus as default favorites
+      [org/gnome/shell]
+      favorite-apps = [<input>'gedit.desktop'</input>, <input>'gnome-terminal.desktop'</input>, 
<input>'nautilus.desktop'</input>]
+      </code>
+  </listing>
+
+  <note style="tip">
+    <p>You can also
+    <link xref="lockdown">lockdown</link> the above settings to prevent users
+    from changing them.</p>
+  </note>
+
+</section>
+
+<section id="all-users">
+  <title>Set the same favorite applications for all users</title>
+
+  <p>In order to have the same favorites for all users, you must modify system
+  database files using <sys its:translate="no">dconf</sys>. System database
+  files are found in <file its:translate="no">/etc/dconf/db</file>, but cannot
+  be edited because they are written in GVDB format. In order to change system
+  settings using a text editor, you can modify key files found in
+  key file directories. Each key file directory corresponds to a particular
+  system database file and has the same name as the database file, appended
+  with a '.d' extension. All key file directories are found in
+  <file its:translate="no">/etc/dconf/db</file>. The following code snippets
+  edit the <sys its:translate="no">dconf</sys> profile and then create a
+  keyfile to set default favorite applications for all employees
+  in the first floor of an organization.</p>
+
+  <!--The code itself need not be translated but the comments withing the
+  code have to be translated.-Aruna-->
+
+  <listing>
+    <title>Contents of <file its:translate="no">/etc/dconf/profile</file>:</title>
+      <code>
+      user-db:user
+
+      #This line defines a system database file called first_floor
+      system-db:first_floor
+      </code>
+  </listing>
+
+  <note style="info">
+    <p>Settings from the <code>user</code> database file
+    will take preference over the settings in the
+    <code>first_floor</code> database file, but
+    <link xref="lockdown">locks</link> introduced in the
+    <code>first_floor</code> database file will take priority over
+    those present in <code>user</code>.</p>
+  </note>
+
+  <listing>
+    <title>Contents of <file 
its:translate="no">/etc/dconf/db/first_floor.d/00_floor1_settings</file>:</title>
+      <code>
+      #Snippet sets gedit, terminal and nautilus as default favorites
+      for all users in the first floor
+
+      [org/gnome/shell]
+      favorite-apps = [<input>'gedit.desktop'</input>, <input>'gnome-terminal.desktop'</input>, 
<input>'nautilus.desktop'</input>]
+      </code>
+  </listing>
+
+  <note style="important">
+    <p><cmd>dconf-update</cmd> has to be run whenever you modify a key file.
+    When you do this, <sys its:translate="no">dconf</sys> compares the time
+    stamp on a system database file with the time stamp on the corresponding
+    key file directory. If the time stamp on the key file directory is more
+    recent than the one on the database file,
+    <sys its:translate="no">dconf</sys> regenerates the
+    <code>system-db</code> file and sends a notification to the system
+    <sys>Dbus</sys>, which in turn notifies all running applications to
+    reread their settings.</p>
+  </note>
+
+</section>
+
+</page>
diff --git a/system-admin-guide/Makefile.am b/system-admin-guide/Makefile.am
index 2d1f548..ed060a7 100644
--- a/system-admin-guide/Makefile.am
+++ b/system-admin-guide/Makefile.am
@@ -14,6 +14,7 @@ HELP_FILES = \
        dconf-nfs-home.page             \
        dconf-profiles-edit.page        \
        dconf-profiles.page             \
+       dconf-favorite-applications.page\
        fonts.page                      \
        gsettings-browse.page           \
        index.page                      \


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]