# Manual do Editor de Menus do &kde;

## Introdução

O &kmenuedit; permite a edição do menu dos lançadores de aplicativos do &kde;.

O &kmenuedit; pode ser iniciado clicando com o &RMB; no botão do lançador de aplicativos no painel e selecionando o Editor aplicativos..., ou digitando `kmenuedit` na linha do &krunner;.

O &kmenuedit; permite-lhe:

- Ver e editar o menu usado pelo lançador de aplicativos atual

- Os submenus Recortar, Copiar e Colar e itens

- Cria e exclui submenus e itens

- Altera a ordem dos submenus e itens

- Oculta os itens e adiciona novos submenus e itens

Por padrão, todos os aplicativos instalados no computador aparecem no menu dos lançadores de aplicativos para todos os usuários. Os aplicativos poderão aparecer mais que uma vez em vários menus diferentes. As categorias de submenus vazias que estiverem definidas na especificação do menu também irão aparecer, mas não ficarão visíveis nos lançadores de aplicativos, a menos que você instale os aplicativos que pertencem a essas categorias.

A exibição em árvore tem dois tipos diferentes de elementos:

- Submenu: Apenas os campos Nome, Comentário e Descrição, bem como o botão para selecionar um ícone estarão habilitados e a aba Avançado estará desabilitada. Qualquer submenu poderá conter vários submenus e/ou itens adicionais.

- Itens: Use este elemento para inserir os dados do aplicativo que deseja adicionar. Para informações mais detalhadas, leia Usando o &kmenuedit;.

O &kmenuedit; tem dois modos de exibição em árvore - normal e com os itens ocultos. Para ver os ocultos, assinale a opção Mostrar os itens ocultos da caixa de diálogo de configuração da página Opções gerais.

Muitos itens adicionais aparecerão no modo de exibição oculta na árvore. Diversos itens ocultos parecem ser simplesmente duplicados, mas têm opções do comando diferentes. Normalmente, você nunca deverá alterar estes itens ocultos, caso contrário, poderá perder alguma funcionalidade do sistema.

No modo oculto, você terá um submenu especial .hidden [Hidden] (oculto) como item mais alto na árvore. Este submenu especial não pode ser editado. Neste submenu, todos os itens excluídos serão apresentados na próxima vez que iniciar o &kmenuedit;.

Não é possível excluir os itens usando a &GUI; neste submenu especial. Eles irão reaparecer da próxima vez que você iniciar o &kmenuedit;.

### Casos de uso

#### Adaptar o menu para um usuário

##### Reordenar os itens

Isto deverá ser feito no modo de exibição oculta, onde aparecem apenas os submenus e itens visíveis no menu do lançador de aplicativos.

Por padrão, o menu aparece ordenado alfabeticamente pelos nomes ou descrições em inglês. Se usar outro idioma, alguns submenus e itens irão aparecer desordenados.

Use as opções em Editar Ordenar para ordenar por nome ou descrição. Se usar o lançador de aplicativos clássico, você deverá escolher o Formato correspondente na caixa de diálogo de configurações. No lançador &kickoff;, assinale a opção Mostrar aplicativos pelo nome se você ordená-los pelo nome neste local.

Se agrupar os seus submenus ou itens usados com maior frequência em conjunto, ⪚, no topo do menu, torna a sua seleção mais simples. Para alterar a ordem dos itens individuais ou submenus na árvore, use os botões Mover para cima ou Mover para baixo na barra de ferramentas ou estas ações no menu.

Todos os lançadores de aplicativos irão usar a ordem dos submenus definida no &kmenuedit;.

##### Remover os itens da área do menu

Ter todos os aplicativos instalados em um computador pode ser confuso para alguns usuários, assim, você pode querer ocultar alguns itens ou submenus menos usados. Existem duas formas diferentes de fazer isso:

Mude para o modo de exibição normal sem itens ocultos. Se excluir os itens, estes serão movidos para o submenu .hidden [Hidden] (oculto). Você poderá trazê-los novamente para a árvore, caso queira recuperá-los.

Se excluir um submenu, ele será realmente excluído, assim como todos os seus submenus e itens. Para criá-los novamente, você poderá usar a opção Editar Restaurar no menu Sistema, mas isto irá remover todos os seus submenus e itens personalizados, bem como os seus arquivos `.desktop` correspondentes. Esta ação não poderá ser revertida.

A forma preferida de remover submenus e itens do menu de um lançador de aplicativos é assinalar a opção Entrada oculta na aba Geral e mudar para o modo de exibição oculta. Neste modo é fácil reverter as alterações, sem destruir a estrutura do menu. A única desvantagem é que você precisará ocultar todos os itens de um submenu de forma manual para ocultar submenu inteiro da árvore.

#### Adicionar itens personalizados

Para adicionar itens personalizados (submenus ou itens), use as ações no menu ou na barra de ferramentas. Os itens precisam de um nome e um comando, pois sem a definição do comando, o item não será salvo e a sua adição será perdida.

Se você adicionar um item, ele será introduzido como subitem na posição atual da árvore. Mova um item arrastando-o com o mouse ou usando o botão Mover para baixo para o base da árvore, de forma a torná-lo um item de nível superior.

#### Transferir as configurações do lançador de aplicativos

Não há uma forma de transferir as configurações do menu usando a &GUI;, você precisa fazer isso manualmente e copiar os seguintes arquivos para o usuário de destino:

O &kmenuedit; armazena a hierarquia de menus em `menus/applications-kmenuedit.menu` na pasta `$(qtpaths --paths GenericConfigLocation)` e `desktop-directories` na pasta `$(qtpaths --paths GenericDataLocation)` contém os arquivos 'desktop' para os submenus que você criou. Em `applications/` na pasta `$(qtpaths --paths GenericDataLocation)` você encontrará os arquivos 'desktop' para os itens personalizados que você criou.

Os atalhos de cada aplicativo são armazenados em `kglobalshortcutsrc` na pasta `$(qtpaths --paths GenericConfigLocation)`, mas a exportação/importação não funciona porque os UUIDs dos atalhos não correspondem entre sistemas, mesmo que os arquivos `.desktop` sejam os mesmos. Você terá que atribuir novamente todos os atalhos de forma manual.

## Adicionando um item do menu

Neste exemplo, será adicionado o &firefox; ao submenu Internet.

Para começar, precisamos abrir o &kmenuedit;, para isso clique com o &RMB; no lançador de aplicativos e clique em Editar aplicativos... para iniciar o &kmenuedit;. Após o &kmenuedit; ter iniciado, selecione Internet como aparece na imagem abaixo. Selecionar a Internet Selecionar a Internet

Logo que tenha selecionado Internet, clique em Arquivo Novo Item..., fazendo abrir a janela Novo Item, como aparece abaixo. Digite o nome do programa que deseja adicionar que é, neste caso, o `firefox`. Janela de Novo Item A janela de Novo Item.

Pressione Return, e você verá algo como a imagem abaixo na janela principal. Novo Item O item novo criado.

Agora, vamos preencher a Descrição:, que neste caso poderá ser `Navegador Web`.

As informações que ficam visíveis, como a descrição e o nome, serão apresentados de acordo com as configurações do lançador de aplicativos, ⪚, Navegador Web (Firefox) ou Firefox (Navegador Web).

Nós teremos que preencher o nome do executável no campo Comando:, que neste caso será ``firefox``.

O comando precisa estar na sua variável `PATH` ou você terá que indicar o caminho completo do executável. Se não souber o nome do executável de um aplicativo, use o comando ``locate`` para procurar pelo arquivo 'desktop' e indique o texto da linha 'Exec' como comando.

Após o comando, você poderá ter vários itens de substituição por outros valores atuais, quando o programa for executado:

- %f - um nome de arquivo único
- %F - uma lista de arquivos; use nos aplicativos que podem abrir vários arquivos locais de uma vez
- %u - um único &URL;
- %U - uma lista de &URL;s
- %d - a pasta do arquivo a abrir
- %D - uma lista de pastas
- %i - o ícone
- %m - o mini-ícone
- %c - o título

Por exemplo: se você quiser que o 'firefox' inicie a sua navegação Web em 'www.kde.org' - em vez do `firefox`, você poderá digitar `firefox %u www.kde.org`.

A maioria dos aplicativos aceitam opções adicionais, como ⪚, o nome de um perfil definido como o &konqueror; ou o &konsole;. Para ver todas as opções de um aplicativo, execute ```nomeaplicativo`` `--help`` no &konsole;.

Seria bom ter um ícone mais criativo, então vamos clicar no ícone genérico que está ao lado do Nome: (observe que o ícone padrão pode estar em branco, e neste caso deve-se clicar na área à direita da caixa de inserção de nome). Ele irá invocar a janela para Selecionar Ícone, que permite-nos escolher um novo ícone, como aparece abaixo. A janela para Selecionar Ícone A janela para Selecionar Ícone.

Nós escolhemos o ícone do 'firefox' na lista; em seguida, pressione &Enter;. A sua tela final deverá ser algo semelhante à imagem abaixo. Imagem final Isto é como deverá ficar o item do menu completo.

O local do novo item do menu poderá ser alterado agora com os botões Mover para cima e Mover para baixo da barra de ferramentas do &kmenuedit; ou arrastando com o mouse.

Os itens do submenu podem ser ordenados com o botão Ordenar da barra de ferramentas do &kmenuedit; ou com a opção do menu Editar Ordenar.

Clique em Arquivo Salvar, espere que a janela Atualizando a Configuração do Sistema termine, para depois encontrar o &firefox; no submenu Internet do lançador de aplicativos.

## Usando o &kmenuedit;

O painel esquerdo do aplicativo mostra a estrutura do lançador de aplicativos. Quando você navega pelos itens deste painel, o painel da direita mostra informações detalhadas sobre o item de menu destacado.

### Página Geral

Nome:

- Este é o nome de seu programa como ele aparece no lançador de aplicativos. Ele pode ser diferente do nome do executável real. Por exemplo, o nome do executável `mc` é "Midnight Commander".

Descrição:

- A descrição será exibida junto com o nome no lançador de aplicativos. Isto é totalmente opcional.

Comentário:

- Descreva o programa em linhas gerais neste campo. Isto é totalmente opcional.

Comando:

- Este é o nome do programa executável. Certifique-se de que você tem permissões para executar o programa.

Ativar o aviso de execução

- Se esta opção estiver assinalada, será mostrado uma reação visual sempre que for iniciado um aplicativo.

Mostrar apenas no &kde;

- Se a opção estiver assinalada, o item do aplicativo só será visível nos lançadores de aplicativos do &kde;, não o sendo nos outros ambientes gráficos.

Item oculto

- Remove um item da área do menu no lançador de aplicativos.

### Aba avançado

Pasta de trabalho:

- Especifique o caminho de trabalho do programa. Ele será o caminho atual quando o programa se iniciar. Ele não precisa ser o mesmo da localização do executável.

Executar em um terminal

- Você deve habilitar isto se seu programa necessita de um emulador de terminal para executar-se. Isto normalmente se aplica a aplicativos de console.

Opções de terminal:

- Coloque todas as opções de terminal neste campo.

Executar como um usuário diferente

- Se você deseja que este programa se execute como um usuário diferente (que não seja você), habilite esta caixa de verificação, e forneça um nome de usuário no campo Nome de usuário:.

Tecla de atalho atual:

- Você pode atribuir um atalho de teclado para iniciar seu programa.

  Clique no botão Nenhum, à direita da opção Tecla de atalho atual:.

  O texto do botão irá mudar para Inserir..., e você poderá pressionar a combinação de teclas que deseja atribuir ao seu programa.

  Você poderá restaurar o atalho como Nenhum usando este botão: .

  Não se esqueça de salvar a sua configuração, clicando para isso no ícone Salvar ou usando o item do menu Arquivo Salvar .

## Referência de Menu

Muitas ações do menu estão também disponíveis no menu de contexto que aparece ao clicar com o &RMB; sobre um item da árvore.

&Ctrl; N Arquivo Novo Item...

- Adiciona novo item de menu.

Arquivo Novo Submenu...

- Adiciona novo submenu.

&Ctrl; S Arquivo Salvar

- Salva o menu

&Ctrl;Q Arquivo Sair

- Sai do &kmenuedit;.

Editar Mover para cima

- Move o item selecionado para cima no seu submenu.

Editar Mover para baixo

- Move o item selecionado para baixo no seu submenu.

&Ctrl;X Editar Recortar

- Corta o item de menu para a área de transferência. Se você deseja mover o item de menu, você deve primeiro cortá-lo para a área de transferência, mover-se para o local de destino usando o painel à esquerda, e usar a função Colar para colar o item de menu da área de transferência.

&Ctrl;C Editar Copiar

- Copia o item de menu atual para a área de transferência. Você pode mais tarde usar a função Colar para colar o item de menu copiado da área de transferência para seu destino. Você pode colar o mesmo item diversas vezes.

&Ctrl;V Editar Colar

- Cola o item de menu da área de transferência para o local atualmente selecionado no menu principal. Você deve primeiro usar o Recortar ou Copiar antes de poder Colar.

Delete Editar Excluir

- Exclui o item de menu atualmente selecionado.

Editar Ordenar

- Abre um submenu para ordenar o submenu selecionado ou toda a árvore do menu. Existem dois métodos de ordenação implementados, pelo nome e pela descrição.

Editar Restaurar o menu do sistema

- Isto irá restaurar o lançador de aplicativos como estava pré-definido e remover todas as suas configurações personalizadas. Uma mensagem será exibida pedindo sua confirmação para esta ação.

O &kmenuedit; possui os itens dos menus Configurações e Ajuda, comuns do &kde;. Para mais informações, consulte as seções sobre o Menu Configurações e o Menu Ajuda dos Fundamentos do &kde;.

## Créditos e licença

&kmenuedit;

Direito de cópia do programa © 2002, &Raffaele.Sandrini;

Contribuidores:

- &Matthias.Elter; &Matthias.Elter.mail; - Autor Original

- &Matthias.Ettrich; &Matthias.Ettrich.mail;

- &Daniel.M.Duley; &Daniel.M.Duley.mail;

- &Preston.Brown; &Preston.Brown.mail;

Direito de cópia da documentação © 2000 &Milos.Prudek;

Documentação com copyright © 2008 de &Anne-Marie.Mahfouf;

Atualizado para o &kde; 3.0 por &Lauri.Watts;&Lauri.Watts.mail; 2002

Tradução de Marcus Gama marcus.gama@gmail.com

&underFDL; &underGPL;

## Glossário

Aplicativo de Console

Aplicativo originalmente escrito para um ambiente não gráfico, ou seja, orientado à texto. Estes aplicativos se executam bem no &kde;. Eles devem ser rodados com um emulador de console, como o &konsole;. Eles não serão alertados automaticamente quando você encerra sua sessão &kde;. Você não deve esquecer-se de salvar documentos abertos nestes aplicativos antes de sair do &kde;.

Aplicativos do console suportam o copiar e colar de aplicativos compatíveis com o &kde;. Simplesmente marque o texto no aplicativo console com seu mouse, alterne para o aplicativo compatível com o &kde; e pressione &Ctrl; V para colar o texto. Se você deseja copiar a partir de um aplicativo &kde; para um aplicativo de console, primeiro marque o texto com seu mouse, pressione &Ctrl; C, alterne para o aplicativo de console e pressione o botão do meio de seu mouse

Se seu mouse não possui botão do meio, você deve pressionar os botões esquerdo e direito ao mesmo tempo. Isto é chamado de emulação do botão do meio e deve ser suportado por seu sistema operacional para funcionar.

.
&documentation.index;