From: Michael Stapelberg Date: Wed, 16 Nov 2011 00:12:45 +0000 (+0000) Subject: update userguide, add missing i3-sync images X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=f6eacac8329f6faf45d8d894fee140d9786d313e;p=i3%2Fi3.github.io update userguide, add missing i3-sync images --- diff --git a/_docs/userguide b/_docs/userguide index 3d78d16..79c97b1 100644 --- a/_docs/userguide +++ b/_docs/userguide @@ -174,7 +174,7 @@ Floating windows are always on top of tiling windows. i3 stores all information about the X11 outputs, workspaces and layout of the windows on them in a tree. The root node is the X11 root window, followed by the X11 outputs, then dock areas and a content container, then workspaces and -finally the windows themselve. In previous versions of i3 we had multiple lists +finally the windows themselves. In previous versions of i3 we had multiple lists (of outputs, workspaces) and a table for each workspace. That approach turned out to be complicated to use (snapping), understand and implement. @@ -812,7 +812,9 @@ status_command command *Example*: ------------------------------------------------- -status_command i3status --config ~/.i3status.conf +bar { + status_command i3status --config ~/.i3status.conf +} ------------------------------------------------- === Display mode @@ -834,7 +836,9 @@ mode *Example*: ---------------- -mode hide +bar { + mode hide +} ---------------- === Position @@ -850,7 +854,9 @@ position *Example*: --------------------- -position top +bar { + position top +} --------------------- === Output(s) @@ -859,6 +865,9 @@ You can restrict i3bar to one or more outputs (monitors). The default is to handle all outputs. Restricting the outputs is useful for using different options for different outputs by using multiple 'bar' blocks. +To make a particular i3bar instance handle multiple outputs, specify the output +directive multiple times. + *Syntax*: --------------- output @@ -868,18 +877,20 @@ output ------------------------------- # big monitor: everything bar { - output HDMI2 - status_command i3status + # The display is connected either via HDMI or via DisplayPort + output HDMI2 + output DP2 + status_command i3status } # laptop monitor: bright colors and i3status with less modules. bar { - output LVDS1 - status_command i3status --config ~/.i3status-small.conf - colors { - background #000000 - statusline #ffffff - } + output LVDS1 + status_command i3status --config ~/.i3status-small.conf + colors { + background #000000 + statusline #ffffff + } } ------------------------------- @@ -899,10 +910,14 @@ tray_output *Example*: ------------------------- # disable system tray -tray_output none +bar { + tray_output none +} # show tray icons on the big monitor -tray_output HDMI2 +bar { + tray_output HDMI2 +} ------------------------- === Font @@ -917,7 +932,9 @@ font *Example*: -------------------------------------------------------------- -font -misc-fixed-medium-r-normal--13-120-75-75-C-70-iso10646-1 +bar { + font -misc-fixed-medium-r-normal--13-120-75-75-C-70-iso10646-1 +} -------------------------------------------------------------- === Workspace buttons @@ -934,7 +951,9 @@ workspace_buttons *Example*: -------------------- -workspace_buttons no +bar { + workspace_buttons no +} -------------------- === Colors @@ -974,14 +993,16 @@ colors { *Example*: -------------------------------------- -colors { - background #000000 - statusline #ffffff - - focused_workspace #ffffff #285577 - active_workspace #ffffff #333333 - inactive_workspace #888888 #222222 - urgent_workspace #ffffff #900000 +bar { + colors { + background #000000 + statusline #ffffff + + focused_workspace #ffffff #285577 + active_workspace #ffffff #333333 + inactive_workspace #888888 #222222 + urgent_workspace #ffffff #900000 + } } -------------------------------------- @@ -1063,7 +1084,7 @@ exec [--no-startup-id] command bindsym mod+g exec gimp # Start the terminal emulator urxvt which is not yet startup-notification-aware -bindsym mod+enter exec --no-startup-id urxvt +bindsym mod+Return exec --no-startup-id urxvt ------------------------------ The +--no-startup-id+ parameter disables startup-notification support for this diff --git a/docs/i3-sync-working.png b/docs/i3-sync-working.png new file mode 100644 index 0000000..dce44ac Binary files /dev/null and b/docs/i3-sync-working.png differ diff --git a/docs/i3-sync.png b/docs/i3-sync.png new file mode 100644 index 0000000..b64cce2 Binary files /dev/null and b/docs/i3-sync.png differ diff --git a/docs/userguide.html b/docs/userguide.html index 5ab8111..dc26073 100644 --- a/docs/userguide.html +++ b/docs/userguide.html @@ -227,7 +227,7 @@ can also do that by using the [floating_modifier]

i3 stores all information about the X11 outputs, workspaces and layout of the windows on them in a tree. The root node is the X11 root window, followed by the X11 outputs, then dock areas and a content container, then workspaces and -finally the windows themselve. In previous versions of i3 we had multiple lists +finally the windows themselves. In previous versions of i3 we had multiple lists (of outputs, workspaces) and a table for each workspace. That approach turned out to be complicated to use (snapping), understand and implement.

@@ -905,7 +905,9 @@ have to have correct quoting etc.

Example:

-
status_command i3status --config ~/.i3status.conf
+
bar {
+    status_command i3status --config ~/.i3status.conf
+}
@@ -925,7 +927,9 @@ save battery power.

Example:

-
mode hide
+
bar {
+    mode hide
+}
@@ -940,7 +944,9 @@ save battery power.

Example:

-
position top
+
bar {
+    position top
+}
@@ -948,6 +954,8 @@ save battery power.

You can restrict i3bar to one or more outputs (monitors). The default is to handle all outputs. Restricting the outputs is useful for using different options for different outputs by using multiple bar blocks.

+

To make a particular i3bar instance handle multiple outputs, specify the output +directive multiple times.

Syntax:

@@ -958,18 +966,20 @@ options for different outputs by using multiple bar blocks.

# big monitor: everything
 bar {
-        output HDMI2
-        status_command i3status
+    # The display is connected either via HDMI or via DisplayPort
+    output HDMI2
+    output DP2
+    status_command i3status
 }
 
 # laptop monitor: bright colors and i3status with less modules.
 bar {
-        output LVDS1
-        status_command i3status --config ~/.i3status-small.conf
-        colors {
-                background #000000
-                statusline #ffffff
-        }
+    output LVDS1
+    status_command i3status --config ~/.i3status-small.conf
+    colors {
+        background #000000
+        statusline #ffffff
+    }
 }
@@ -988,10 +998,14 @@ you can turn off the functionality entirely.

# disable system tray
-tray_output none
+bar {
+    tray_output none
+}
 
 # show tray icons on the big monitor
-tray_output HDMI2
+bar { + tray_output HDMI2 +}
@@ -1006,7 +1020,9 @@ the bar.

Example:

-
font -misc-fixed-medium-r-normal--13-120-75-75-C-70-iso10646-1
+
bar {
+    font -misc-fixed-medium-r-normal--13-120-75-75-C-70-iso10646-1
+}
@@ -1022,7 +1038,9 @@ you want to display a statusline-only bar containing additional information.

Example:

-
workspace_buttons no
+
bar {
+    workspace_buttons no
+}
@@ -1099,14 +1117,16 @@ urgent_workspace

Example:

-
colors {
-    background #000000
-    statusline #ffffff
+
bar {
+    colors {
+        background #000000
+        statusline #ffffff
 
-    focused_workspace  #ffffff #285577
-    active_workspace   #ffffff #333333
-    inactive_workspace #888888 #222222
-    urgent_workspace   #ffffff #900000
+        focused_workspace  #ffffff #285577
+        active_workspace   #ffffff #333333
+        inactive_workspace #888888 #222222
+        urgent_workspace   #ffffff #900000
+    }
 }
@@ -1225,7 +1245,7 @@ searched in your $PATH.

bindsym mod+g exec gimp # Start the terminal emulator urxvt which is not yet startup-notification-aware -bindsym mod+enter exec --no-startup-id urxvt +bindsym mod+Return exec --no-startup-id urxvt

The --no-startup-id parameter disables startup-notification support for this particular exec command. With startup-notification, i3 can make sure that a