summaryrefslogtreecommitdiffstats
path: root/tde-i18n-pt/docs/tdeedu/kturtle/getting-started.docbook
blob: 37c411156bd46fca7bb937d9198fd2cdd296a005 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
<!--Dear translator: please NEVER translate the id or anything inside the tags as they are needed in english by the application
     Thanks a lot in advance.-->
<chapter id="getting-started">
<title
>Começar</title>
<para
>Quando você inicia o &kturtle; você irá ver algo semelhante a isto: <screenshot
> <screeninfo
>Aqui está uma imagem do &kturtle; quando o inicia pela primeira vez</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="mainwindow.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Janela principal do &kturtle;</phrase
> </textobject
> </mediaobject
> </screenshot
> Neste guia introdutório, iremos assumir que a língua dos comandos é o Inglês. Você poderá mudar esta língua em <menuchoice
><guimenu
>Configuração</guimenu
><guimenuitem
>Configurar o &kturtle;...</guimenuitem
></menuchoice
>, mais concretamente na secção <guilabel
>Língua</guilabel
>. Tenha em atenção que a língua que definir para o &kturtle; necessita de ser a mesma que a língua que usa para escrever os comandos de &logo;.</para>

<sect1 id="first-steps">
<title
>Primeiros passos no &logo;: apresentamos-lhe a Tartaruga!</title>
<para
>Você já deve ter reparado que a tartaruga está no meio da área de desenho: você está agora prestes a aprender como controlá-la, usando os comandos no editor de código.</para>

<sect2 id="the-turtle-moves">
<title
>A Tartaruga Move-se</title>
<para
>Vamos começar por pôr a tartaruga a andar. A nossa tartaruga tem 3 tipos de movimentos: (1) pode ir para a frente e para trás, (2) pode virar à esquerda ou à direita e (3) poderá ir directamente para uma posição do ecrã. Tente isto, por exemplo:</para>
<para>
<screen
>forward 100
turnleft 90 
</screen>
Escreva ou copie e cole o código no editor e execute-o (usando o <link linkend="file-execute"
><menuchoice
><guimenu
>Ficheiro</guimenu
><guimenuitem
>Executar Comandos</guimenuitem
></menuchoice
></link
>) para ver o resultado.</para>

<para
>Quando tiver escrito e executado os comandos acima no editor de código, você irá reparar em uma ou mais das seguintes coisas:</para>
<orderedlist>
<listitem
><para
>Que &mdash; depois de executar os comandos &mdash; a tartaruga vai-se movendo, desenhar uma linha e depois dá um quarto de volta para a esquerda. Isto acontece porque você usou os comandos <link linkend="forward"
><userinput
>forward</userinput
></link
> e <link linkend="turnleft"
><userinput
>turnleft</userinput
></link
>.</para>
</listitem>
<listitem>
<para
>Que a cor do código mudou à medida que o foi escrevendo; esta funcionalidade chama-se <emphasis
>realce intuitivo</emphasis
> &mdash; os diferentes tipos de comandos são realçados de forma diferente. Isto torna a leitura de grandes blocos de código mais fácil.</para>
</listitem>
<listitem>
<para
>Que a tartaruga desenha uma linha preta fina.</para>
</listitem>
<listitem>
<para
>Talvez tenha obtido uma mensagem de erro. Isto poderá simplesmente significar duas coisas: você poderá ter cometido um erro ao copiar os comandos, ou você precisa de definir a língua correcta para os comandos de &logo; (o que você pode fazer escolhendo <menuchoice
><guimenu
>Configuração</guimenu
><guimenuitem
>Configurar o &kturtle;</guimenuitem
></menuchoice
> na secção <guilabel
>Língua</guilabel
>).</para>
</listitem>
</orderedlist>

<para
>Você irá da mesma forma perceber que o <userinput
>forward 100</userinput
> mandou a tartaruga andar em frente, deixando uma linha, e que o <userinput
>turnleft 90</userinput
> disse à tartaruga virar 90 <glossterm linkend="degrees"
>graus</glossterm
> à esquerda.</para>

<para
>Por favor, veja as seguintes referências para o manual para uma explicação completa dos comandos introduzidos: <userinput
>forward</userinput
>, <userinput
>backward</userinput
>, <userinput
>turnleft</userinput
> e <userinput
>turnright</userinput
>.</para>
</sect2>

<sect2 id="more-examples">
<title
>Mais exemplos</title>
<para
>O primeiro exemplo foi muito simples, por isso vamos continuar!</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: tde-i18n/language-code/data/tdeedu/kturtle/ -->
<screen
>canvassize 200,200
canvascolor 0,0,0
pencolor 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>
Mais uma vez, você deverá escrever ou copiar e colar o código para o editor ou abrir o ficheiro <filename
>arrow.logo</filename
> na pasta <guimenu
>Abrir os Exemplos</guimenu
> e executá-lo (usando a opção <link linkend="file-execute"
><menuchoice
><guimenu
>Ficheiro</guimenu
><guimenuitem
>Executar Comandos</guimenuitem
></menuchoice
></link
>) para ver o resultado. Nos próximos exemplos, você já é suposto saber a mecânica do assunto.</para>

<para
>Você poderá já ter notado que este segundo exemplo usa bastante mais código. Você poderá ter visto também um conjunto de comandos novos. Aqui está uma breve explicação de todos os comandos novos:</para>

<para
>O <userinput
>canvassize 200,200</userinput
> configura a largura e a altura da área de desenho para 200 <glossterm linkend="pixels"
>pontos</glossterm
>. A largura e a altura são iguais em tamanho, o que significa que a área de desenho deverá ser agora um quadrado.</para>

<para
>O <userinput
>canvascolor 0,0,0</userinput
> coloca a área de desenho a preto. O <userinput
>0,0,0</userinput
> é uma <glossterm linkend="rgb"
>combinação RGB</glossterm
> onde todos os valores ficam iguais a <userinput
>0</userinput
>, o que corresponde a preto.</para>

<para
>O <userinput
>pencolor 255,0,0</userinput
> coloca a cor do traço a vermelho. O <userinput
>255,0,0</userinput
> é uma <glossterm linkend="rgb"
>combinação RGB</glossterm
> em que só o valor do 'vermelho' fica igual a <userinput
>255</userinput
> enquanto que os outros (verde e azul) ficam a <userinput
>0</userinput
>, o que resulta num tom claro de vermelho.</para>

<para
>Se não compreender os valores das cores, tente por favor ler o glossário sobre as <glossterm linkend="rgb"
>combinações RGB</glossterm
></para>

<para
>O <userinput
>penwidth 5</userinput
> configura a espessura (ou tamanho) do traço a <userinput
>5</userinput
> <glossterm linkend="pixels"
>pontos</glossterm
>. A partir de agora, todas as linhas que a tartaruga desenhar irão ter uma espessura de <userinput
>5</userinput
> pontos, até que se mude o <userinput
>penwidth</userinput
> para outra coisa qualquer.</para>

<para
>O <userinput
>clear</userinput
> limpa a área de desenho, e é tudo o que faz.</para>

<para
>O <userinput
>go 20,20</userinput
> manda a tartaruga ir para um dado lugar da área de desenho. A contar do canto superior esquerdo, este lugar fica a 20 <glossterm linkend="pixels"
>pontos</glossterm
> a contar da esquerda e a 20 <glossterm linkend="pixels"
>pontos</glossterm
> da parte superior. Lembre-se que, ao usar o comando <userinput
>go</userinput
>, a tartaruga não irá desenhar uma linha.</para>

<para
>O <userinput
>direction 135</userinput
> define a direcção da tartaruga. O <userinput
>turnleft</userinput
> e o <userinput
>turnright</userinput
> mudam o ângulo da tartaruga a partir da direcção actual dela. O <userinput
>direction</userinput
> muda o ângulo da tartaruga a partir do zero e, como tal, não é relativo à posição anterior da tartaruga.</para>

<para
>Depois do comando de direcção, segue-se um conjunto de comandos <userinput
>forward</userinput
> e <userinput
>turnleft</userinput
>. Estes comandos fazem, de facto, o desenho.</para>

<para
>Por fim, é usado outro comando <userinput
>go</userinput
> para mover a tartaruga para o lado.</para>

<para
>Certifique-se que segue as referências. Estas explicam cada comando em mais detalhe.</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>