/usr/share/help/C/system-admin-guide/dconf-custom-defaults.page is in gnome-user-docs 3.28.1-0ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 | <page xmlns="http://projectmallard.org/1.0/"
xmlns:its="http://www.w3.org/2005/11/its"
type="topic" style="task"
id="dconf-custom-defaults">
<info>
<link type="guide" xref="setup" />
<link type="seealso" xref="dconf-profiles" />
<link type="seealso" xref="dconf-lockdown" />
<link type="seealso" xref="dconf" />
<revision pkgversion="3.6" version="0.1" date="2012-05-21" status="draft"/>
<credit type="author copyright">
<name>Ryan Lortie</name>
<email>desrt@desrt.ca</email>
<years>2012</years>
</credit>
<credit type="author copyright">
<name>Jeremy Bicha</name>
<email>jbicha@ubuntu.com</email>
<years>2012</years>
</credit>
<credit type="author copyright">
<name>Jim Campbell</name>
<email>jwcampbell@gmail.com</email>
<years>2012</years>
</credit>
<credit type="editor">
<name>Jana Svarova</name>
<email>jana.svarova@gmail.com</email>
<years>2013</years>
</credit>
<credit type="copyright editor">
<name>Ekaterina Gerasimova</name>
<email>kittykat3756@gmail.com</email>
<years>2013</years>
</credit>
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
<desc>Set system-wide default settings using
<sys its:translate="no">dconf</sys> profiles.</desc>
</info>
<title>Custom default values for system settings</title>
<!-- TODO: reveiw against dconf-lockdown.page -->
<p>System-wide default settings can be set by providing a default for a key
in a <sys its:translate="no">dconf</sys> profile. These defaults can be
overridden by the user.</p>
<section id="example">
<title>Set a default value</title>
<p>To set a default for a key, the <sys>user</sys> profile must exist and the
value for the key must be added to a <sys its:translate="no">dconf</sys>
database.</p>
<comment>
<cite date="2012-08-14">Jeremy Bicha</cite>
<p>You don't have to use "local" as the profile name. You can even have
different profiles for different users. This isn't mentioned because this
functionality needs something like accountsservice integration to enforce
this. gnome-control-center integration would be great too.</p>
</comment>
<steps>
<title>An example demonstrating how to set the default background</title>
<item>
<p>Create the <file its:translate="no">user</file> profile:</p>
<listing its:translate="no">
<title><file>/etc/dconf/profile/user</file></title>
<code>user-db:user
system-db:local</code>
</listing>
<p><input its:translate="no">local</input> is the name of a
<sys its:translate="no">dconf</sys> database.</p>
</item>
<item>
<p>Create a <em>keyfile</em> for the <input its:translate="no">local</input>
database which contains the default settings:</p>
<listing its:translate="no">
<title><file>/etc/dconf/db/local.d/01-background</file></title>
<code># <span its:translate="yes">dconf path</span>
[org/gnome/desktop/background]
# <span its:translate="yes">dconf key names and their corresponding values</span>
picture-uri='file:///usr/local/share/backgrounds/wallpaper.jpg'
picture-options='scaled'
primary-color='000000'
secondary-color='FFFFFF'</code>
</listing>
</item>
<include href="dconf-snippets.xml"
xpointer="xpointer(/*/*[@xml:id='dconf-update'])"
xmlns="http://www.w3.org/2001/XInclude"/>
</steps>
<note>
<p>When the <sys its:translate="no">user</sys> profile is created or
changed, the user will need to log out and log in again before the changes
will be applied.</p>
</note>
</section>
</page>
|