<?xml version="1.0" ?>
<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN"
"dtd/kdedbx45.dtd" [
<!ENTITY kappname "&kwrite;">
<!ENTITY % Brazilian-Portuguese "INCLUDE"
> <!-- change language only here -->
]>

<article id="kwrite" lang="&language;">

<articleinfo>
<title
>Manual do &kwrite;</title>
<authorgroup>
<author
>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
<othercredit role="developer"
>&Christoph.Cullmann; &Christoph.Cullmann.mail; </othercredit>

<othercredit role="translator"
><firstname
>Marcus</firstname
><surname
>Gama</surname
><affiliation
><address
><email
>marcus.gama@gmail.com</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
><othercredit role="translator"
><firstname
>André Marcelo</firstname
><surname
>Alvarenga</surname
><affiliation
><address
><email
>alvarenga@kde.org</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> <othercredit role="translator"
><firstname
>Antonio Henrique L.</firstname
><surname
>Rodrigues</surname
><affiliation
><address
><email
>ahlr_2000@yahoo.com</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
>  

</authorgroup>

<copyright>
<year
>2014</year>
<holder
>&TC.Hollingsworth; &TC.Hollingsworth.mail;</holder>
</copyright>
<legalnotice
>&FDLNotice;</legalnotice>

<date
>2021-09-02</date>
<releaseinfo
>KDE Gear 21.12</releaseinfo>

<abstract>
<para
>&kwrite; é um editor de texto do &kde;, que permite a edição de apenas um arquivo por janela.</para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>KWrite</keyword>
<keyword
>texto</keyword>
<keyword
>editor</keyword>
</keywordset>

</articleinfo>

<sect1 id="introduction">
<title
>Introdução</title>

<para
>O &kwrite; é mais do que um editor de texto do &kde;. Ele foi projetado para ser um editor para programadores, e pode ser considerado pelo menos como uma alternativa parcial para a maioria dos editores mais poderosos. Em conjunto com o &konqueror; ou &dolphin;, ele pode ser melhor usado para a navegação por arquivos de código para diferentes linguagens de programação. O &kwrite; também funciona muito bem como um simples editor de texto. Uma das principais funcionalidades do &kwrite; é a sintaxe colorida personalizada para várias linguagens de programação, como por exemplo: C/C++, &Java;, Python, Perl, Bash, Modula 2, &HTML; e Ada. Possui uma interface para documentos individuais (<acronym
>SDI</acronym
>), que permite a edição de apenas um arquivo por janela. </para>

<para
>O &kwrite; é uma interface simples para o componente &katepart;, que também é usado pelo &kate;, &kdevelop;, e por outros aplicativos do &kde;, que precisam de funcionalidades avançadas para edição de texto. Portanto, a documentação completa das funcionalidades do &kwrite; pode ser encontrada no <ulink url="help:/katepart"
>Manual do &katepart;</ulink
>. </para>
</sect1>

<sect1 id="command-line-options">
<title
>Opções da linha de comando</title>

<para
>Embora o &kwrite; possa ser geralmente iniciado a partir do &plasma; através do menu de programas, ou de um ícone da área de trabalho, ele também poderá ser aberto a partir da linha de comando de uma janela do terminal. Existem algumas opções úteis que estão disponíveis ao fazer isso. </para>

<para
>Muitos outros aplicativos que usam o &katepart; oferecem opções de linha de comando similares.</para>

<sect2 id="specify-a-file">
<title
>Especificar um arquivo</title>

<para
>Especificando o caminho e o nome de um arquivo em particular o usuário pode fazer com que o &kwrite; abra (ou crie) esse arquivo imediatamente após iniciar. Esta opção pode parecer algo como o seguinte:</para>

<informalexample
><screen
><prompt
>%</prompt
> <userinput
><command
>kwrite</command
> <option
><replaceable
>/home/minhahome/docs/meuarquivo.txt</replaceable
></option>
</userinput
>
</screen>
</informalexample>
</sect2>
<sect2 id="editing-files-on-the-internet">
<title
>Especificar um arquivo da Internet</title>

<para
>O método acima mencionado também pode ser usado para abrir arquivos na Internet (se o usuário tiver uma conexão ativa no momento). Um exemplo disso pode parecer com o seguinte:</para>

<informalexample
><screen
><prompt
>%</prompt
> <userinput
><command
>kwrite</command
> <option
><replaceable
>ftp://ftp.kde.org/pub/kde/README</replaceable>
</option
></userinput
>
</screen>
</informalexample>

</sect2>

<sect2 id="other-command-line-options">
<title
>Outras opções de linha de comando</title>

<para
>As seguintes opções de ajuda de linha de comando estão disponíveis</para>

<variablelist>

<varlistentry>
<term
><userinput
><command
>kwrite</command
> <option
>--help</option
></userinput
></term>
<listitem
><para
>Apresenta as opções mais básicas disponíveis a partir da linha de comando.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
><command
>kwrite</command
> <option
>--author</option
></userinput
></term>
<listitem
><para
>Apresenta os autores do &kwrite; na janela do terminal</para
></listitem>
</varlistentry>
<varlistentry>

<term
><userinput
><command
>kwrite</command
> <option
>-v</option
>, <option
>--version</option
></userinput
></term>
<listitem
><para
>Lista informações da versão do aplicativo.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
><command
>kwrite</command
> <option
>--license</option
></userinput
></term>
<listitem>
<para
>Mostra informações sobre a licença.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><userinput
><command
>kwrite</command
> <option
>--desktopfile</option
> <parameter
>nome do arquivo</parameter
></userinput
></term>
<listitem
><para
>Nome do arquivo base de entrada da área de trabalho para este aplicativo.</para>
<para
>Isso é particularmente útil para aplicativos wrapper e aplicativos que geralmente possuem vários arquivos da área de trabalho. Assim, cada arquivo da área de trabalho pode ter sua própria linha de comando para a entrada <option
>Exec</option
>. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
><command
>kwrite</command
> <option
>-e</option
>, <option
>--encoding</option
> <parameter
>codificação</parameter
> </userinput
></term>
<listitem
><para
>Faz com que o &kwrite; use a codificação especificada para o documento. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
><command
>kwrite</command
> <option
>-l</option
>, <option
>--line</option
> <parameter
>linha</parameter
> </userinput
></term>
<listitem
><para
>Navegue até a linha especificada após abrir o documento. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
><command
>kwrite</command
> <option
>-c</option
>, <option
>--column</option
> <parameter
>coluna</parameter
> </userinput
></term>
<listitem
><para
>Navegue até a coluna especificada após abrir o documento. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
><command
>kwrite</command
> <option
>-i</option
>, <option
>--stdin</option
></userinput
></term>
<listitem
><para
>Faz com que o &kwrite; leia o conteúdo do documento a partir do STDIN. É semelhante à opção <option
>-</option
> normalmente usada em muitos programas de linha de comando e permite direcionar a saída do comando para o &kwrite;.</para
></listitem>
</varlistentry>

</variablelist>
</sect2>
</sect1>

<sect1 id="credits">
<title
>Créditos e Licença</title>

<para
>Copyright do &kwrite; 2001-2014 da equipe do &kate;.</para>

<para
>Baseado no &kwrite; original, que possui Copyright 2000 de Jochen Wilhelmy <email
>digisnap@cs.tu-berlin.de</email
> </para>

<para
>Contribuições:</para>

<itemizedlist>
<listitem>
<para
>&Christoph.Cullmann; &Christoph.Cullmann.mail;</para>
</listitem>

<listitem>
<para
>Michael Bartl <email
>michael.bartl1@chello.at</email
></para>
</listitem>

<listitem>
<para
>Phlip <email
>phlip_cpp@my-deja.com</email
></para>
</listitem>

<listitem>
<para
>&Anders.Lund; &Anders.Lund.mail;</para>
</listitem>

<listitem>
<para
>Matt Newell <email
>newellm@proaxis.com</email
></para>
</listitem>

<listitem>
<para
>&Joseph.Wenninger; &Joseph.Wenninger.mail;</para>
</listitem>

<listitem>
<para
>Jochen Wilhelmy <email
>digisnap@cs.tu-berlin.de</email
></para>
</listitem>

<listitem>
<para
>&Michael.Koch; &Michael.Koch.mail;</para>
</listitem>

<listitem>
<para
>&Christian.Gebauer; &Christian.Gebauer.mail;</para>
</listitem>

<listitem>
<para
>&Simon.Hausmann; &Simon.Hausmann.mail;</para>
</listitem>

<listitem>
<para
>Glen Parker <email
>glenebob@nwlink.com</email
></para>
</listitem>

<listitem>
<para
>Scott Manson <email
>sdmanson@altel.net</email
></para>
</listitem>

<listitem>
<para
>&John.Firebaugh; &John.Firebaugh.mail;</para>
</listitem>
</itemizedlist>

<para
>Tradução:</para
><para
>Marcus Gama <email
>marcus.gama@gmail.com</email
></para
><para
>André Marcelo Alvarenga <email
>alvarenga@kde.org</email
></para
> &underFDL; &underGPL; </sect1>

</article>
<!--
Local Variables:
mode: sgml
sgml-namecase-general: t
sgml-namecase-entity: nil
sgml-general-insert-case: lower
sgml-minimize-attributes: nil
sgml-omittag: nil
End:
-->
