1 files changed, 183 insertions, 0 deletions
diff --git a/doc/chalk/tutorial-quick-starts.docbook b/doc/chalk/tutorial-quick-starts.docbook
new file mode 100644
index 00000000..b22d3250
--- /dev/null
+++ b/doc/chalk/tutorial-quick-starts.docbook
@@ -0,0 +1,183 @@
+<sect1 id="tutorial-quickstarts">
+<title>Quick start guides</title>
+<sect2 id="tutorial-quickstarts-cropimage">
+<title>Crop an area and save it</title>
+
+<para>Aim: from a picture, crop an area and save that area in a new file</para>
+
+<para>Open &chalk; with the original picture.</para>
+
+<screenshot>
+<screeninfo>The original picture</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="tutorial-quick-starts1.png" format="PNG"/>
+</imageobject>
+<textobject><phrase>The original picture</phrase></textobject>
+</mediaobject>
+</screenshot>
+
+<para>Select the <guiicon>Select Rectangular</guiicon> tool in the
+&chalk; toolbar.</para>
+
+<screenshot>
+<screeninfo>The Select a rectangular area tool</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="tutorial-quick-starts2.png" format="PNG"/>
+</imageobject>
+<textobject><phrase>The Select a rectangular area tool</phrase></textobject>
+</mediaobject>
+</screenshot>
+
+<para>Select the area you want to make a new picture with. &chalk; makes the
+outside area grey.</para>
+
+<screenshot>
+<screeninfo>The selected area</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="tutorial-quick-starts3.png" format="PNG"/>
+</imageobject>
+<textobject><phrase>The selected area</phrase></textobject>
+</mediaobject>
+</screenshot>
+
+<para>Then use the
+<menuchoice><guimenu>Edit</guimenu><guimenuitem>Copy</guimenuitem></menuchoice>
+menu item or <keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo> to
+copy the selected area.</para>
+
+<para>Click again on the <guimenu>Edit</guimenu> menu.</para>
+<para>Use the <guimenuitem>Paste into new image</guimenuitem> item.</para>
+
+<screenshot>
+<screeninfo>The <guimenu>Edit</guimenu> menu</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="tutorial-quick-starts4.png" format="PNG"/>
+</imageobject>
+<textobject><phrase>The <guimenu>Edit</guimenu> menu</phrase></textobject>
+</mediaobject>
+</screenshot>
+
+<para>&chalk; opens a new window with the selected area as new image.</para>
+
+<screenshot>
+<screeninfo>The new image</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="tutorial-quick-starts5.png" format="PNG"/>
+</imageobject>
+<textobject><phrase>The new image</phrase></textobject>
+</mediaobject>
+</screenshot>
+
+<para>Save the new image.</para>
+
+</sect2>
+<sect2 id="tutorial-quickstarts-drawrectangle">
+<title>Draw a rectangle on your picture</title>
+
+<para>Aim: draw a coloured rectangle on your picture</para>
+
+<para>Open &chalk; with the original picture. My picture consists of a view of
+a toolbar in which I want to point an icon by putting a red rectangle around
+it.</para>
+
+<screenshot>
+<screeninfo>The original picture</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="tutorial-quick-starts6.png" format="PNG"/>
+</imageobject>
+<textobject><phrase>The original picture</phrase></textobject>
+</mediaobject>
+</screenshot>
+
+<para>Enable the <guilabel>Brushes and Stuff</guilabel> toolbar using
+<menuchoice><guimenu>Settings</guimenu><guimenuitem>Toolbars</guimenuitem></menuchoice>
+menu.</para>
+<para>Also make sure the palettes are viewed. If not, use the
+<menuchoice><guimenu>View</guimenu><guimenuitem>Palettes</guimenuitem></menuchoice>
+menu.</para>
+
+<screenshot>
+<screeninfo>&chalk; view</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="tutorial-quick-starts7.png" format="PNG"/>
+</imageobject>
+<textobject><phrase>&chalk; view</phrase></textobject>
+</mediaobject>
+</screenshot>
+
+<para>Click on the <guiicon>Brush Shapes</guiicon> icon in the
+<guilabel>Brushes and Stuff</guilabel> toolbar.</para>
+
+<screenshot>
+<screeninfo>The <guiicon>Brush Shapes</guiicon> icon</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="tutorial-quick-starts8.png" format="PNG"/>
+</imageobject>
+<textobject><phrase>The <guiicon>Brush Shapes</guiicon> icon</phrase></textobject>
+</mediaobject>
+</screenshot>
+
+<para>Select which brush shape you want to use among the predefined
+brushes.</para>
+
+<screenshot>
+<screeninfo>Selecting a brush shape</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="tutorial-quick-starts9.png" format="PNG"/>
+</imageobject>
+<textobject><phrase>Selecting a brush shape</phrase></textobject>
+</mediaobject>
+</screenshot>
+
+<para>Select the drawing shape on the &chalk; toolbar. I choose a
+rectangle.</para>
+
+<screenshot>
+<screeninfo>Selecting the <guiicon>Rectangle</guiicon> icon</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="tutorial-quick-starts10.png" format="PNG"/>
+</imageobject>
+<textobject><phrase>Selecting the <guiicon>Rectangle</guiicon> icon</phrase></textobject>
+</mediaobject>
+</screenshot>
+
+<para>In the <guilabel>Colors</guilabel> palette, select the color you want by clicking on one of the
+tabs and then choosing the color.</para>
+
+<screenshot>
+<screeninfo>Choosing the color</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="tutorial-quick-starts11.png" format="PNG"/>
+</imageobject>
+<textobject><phrase>Choosing the color</phrase></textobject>
+</mediaobject>
+</screenshot>
+
+<para>Finally draw your shape on your picture and save the new picture!</para>
+
+<screenshot>
+<screeninfo>Drawing</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="tutorial-quick-starts12.png" format="PNG"/>
+</imageobject>
+<textobject><phrase>Drawing</phrase></textobject>
+</mediaobject>
+</screenshot>
+
+<para>Thanks go to Anne-Marie Mahfouf for providing this tutorial.</para>
+
+</sect2>
+
+</sect1>