Manual de Plug-ins do Kate
Copyright © 2001, 2002
É concedida permissão para copiar, distribuir e/ou modificar este documento sob os termos da Licença de Documentação Livre GNU, Versão 1.1 ou qualquer versão posterior publicada pela Fundação do Software Livre; com nenhuma Seção Não Modificável, com nenhum Texto de Capa, e com nenhum Texto de Contra-Capa. Uma cópia da licença está incluída na seção intitulada "Licença de Documentação Livre GNU".
Este é o manual para os plug-ins do Kate, o Editor de Texto Avançado.
Índice
Os plug-ins do Kate são funções adicionais para o editor Kate. Elas podem adicionar menus extras e atalhos e estender as opções do Kate. Você pode instalar tantas quantas desejar, dentro do Kate.
Mais informações de como usar oKate e habilitar os plug-ins desejados estão disponíveis no manual do Kate.
Os plug-ins instalados neste manual são:
Este plug-in dá pistas sobre o que é permitido em certa posição de um arquivo XML, de acordo com o DTD do arquivo. Ele listará possíveis elementos, atributos, valores de atributos ou entidades, dependendo da posição do cursor (por exemplo, todas as entidades são listadas se o caractere a esquerda do cursor for “&”). Também é possível fechar a tag aberta mais próxima a 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/, o qual também é a pasta padrão quando você escolhe . Para produzir seus próprios meta DTDs, pegue o dtdparse em http://dtdparse.sourceforge.net.
Inicie o Kate e selecione Complementação XML do Kate o qual aparecerá na seção Aplicação/Plug-ins sob ->. Após isto, selecione ->. Se o seu documento não contém “DOCTYPE” ou o doctype é desconhecido, você terá que selecionar um meta DTD do sistema de arquivo. Senão, o meta DTD que combinar com o DOCTYPE do documento atual será carregado automaticamente.
Você pode agora usar o plug-in enquanto digita seu texto:
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 (isto é “<html>”).
A chave de citação disparará uma lista dos valores de atributos possíveis (se existirem) se você estiver dentro de uma tag.
Isto disparará uma lista dos atributos possíveis para o elemento atual se você estiver dentro de uma tag.
Isto disparará uma lista de entidades nomeadas.
Você pode testar todas as funções e limitações carregando $KDEDIR/share/apps/katexmltools/testcases.xml no Kate e seguindo as instruções. Note que trabalhar com mais de uma visualização por documento ainda não é suportado corretamente por este plug-in.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Isto abrirá um dialogo que lhe permite inserir um elemento XML. Os caracteres <, > e a tag de fechamento serão inseridas automaticamente. Se você tiver selecionado texto quando este item de menu for selecionado, o texto selecionado será circundado pelas tags de abertura e fechamento. O dialogo também oferece Complementação de todos os elementos que podem ser inseridos na posição atual do cursor se você tiver designado um meta DTD usando .
Isto irá pesquisar em seu texto por uma tag que não está ainda fechada e irá fecha-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á.
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.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Plug-in “Complementação de XML” do Kate - copyright 2001,2002 Daniel Naber (daniel.naber AT t-online.de).
Copyright da Documentação 2001,2002 por Daniel Naber
Tradução de José Monteiro (monteiro AT ajato.com.br)
Este programa é licenciado sob os termos da Licença Pública Geral GNU.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
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. por exemplo, 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 XML veja em Páginas oficiais W3C XML.
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.
Plug-in “Validação de XML” do Kate - copyright 2002 Daniel Naber (daniel.naber AT t-online.de).
Copyright da Documentação 2002 por Daniel Naber
Tradução de José Monteiro (monteiro AT ajato.com.br)
Este programa é licenciado sob os termos da Licença Pública Geral GNU.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
O plug-in “Inserir Comando” permite que você insira comandos de saída shell em um documento aberto no Kate.
Para usar o plug-in, selecione no menu. o qual lhe apresentará um pequeno diálogo para digitar o comando, escolher uma pasta de trabalho e selecionar ou não a inclusão de erros (saída STDERR) no texto inserido. Você pode também ter o a linha de comando impressa acima da saída.
O plug-in pode lembrar um numero de comandos conforme escolhido na pagina de configuração. Estes são usados para completação automática, e pode ser selecionado de uma lista na entrada de comandos.
Por padrão, o comando rodará na pasta do processo do kate, o qual usualmente é a sua pasta de trabalho. Isto pode ser mudado na página de configuração do plug-in.
Note que todo comando shell que requer entrada de usuário (passwd,por exemplo) ou que usa uma interface ncurses ou algo similar (top, por exemplo), falhará em produzir a saída desejada
Para configurar o plug-in “Inserir Comando”, abra o diálogo de configuração do Kate a partir do menu e escolha +Inserir Comando.
As seguinte opções de configuração estão disponíveis:
Esta configuração se apresenta como uma caixa de giro a qual você pode ajustar para o numero de comandos a serem lembrados. Qualquer numero de 0 ate 99 é legal.
Esta configuração apresentada como um grupo de botões de rádio, permite que você decida como a pasta de trabalho de um comando é escolhida. As opções são: a pasta de trabalho de processo do kate (usualmente a sua pasta de trabalho home, 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 rodado no plug-in.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Plug-in “Inserir Comando” do Kate - copyright 2001 Anders Lund (anders AT alweb.dk).
Direitos de Copia 2001 Anders Lund (anders AT alweb.dk)
Tradução de José Monteiro (monteiro AT ajato.com.br)
Este programa é licenciado sob os termos da Licença Pública Geral GNU.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
O plug-in de ferramentas de “HTML” para o Kate atualmente não tem documentação. Se você está interessado em retificar esta situação, por favor contate Lauri Watts (lauri AT kde.org), Coordenador do Time de Documentação do KDE.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
O plug-in “Abrir Cabeçalho” do Kate atualmente não tem documentação. Se você está interessado em retificar isto por favor contate Lauri Watts (lauri AT kde.org
>
>). Coordenadora do Time de Tradução do KDE.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
O plug-in “Filtro de Texto” do Kate atualmente não tem documentação. Se você está interessado em retificar esta situação, por favor contate Lauri Watts (lauri AT kde.org), Coordenadora do Time de Documentação do KDE.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
O plug-in de Modelos de Arquivo permite criar arquivos baseados em outros arquivos. Você pode usar qualquer arquivo como um modelo, que criará uma cópia do arquivo com uma URL vazia, ou usar um arquivo de modelo especial que pode conter macros para preencher informações como seu nome e endereço de e-mail, a data atual dentre outras, e posicionar o cursor numa posição adequado no novo arquivo.
Além do mais, modelos localizados no diretório de modelos serão apresentados no ítem de menu ->.
O plug-in também fornece um método para criar facilmente um novo modelo a partir de um documento aberto.
O diretório de modelos é parte do sistema de arquivos do KDE, e consiste pelo menos do KDEDIR/share/applications/kate/plug-ins/katefiletemplates/templates e do KDEHOME/share/applications/kate/plug-ins/katefiletemplates/templates. Se sua variável de ambiente KDEDIRS contiver diretórios adicionais, serão procurados nestes diretórios por um subdiretório semelhante. Se modelos com mesmo nome forem encontrados, o do diretório local (KDEHOME) será escolhido.
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.
Apresenta uma lista de arquivos recentemente usados como modelos, representados por suas URL.
O lembrador de submenus contém os links para modelos. Clique em um ítem de menu para criar um arquivo como descrito pelo texto do ítem de menu.
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.
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.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Para criar um novo modelo, use o ítem -> para lançar o diálogo de gerenciamento de modelo. Neste diálogo, clique em 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.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Para editar um modelo, use o ->. Selecione o modelo que você deseja editar e clique em , 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.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Se você usar arquivos com extensão katetemplate, eles serão analisados por informações de modelo, macros e uma posição do cursor.
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:
TemplateEste é o nome do modelo, exibido no menu ->.
GroupO grupo de lugares do modelo no submenu do menu ->.
NameEste é 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.
HighlightO plug-in tentará configurar o Destaque para o novo documento para o valor desta variável. O valor deve ser o nome, como encontrado em ->.
DescriptionUma descrição informativa curta do modelo. Isto é atualmente usado para configurar um string 'O Que É Isto?' para o ítem de menu, mas pode ser usado para outras finalidades no futuro.
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 ítem de menu, mas pode ser usado para outras finalidades no futuro.
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:
Expande para a hora atual no seu formato local.
Expande para a data atual no formato reduzido.
Expande para a data e hora atual formatado como um string de acordo com seu local.
O ano atual como um número de quatro dígitos.
O nome completo do mês atual, de acordo com seu local.
Expande para o dia atual do mês.
Expande para o 'nome de máquina' do seu computador.
Expande para 'i'.
Expande para seu nome completo, como definido pelo endereço do dono em seu livro de endereços padrão do KDE.
Expande para seu primeiro nome, como definido pelo endereço do dono em seu livro de endereços padrão do KDE.
Expande para seu último nome, como definido pelo endereço do dono em seu livro de endereços padrão do KDE.
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.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Plug-in Kate de “Modelos de Arquivo” direitos autorais 2004 Anders Lund (anders AT alweb.dk).
Direitos autorais da documentação 2004 para Anders Lund
Tradução de Marcus Gama(marcus_gama AT uol.com.br)
Este programa é licenciado sob os termos da Licença Pública Geral GNU.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Direito de cópia para cada mini-aplicativo está listado no capítulo aplicável.
Esta documentação é licenciada sob os termos da Licença de Documentação Livre GNU.
Este programa é licenciado sob os termos da Licença Pública Geral GNU.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team