diff --git a/pages/docs/manuals/v1.2.0/_index.md b/pages/docs/manuals/v1.2.0/_index.md
index c1630ca..36abcb8 100644
--- a/pages/docs/manuals/v1.2.0/_index.md
+++ b/pages/docs/manuals/v1.2.0/_index.md
@@ -12,23 +12,26 @@ sectionNavURL = "/docs/manuals/v1.2.0"
Welcome to the MyPaint v1.2.0 User manual. Here you can learn the broad strokes of how MyPaint works.
# User Interface
-When MyPaint is first opened, you'll see a single window appear with not much in it. In the centre, there's a plain
-off-white paper background where you can draw. At the top, there are toolbars and menus. At the bottom, there's a status
-bar with some buttons and indicators clustered in the corners.
+When MyPaint is first opened, a single relatively sparse window will appear. At the centre, there's a plain off-white
+background where you can draw (the **canvas**). At the top, there are toolbars and menus. At the bottom, there's a
+status bar with some buttons and indicators clustered in the corners.
{{< img src="mypaint-window-new.jpg" caption="A fresh installation of MyPaint" >}}
{{< img src="mypaint-window-in-use.jpg" caption="MyPaint's user interface adapts to meet your needs">}}
-With a bit of customization you can set up sidebars full of dockable panels and palettes. You can make the MyPaint use
-the full screen area too, and tell it to hide the controls while you're working.
+MyPaint can be customised with dockable panels and palettes, all hideable while you work.
-## More Information
-- [Main Toolbar]({{< relref "ui/main-toolbar" >}})
-- [UI Toolbar]({{< relref "ui/ui-toolbar" >}})
-- [Footer bar]({{< relref "ui/footer-bar" >}})
-- Dockable panels
-- [Fullscreen mode]({{< relref "ui/fullscreen" >}})
+## Read more
+To learn more about MyPaint's user interface, refer to these pages:
+
+{{< flex grow="true" >}}
+ {{< button content="Main Toolbar" href="ui/main-toolbar" >}}
+ {{< button content="UI Toolbar" href="ui/ui-toolbar" >}}
+ {{< button content="Footer Bar" href="ui/footer-bar" >}}
+ {{< button content="Dockable Panels" href="./panels" >}}
+ {{< button content="Fullscreen Mode" href="ui/fullscreen" >}}
+{{< /flex >}}
# Tools
## Anatomy of a stroke
diff --git a/pages/docs/manuals/v1.2.0/colour/_index.md b/pages/docs/manuals/v1.2.0/colour/_index.md
index a97b4d9..721f5fb 100644
--- a/pages/docs/manuals/v1.2.0/colour/_index.md
+++ b/pages/docs/manuals/v1.2.0/colour/_index.md
@@ -1,5 +1,6 @@
+++
title = "Colour"
+weight = 50
+++
MyPaint uses only one active colour (no foreground/background). However, the colour previews will display two colours while you adjust the colour: The old colour and the new colour with changes.
diff --git a/pages/docs/manuals/v1.2.0/paint-modes.md b/pages/docs/manuals/v1.2.0/paint-modes.md
index 8f3d6ce..bd230ff 100644
--- a/pages/docs/manuals/v1.2.0/paint-modes.md
+++ b/pages/docs/manuals/v1.2.0/paint-modes.md
@@ -1,5 +1,6 @@
+++
title = "Paint Modes"
+weight = 30
+++
_Paint modes_, also known as _brush blend modes_, change the way that the brush applies paint. They affect every kind of drawing and painting tool where you use the brush to apply paint. MyPaint's paint modes track the current brush, so if you choose an eraser preset from a brush group panel, you will see the Eraser symbol on the toolbar light up.
diff --git a/pages/docs/manuals/v1.2.0/panels/_index.md b/pages/docs/manuals/v1.2.0/panels/_index.md
index 21d0632..4240170 100644
--- a/pages/docs/manuals/v1.2.0/panels/_index.md
+++ b/pages/docs/manuals/v1.2.0/panels/_index.md
@@ -1,5 +1,6 @@
+++
title = "Dockable Panels"
+weight = 40
+++
* [[HCY Wheel and Gamut Mask Editor|v1.2 HCY Wheel and Gamut Mask Editor]]
diff --git a/pages/docs/manuals/v1.2.0/popups/brush-groups.md b/pages/docs/manuals/v1.2.0/popups/brush-groups.md
new file mode 100644
index 0000000..5023f4f
--- /dev/null
+++ b/pages/docs/manuals/v1.2.0/popups/brush-groups.md
@@ -0,0 +1,6 @@
++++
+title = "Brush Group Panel"
+tags = "Incomplete"
++++
+
+TBD
diff --git a/pages/docs/manuals/v1.2.0/colour/selector-popup.md b/pages/docs/manuals/v1.2.0/popups/colour-selector.md
similarity index 100%
rename from pages/docs/manuals/v1.2.0/colour/selector-popup.md
rename to pages/docs/manuals/v1.2.0/popups/colour-selector.md
diff --git a/pages/docs/manuals/v1.2.0/preferences/_index.md b/pages/docs/manuals/v1.2.0/preferences/_index.md
index d6f94b1..46668cd 100644
--- a/pages/docs/manuals/v1.2.0/preferences/_index.md
+++ b/pages/docs/manuals/v1.2.0/preferences/_index.md
@@ -1,6 +1,7 @@
+++
title = "Preferences"
summary = "A description of MyPaint's configurable preferences"
+weight = 60
+++
The Preferences Window gives you options to configure MyPaint's appearance, input, keyboard shortcuts and many other settings. Open the Preferences Window by
diff --git a/pages/docs/manuals/v1.2.0/tools/_index.md b/pages/docs/manuals/v1.2.0/tools/_index.md
index 93cce3a..8247f66 100644
--- a/pages/docs/manuals/v1.2.0/tools/_index.md
+++ b/pages/docs/manuals/v1.2.0/tools/_index.md
@@ -1,4 +1,5 @@
+++
title = "Tools"
summmary = "A list of MyPaint's tools"
+weight = 20
+++
diff --git a/pages/docs/manuals/v1.2.0/tools/colour-picker.md b/pages/docs/manuals/v1.2.0/tools/colour-picker.md
index 266b48a..577df7d 100644
--- a/pages/docs/manuals/v1.2.0/tools/colour-picker.md
+++ b/pages/docs/manuals/v1.2.0/tools/colour-picker.md
@@ -1,5 +1,5 @@
+++
-title = "Colour Picker Tool"
+title = "Colour Picker"
tags = "Incomplete"
+++
diff --git a/pages/docs/manuals/v1.2.0/tools/stroke-layer-picker.md b/pages/docs/manuals/v1.2.0/tools/stroke-layer-picker.md
new file mode 100644
index 0000000..32de707
--- /dev/null
+++ b/pages/docs/manuals/v1.2.0/tools/stroke-layer-picker.md
@@ -0,0 +1,6 @@
++++
+title = "Stroke & Layer Picker"
+tags = "Incomplete"
++++
+
+TBD.
diff --git a/pages/docs/manuals/v1.2.0/ui/_index.md b/pages/docs/manuals/v1.2.0/ui/_index.md
index 7ffecd4..09f14b5 100644
--- a/pages/docs/manuals/v1.2.0/ui/_index.md
+++ b/pages/docs/manuals/v1.2.0/ui/_index.md
@@ -1,4 +1,6 @@
+++
title = "User Interface"
-summary = "This page provides an overview of the layout and details in MyPaint's UI"
+weight = 10
+++
+
+This page provides an overview of the layout and details in MyPaint's UI
diff --git a/pages/docs/manuals/v1.2.0/ui/footer-bar.md b/pages/docs/manuals/v1.2.0/ui/footer-bar.md
deleted file mode 100644
index a845b37..0000000
--- a/pages/docs/manuals/v1.2.0/ui/footer-bar.md
+++ /dev/null
@@ -1,60 +0,0 @@
-+++
-title = "Footer bar"
-summary = "A description of the strip of UI features at the bottom of the main window"
-+++
-
-The *Footer Bar* is the entire strip at the bottom of the [[main window|v1.2 User Interface]]. It consists of a status bar, and clusters of controls for changing the brush and colour used for painting.
-
-* [Status bar](#status-bar)
-* [Brush controls](#brush-controls)
-* [Colour controls](#colour-controls)
-
-#### Status bar
-
-
-
-The status bar at the bottom of the main window shows the current tool, and also the canvas's zoom and rotation.
-
-#### Colour controls
-
-
-
-The colour controls are clustered into the bottom left of the footer bar. You can change the painting colour here, pick a colour off the canvas, or bookmark the current colour to the palette.
-
-* **Eye Dropper** button _:new: Since_ MyPaint _1.2.0_
- * Lets you quickly pick a colour to paint with from the canvas.
- * The R key, and pressing ALT+LMB offer similar functionality.
- * Main article: [[v1.2 Pick Colour]]
-* **Current and Previous Colour** indicator and menu (_Colour → Change Colour…_, or press C.)
- * These two coloured rectangles show the current brush colour, and the colour previously painted with.
- * Click the left-hand (current colour) swatch for a pop-up menu full of colour selectors.
- * The popup menu is the one revealed by the C key.
- * Click the right-hand (previous colour) swatch to revert back to that colour.
- * Main article: [[v1.2 Colour Selector Popup]]
-* **Edit Colour Details** button
- * Opens the Set Current Colour popup window
- * Change the numeric values of the current colour
- * Main article: [[v1.2 Numeric Colour values]]
-* **Add Colour to Palette** button (_Colour → Add Colour to Palette_)
- * Click this to add the current brush colour to the palette.
- * The palette will open in a sidebar panel if it isn't already open.
- * Main article: [[v1.2 Palette]]
-
-#### Brush controls
-
-
-
-The brush controls are clustered into the bottom right of the footer bar. You can change your brush here, or pick a brush and layer from the canvas to continue work there.
-
-* **Current Brush** indicator and menu _(Brush → Change Brush…, or press B.)_
- * Shows the current brush's icon.
- * Click the icon to reveal a pop-up menu from which every brush group is available.
- * The popup menu is the one revealed by the B key.
- * Main article: [[v1.2 Brush groups]]
-* **Pick Stroke and Layer** button
- * Allows you to pick a brushstroke from the screen.
- * If the stroke is on a different layer, _MyPaint_ will switch to that layer.
- * Invisible and locked layers (and their brushstrokes) can't be picked this way.
- * Not every kind of image has a strokemap.
- * The W key offers similar functionality.
- * Main article: [[v1.2 Pick Stroke and Layer]]
diff --git a/pages/docs/manuals/v1.2.0/ui/footer-bar/index.md b/pages/docs/manuals/v1.2.0/ui/footer-bar/index.md
new file mode 100644
index 0000000..15a9c36
--- /dev/null
+++ b/pages/docs/manuals/v1.2.0/ui/footer-bar/index.md
@@ -0,0 +1,53 @@
++++
+title = "Footer bar"
+summary = "A description of the strip of UI features at the bottom of the main window"
+weight = 30
++++
+
+The **Footer Bar** is a strip comprising the bottom of the [main window]({{< relref "../#user-interface" >}}). It
+consists of a status bar, and two clusters of controls for changing the brush and colour.
+
+# Status bar
+{{< img src="mypaint-footer-bar-status.jpg" width="100%" >}}
+
+The status bar at the bottom of the main window shows the current tool, and also the canvas's zoom and rotation.
+
+# Colour controls
+
+{{< img src="mypaint-footer-bar-colour.jpg" float="right" >}}
+
+The colour controls are clustered on the left side of the footer bar.
+
+**Eyedropper** button
+> R, and ALT+LMB
+- Pick a colour from the canvas. [Read more]({{< relref "../tools/colour-picker" >}})
+
+**Current and Previous Colour** indicator and menu
+> *Colour → Change Colour…*, or C.
+- A rectangle consisting of two sides (swatches). The left swatch shows the current brush colour, the right swatch shows
+the previous colour.
+- Clicking the left swatch (current colour) opens the colour selector popup. [Read more]({{< relref "../popups/colour-selector" >}})
+- Clicking the right swatch (previous colour) reverts the brush to the previous colour.
+
+**Edit Colour Details** button
+- Open the *Set Current Colour* popup window for inputting numeric colour values. [Read more]({{< relref "../colour/numeric-values" >}})
+
+**Add Colour to Palette** button
+> *Colour → Add Colour to Palette*
+- Adds the current brush colour to the palette. The palette will open in a sidebar panel if it isn't already open. [Read
+more]({{< relref "../panels/palette" >}})
+
+# Brush controls
+{{< img src="mypaint-footer-bar-brush.jpg" float="right" >}}
+
+The brush controls are clustered on the right side of the footer bar.
+
+**Current Brush** indicator and menu
+> *Brush → Change Brush…*, or B
+- A square containing the current brush icon.
+- Clicking the icon opens the brush groups popup. [Read more]({{< relref "../popups/brush-groups" >}})
+
+**Pick Stroke and Layer** button
+> Press W
+- Pick a brushstroke from the screen. If the stroke is on a different layer, MyPaint will switch to that layer.
+Invisible and locked layers can't be picked. Not every kind of image has a strokemap. [Read more]({{< relref "../tools/stroke-layer-picker" >}})
diff --git a/pages/docs/manuals/v1.2.0/ui/footer-bar/mypaint-footer-bar-brush.jpg b/pages/docs/manuals/v1.2.0/ui/footer-bar/mypaint-footer-bar-brush.jpg
new file mode 100644
index 0000000..e08d06a
--- /dev/null
+++ b/pages/docs/manuals/v1.2.0/ui/footer-bar/mypaint-footer-bar-brush.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:6b5bfa822700ed725b47e0f0e470f20e6b4627bf1cc4b349718273faaa73603d
+size 6936
diff --git a/pages/docs/manuals/v1.2.0/ui/footer-bar/mypaint-footer-bar-colour.jpg b/pages/docs/manuals/v1.2.0/ui/footer-bar/mypaint-footer-bar-colour.jpg
new file mode 100644
index 0000000..73f8206
--- /dev/null
+++ b/pages/docs/manuals/v1.2.0/ui/footer-bar/mypaint-footer-bar-colour.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:2eee5c20c376bf8e02447b0591fc26280a6a29ecab55e39428e5542d2819d850
+size 7181
diff --git a/pages/docs/manuals/v1.2.0/ui/footer-bar/mypaint-footer-bar-status.jpg b/pages/docs/manuals/v1.2.0/ui/footer-bar/mypaint-footer-bar-status.jpg
new file mode 100644
index 0000000..ac3fd64
--- /dev/null
+++ b/pages/docs/manuals/v1.2.0/ui/footer-bar/mypaint-footer-bar-status.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:2f77f719484ae85ff4519069ddefa105e4b63bc4e57c957c1c6cceebe95a35bc
+size 15897
diff --git a/pages/docs/manuals/v1.2.0/ui/fullscreen.md b/pages/docs/manuals/v1.2.0/ui/fullscreen.md
index 697f8aa..18ff56c 100644
--- a/pages/docs/manuals/v1.2.0/ui/fullscreen.md
+++ b/pages/docs/manuals/v1.2.0/ui/fullscreen.md
@@ -1,16 +1,11 @@
+++
title = "Fullscreen Mode"
-summary = "How to use MyPaint's fullscreen mode"
+++
-Turn on the Fullscreen mode to maximize your drawing space. Differences in Fullscreen mode:
-* MyPaint's canvas fills your screen completely
-* No window borders or taskbar (Windows)
-* UI elements like Toolbar, floating and docked Panels, Footer are hidden when not in use
-* move the cursor to the UI element's location to show it
-* Main Menu is hidden under _MyPaint_ button
+MyPaint's fullscreen mode maximises useable drawing space on the screen.
+> *View → Fullscreen*, or F11, or [fullscreen button]({{< relref "ui-toolbar#fullscreen-toggle" >}})
-## To enter or leave Fullscreen
-* Click the Fullscreen icon in the [[UI toolbar|v1.2-UI-Toolbar]] (the double arrows, far right)
-* Main Menu _View_ → _Fullscreen_
-* Keyboard shortcut F11
+- Window borders and the system taskbar/dash/panel are hidden.
+- UI elements (e.g. toolbars, footer, and panels) can be toggled on/off.
+ - Move the cursor to the UI element's location to unhide it
+- Menus are hidden under the *MyPaint* button on the [main toolbar]({{< relref "main-toolbar" >}})
diff --git a/pages/docs/manuals/v1.2.0/ui/main-toolbar/index.md b/pages/docs/manuals/v1.2.0/ui/main-toolbar/index.md
index 5adab7d..02c1729 100644
--- a/pages/docs/manuals/v1.2.0/ui/main-toolbar/index.md
+++ b/pages/docs/manuals/v1.2.0/ui/main-toolbar/index.md
@@ -2,9 +2,12 @@
title = "Main Toolbar"
summary = "The main toolbar contains painting tools and other commands"
hideSummary = true
+weight = 10
+++
-{{< img src="main-toolbar.jpg" caption="The main toolbar with the customisation menu open" >}}
+{{< id "main-toolbar-image" nomd >}}
+{{< img src="main-toolbar.jpg" caption="The main toolbar with the context menu open" >}}
+{{< /id >}}
The **Main Toolbar** contains MyPaint's painting tools, and other commands. It is located at the top of the
[main window]({{< relref "../#user-interface" >}}), next to the menu. It continues into the [UI toolbar]({{< relref
@@ -16,10 +19,17 @@ what appears on it.
{{< img src="main-toolbar-file.jpg" float="right" >}}
The File Handling toolbar buttons let you load and save the working canvas. They are visible by default.
-- **New File** (_File → New_, or `Ctrl+N`). Starts a new, blank canvas.
-- **Open File** (_File → Open…_, or `Ctrl+O`). Open a file on disk, so it can be edited in the canvas area.
-- **Save File** (_File → Save…_, or `Ctrl+S`). Saves the current canvas to a file on disk. If it hasn't got a file name
-yet, you'll be asked for one.
+**New File**
+> *File → New*, or `Ctrl+N`
+- Starts a new, blank canvas.
+
+**Open File**
+> *File → Open…*, or `Ctrl+O`
+- Open a file on disk, so it can be edited in the canvas area.
+
+**Save File**
+> *File → Save…*, or `Ctrl+S`
+- Saves the current canvas to a file on disk. If it hasn't got a file name yet, you'll be asked for one.
# Core Tools
{{< img src="main-toolbar-tools.jpg" float="right" >}}
@@ -31,21 +41,21 @@ The core set of tools cannot be hidden using the popup menu.
- Toggles the Eraser paint/blend mode, which affects how the painting tools operate. [Read more]({{< relref
"../paint-modes#eraser" >}})
-- Other optional paint modes can be toggled on the toolbar: see [Blend Modes]({{< relref "#blend-modes" >}})
-below.
+- Other optional paint modes can be toggled on the toolbar, see [blend modes]({{< relref "#blend-modes" >}}).
+
-**Freehand** (paint brush)
+**Freehand** (paintbrush)
> *Edit → Freehand*, or `P`
- The default painting tool; paint using the current brush and colour, without constraints. [Read more]({{< relref
"../tools/freehand" >}})
-**Pick Colour** (eye dropper)
+**Pick Colour** (eyedropper)
> *Colour → Pick Colour*, or `R`
- Pick a new painting colour from the canvas. [Read more]({{< relref "../tools/colour-picker" >}})
-**Flood fill** (paint bucket)
+**Flood Fill** (paint bucket)
> *Edit → Flood Fill*
- Fills an area with the current painting colour.
@@ -67,7 +77,8 @@ below.
{{< img src="main-toolbar-scraps.jpg" float="right" >}}
The Scraps Switcher toolbar buttons let you quickly save drafts to a dedicated folder on disk, and load them in again.
-These items are optional, you need to use the [main toolbar's context menu]({{< relref "#" >}}) to make them visible.
+These items are optional, you need to use the [main toolbar's context menu]({{< relref "#main-toolbar-image" >}}) to
+make them visible.
Scrap file revisions are stored with numbered filenames in a single folder. The scrap folder's location can be changed
in the [Preferences window]({{< relref "../preferences" >}})
@@ -106,8 +117,8 @@ The toolbar items are only sensitive when you can undo or redo a step.
{{< img src="main-toolbar-blend.jpg" float="right" >}}
Paint blend modes change how your brush affects the layer you paint on. These toolbar buttons are optional, and you need
-to use the [main toolbar's context menu]({{< relref "#" >}}) to make them visible. [Read more about paint modes]({{<
-relref "../paint-modes" >}})
+to use the [main toolbar's context menu]({{< relref "#main-toolbar-image" >}}) to make them visible. [Read more about
+paint modes]({{< relref "../paint-modes" >}})
**Lock Alpha** (padlock)
> *Brush → Paint Mode → Paint Mode: Lock Alpha*, or press `Shift+L`
@@ -181,7 +192,7 @@ tools, so they are visible by default.
{{< img src="main-toolbar-view-alt.jpg" float="right" >}}
These buttons allow single-click adjustments of the view. These items are optional, you need to use the [main toolbar's
-context menu]({{< relref "#" >}}) to make them visible.
+context menu]({{< relref "#main-toolbar-image" >}}) to make them visible.
There's no equivalent of these buttons for the canvas position, but the cursor keys will pan around the canvas.
@@ -197,7 +208,7 @@ There's no equivalent of these buttons for the canvas position, but the cursor k
{{< img src="main-toolbar-view-reset.jpg" float="right" >}}
These are for resetting the view. These items are optional, you need to use the [main toolbar's context menu]({{< relref
-"#" >}}) to make them visible.
+"#main-toolbar-image" >}}) to make them visible.
**Reset and Centre View**
> *View → Reset and Centre View*, or press `F12`
diff --git a/pages/docs/manuals/v1.2.0/ui/ui-toolbar.md b/pages/docs/manuals/v1.2.0/ui/ui-toolbar.md
deleted file mode 100644
index 9f95444..0000000
--- a/pages/docs/manuals/v1.2.0/ui/ui-toolbar.md
+++ /dev/null
@@ -1,40 +0,0 @@
-+++
-title = "UI Toolbar"
-summary = "This toolbar toggles various parts of the UI"
-+++
-
-
-
-The **User Interface Toolbar** is shown at the top right of the [[main window|v1.2 User Interface]], and is not customizable. It allows various pieces of the user interface to be turned on and off.
-
-### Buttons and Menus
-
-From left to right:
-
-* **Colour Selectors Menu** (_Colour → \_, or _Window → Colour Adjusters_) _:new: Since MyPaint 1.2.0_
- - The entries in this menu open different kinds of colour selector dock-panels.
- - Each dock-panel gives you a different way of changing the painting colour.
- - Main article: [[v1.2 Colour selectors]]
-* **Brush Groups Menu** (_Brush → Brush Groups_ or _Window → Brush Groups_) _:new: Since MyPaint 1.2.0_
- - The entries in this menu open different brush group dock-panels.
- - Each dock-panel allows you to change the brush you paint with.
- - Main article: [[v1.2 Brush groups]]
-* **Tool Options Panel (cog)** (_Edit → Show Tool Options Panel_)
- - This panel shows options for the current tool.
- - Main article: [[v1.2 Tool Options Panel]]
-* **Layers Panel (pile of papers)** (_Layer → Show Layers Panel_, or press `L`)
- - This panel shows the layers tree (layer stack) for your working document.
- - Main article: [[v1.2 Layers Panel]]
-* **Scratchpad Panel (notebook)** (_Scratchpad → Show Scratchpad Panel_, or press `Shift+S`)
- - This panel is a little area where you can work on thumbnail sketches, stash references, or make palettes.
- - Scratchpads can be saved and loaded independently of the main working doc.
- - Main article: [[v1.2 Scratchpad Panel]]
-* **Preview Panel (camera viewfinder)** (_View → Preview_, or press `Shift+P`)
- - The preview panel shows an overview of the entire document, and a viewfinder showing where you're zoomed to.
- - Main article: [[v1.2 Preview Panel]]
-* **History Panel (clock)** (_Edit → Recent Brushes and Colours_)
- - The history panel shows a short timeline of recent brushes and colours.
- - Main article: [[v1.2 History Panel]]
-* **Fullscreen mode toggle** (_View → Fullscreen_, or press `F11`)
- - This button makes MyPaint take up the whole screen, or gets you out of fullscreen mode when it's active.
- - Main article: [[v1.2 Fullscreen mode]]
diff --git a/pages/docs/manuals/v1.2.0/ui/ui-toolbar/index.md b/pages/docs/manuals/v1.2.0/ui/ui-toolbar/index.md
new file mode 100644
index 0000000..fc7b125
--- /dev/null
+++ b/pages/docs/manuals/v1.2.0/ui/ui-toolbar/index.md
@@ -0,0 +1,47 @@
++++
+title = "UI Toolbar"
+summary = "This toolbar toggles various parts of the UI"
+weight = 20
++++
+
+{{< img src="mypaint-ui-toolbar.jpg" float="right" >}}
+
+The **User Interface Toolbar** is located right of the [main toolbar]({{< relref "main-toolbar" >}}), it contains
+buttons to toggle parts of the user interface. The UI toolbar is not customisable.
+
+**Colour Selectors Menu** (three circles)
+> *Colour → \*, or *Window → Colour Adjusters*
+- The entries in this menu open different kinds of colour selector dock-panels. Each dock-panel gives you a different
+way of changing the painting colour. [Read more]({{< relref "../colour/selectors" >}})
+
+**Brush Groups Menu** (three brushes)
+> *Brush → Brush Groups* or *Window → Brush Groups*
+- The entries in this menu open different brush group dock-panels. Each dock-panel allows you to change the brush you
+paint with. [Read more]({{< relref "../popups/brush-groups" >}})
+
+**Tool Options Panel** (cog)
+> *Edit → Show Tool Options Panel*
+- This panel shows options for the current tool. [Read more]({{< relref "../panels/tool-options" >}})
+
+**Layers Panel** (stack of paper)
+> *Layer → Show Layers Panel*, or press `L`
+- This panel shows the layers tree (layer stack) for your working document. [Read more]({{< relref "../panels/layers" >}})
+
+**Scratchpad Panel** (clipboard)
+> *Scratchpad → Show Scratchpad Panel*, or press `Shift+S`
+- This panel is a little area where you can work on thumbnail sketches, stash references, or make palettes. Scratchpads
+can be saved and loaded independently of the main working doc. [Read more]({{< relref "../panels/scratchpad" >}})
+
+**Preview Panel** (camera viewfinder)
+> *View → Preview*, or press `Shift+P`
+- The preview panel shows an overview of the entire document, and a viewfinder showing where you're zoomed to. [Read
+more]({{< relref "../panels/preview" >}})
+
+**History Panel** (clock)
+> *Edit → Recent Brushes and Colours*
+- The history panel shows a short timeline of recent brushes and colours. [Read more]({{< relref "../panels/history" >}})
+
+{{< id "fullscreen-toggle" >}}**Fullscreen Mode Toggle**{{< /id >}}
+> *View → Fullscreen*, or press `F11`
+- This button makes MyPaint take up the whole screen, or gets you out of fullscreen mode when it's active. [Read more](
+{{< relref "fullscreen" >}})
diff --git a/pages/docs/manuals/v1.2.0/ui/ui-toolbar/mypaint-ui-toolbar.jpg b/pages/docs/manuals/v1.2.0/ui/ui-toolbar/mypaint-ui-toolbar.jpg
new file mode 100644
index 0000000..a1054a7
--- /dev/null
+++ b/pages/docs/manuals/v1.2.0/ui/ui-toolbar/mypaint-ui-toolbar.jpg
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:201a1778ca1b0c3158152becff4139e55a3a2024ffb45c19799de91b5c871906
+size 8906