# Menu Configurável pelo Utilizador

## Configuração

O &kile; suporta um menu configurável pelo utilizador, que irá aparecer como parte do menu do &kile;. Ao usar a janela de configuração do kile; com a opção Configuração Configurar o Kile Menu do Utilizador.

Configurar o menu do utilizador
Configurar o menu do utilizador

Tem duas opções para colocar este menu:

- ou o item do menu Menu do Utilizador irá aparecer no menu principal, entre os itens de menu LaTeX e Assistente e o assistente de configuração Editar o Menu do Utilizador no menu Assistente

  O Menu do Utilizador está colocado no menu principal
  O Menu do Utilizador está colocado no menu principal

- ou ambos os itens irão aparecer no fundo do item LaTeX do menu.

  O Menu do Utilizador como parte do menu LaTeX
  O Menu do Utilizador como parte do menu LaTeX

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

Poderá usar diferentes ficheiros de definição do menu para diferentes tarefas. Invoque o assistente do menu do utilizador Assistente Editar o Menu do Utilizador ou LaTeX Editar o Menu do Utilizador para instalar ou editar um ficheiro de definição do menu.

## Assistente

Pode criar menus novos ou alterar os existentes com um assistente de configuração de menus do utilizador que poderá ser encontrado em Assistente Editar o Menu do Utilizador.

Assistente do Menu do Utilizador
Assistente do Menu do Utilizador

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

- itens de menu normais, atribuídos a uma acçã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. Estão disponíveis ainda mais acções no menu de contexto dos itens já existentes.

Árvore de Menus Definidos pelo Utilizador
Árvore de Menus Definidos pelo Utilizador

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

- Texto: o &kile; dá-lhe a possibilidade de criar as suas próprias marcas. Uma marca é semelhante a um atalho que invoca algum comando ou escreve texto frequente, &eg; o José Pires usa bastante a frase `Olá, venho por este meio ...`. Esta marca será introduzida na posição actual do cursor, quando esta acção for invocada (ver acima). Estão também disponíveis meta-caracteres (ver em ).

- Inserir o conteúdo de um ficheiro: Insere o conteúdo completo de um dado ficheiro.

  Inserir o conteúdo de um ficheiro
  Inserir o conteúdo de um ficheiro

- Executar um programa externo: O resultado deste comando poderá ser introduzido no documento aberto. O meta-carácter `%M` é também possível na linha de comandos deste programa, dado que o texto seleccionado será gravado num ficheiro temporário. Use o `%M` para o nome deste ficheiro temporário.

  Executar um programa externo
  Executar um programa externo

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

Ficheiro inexistente
Ficheiro inexistente

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

Título em falta de um item do menu
Título em falta de um item do menu

Se 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ção adicional

Poderá estar mais alguma informação disponível com a funcionalidade O que é isto da maior parte dos itens.

## Substituições

### Inserir um Texto

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

- `%C`: aqui será onde o cursor será colocado depois de introduzir uma marca definida pelo utilizador.

  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 seleccionado.

  Texto Seleccionado (%M)
  Texto Seleccionado (%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`: irá invocar uma janela de referência para escolher uma legenda já definida. Isto pode ser usado para referenciar uma legenda predefinida, que poderá escolher numa lista (ver também em LaTeX Referênciasref ou LaTeX Referênciaspageref).

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

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

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

Vejamos outro exemplo, com uma macro do tipo `\frac{%M}{%C}`. Primeiro, iremos seleccionar 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 chavetas.

### Inserir o Conteúdo de um Ficheiro

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

### Executar um Programa

Se quiser executar um programa externo, só é reconhecido o `%M` para o texto seleccionado na linha de comandos. A selecção será gravada num ficheiro temporário e o item de substituição `%M` é substituído por este nome de ficheiro.

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 actual, sem a respectiva pasta. Este nome de base consiste em todos os caracteres no nome do ficheiro até ao último carácter '.' (exclusive).

## Parâmetro

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

Parâmetro do Menu do Utilizador
Parâmetro do Menu do Utilizador

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

Exemplo do parâmetro
Exemplo do parâmetro

Poderá ver que é invocado um programa em `perl`, o qual deverá funcionar com a selecção actual. O parâmetro Necessita de texto seleccionado está assinalado para garantir que tem texto seleccionado. O resultado deste programa será introduzido (Inserir o resultado do programa escolhido) e substituirá a selecção actual (Substituir o texto seleccionado), mas não ficará seleccionada por si só.

Obviamente, também poderá invocar os seus próprios programas. Por exemplo, seleccione uma lista de números, separada por espaços, e invoque um programa em Perl (por exemplo), que transforma esta secção em código &latex; para uma matriz. Sejam quais for as suas ideias, podê-las-á realizar com o seguinte item de menu.

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

## Ficheiros de Definição do Menu

Poderá instalar diferentes menus durante a execução para diferentes tarefas. Quando invocar o assistente do menu, será carregado o ficheiro de definição do menu actual. Se o modificar e fechar a janela com o OK, as suas alterações serão gravadas e instaladas como um novo menu de utilizador. Se fechar a janela com o Cancelar, irá ignorar todas as alterações.

Ficheiros de Definição do Menu
Ficheiros de Definição do Menu

Mas também está à vontade para modificar o ficheiro modificado na pasta de menus do utilizador ou para carregar outro ficheiro de definições e instalá-lo. Todos os ficheiros de definição dos menus deverão ser gravados na pasta local dos menus do utilizador do &kile;: `KILE_APP_DIR/usermenu/`.

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