<!--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="using-kturtle">
<title
>Usando o &kturtle;</title>

<screenshot>
  <screeninfo
>Aqui está uma imagem do &kturtle; em ação</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="mainwindow_flower_nrs.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Janela principal do &kturtle;</phrase>
    </textobject>
  </mediaobject>
</screenshot>

<para
>A janela principal do &kturtle; tem três partes principais, o <link linkend="the-code-editor"
>editor de código</link
> (3) à esquerda, onde você escreve os comandos do &turtlelang;, o <link linkend="the-inspector"
>inspetor</link
> (4) que fornece a você informações sobre variáveis quando o programa é executado, e a <link linkend="the-canvas"
>área de desenho</link
> (5) à direita, onde as instruções são visualizadas. A <link linkend="the-canvas"
>área de desenho</link
> é a área de recreio da tartaruga; é na área de desenho que a tartaruga se move e desenha. Os quatro outros locais da janela principal são: <link linkend="the-menubar"
>a barra do menu</link
> (1) onde todas as ações podem ser acessadas, a <link linkend="the-toolbar"
>barra de ferramentas</link
> (2) que lhe permite selecionar rapidamente as ações mais utilizadas, o <guilabel
>console</guilabel
>, que você pode usar para digitar uma linha de comando e testá-la e a <link linkend="the-statusbar"
>barra de status</link
> (6) onde você irá encontrar algumas informações sobre o estado do &kturtle;.</para>

<sect1 id="the-code-editor">
<title
>O editor de código</title>
<para
>No editor de código, você poderá escrever os comandos do &turtlelang;. Ele tem todos os recursos que você poderia esperar num editor moderno. A maioria dos seus recursos são encontrados nos menus <link linkend="the-edit-menu"
>Editar</link
> e <link linkend="the-tools-menu"
>Ferramentas</link
>. O editor de código pode ser acoplado a qualquer um dos lados da janela principal ou poderá ser destacado e colocado em qualquer local da sua área de trabalho.</para>
<para
>Você dispõe de várias formas de obter algum código no editor. A forma mais fácil é usar um exemplo já feito: escolha <menuchoice
><guimenu
>Arquivo</guimenu
><guisubmenu
>Abrir exemplos</guisubmenu
></menuchoice
> no <link linkend="the-file-menu"
>menu Arquivo</link
> e selecione um exemplo. O arquivo de exemplo que você escolheu será aberto no <link linkend="the-code-editor"
>editor de código</link
>, você então poderá usar <menuchoice
><guimenu
>Arquivo</guimenu
><guimenuitem
>Executar</guimenuitem
></menuchoice
> para excutar o código se desejar.</para>
<para
>Você poderá abrir os arquivos do &turtlelang; escolhendo <menuchoice
><guimenu
>Arquivo</guimenu
><guimenuitem
>Abrir...</guimenuitem
></menuchoice
>.</para>
<para
>A terceira forma é escrever diretamente o seu código no editor ou copiar/colar algum código deste guia do usuário. </para>
<para
>A posição do cursor é indicada na <link linkend="the-statusbar"
>barra de status</link
> à direita, com o número da linha e da coluna. </para>
</sect1>

<sect1 id="the-inspector">
<title
>O inspetor</title>
<para
>O inspetor informa sobre as variáveis, as funções aprendidas e a árvore de código enquanto o programa está executando. </para>
<para
>O inspetor pode ser embutido em qualquer canto da janela principal ou pode ser desanexado e colocado em qualquer lugar de sua área de trabalho.</para>
</sect1>

<sect1 id="the-canvas">
<title
>A área de desenho</title>
<para
>A área de desenho é a área onde os comandos são visualizados, ou seja, onde eles <quote
>desenham</quote
> uma imagem. Em outras palavras, é a área de recreio da tartaruga. Depois de introduzir algum código no <link linkend="the-code-editor"
>editor de código</link
> e de executá-lo com <menuchoice
><guimenu
>Arquivo</guimenu
><guimenuitem
>Executar</guimenuitem
></menuchoice
>, duas coisas poderão acontecer: ou o código se executa com perfeição e você poderá ver algo mudando na área de desenho, ou você fez um erro no seu código e existirá uma mensagem que lhe dirá qual o erro que você cometeu.</para>
<para
>Esta mensagem deverá ajudá-lo a resolver o erro.</para>
<para
>Você poderá ampliar ou diminuir a área de desenho com a roda do seu mouse.</para>
</sect1>

<sect1 id="the-menubar">
<title
>A barra de menu</title>
<para
>Na barra de menu, você irá encontrar todas as ações do &kturtle;. Elas estão nos seguintes grupos: <guimenu
>Arquivo</guimenu
>, <guimenu
>Editar</guimenu
>, <guimenu
>Visualizar</guimenu
>, <guimenu
>Ferramentas</guimenu
>, <guimenu
>Configurações</guimenu
> e <guimenu
>Ajuda</guimenu
>. Esta seção descreve todas estas opções.</para>

<sect2 id="the-file-menu">
<title
>O menu <guimenu
>Arquivo</guimenu
></title>

  <variablelist>
    <anchor id="file-new"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Arquivo</guimenu
> <guimenuitem
>Novo</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Cria um arquivo novo e vazio do &turtlelang;.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-open"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>O</keycap
></keycombo
> </shortcut
> <guimenu
>Arquivo</guimenu
> <guimenuitem
>Abrir...</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Abre um arquivo do &turtlelang;.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-open-recent"/>
    <varlistentry>
      <term
><menuchoice
><guimenu
>Arquivo</guimenu
> <guisubmenu
>Abrir recente</guisubmenu
> </menuchoice
></term>
      <listitem
><para
>Abre um arquivo do &turtlelang; que foi aberto recentemente.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-open-examples"/>
    <varlistentry>
      <term
><menuchoice
><guimenu
>Arquivo</guimenu
> <guisubmenu
>Exemplos</guisubmenu
> </menuchoice
></term>
      <listitem
><para
>Um exemplo dos programas do &turtlelang;. Os exemplos estão em seu idioma favorito, que poderá ser escolhdio em <menuchoice
><guimenu
>Configurações</guimenu
><guisubmenu
>Linguagem dos scripts</guisubmenu
></menuchoice
>.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-save"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>S</keycap
></keycombo
> </shortcut
> <guimenu
>Arquivo</guimenu
> <guimenuitem
>Salvar</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Salva o arquivo do &turtlelang; aberto atualmente.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-save-as"/>
    <varlistentry>
      <term
><menuchoice
><guimenu
>Arquivo</guimenu
> <guimenuitem
>Salvar como...</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Salva o arquivo do &turtlelang; aberto atualmente num local especificado.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-save-as-picture"/>
    <varlistentry>
      <term
><menuchoice
><guimenu
>Arquivo</guimenu
> <guimenuitem
>Salvar como figura...</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Salva a área de desenho atual como uma imagem.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-execute"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
><keysym
>F5</keysym
></keycombo
> </shortcut
> <guimenu
>Arquivo</guimenu
> <guimenuitem
>Executar</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Inicia a execução dos comandos no editor de código.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-pause"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
><keysym
>F6</keysym
></keycombo
> </shortcut
> <guimenu
>Arquivo</guimenu
> <guimenuitem
>Pausar</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Coloca a execução em pausa. Esta ação só fica ativa quando os comandos estiverem de fato sendo executados.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-stop"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
><keysym
>F7</keysym
></keycombo
> </shortcut
> <guimenu
>Arquivo</guimenu
> <guimenuitem
>Cancelar</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Pára a execução; esta ação só fica ativa quando os comandos estiverem de fato sendo executados.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-speed"/>
    <varlistentry>
      <term
><menuchoice
><guimenu
>Arquivo</guimenu
> <guisubmenu
>Velocidade de execução</guisubmenu
> </menuchoice
></term>
      <listitem
><para
>Apresenta uma lista com as velocidades de execução possíveis, consistindo em: <guimenuitem
>velocidade máxima</guimenuitem
>, <guimenuitem
>velocidade baixa</guimenuitem
>, <guimenuitem
>velocidade mais baixa</guimenuitem
>, <guimenuitem
>velocidade mínima</guimenuitem
> e <guimenuitem
>passo-a-passo</guimenuitem
>. Quando a velocidade de execução é igual <guimenuitem
>velocidade máxima</guimenuitem
> (padrão), você poderá não conseguir ver o que está acontecendo. Em alguns dos casos este comportamento poderá ser o desejado, mas em outros casos você poderá querer ter uma ideia da execução. No último caso, você poderá desejar configurar a velocidade da execução como <guimenuitem
>velocidade baixa</guimenuitem
>, <guimenuitem
>velocidade mais baixa</guimenuitem
> ou <guimenuitem
>velocidade mínima</guimenuitem
>. Quando um dos modos lentos for selecionado, a posição atual de execução será exibida no editor. O <guimenuitem
>passo-a-passo</guimenuitem
> irá executar um comando por vez.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-print"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>P</keycap
></keycombo
> </shortcut
> <guimenu
>Arquivo</guimenu
> <guimenuitem
>Imprimir...</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Imprime o código atual no editor.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-quit"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Arquivo</guimenu
> <guimenuitem
>Sair</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Sai do &kturtle;.</para
></listitem>
    </varlistentry>
  </variablelist>
</sect2>

<sect2 id="the-edit-menu">
  <title
>O menu <guimenu
>Editar</guimenu
></title>
  <variablelist>
    <anchor id="edit-undo"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>Z</keycap
></keycombo
> </shortcut
> <guimenu
>Editar</guimenu
> <guimenuitem
>Desfazer</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Desfaz a última alteração no código. O &kturtle; pode fazer desfazer de forma ilimitada.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="edit-redo"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;&Shift;<keycap
>Z</keycap
></keycombo
> </shortcut
> <guimenu
>Editar</guimenu
> <guimenuitem
>Refazer</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Refaz uma alteração desfeita no código.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="edit-cut"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>X</keycap
></keycombo
> </shortcut
> <guimenu
>Editar</guimenu
> <guimenuitem
>Recortar</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Corta o texto selecionado do editor de código para a área de transferência.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="edit-copy"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>C</keycap
></keycombo
> </shortcut
> <guimenu
>Editar</guimenu
> <guimenuitem
>Copiar</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Copia o texto selecionado do editor de código para a área de transferência.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="edit-paste"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>V</keycap
></keycombo
> </shortcut
> <guimenu
>Editar</guimenu
> <guimenuitem
>Colar</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Cola o texto na área de transferência no editor.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="edit-select-all"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>A</keycap
></keycombo
> </shortcut
> <guimenu
>Editar</guimenu
> <guimenuitem
>Selecionar tudo</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Seleciona todo o texto do editor.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="edit-find"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>F</keycap
></keycombo
> </shortcut
> <guimenu
>Editar</guimenu
> <guimenuitem
>Procurar...</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Com esta ação, você poderá procurar frases no código.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="edit-find-next"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
><keysym
>F3</keysym
></keycombo
> </shortcut
> <guimenu
>Editar</guimenu
> <guimenuitem
>Procurar próximo</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Use isto para procurar a próxima ocorrência da frase.</para
></listitem>
    </varlistentry>
  </variablelist
>  
  <variablelist>
    <anchor id="edit-find-previous"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Shift;<keysym
>F3</keysym
></keycombo
> </shortcut
> <guimenu
>Editar</guimenu
> <guimenuitem
>Localizar anterior</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Use isto para procurar a ocorrência anterior da frase.</para
></listitem>
    </varlistentry>
  </variablelist>
  <!--<variablelist>
    <anchor id="edit-replace"/>
    <varlistentry>
      <term
><menuchoice>
        <shortcut>
          <keycombo
>&Ctrl;<keycap
>R</keycap
></keycombo>
        </shortcut>
        <guimenu
>Edit</guimenu>
        <guimenuitem
>Replace...</guimenuitem>
      </menuchoice
></term>
      <listitem
><para
>With this action you can replace text in the code.</para
></listitem>
    </varlistentry>
  </variablelist
>-->
<variablelist>
    <anchor id="toggle-insert"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
><keycap
>Ins</keycap
></keycombo
> </shortcut
> <guimenu
>Editar</guimenu
> <guimenuitem
>Modo de edição</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Alterne entre o modo de 'inserir' e 'sobrescrever'.</para
></listitem>
    </varlistentry>
  </variablelist>
</sect2>

<sect2 id="the-view-menu">
  <title
>O menu <guimenu
>Ver</guimenu
></title>
  <variablelist>
    <anchor id="view-codeeditor"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>E</keycap
></keycombo
> </shortcut
> <guimenu
>View</guimenu
> <guimenuitem
>Exibir editor</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Exibe ou esconde o editor de código.</para>
</listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="view-inspector"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>I</keycap
></keycombo
> </shortcut
> <guimenu
>Visualizar</guimenu
> <guimenuitem
>Exibir inspetor</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Exibe ou oculta o inspetor.</para>
</listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="view-error"/>
    <varlistentry>
      <term
><menuchoice
><guimenu
>Visualizar</guimenu
> <guimenuitem
>Exibir erros</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Exiba ou esconda a aba <guilabel
>Erro</guilabel
> com a lista de erros resultantes do código em execução. Se esta opção estiver habilitada, clique  na <guilabel
>área de desenho</guilabel
> para ver a tartaruga novamente.</para>
      </listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="view-linenumbers"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
><keysym
>F11</keysym
></keycombo
> </shortcut
> <guimenu
>Ver</guimenu
> <guimenuitem
>Exbir números de linha</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Com esta ação, você poderá mostrar os números de linha no editor de código. Isto poderá ser útil para procurar um erro.</para
></listitem>
    </varlistentry>
  </variablelist>
</sect2>

<sect2 id="the-tools-menu">
  <title
>O menu <guimenu
>Ferramentas</guimenu
></title>
  <variablelist>
    <anchor id="tools-direction-chooser"/>
    <varlistentry>
      <term
><menuchoice
><guimenu
>Ferramentas</guimenu
> <guimenuitem
>Seletor de direção...</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Esta ação abre o diálogo do seletor de direção.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="tools-color-chooser"/>
    <varlistentry>
      <term
><menuchoice
><guimenu
>Ferramentas</guimenu
> <guimenuitem
>Seletor de cores...</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Esta ação abre o diálogo do seletor de cores.</para
></listitem>
    </varlistentry>
  </variablelist>
</sect2>

<sect2 id="the-setting-menu">
  <title
>O menu <guimenu
>Configurações</guimenu
></title>
    <variablelist>
    <anchor id="script-language"/>
    <varlistentry>
<term
><menuchoice
><guimenu
>Configurações</guimenu
> <guisubmenu
>Linguagem de script</guisubmenu
> </menuchoice
></term>
<listitem
><para
><action
>Escolhe</action
> a linguagem para o código.</para
></listitem>
</varlistentry>
  </variablelist
>  
<variablelist>
    <anchor id="toggle-toolbar"/>
    <varlistentry>
<term
><menuchoice
><guimenu
>Configurações</guimenu
> <guimenuitem
>Exibir barra de ferramentas</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Ativa ou desativa</action
> a barra de ferramentas principal</para
></listitem>
</varlistentry>
  </variablelist
>  
  <variablelist>
      <anchor id="toggle-statusbar"/>
   <varlistentry>
<term
><menuchoice
><guimenu
>Configurações</guimenu
> <guimenuitem
>Exibir barra de status</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Alterna</action
> a barra de status</para
></listitem>
</varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="settings-configure-shortcuts"/>
    <varlistentry>
      <term
><menuchoice
><guimenu
>Configurações</guimenu
> <guimenuitem
>Configurar atalhos...</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>O diálogo padrão do &kde; para configurar os atalhos.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="settings-configure-toolbars"/>
    <varlistentry>
      <term
><menuchoice
><guimenu
>Configurações</guimenu
> <guimenuitem
>Configurar barra de ferramentas...</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>O diálogo padrão do &kde; para configurar as barras de ferramentas.</para
></listitem>
    </varlistentry>
  </variablelist>
</sect2>

<sect2 id="the-help-menu">
  <title
>O menu <guimenu
>Ajuda</guimenu
></title>
&help.menu.documentation; </sect2>

</sect1>

<sect1 id="the-toolbar">
<title
>A barra de ferramentas</title>
<para
>Aqui você poderá acessar rapidamente às funções mais usadas. Por padrão, você irá encontrar aqui todos os comandos mais úteis, terminando nos ícones <guiicon
>Executar</guiicon
>, <guiicon
>Pausar</guiicon
>e <guiicon
>Cancelar</guiicon
>. O último ícone da barra de ferramentas é o <guilabel
>console</guilabel
>, que você pode usar para digitar uma linha de comando e testá-la.</para>
<para
>Você poderá configurar a barra de ferramentas usando o menu <menuchoice
><guimenu
>Configurações</guimenu
><guimenuitem
>Configurar barra de ferramentas...</guimenuitem
></menuchoice
></para>
</sect1>

<sect1 id="the-statusbar">
<title
>A barra de status</title>
<para
>Na barra de status você poderá saber o estado do &kturtle;. Do lado esquerdo, ela fornece o resultado da última ação. Do lado direito, você encontra a localização atual do cursor (os números da linha e da coluna). No meio da barra de status é indicado o idioma atual usado para os comandos.</para>
</sect1>

</chapter>
