Warning, /education/kturtle/po/gl/docs/kturtle/getting-started.docbook is written in an unsupported language. File is not indexed.

0001 <chapter id="getting-started">
0002 <title
0003 >Comezando</title>
0004 <para
0005 >Cando inicie &kturtle; verá algo como isto: <screenshot
0006 > <screeninfo
0007 >Esta é unha imaxe de &kturtle; ao inicialo por primeira vez</screeninfo
0008 ><mediaobject
0009 ><imageobject
0010 ><imagedata fileref="mainwindow.png" format="PNG"/></imageobject
0011 ><textobject
0012 ><phrase
0013 >&kturtle; nun inicio coa configuración de fábrica</phrase
0014 ></textobject
0015 ></mediaobject
0016 ></screenshot
0017 > Nesta guía de iniciación asumirase que o idioma das ordes de &turtlescript; é o galego. Pode cambiar o idioma en <menuchoice
0018 ><guimenu
0019 >Configuración</guimenu
0020 ><guisubmenu
0021 >Idioma do script</guisubmenu
0022 ></menuchoice
0023 >. Lembre que o idioma que lle indique aquí a &kturtle; é o que utilizará para escribir as ordes de &turtlescript;, non o idioma empregado por &kde; no computador e utilizado na interface e menús de &kturtle;.</para>
0024 
0025 <sect1 id="first-steps">
0026 <title
0027 >Os primeiros pasos con &turtlescript;: coñeza o sapoconcho!</title>
0028 <para
0029 >Xa se debeu decatar de que hai un sapoconcho no centro do lenzo: agora aprenderá a controlalo mediante ordes no editor.</para>
0030 
0031 <sect2 id="the-turtle-moves">
0032 <title
0033 >Os movementos do sapoconcho</title>
0034 <para
0035 >Comecemos facendo que se mova o sapoconcho. O noso animal pode facer tres tipos de movemento, (1) pode moverse adiante e atrás, (2) pode xirar á esquerda e á dereita e (3) pode ir (saltar) directamente a unha posición na pantalla. Probe isto:</para>
0036 <para>
0037 <screen
0038 >avanza 100
0039 xiraesquerda 90 
0040 </screen
0041 >Escriba ou corte e pegue o código no editor e execúteo (empregando <link linkend="run-execute"
0042 ><menuchoice
0043 ><guimenu
0044 >Executar</guimenu
0045 ><guimenuitem
0046 >Executar</guimenuitem
0047 ></menuchoice
0048 ></link
0049 >) para ver o resultado.</para>
0050 
0051 <para
0052 >Cando escribiu e executou as ordes como as de arriba no editor pode que se decatase dunha ou máis das seguintes cousas:</para>
0053 <orderedlist>
0054 <listitem
0055 ><para
0056 >Que &mdash; tras executar as ordes &mdash; o sapoconcho rube, debuxa unha liña, e logo xira un cuarto de volta á esquerda. Isto é debido a que empregou as ordes <link linkend="forward"
0057 ><userinput
0058 >avanza</userinput
0059 ></link
0060 > e <link linkend="turnleft"
0061 ><userinput
0062 >xiraesquerda</userinput
0063 ></link
0064 >.</para>
0065 </listitem>
0066 <listitem>
0067 <para
0068 >Que se cambiou a cor do código mentres a estaba a escribir: esta funcionalidade é chamara <emphasis
0069 >realzado intuitivo</emphasis
0070 > &mdash; distintos tipos de ordes son realzados de xeito distinto. Isto facilita a lectura de grandes bloques de código.</para>
0071 </listitem>
0072 <listitem>
0073 <para
0074 >Que o animal debuxa unha liña branca fina.</para>
0075 </listitem>
0076 <listitem>
0077 <para
0078 >Quizais obteña unha mensaxe de erro. Isto simplemente significará dúas cousas: ou que cometeu un erro ao copiar as ordes, ou que aínda non indicou a linguaxe correcta para as ordes de &turtlescript; (pode facelo mediante <menuchoice
0079 ><guimenu
0080 >Configuración</guimenu
0081 ><guisubmenu
0082 >Linguaxe do script</guisubmenu
0083 ></menuchoice
0084 >).</para>
0085 </listitem>
0086 </orderedlist>
0087 
0088 <para
0089 >Posibelmente xa se decatase de que <userinput
0090 >avanza 100</userinput
0091 > ordenoulle ao sapoconcho que se mova cara diante deixando un rastro, e que <userinput
0092 >xiraesquerda 90</userinput
0093 > é para que o animal xire 90 <glossterm linkend="degrees"
0094 >graus</glossterm
0095 > á esquerda.</para>
0096 
0097 <para
0098 >Consulte as seguintes ligazón ao manual de referencia para ter unha explicación completa das seguintes ordes: <link linkend="forward"
0099 ><userinput
0100 >avanza</userinput
0101 ></link
0102 >, <link linkend="backward"
0103 ><userinput
0104 >retrocede</userinput
0105 ></link
0106 >, <link linkend="turnleft"
0107 ><userinput
0108 >xiraesquerda</userinput
0109 ></link
0110 > e <link linkend="turnright"
0111 ><userinput
0112 >xiradereita</userinput
0113 ></link
0114 >.</para>
0115 </sect2>
0116 
0117 <sect2 id="more-examples">
0118 <title
0119 >Máis exemplos</title>
0120 <para
0121 >O primeiro exemplo era moi simples, continuemos!</para>
0122 
0123 <para>
0124 
0125 <screen
0126 >reinicia
0127 
0128 tamañolenzo 200,200
0129 corlenzo 0,0,0
0130 corlapis 255,0,0
0131 ancholapis 5
0132 
0133 vai 20,20
0134 direccion 135
0135 
0136 avanza 200
0137 xiraesquerda 135
0138 avanza 100
0139 xiraesquerda 135
0140 avanza 141
0141 xiraesquerda 135
0142 avanza 100
0143 xiraesquerda 45
0144 
0145 vai 40,100
0146 </screen
0147 >Novamente, pode escribir ou copiar e pegar o código no editor ou abrir o exemplo <filename
0148 >frecha</filename
0149 > no menú <guimenu
0150 >Exemplos</guimenu
0151 > e executalo (mediante <link linkend="run-execute"
0152 ><menuchoice
0153 ><guimenu
0154 >Executar</guimenu
0155 ><guimenuitem
0156 >Executar</guimenuitem
0157 ></menuchoice
0158 ></link
0159 >) para ver o resultado. Nos seguintes exemplos suponse que coñece o sistema.</para>
0160 
0161 <para
0162 >Posibelmente xa se decatou de que este segundo exemplo utiliza moito máis código. Tamén hai un par de ordes novas. Velaí vai unha explicación breve das novas ordes:</para>
0163 
0164 <para
0165 >Tras unha orde <userinput
0166 >reinicia</userinput
0167 > todo volve ser como se acabase de arrincar &kturtle;.</para>
0168 
0169 <para
0170 ><userinput
0171 >tamañolenzo 200,200</userinput
0172 > fai que a anchura e altura do lenzo sexa de 200 <glossterm linkend="pixels"
0173 >píxeles</glossterm
0174 >. A anchura e a altura son iguais, polo que o lenzo será un cadrado.</para>
0175 
0176 <para
0177 ><userinput
0178 >corlenzo 0,0,0</userinput
0179 > fai que o lenzo sexa negro. <userinput
0180 >0,0,0</userinput
0181 > é unha <glossterm linkend="rgb"
0182 >combinación RGB</glossterm
0183 > onde todos os valores son <userinput
0184 >0</userinput
0185 >, o que dá a cor negra.</para>
0186 
0187 <para
0188 ><userinput
0189 >corlapis 255,0,0</userinput
0190 > fai que a cor do lapis sexa vermella. <userinput
0191 >255,0,0</userinput
0192 > é unha <glossterm linkend="rgb"
0193 >combinación RGB</glossterm
0194 > onde só a cor vermella é <userinput
0195 >255</userinput
0196 > (total) mentres que as outras (verde e azul) son <userinput
0197 >0</userinput
0198 > (nulas). Isto resulta na cor vermella.</para>
0199 
0200 <para
0201 >Se non comprende os valores das cores, lea a entrada no glosario sobre as <glossterm linkend="rgb"
0202 >combinacións RGB</glossterm
0203 >.</para>
0204 
0205 <para
0206 ><userinput
0207 >ancholapis 5</userinput
0208 > fai que a anchura (o tamaño) do trazo sexa de <userinput
0209 >5</userinput
0210 > <glossterm linkend="pixels"
0211 >píxeles</glossterm
0212 >. De agora en diante cada liña que debuxe o sapoconcho terá un gordo de <userinput
0213 >5</userinput
0214 >, ata que cambie o <userinput
0215 >ancholapis</userinput
0216 >.</para>
0217 
0218 <para
0219 ><userinput
0220 >vai 20,20</userinput
0221 > fai que o animal vaia a un certo lugar do lenzo. Contando desde a esquina superior esquerda, este lugar está a 20 <glossterm linkend="pixels"
0222 >píxeles</glossterm
0223 > da esquerda, e 20 <glossterm linkend="pixels"
0224 >píxeles</glossterm
0225 > para baixo do cume do lenzo. Lembre que cando se utiliza a orde <userinput
0226 >vai</userinput
0227 > o sapoconcho non debuxa liña ningunha.</para>
0228 
0229 <para
0230 ><userinput
0231 >direccion 135</userinput
0232 > estabelece a dirección a onde mira o sapoconcho. As ordes <userinput
0233 >xiraesquerda</userinput
0234 > e <userinput
0235 >xiradereita</userinput
0236 > cambian o ángulo do animal desde a posición actual. A orde <userinput
0237 >direccion</userinput
0238 > cámbiao desde o cero, e polo tanto non é relativo á dirección anterior do sapoconcho.</para>
0239 
0240 <para
0241 >Despois da orde <userinput
0242 >direccion</userinput
0243 > van unha morea de ordes <userinput
0244 >avanza</userinput
0245 > e <userinput
0246 >xiraesquerda</userinput
0247 >. Estes son os que fan o debuxo en si.</para>
0248 
0249 <para
0250 >Finalmente outra orde <userinput
0251 >vai</userinput
0252 > move o sapoconcho para un lado.</para>
0253 
0254 <para
0255 >Siga as ligazóns á referencia. Aló explícase cada orde con máis detalle.</para>
0256 
0257 
0258 </sect2>
0259 </sect1>
0260 
0261 
0262 
0263 <!--        EXTRA SECTIONS CAN BE ADDED TO THE "GETTING STARTED"
0264 
0265 <sect1 id="calculations">
0266 <title
0267 >Simple Calculations</title>
0268 <para>
0269 Not yet written
0270 </para>
0271 </sect1>
0272 <sect1 id="using_variables">
0273 <title
0274 >Using Variables: creating 'number containers'</title>
0275 <para>
0276 Not yet written
0277 </para>
0278 </sect1>
0279 <sect1 id="using_strings">
0280 <title
0281 >Using strings: creating 'text containers'</title>
0282 <para>
0283 Not yet written
0284 </para>
0285 </sect1>
0286 <sect1 id="logic">
0287 <title
0288 >Logic: asking the computer simple questions</title>
0289 <para>
0290 Not yet written
0291 </para>
0292 </sect1>
0293 <sect1 id="recursion">
0294 <title
0295 >Recursion: the Turtle is using itself</title>
0296 <para>
0297 Draw a maze for example
0298 </para>
0299 </sect1>
0300 -->
0301 
0302 
0303 </chapter>