View | Details | Raw Unified | Return to bug 201870
Collapse All | Expand All

(-)htdocs/Makefile (+1 lines)
Lines 71-76 Link Here
71
SUBDIR+= security
71
SUBDIR+= security
72
SUBDIR+= snapshots
72
SUBDIR+= snapshots
73
SUBDIR+= support
73
SUBDIR+= support
74
SUBDIR+= xfce
74
.if !defined(WEB_ONLY) || empty(WEB_ONLY)
75
.if !defined(WEB_ONLY) || empty(WEB_ONLY)
75
SUBDIR+= doc
76
SUBDIR+= doc
76
SUBDIR+= ports
77
SUBDIR+= ports
(-)htdocs/projects/projects.xml (+4 lines)
Lines 99-104 Link Here
99
OpenOffice.org on FreeBSD</a>:
99
OpenOffice.org on FreeBSD</a>:
100
Information about the various OpenOffice.org ports.</li>
100
Information about the various OpenOffice.org ports.</li>
101
101
102
<li><a name="xfce" href="../xfce/index.html">Xfce on &os;</a>:
103
This contains information on how to install, run it and FAQ covering
104
&os;-specific Xfce issues.</li>
105
102
<li><a href="../ports/index.html">FreeBSD Ports Collection</a>:
106
<li><a href="../ports/index.html">FreeBSD Ports Collection</a>:
103
The FreeBSD Ports Collection provides an easy way to compile and
107
The FreeBSD Ports Collection provides an easy way to compile and
104
install a wide range of applications with a minimum amount of effort.
108
install a wide range of applications with a minimum amount of effort.
(-)htdocs/xfce/Makefile (+12 lines)
Line 0 Link Here
1
# $FreeBSD$
2
3
.if exists(../Makefile.conf)
4
.include "../Makefile.conf"
5
.endif
6
.if exists(../Makefile.inc)
7
.include "../Makefile.inc"
8
.endif
9
10
DOCS+=  index.xml
11
12
.include "${DOC_PREFIX}/share/mk/web.site.mk"
(-)htdocs/xfce/Makefile.inc (+4 lines)
Line 0 Link Here
1
# $FreeBSD$
2
3
WEBBASE?=	/data/xfce
4
DOC_PREFIX?=	${.CURDIR}/../../../..
(-)htdocs/xfce/dot.xinitrc.diff (+38 lines)
Line 0 Link Here
1
--- .xinitrc.orig
2
+++ .xinitrc
3
@@ -87,6 +87,17 @@
4
 # load local modmap
5
 test -r $HOME/.Xmodmap && xmodmap $HOME/.Xmodmap
6
 
7
+# Use dbus-launch if installed.
8
+if test x"$DBUS_SESSION_BUS_ADDRESS" = x""; then
9
+  if which dbus-launch >/dev/null 2>&1; then
10
+    eval `dbus-launch --sh-syntax --exit-with-session`
11
+    # some older versions of dbus don't export the var properly
12
+    export DBUS_SESSION_BUS_ADDRESS
13
+  else
14
+    echo "Could not find dbus-launch; Xfce will not work properly" >&2
15
+    fi
16
+fi
17
+
18
 # run xfce4-session if installed
19
 if which xfce4-session >/dev/null 2>&1; then
20
 
21
@@ -124,17 +135,6 @@
22
 
23
 ##################
24
 
25
-# Use dbus-launch if installed.
26
-if test x"$DBUS_SESSION_BUS_ADDRESS" = x""; then
27
-  if which dbus-launch >/dev/null 2>&1; then
28
-    eval `dbus-launch --sh-syntax --exit-with-session`
29
-    # some older versions of dbus don't export the var properly
30
-    export DBUS_SESSION_BUS_ADDRESS
31
-  else
32
-    echo "Could not find dbus-launch; Xfce will not work properly" >&2
33
-    fi
34
-fi
35
-
36
 # this is only necessary when running w/o xfce4-session
37
 xsetroot -solid black -cursor_name watch
38
 
(-)htdocs/xfce/index.xml (+365 lines)
Line 0 Link Here
1
<?xml version="1.0" encoding="iso-8859-1"?>
2
<!DOCTYPE html PUBLIC "-//FreeBSD//DTD XHTML 1.0 Transitional-Based Extension//EN"
3
"http://www.FreeBSD.org/XML/share/xml/xhtml10-freebsd.dtd" [
4
<!-- taken from share/xml/urls.ent, but &url.base is defined here -->
5
<!ENTITY url.books.handbook "..&url.doc.base;/books/handbook">
6
<!ENTITY a.mailman.listinfo
7
"http://lists.FreeBSD.org/mailman/listinfo">
8
<!ENTITY a.xfce.url "&a.mailman.listinfo;/freebsd-xfce">
9
<!ENTITY forums.wm "forums/other-window-managers.31/">
10
<!ENTITY forums.url "https://forums.freebsd.org/&forums.wm;">
11
<!ENTITY title "The &os; Xfce Project">
12
<!ENTITY xfce.url "http://www.xfce.org/">
13
<!ENTITY gnome.developer "https://developer.gnome.org/">
14
<!ENTITY clutter.desaturate.effect "&gnome.developer;clutter/stable/ClutterDesaturateEffect.html">
15
]>
16
17
<html xmlns="http://www.w3.org/1999/xhtml">
18
  <head>
19
    <title>&title;</title>
20
21
    <cvs:keyword xmlns:cvs="http://www.FreeBSD.org/XML/CVS">
22
			$FreeBSD$
23
		</cvs:keyword>
24
  </head>
25
26
  <body class="navinclude.developers">
27
    <p><a href="&xfce.url;">Xfce</a> is a complete graphical desktop
28
      environment based ont the GTK+ toolkit.  It aims to be fast,
29
      lightweight and easy-to-use.</p>
30
31
    <p>Any questions regarding Xfce on &os; should be address to
32
      the <a href="&a.xfce.url;">freebsd-xfce</a> mailing list, or
33
      <a href="&forums.url;">&os; forums</a>
34
      (<em>Other Window Manager</em> subforum).</p>
35
36
    <h2>Resources</h2>
37
    <ul>
38
      <li><a href="http://www.xfce.org/">Xfce project</a></li>
39
      <li><a href="../ports/xfce.html">Available ports...</a></li>
40
      <li><a href="https://wiki.freebsd.org/Xfce">The &os; Xfce
41
      wiki page</a></li>
42
    </ul>
43
44
    <h2>Frequently Asked Questions</h2>
45
    <h3>Contents</h3>
46
    <ol>
47
      <li><a href="#q01">How is Xfce installed?</a></li>
48
      <li><a href="#q02">How is Xfce started?</a></li>
49
      <li><a href="#q03">What about localization?</a></li>
50
      <li><a href="#q04">How can unified themes be used with
51
				GTK3 and GTK2?</a></li>
52
      <li><a href="#q05">How can keyboard shortcuts be changed
53
				in GTK2 applications?</a></li>
54
      <li><a href="#q06">How can menu items be hidden?</a></li>
55
      <li><a href="#q07">How can the panel be hidden with
56
				fullscreen applications?</a></li>
57
      <li><a href="#q08">How can double title bars be removed in
58
				some applications?</a></li>
59
      <li><a href="#q09">How can shadows be removed in additional
60
				panels</a></li>
61
      <li><a href="#q10">How is windows preview displayed in
62
				TabWin widget?</a></li>
63
      <li><a href="#q11">How are elements displayed in TabWin
64
				widget?</a></li>
65
      <li><a href="#q12">How is zoom effect enabled?</a></li>
66
      <li><a href="#q13">How can we adopt the same behavior as
67
				Thunar in GtkFileChooserDialog widget?</a></li>
68
      <li><a href="#q14">How can xfdashboard be lauched at
69
				startup?</a></li>
70
      <li><a href="#q15">How can grayscale colors of quicklaunch
71
				icons be changed in xfdashboard?</a></li>
72
      <li><a href="#q16">How can PulseAudio be disabled?</a></li>
73
    </ol>
74
75
    <h3>Full text</h3>
76
		<ol>
77
			<li>
78
				<a name="q01"></a>
79
				<h4>How is Xfce installed?</h4>
80
81
				<p>There are two ways to install Xfce.  Using pkg(8):</p>
82
				<pre># pkg install xfce</pre>
83
84
				<p>More information is available in the <a
85
				  href="&url.books.handbook;/pkgng-intro.html">&os;
86
				  Handbook</a>.</p>
87
88
				<p>The other way is to use <a
89
				  href="&url.books.handbook;/ports-using.html">ports</a>:</p>
90
				<pre># cd /usr/ports/x11-wm/xfce4
91
# make clean-depends</pre>
92
			</li>
93
94
			<li>
95
				<a name="q02"></a>
96
				<h4>How is Xfce started?</h4>
97
98
				<p>There are several different ways to start Xfce:</p>
99
				<ul>
100
					<li>Using <tt>startx</tt> from a text console.</li>
101
					<li>Using display manager (e.g., SLiM, Xdm, ...)</li>
102
				</ul>
103
				<p>Firstly, <tt>.xinitrc</tt> file must be created.</p>
104
105
				<p><strong>Note:</strong> <tt>x11-wm/xfce4-session</tt>
106
					provides this file.</p>
107
				<pre>% cp /usr/local/etc/xdg/xfce4/xinitrc ~/.xinitrc</pre>
108
109
				<p>Using <tt>startx</tt> or Xdm, <tt>.xsession</tt> file is
110
					also required.</p>
111
				<pre>% ln -sf ~/.xinitrc ~/.xsession</pre>
112
113
				<p>To use Xdm, apply the following <a
114
					href="dot.xinitrc.diff">patch</a>.  It fixes a well-known bug <a
115
					href="https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=191296">
116
					PR191296</a>.</p>
117
				<pre>% patch --posix &lt; dot.xinitrc.diff</pre>
118
			</li>
119
120
			<li>
121
				<a name="q03"></a>
122
				<h4>What about localization?</h4>
123
124
				<p>Xfce supports different languages (internationalization).
125
					Even if the system has already been <a
126
					href="&url.books.handbook;/l10n.html">configured for
127
					localization</a>, additional settings must be added to
128
					<tt>.xinitrc</tt>.</p>
129
130
				<p>The variables, <tt>LANG</tt> and <tt>LC_CTYPE</tt> control
131
					locale settings.</p>
132
133
				<p>For instance, for French users using latin-9 encoding, these
134
					environments variables will be defined like:</p>
135
				<pre>#!/bin/sh
136
137
export LANG="fr_FR.ISO8859-15"
138
export LC_CTYPE="fr_FR.ISO8859-15"
139
[...]</pre>
140
141
				<p>Users with no UTF-8 encoding must also define new variable
142
					<tt>G_FILENAME_ENCODING</tt> (avoid warning in some GTK
143
					applications).</p>
144
145
				<p>Add following lines in <tt>.xinitrc</tt>.</p>
146
				<pre>[...]
147
# set $G_FILENAME_ENCODING to @locale and/or UTF-8.
148
if test "x$G_FILENAME_ENCODING" = "x"; then
149
  G_FILENAME_ENCODING="@locale,UTF-8"
150
  export G_FILENAME_ENCODING
151
fi
152
[...]</pre>
153
			</li>
154
155
			<li>
156
				<a name="q04"></a>
157
				<h4>How can unified themes be used with GTK3 and GTK2?</h4>
158
159
				<p>Install <tt>x11-themes/gnome-themes-standard</tt>, and change
160
					the value of <tt>/Net/ThemeName</tt> property:</p>
161
				<pre>% xfconf-query -c xsettings -p /Net/ThemeName -t string -s Adwaita</pre>
162
163
				<p>Or use <tt>xfce4-appearance-settings</tt>.</p>
164
			</li>
165
166
			<li>
167
				<a name="q05"></a>
168
				<h4>How can keyboard shortcuts be changed in GTK2
169
					applications?</h4>
170
171
				<p><tt>/Gtk/CanChangeAccels</tt> must be enabled.</p>
172
173
				<p>To check its value:</p>
174
				<pre>% xfconf-query -c xsettings -p /Gtk/CanChangeAccels</pre>
175
176
				<p>If it is <strong>false</strong>, the value must be
177
					changed.</p>
178
				<pre>% xfconf-query -c xsettings -p /Gtk/CanChangeAccels -T</pre>
179
180
				<p>When the item menu is active (hightlighted), keyboard
181
					shortcut can be directly changed by pressing the desired key
182
					combination.</p>
183
184
				<p><strong>Note:</strong> This settings is deprecated since
185
					GTK >= 3.10.</p>
186
			</li>
187
188
			<li>
189
				<a name="q06"></a>
190
				<h4>How can menu items be hidden?</h4>
191
192
				<p>Launch <tt>xfce4-appfinder</tt> and right-click on one
193
					item in the right pane, then select
194
					<strong>Hidden</strong>.</p>
195
			</li>
196
197
			<li>
198
				<a name="q07"></a>
199
				<h4>How can the panel be hidden with fullscreen
200
					applications?</h4>
201
202
				<p>Sometimes when applications are in full-screen mode, panels
203
					are not hidden.  The value of <tt>autohide-behavior</tt> can
204
					be changed.</p>
205
206
				<p>Possible values are:</p>
207
				<ul>
208
					<li>0 &rarr; never hide</li>
209
					<li>1 &rarr; intelligently autohide</li>
210
					<li>2 &rarr; autohide</li>
211
				</ul>
212
213
				<p>For example:</p>
214
				<pre>% xfconf-query -c xfce4-panel -p /panels/panels-<em>id</em>/autohide-behavior -n -t int -s 1</pre>
215
216
				<p>Where <em>id</em> is integer, it represents panel number.</p>
217
218
				<p>Or go to <strong>Panel Preferences</strong>.</p>
219
			</li>
220
221
			<li>
222
				<a name="q08"></a>
223
				<h4>How can double title bars be removed in some
224
					applications?</h4>
225
226
				<p>They appear often with GTK3 applications, because they use
227
					a new method for decorating windows, calls
228
					<acronym title="Client-Side Decorations">CSD</acronym>.</p>
229
230
				<p>To avoid this artifact, compositing must be enabled.</p>
231
232
				<p>Launch <tt>xfwm4-teaks-settings</tt>, and go to the
233
					<strong>Compositor</strong> tab.</p>
234
235
				<p>Or change the value of
236
					<tt>/general/use_compositing</tt>:</p>
237
				<pre>% xfconf-query -c xfwm4 -p /general/use_compositing -n -t bool -s true</pre>
238
			</li>
239
240
			<li>
241
				<a name="q09"></a>
242
				<h4>How can shadows be removed in additional panels?</h4>
243
244
				<p>With some additional panels like <tt>deskutils/cairo-dock</tt>,
245
					<tt>x11/tint</tt>, or <tt>x11/plank</tt> shadows appear.</p>
246
247
				<p>Launch <tt>xfwm4-tweaks-settings</tt> and go to
248
					<strong>Compositor</strong> tab, uncheck <strong>Show shadows
249
					under dock windows</strong> option.</p>
250
251
				<p>Or</p>
252
				<pre>% xfconf-query -c xfwm4 -p /general/show_dock_shadow -n -t bool -s false</pre>
253
			</li>
254
255
			<li>
256
				<a name="q10"></a>
257
				<h4>How is windows preview displayed in TabWin widget?</h4>
258
259
				<p>TabWin widget is little window which appears, when we
260
					toggle between open applications (Alt+Tab).</p>
261
262
				<p>The value of <tt>/general/cycle_preview</tt> can be
263
					changed, if compositing is enabled.</p>
264
				<pre>% xfconf-query -c xfwm4 -p /general/cycle_preview -T</pre>
265
266
				<p><strong>Note:</strong> If the value of
267
					<tt>/general/cycle_tabwin_mode</tt> is <strong>1</strong>
268
					previews are not displayed.</p>
269
			</li>
270
271
			<li>
272
				<a name="q11"></a>
273
				<h4>How are elements displayed in TabWin widget?</h4>
274
275
				<p>By default in TabWin widget, open applications are
276
					symbolized by previews list.</p>
277
278
				<p>Another view is also possible (like in Xfce &lt;= 4.10).</p>
279
				<pre>% xfconf-query -c xfwm4 -p /general/cycle_tabwin_mode -n -t int -s 1</pre>
280
281
				<p>Possible values are:</p>
282
				<ul>
283
					<li>0 &rarr; previews list</li>
284
					<li>1 &rarr; grid (icons)</li>
285
				</ul>
286
			</li>
287
288
			<li>
289
				<a name="q12"></a>
290
				<h4>How is zoom effect enabled?</h4>
291
292
				<p>If compositing is enabled and the value of
293
					<tt>/general/zoom_desktop</tt> is <strong>true</strong>.
294
					Zoom effect is active.</p>
295
				<pre>% xfconf-query -c xfwm4 -p /general/zoom_desktop</pre>
296
297
				<p>Alt+Scroll-wheel to zoom in/out anywhere inside desktop.</p>
298
			</li>
299
300
			<li>
301
				<a name="q13"></a>
302
				<h4>How can we adopt the same behavior as Thunar in
303
					GtkFileChooserDialog widget?</h4>
304
305
				<p>By default, Thunar displays directories first, then
306
					files.  This behaviour is managed by
307
					<tt>/misc-folders-first</tt> property.</p>
308
309
				<p>To adopt the same behavior when GTK3 applications use
310
					GtkFileChooserDialog widget, the value of
311
					<tt>sort-directories-first</tt> must be changed.</p>
312
				<pre>% gsettings set org.gtk.Settings.FileChooser sort.directories-first true</pre>
313
			</li>
314
315
			<li>
316
				<a name="q14"></a>
317
				<h4>How can xfdashboard be launched at startup?</h4>
318
319
				<p>Launch <tt>xfce4-session-settings</tt>, and go to
320
					<strong>Application Autostart</strong> tab.  Select
321
					<tt>xfdashboard</tt>.</p>
322
323
				<p>To define keyboard shortcuts, launch
324
					<tt>xfce4-keyboard-settings</tt>, and go to
325
					<strong>Application Shortcuts</strong> tab.</p>
326
			</li>
327
328
			<li>
329
				<a name="q15"></a>
330
				<h4>How can grayscale colors of quicklaunch icons be changed
331
					in xfdashboard?</h4>
332
333
				<p>Since 0.3.2 release, a new feature was introduced, based on <a
334
					href="&clutter.desaturate.effect;">ClutterDesaturateEffect</a>.</p>
335
336
				<p>Launch <tt>xfdashboard-settings</tt> and go to
337
					<strong>Themes</strong> tab.  Select one among list.</p>
338
339
				<p>To display current theme:</p>
340
				<pre>% xfconf-query -c xfdashboard -p /theme</pre>
341
342
				<p>For example, if it is <tt>xfdashboard-blue</tt>.  Copy
343
					its content into <tt>~/.themes/xfdashboard-blue/</tt>.</p>
344
				<pre>% cp -R /usr/local/share/themes/xfdashboard-blue/* ~/.themes/xfdashboard-blue/</pre>
345
				
346
				<p>Edit <tt>effects.xml</tt>, and change the value
347
					(between 0.0 and 1.0) of factor property.</p>
348
			</li>
349
350
			<li>
351
				<a name="q16"></a>
352
				<h4>How can PulseAudio be disabled?</h4>
353
354
				<p>In <tt>~/.config/pulse/client.conf</tt> replace these
355
					lines:</p>
356
				<pre>; autospawn = yes
357
; daemon-binary = /usr/local/bin/pulseaudio</pre>
358
359
				<p>by</p>
360
				<pre>autospawn = no
361
daemon-binary =</pre>
362
			</li>
363
		</ol>
364
  </body>
365
</html>

Return to bug 201870