mirror of
https://github.com/gryf/window-maker.github.io.git
synced 2025-12-17 11:10:18 +01:00
Converted dock to rst, added new images, corrected content
This commit is contained in:
@@ -1,180 +0,0 @@
|
|||||||
---
|
|
||||||
layout: default
|
|
||||||
title: Guided Tour - Dock
|
|
||||||
---
|
|
||||||
|
|
||||||
<h1><strong>
|
|
||||||
<center>DOCK</center>
|
|
||||||
</strong></h1>
|
|
||||||
|
|
||||||
<h2><strong></strong></h2>
|
|
||||||
|
|
||||||
<strong></strong>
|
|
||||||
<center><a href="index.html">Back to index</a></center>
|
|
||||||
|
|
||||||
<ul>
|
|
||||||
|
|
||||||
<li><a href="dock.html#what" name="what">Application dock</a></li>
|
|
||||||
<li><a href="dock.html#start" name="start">Starting an application</a></li>
|
|
||||||
<li><a href="dock.html#cust" name="cust">Customizing</a></li>
|
|
||||||
<li><a href="dock.html#conf" name="conf">Configuring</a></li>
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<h2><a name="what">Application dock</a></h2>
|
|
||||||
|
|
||||||
|
|
||||||
<p>The dock is the column of icons located by default on the right
|
|
||||||
side of the screen.</p>
|
|
||||||
|
|
||||||
<p>Any application can be attached to the dock. To do this, open an
|
|
||||||
application then simply left-click-and-drag the application's icon to
|
|
||||||
the last position on the dock. The dock will "attract" the icon and it
|
|
||||||
will remain on the dock until removed by the user (left-click-and-drag
|
|
||||||
the icon off the dock - it will disappear.) If you have saved your
|
|
||||||
Window Maker session prior to logout (or set Window Maker to autosave
|
|
||||||
your session upon logout) any icons you docked will automatically
|
|
||||||
reappear at your next - and each subsequent - session.<br>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>The dock has it's own menu for user configuration.<br>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>The dock can be configured to remain on top of maximized windows. To
|
|
||||||
do this, right-click on any docked icon then select "Keep on top" from
|
|
||||||
the application icon menu. This will keep the entire dock visible
|
|
||||||
(maximized windows will not be allowed to cover the dock). To allow the
|
|
||||||
dock to be covered, uncheck the "Keep on top" item in the application
|
|
||||||
icon menu.<br>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>The WMDock icon (by default, with the GNUstep logo) can be dragged
|
|
||||||
sideways
|
|
||||||
to switch the
|
|
||||||
the entire dock from one side of the display to the other.<br>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>Dragging the WMDock icon downward will move the dock off the display
|
|
||||||
with the
|
|
||||||
exception of the WMDock icon itself, which will remain visible. To
|
|
||||||
restore dock visibility, left-click-and-drag the dock back on screen.<br>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<h2><a name="start">Starting an application</a></h2>
|
|
||||||
|
|
||||||
|
|
||||||
<p>Double-clicking the icon of a docked application starts the
|
|
||||||
application. <br>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>An application that has not been launched normally has an elipsis
|
|
||||||
(three dots) in the bottom-left-corner of the icon and appears in full
|
|
||||||
color as shown below. <br>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p style="text-align: center;"><img style="width: 62px; height: 62px;" alt="Unlaunched application icon" src="images/iconwithelipsis.png"><br>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>When the application is running, the elipsis disappears from the
|
|
||||||
bottom-left-corner of the icon and the icon becomes "greyed out,"
|
|
||||||
giving a visual cue that the application is already open. <br>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p style="text-align: center;"><img style="width: 62px; height: 62px;" alt="Launched application icon" src="images/greyedouticon.png"><br>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>A docked icon that continues to show an elipsis and remains "full
|
|
||||||
color" even after an instance of the
|
|
||||||
application is running indicates that the application's settings have
|
|
||||||
been modified to allow multiple launches from one docked icon. To do
|
|
||||||
this you must open the application and modify the
|
|
||||||
"application specific" settings in the <a href="win.html#menu">"commands
|
|
||||||
menu"</a> of the application to allow
|
|
||||||
"shared application icons."</p>
|
|
||||||
|
|
||||||
<p>Using the "launch" command in the "application icon menu" for the
|
|
||||||
icon is another way to start an application from the dock.<br>
|
|
||||||
<br>
|
|
||||||
From version 0.80.0 on, the dock can "steal" appicons. This feature has
|
|
||||||
nothing to
|
|
||||||
do with Autoattract Icons. When you start an application from somewhere
|
|
||||||
else
|
|
||||||
than either the clip or the dock (menu or terminal), and the appicon
|
|
||||||
exists in
|
|
||||||
one of them (clip or dock), this appicon doesn't appear at the bottom
|
|
||||||
of your
|
|
||||||
screen. The appicon existing in the clip or the dock "stole" it. As a
|
|
||||||
result, the
|
|
||||||
appicon is the same as the one used to start the application from the
|
|
||||||
clip or
|
|
||||||
the dock. </p>
|
|
||||||
|
|
||||||
<p> </p>
|
|
||||||
|
|
||||||
<h2><a name="cust">Customizing</a></h2>
|
|
||||||
|
|
||||||
|
|
||||||
<p>Left-clicking and dragging an application icon to the dock adds this
|
|
||||||
application to the dock. Obviously, this means the application is
|
|
||||||
running! <br>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p><span style="font-style: italic;">Miniwindows</span> (windows of
|
|
||||||
minimized applications) cannot be docked. The small titlebar on the
|
|
||||||
miniwindow differentiates it from an application's icon. <br>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>Dragging an icon off the dock removes the docked application. <br>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p> </p>
|
|
||||||
|
|
||||||
<h2><a name="conf">Configuring</a></h2>
|
|
||||||
|
|
||||||
|
|
||||||
<p>There is a dock menu for each icon. Right-clicking the icon displays
|
|
||||||
the "application icon menu." Select the "Settings..." option to
|
|
||||||
configure the application. </p>
|
|
||||||
|
|
||||||
<center>
|
|
||||||
<p><a href="images/docks.jpg"><img src="images/docks.jpg" alt="dock"></a></p>
|
|
||||||
</center>
|
|
||||||
|
|
||||||
<p>The application's <span style="font-style: italic;">path</span> and
|
|
||||||
its arguments, the command for middle-click launch, and the icon
|
|
||||||
employed can
|
|
||||||
be changed in this panel.<br>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>Shell commands such as redirection cannot be used in the command
|
|
||||||
field. <br>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>The desired icon must be in one of the directories displayed
|
|
||||||
in the panel while browsing. New directories can be added from the <a href="prefs.html#search">Search path preferences</a><br>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p> A checkbox allows you to start the application when Window Maker is
|
|
||||||
first started. (Note: <span style="font-style: italic;">You want to be
|
|
||||||
careful with this</span>. If you have, for example, your terminal
|
|
||||||
emulator, your file manager, and your browser set to start when Window
|
|
||||||
Maker is started you'll get an open terminal, an open file manager and
|
|
||||||
an open browser <span style="font-style: italic;">every time</span>
|
|
||||||
you start a session! Normally you will only want to start certain
|
|
||||||
dockapps - "regular" applications like a terminal emulator or browser
|
|
||||||
can be started <span style="font-style: italic;">after</span> your
|
|
||||||
session is up and going.)<br>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>From version 0.62.0 on, a checkbox can be used to prevent accidental
|
|
||||||
removal from the dock. <br>
|
|
||||||
<br>
|
|
||||||
From version 0.70.0 on, a new field has been added for middle-click
|
|
||||||
launch. Entering, for example, "firefox" into a docked
|
|
||||||
application
|
|
||||||
settings panel will launch the Firefox browser.<br>
|
|
||||||
<br>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p> </p>
|
|
||||||
|
|
||||||
<center><a href="index.html">Back to index</a></center>
|
|
||||||
135
docs/guidedtour/dock.rst
Normal file
135
docs/guidedtour/dock.rst
Normal file
@@ -0,0 +1,135 @@
|
|||||||
|
---
|
||||||
|
layout: default
|
||||||
|
title: Guided Tour - Dock
|
||||||
|
---
|
||||||
|
|
||||||
|
Dock
|
||||||
|
====
|
||||||
|
|
||||||
|
.. contents::
|
||||||
|
:backlinks: none
|
||||||
|
|
||||||
|
Application dock
|
||||||
|
----------------
|
||||||
|
|
||||||
|
The dock is the column of icons located by default on the right side of the
|
||||||
|
screen.
|
||||||
|
|
||||||
|
Any application can be attached to the dock. To do this, open an application
|
||||||
|
then simply left-click-and-drag the application's icon to the last position on
|
||||||
|
the dock. The dock will "attract" the icon and it will remain on the dock until
|
||||||
|
removed by the user (left-click-and-drag the icon off the dock - it will
|
||||||
|
disappear.) If you have saved your Window Maker session prior to logout (or set
|
||||||
|
Window Maker to autosave your session upon logout) any icons you docked will
|
||||||
|
automatically reappear at your next - and each subsequent - session.
|
||||||
|
|
||||||
|
The dock can be configured to remain on top of maximized windows. To do this,
|
||||||
|
right-click on a dock or any docked icon then select appropriate option form
|
||||||
|
*Dock position* submenu. Consult `Application icon menu
|
||||||
|
<menu.html#application-icon-menu>`_ for details.
|
||||||
|
|
||||||
|
The WMDock icon (by default, with the GNUstep logo) can be dragged sideways to
|
||||||
|
switch the the entire dock from one side of the display to the other.
|
||||||
|
|
||||||
|
Dragging the WMDock icon downward will move the dock off the display with the
|
||||||
|
exception of the WMDock icon itself, which will remain visible. To restore dock
|
||||||
|
visibility, left-click-and-drag the dock back on screen.
|
||||||
|
|
||||||
|
Starting an application
|
||||||
|
-----------------------
|
||||||
|
|
||||||
|
Double-clicking the icon of a docked application starts the application.
|
||||||
|
|
||||||
|
An application that has not been launched normally has an elipsis (three dots)
|
||||||
|
in the bottom-left-corner of the icon and appears in full color as shown below.
|
||||||
|
|
||||||
|
.. figure:: images/unlaunched_app.png
|
||||||
|
:alt: Unlaunched application icon
|
||||||
|
:figclass: borderless
|
||||||
|
|
||||||
|
Unlaunched application icon
|
||||||
|
|
||||||
|
When the application is running, the elipsis disappears from the
|
||||||
|
bottom-left-corner of the icon and the icon becomes highlited.
|
||||||
|
|
||||||
|
.. figure:: images/launched_app.png
|
||||||
|
:alt: Launched application icon
|
||||||
|
:figclass: borderless
|
||||||
|
|
||||||
|
Launched application icon
|
||||||
|
|
||||||
|
Sometimes, when the application is running, instead of highlited icon, the icon
|
||||||
|
becomes "greyed out", giving a visual cue that the application is already open,
|
||||||
|
and cannot be launched again.
|
||||||
|
|
||||||
|
.. figure:: images/grayed_out_icon.png
|
||||||
|
:alt: Launched application icon
|
||||||
|
:figclass: borderless
|
||||||
|
|
||||||
|
Grayed-out application icon
|
||||||
|
|
||||||
|
A docked icon that continues to show an elipsis and remains "full color" even
|
||||||
|
after an instance of the application is running indicates that the
|
||||||
|
application's settings have been modified to allow multiple launches from one
|
||||||
|
docked icon. To do this you must open the application and modify the
|
||||||
|
"application specific" settings in the `commands menu <win.html#menu>`_ of the
|
||||||
|
application to allow "shared application icons".
|
||||||
|
|
||||||
|
Using the "launch" command in the "application icon menu" for the icon is
|
||||||
|
another way to start an application from the dock.
|
||||||
|
|
||||||
|
From version 0.80.0 on, the dock can "steal" appicons. This feature has nothing
|
||||||
|
to do with Autoattract Icons. When you start an application from somewhere else
|
||||||
|
than either the clip or the dock (menu or terminal), and the appicon exists in
|
||||||
|
one of them (clip or dock), this appicon doesn't appear at the bottom of your
|
||||||
|
screen. The appicon existing in the clip or the dock "stole" it. As a result,
|
||||||
|
the appicon is the same as the one used to start the application from the clip
|
||||||
|
or the dock.
|
||||||
|
|
||||||
|
Customizing
|
||||||
|
-----------
|
||||||
|
|
||||||
|
Left-clicking and dragging an application icon to the dock adds this
|
||||||
|
application to the dock. Obviously, this means the application is running!
|
||||||
|
|
||||||
|
*Miniwindows* (windows of minimized applications) cannot be docked. The small
|
||||||
|
titlebar on the miniwindow differentiates it from an application's icon.
|
||||||
|
|
||||||
|
Dragging an icon off the dock removes the docked application.
|
||||||
|
|
||||||
|
Configuring
|
||||||
|
-----------
|
||||||
|
|
||||||
|
There is a dock menu for each icon. Right-clicking the icon displays the
|
||||||
|
"application icon menu". Select the "Settings..." option to configure the
|
||||||
|
application.
|
||||||
|
|
||||||
|
.. figure:: images/docked_application_settings.png
|
||||||
|
:alt: Launched application icon
|
||||||
|
:figclass: borderless
|
||||||
|
|
||||||
|
Launched application icon
|
||||||
|
|
||||||
|
The application's *path* and its arguments, the command for middle-click
|
||||||
|
launch, and the icon employed can be changed in this panel.
|
||||||
|
|
||||||
|
Shell commands such as redirection cannot be used in the command field.
|
||||||
|
|
||||||
|
The desired icon must be in one of the directories displayed in the panel while
|
||||||
|
browsing. New directories can be added from the `Search path preferences
|
||||||
|
<prefs.html#search-path>`_.
|
||||||
|
|
||||||
|
A checkbox allows you to start the application when Window Maker is first
|
||||||
|
started. (Note: *You want to be careful with this*. If you have, for example,
|
||||||
|
your terminal emulator, your file manager, and your browser set to start when
|
||||||
|
Window Maker is started you'll get an open terminal, an open file manager and
|
||||||
|
an open browser *every time* you start a session! Normally you will only want
|
||||||
|
to start certain dockapps - "regular" applications like a terminal emulator or
|
||||||
|
browser can be started *after* your session is up and going.)
|
||||||
|
|
||||||
|
From version 0.62.0 on, a checkbox can be used to prevent accidental
|
||||||
|
removal from the dock.
|
||||||
|
|
||||||
|
From version 0.70.0 on, a new field has been added for middle-click launch.
|
||||||
|
Entering, for example, "firefox" into a docked application settings panel will
|
||||||
|
launch the Firefox browser.
|
||||||
BIN
docs/guidedtour/images/docked_application_settings.png
Normal file
BIN
docs/guidedtour/images/docked_application_settings.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 25 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 33 KiB |
BIN
docs/guidedtour/images/grayed_out_icon.png
Normal file
BIN
docs/guidedtour/images/grayed_out_icon.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 3.0 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 3.3 KiB |
BIN
docs/guidedtour/images/launched_app.png
Normal file
BIN
docs/guidedtour/images/launched_app.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 3.7 KiB |
BIN
docs/guidedtour/images/unlaunched_app.png
Normal file
BIN
docs/guidedtour/images/unlaunched_app.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 3.1 KiB |
Reference in New Issue
Block a user