&Anders.Lund; &Anders.Lund.mail;
Lisiane
Sztoltz

    lisiane@conectiva.com.br

Tradução

# Trabalhando com plugins

O Kate está usando dois tipos diferentes de plug-ins, nomeadamente os plugins para o aplicativo &kate; e os plugins para o componente de edição do &kate;. Os últimos estão disponíveis em qualquer aplicativo que use o componente de edição, como o KDevelop, o Quanta, o Kile, o Kwrite e muitos outros, enquanto os plugins do aplicativo são específicos apenas do &kate;.

Você poderá ativar ambos os tipos de plugins na janela de configuração, a qual também oferece acesso às opções de configuração adicionais dos plugins que necessitem delas.

Existem vários plugins para vários fins e você poderá procurar mais na Web. Alguns plugins são fornecidos com o componente de edição, para fazer inserção automática de parênteses, inserções de arquivos, ferramentas de dados e exportação de texto como &HTML;.

## Plugins do Componente de Edição

A página de Plugins da seção Extensões lista todos os plugins disponíveis e você poderá assinalar os que deseja usar. Clique no botão Informações para abrir a janela Sobre do referido plugin.

Uma vez que um plug-in configurável esteja marcado, o botão Configurar fica habilitado para que se possa clicar nele, de modo a configurar o plug-in realçado.

Parênteses automático

  O plug-in de parênteses automático sobrepõe-se ao recurso interno do &kate; de Parênteses automático. Ele automaticamente insere um parênteses de fechamento } no início da próxima linha após terminar uma linha com um parênteses de abertura { e pressionar o &Enter;.

Ferramentas de dados

  Ativa as ferramentas de dados, como a verificação gramatical e ortográfica (se estiverem instaladas). As ferramentas de dados só ficam disponíveis quando tem texto é selecionado, ou quando o botão direito do mouse é clicado sobre uma palavra. Se não existirem ferramentas de dados disponíveis, mesmo quando selecionar algum texto, você terá que instalá-las. Algumas ferramentas de dados fazem parte do pacote &koffice;. Se este plugin estiver ativo e se as ferramentas de dados estiverem instaladas, irão aparecer alguns itens adicionais no fim do menu do contexto.

Exportador

  Este comando permite que você exporte o documento atual com todas as informações realçadas em um documento HTML usando oArquivo Exportar como HTML. Adicionalmente você pode usar o Editar Copiar como HTML para copiar o texto atualmente selecionado como HTML para a área de transferência do sistema.

Inserção de Ícones

  O plugin de inserção de ícones somente é usado por desenvolvedores do &kde;. Ele adiciona um item Inserir código do KIcon no menu de contexto do editor. Se ativado, o seletor de ícones do &kde; é aberto (mostrando ícones de aplicações, de ações, &etc;...). Se você clicar nele, o nome do arquivo sem extensão será inserido como texto. Isto é útil somente para definir ícones usando a infraestrutura do &kde; através da classe KIcon().

Codificação insana (não ZEN) de HTML (edição leve)

  Um plugin que faz uma codificação Zen como um seletor de completamento. Para mais informações veja a Codificação Zen.

Inserir arquivo

  Este plugin permite que você insira qualquer arquivo legível na posição do cursor. Se ativado, o menu Ferramentas possui um item adicional Inserir arquivo.

## Plugins do aplicativo &kate;

Os plugins do &kate; são funções adicionais para o editor &kate;. Eles poderão adicionar menus e atalhos extra, assim como estender as funcionalidades do &kate;. Você poderá instalar ou desinstalar os que quiser, dentro do &kate;. Abra a janela de configuração do &kate; com a opção Configurações Configurar o &kate;.... Selecione o Aplicativo Plugins para escolher os plugins desejados.

O plugins do aplicativo disponíveis são:

- Área de ferramenta para procura nos arquivos - Uma área que lhe permite procurar em todos os arquivos abertos ou no sistema de arquivos

- GDB - Oferece uma interface simples do GDB

- Navegador de estouros - Janela da ferramenta de navegação dos estouros

- Mudança rápida de documento - Muda rapidamente para outro documento já aberto

- Plugin SQL - Executar uma pesquisa em bases de dados SQL

- Plugin de pesquisa - Procura um padrão nos arquivos

- Barra de páginas - Adiciona uma barra de páginas padrão à janela principal do &kate;

- Filtro de texto - Filtragem simples de texto

- Visualizador de símbolos - Extrair e mostrar os símbolos de referência do código

- Navegador do sistema de arquivos - Ferramenta de navegação no sistema de arquivos

- Área de ferramentas do console - Área de ferramentas que incorpora um console

- Plugin CTags - Procurar definições/declarações com o CTags

- Modelos de arquivo - Cria novos arquivos a partir de modelos

- Abrir cabeçalho - Abre o arquivo .h/[.cpp|.c] correspondente

- Ferramentas externas

- Plugin de compilação - Compila ou executa o Make e processa as mensagens de erro

- Enviar arquivos - Enviar os arquivos por e-mail

- Barra de abas multilinha - Adiciona uma barra de abas com várias linhas à janela principal do &kate;

- Trechos do Kate - Plugin de trechos com suporte a completamento de código

- Plugin de Texto-para-Fala do Jovie - Adiciona um item de meu para falar o texto

- O Validação do &XML; valida arquivos &XML; usando o xmllint

- Completamento de &XML;- Apresenta os elementos de &XML;, os seus atributos, valores e entidades permitidas pela DTD

- Tabulação - Adiciona uma barra de páginas à janela principal do Kate

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

## Modelos de Arquivos

O plugin de Modelos de Arquivos permite-lhe criar arquivos com base em outros arquivos.

Quando instalar o Kate da primeira vez, você terá que ativar o plugin:

1. Clique em Configurações Configurar o Kate

2. Na árvore à esquerda da tela, clique em Plugins.

3. No painel do Gerenciador de Plugins à direita, selecione os Modelos de Arquivos e clique depois em OK.

Você pode agora usar qualquer arquivo como modelo (isto cria uma cópia do arquivo com um &URL; vazio). Os arquivos de modelos especiais poderão conter macros para preencher informações como o seu nome e endereço de e-mail, a data atual, entre outros, colocando o cursor numa posição conveniente do arquivo novo.

Você pode criar facilmente um novo modelo a partir de um documento aberto.

Os modelos que você salvar na pasta de modelos aparecem no item de menu Arquivo Novo a partir do modelo.

A pasta de modelos faz parte do sistema de arquivos do &kde; e consiste em, pelo menos

- `$`KDEDIR`/share/applications/kate/plugins/katefiletemplates/templates`

- `$`KDEHOME`/share/applications/kate/plugins/katefiletemplates/templates.`

Se a sua variável de ambiente `KDEDIRS` contiver pastas adicionais, elas são pesquisadas por subpastas semelhantes. Se forem encontrados modelos com o mesmo nome, é escolhido o da pasta local (KDEHOME).

### Estrutura do Menu

Arquivo Novo a Partir do Modelo Qualquer Arquivo...

  Apresente o diálogo para Abrir Arquivo que permite usar qualquer arquivo como um modelo. Se o arquivo escolhido tiver a extensão `katetemplate` ele será analisado por informações e macros do modelo.

Arquivo Novo a Partir do Modelo

  O lembrador de submenus contém os links para modelos. Clique em um item de menu para criar um arquivo como descrito pelo texto do item de menu.

Configurações Gerenciar Modelos...

  Isto lançará um diálogo com uma lista de todos os modelos encontrados nos diretórios de modelos, junto com opções para adicionar, editar ou remover modelos.

### Usando um Modelo do &kate;

Ao criar um arquivo a partir de um modelo que contenha macros, alguns macros aparecerão como variáveis editáveis no texto. Como variáveis, eles aparecem como palavras sublinhadas no texto.

A primeira variável será selecionada, assim que você tenha digitado para editá-la. Se o texto do documento contiver mais de uma instância da mesma variável, elas serão mudadas assim que você editar a primeira. Para mover para a próxima variável editável, pressione a tecla TAB. Quando a última variável tiver sido editada, a lista é descartada, e sua tecla TAB voltará a funcionar normalmente.

### Criando seus próprios modelos

Para criar um novo modelo, use o item Configurações Gerenciar Modelos para lançar o diálogo de gerenciamento de modelo. Neste diálogo, clique em Novo... para lançar o Assistente de Modelo de Arquivo. Você será questionado por um arquivo opcional para tornar-se um modelo e por configurações de informações do modelo, criando assim um arquivo de modelo para você.

Alternativamente, você pode criar um modelo manualmente adicionando informações do modelo no topo de qualquer arquivo, adicionando texto e macros, e salvando-o com a extensão `katetemplate`.

O menu de modelo será automaticamente atualizado se você escolher armazenar seu modelo no diretório de modelos.

### Editando modelos

Para editar um modelo, use o Configurações Gerenciar Modelos.... Selecione o modelo que você deseja editar e clique em Editar..., e o arquivo de modelo será aberto. Feche o diálogo, edite o arquivo de modelo como desejar, salve-o e feche-o. As mudanças para os modelos terão efeito imediatamente, e você pode ativar o modelo para testar suas mudanças após salvá-lo.

### O Formato de Modelo do &kate;

Se você usar arquivos com extensão `katetemplate`, eles serão analisados por informações de modelo, macros e uma posição do cursor.

#### Informações do modelo

Ao ler um arquivo, o analisador mantém as linhas que iniciam com a frase `katetemplate:` e procura nelas por informações do modelo no formato NOMEDAVARIAVEL=VALOR. A primeira linha que não iniciar com `katetemplate:` será tomada como inicial do conteúdo do modelo. VALOR pode conter qualquer caracter menos o sinal de igual (=). Nomes de variáveis válidos são:

`Modelo`

  Este é o nome do modelo, exibido no menu Arquivo Novo A Partir do Modelo.

`Group`

  O grupo de lugares do modelo no submenu do menu Arquivo Novo A Partir do Modelo.

`Nome`

  Este é o nome que será configurado para o documento, e exibido na lista de arquivos e barra de título. Se o nome contiver `%N` isto será substituído com um número, aumentado se mais documentos tiverem o mesmo nome.

`Highlight`

  O plug-in tentará configurar o Destaque do novo documento para o valor desta variável. O valor deve ser o nome, como encontrado em Ferramentas Destaque .

`Description`

  Uma descrição informativa curta do modelo. Isto é atualmente usado para configurar um string 'O Que É Isto?' para o item de menu, mas pode ser usado para outras finalidades no futuro.

Autor

  Um string identificando o autor, por exemplo na forma `Nome <endereço de email>`. Isto é atualmente usado para configurar um string 'O Quê É Isto?' para o item de menu, mas pode ser usado para outras finalidades no futuro.

#### Macros do modelo

Ao analisar o conteúdo do modelo, macros na forma `%{NOME}` ou `${NOME}` são expandidos. Se você usar o prefixo `$`, o macro expandido será tratado como uma variável editável quando um documento é criado a partir do modelo, enquanto se você usar o `%` ele não é, a menos que a expansão falhe.

Os seguintes macros são expandidos:

`time`

  Expande para a hora atual no seu formato local.

`data`

  Expande para a data atual no formato reduzido.

`datahora`

  Expande para a data e hora atual formatado como um string de acordo com seu local.

`ano`

  O ano atual como um número de quatro dígitos.

`mês`

  O nome completo do mês atual, de acordo com seu local.

`dia`

  Expande para o dia atual do mês.

`hostname`

  Expande para o 'nome de máquina' do seu computador.

`índice`

  Expande para 'i'.

`fullname`

  Expande para seu nome completo, como definido pelo endereço do dono em seu livro de endereços padrão do &kde;.

`nome`

  Expande para seu primeiro nome, como definido pelo endereço do dono em seu livro de endereços padrão do &kde;.

`lastname`

  Expande para seu último nome, como definido pelo endereço do dono em seu livro de endereços padrão do &kde;.

e-mail

  Expande para seu endereço eletrônico, como definido pelo endereço do dono em seu livro de endereços padrão do &kde;.

Qualquer macro que não esteja na lista acima é tratado como uma variável editável independente do prefixo. Se a mesma variável aparecer várias vezes no modelo, elas podem ser editadas de uma vez após criar um documento a partir do modelo.

#### Configurando a posição do cursor

O macro especial `${cursor}` será substituído com uma barra vertical e adicionado ao final da lista de variáveis editáveis, independente de sua localização no texto.

### Agradecimentos e Reconhecimentos

Plug-in Modelos de arquivo &kate; com direitos autorais 2004 de &Anders.Lund; &Anders.Lund.mail;.

Documentação copyright 2004 &Anders.Lund;

Daniel
Naber

    &Daniel.Naber.mail;

## Validação &XML;

Este plug-in verifica arquivos &XML; para consistência e validação.

Este plug-in verifica o arquivo atual. Uma lista de avisos e erros aparecerá na parte de baixo do janela principal do &kate;. Você pode clicar em uma mensagem de erro para pular para o lugar correspondente no arquivo. Se o arquivo tiver um DOCTYPE o DTD dado com este doctype será usado para validar este arquivo. O DTD é esperado em uma posição relativa ao arquivo atual. &eg;, se o doctype se refere ao DTD/xhtml1-transitional.dtd e o arquivo é `/home/peter/test/xml` o DTD deve estar localizado em `/home/peter/DTD/xhtml1-transitional.dtd`. De qualquer modo, DTDs remotos especificados via http são suportados.

se o arquivo não tiver um doctype ele será checado para boa formatação.

Para aprender mais sobre o &XML; consulte as páginas oficiais de &XML; do W3C.

Internamente, este plug-in chama o comando externo `xmllint`, o qual é parte de libxml2. Se este comando não está instalado corretamente em seu sistema, o plug-in não funcionará.

Um arquivo temporário precisa ser escrito na mesma pasta do arquivo a ser verificado, e assim, você deve ter acesso de escrita para aquela pasta.

Para carregar este plugin, abra a janela de configuração do &kate; em Configurações Configurar o &kate;.... Depois, selecione a opção Validação de XML, que irá aparecer na seção Aplicativo/Plugins e feche a janela.

### Estrutura do Menu

XML Validar XML

  Isto iniciará a checagem, conforme descrito acima.

### Agradecimentos e Reconhecimentos

Plug-in para o &kate; de Validação de XML copyright 2002 &Daniel.Naber; &Daniel.Naber.mail;.

Copyright da Documentação 2002 por &Daniel.Naber;

Daniel
Naber

    &Daniel.Naber.mail;

## Completamento &XML;

Este plug-in dá pistas sobre o que é permitido em determinada posição de um arquivo &XML;, de acordo com o DTD do arquivo. Ele lista elementos, atributos, valores de atributos ou entidades válidas, dependendo da posição do cursor (&eg;, todas as entidades são mostradas se o caracter à esquerda do cursor for &). Também é possível fechar a marca aberta mais próxima à esquerda.

O DTD deve existir em formato &XML;, como produzido pelo programa Perl `dtdparse`. Chamaremos um DTD neste formato de meta DTD. Alguns meta DTDs são fornecidos. Eles estão instalados em `$KDEDIR/share/apps/katexmltools/`, que também é a pasta padrão quando você escolhe Designar Meta DTD.... Para produzir seus próprios meta DTDs, baixe o `dtdparse` em http://dtdparse.sourceforge.net.

### Como usar

Inicie o &kate; e abra a janela de configuração em Configurações Configurar o &kate;.... Depois, selecione o Completamento de XML que irá aparecer na seção Aplicação/Plugins, fechando depois a janela. Depois disso, selecione a opção do menu XML Atribuir uma Meta-DTD.... Se o seu documento não tiver nenhum DOCTYPE ou se ele for desconhecido, você terá que selecionar uma meta-DTD no sistema de arquivos. Caso contrário, será carregada automaticamente a meta-DTD que corresponder ao DOCTYPE do documento atual.

Você pode agora usar o plug-in enquanto digita seu texto:

< (chave menor que)

  Isto disparará uma lista dos elementos possíveis a menos que o cursor esteja já dentro de uma tag. Note que você atualmente não pode usar isto para inserir os elementos de nível mais alto (&eg; <html>).

</ (tecla 'menor que' + barra)

  Inserir estes caracteres irá oferecer o fecho do elemento atual (o mais próximo do que se encontra à esquerda do cursor). Pressione &Enter; para aceitar a sugestão. Ao contrário do item Fechar o Elemento, isto funciona apenas com uma DTD atribuída.

" (chave de citação)

  A chave de citação disparará uma lista dos valores de atributos possíveis (se existirem) se você estiver dentro de uma tag.

(chave espaço)

  Isto disparará uma lista dos atributos possíveis para o elemento atual se você estiver dentro de uma tag.

& (chave E comercial)

  Isto disparará uma lista de entidades nomeadas.

### Características e limitações

Você pode testar todas as funções e limitações carregando `$KDEDIR/share/apps/katexmltools/testcases.xml` no &kate; e seguindo as instruções.

### Estrutura do Menu

&Ctrl;Return XML Inserir Elemento...

  Isto irá abrir uma janela que lhe permite inserir um elemento em &XML;. Os caracteres <, > e a marca de fecho serão inseridos automaticamente. Se você tiver selecionado algum texto quando tiver selecionado este item do menu, o texto selecionado será rodeado pela marca de abertura e de fecho. A janela também oferece o completamento de todos os elementos que poderão ser inseridos na posição atual do cursor, caso tenha atribuído uma meta-DTD com a opção Atribuir uma Meta-DTD....

&Ctrl;< XML Fechar Elemento

  Isto irá pesquisar em seu texto por uma tag que não está ainda fechada e irá fechá-la inserindo a tag de fechamento correspondente. A pesquisa inicia na posição do cursor e vai para a esquerda. Se não puder encontrar uma tag aberta nada acontecerá.

XML Designar Meta DTD...

  Isto irá dizer ao plug-in qual meta DTD usar para o documento atual. Note que esta designação não será salva. Você terá que repetir isto quando você iniciar o &kate; na próxima vez.

### Agradecimentos e Reconhecimentos

Plug-in para o &kate; de Completação de &XML; copyright 2001,2002 &Daniel.Naber; &Daniel.Naber.mail;.

Versão para o KDE SC 4 com 'copyright' 2010 de Tomáš Trnka

Copyright da Documentação 2001,2002 por &Daniel.Naber;

## Mudança rápida de documentos

### Estrutura do Menu

&Ctrl;1 Ir Mudança Rápida

  Abre a janela de Mudança Rápida de Documentos com um campo de pesquisa e uma lista com os arquivos abertos. Ao inserir o texto no campo de pesquisa, os nomes e URL's dos documentos são pesquisados com base no texto correspondente. Enquanto introduz texto no campo de pesquisa, você poderá usar as teclas de cursores para Cima e para Baixo para navegar na lista. Se sair da janela com o OK, o plugin fará com que mude para o documento selecionado na lista. Isto torna a mudança de documentos mais simples, caso existam muitos documentos abertos.

## Exportador

### Estrutura do Menu

Arquivo Exportar como HTML...

  Exporta o seu arquivo para o formato &HTML;, para que o documento possa ser visto como uma página Web.

Editar Copiar como HTML...

  Copia o texto selecionado com o realce de sintaxe como texto HTML.

## Procurar nos arquivos

### Estrutura do Menu

Editar Procurar nos arquivos...

  Lança a janela para Procurar nos arquivos que lhe permite procurar por um texto nos documentos de uma pasta.

Exibir Áreas de ferramentas Mostrar o Procurar nos arquivos

  Alterna a exibição da ferramenta Procurar nos arquivos do &kate;.

T.C.
Hollingsworth

    tchollingsworth@gmail.com

## Pesquisar nos arquivos

### Introdução

O plugin Pesquisar nos arquivos do &kappname; permite que você procure por um texto ou expressão regular em vários arquivos de uma só vez. Você pode procurar em todos os arquivos abertos, ou todos os arquivos de uma pasta, e opcionalmente suas subpastas. Você pode até mesmo filtrar por nome de arquivo, para por exemplo procurar somente em arquivos que terminam com uma extensão específica de arquivo.

O plugin Procurar nos arquivos não está ativo por padrão, uma vez que ele é novo no &kappname; 3.7. Ative-o no painel Plugins das configurações do &kappname;. Ele substituirá o antigo plugin Procurar nos arquivos na próxima versão do &kappname;.

### Interface

#### Parâmetros da pesquisa

As opções a seguir são exibidas sempre no topo da ferramenta Pesquisar nos arquivos:

Nova aba

  Você pode ter tantas pesquisas quanto desejar abertas ao mesmo tempo. Basta clicar no botão Nova aba no canto superior esquerdo da ferramenta de Pesquisa e uma nova aba de resultados será aberta, permitindo que você realize outra pesquisa.

Pesquisa

  A grande caixa de texto no topo é onde você digita o que você deseja encontrar. Você pode inserir um texto padrão ou uma expressão regular se este recurso estiver ativo.

Pesquisar

  Quando você tiver terminado de configurar tudo, basta pressionar o botão Pesquisar para que a pesquisa seja realizada. Você pode também pressionar o &Enter; na caixa de texto da Pesquisa para obter o mesmo efeito.

Localização

  Isto possui duas opções. Selecione nos arquivos abertos para pesquisar em todos os arquivos atualmente abertos no &kappname;. Selecione na pasta para pesquisar em uma pasta e opcionalmente suas subpastas.

Opções

  Existem duas opções disponíveis. Se ativado, a opção Corresponder caixa restringirá os resultados da pesquisa para somente aqueles que possuem a mesma combinação de letras maiúsculas e minúsculas do texto de sua pesquisa. A opção Expressões regulares permite que você use expressões regulares ao invés de texto simples como sua pesquisa.

Alternar resultados

  A seta para baixo no canto superior direito da ferramenta Pesquisar nos arquivos alternará a metade inferior da ferramenta entre exibir opções adicionais para o modo Pesquisar na pasta e os resultados de sua pesquisa.

#### Opções do Pesquisar na pasta

Estas opções são exibidas abaixo das opções de consulta mencionadas anteriormente. Se os resultados da pesquisa estiverem sendo exibidos, pressione o botão Alternar resultados para exibi-las. Estas opções se aplicam somente quando o modo Pesquisar na pasta estiver ativo. Se o Pesquisar nos arquivos abertos estiver selecionado, as opções estarão desativadas.

Pasta

  Você pode inserir a localização da pasta que deseja pesquisar. Por exemplo, você pode inserir `~/development/kde/kate/` se deseja pesquisar no código fonte do &kate;.

Diálogo de abertura de arquivo

  Pressione este botão para localizar a pasta no navegador de pastas do seu computador.

Acima

  Pressione este botão para mudar a Pasta para a pasta pai da atualmente selecionada.

Restaurar pasta atual

  Este botão definirá a entrada Pasta para a pasta na qual o documento atual está localizado.

Filtro

  Isto permite que você pesquise somente por nomes de arquivos que correspondam a um determinado padrão. Por exemplo, para pesquisar somente por arquivos escritos em C++, mude isto para `*.cpp`. Para pesquisar somente por arquivos começando com `kate`, mude isto para `kate*`.

Recursivo

  Se esta opção estiver ativa, o &kappname; pesquisará também em todas as subpastas da pasta selecionada.

Incluir ocultos

  Se esta opção estiver ativa, o &kappname; também pesquisará em arquivos ou pastas que estão normalmente ocultos pelo seu &OS;.

Seguir as ligações simbólicas

  O plugin Pesquisar nos arquivos normalmente não segue ligações simbólicas. Quando esta opção estiver ativa, o plugin as seguirá ao invés de pesquisar dentro dos arquivos ou pastas às quais elas se referem.

  É possível ligações simbólicas que se referem a uma pasta que é a pai da pasta que estiver atualmente sendo pesquisada, ou que outras pastas contenham ligações simbólicas para seus pais. Se existir este tipo de ligação na pasta que está sendo pesquisada e esta opção estiver ativa, o &kappname; seguirá repetidamente a ligação e pesquisará a pasta, e a pesquisa nunca terminará.

#### Resultados da pesquisa

Os resultados de sua pesquisa são exibidos abaixo das opções de consulta. Se as opções do modo de Pesquisa em pasta estiverem sendo exibidas, basta pressionar o botão Alternar resultados para exibi-los. Eles também serão automaticamente exibidos tão logo a pesquisa termine.

Os resultados da pesquisa são exibidos em três colunas fornecendo informações sobre cada resultado de sua pesquisa. A coluna Arquivo mostra o nome do arquivo. A coluna Linha mostra o número da linha aonde o conteúdo de sua pesquisa foi encontrado. A coluna Texto exibe o texto completo da referida linha.

Para abrir o arquivo encontrado pela sua pesquisa, basta dar um clique-duplo sobre ele. O &kappname; abrirá o arquivo, se necessário, e posicionará o cursor no início do texto inserido como pesquisa encontrado no arquivo.

### Estrutura do Menu

Exibir Áreas de ferramentas Mostrar o Pesquisar nos arquivos

  Alterna a exibição da ferramenta Pesquisar nos arquivos do &kappname;.

## Enviar arquivos por e-mail

### Estrutura do Menu

Arquivo Enviar por E-mail...

  Abre o seu cliente de e-mail e anexa o arquivo na mensagem de e-mail.

## Navegador do sistema de arquivos

O navegador do sistema de arquivos é um visualizador de pastas que lhe permite abrir os arquivos a partir da pasta mostrada na janela atual.

### Estrutura do Menu

Exibir Áreas de Ferramentas Mostrar o Navegador no sistema de arquivos

  Liga e desliga o navegador do sistema de arquivos do &kate;

### Interface

De cima para baixo, o navegador do sistema de arquivos consiste nos seguintes elementos:

Uma barra de ferramentas

  Contém os botões de navegação padrão da ferramenta:

  Voltar

    Faz com que a visão de pastas, com o comando `cd`, vá para a pasta exibida anteriormente no histórico. Este botão ficará desligado, se não existir o item anterior.

  Avançar

    Faz com que a visão de pastas, com o `cd`, mostre o próxima pasta do histórico. O botão é desabilitado, caso não exista a próxima pasta.

  Favoritos

    Abre um submenu para editar ou adicionar favoritos e para adicionar uma nova pasta de favoritos.

  Pasta de documento atual

    Este botão fará com que a visão de pastas, com o comando `cd` , vá para a pasta do documento atualmente ativo, se possível. Este botão é desabilitado se o documento ativo é um arquivo novo ou ainda não salvo, ou se a pasta no qual ele reside não pode ser definida.

  Opções
    Visão abreviada

      Mostra apenas os nomes dos arquivos.

    Visão detalhada

      Mostra o Nome, Data, Tamanho e Tipo dos arquivos.

    Visão em árvore

      Como a visão abreviada, mas as pastas podem ser expandidas para ver seu conteúdo.

    Visão em árvore detalhada

      Isto também permite que as pastas sejam expandidas, mas exibe as colunas adicionais disponíveis na visão detalhada.

    Exibir arquivos ocultos

      Mostra os arquivos normalmente ocultos pelo seu sistema operacional.

    Sincronizar automaticamente com o documento atual

      Quando esta opções estiver ativa, o navegador do sistema de arquivos fará um `cd` automaticamente para a pasta do documento atualmente aberto na área de edição toda vez que ele mudar.

Um entrada de localização

  Isto exibe uma navegação no estilo 'trilha de pão' para a pasta atualmente aberta, como no &dolphin;. Você pode clicar em qualquer pasta para navegar nela, ou clicar em uma das setas à esquerda de uma pasta para selecionar qualquer pasta a partir dela. Você pode também selecionar a partir de sua lista de locais clicando no ícone mais à esquerda na navegação em 'trilha de pão', que exibe um ícone que representa seu Local atual.

  Você pode também clicar na trilha de pão para mudar para uma caixa de texto de onde pode digitar a localização de uma pasta para navegar. O campo do &URL; mantém uma lista dos campos introduzidos anteriormente. Para escolher um, utilize o botão da seta à direita do campo.

  O campo do &URL; tem a completamento automático das pastas. O método de completamento pode ser definido usando o menu do botão direito do mouse do campo.

Uma visão de pastas

  Esta é uma janela de pastas padrão do &kde;.

Uma entrada de filtro

  A entrada de Filtro permite a você digitar um filtro para arquivos exibidos na visão de pastas. O filtro está usando padrões, que devem estar separados por espaço em branco. Exemplo: `*.cpp *.h *.moc`

  Para exibir todos os arquivos, digite um único asterisco - `*`.

  O campo do filtro salva os últimos 10 filtros inseridos entre sessões. Para usar um, clique no botão de setas à direita do campo e selecione o filtro desejado. Você poderá desativar o filtro se clicar no botão Limpar o texto à esquerda do botão de auto-completamento.

### Configuração

Este plugin pode ser configurado na página do Navegador do sistema de arquivos da configuração do &kate;.

Barra de ferramentas

  Configure os botões no navegador do sistema de arquivos, movendo os que deseja ativar para a lista de Ações Selecionadas e ordenando-os com as setas ao lado da lista.

## Ferramentas externas

No menu Ferramentas, você irá encontrar um submenu chamado Ferramentas externas, se você habilitá-las nas configurações do &kate;. Estas ferramentas invocam os aplicativos externos com dados relativos ao documento atual como, por exemplo, o seu URL, pasta, texto ou seleção.

As ferramentas externas são definidas pelo usuário e você poderá adicionar, editar ou remover as ferramentas com o painel de configuração das Ferramentas externas.

### Estrutura do Menu

Ferramentas Ferramentas externas

  Este submenu contém todas as ferramentas externas que tiver configurado.

### Configuração

As ferramentas externas são configuradas na página Ferramentas externas da configuração do &kate;. Estas ferramentas invocam aplicativos externos com dados relacionados com o documento atual, como por exemplo o seu URL, pasta, texto ou seleção. Esta página permite-lhe gerenciar o menu e editar, remover ou adicionar ferramentas novas.

Cada ferramenta externa é um comando de console que contém macros representando dos dados do documento. Quando estiver ativada, as macros são substituídas por dados do documento ativo.

#### Comandos disponíveis

Novo

  Adiciona uma nova ferramenta externa à lista. Isto irá invocar a folha de propriedades descrita abaixo, onde poderá configurar uma ferramenta externa.

Editar

  Edita a ferramenta externa selecionada no momento, usando a folha de propriedades descrita abaixo.

Inserir separador

  Adiciona uma linha separadora que aparece no menu abaixo do item atualmente selecionado.

Acima

  Sobe o item atualmente selecionado para cima do anterior.

Abaixo

  Desce o item atualmente selecionado para baixo do anterior.

#### Propriedades das ferramentas externas

Legenda

  Uma legenda amigável que aparecerá no menu Ferramentas externas.

Ícone

  Permite que você selecione o ícone que aparece ao lado da legenda no menu de Ferramentas externas.

Programa

  O programa a executar quando a ferramenta estiver ativada. Antes de passar o programa à linha de comando, são substituídas as seguintes macros:

  `%URL`

    O URL completo do documento atual ou um texto vazio, se o documento não estiver salvo.

  `%URLs`

    Uma lista, separada por espaços, dos URLs de todos os documentos abertos (exceto os não-salvos).

  `%directory`

    A parte do diretório do URL do documento atual ou um texto vazio se o documento atual não estiver salvo.

  `%filename`

    O nome do arquivo do documento atual, sem o caminho completo, ou um texto vazio se o documento atual não estiver salvo.

  `%line`

    O número de linha onde o cursor de inserção se encontra no documento atual.

  `%column`

    O número da coluna onde o cursor de inserção se encontra no documento atual.

  `%selection`

    O texto selecionado no documento atual ou um texto vazio se não existir qualquer texto selecionado

  `%text`

    O texto completo do documento atual. Note que este texto poderá exceder potencialmente o comprimento máximo do comando no seu sistema. Use-o com cuidado.

Executável

  O executável principal no programa. Isto é obrigatório e é usado para testar se o comando poderá ser executado de fato. É permitida uma localização absoluta, no caso do executável não se encontrar acessível através da sua variável `PATH`.

Tipos MIME

  Uma lista, separada por pontos-e-vírgulas, dos tipos MIME que estão ativos para este comando. Isto normalmente não é usado

Salvar

  Você poderá, opcionalmente, optar por salvar o documento atual ou todos os documentos, antes de executar o programa. Isto é útil se o seu programa ler o arquivo do disco.

Nome da linha de comando

  Se você preencher isto, a ferramenta estará disponível na linha de comando dos editores como `exttool-nome da linha de comando` (o texto que indicar aqui é antecedido por exttool-).