[gnome-user-docs] Review lockdown.page sysadmin page



commit 0fdd2f0f80098e890718bac6b7ae8d7dddbd119a
Author: Ekaterina Gerasimova <kittykat3756 gmail com>
Date:   Sat Mar 16 19:34:42 2013 +0000

    Review lockdown.page sysadmin page
    
    Move the page to dconf-lockdown.page as the page is dconf related.
    
    Mark up untranslatable stings.
    
    Improve the wording and markup.

 system-admin-guide/C/dconf-lockdown.page |   70 ++++++++++++++++++++++++++++++
 system-admin-guide/C/lockdown.page       |   54 -----------------------
 system-admin-guide/Makefile.am           |    2 +-
 3 files changed, 71 insertions(+), 55 deletions(-)
---
diff --git a/system-admin-guide/C/dconf-lockdown.page b/system-admin-guide/C/dconf-lockdown.page
new file mode 100644
index 0000000..eb71f80
--- /dev/null
+++ b/system-admin-guide/C/dconf-lockdown.page
@@ -0,0 +1,70 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:its="http://www.w3.org/2005/11/its";
+      type="topic" style="task"
+      id="dconf-lockdown">
+
+  <info>
+    <link type="guide" xref="index" group="user" />
+    <link type="seealso" xref="dconf-profiles" />
+    <revision version="0.1" date="2012-05-21" status="review"/>
+    <revision pkgversion="3.8" version="0.1" date="2013-04-26" status="review"/>
+
+    <credit type="author copyright">
+      <name>Ryan Lortie</name>
+      <email its:translate="no">desrt desrt ca</email>
+      <years>2012</years>
+    </credit>
+    <credit type="copyright editor">
+      <name>Ekaterina Gerasimova</name>
+      <email its:translate="no">kittykat3756 gmail com</email>
+      <years>2013</years>
+    </credit>
+
+    <desc>Use the <em>lockdown</em> mode in <app its:translate="no">dconf</app> to prevent users from 
changing specific settings.</desc>
+  </info>
+
+  <title>Lock down specific settings</title>
+
+  <p>To <em>lockdown</em> <sys its:translate="no">GSettings</sys> keys in
+  <app its:translate="no">dconf</app>, you will need to create a
+  <file its:translate="no">locks</file> subdirectory in the keyfile directory.
+  The files inside this directory contain a list of keys to lock. Just as with
+  the <link xref="dconf-profiles">keyfiles</link>, you may add any number of
+  files to this directory. Here is an example of what one might look like:</p>
+
+  <steps>
+    <title>How to lock the default wallpaper</title>
+    <item>
+      <p>First, <link xref="dconf-profiles">set a default wallpaper</link>.</p>
+    </item>
+    <item>
+      <p>Create a directory named
+      <file its:translate="no">/etc/dconf/db/local.d/locks</file>.</p>
+    </item>
+    <item>
+      <p>Edit
+      <file its:translate="no">/etc/dconf/db/local.d/locks/00_default-wallpaper</file>,
+      listing one key per line:</p>
+<code its:translate="no">
+# <span its:translate="yes">prevent changes to the company wallpaper</span>
+/org/gnome/desktop/background/picture-uri
+/org/gnome/desktop/background/picture-options
+/org/gnome/desktop/background/primary-color
+/org/gnome/desktop/background/secondary-color
+</code>
+    </item>
+    <item>
+      <p>Update the system databases:</p>
+      <screen its:translate="no">
+        <output style="prompt">#</output> <input>dconf update</input>
+</screen>
+    </item>
+  </steps>
+
+  <note>
+    <p>As of <app its:translate="no">dconf</app> 0.7.4, lockdown is only
+    supported on a per-key basis for performance reasons; you may not yet lock
+    entire subpaths. There are plans to address this in future releases.</p>
+  </note>
+
+</page>
diff --git a/system-admin-guide/Makefile.am b/system-admin-guide/Makefile.am
index ed2e382..032e284 100644
--- a/system-admin-guide/Makefile.am
+++ b/system-admin-guide/Makefile.am
@@ -11,13 +11,13 @@ HELP_FILES = \
        backgrounds-extra.page          \
        custom-default-values.page      \
        custom-session.page             \
+       dconf-lockdown.page             \
        dconf-profiles-edit.page        \
        dconf-profiles.page             \
        fonts.page                      \
        gsettings-browse.page           \
        index.page                      \
        keyboard-layout.page            \
-       lockdown.page                   \
        lockscreenbackground.page       \
        login-background.page           \
        login-banner.page               \


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