wmii/rc/welcome
2005-11-18 17:54:58 +02:00

66 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 the wmii window manager.
NOTE: Some characters in the shortcuts that are mentioned in the following
text 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 a terminal by pressing M-t. This assumes that you have xterm(1)
installed.
- Open the actions menu: C-M-a
Type 'term' and press Enter. You've now used wmimenu(1) to accomplish what
wmikeys(1) did before when you pressed M-t: executing the term action.
Notice how the tiled layout arranges the windows.
- 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 move the pointer above the desired window; no click is required.
- Create a new page: C-M-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-1, etc. Make sure that you are on the
second page before performing the next steps.
- Apply the float layout to the current page: S-M-f
Watch the leftmost bar label: the 't', which stood for 'tiled', has now
turned into an 'f', for 'float'.
- Open the programs menu: C-M-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.
- Remove the current page by opening the actions menu and selecting the premove
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: C-M-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-return.
- We'll now have a look at the internal filesystem used by wmii. Executing
wmir 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, wmibar, wmikeys, and wmimenu. If you
are curious, you can now dig deeper into the directory trees. For instance,
wmir 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. Of course, there
is much more to say. You should now read the wmii(1) man page and the FAQ at
<http://wmii.de>.
END