Commit f06328c6 authored by Petr Kovář's avatar Petr Kovář Committed by Petr Kovář

Improve favorite-applications, dconf-profiles, add markup & navigation

parent 59135cee
Pipeline #65848 passed with stage
in 7 minutes and 59 seconds
......@@ -11,7 +11,7 @@
<link xref="desktop-shield">Change the lock screen shield</link>,
<link xref="desktop-favorite-applications">default favorite
applications</link>,
<link xref="desktop-lockscreen">lock the screen when user is idle</link>…
<link xref="desktop-lockscreen">lock the screen when idle</link>…
</desc>
</info>
......
......@@ -78,7 +78,7 @@
</p>
<p>Below is a sample <file><var>filename</var>.xml</file> file:</p>
<code><![CDATA[
<code mime="application/xml"><![CDATA[
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE wallpapers SYSTEM "gnome-wp-list.dtd">
<wallpapers>
......@@ -112,7 +112,7 @@
<p>See the following example with two <code>&lt;wallpaper&gt;</code> elements,
adding two different backgrounds:</p>
<code><![CDATA[
<code mime="application/xml"><![CDATA[
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE wallpapers SYSTEM "gnome-wp-list.dtd">
<wallpapers>
......
......@@ -7,7 +7,7 @@
<link type="guide" xref="setup" />
<link type="seealso" xref="dconf-custom-defaults" />
<link type="seealso" xref="dconf" />
<revision pkgversion="3.30" date="2019-02-08" status="incomplete"/>
<revision pkgversion="3.30" date="2019-02-22" status="incomplete"/>
<credit type="author copyright">
<name>Ryan Lortie</name>
......@@ -59,8 +59,8 @@
<title>Sample profile</title>
<code its:translate="no">
user-db:user
system-db:<input>local</input>
system-db:<input>site</input>
system-db:<var>local</var>
system-db:<var>site</var>
</code>
</listing>
</example>
......@@ -68,12 +68,25 @@ system-db:<input>site</input>
<!-- TODO: explain the profile syntax (maybe new page) -->
<!--TODO: explain local and site -->
<p>Configuring a single user and multiple system databases allows for layering
of preferences. Settings from the <code>user</code> database file take
precedence over the settings in the <code>local</code> database file, and the
<code>local</code> database file in turn takes precedence over the
<code>site</code> database file.</p>
<p>However, the order of precedence for <link xref="dconf-lockdown">locks</link>
is reversed. Locks introduced in the <code>site</code> or <code>local</code>
database files take priority over those present in <code>user</code>.</p>
<note style="important">
<p>The <sys>dconf</sys> profile for a session is determined at login, so users
will have to log out and log in to apply a new <sys>dconf</sys> user profile
to their session.</p>
</note>
<p>For more information, see the <link its:translate="no" href="man:dconf(7)">
<cmd>dconf</cmd>(7)</link> man page.</p>
<section id="dconf-profiles">
<title>Select a profile</title>
......@@ -88,6 +101,9 @@ system-db:<input>site</input>
<sys>dconf</sys> attempts to open the profile named “user”. If that
fails, it will fall back to an internal hard-wired configuration.</p>
<p>For more information, see the <link its:translate="no" href="man:dconf(7)">
<cmd>dconf</cmd>(7)</link> man page.</p>
</section>
</page>
......@@ -5,6 +5,7 @@
<info>
<link type="guide" xref="appearance" />
<link type="seealso" xref="backgrounds-extra" />
<revision pkgversion="3.11" date="2014-01-29" status="draft"/>
<revision pkgversion="3.14" date="2014-06-17" status="incomplete">
<desc>All prose and instructions are up to par. Extra info needs
......
......@@ -5,24 +5,29 @@
<info>
<link type="guide" xref="appearance"/>
<revision pkgversion="3.8" date="2013-04-28" status="draft"/>
<revision pkgversion="3.30" date="2019-02-22" status="review"/>
<credit type="author">
<name>Aruna Sankaranarayanan</name>
<email>aruna.evam@gmail.com</email>
</credit>
<credit type="editor">
<name>Petr Kovar</name>
<email>pknbe@volny.cz</email>
<years>2019</years>
</credit>
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
<desc>Customize the default favourites in the Activities overview.</desc>
<desc>Customize the default favorites in the Activities overview.</desc>
</info>
<title>Default favorite applications</title>
<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
<p>Favorite applications are those visible on the GNOME Shell
<link href="help:gnome-help/shell-introduction#activities">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
......@@ -35,28 +40,25 @@
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-->
<app>Terminal</app> and <app>Files</app> (<sys>nautilus</sys>) as default
favorites for a user. The example code allows users to modify the list later,
if they wish to do so.</p>
<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>
<code its:translate="no">
# <span its:translate="yes">This line allows the user to change the default favorites later</span>
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>
<code its:translate="no">
# <span its:translate="yes">Set gedit, terminal and nautilus as default favorites</span>
[org/gnome/shell]
favorite-apps = [<var>'gedit.desktop'</var>, <var>'gnome-terminal.desktop'</var>, <var>'nautilus.desktop'</var>]
</code>
</listing>
<note style="tip">
......@@ -71,45 +73,52 @@
<p>In order to have the same favorites for all users, you must modify system
database files using <link xref="dconf-keyfiles">dconf keyfiles</link>. The
following code snippets edit the <sys its:translate="no">dconf</sys> profile
following steps 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 within 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 precedence over the settings in the
<code>first_floor</code> database file, but
<link xref="dconf-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>
<p>Incorporate your changes into the system databases by running
<cmd>dconf update</cmd>.</p>
users in the <code>local</code> configuration database.</p>
<steps>
<title>Set the favorite applications</title>
<include href="dconf-snippets.xml"
xpointer="xpointer(/*/*[@xml:id='dconf-profile-user'])"
xmlns="http://www.w3.org/2001/XInclude"/>
<include href="dconf-snippets.xml"
xpointer="xpointer(/*/*[@xml:id='dconf-profile-user-dir'])"
xmlns="http://www.w3.org/2001/XInclude"/>
<item>
<p>Create the key file
<file>/etc/dconf/db/local.d/00-favorite-apps</file> to provide
information for the <sys>local</sys> database.</p>
<listing>
<title>Contents of
<file its:translate="no">/etc/dconf/db/local.d/00-favorite-apps</file>:
</title>
<code>
# Snippet sets gedit, terminal and nautilus as default favorites for all users
[org/gnome/shell]
favorite-apps = [<var>'gedit.desktop'</var>, <var>'gnome-terminal.desktop'</var>, <var>'nautilus.desktop'</var>]
</code>
</listing>
</item>
<item>
<p>To prevent the user from overriding these settings, create the file
<file>/etc/dconf/db/local.d/locks/favorite-apps</file> with the following
content:</p>
<listing>
<title><file>/etc/dconf/db/local.db/locks/favorite-apps</file></title>
<code>
# Lock default favorite applications
/org/gnome/shell/favorite-apps
</code>
</listing>
</item>
<include href="dconf-snippets.xml"
xpointer="xpointer(/*/*[@xml:id='dconf-update'])"
xmlns="http://www.w3.org/2001/XInclude"/>
<include href="dconf-snippets.xml"
xpointer="xpointer(/*/*[@xml:id='dconf-logoutin'])"
xmlns="http://www.w3.org/2001/XInclude"/>
</steps>
</section>
......
......@@ -29,10 +29,10 @@
enter a password after being idle.</desc>
</info>
<title>Lock the screen when user is idle</title>
<title>Lock the screen when the user is idle</title>
<p>You can make the screen lock automatically whenever a user
is idle for some amount of time. This is useful if your users
<p>You can make the screen lock automatically whenever the user
is idle for some amount of time. This is useful if users
may leave their computers unattended in public or unsecure
locations.</p>
......
......@@ -10,6 +10,7 @@
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
<desc>A guide for GNOME 3 system administrators</desc>
</info>
<title>GNOME System Administration Guide</title>
......
......@@ -86,15 +86,15 @@
<p>Add the layout codes to
<file>/usr/share/X11/xorg.conf.d/10-evdev.conf</file> in the following
way:</p>
<screen>
Section "InputClass"
Identifier "evdev keyboard catchall"
MatchIsKeyboard "on"
MatchDevicePath "/dev/input/event*"
Driver "evdev"
<input>Option "XkbLayout" "en,fr"</input>
EndSection
</screen>
<screen>
Section "InputClass"
Identifier "evdev keyboard catchall"
MatchIsKeyboard "on"
MatchDevicePath "/dev/input/event*"
Driver "evdev"
<input>Option "XkbLayout" "en,fr"</input>
EndSection
</screen>
<p>Multiple layouts can be added as a comma separated list, as shown in
the example for English (<sys>en</sys>) and French (<sys>fr</sys>)
layouts.</p>
......
......@@ -5,11 +5,14 @@
<info>
<link type="guide" xref="user-settings#lockdown"/>
<link type="guide" xref="sundry#session"/>
<link type="seealso" xref="lockdown-printing" />
<link type="seealso" xref="lockdown-file-saving" />
<link type="seealso" xref="lockdown-repartitioning" />
<link type="seealso" xref="lockdown-command-line" />
<link type="seealso" xref="login-automatic" />
<link type="seealso" xref="session-custom" />
<link type="seealso" xref="session-user" />
<revision pkgversion="3.30" date="2019-02-08" status="review"/>
......@@ -33,7 +36,7 @@
<desc>Set up a kiosk-like, single-application system.</desc>
</info>
<title>Configure single-application mode</title>
<p>Single-application mode is a modified GNOME Shell which configures the
......
......@@ -5,6 +5,7 @@
<info>
<link type="guide" xref="login#appearance"/>
<link type="seealso" xref="login-banner"/>
<!--<link type="seealso" xref="gdm-restart"/>-->
<revision pkgversion="3.11" date="2014-01-29" status="draft"/>
......
......@@ -9,7 +9,7 @@
<desc>
<link xref="login-userlist-disable">Disable the user list</link>,
<link xref="session-user">configure a user default session</link>,
<link xref="login-automatic">configure automatic login</link>…
<link xref="login-automatic">automatic login</link>…
</desc>
</info>
......
......@@ -8,13 +8,16 @@
<link type="seealso" xref="mime-types-custom" />
<revision pkgversion="3.30" date="2019-02-08" status="review"/>
<credit type="author">
<credit type="author copyright">
<name>Petr Kovar</name>
<email>pknbe@volny.cz</email>
<years>2014</years>
</credit>
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
<desc>Customize per user which application opens a specific MIME type.
</desc>
</info>
<title>Override the default registered application for individual users</title>
......
......@@ -9,13 +9,15 @@
<link type="seealso" xref="mime-types-custom" />
<revision pkgversion="3.30" date="2019-02-08" status="review"/>
<credit type="author">
<credit type="author copyright">
<name>Petr Kovar</name>
<email>pknbe@volny.cz</email>
<years>2014</years>
</credit>
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
<desc>Customize which application opens a specific MIME type.</desc>
</info>
<title>Override the default registered application for all users</title>
......
......@@ -7,13 +7,16 @@
<link type="seealso" xref="mime-types" />
<revision pkgversion="3.12" date="2014-06-17" status="review"/>
<credit type="author">
<credit type="author copyright">
<name>Petr Kovar</name>
<email>pknbe@volny.cz</email>
<years>2014</years>
</credit>
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
<desc>Create a user's MIME type specification and register a default
application.</desc>
</info>
<title>Add a custom MIME type for individual users</title>
......
......@@ -8,13 +8,16 @@
<link type="seealso" xref="mime-types-custom-user" />
<revision pkgversion="3.12" date="2014-06-17" status="review"/>
<credit type="author">
<credit type="author copyright">
<name>Petr Kovar</name>
<email>pknbe@volny.cz</email>
<years>2014</years>
</credit>
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
<desc>Create a MIME type specification and register a default
application.</desc>
</info>
<title>Add a custom MIME type for all users</title>
......
......@@ -9,9 +9,10 @@
<link type="seealso" xref="mime-types-custom-user" />
<revision pkgversion="3.12" date="2014-06-17" status="review"/>
<credit type="author">
<credit type="author copyright">
<name>Petr Kovar</name>
<email>pknbe@volny.cz</email>
<years>2014</years>
</credit>
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
......
......@@ -4,33 +4,33 @@
id="network-printer-config">
<info>
<link type="guide" xref="network" />
<revision pkgversion="3.8" date="2013-03-19" status="draft"/>
<link type="guide" xref="network" />
<revision pkgversion="3.30" date="2019-02-22" status="review"/>
<credit type="author copyright">
<name>Jana Svarova</name>
<email>jana.svarova@gmail.com</email>
<years>2013</years>
</credit>
<credit type="editor">
<name>Petr Kovar</name>
<email>pknbe@volny.cz</email>
<years>2019</years>
</credit>
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
<desc>How do I preconfigure my Samba printer</desc>
<desc>How do I configure a Samba printer?</desc>
</info>
<title>Configure a printer</title>
<comment>
<cite date="2013-03-19" href="mailto:jsvarova@gmail.com">Jana Svarova</cite>
<p>Adapted from GNOME Bugzilla – Bug 694569</p>
</comment>
<title>Configure a network printer</title>
<p>This topic explains how to make printers, Windows printers in particular,
available in GNOME.</p>
<p>This topic explains how to make network printers, Windows printers in
particular, available in GNOME.</p>
<p>There is no preconfiguration needed for being able to install Samba
printers using gnome-control-center. To add a new Samba printer to your CUPS
(Common UNIX Printing System) server, simply follow the steps below.</p>
printers using <app>GNOME Settings</app>. To add a new Samba printer to your
CUPS (Common UNIX Printing System) server, simply follow the steps below.</p>
<steps>
<title>Configure your printer</title>
......
......@@ -9,11 +9,12 @@
<desc>
<link xref="network-server-list">Configure a default server list</link>,
<link xref="network-printer-config">configure a printer</link>,
<link xref="network-printer-config">a network printer</link>,
<link xref="network-vpn">default VPN settings</link>…
</desc>
</info>
<title>Network &amp; Hardware</title>
<title>Network &amp; hardware</title>
</page>
......@@ -6,6 +6,7 @@
<info>
<link type="guide" xref="software#management" />
<link type="guide" xref="sundry#session"/>
<revision pkgversion="3.12" date="2014-06-17" status="review"/>
<credit type="author copyright">
......
......@@ -3,9 +3,13 @@
id="setup">
<info>
<link type="guide" xref="index" group="#first"/>
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
<desc>User and system settings management</desc>
</info>
<title>Setup</title>
......
......@@ -8,10 +8,9 @@
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
<desc>
<link xref="extensions">What are GNOME Shell extensions?</link>,
<link xref="mime-types">what are MIME types?</link>,
<link xref="mime-types-application">override the default registered
application for all users</link>…
<link xref="extensions">GNOME Shell extensions</link>,
<link xref="mime-types">MIME types</link>,
<link xref="mime-types-application">override default applications</link>…
</desc>
</info>
......
......@@ -3,9 +3,13 @@
id="sundry">
<info>
<link type="guide" xref="index" group="#last"/>
<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
<desc>Session management and troubleshooting</desc>
</info>
<title>Other</title>
......
......@@ -16,7 +16,7 @@
</info>
<title>User Settings</title>
<title>User settings</title>
<!--<section id="default">
<title>Pre-seed user defaults</title>
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment