[gnome-user-docs] New topic sys-admin:dconf-favorite-applications
- From: Aruna Sankaranarayanan <arunasank src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gnome-user-docs] New topic sys-admin:dconf-favorite-applications
- Date: Mon, 24 Jun 2013 15:22:09 +0000 (UTC)
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]