# Manual do &kwrite;

## Introdução

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 (SDI), que permite a edição de apenas um arquivo por janela.

O &kwrite; é uma interface simples para o componente &katepart;, que também é usado pelo &kate;, pelo 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 Manual do &katepart;.

## Opções da linha de comando

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.

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

### Especificar um arquivo

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:

    % kwrite
    /home/myhome/docs/myfile.txt

### Especificar um arquivo da Internet

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:

    % kwrite
    ftp://ftp.kde.org/pub/kde/README

### Outras opções de linha de comando

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

``kwrite` `--help``

- Apresenta as opções mais básicas disponíveis a partir da linha de comando.

``kwrite` `--author``

- Apresenta os autores do &kwrite; na janela do terminal

``kwrite` `-v`, `--version``

- Lista informações da versão do aplicativo.

``&kwrite;` `--license``

- Mostra informações sobre a licença.

``kwrite` `--desktopfile` `nome do arquivo``

- Nome do arquivo base de entrada da área de trabalho para este aplicativo.

  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 `Exec`.

``kwrite` `-e`, `--encoding` `codificação``

- Faz com que o &kwrite; use a codificação especificada para o documento.

``kwrite` `-l`, `--line` `linha``

- Navegue até a linha especificada após abrir o documento.

``kwrite` `-c`, `--column` `coluna``

- Navegue até a coluna especificada após abrir o documento.

``kwrite` `-i`, `--stdin``

- Faz com que o &kwrite; leia o conteúdo do documento a partir do STDIN. É semelhante à opção `-` normalmente usada em muitos programas de linha de comando e permite direcionar a saída do comando para o &kwrite;.

## Créditos e Licença

Copyright do &kwrite; 2001-2014 da equipe do &kate;.

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

Contribuições:

- &Christoph.Cullmann; &Christoph.Cullmann.mail;

- Michael Bartl michael.bartl1@chello.at

- Phlip phlip_cpp@my-deja.com

- &Anders.Lund; &Anders.Lund.mail;

- Matt Newell newellm@proaxis.com

- &Joseph.Wenninger; &Joseph.Wenninger.mail;

- Jochen Wilhelmy digisnap@cs.tu-berlin.de

- &Michael.Koch; &Michael.Koch.mail;

- &Christian.Gebauer; &Christian.Gebauer.mail;

- &Simon.Hausmann; &Simon.Hausmann.mail;

- Glen Parker glenebob@nwlink.com

- Scott Manson sdmanson@altel.net

- &John.Firebaugh; &John.Firebaugh.mail;

Tradução:

Marcus Gama marcus.gama@gmail.com

André Marcelo Alvarenga alvarenga@kde.org

&underFDL; &underGPL;