manual:1.2.0: Completed index & main-toolbar page

Signed-off-by: Aesara <[email protected]>

pages/docs/manuals/v1.2.0/_index.md

@@ -9,76 +9,75 @@ hideList = true
 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, 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.
+
+{{< img src="mypaint-window-new.jpg" caption="A fresh installation of MyPaint" >}}
 
-![First Open / In Use comparison](https://cloud.githubusercontent.com/assets/61299/12079583/60843502-b236-11e5-8ecc-36bad8507890.png)
+{{< 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.
+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.
 
-For more information, see the [User Interface]({{< relref "ui" >}}) page.
+## 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" >}})
 
 # Tools
 ## Anatomy of a stroke
-When you paint a stroke, the result is defined by different parts of MyPaint. You
-can combine any _Painting Tool_, _Brush_ and _Paint Mode_ to suit your drawing style.
-MyPaint uses one and the same engine for all kinds of brushes (and the eraser).
+When you paint a stroke, the result is defined by different parts of MyPaint. You can combine any _Painting Tool_,
+_Brush_ and _Paint Mode_ to suit your drawing style. MyPaint uses one and the same engine for all kinds of brushes (and
+the eraser).
 
 * Painting Tool: Defines how the **shape** of a stroke is made
 * Brush: Defines the **look** of the stroke
 * Paint Mode: Defines how the resulting color is **applied** to the canvas.
 
 
 ## The Painting Tools
-The general painting tools change the input method of strokes and can be used to
-construct geometrical shape. The lines that are created will be made with the current
-brush, colour, and paint blend mode.
+{{< img src="mypaint-preferences.jpg" caption="Menu -> Edit -> Current Tool" width="250px" float="right" >}}
+
+The general painting tools change the input method of strokes and can be used to construct geometrical shape. The lines
+that are created will be made with the current brush, colour, and paint blend mode.
 
-* [[Freehand|v1.2-Freehand-Tool]] - free drawing without constraints
-* [[Inking|v1.2-Inking-Tool]] - smooth Strokes than can be modified
+* [Freehand]({{< relref "tools/freehand" >}}) - free drawing without constraints
+* [Inking]({{< relref "tools/inking" >}}) - smooth Strokes than can be modified
 * Lines and Curves
 * Connected Lines
-* [[Ellipses and Circles|v1.2-Ellipses-and-Circles]]
+* [Ellipses and Circles]({{< relref "tools/ellipses-and-circles" >}})
 
 ### Other Tools
 MyPaint also offers Tools for:
-- [[Navigation|v1.2-Main-Toolbar#view-main]]
-- [[canvas tools|v1.2-Main-Toolbar#core-tools]]
+- [Navigation]({{< relref "ui/main-toolbar#view-main" >}})
+- [Canvas tools]({{< relref "ui/main-toolbar#core-tools" >}})
 - the colour picker.
 
-_Main Menu: Edit → Current Tool_
-
 # Shortcuts for brush settings
+Brush shortcut keys are used to quickly save and restore brush settings. You can paint with one hand and change brushes
+with the other, even in mid-stroke.
 
-Brush shortcut keys are used to quickly save and restore brush settings. You can
-paint with one hand and change brushes with the other, even in mid-stroke.
-
-There are 10 slots available for brushes. By default, shortcuts are assigned to
-the keys `1` through `9`, and to the `0` key. To save your current brush’s settings
-to one of these press `Ctrl+<number>`, for example `Ctrl+9`. To load stored settings
-back, just press the number key on its own.
+There are 10 slots available for brushes. By default, shortcuts are assigned to the keys `1` through `9`, and to the `0`
+key. To save your current brush’s settings to one of these press `Ctrl+<number>`, for example `Ctrl+9`. To load stored
+settings back, just press the number key on its own.
 
-The brush shortcuts you assign are saved to your personal MyPaint settings, allowing
-you to use them in future sessions.
+The brush shortcuts you assign are saved to your personal MyPaint settings, allowing you to use them in future sessions.
 
-By default, pressing the `Q` key saves your current brush’s settings to the most
-recently used shortcut slot.
+By default, pressing the `Q` key saves your current brush’s settings to the most recently used shortcut slot.
 
 ## Options
-By default, brush shortcut keys remember the colour you had active when you saved
-the brush.
+By default, brush shortcut keys remember the colour you had active when you saved the brush.
 
 This behaviour can be turned off using the main menu:
 - _Brush → Shortcut Keys → Brush Shortcut Keys Restore Colour_.
 
 # Preferences
-![Menu - Edit - Current Tool: Overview](https://cloud.githubusercontent.com/assets/6949092/21042880/88398014-bdf4-11e6-8a51-a7ae855192f2.PNG)
-
 The [Preferences Window]({{< relref "preferences" >}}) gives you options to configure
 MyPaint's appearance, input, keyboard shortcuts and many other settings.
 

pages/docs/manuals/v1.2.0/tools/colour-picker.md

@@ -0,0 +1,6 @@
++++
+title = "Colour Picker Tool"
+tags = "Incomplete"
++++
+
+TBD.

pages/docs/manuals/v1.2.0/tools/ellipses-and-circles.md

@@ -2,7 +2,8 @@
 title = "Ellipses and Circles Tool"
 +++
 
-The Ellipses tool is a geometrical tool to construct circles or ellipses. The line shape is put directly on the canvas and can't be modified afterwards (compare to Inking tool). There are different ways to choose the Ellipses tool:
+The Ellipses tool is a geometrical tool to construct circles or ellipses. The line shape is put directly on the canvas
+and can't be modified afterwards (compare to Inking tool). There are different ways to choose the Ellipses tool:
 
 * Click on the ellipses icon in the Tool bar
 * _Edit → Ellipses and Circles_

pages/docs/manuals/v1.2.0/tools/Freehand-Tool.md → pages/docs/manuals/v1.2.0/tools/freehand.md

@@ -1,4 +1,6 @@
-## The Freehand tool - draw and write freely
++++
+title = "Freehand Tool"
++++
 
 The Freehand tool is the default tool to draw or write without geometric constraints. The stroke shape is put directly on the canvas and can't be modified afterwards (compare to Inking tool). 
 There are different ways to choose the Freehand tool:
@@ -14,4 +16,4 @@ You can draw strokes with the Freehand tool by clicking on the left mouse button
 
 ### Changing the appearance of the strokes
 To change the appearance of the Freehand strokes pick a different brush from the brush group panels or change the brush settings.
-The Tool Options panel gives you quick access to common brush options.
+The Tool Options panel gives you quick access to common brush options.

pages/docs/manuals/v1.2.0/tools/inking-tool/index.md → pages/docs/manuals/v1.2.0/tools/inking/index.md

@@ -1,18 +1,13 @@
-> :book: _Part of the [[v1.2 User Manual]]_.  
-> :heavy_check_mark: This page is ready to be [[translated|Writing-Documentation#translations]].  
++++
+title = "Inking Tool"
++++
 
-The Inking tool helps you draw controlled, smooth curved lines.
-You can use it for making sharp ink-like strokes
-over the top of pencil sketch layers.
-It also works as a way of gaining
-some fine control of your painting strokes.
+The Inking tool helps you draw controlled, smooth curved lines. You can use it for making sharp ink-like strokes over
+the top of pencil sketch layers. It also works as a way of gaining some fine control of your painting strokes.
 
 ## Capturing strokes
-
-To use your current brush with extra inking guidance,
-click on the Inking Tool icon in the toolbar.
-This tool works best with brush settings that emulate an ink pen.
-A brush whose width responds to your stylus pressure is ideal.
+To use your current brush with extra inking guidance, click on the Inking Tool icon in the toolbar. This tool works best
+with brush settings that emulate an ink pen. A brush whose width responds to your stylus pressure is ideal.
 
 [[v1.2-Inking-Tool-00-toolbar-icon.png]]
 

pages/docs/manuals/v1.2.0/tools/Lines-and-Curves.md → pages/docs/manuals/v1.2.0/tools/lines-and-curves.md

@@ -1,3 +1,7 @@
++++
+title = "Lines and Curves"
++++
+
 The Lines and Curves tool is a geometrical tool to draw straight lines or smooth curves. The stroke shape can be modified directly after it is drawn to edit the curve. There are different ways to choose the Lines and Curves tool:
 * Click on the Lines and Curves icon in the Toolbar
 * Select _Edit → Lines and Curves_ from the top menu