# Menu configurável pelo usuário

## Configuração

O &kile; suporta um menu configurável pelo usuário, que irá aparecer como parte do menu do &kile;. Esse menu pode ser configurado com a opção Configurações Configurar o Kile Menu do Usuário.

Configurar o menu do usuário
Configurar o menu do usuário

Você tem duas opções de local para colocar este menu:

- ou o item do menu Menu do Usuário irá aparecer na barra de menus principal, entre os menus LaTeX e Assistente e o assistente de configuração Editar o Menu do Usuário no menu Assistente

  O Menu do Usuário está colocado no menu principal
  O Menu do Usuário está colocado no menu principal

- ou ambos os itens aparecerão na parte inferior do menu LaTeX.

  O Menu do Usuário como parte do menu LaTeX
  O Menu do Usuário como parte do menu LaTeX

As marcas definidas pelo usuário já existentes em versões mais antigas do &kile; são transformadas automaticamente para o novo menu configurável pelo usuário. As marcas são guardadas num arquivo chamado `usertags.xml` e, como em todos os arquivos de definição do menu, poderão ser encontrados na pasta local dos menus do usuário do &kile;: `KILE_APP_DIR/usermenu/`, &eg;, `/home/usuário/.kde/share/apps/kile/usermenu/`.

Você poderá usar diferentes arquivos de definição do menu para diferentes tarefas. Invoque o assistente do menu do usuário Assistente Editar o Menu do Usuário ou LaTeX Editar o Menu do Usuário para instalar ou editar um arquivo de definição do menu.

## Assistente

Você pode criar menus novos ou alterar os existentes com um assistente de configuração de menus do usuário que poderá ser encontrado em Assistente Editar o Menu do Usuário.

Assistente do Menu do Usuário
Assistente do Menu do Usuário

Do lado esquerdo você verá uma árvore de menu existente. Como em um menu normal, estão disponíveis três tipos de itens:

- itens de menu normais, atribuídos a uma ação

- submenus, que contêm mais itens de menu

- separadores, para obter uma estrutura visível de todos os itens.

Para modificar este menu, use os seis botões do lado esquerdo. As ações mais prováveis estão disponíveis no menu de contexto dos itens já existentes.

Árvore de menus definidos pelo usuário
Árvore de menus definidos pelo usuário

Cada item de menu normal está atribuído a um de três tipos de ações, onde cada um possui diferentes atributos a definir:

- Texto: O &kile; permite-lhe criar as suas próprias marcas. Uma marca é semelhante a um atalho que executa algum comando ou escreve um texto usado com frequência, &eg;, Marcus usa bastante a frase `Olá, eu anexei...` Essa marca será inserida na posição atual do cursor, quando esta ação for invocada (ver acima). Estão também disponíveis metacaracteres (ver ).

- Inserir o conteúdo de um arquivo: Insere o conteúdo completo de um determinado arquivo.

  Inserir o conteúdo de um arquivo
  Inserir o conteúdo de um arquivo

- Executar um programa externo: O resultado deste comando poderá ser inserido no documento aberto. O metacaractere `%M` é também possível na linha de comando deste programa, uma vez que o texto selecionado será salvo em um arquivo temporário. Use o `%M` para o nome desse arquivo temporário.

  Executar um programa externo
  Executar um programa externo

Se faltar alguma informação importante para uma ação, os itens do menu aparecerão em vermelho. Poderá ser, por exemplo, um arquivo inexistente

Arquivo inexistente
Arquivo inexistente

ou a falta de um título para a opção do menu, o qual será apresentado com pontos de interrogação do tipo `???`.

Título faltando de um item do menu
Título faltando de um item do menu

Se você abrir o menu de contexto de um desses itens do menu, irá obter uma opção adicional com mais informações sobre esse erro.

Informações adicionais
Informações adicionais

Mais informações podem estar disponíveis com a funcionalidade O que é isto da maior parte dos itens.

## Substituições

### Inserir um texto

Existem alguns itens de substituição que você poderá usar nas marcas que você definir: `%C`, `%B`, `%M`, `%E`, `%R` e `%T`.

- `%C`: local onde o cursor será colocado depois de inserir uma marca definida pelo usuário.

  Posição do cursor (%C)
  Posição do cursor (%C)

- `%B`: será substituído por um ponto (veja em ).

  Ponto (%B)
  Ponto (%B)

- `%M`: será substituído pelo texto selecionado.

  Texto selecionado (%M)
  Texto selecionado (%M)

- `%E`: define a profundidade de indentação do texto dentro de um ambiente.

  Indentação do texto do ambiente (%E)
  Indentação do texto do ambiente (%E)

- `%R`: abrirá uma janela de referência para escolher uma legenda já definida. Isto pode ser usado para referenciar uma legenda predefinida, que você poderá escolher numa lista (ver também em LaTeX Referências ref ou LaTeX Referências pageref).

  Referências (%R)
  Referências (%R)

- `%T`: abrirá uma janela de citações para escolher uma existente. Como no uso da opção LaTeX Referências Citar, irá aparecer uma lista com todas as chaves de citação.

  Chaves de citação (%T)
  Chaves de citação (%T)

Vejamos outro exemplo, utilizando a macro `\frac{%M}{%C}`. Primeiro, selecionaremos um número no nosso texto, como por exemplo, `42`. Agora iremos invocar esta macro e obter `\frac{42}{}` com o cursor localizado dentro do segundo par de chaves.

### Inserir o conteúdo do arquivo

Se quiser inserir o conteúdo de um arquivo de texto, poderá usar os mesmos itens de substituição.

### Executar um programa

Se quiser executar um programa externo, apenas o `%M` será reconhecido para o texto selecionado na linha de comando. A seleção será salva em um arquivo temporário e o item de substituição `%M` é substituído por este nome de arquivo.

Executar um programa externo (%M)
Executar um programa externo (%M)

Outro item de substituição é o `%S`, que é substituído pelo nome de base completo do documento atual, sem a respectiva pasta. Esse nome de base consiste em todos os caracteres no nome do arquivo até o último caractere '.' (exclusive).

## Parâmetro

A maioria dos itens de menu poderão ter parâmetros intuitivos adicionais, os quais poderão ser verificados. Se alguns desses parâmetros não estiverem disponíveis para algum tipo de ação, serão desativados.

Parâmetro do menu do usuário
Parâmetro do menu do usuário

Aqui está um exemplo de execução de um programa externo:

Exemplo do parâmetro
Exemplo do parâmetro

Você poderá ver que é invocado um programa em `perl`, o qual deverá funcionar com a seleção atual. O parâmetro Necessita de texto selecionado está assinalado para garantir que exista um texto selecionado. O resultado deste programa será inserido (Inserir o resultado do programa escolhido) e substituirá a seleção atual (Substituir o texto selecionado), mas não ficará selecionado por si só.

Claro que você também pode invocar seus próprios programas ou scripts. Por exemplo, selecione uma lista de números, separados por espaços, e invoque um script ou programa Perl, que transforma esta seleção em código &latex; para uma matriz. Quaisquer que sejam suas ideias, você pode realizá-las usando a seguinte entrada do menu do usuário.

Exemplo 2 do parâmetro
Exemplo 2 do parâmetro

## Arquivos de definição do menu

Você poderá instalar diferentes menus durante a execução para diferentes tarefas. Quando invocar o assistente do menu, será carregado o arquivo de definição do menu atual. Se o modificar e fechar a janela com o botão OK, as suas alterações serão salvas e instaladas como novo menu de usuário. Se fechar a janela com o botão Cancelar, irá ignorar todas as alterações.

Arquivos de definição do menu
Arquivos de definição do menu

Você também está livre para salvar o arquivo modificado na pasta de menus do usuário ou carregar e instalar outro arquivo de definições. Todos os arquivos de definições dos menus deverão ser salvos na pasta local dos menus do usuário do &kile;: `KILE_APP_DIR/usermenu/`.

Veja o arquivo de definição do menu de exemplo `example.xml` para ver mais itens de menu com os seus parâmetros.