Commit f06328c698b86a8bfe32389e6aa1e5e8a48b91b5 - gnome-user-docs

+1

-1

system-admin-guide/C/appearance.page less more

10	10	<link xref="desktop-shield">Change the lock screen shield</link>,
11	11	<link xref="desktop-favorite-applications">default favorite
12	12	applications</link>,
13		<link xref="desktop-lockscreen">lock the screen when user is idle</link>…
	13	<link xref="desktop-lockscreen">lock the screen when idle</link>…
14	14	</desc>
15	15
16	16	</info>

+2

-2

system-admin-guide/C/backgrounds-extra.page less more

77	77	</p>
78	78	<p>Below is a sample <file><var>filename</var>.xml</file> file:</p>
79	79
80		<code><![CDATA[
	80	<code mime="application/xml"><![CDATA[
81	81	<?xml version="1.0" encoding="UTF-8"?>
82	82	<!DOCTYPE wallpapers SYSTEM "gnome-wp-list.dtd">
83	83	<wallpapers>

111	111	<p>See the following example with two <code><wallpaper></code> elements,
112	112	adding two different backgrounds:</p>
113	113
114		<code><![CDATA[
	114	<code mime="application/xml"><![CDATA[
115	115	<?xml version="1.0" encoding="UTF-8"?>
116	116	<!DOCTYPE wallpapers SYSTEM "gnome-wp-list.dtd">
117	117	<wallpapers>

+19

-3

system-admin-guide/C/dconf-profiles.page less more

6	6	<link type="guide" xref="setup" />
7	7	<link type="seealso" xref="dconf-custom-defaults" />
8	8	<link type="seealso" xref="dconf" />
9		<revision pkgversion="3.30" date="2019-02-08" status="incomplete"/>
	9	<revision pkgversion="3.30" date="2019-02-22" status="incomplete"/>
10	10
11	11	<credit type="author copyright">
12	12	<name>Ryan Lortie</name>

58	58	<title>Sample profile</title>
59	59	<code its:translate="no">
60	60	user-db:user
61		system-db:<input>local</input>
62		system-db:<input>site</input>
	61	system-db:<var>local</var>
	62	system-db:<var>site</var>
63	63	</code>
64	64	</listing>
65	65	</example>

67	67	<!-- TODO: explain the profile syntax (maybe new page) -->
68	68	<!--TODO: explain local and site -->
69	69
	70	<p>Configuring a single user and multiple system databases allows for layering
	71	of preferences. Settings from the <code>user</code> database file take
	72	precedence over the settings in the <code>local</code> database file, and the
	73	<code>local</code> database file in turn takes precedence over the
	74	<code>site</code> database file.</p>
	75
	76	<p>However, the order of precedence for <link xref="dconf-lockdown">locks</link>
	77	is reversed. Locks introduced in the <code>site</code> or <code>local</code>
	78	database files take priority over those present in <code>user</code>.</p>
	79
70	80	<note style="important">
71	81	<p>The <sys>dconf</sys> profile for a session is determined at login, so users
72	82	will have to log out and log in to apply a new <sys>dconf</sys> user profile
73	83	to their session.</p>
74	84	</note>
	85
	86	<p>For more information, see the <link its:translate="no" href="man:dconf(7)">
	87	<cmd>dconf</cmd>(7)</link> man page.</p>
75	88
76	89	<section id="dconf-profiles">
77	90

87	100	<sys>dconf</sys> attempts to open the profile named “user”. If that
88	101	fails, it will fall back to an internal hard-wired configuration.</p>
89	102
	103	<p>For more information, see the <link its:translate="no" href="man:dconf(7)">
	104	<cmd>dconf</cmd>(7)</link> man page.</p>
	105
90	106	</section>
91	107
92	108	</page>

+1

-0

system-admin-guide/C/desktop-background.page less more

4	4
5	5	<info>
6	6	<link type="guide" xref="appearance" />
	7	<link type="seealso" xref="backgrounds-extra" />
7	8	<revision pkgversion="3.11" date="2014-01-29" status="draft"/>
8	9	<revision pkgversion="3.14" date="2014-06-17" status="incomplete">
9	10	<desc>All prose and instructions are up to par. Extra info needs

+67

-58

system-admin-guide/C/desktop-favorite-applications.page less more

4	4
5	5	<info>
6	6	<link type="guide" xref="appearance"/>
7		<revision pkgversion="3.8" date="2013-04-28" status="draft"/>
	7	<revision pkgversion="3.30" date="2019-02-22" status="review"/>
8	8
9	9	<credit type="author">
10	10	<name>Aruna Sankaranarayanan</name>
11	11	<email>aruna.evam@gmail.com</email>
12	12	</credit>
	13	<credit type="editor">
	14	<name>Petr Kovar</name>
	15	<email>pknbe@volny.cz</email>
	16	<years>2019</years>
	17	</credit>
13	18
14	19	<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
15	20
16		<desc>Customize the default favourites in the Activities overview.</desc>
	21	<desc>Customize the default favorites in the Activities overview.</desc>
17	22
18	23	</info>
19	24
20		<title>Default favorite applications</title>
	25	<title>Set default favorite applications</title>
21	26
22		<p>Favorite applications are those visible on the
23		<link href="help:gnome-help/shell-terminology">dash</link>. You can use
24		<sys its:translate="no">dconf</sys> to set favorite applications
	27	<p>Favorite applications are those visible on the GNOME Shell
	28	<link href="help:gnome-help/shell-introduction#activities">dash</link>.
	29	You can use <sys its:translate="no">dconf</sys> to set favorite applications
25	30	for one user, or to set the same favorite applications
26	31	for all users. For both cases, you must first edit the
27	32	<sys its:translate="no">dconf</sys> profile found in

34	39	their user database file found in
35	40	<file its:translate="no">~/.config/dconf/user</file>. The following example
36	41	snippet uses <sys its:translate="no">dconf</sys> to set <app>gedit</app>,
37		<app>Terminal</app> and <app>Nautilus</app> as default favorites for a user.
38		The example code allows users to modify the list later, if they wish to do
39		so.</p>
40
41		<!--The code itself need not be translated but the comments withing the
42		code have to be translated.-Aruna-->
	42	<app>Terminal</app> and <app>Files</app> (<sys>nautilus</sys>) as default
	43	favorites for a user. The example code allows users to modify the list later,
	44	if they wish to do so.</p>
43	45
44	46	<listing>
45	47	<title>Contents of <file its:translate="no">/etc/dconf/profile</file>:</title>
46		<code>
47		#This line allows the user to change the default favorites later.
48		user-db:user
49		</code>
	48	<code its:translate="no">
	49	# <span its:translate="yes">This line allows the user to change the default favorites later</span>
	50	user-db:user
	51	</code>
50	52	</listing>
51	53
52	54	<listing>
53	55	<title>Contents of <file its:translate="no">~/.config/dconf/user</file>:</title>
54		<code>
55		#Set gedit, terminal and nautilus as default favorites
56		[org/gnome/shell]
57		favorite-apps = [<input>'gedit.desktop'</input>, <input>'gnome-terminal.desktop'</input>, <input>'nautilus.desktop'</input>]
58		</code>
	56	<code its:translate="no">
	57	# <span its:translate="yes">Set gedit, terminal and nautilus as default favorites</span>
	58	[org/gnome/shell]
	59	favorite-apps = [<var>'gedit.desktop'</var>, <var>'gnome-terminal.desktop'</var>, <var>'nautilus.desktop'</var>]
	60	</code>
59	61	</listing>
60	62
61	63	<note style="tip">

70	72
71	73	<p>In order to have the same favorites for all users, you must modify system
72	74	database files using <link xref="dconf-keyfiles">dconf keyfiles</link>. The
73		following code snippets edit the <sys its:translate="no">dconf</sys> profile
	75	following steps edit the <sys its:translate="no">dconf</sys> profile
74	76	and then create a keyfile to set default favorite applications for all
75		employees in the first floor of an organization.</p>
	77	users in the <code>local</code> configuration database.</p>
76	78
77		<!--The code itself need not be translated but the comments within the
78		code have to be translated.-Aruna-->
79
80		<listing>
81		<title>Contents of <file its:translate="no">/etc/dconf/profile</file>:</title>
82		<code>
83		user-db:user
84
85		#This line defines a system database file called first_floor
86		system-db:first_floor
87		</code>
88		</listing>
89
90		<note style="info">
91		<p>Settings from the <code>user</code> database file
92		will take precedence over the settings in the
93		<code>first_floor</code> database file, but
94		<link xref="dconf-lockdown">locks</link> introduced in the
95		<code>first_floor</code> database file will take priority over
96		those present in <code>user</code>.</p>
97		</note>
98
99		<listing>
100		<title>Contents of <file its:translate="no">/etc/dconf/db/first_floor.d/00_floor1_settings</file>:</title>
101		<code>
102		# Snippet sets gedit, terminal and nautilus as default favorites
103		# for all users in the first floor
104
105		[org/gnome/shell]
106		favorite-apps = [<input>'gedit.desktop'</input>, <input>'gnome-terminal.desktop'</input>, <input>'nautilus.desktop'</input>]
107		</code>
108		</listing>
109
110		<p>Incorporate your changes into the system databases by running
111		<cmd>dconf update</cmd>.</p>
	79	<steps>
	80	<title>Set the favorite applications</title>
	81	<include href="dconf-snippets.xml"
	82	xpointer="xpointer(//[@xml:id='dconf-profile-user'])"
	83	xmlns="http://www.w3.org/2001/XInclude"/>
	84	<include href="dconf-snippets.xml"
	85	xpointer="xpointer(//[@xml:id='dconf-profile-user-dir'])"
	86	xmlns="http://www.w3.org/2001/XInclude"/>
	87	<item>
	88	<p>Create the key file
	89	<file>/etc/dconf/db/local.d/00-favorite-apps</file> to provide
	90	information for the <sys>local</sys> database.</p>
	91	<listing>
	92	<title>Contents of
	93	<file its:translate="no">/etc/dconf/db/local.d/00-favorite-apps</file>:
	94	</title>
	95	<code>
	96	# Snippet sets gedit, terminal and nautilus as default favorites for all users
	97	[org/gnome/shell]
	98	favorite-apps = [<var>'gedit.desktop'</var>, <var>'gnome-terminal.desktop'</var>, <var>'nautilus.desktop'</var>]
	99	</code>
	100	</listing>
	101	</item>
	102	<item>
	103	<p>To prevent the user from overriding these settings, create the file
	104	<file>/etc/dconf/db/local.d/locks/favorite-apps</file> with the following
	105	content:</p>
	106	<listing>
	107	<title><file>/etc/dconf/db/local.db/locks/favorite-apps</file></title>
	108	<code>
	109	# Lock default favorite applications
	110	/org/gnome/shell/favorite-apps
	111	</code>
	112	</listing>
	113	</item>
	114	<include href="dconf-snippets.xml"
	115	xpointer="xpointer(//[@xml:id='dconf-update'])"
	116	xmlns="http://www.w3.org/2001/XInclude"/>
	117	<include href="dconf-snippets.xml"
	118	xpointer="xpointer(//[@xml:id='dconf-logoutin'])"
	119	xmlns="http://www.w3.org/2001/XInclude"/>
	120	</steps>
112	121
113	122	</section>
114	123

+3

-3

system-admin-guide/C/desktop-lockscreen.page less more

28	28	enter a password after being idle.</desc>
29	29	</info>
30	30
31		<title>Lock the screen when user is idle</title>
	31	<title>Lock the screen when the user is idle</title>
32	32
33		<p>You can make the screen lock automatically whenever a user
34		is idle for some amount of time. This is useful if your users
	33	<p>You can make the screen lock automatically whenever the user
	34	is idle for some amount of time. This is useful if users
35	35	may leave their computers unattended in public or unsecure
36	36	locations.</p>
37	37

+1

-0

system-admin-guide/C/index.page less more

9	9	<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
10	10
11	11	<desc>A guide for GNOME 3 system administrators</desc>
	12
12	13	</info>
13	14
14	15	<title>GNOME System Administration Guide</title>

+9

-9

system-admin-guide/C/keyboard-layout.page less more

85	85	<p>Add the layout codes to
86	86	<file>/usr/share/X11/xorg.conf.d/10-evdev.conf</file> in the following
87	87	way:</p>
88		<screen>
89		Section "InputClass"
90		Identifier "evdev keyboard catchall"
91		MatchIsKeyboard "on"
92		MatchDevicePath "/dev/input/event*"
93		Driver "evdev"
94		<input>Option "XkbLayout" "en,fr"</input>
95		EndSection
96		</screen>
	88	<screen>
	89	Section "InputClass"
	90	Identifier "evdev keyboard catchall"
	91	MatchIsKeyboard "on"
	92	MatchDevicePath "/dev/input/event*"
	93	Driver "evdev"
	94	<input>Option "XkbLayout" "en,fr"</input>
	95	EndSection
	96	</screen>
97	97	<p>Multiple layouts can be added as a comma separated list, as shown in
98	98	the example for English (<sys>en</sys>) and French (<sys>fr</sys>)
99	99	layouts.</p>

+4

-1

system-admin-guide/C/lockdown-single-app-mode.page less more

4	4
5	5	<info>
6	6	<link type="guide" xref="user-settings#lockdown"/>
	7	<link type="guide" xref="sundry#session"/>
7	8	<link type="seealso" xref="lockdown-printing" />
8	9	<link type="seealso" xref="lockdown-file-saving" />
9	10	<link type="seealso" xref="lockdown-repartitioning" />
10	11	<link type="seealso" xref="lockdown-command-line" />
11	12	<link type="seealso" xref="login-automatic" />
	13	<link type="seealso" xref="session-custom" />
	14	<link type="seealso" xref="session-user" />
12	15
13	16	<revision pkgversion="3.30" date="2019-02-08" status="review"/>
14	17

32	35
33	36	<desc>Set up a kiosk-like, single-application system.</desc>
34	37	</info>
35
	38
36	39	<title>Configure single-application mode</title>
37	40
38	41	<p>Single-application mode is a modified GNOME Shell which configures the

+1

-0

system-admin-guide/C/login-logo.page less more

4	4
5	5	<info>
6	6	<link type="guide" xref="login#appearance"/>
	7	<link type="seealso" xref="login-banner"/>
7	8	<!--<link type="seealso" xref="gdm-restart"/>-->
8	9	<revision pkgversion="3.11" date="2014-01-29" status="draft"/>
9	10

+1

-1

system-admin-guide/C/login.page less more

8	8	<desc>
9	9	<link xref="login-userlist-disable">Disable the user list</link>,
10	10	<link xref="session-user">configure a user default session</link>,
11		<link xref="login-automatic">configure automatic login</link>…
	11	<link xref="login-automatic">automatic login</link>…
12	12	</desc>
13	13
14	14	</info>

+4

-1

system-admin-guide/C/mime-types-application-user.page less more

7	7	<link type="seealso" xref="mime-types-custom" />
8	8	<revision pkgversion="3.30" date="2019-02-08" status="review"/>
9	9
10		<credit type="author">
	10	<credit type="author copyright">
11	11	<name>Petr Kovar</name>
12	12	<email>pknbe@volny.cz</email>
	13	<years>2014</years>
13	14	</credit>
14	15
15	16	<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
16	17
	18	<desc>Customize per user which application opens a specific MIME type.
	19	</desc>
17	20	</info>
18	21
19	22	<title>Override the default registered application for individual users</title>

+3

-1

system-admin-guide/C/mime-types-application.page less more

8	8	<link type="seealso" xref="mime-types-custom" />
9	9	<revision pkgversion="3.30" date="2019-02-08" status="review"/>
10	10
11		<credit type="author">
	11	<credit type="author copyright">
12	12	<name>Petr Kovar</name>
13	13	<email>pknbe@volny.cz</email>
	14	<years>2014</years>
14	15	</credit>
15	16
16	17	<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
17	18
	19	<desc>Customize which application opens a specific MIME type.</desc>
18	20	</info>
19	21
20	22	<title>Override the default registered application for all users</title>

+4

-1

system-admin-guide/C/mime-types-custom-user.page less more

6	6	<link type="seealso" xref="mime-types" />
7	7	<revision pkgversion="3.12" date="2014-06-17" status="review"/>
8	8
9		<credit type="author">
	9	<credit type="author copyright">
10	10	<name>Petr Kovar</name>
11	11	<email>pknbe@volny.cz</email>
	12	<years>2014</years>
12	13	</credit>
13	14
14	15	<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
15	16
	17	<desc>Create a user's MIME type specification and register a default
	18	application.</desc>
16	19	</info>
17	20
18	21	<title>Add a custom MIME type for individual users</title>

+4

-1

system-admin-guide/C/mime-types-custom.page less more

7	7	<link type="seealso" xref="mime-types-custom-user" />
8	8	<revision pkgversion="3.12" date="2014-06-17" status="review"/>
9	9
10		<credit type="author">
	10	<credit type="author copyright">
11	11	<name>Petr Kovar</name>
12	12	<email>pknbe@volny.cz</email>
	13	<years>2014</years>
13	14	</credit>
14	15
15	16	<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
16	17
	18	<desc>Create a MIME type specification and register a default
	19	application.</desc>
17	20	</info>
18	21
19	22	<title>Add a custom MIME type for all users</title>

+2

-1

system-admin-guide/C/mime-types.page less more

8	8	<link type="seealso" xref="mime-types-custom-user" />
9	9	<revision pkgversion="3.12" date="2014-06-17" status="review"/>
10	10
11		<credit type="author">
	11	<credit type="author copyright">
12	12	<name>Petr Kovar</name>
13	13	<email>pknbe@volny.cz</email>
	14	<years>2014</years>
14	15	</credit>
15	16
16	17	<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>

+13

-13

system-admin-guide/C/network-printer-config.page less more

3	3	id="network-printer-config">
4	4
5	5	<info>
6		<link type="guide" xref="network" />
7		<revision pkgversion="3.8" date="2013-03-19" status="draft"/>
	6	<link type="guide" xref="network" />
	7	<revision pkgversion="3.30" date="2019-02-22" status="review"/>
8	8
9	9	<credit type="author copyright">
10	10	<name>Jana Svarova</name>
11	11	<email>jana.svarova@gmail.com</email>
12	12	<years>2013</years>
13	13	</credit>
	14	<credit type="editor">
	15	<name>Petr Kovar</name>
	16	<email>pknbe@volny.cz</email>
	17	<years>2019</years>
	18	</credit>
14	19
15	20	<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
16	21
17		<desc>How do I preconfigure my Samba printer</desc>
	22	<desc>How do I configure a Samba printer?</desc>
18	23	</info>
19	24
20		<title>Configure a printer</title>
	25	<title>Configure a network printer</title>
21	26
22		<comment>
23		<cite date="2013-03-19" href="mailto:jsvarova@gmail.com">Jana Svarova</cite>
24		<p>Adapted from GNOME Bugzilla – Bug 694569</p>
25		</comment>
26
27		<p>This topic explains how to make printers, Windows printers in particular,
28		available in GNOME.</p>
	27	<p>This topic explains how to make network printers, Windows printers in
	28	particular, available in GNOME.</p>
29	29
30	30	<p>There is no preconfiguration needed for being able to install Samba
31		printers using gnome-control-center. To add a new Samba printer to your CUPS
32		(Common UNIX Printing System) server, simply follow the steps below.</p>
	31	printers using <app>GNOME Settings</app>. To add a new Samba printer to your
	32	CUPS (Common UNIX Printing System) server, simply follow the steps below.</p>
33	33
34	34	<steps>
35	35	<title>Configure your printer</title>

+3

-2

system-admin-guide/C/network.page less more

8	8
9	9	<desc>
10	10	<link xref="network-server-list">Configure a default server list</link>,
11		<link xref="network-printer-config">configure a printer</link>,
	11	<link xref="network-printer-config">a network printer</link>,
12	12	<link xref="network-vpn">default VPN settings</link>…
13	13	</desc>
14	14
15	15	</info>
16	16
17		<title>Network & Hardware</title>
	17	<title>Network & hardware</title>
	18
18	19	</page>

+1

-0

system-admin-guide/C/processes.page less more

5	5
6	6	<info>
7	7	<link type="guide" xref="software#management" />
	8	<link type="guide" xref="sundry#session"/>
8	9	<revision pkgversion="3.12" date="2014-06-17" status="review"/>
9	10
10	11	<credit type="author copyright">

+4

-0

system-admin-guide/C/setup.page less more

2	2	id="setup">
3	3
4	4	<info>
	5
5	6	<link type="guide" xref="index" group="#first"/>
6	7
7	8	<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
	9
	10	<desc>User and system settings management</desc>
	11
8	12	</info>
9	13
10	14	<title>Setup</title>

+3

-4

system-admin-guide/C/software.page less more

7	7	<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
8	8
9	9	<desc>
10		<link xref="extensions">What are GNOME Shell extensions?</link>,
11		<link xref="mime-types">what are MIME types?</link>,
12		<link xref="mime-types-application">override the default registered
13		application for all users</link>…
	10	<link xref="extensions">GNOME Shell extensions</link>,
	11	<link xref="mime-types">MIME types</link>,
	12	<link xref="mime-types-application">override default applications</link>…
14	13	</desc>
15	14
16	15	</info>

+4

-0

system-admin-guide/C/sundry.page less more

2	2	id="sundry">
3	3
4	4	<info>
	5
5	6	<link type="guide" xref="index" group="#last"/>
6	7
7	8	<include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
	9
	10	<desc>Session management and troubleshooting</desc>
	11
8	12	</info>
9	13
10	14	<title>Other</title>

+1

-1

system-admin-guide/C/user-settings.page less more

15	15
16	16	</info>
17	17
18		<title>User Settings</title>
	18	<title>User settings</title>
19	19
20	20	<!--<section id="default">
21	21	<title>Pre-seed user defaults</title>