<chapter id="insertcommand">
<chapterinfo>

<title
>Inserir um Comando</title>

<authorgroup>
<author
><firstname
>Anders</firstname
> <surname
>Lund</surname
> <affiliation
> <address
>&Anders.Lund.mail;</address>
</affiliation>
</author>
</authorgroup
> <date
>2006-05-17</date
> <releaseinfo
>3.5.2</releaseinfo
> <abstract
> <para
>O plugin <quote
>Inserir um Comando</quote
> permite-lhe inserir os resultado de comandos de consola num documento aberto no &kate;. </para>
</abstract>
<keywordset>
<keyword
>KDE</keyword>
<keyword
>kate</keyword>
<keyword
>inserir</keyword>
</keywordset>
</chapterinfo>

<title
>Introdução</title>

<para
>O plugin <quote
>Inserir um Comando</quote
> permite-lhe inserir os resultado de comandos de consola num documento aberto no &kate;.</para>

<para
>Para configurar o 'plugin' <quote
>Inserir um Comando</quote
>, abra a janela de configuração do Kate a partir do menu de <menuchoice
><guimenu
>Configuração</guimenu
><guimenuitem
>Configurar o &kate;...</guimenuitem
></menuchoice
> e escolha a página <menuchoice
><guimenuitem
>Plugins</guimenuitem
><guilabel
>Inserir um Comando do &kate;</guilabel
></menuchoice
> e feche-a de seguida.</para>

<sect1 id="insertcommand-fund">
<title
>Fundamental da Interface</title>

<para
>Para usar o plugin, seleccione <guimenu
>Inserir um Comando...</guimenu
> no menu<guimenu
>Ferramentas</guimenu
>, o qual lhe apresentará uma pequena janela onde inserir o comando, escolher uma pasta de trabalho e seleccionar ou não a inclusão de erros (saída STDERR) no texto inserido. Pode também ter a linha de comandos impressa acima do resultado. </para>

<mediaobject>
<imageobject
><imagedata format="PNG" fileref="insertcommand.png"/></imageobject>
<textobject>
<phrase
>A Janela Inserir um Comando</phrase>
</textobject>
</mediaobject>

<para
>O plugin pode recordar um número de comandos conforme escolhido na pagina de configuração. Estes são usados para completação automática, e podem ser seleccionado de uma lista na entrada de comandos. </para>

<para
>Por omissão, o comando será executado na pasta de trabalho do processo do kate, a qual é normalmente a sua directoria pessoal. Isto pode ser mudado na página de configuração do 'plugin'. </para>

<para
>Note que todos os comandos de consola que necessitam uma entrada do utilizador (passwd,por exemplo) ou que utilizem uma interface ncurses ou algo similar (top, por exemplo), não produzirá a saída desejada. </para>

</sect1>

<sect1 id="insertcommand-config">
<title
>Configuração</title>

<para
>Para configurar o 'plugin' <quote
>Inserir um Comando</quote
>, abra a janela de configuração do &kate; a partir do menu de <menuchoice
><guimenu
>Configuração</guimenu
><guimenuitem
>Configurar o &kate;...</guimenuitem
></menuchoice
> e escolha a página <menuchoice
><guimenuitem
>Plugins</guimenuitem
><guilabel
>Inserir um Comando</guilabel
></menuchoice
>. </para>

<mediaobject>
<imageobject
><imagedata format="PNG"
fileref="configure_insertcommand.png"/></imageobject>
<textobject>
<phrase
>A Página de Configuração para Inserir um Comando</phrase>
</textobject>
</mediaobject>

<para
>As seguintes opções de configuração estão disponíveis: </para>

<variablelist>
<varlistentry>
<term
><guilabel
>Número de comandos a recordar</guilabel
></term>
<listitem>
<para
>Esta configuração apresenta-se como um valor que pode ser ajustado para o número de comandos a serem recordados. Qualquer número de 0 ate 99 é válido. O valor por omissão é 20.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Pasta de Trabalho por Omissão</guilabel
></term>
<listitem>
<para
>Esta configuração, apresentada como um grupo de opções, permite-lhe decidir como é escolhida a pasta de trabalho de um comando. As opções são a pasta de trabalho do processo kate (normalmente a sua pasta pessoal, quando o kate é iniciado a partir do menu K), a pasta do documento (se nenhum, a opção acima é usada) ou a pasta de trabalho do último comando executado no 'plugin'. </para>
</listitem>
</varlistentry>

</variablelist>


</sect1>

<sect1 id="insertcommand-thanks-and-acknowledgements">
<title
>Agradecimentos e Reconhecimentos</title>

<para
>Plugin do &kate; <quote
>Inserir um Comando</quote
> copyright 2001 Anders Lund &Anders.Lund.mail;. </para>

<para
>Copyright da documentação 2001 Anders Lund &Anders.Lund.mail; </para>

<para
>Tradução de Pedro Morais <email
>morais@kde.org</email
></para
> 
&underGPL; </sect1>
</chapter>

<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->