Description

Synopsis

# Usage

This module contains example Groups-based layouts. You can either import this module directly, or look at its source for ideas of how XMonad.Layout.Groups may be used.

You can use the contents of this module by adding

import XMonad.Layout.Groups.Examples

to the top of your ./.xmonad/xmonad.hs.

For more information on using any of the layouts, jump directly to its "Example" section.

Whichever layout you choose to use, you will probably want to be able to move focus and windows between groups in a consistent manner. For this, you should take a look at the functions from the XMonad.Layout.Groups.Helpers module, which are all re-exported by this module.

# Example: Row of columns

A layout that arranges windows in a row of columns. It uses ZoomRows for both, allowing you to:

• Freely change the proportion of the screen width allocated to each column
• Freely change the proportion of a column's heigth allocated to each of its windows
• Set a column to occupy the whole screen space whenever it has focus
• Set a window to occupy its whole column whenever it has focus

to use this layout, add rowOfColumns to your layout hook, for example:

myLayout = rowOfColumns

To be able to change the sizes of columns and windows, you can create key bindings for the relevant actions:

((modMask, xK_minus), zoomWindowOut)

and so on.

Increase the width of the focused column

Decrease the width of the focused column

Reset the width of the focused column

Toggle whether the currently focused column should take up all available space whenever it has focus

Increase the heigth of the focused window

Decrease the height of the focused window

Reset the height of the focused window

Toggle whether the currently focused window should take up the whole column whenever it has focus

# Example: Tiled tab groups

A layout which arranges windows into tabbed groups, and the groups themselves according to XMonad's default algorithm (Tall ||| Mirror Tall ||| Full). As their names indicate, tallTabs starts as Tall, mirrorTallTabs starts as Mirror Tall and fullTabs starts as Full, but in any case you can freely switch between the three afterwards.

You can use any of these three layouts by including it in your layout hook. You will need to provide it with a TiledTabsConfig containing the size parameters for Tall and Mirror Tall, and the shrinker and decoration theme for the tabs. If you're happy with defaults, you can use def:

myLayout = tallTabs def

To be able to increase/decrease the number of master groups and shrink/expand the master area, you can create key bindings for the relevant actions:

((modMask, xK_h), shrinkMasterGroups)

and so on.

Configuration data for the "tiled tab groups" layout

Constructors

 TTC FieldsvNMaster :: Int vRatio :: Rational vIncrement :: Rational hNMaster :: Int hRatio :: Rational hIncrement :: Rational tabsShrinker :: s tabsTheme :: Theme

Instances

 Source # Methods

def :: Default a => a #

The default value for this type.

Increase the number of master groups by one

Decrease the number of master groups by one

Shrink the master area

Expand the master area

Rotate the available outer layout algorithms

# Useful re-exports and utils

The default xmonad Theme.

data GroupEQ a Source #

Compare two Groups by comparing the ids of their layouts.

Constructors

 GroupEQ

Instances

 Eq a => EQF GroupEQ (Group l a) Source # Methodseq :: GroupEQ (Group l a) -> Group l a -> Group l a -> Bool Source # Read (GroupEQ a) Source # MethodsreadsPrec :: Int -> ReadS (GroupEQ a) # Show (GroupEQ a) Source # MethodsshowsPrec :: Int -> GroupEQ a -> ShowS #show :: GroupEQ a -> String #showList :: [GroupEQ a] -> ShowS #

zoomRowG :: (Eq a, Show a, Read a, Show (l a), Read (l a)) => ZoomRow GroupEQ (Group l a) Source #