diff options
Diffstat (limited to 'tde-i18n-en_GB/docs/kdeedu/kturtle/getting-started.docbook')
| -rw-r--r-- | tde-i18n-en_GB/docs/kdeedu/kturtle/getting-started.docbook | 292 |
1 files changed, 292 insertions, 0 deletions
diff --git a/tde-i18n-en_GB/docs/kdeedu/kturtle/getting-started.docbook b/tde-i18n-en_GB/docs/kdeedu/kturtle/getting-started.docbook new file mode 100644 index 00000000000..d14539ae964 --- /dev/null +++ b/tde-i18n-en_GB/docs/kdeedu/kturtle/getting-started.docbook @@ -0,0 +1,292 @@ +<chapter id="getting-started"> +<title +>Getting Started</title> +<para +>When you start &kturtle; you will see something like this: <screenshot +> <screeninfo +>Here is a screenshot of &kturtle; when you start it for the first time</screeninfo +> <mediaobject +> <imageobject +> <imagedata fileref="mainwindow.png" format="PNG"/> </imageobject +> <textobject +> <phrase +>&kturtle; Main window</phrase +> </textobject +> </mediaobject +> </screenshot +> In this Getting Started guide we assume that the language of the &logo; commands is English. You can change this language in <menuchoice +><guimenu +>Settings</guimenu +><guimenuitem +>Configure &kturtle;...</guimenuitem +></menuchoice +> in the <guilabel +>Language</guilabel +> section. Be aware that the language you set here for &kturtle; is the one you use to type the &logo; commands.</para> + +<sect1 id="first-steps"> +<title +>First steps with &logo;: meet the Turtle!</title> +<para +>You must have noticed the turtle is in the middle of the canvas: you are just about to learn how to control it using commands in the code editor.</para> + +<sect2 id="the-turtle-moves"> +<title +>The Turtle Moves</title> +<para +>Let us start by getting the turtle moving. Our turtle can do 3 types of moves, (1) it can go forwards and backwards, (2) it can turn left and right and (3) it can go directly to a position on the screen. Try this for example:</para> +<para> +<screen +>forward 90 +turnleft 90 +</screen> +Type or copy-paste the code to the code editor and execute it (using <link linkend="file-execute" +><menuchoice +><guimenu +>File</guimenu +><guimenuitem +>Execute Commands</guimenuitem +></menuchoice +></link +>) to see the result.</para> + +<para +>When you typed and executed the commands like above in the code editor you might have noticed one or more of the following things:</para> +<orderedlist> +<listitem +><para +>That — after executing the commands — the turtle moves up, draws a line, and then turns a quarter turn to the left. This because you have used the <link linkend="forward" +><userinput +>forward</userinput +></link +> and the <link linkend="turnleft" +><userinput +>turnleft</userinput +></link +> commands.</para> +</listitem> +<listitem> +<para +>That the colour of the code changed while you where typing it: this feature is called <emphasis +>intuitive highlighting</emphasis +> — different types of commands are highlighted differently. This makes reading large blocks of code more easy.</para> +</listitem> +<listitem> +<para +>That the turtle draws a thin black line.</para> +</listitem> +<listitem> +<para +>Maybe you got an error message. This could simply mean two things: you could have made a mistake while copying the commands, or you should still set the correct language for the &logo; commands (you can do that by choosing <menuchoice +><guimenu +>Settings</guimenu +><guimenuitem +>Configure &kturtle;...</guimenuitem +></menuchoice +>, in the <guilabel +>Language</guilabel +> section).</para> +</listitem> +</orderedlist> + +<para +>You will likely understand that <userinput +>forward 90</userinput +> commanded the turtle to move forward leaving a line, and that <userinput +>turnleft 90</userinput +> commanded the turtle to turn 90 <glossterm linkend="degrees" +>degrees</glossterm +> to the left.</para> + +<para +>Please see the following links to the reference manual for a complete explanation of the new commands: <userinput +>forward</userinput +>, <userinput +>backward</userinput +>, <userinput +>turnleft</userinput +>, and <userinput +>turnright</userinput +>.</para> +</sect2> + +<sect2 id="more-examples"> +<title +>More examples</title> +<para +>The first example was very simple, so let us go on!</para> + +<para> +<!--translators: if it's not already there, you can copy/paste the translated code below and save it in arrow.logo in your examples folder: kde-i18n/language-code/data/kdeedu/kturtle/ --> +<screen +>canvassize 200,200 +canvascolour 0,0,0 +pencolour 255,0,0 +penwidth 5 +clear + +go 20,20 +direction 135 + +forward 200 +turnleft 135 +forward 100 +turnleft 135 +forward 141 +turnleft 135 +forward 100 +turnleft 45 + +go 40, 100 +</screen> +Again you can type or copy-paste the code to the code editor or open the <filename +>arrow.logo</filename +> file in the <guimenu +>Open examples</guimenu +> folder and execute it (using <link linkend="file-execute" +><menuchoice +><guimenu +>File</guimenu +><guimenuitem +>Execute Commands</guimenuitem +></menuchoice +></link +>) to see the result. In the next examples you are expected to know the drill.</para> + +<para +>You might have noticed that this second example uses a lot more code. You have also seen a couple of new commands. Here a short explanation of all the new commands:</para> + +<para +><userinput +>canvassize 200,200</userinput +> sets the canvas width and height to 200 <glossterm linkend="pixels" +>pixels</glossterm +>. The width and the height are equal, so the canvas will be a square.</para> + +<para +><userinput +>canvascolour 0,0,0</userinput +> makes the canvas black. <userinput +>0,0,0</userinput +> is an <glossterm linkend="rgb" +>RGB-combination</glossterm +> where all values are set to <userinput +>0</userinput +>, which results in black.</para> + +<para +><userinput +>pencolor 255,0,0</userinput +> sets the color of the pen to red. <userinput +>255,0,0</userinput +> is an <glossterm linkend="rgb" +>RGB-combination</glossterm +> where only the red value is set to <userinput +>255</userinput +> (fully on) while the others (green and blue) are set to <userinput +>0</userinput +> (fully off). This results in a bright shade of red.</para> + +<para +><userinput +>penwidth 5</userinput +> sets the width (the size) of the pen to <userinput +>5</userinput +> <glossterm linkend="pixels" +>pixels</glossterm +>. From now on every line the turtle draw will have a thickness of <userinput +>5</userinput +>, until we change the <userinput +>penwidth</userinput +> to something else.</para> + +<para +><userinput +>clear</userinput +> clear the canvas, that is all it does.</para> + +<para +><userinput +>go 20,20</userinput +> commands the turtle to go to a certain place on the canvas. Counted from the upper left corner, this place is 20 <glossterm linkend="pixels" +>pixels</glossterm +> across from the left, and 20 <glossterm linkend="pixels" +>pixels</glossterm +> down from the top of the canvas. Note that using the <userinput +>go</userinput +> command the turtle will not draw a line.</para> + +<para +><userinput +>direction 135</userinput +> set the turtle's direction. The <userinput +>turnleft</userinput +> and <userinput +>turnright</userinput +> commands change the turtle's angle starting from its current direction. The <userinput +>direction</userinput +> command changes the turtle's angle from zero, and thus is not relative to the turtle previous direction.</para> + +<para +>After the <userinput +>direction</userinput +> command a lot of <userinput +>forward</userinput +> and <userinput +>turnleft</userinput +> commands follow. These command do the actual drawing.</para> + +<para +>At last another <userinput +>go</userinput +> command is used to move the turtle aside.</para> + +<para +>Make sure you follow the links to the reference. The reference explains each command more thoroughly.</para> + +</sect2> +</sect1> + + + +<!-- EXTRA SECTIONS CAN BE ADDED TO THE "GETTING STARTED" + +<sect1 id="calculations"> +<title +>Simple Calculations</title> +<para> +Not yet written +</para> +</sect1> +<sect1 id="using_variables"> +<title +>Using Variables: creating 'number containers'</title> +<para> +Not yet written +</para> +</sect1> +<sect1 id="using_strings"> +<title +>Using strings: creating 'text containers'</title> +<para> +Not yet written +</para> +</sect1> +<sect1 id="logic"> +<title +>Logic: asking the computer simple questions</title> +<para> +Not yet written +</para> +</sect1> +<sect1 id="recursion"> +<title +>Recursion: the Turtle is using itself</title> +<para> +Draw a maze for example +</para> +</sect1 +>--> + + +</chapter>
\ No newline at end of file |