mirror of
https://github.com/gryf/window-maker.github.io.git
synced 2025-12-17 19:20:17 +01:00
Converted menu file to rst, cleaned up the contents
This commit is contained in:
Binary file not shown.
|
Before Width: | Height: | Size: 20 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 9.1 KiB |
BIN
docs/guidedtour/images/menu_application_icon.png
Normal file
BIN
docs/guidedtour/images/menu_application_icon.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 4.4 KiB |
BIN
docs/guidedtour/images/menu_applications.png
Normal file
BIN
docs/guidedtour/images/menu_applications.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 7.6 KiB |
BIN
docs/guidedtour/images/menu_window_list.png
Normal file
BIN
docs/guidedtour/images/menu_window_list.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 6.6 KiB |
BIN
docs/guidedtour/images/menu_workspaces.png
Normal file
BIN
docs/guidedtour/images/menu_workspaces.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 6.0 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 4.9 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 11 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 13 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 24 KiB |
@@ -1,185 +0,0 @@
|
|||||||
---
|
|
||||||
layout: default
|
|
||||||
title: Guided Tour - Menus
|
|
||||||
---
|
|
||||||
</head>
|
|
||||||
<h1>
|
|
||||||
<center>Menus</center>
|
|
||||||
</h1>
|
|
||||||
|
|
||||||
<center><a href="index.html">Back
|
|
||||||
to Index</a></center>
|
|
||||||
|
|
||||||
<ul>
|
|
||||||
|
|
||||||
<li><a href="#menu">Menu list</a></li>
|
|
||||||
<li><a href="#root">Root window menu</a></li>
|
|
||||||
<li><a href="#list">Window list menu</a></li>
|
|
||||||
<li><a href="#wspace">Workspaces menu</a></li>
|
|
||||||
<li><a href="#apps">Application icon menu</a></li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h2><a id="menu">Menu list</a></h2>
|
|
||||||
|
|
||||||
<p>Different menus are available within Window Maker:</p>
|
|
||||||
|
|
||||||
<ul>
|
|
||||||
|
|
||||||
<li>The root window menu or applications menu</li>
|
|
||||||
<li>The window list menu</li>
|
|
||||||
<li>The workspace menu</li>
|
|
||||||
<li>The application icon menu<br>
|
|
||||||
</li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<p>Menus provide a list of applications or commands for execution. They
|
|
||||||
can be used to launch applications, to get information, to configure
|
|
||||||
the workspace...<br>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>Menus are opened by right-clicking either in the "blank" area of the
|
|
||||||
workspace or in a window's titlebar or in docked icons. The <em>window
|
|
||||||
list menu</em> is the only one opened with the middle mouse button.
|
|
||||||
With a two-button mouse, pressing both buttons at once usually does the
|
|
||||||
trick. A number of keyboard shortcuts are provided. These shortcuts are
|
|
||||||
indicated by the modifier key + letter shown to the right of a menu
|
|
||||||
item.</p>
|
|
||||||
|
|
||||||
<p>The keyboard can be used to open and move through some of the menus.
|
|
||||||
For instance, the root menu can be opened using F12 (default setting).
|
|
||||||
The Up and Down arrow keys can then be used to navigate through the
|
|
||||||
menu or the Left and Right arrow keys to jump between parent menus and
|
|
||||||
submenus. Hitting the <em>Enter</em> key executes the selected item.
|
|
||||||
the <em>Escape</em> key closes the menu or stops menu traversal.</p>
|
|
||||||
|
|
||||||
<p>Menus can be forced to remain open on the workspace by left-clicking
|
|
||||||
the titlebar. This creates a <em>close</em> button on the titlebar.</p>
|
|
||||||
|
|
||||||
<h2><a id="root">Root window menu</a></h2>
|
|
||||||
|
|
||||||
<center><img style="width: 107px; height: 261px;" alt="Root window menu (applications menu)" src="images/apm.png"></center>
|
|
||||||
|
|
||||||
<br>
|
|
||||||
|
|
||||||
The root window menu or applications menu is opened by right-clicking
|
|
||||||
on an empty area of the workspace or by hitting the pre-defined
|
|
||||||
keyboard shortcut (default is F12). This menu launches applications,
|
|
||||||
allows for the customization of the workspace (backgrounds, themes...),
|
|
||||||
and the management of other workspace characteristics using standard X
|
|
||||||
utilities (xprop, xfontsel, xcmap...).
|
|
||||||
<p>The menu content is totally configurable, either using WPrefs.app or
|
|
||||||
by editing the plain text menu file. Instructions on how to configure
|
|
||||||
one or the other can be found in the WindowMaker directory of the
|
|
||||||
distribution. To use WPrefs.app, menus must be in property list format
|
|
||||||
(plmenu). A script is available to convert plain text menus to property
|
|
||||||
list menus and it's called wm-oldmenu2new. </p>
|
|
||||||
|
|
||||||
<h2><a id="list">Window list menu</a></h2>
|
|
||||||
|
|
||||||
<center><img style="width: 265px; height: 141px;" alt="Window list menu" src="images/wlm.png"></center>
|
|
||||||
|
|
||||||
<br>
|
|
||||||
|
|
||||||
Middle-clicking an empty area of the workspace opens the window list
|
|
||||||
menu. With a two-button mouse, clicking both buttons at once usually
|
|
||||||
gives the same result. F11 is the default keyboard shorcut to open the
|
|
||||||
window list menu.
|
|
||||||
<p>This menu lists all windows - whether active or inactive - in every
|
|
||||||
workspace. The workspace containing each window is indicated at the
|
|
||||||
right of the window name. The current focused window is marked by a
|
|
||||||
diamond sign to the left of the window's name. Clicking any window in
|
|
||||||
the list focuses and raises the corresponding window and moves you to
|
|
||||||
the workspace where it's located.</p>
|
|
||||||
|
|
||||||
<h2><a id="wspace">Workspaces menu</a></h2>
|
|
||||||
|
|
||||||
<center><img style="width: 101px; height: 121px;" alt="Workspaces menu" src="images/wksm.png"></center>
|
|
||||||
|
|
||||||
<br>
|
|
||||||
|
|
||||||
<br>
|
|
||||||
|
|
||||||
The workspaces menu is part of the root menu (applications menu).
|
|
||||||
This item has two options: <em>new</em> and <em>destroy last</em>.
|
|
||||||
<p>The first option creates a new workspace and automatically switches
|
|
||||||
you to it. </p>
|
|
||||||
|
|
||||||
<p>The second option destroys the last workspace as soon as there are
|
|
||||||
no windows opened in it.</p>
|
|
||||||
|
|
||||||
<p>Each workspace has a corresponding item in this menu. The active
|
|
||||||
workspace is indicated by a diamond to the left of the workspace name
|
|
||||||
or number.</p>
|
|
||||||
|
|
||||||
<p>Clicking a workspace entry switches from the current workspace to
|
|
||||||
the selected workspace.</p>
|
|
||||||
|
|
||||||
<p>To change the name of a workspace, first "stick" the menu by
|
|
||||||
left-clicking the menu titlebar. Then <em>Ctrl + click</em> the menu
|
|
||||||
item to make it editable and type in the new name. Hitting <em>Return</em>
|
|
||||||
saves the new name, hitting <em>Escape</em> cancels the operation.</p>
|
|
||||||
|
|
||||||
<p>Key bindings allow movement from one workspace to another. Usually <em>Meta
|
|
||||||
+ (number)</em>. The <span style="font-style: italic;">Meta</span> key
|
|
||||||
is normally the "<span style="font-style: italic;">Alt</span>" key,
|
|
||||||
while <em>(number)</em> represents a number
|
|
||||||
key that corresponds to the workspace number. For instance 1 can be
|
|
||||||
the default workspace (workspace 1), 2 the second workspace and so on.
|
|
||||||
Thus,
|
|
||||||
<span style="font-style: italic;">Meta + 2</span> switches to workspace
|
|
||||||
2.</p>
|
|
||||||
|
|
||||||
<p>These key bindings can be set (or changed) from the keyboard
|
|
||||||
shortcut dialog in
|
|
||||||
WPrefs.app. </p>
|
|
||||||
|
|
||||||
<h2><a id="apps">Application icon menu</a></h2>
|
|
||||||
|
|
||||||
<center><img style="width: 98px; height: 119px;" alt="Icon application menu" src="images/dockm.png"></center>
|
|
||||||
|
|
||||||
<br>
|
|
||||||
|
|
||||||
<br>
|
|
||||||
|
|
||||||
Clicking an icon in the dock with the right mouse button brings a
|
|
||||||
menu for modifying that icon's application. There are six options
|
|
||||||
available in the application icon menu for docked applications. (Some
|
|
||||||
applications will not have all six options available. If an
|
|
||||||
option is not available, it will appear "greyed out" in the menu.) <br>
|
|
||||||
|
|
||||||
<ol>
|
|
||||||
|
|
||||||
<li>
|
|
||||||
<p>Clicking "Keep on top" places a check-mark beside that option,
|
|
||||||
which means that the icon will always be on "top" of
|
|
||||||
opened windows. If "Keep on top" is unchecked, windows will be allowed
|
|
||||||
to cover the icons in the dock. Selecting "Keep on top" for one icon
|
|
||||||
automatically affects all of the items in the dock. You cannot keep
|
|
||||||
just one docked icon on top of windows - it's all or nothing, one way
|
|
||||||
or the other.<br>
|
|
||||||
</p>
|
|
||||||
</li>
|
|
||||||
<li>
|
|
||||||
<p>"Launch" opens the application without double-clicking the icon.</p>
|
|
||||||
</li>
|
|
||||||
<li>
|
|
||||||
<p>"Bring here" unhides the application in the current workspace.</p>
|
|
||||||
</li>
|
|
||||||
<li>
|
|
||||||
<p>"Hide" hides the application or unhides it if already hidden.
|
|
||||||
Unhiding opens the application in the workspace where it is located.
|
|
||||||
(This option may not work if the application has it's own hiding menu
|
|
||||||
option.)</p>
|
|
||||||
</li>
|
|
||||||
<li>
|
|
||||||
<p>"Settings" allows the modification of application path and
|
|
||||||
arguments, the command line, and the icon used.</p>
|
|
||||||
</li>
|
|
||||||
<li>
|
|
||||||
<p>"Kill" closes the application immediately and should only be
|
|
||||||
used if absolutely necessary.</p>
|
|
||||||
</li>
|
|
||||||
</ol>
|
|
||||||
|
|
||||||
<center><a href="index.html">Back
|
|
||||||
to Index</a></center>
|
|
||||||
168
docs/guidedtour/menu.rst
Normal file
168
docs/guidedtour/menu.rst
Normal file
@@ -0,0 +1,168 @@
|
|||||||
|
---
|
||||||
|
layout: default
|
||||||
|
title: Guided Tour - Menus
|
||||||
|
---
|
||||||
|
|
||||||
|
Menus
|
||||||
|
=====
|
||||||
|
|
||||||
|
.. contents::
|
||||||
|
:depth: 1
|
||||||
|
:backlinks: none
|
||||||
|
:local:
|
||||||
|
|
||||||
|
|
||||||
|
Menu list
|
||||||
|
---------
|
||||||
|
|
||||||
|
Different menus are available within Window Maker:
|
||||||
|
|
||||||
|
- The root window menu or applications menu
|
||||||
|
- The window list menu
|
||||||
|
- The workspace menu
|
||||||
|
- The application icon menu
|
||||||
|
|
||||||
|
Menus provide a list of applications or commands for execution. They can be
|
||||||
|
used to launch applications, to get information, to configure the workspace...
|
||||||
|
|
||||||
|
|
||||||
|
Menus are opened by right-clicking either in the "blank" area of the workspace
|
||||||
|
or in a window's titlebar or in docked icons. The *window list menu* is the
|
||||||
|
only one opened with the middle mouse button. With a two-button mouse,
|
||||||
|
pressing both buttons at once usually does the trick. A number of keyboard
|
||||||
|
shortcuts are provided. These shortcuts are indicated by the modifier key +
|
||||||
|
letter shown to the right of a menu item.
|
||||||
|
|
||||||
|
The keyboard can be used to open and move through some of the menus. For
|
||||||
|
instance, the root menu can be opened using F12 (default setting). The Up and
|
||||||
|
Down arrow keys can then be used to navigate through the menu or the Left and
|
||||||
|
Right arrow keys to jump between parent menus and submenus. Hitting the *Enter*
|
||||||
|
key executes the selected item. The *Escape* key closes the menu or stops menu
|
||||||
|
traversal.
|
||||||
|
|
||||||
|
Menus can be forced to remain open on the workspace by left-clicking the
|
||||||
|
titlebar. This creates a *close* button on the titlebar.
|
||||||
|
|
||||||
|
Root window menu
|
||||||
|
----------------
|
||||||
|
|
||||||
|
.. figure:: images/menu_applications.png
|
||||||
|
:alt: Root window menu (applications menu)
|
||||||
|
:figclass: borderless
|
||||||
|
|
||||||
|
Root window menu (applications menu)
|
||||||
|
|
||||||
|
The root window menu or applications menu is opened by right-clicking on an
|
||||||
|
empty area of the workspace or by hitting the pre-defined keyboard shortcut
|
||||||
|
(default is F12). This menu launches applications, allows for the customization
|
||||||
|
of the workspace (backgrounds, themes...), and the management of other
|
||||||
|
workspace characteristics using standard X utilities (xprop, xfontsel,
|
||||||
|
xcmap...).
|
||||||
|
|
||||||
|
The menu content is totally configurable, either using WPrefs.app or by editing
|
||||||
|
the plain text menu file. Instructions on how to configure one or the other can
|
||||||
|
be found in the WindowMaker directory of the distribution. To use WPrefs.app,
|
||||||
|
menus must be in property list format (plmenu). A script is available to
|
||||||
|
convert plain text menus to property list menus and it's called wm-oldmenu2new.
|
||||||
|
|
||||||
|
Window list menu
|
||||||
|
----------------
|
||||||
|
|
||||||
|
.. figure:: images/menu_window_list.png
|
||||||
|
:alt: Window list menu
|
||||||
|
:figclass: borderless
|
||||||
|
|
||||||
|
Window list menu
|
||||||
|
|
||||||
|
Middle-clicking an empty area of the workspace opens the window list menu. With
|
||||||
|
a two-button mouse, clicking both buttons at once usually gives the same
|
||||||
|
result. F11 is the default keyboard shortcut to open the window list menu.
|
||||||
|
|
||||||
|
This menu lists all windows - whether active or inactive - in every workspace.
|
||||||
|
The workspace containing each window is indicated at the right of the window
|
||||||
|
name. The current focused window is marked by a diamond sign to the left of the
|
||||||
|
window's name. Clicking any window in the list focuses and raises the
|
||||||
|
corresponding window and moves you to the workspace where it's located.
|
||||||
|
|
||||||
|
Workspaces menu
|
||||||
|
---------------
|
||||||
|
|
||||||
|
.. figure:: images/menu_workspaces.png
|
||||||
|
:alt: Workspaces menu
|
||||||
|
:figclass: borderless
|
||||||
|
|
||||||
|
Workspaces menu
|
||||||
|
|
||||||
|
The workspaces menu is part of the root menu (applications menu). This item
|
||||||
|
has three options: *new*, *destroy last* and *last used*.
|
||||||
|
|
||||||
|
The first option creates a new workspace and automatically switches you to it.
|
||||||
|
|
||||||
|
The second option destroys the last workspace as soon as there are no windows
|
||||||
|
opened in it.
|
||||||
|
|
||||||
|
The third option switches to last visited workspace.
|
||||||
|
|
||||||
|
Each workspace has a corresponding item in this menu. The active workspace is
|
||||||
|
indicated by a diamond to the left of the workspace name or number.
|
||||||
|
|
||||||
|
Clicking a workspace entry switches from the current workspace to the selected
|
||||||
|
workspace.
|
||||||
|
|
||||||
|
To change the name of a workspace, first "stick" the menu by left-clicking the
|
||||||
|
menu titlebar. Then *Ctrl + click* the menu item to make it editable and type
|
||||||
|
in the new name. Hitting *Return* saves the new name, hitting *Escape* cancels
|
||||||
|
the operation.
|
||||||
|
|
||||||
|
Key bindings allow movement from one workspace to another. Usually *Meta +
|
||||||
|
(number)*. The *Meta* key is normally the "*Alt*" key, while *(number)*
|
||||||
|
represents a number key that corresponds to the workspace number. For instance
|
||||||
|
1 can be the default workspace (workspace 1), 2 the second workspace and so on.
|
||||||
|
Thus, *Meta + 2* switches to workspace 2.
|
||||||
|
|
||||||
|
These key bindings can be set (or changed) from the keyboard shortcut dialog in
|
||||||
|
WPrefs.app.
|
||||||
|
|
||||||
|
Application icon menu
|
||||||
|
---------------------
|
||||||
|
|
||||||
|
.. figure:: images/menu_application_icon.png
|
||||||
|
:alt: Icon application menu
|
||||||
|
:figclass: borderless
|
||||||
|
|
||||||
|
Icon application menu
|
||||||
|
|
||||||
|
Clicking an icon in the dock with the right mouse button brings a menu for
|
||||||
|
modifying that icon's application. There are several options available in the
|
||||||
|
application icon menu for docked applications. Docked, but not running
|
||||||
|
applications will not have all options available - they will appear "greyed
|
||||||
|
out" in the menu.
|
||||||
|
|
||||||
|
#. First option is a global Dock submenu, which have three items:
|
||||||
|
|
||||||
|
#. *Normal* will not change dock behaviour - it can be covered by windows,
|
||||||
|
while clicking on any docked items will bring it up.
|
||||||
|
|
||||||
|
#. *Auto raise & lower* is similar for the first options, although you don't
|
||||||
|
have to click on dock - it's enough to hover mouse pointer on visible
|
||||||
|
part of dock or it's items.
|
||||||
|
|
||||||
|
#. *Keep on top* means that the dock will always be on "top" of opened
|
||||||
|
windows.
|
||||||
|
|
||||||
|
#. *Add a drawer* will add special dockapp which can be used for aggregating
|
||||||
|
applications. See `Dock <dock.html>`_ for more details about drawers.
|
||||||
|
|
||||||
|
#. "Launch" opens the application without double-clicking the icon.
|
||||||
|
|
||||||
|
#. "Bring here" unhides the application in the current workspace.
|
||||||
|
|
||||||
|
#. "Hide" hides the application or unhides it if already hidden. Unhiding opens
|
||||||
|
the application in the workspace where it is located. (This option may not
|
||||||
|
work if the application has it's own hiding menu option.)
|
||||||
|
|
||||||
|
#. "Settings" allows the modification of application path and arguments, the
|
||||||
|
command line, and the icon used.
|
||||||
|
|
||||||
|
#. "Kill" closes the application immediately and should only be used if
|
||||||
|
absolutely necessary.
|
||||||
Reference in New Issue
Block a user