mirrors/wmii
1
0
Fork 0
mirror of https://github.com/0intro/wmii synced 2024-11-22 05:42:05 +03:00
Code Issues Packages Projects Releases Wiki Activity

Added a chapter "Changing the looks", improved the "audience" chapter, corrected keybindings, added copyright information

Browse Source
This commit is contained in:
stepardo 2006-04-19 21:14:20 +01:00
parent 917aff947c
commit 43ee717835
1 changed files with 94 additions and 30 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

124
doc/guide_en.tex
View File

@ -1,5 +1,5 @@
%guide to wmii-3
%Copyright (C) 2005, 2006 by Steffen Liebergeld, Salva Peiro
%Copyright (C) 2005, 2006 by Steffen Liebergeld, Salva Peir\'o
%This program is free software; you can redistribute it and/or
%modify it under the terms of the GNU General Public License
@ -39,18 +39,16 @@
\setlength{\parskip}{0pt}}
{\end{itemize}}
\date{\today}
\author{
Steffen \\ Liebergeld \\ \emph{author}
\and
Salvador \\ Peir\'o \\ \emph{inquisitor}
\author{
Steffen\\Liebergeld \\\\
\small{with help from}\\
Salvador\\Peir\'o
}
\title{A Guide to wmii-3%
\thanks{This work was partly funded by the EEE \emph{(European Easter's Egg)}
commission. thanks to the wmii community in particular all the people in the Credits section} \\
\small{(\emph{when did wmii got lost?})}
\thanks{Thanks to the wmii community in particular all the people in the Credits section}
}
%\email{stepardo@gmail.com et saoret.one@gmail.com}
%\email{stepardo@gmail.com \and saoret.one@gmail.com}
\begin{document}
@ -62,6 +60,11 @@ commission. thanks to the wmii community in particular all the people in the Cre
\section{Abstract}
\subsection{Who brought this to you}
This guide was written by Steffen Liebergeld, who got lots of help
from Salvador Peir\'o and a patch from Jochen Schwartz.
\subsection{The purpose of this document}
This document tries to be a good starting point for people new to
@ -93,12 +96,21 @@ commission. thanks to the wmii community in particular all the people in the Cre
\subsection{Target audience}
I presume the reader already has experience with Unix, knows all
the basic terminology and concepts like files or editors. It is
helpful if you know what a socket and a network protocol is.
the basic terminology and concepts like files or editors.
I hope you are open minded against new ideas, and willing to spend
some time learning it~\footnote{remember the refrain:
\emph{``nobody can teach you what you don't want to know''.}}.
some time learning it~\footnote{remember the refrain: ``nobody can
teach you what you don't want to know''.}.
If you only want to know how to operate wmii-3 and are not
interested in the inner workings or in scripting, you may read the
chapters ``Configuration and install'', ``Terminology'' and
``First steps'' and skip the rest.
However, to get the most out of wmii-3 you should possibly read
the whole document. Another possibility is to read the
introductory chapters first, use some time to get settled in the
wmii-world and read the scripting chapters later on.
\section{Configuration and install}
@ -325,7 +337,7 @@ commission. thanks to the wmii community in particular all the people in the Cre
It should be clear, that you really need at least two clients to
have two columns.
If you press \emph{MOD-k} to change focus, you will see that wmii
If you press \emph{MOD-j} to change focus, you will see that wmii
actually cycles the focus in the current column only. That is why
you need commands to change the current column.
@ -350,12 +362,12 @@ commission. thanks to the wmii community in particular all the people in the Cre
\emph{MOD-s}. As you see now, there in only one client using as
much space as possible, whereas you only see the title-bars of the
other clients in the column. You may still switch between the
clients in the column using \emph{MOD-Tab}.
clients in the column using \emph{MOD-j}.
The third layout is the max-layout, which maximises all the
clients to use all the space in the column each. Only the focused
client is visible and the other are hidden behind. You may still
switch between those clients with \emph{MOD-Tab}.
switch between those clients with \emph{MOD-j}.
\subsection{Float pages}
@ -371,7 +383,7 @@ commission. thanks to the wmii community in particular all the people in the Cre
fashioned programs rely on the old window managing concept, where
all the clients fly around on the desktop and the user has to tell
them where to stay. We have the term floating windows for this
pragma.
rule.
To come to the point: wmii also allows you to use floating
clients. You may enable floating mode for a window by focusing it
@ -379,8 +391,8 @@ commission. thanks to the wmii community in particular all the people in the Cre
(the column it came from) by pressing \emph{MOD-Shift-Space}.
As a side note, this floating mode is actually the zeroth column
internally. You will see later on why this was implemented this
way.
internally. That is why there is not much special internal
handling needed.
\subsection{Tags}
@ -579,11 +591,11 @@ commission. thanks to the wmii community in particular all the people in the Cre
your local copy will be executed instead.
This works because in the \emph{wmii} launcher script alters and
exports the variable \verb+\${}PATH+ as\\
\verb+\${}PATH=\~{}/.wmii-3:\${}CONFPREFIX/wmii:\${}PATH+ before
exports the variable \verb+$PATH+ as\\
\verb+$PATH=~/.wmii-3:$CONFPREFIX/wmii:$PATH+ before
launching the wmiiwm, this way local user actions under
\verb+~/.wmii-3+ take precedence over the defaults from
\verb+\${}CONFPREFIX/wmii+ of the default actions.
\verb+$CONFPREFIX/wmii+ of the default actions.
You may edit this file on the fly, which means you don't need to
stop wmii before editing. After you've finished editing, you may
@ -607,6 +619,34 @@ commission. thanks to the wmii community in particular all the people in the Cre
the \emph{hjkl} vim home row) this is probably the place to look
at.
\subsection{Changing the looks}
The look of wmii-3 is determined by colours only. And because we
wanted small and unimportant things to be as unobstrusive as
possible, we used another virtue of unix: \emph{Environment
variables}.
\begin{verbatim}
WMII_SELCOLORS='#000000 #eaffff #8888cc'
WMII_NORMCOLORS='#000000 #ffffea #bdb76b'
WMII_FONT=static
\end{verbatim}
\verb+WMII_SELCOLORS+ define the colours of the selected clients
window title and border, whereas \verb+WMII_NORMCOLORS+ defines
the colours of all the other clients. The numbers are hexadecimal
rgb, which you might know from html. You might get them with the
Gimps colour-chooser.
The definitions are as follows: the first is the colour of the
strings in bars and menus. The second is the main colour of bars
borders, whereas the third defines the borders and is used for the
3d-effects of title-bars and menus.
\verb+WMII_FONT+ accepts font names or full font strings, which
you might get from xfontsel. It defines the font to be used in
titlebars, status-bar and in wmiimenu.
\subsection{Filling the status-bar}
\label{subsec:status}
@ -696,17 +736,22 @@ commission. thanks to the wmii community in particular all the people in the Cre
\begin{verbatim}
echo -n web code | wmiir write /view/sel/sel/tags
\end{verbatim}
\end{verbatim}
This command would give the current focused client the tags
``web'' and ``code''.
This command would give the current focused client the tags
``web'' and ``code''.
You may now go to the new view web by executing the following:
You may now go to the new view web by executing the following:
\begin{verbatim}
echo -n view web | wmiir write /ctl
\end{verbatim}
\begin{verbatim}
echo -n view web | wmiir write /ctl
\end{verbatim}
As the development of wmii-3 prograssed, it became clear that this
action is so common, that it got its own keybinding. By default
\emph{MOD-t} brings up a menu to choose a view and
\emph{MOD-Shift-t} brings up a menu enabling you to assign new
tags to the focused client.
\section{The End}
@ -727,6 +772,25 @@ commission. thanks to the wmii community in particular all the people in the Cre
up learning a lot and if in the end it's wrong you'll provide
better feedback to solve the issue.
\newpage
\section{Copyright notice}
guide to wmii-3\\
Copyright (C) 2005, 2006 by Steffen Liebergeld, Salva Peir\'o
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, version 2
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
02110-1301, USA.
\end{document}