mirror of
https://github.com/gryf/window-maker.github.io.git
synced 2025-12-17 19:20:17 +01:00
Deploy gryf/window-maker.github.io to github.com/gryf/window-maker.github.io.git:gh-pages
This commit is contained in:
Deployment Bot (from Travis CI)
370
docs/chap3.html
Normal file
370
docs/chap3.html
Normal file
@@ -0,0 +1,370 @@
|
||||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<title>Window Maker: User Guide - Workspace</title>
|
||||
<meta charset="utf-8">
|
||||
<link rel="stylesheet" href="/style.css" media="screen">
|
||||
<meta name="HandheldFriendly" content="True">
|
||||
<meta name="MobileOptimized" content="320">
|
||||
<meta name="viewport"
|
||||
content="width=device-width, minimumscale=1.0, maximum-scale=1.0">
|
||||
</head>
|
||||
<body>
|
||||
<div id="wrapper">
|
||||
<header>
|
||||
<h1>
|
||||
<a href="/">
|
||||
<span class="first">Window</span><span class="second">Maker</span>
|
||||
</a>
|
||||
</h1>
|
||||
</header>
|
||||
<aside>
|
||||
<nav class="menu">
|
||||
<ul>
|
||||
<li id="dock">
|
||||
<a href="#"></a>
|
||||
</li>
|
||||
<li id="home" title="Home">
|
||||
<a href="/">Home</a>
|
||||
</li>
|
||||
<li id="news" title="News">
|
||||
<a href="/news">News</a>
|
||||
</li>
|
||||
<li id="docs" title="Documentation">
|
||||
<a href="/docs">Documentation</a>
|
||||
</li>
|
||||
<li id="mail" title="Mailing lists">
|
||||
<a href="/lists">Mailing</a>
|
||||
</li>
|
||||
<li id="devel" title="Development">
|
||||
<a href="/dev">Development</a>
|
||||
</li>
|
||||
<li id="screenshots" title="Screenshots">
|
||||
<a href="/screenshots">Screenshots</a>
|
||||
</li>
|
||||
<li id="themes" title="Themes">
|
||||
<a href="/themes">Themes</a>
|
||||
</li>
|
||||
<li id="links" title="Links">
|
||||
<a href="/links">Links</a>
|
||||
</li>
|
||||
</ul>
|
||||
</nav>
|
||||
</aside>
|
||||
<article>
|
||||
|
||||
<div class="document" id="the-workspace">
|
||||
<h1 class="title">The Workspace</h1>
|
||||
|
||||
<div class="section" id="working-with-menus">
|
||||
<h1>Working with Menus</h1>
|
||||
<p>Menus provide a list of commands that you can execute.</p>
|
||||
<div class="borderless figure">
|
||||
<img alt="An Example Menu" src="guide/images/menu.gif">
|
||||
</div>
|
||||
<p>To execute a command listed in a menu, click in the corresponding item. The
|
||||
item will blink telling that the command is going to be executed.</p>
|
||||
<p>Grayed commands are disabled and cannot be executed at that moment. If you
|
||||
click on them nothing will happen.</p>
|
||||
<p>Some menu entries have a little triangular indicator at the right. Selecting
|
||||
these entries will open a submenu, with a new list of commands.</p>
|
||||
<p>You can use the keyboard to traverse and execute commands in some of the menus.
|
||||
First you must hit the key used to open the menu - like F12 for the root menu -
|
||||
to enable keyboard traversal of it. Then you can use the Up and Down arrow keys
|
||||
to change the current selected item and the Left and Right arrow keys to jump
|
||||
between submenus and parent menus. To execute the current selected item press
|
||||
Return. To close the menu or stop menu traversal, press Escape. Additionally,
|
||||
pressing the first letter for an menu item, will jump the current selection to
|
||||
that item.</p>
|
||||
<p>You can make frequently used menus "stick" to the workspace by dragging the
|
||||
titlebar of the menu. This will make a close button appear in the menu
|
||||
titlebar. If you want to close the menu, just click in that button.</p>
|
||||
<p>Menus are normally placed on top of other windows and cannot be obscured by
|
||||
them. If you want the menus to be able to be obscured by lowering them, double
|
||||
click the menu titlebar while holding the Meta key. Repeat this to make the
|
||||
menus not obscurable again.</p>
|
||||
<div class="section" id="the-root-window-menu">
|
||||
<h2>The Root Window Menu</h2>
|
||||
<p>The <em>Root Window Menu</em> or <em>Applications Menu</em> has items that allow you to
|
||||
quickly launch applications and do some workspace management.</p>
|
||||
<p>To open this menu, click on the workspace (root window) with the 3rd mouse
|
||||
button or hit the key bound to it (F12 by default).</p>
|
||||
<p>The contents of the applications menu can be configured to hold the
|
||||
applications installed on your system. To learn how to configure it, read the
|
||||
section on application menu configuration.</p>
|
||||
</div>
|
||||
<div class="section" id="the-window-list-menu">
|
||||
<h2>The Window List Menu</h2>
|
||||
<p>Clicking in the workspace with the middle mouse button will open a menu listing
|
||||
all windows that currently exist, with the workspace in which the window is
|
||||
located to its right. The current focused window is marked by a diamond sign
|
||||
next to its name. Clicking in an entry in this menu will focus the window,
|
||||
raise it, and change to the workspace where it is located.</p>
|
||||
</div>
|
||||
</div>
|
||||
<div class="section" id="working-with-applications">
|
||||
<h1>Working with Applications</h1>
|
||||
<p>In WindowMaker the instance of a running application is represented by an
|
||||
application icon. Do not confuse it with the icons (miniwindows in WindowMaker)
|
||||
displayed by other window managers when a window is iconified. Application
|
||||
icons and miniwindows can be differentiated in that miniwindows have titlebars,
|
||||
application icons do not.</p>
|
||||
<p>WindowMaker identifies a group of windows as belonging to a single instance of
|
||||
an application through some standard hints that the application sets in its
|
||||
windows. Unfortunately, not all applications that exist set these hints,
|
||||
preventing some application-specific features from working. These hints are
|
||||
<strong>WM.CLASS</strong>, <strong>WM.COMMAND</strong>, and <strong>WM.CLIENT.LEADER</strong> or the group leader in
|
||||
<strong>WM.HINTS</strong>.</p>
|
||||
<p>Note: The information about applications contained in this section only applies
|
||||
to versions of WindowMaker built without the --enable-single-icon compile time
|
||||
option. This option is unsupported and behaviour when it's enabled will not be
|
||||
covered in this text.</p>
|
||||
<div class="section" id="hiding-an-application">
|
||||
<h2>Hiding an Application</h2>
|
||||
<p>If you want to close and application but intend to use it later you can <em>hide</em>
|
||||
it. When you hide an application all windows and miniwindows that belong to
|
||||
that application will be removed from the screen and hidden into its
|
||||
application icon.</p>
|
||||
<p>To hide an application:</p>
|
||||
<ul class="simple">
|
||||
<li><p>Click the miniaturize button of any of the windows that belong to the
|
||||
application while holding the Control key.</p></li>
|
||||
</ul>
|
||||
<p>OR</p>
|
||||
<ul class="simple">
|
||||
<li><p>Press the keyboard shortcut assigned to it, which is Meta+h in the default
|
||||
configuration.</p></li>
|
||||
</ul>
|
||||
<p>OR</p>
|
||||
<ul class="simple">
|
||||
<li><p>User the hide command in the <a class="reference external" href="chap2.html#the-window-commands-menu">window commands menu</a> brought up when the window titlebar
|
||||
is clicked with the right mouse button.</p></li>
|
||||
</ul>
|
||||
<p>OR</p>
|
||||
<ul class="simple">
|
||||
<li><p>Use the (Un)Hide command in the application icon commands menu brought up
|
||||
when the application icon is clicked with the right mouse button.</p></li>
|
||||
</ul>
|
||||
<p>To unhide an application</p>
|
||||
<ul class="simple">
|
||||
<li><p>Double click the application icon with the left mouse button.</p></li>
|
||||
</ul>
|
||||
<p>OR</p>
|
||||
<ul class="simple">
|
||||
<li><p>Use the (Un)Hide command in the application icon commands menu brought up
|
||||
when the application icon is clicked with the right mouse button.</p></li>
|
||||
</ul>
|
||||
<p>When you unhide an application, all it's windows and miniwindows will brought
|
||||
back, and you will be taken to the last workspace in which you worked with that
|
||||
application.</p>
|
||||
<p><strong>Extra Bindings</strong></p>
|
||||
<table>
|
||||
<colgroup>
|
||||
<col style="width: 49%">
|
||||
<col style="width: 51%">
|
||||
</colgroup>
|
||||
<thead>
|
||||
<tr>
|
||||
<th class="head"><p>Action</p></th>
|
||||
<th class="head"><p>Effect</p></th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td><p>Double-click the application icon
|
||||
while holding the Meta key</p></td>
|
||||
<td><p>Unhide the clicked application,
|
||||
and hide all other applications
|
||||
that are present in the current
|
||||
workspace.</p></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><p>Double-click the application icon
|
||||
while holding the Shift key</p></td>
|
||||
<td><p>Unhide the clicked application in
|
||||
the current workspace</p></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><p>Double-click the application icon
|
||||
with the middle mouse button</p></td>
|
||||
<td><p>Unhide the clicked application and
|
||||
deminiaturize all its windows.</p></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><p>Double-click the window titlebar
|
||||
with the right mouse button while
|
||||
holding the Meta key.</p></td>
|
||||
<td><p>Hide all applications in the
|
||||
current workspace except for the
|
||||
clicked one.</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<p>There are two other commands in the applications menu related to application
|
||||
hiding:</p>
|
||||
<dl class="simple">
|
||||
<dt>Hide others</dt>
|
||||
<dd>
|
||||
<p>Hide all applications in the current workspace, except for the currently
|
||||
active one.</p>
|
||||
</dd>
|
||||
<dt>Show All</dt>
|
||||
<dd>
|
||||
<p>Unhide all applications that were hidden from the current workspace</p>
|
||||
</dd>
|
||||
</dl>
|
||||
</div>
|
||||
<div class="section" id="the-application-icon-menu">
|
||||
<h2>The Application Icon Menu</h2>
|
||||
<p>A menu with commands that will apply to the application can be brought up by
|
||||
clicking the application icon with the right mouse button.</p>
|
||||
<p>The commands available in this menu are:</p>
|
||||
<dl class="simple">
|
||||
<dt>Unhide Here</dt>
|
||||
<dd>
|
||||
<p>Unhides the application in the current workspace.</p>
|
||||
</dd>
|
||||
<dt>(Un)Hide</dt>
|
||||
<dd>
|
||||
<p>Hides the application. Unless the application is already hidden, in which
|
||||
case it will unhide the application and take you to its workspace.</p>
|
||||
</dd>
|
||||
<dt>Set Icon...</dt>
|
||||
<dd>
|
||||
<p>Opens the icon image selection panel for the application icon.</p>
|
||||
</dd>
|
||||
<dt>Kill</dt>
|
||||
<dd>
|
||||
<p>Will kill the application.</p>
|
||||
</dd>
|
||||
</dl>
|
||||
</div>
|
||||
<div class="section" id="the-application-dock">
|
||||
<h2>The Application Dock</h2>
|
||||
<p>The application dock is a place where you can store frequently used
|
||||
applications for easy and fast access. It is located, by default, on the right
|
||||
side of the screen.</p>
|
||||
<p>You can click the top icon (the one with the GNUstep logo) and drag it downward
|
||||
to remove most of the dock from view. You can also drag it sideways to move
|
||||
the entire dock from side of the screen to the other.</p>
|
||||
<p>A menu similar to the <a class="reference external" href="#the-application-icon-menu">application icon menu</a> is
|
||||
brought up when you click a docked icon with the right mouse button.</p>
|
||||
<p>To make the dock <em>float</em> over windows (not be coverable by windows), either
|
||||
double-click the top dock icon while holding the Meta key, or select the
|
||||
"Floating Dock" option in the dock menu.</p>
|
||||
<div class="section" id="starting-a-docked-application">
|
||||
<h3>Starting a docked application</h3>
|
||||
<p>To start an application that is docked, double-click its icon. The icon will be
|
||||
briefly highlighted and the application will start.</p>
|
||||
<p>While an application is not running an ellipsis is present in the lower
|
||||
left-hand corner of the icon. This ellipsis will disappear when the application
|
||||
is started and reappear when the application is exited.</p>
|
||||
<p>While the application is running the docked icon will behave just like a
|
||||
normal, undocked application icon, except for some extra actions specific to
|
||||
the dock.</p>
|
||||
<p>To start a docked application:</p>
|
||||
<ul class="simple">
|
||||
<li><p>Double-click the application icon with the left mouse button.</p></li>
|
||||
</ul>
|
||||
<p>OR</p>
|
||||
<ul class="simple">
|
||||
<li><p>Use the "Launch" command in the dock menu for the icon. If the application is
|
||||
already running it will start another instance.</p></li>
|
||||
</ul>
|
||||
<p>OR</p>
|
||||
<ul class="simple">
|
||||
<li><p>Hold the Control key while double-clicking the icon to start another instance
|
||||
of the application.</p></li>
|
||||
</ul>
|
||||
<p>If a new instance of an already running application is started it will get a
|
||||
new application icon.</p>
|
||||
</div>
|
||||
<div class="section" id="customizing-the-dock">
|
||||
<h3>Customizing the dock</h3>
|
||||
<p>To add new applications to the dock, you can click an application icon and drag
|
||||
it onto the dock. When a ghost image of the icon appears you can release the
|
||||
mouse button and the icon will be docked.</p>
|
||||
<p>To reorder the docked applications, drag an icon to an empty slot and move the
|
||||
icons around as you want.</p>
|
||||
<p>To remove a docked application, drag it from the dock and release the mouse
|
||||
button when the ghost image disappears. To remove the icon of an application
|
||||
that is running, hold the Meta key while dragging it.</p>
|
||||
</div>
|
||||
<div class="section" id="configuring-the-docked-application">
|
||||
<h3>Configuring the docked application</h3>
|
||||
<p>To change the settings of a docked application, select the "Settings..." item
|
||||
in the dock menu for that icon. A settings panel for that icon will appear.</p>
|
||||
<div class="borderless figure">
|
||||
<img alt="Docked Application Settings Panel" src="guide/images/dockapppanel.gif">
|
||||
</div>
|
||||
<p>In the <em>Application path and arguments</em> field, the path for the application and
|
||||
its arguments can be changed. Note that you can't change the application that
|
||||
is represented in the icon or change anything that would cause the application
|
||||
name to be changed. For example, if the icon is for <span class="docutils literal">xterm</span> you can't change
|
||||
the field's value to <strong>ghostview</strong>; or if the icon is for <span class="docutils literal">xterm <span class="pre">-name</span> vi</span>,
|
||||
you can't change it to <span class="docutils literal">xterm <span class="pre">-name</span> pine</span>. Also note that you cannot use
|
||||
shell commands, such as output redirectors. (<span class="docutils literal">></span>, <span class="docutils literal">>></span>; etc.)</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div class="section" id="working-with-workspaces">
|
||||
<h1>Working with Workspaces</h1>
|
||||
<div class="section" id="the-workspaces-menu">
|
||||
<h2>The Workspaces Menu</h2>
|
||||
<p>The <em>Workspaces Menu</em> allows you to create, switch, destroy and rename
|
||||
workspaces.</p>
|
||||
<p>It has the following items:</p>
|
||||
<dl class="simple">
|
||||
<dt>New</dt>
|
||||
<dd>
|
||||
<p>Creates a new workspace and automatically switches to it</p>
|
||||
</dd>
|
||||
<dt>Destroy Last</dt>
|
||||
<dd>
|
||||
<p>Destroys the last workspace unless it is occupied</p>
|
||||
</dd>
|
||||
<dt>Workspaces</dt>
|
||||
<dd>
|
||||
<p>Each workspace has a corresponding item in the Workspaces menu. Clicking in
|
||||
one of these entries will switch from the current workspace to the selected
|
||||
workspace.</p>
|
||||
</dd>
|
||||
</dl>
|
||||
<p>The current active workspace is indicated by a small indicator at the left of
|
||||
the workspace item.</p>
|
||||
<div class="borderless figure">
|
||||
<img alt="Workspace Menu" src="guide/images/wsmenu.gif">
|
||||
</div>
|
||||
<p>To change the name of a workspace you must first "stick" the menu. Then Control
|
||||
click in the item corresponding to the workspace you want to rename. The item
|
||||
will turn into a editable text field where you can edit the workspace name. To
|
||||
finish editing the workspace name, press Return; to cancel it, press Escape.</p>
|
||||
<p>There is a limit of 16 characters on the length of the workspace name.</p>
|
||||
<p>An example Workspace menu being edited:</p>
|
||||
<div class="borderless figure">
|
||||
<img alt="Workspace Menu: Editing a Workspace name" src="guide/images/wsmenued.gif">
|
||||
</div>
|
||||
</div>
|
||||
<div class="section" id="the-workspace-clip">
|
||||
<h2>The workspace clip</h2>
|
||||
<!-- WTF is that?? -->
|
||||
<p>[This section was unavailable in the original, and thus is not here]</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
</article>
|
||||
<div id="titlebar">
|
||||
<div id="minimize"></div>
|
||||
<div id="titlebar-inner">Window Maker: User Guide - Workspace</div>
|
||||
<div id="close"></div>
|
||||
</div>
|
||||
<div id="resizebar">
|
||||
<div id="resizel"></div>
|
||||
<div id="resizebar-inner">
|
||||
</div>
|
||||
<div id="resizer"></div>
|
||||
</div>
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
Reference in New Issue
Block a user