wmii/rc/welcome

67 lines
3.1 KiB
Bash

#!9PREFIX/bin/rc
# display a welcome message that contains the wmii tutorial
xmessage -file - <<END
Welcome to wmii, the non-wimp environment of the WMI Project.
This is a small step by step tutorial, intended to make you a little bit
familiar with wmii.
NOTE: Some characters in shortcuts have a special meaning. S is the Shift
key, C is the Ctrl key, M is the Meta key (usually Alt), and the hyphen means
that you have to press the surrounding keys at the same time.
Let's go!
- Start two xterms by pressing M-t twice.
- Switch between the three windows: M-j, M-k
You can also use M-Tab instead of M-j. If you prefer the mouse, then
just click the desired window.
- Create a new page: M-C-y
IMPORTANT: this text will then no longer be visible. In order to continue
reading you'll now often have to go back to the first page. Use M-h
or M-l for cycling through the existing pages. The digit in the left
corner at the bottom indicates which page you're on. You can directly
select a specific page as well: M-S-1, etc. Make sure that you are on the
second page before performing the next steps.
- Apply the float layout to the current page: M-S-f
Watch the leftmost bar label: the 't', which stood for 'tiled', has now
turned into an 'f', for 'float'.
- Open the programs menu: M-C-p
Type 'xclock' and press Enter.
- Resize the xclock window: left-click on the border and, while holding the
button down, move the cursor around.
- Move the xclock window: left-click on the title bar and, while holding
the button down, move the cursor around.
- Open the actions menu: M-C-a
Remove the current page by selecting the rmpage action. The xclock window
will be automatically detached and we'll land on the first page.
- Attach the xclock window again: M-a
- Select one of the terminals and close it: M-C-c
Close xclock as well.
- Swap the remaining terminal with the left master tile by moving the terminal
window somewhere to the left. Afterwards, swap them once again, but this
time by pressing M-Enter.
- Working with mouse efficiently:
selecting a window: just click the desired window
move a window : press M+Button1Press and move the window
resize a window (only with non managed): press M+Button3Press and resize it
(this can also be done by clicking the titlebar of the window/borders respectively)
- We'll now have a look at the internal filesystem used by wmii. Executing
wmiir read /
in the shell of the terminal will list all the files in the root directory.
Files ending with a slash are directories. As you can see, / contains a
"normal" file and four directories. These directories correspond to the
four main components of wmii: wmiiwm, wmiibar, wmiikeys, and wmiimenu. If you
are curious, you can now dig deeper into the directory trees. For instance,
wmiir read /bar/1/b1press
will show you which command gets executed when you left-click on the page
label in the bar.
We hope that these steps gave you an idea of how wmii works. You can reread
them at any time by pressing M-C-a and selecting 'welcome'.
You should now take a look at the wmii(1) man page. An FAQ is available on
<http://wmii.de>.
END