source: x/wm/openbox.xml@ b0ae5b7

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since b0ae5b7 was b0ae5b7, checked in by Ken Moffat <ken@…>, 12 years ago

pkgconfig -> glib2 : fix the early changes since LFS-7.0, i.e. gdk-pixbuf, atk, cairo, polkit : openbox now gets glib2 via cairo.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@10282 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 13.5 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY openbox-download-http
8 "http://openbox.org/dist/openbox/openbox-&openbox-version;.tar.gz">
9 <!ENTITY openbox-download-ftp " ">
10 <!ENTITY openbox-md5sum "00441b53cf14c03566c8e82643544ff9">
11 <!ENTITY openbox-size "9 MB">
12 <!ENTITY openbox-buildsize "18 MB">
13 <!ENTITY openbox-time "0.3 SBU">
14]>
15
16<sect1 id="openbox" xreflabel="openbox-&openbox-version;">
17 <?dbhtml filename="openbox.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>openbox-&openbox-version;</title>
25
26 <indexterm zone="openbox">
27 <primary sortas="a-openbox">Openbox</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to openbox</title>
32
33 <para>
34 <application>Openbox</application> is a highly configurable desktop
35 window manager with extensive standards support. It allows you to control
36 almost every aspect of how you interact with your desktop.
37 </para>
38
39 &lfs71_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
44 <para>
45 Download (HTTP): <ulink url="&openbox-download-http;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>Download MD5 sum: &openbox-md5sum;
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download size: &openbox-size;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Estimated disk space required: &openbox-buildsize;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated build time: &openbox-time;
65 </para>
66 </listitem>
67 </itemizedlist>
68
69 <bridgehead renderas="sect3">Openbox Dependencies</bridgehead>
70
71 <bridgehead renderas="sect4">Required</bridgehead>
72 <para role="required">
73 <xref linkend="x-window-system"/> and
74 <xref linkend="pango"/> (compiled with support for libXft).
75 </para>
76
77 <bridgehead renderas="sect4">Optional</bridgehead>
78 <para role="optional">
79 <xref linkend="imlib2"/> (to enable icons in the right click menu).
80 </para>
81
82 <para condition="html" role="usernotes">
83 User Notes: <ulink url="&blfs-wiki;/openbox"/>
84 </para>
85 </sect2>
86
87 <sect2 role="installation">
88 <title>Installation of Openbox</title>
89
90 <para>
91 Install <application>Openbox</application> by running the following
92 commands:
93 </para>
94
95<screen><userinput>./configure -&#45;prefix=/usr -&#45;sysconfdir=/etc -&#45;disable-static \
96 -&#45;docdir=/usr/share/doc/openbox-&openbox-version; &amp;&amp;
97make</userinput></screen>
98
99 <para>
100 To test the results, issue: <command>make check</command>.
101 </para>
102
103 <para>
104 Now, as the <systemitem class="username">root</systemitem> user:
105 </para>
106
107<screen role="root"><userinput>make install</userinput></screen>
108 </sect2>
109
110 <sect2 role="commands">
111 <title>Command Explanations</title>
112
113 <para>
114 <option>-&#45;sysconfdir=/etc</option>: This option puts
115 <application>Openbox</application>'s configuration files in
116 /etc/xdg/openbox instead of /usr/etc/xdg/openbox.
117 </para>
118
119 <para>
120 <option>-&#45;disable-static</option>: This option stops it compiling
121 static versions of the libraries.
122 </para>
123
124 <para>
125 <option>-&#45;docdir=/usr/share/doc/openbox-&openbox-version;</option>:
126 this puts a few files in a versioned directory in
127 <filename class="directory">/usr/share/doc</filename>.
128 </para>
129 </sect2>
130
131 <sect2 role="configuration">
132 <title>Configuring Openbox</title>
133
134 <sect3 id="openbox-config">
135 <title>Config Files</title>
136
137 <para>
138 /etc/xdg/openbox/menu.xml, /etc/xdg/openbox/rc.xml,
139 ~/.config/openbox/menu.xml and ~/.config/openbox/rc.xml
140 </para>
141
142 <indexterm zone="openbox openbox-config">
143 <primary sortas="e-AA.menu">~/.config/openbox/menu.xml</primary>
144 </indexterm>
145
146 <indexterm zone="openbox openbox-config">
147 <primary sortas="e-AA.rc">~/.config/openbox/rc.xml</primary>
148 </indexterm>
149
150 <indexterm zone="openbox openbox-config">
151 <primary sortas="e-etc-path-menu">/etc/xdg/openbox/menu.xml</primary>
152 </indexterm>
153
154 <indexterm zone="openbox openbox-config">
155 <primary sortas="e-etc-path-rc">/etc/xdg/openbox/rc.xml</primary>
156 </indexterm>
157 </sect3>
158
159 <sect3><title>Configuration Information</title>
160
161 <para>
162 <application>Openbox</application>'s right click menu can be used to
163 launch programs. The menu itself is configured with 2 files,
164 <filename>/etc/xdg/openbox/menu.xml</filename> and
165 <filename>~/.config/openbox/menu.xml</filename>. To make changes to the
166 menu, copy /etc/xdg/openbox/menu.xml to ~/.config/openbox/menu.xml and
167 edit it:
168 </para>
169
170<screen role="user"><userinput>cp -rf /etc/xdg/openbox ~/.config</userinput></screen>
171 <para>
172
173 <filename>~/.config/openbox/menu.xml</filename> can be edited with a
174 text editor or you can install
175 <ulink url="http://obmenu.sourceforge.net/">Obmenu</ulink> (requires
176 <xref linkend="pyxml"/> and <xref linkend="pygtk"/>).
177 </para>
178
179 <para>
180 To have icons in your right click menu requires installing
181 <xref linkend="imlib2"/> before you install
182 <application>Openbox</application>. To set an icon for an entry in the
183 menu edit <filename>~/.config/openbox/menu.xml</filename> and add an
184 icon to the &lt;item&gt; tag like this:
185 </para>
186
187<screen>&lt;item label="Mplayer" icon="/usr/share/pixmaps/mplayer.png"&gt;</screen>
188
189 <para>
190 Many other aspects of <application>Openbox</application>'s behaviour are
191 configured with <filename>~/.config/openbox/rc.xml</filename> such as
192 what keybindings are used to launch programs or which mouse button
193 launches the main menu.
194 </para>
195
196 <para>
197 Details of the theme that <application>Openbox</application> applies to
198 window decorations are configured in
199 <filename>~/.config/openbox/rc.xml</filename>. You can get a list of the
200 available themes with the command:
201 </para>
202
203<screen role="user"><userinput>ls -d /usr/share/themes/*/openbox-3 | sed 's#.*es/##;s#/o.*##'</userinput></screen>
204 </sect3>
205
206 <sect3 id="openbox-init">
207 <title>Starting Openbox</title>
208
209 <para>
210 To automatically start <command>openbox</command> when you start
211 <application>Xorg</application>:
212 </para>
213
214<screen role="user"><userinput>echo openbox &gt; ~/.xinitrc</userinput></screen>
215
216 <para>
217 If you want to set a background image to your desktop you can use
218 <xref linkend="display"/> and launch it from ~/.xinitrc just before
219 openbox:
220 </para>
221
222<screen role="user"><userinput>cat &gt; ~/.xinitrc &lt;&lt; "HERE_DOC"
223display -backdrop -window root /path/to/beautiful/picture.jpeg
224exec openbox
225HERE_DOC</userinput></screen>
226
227 <para>
228 Or if you like a bit of variety, put a selection of images in a folder
229 (in this example, the directory ~/.config/backgrounds) and choose one at
230 random each time you <command>xinit</command>:
231 </para>
232
233<screen role="user"><userinput>cat &gt; ~/.xinitrc &lt;&lt; "HERE_DOC"
234# make an array which lists the pictures:
235picture_list=(~/.config/backgrounds/*)
236# create a random integer between 0 and the number of pictures:
237random_number=$(( ${RANDOM} % ${#picture_list[@]} ))
238# display the chosen picture:
239display -backdrop -window root "${picture_list[${random_number}]}"
240exec openbox
241HERE_DOC</userinput></screen>
242
243 <para>
244 If you like to have the numlock key set whan you start Xorg, install
245 <ulink url="http://home.kde.org/~seli/numlockx/">Numlockx</ulink> and
246 add that to your xinitrc. Another useful application is
247 <xref linkend="dbus"/>
248 </para>
249
250<screen role="user"><userinput>cat &gt; ~/.xinitrc &lt;&lt; "HERE_DOC"
251. /etc/profile
252picture_list=(~/.config/backgrounds/*)
253random_number=$(( ${RANDOM} % ${#picture_list[*]} ))
254display -backdrop -window root "${picture_list[${random_number}]}"
255numlockx
256eval $(dbus-launch --auto-syntax --exit-with-session)
257lxpanel &amp;
258exec openbox
259HERE_DOC</userinput></screen>
260 </sect3>
261 </sect2>
262
263 <sect2 role="content">
264 <title>Contents</title>
265
266 <segmentedlist>
267 <segtitle>Installed Programs</segtitle>
268 <segtitle>Installed Libraries</segtitle>
269 <segtitle>Installed Directories</segtitle>
270
271 <seglistitem>
272 <seg>
273 gdm-control, gnome-panel-control, obxprop, openbox,
274 openbox-gnome-session, openbox-kde-session and openbox-session
275 </seg>
276 <seg>
277 libobrender.so and libobt.so
278 </seg>
279 <seg>
280 /etc/xdg/openbox, /usr/include/openbox,
281 /usr/share/doc/openbox-&openbox-version; and /usr/share/themes.
282 </seg>
283 </seglistitem>
284 </segmentedlist>
285
286 <variablelist>
287 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
288 <?dbfo list-presentation="list"?>
289 <?dbhtml list-presentation="table"?>
290
291 <varlistentry id="gdm-control">
292 <term><command>gdm-control</command></term>
293 <listitem>
294 <para>
295 is a command line tool to send signals to
296 <application>GDM</application>.
297 </para>
298 <indexterm zone="openbox gdm-control">
299 <primary sortas="b-gdm-control">gdm-control</primary>
300 </indexterm>
301 </listitem>
302 </varlistentry>
303
304 <varlistentry id="gnome-panel-control">
305 <term><command>gnome-panel-control</command></term>
306 <listitem>
307 <para>
308 is a command line utility to invoke the <application>Gnome
309 Panel</application> run dialog/menu.
310 </para>
311 <indexterm zone="openbox gnome-panel-control">
312 <primary
313 sortas="b-gnome-panel-control">gnome-panel-control</primary>
314 </indexterm>
315 </listitem>
316 </varlistentry>
317
318 <varlistentry id="obxprop">
319 <term><command>obxprop</command></term>
320 <listitem>
321 <para>
322 is a tool for displaying the properties on an x window. It has a
323 similar functionality to <command>xprop</command>, but allows you to
324 see UTF-8 strings as text.
325 </para>
326 <indexterm zone="openbox obxprop">
327 <primary sortas="b-obxprop">obxprop</primary>
328 </indexterm>
329 </listitem>
330 </varlistentry>
331
332 <varlistentry id="openbox-prog">
333 <term><command>openbox</command></term>
334 <listitem>
335 <para>
336 is a standards compliant, highly configurable, window manager.
337 </para>
338 <indexterm zone="openbox openbox">
339 <primary sortas="b-openbox">openbox</primary>
340 </indexterm>
341 </listitem>
342 </varlistentry>
343
344 <varlistentry id="openbox-gnome-session">
345 <term><command>openbox-gnome-session</command></term>
346 <listitem>
347 <para>
348 is a script to launch an <application>Gnome</application> session
349 with openbox as your window manager from your
350 <filename>~/.xinitrc</filename>.
351 </para>
352 <indexterm zone="openbox openbox-gnome-session">
353 <primary
354 sortas="b-openbox-gnome-session">openbox-gnome-session</primary>
355 </indexterm>
356 </listitem>
357 </varlistentry>
358
359 <varlistentry id="openbox-kde-session">
360 <term><command>openbox-kde-session</command></term>
361 <listitem>
362 <para>
363 is a script to launch an <application>KDE</application> session with
364 <application>Openbox</application> as your window manager from your
365 <filename>~/.xinitrc</filename>.
366 </para>
367 <indexterm zone="openbox openbox-kde-session">
368 <primary
369 sortas="b-openbox-kde-session">openbox-kde-session</primary>
370 </indexterm>
371 </listitem>
372 </varlistentry>
373
374 <varlistentry id="openbox-session">
375 <term><command>openbox-session</command></term>
376 <listitem>
377 <para>
378 is a script to launch an <application>Openbox</application> session
379 from your <filename>~/.xinitrc</filename>.
380 </para>
381 <indexterm zone="openbox openbox-session">
382 <primary sortas="b-openbox-session">openbox-session</primary>
383 </indexterm>
384 </listitem>
385 </varlistentry>
386
387 <varlistentry id="libobrender">
388 <term><filename class="libraryfile">libobrender.so</filename></term>
389 <listitem>
390 <para>
391 contains the functions used by <application>Openbox</application>
392 for theme rendering.
393 </para>
394 <indexterm zone="openbox libobrender">
395 <primary sortas="c-libobrender">libobrender.so</primary>
396 </indexterm>
397 </listitem>
398 </varlistentry>
399
400 <varlistentry id="libobt">
401 <term><filename class="libraryfile">libobt.so</filename></term>
402 <listitem>
403 <para>
404 is the <application>Openbox</application> toolkit library.
405 </para>
406 <indexterm zone="openbox libobt">
407 <primary sortas="c-libobt">libobt.so</primary>
408 </indexterm>
409 </listitem>
410 </varlistentry>
411 </variablelist>
412 </sect2>
413</sect1>
Note: See TracBrowser for help on using the repository browser.