# Integração com o ambiente de trabalho

Há dois elementos para uma integração básica com o ambiente de usuário do GNOME.

1. Coloque uma entrada para seu aplicativo no menu Aplicativos. Este é o mecanismo primário pelo qual os usuários descobrem e executam aplicativos.

2. Caso seu aplicativo possa abrir e salvar arquivos, coloque uma entrada para esses tipos de arquivos no banco de dados do aplicativo e no banco de dados de tipos de documento (MIME). Isso permite que o gerenciador de arquivos e outros aplicativos automaticamente executem seu aplicativo quando encontram arquivos que seu aplicativo pode manipular.

Não adicione lançadores ou outros ícones na área de trabalho quando seu aplicativo é instalado. A área de trabalho é o espaço do usuário, e é reservado para ícones que ele explicitamente solicite ou adicione.

## Colocando entradas no menu Aplicativos

### O menu Aplicativos

Captura de tela do menu Aplicativos aberto no painel de menus do GNOME

O menu Aplicativos, o qual aparece no painel no topo da tela por padrão, é o mecanismo primário pelo qual os usuários descobrem e executam aplicativos. Você coloca entradas nesse meno ao instalar um arquivo `.desktop` apropriado.

O menu é arranjado em um conjunto de categorias, como Acessórios e Jogos. Aplicativos são colocados em categorias particulares pelo conjunto de palavras-chave que incluem em seu arquivo `.desktop`.

### Diretrizes

- Atribua a seu aplicativo apenas uma categoria no menu Aplicativos

- Para suítes de aplicativos que envolvem sub-aplicativos menores em uma única janela, como Evolution ou OpenOffice.org, adicione um item de menu para cada sub-aplicativo. Por exemplo, o e-mail, o calendário e a lista de tarefas no Evolution devem ter cada um seu próprio item no menu.

Detalhes técnicos podem ser encontrados nas especificações de menu e de entradas da área de trabalho em freedesktop.org.

### Nomes dos itens de menu

#### Inclua uma descrição funcional no nome do menu

No nome do item de menu, inclua uma descrição da funcionalidade além do próprio nome do aplicativo. Isso é especialmente útil para usuários novatos, e para usuários de sistemas onde inúmeros aplicativos estão instalados por padrão. Usuários são mais suscetíveis a encontrar seu aplicativo se o nome que aparece no menu inclui uma descrição de sua funcionalidade.

Por exemplo, um teste de usuários do sistema Athena do MIT revelou que usuários tiveram dificuldade de encontrar o gerenciador de arquivos porque não eram familiarizados com o nome "Nautilus". O item de menu não ajudou os usuários porque eles não associaram a palavra "Nautilus" com o conceito "gerenciador de arquivos". Esse é um exemplo de como não utilizar a linguagem do usuário. Veja para mais informações neste tópico.

##### Incluindo descrições funcionais nos nomes do menu

Item de menu original | Item de menu revisado
--- | ---
Epiphany | Navegador web Epiphany

#### Coloque apenas informações úteis no nome do menu

Não inclua palavras como "GNOME", "Sistema de janelas X", "GTK+" ou outros detalhes da plataforma no nome do menu Aplicativos. O usuário provavelmente já sabe qual plataforma que estão usando, e caso não saibam, nomes de aplicativos não são o lugar correto para informá-lo.

##### Removendo informação não essencial do nome do menu

Item de menu original | Item de menu revisado
--- | ---
Visualizador de imagens do GNOME | Visualizador de imagens
Editor de blog em GTK | Editor de blog

Não inclua detalhes técnicos quando o usuário não precisa conhecê-los, ou pode inferí-los do contexto. Evite jargão técnico a não ser que o aplicativo seja usado apenas por uma audiência técnica.

Por exemplo, quando tanto um cliente e um servidor de algo são listados nos menus, remova a palavra "cliente" do nome do menu do cliente.

##### Removendo jargão técnico dos nomes do menu

Item de menu original | Item de menu revisado
--- | ---
Cliente de batalha naval do Gnome | Batalha naval
Servidor de batalha naval do Gnome | Servidor multijogador de batalha naval
Cliente de VideoLAN do Gnome | Reprodutor multimídia VideoLAN

##### Fornecendo a informação certa

Tente imaginar quais palavras os usuários estarão procurando quando selecionarem seu aplicativo do menu Aplicativos. Esta é a informação que deve estar no nome do menu. Por exemplo, um usuário que deseja reproduzir um filme provavelmente não estará procurando pela palavra "cliente". Por outro lado, um usuário que deseja transmitir filmes de seu computador poderá estar procurando pela palavra "servidor". Evite pensar no menu de aplicativos como uma ontologia!

#### Formatos do nome de menu

1. Caso o nome do seu aplicativo já seja descritivo de sua funcionalidade, e não apenas sugestivo, use o formato: Nome do aplicativo

   ##### Usando o nome do aplicativo como o nome de menu

   Nome do aplicativo | Nome de menu
   --- | ---
   Dicionário | Dicionário
   Ferramenta de pesquisa | Ferramenta de pesquisa

2. Caso haja uma descrição funcional sucinta de seu aplicativo, use o formato: NomeDoAplicativo DescriçãoFuncional

   ##### Usando descrições funcionais em nomes de menu

   Nome do aplicativo | Nome do item de meno
   --- | ---
   GIMP | Editor de imagens GIMP
   Sub-aplicativo de e-mail do Evolution | E-mail do Evolution
   AbiWord | Processador de texto AbiWord
   Galeon | Navegador web Galeon
   Gramps | Genealogia Gramps
   AisleRiot | Paciência AisleRiot

3. Alguns aplicativos, particularmente jogos, não possuem uma descrição funcional apropriada (mas note que vários jogos possuem). Neste caso, use Nome do aplicativo como o nome de menu.

   ##### Usando o nome do aplicativo como nome de menu onde nenhuma descrição funcional existe

   Nome do aplicativo | Nome do item de meno
   --- | ---
   Bomber Maze | Bomber Maze

### Dicas de ferramenta do item de menu

As dicas de ferramenta fornecem aos usuários informações suficientes para executar o aplicativo correto. Muitos usuários usam as dicas de ferramenta para explorar um ambiente novo.

Forneça uma dica de ferramenta para cada item que você adicionar ao menu Aplicativos, seguindo estas diretrizes:

#### Diretrizes

- Expresse a dica de ferramenta por um verbo no imperativo, por exemplo "projete", "escreva" ou "cheque".

- Descreva as tarefas mais importantes que os usuários podem realizar com seu aplicativo.

- Embora dicas de ferramenta não devem ser prolixas, elas devem ser mais longas e descritivas que o nome do item.

#### Exemplos de dicas de ferramentas para aplicativos do GNOME

Aplicativo | Dica de ferramenta do item de menu
--- | ---
Mapa de caracteres | Insira caracteres especiais nos documentos
Memprof | Verifique seus aplicativos por vazamentos de memória
Same Gnome | Organize longas cadeias de bolas com cores similares para eliminá-las
Cliente de batalha naval do Gnome | Encontre e afunde navios inimigos nesta versão em rede de batalha naval

## Chaves do GConf

Chaves do GConf necessitam ter uma descrição longa e curta para cada chave. Muitas chaves não tem interface no aplicativo, então, para alguém administrando os valores das chaves a partir de outro aplicativo, cada campo de descrição será a única interface disponível.

### Diretrizes

- Descrições curtas devem ser curtas, com menos que 8 palavras, descrevendo o propósito da chave

- Descrições longas devem ser completas ao descrever os possíveis valores da chave e os efeitos que esses valores terão no aplicativo

### Exemplos de descrições para chaves do GConf do gnome-terminal

Chave | Descrição curta | Descrição longa
--- | --- | ---
background_type | Tipo de plano de fundo | Tipo de plano de fundo do terminal. Pode ser "sólido" para uma cor sólida, "imagem" para uma imagem, ou "transparente" para pseudo-transparência.
delete_binding | Efeito da tecla Delete | Determina qual código é gerado pela tecla delete. Valores possíveis são "ascii-del" para o caractere ASCII DEL, "control-h" para Control-H (também conhecido como o caractere ASCII BS), "escape-sequence" para a sequencia de escape tipicamente atado a backspace ou delete. "escape-sequence" é normalmente considerado a configuração correta para a tecla delete.

## Mapeando tipos de documento a aplicativos

O banco de dados de tipos do documento (MIME) permite que usuários especifiquem seu aplicativo preferencial para abrir diferentes tipos de documentos. Este é o mecanismo pelo qual Nautilus, Evolution e outros aplicativos decidem qual aplicativo executar quando encontram um documento que não podem abrir.

É importante que os usuários sejam capazes de abrir documentos que veem na área de trabalho com clique duplo, como arquivos e mensagens de email, e iniciar seu aplicativo favorito. Assim, seu aplicativo GNOME deve associar-se na hora da instalação com todos os tipos de documento que pode manusear. Detalhes técnico sobre como fazer isso podem ser encontrados na especificação das informações compartilhadas MIME e na especificação das entradas da área de trabalho do Freedesktop.

## Usando a área de notificação de estados

Ao usar a área de notificação de estados, os aplicativos podem notificar o usuário sobre eventos não críticos (por exemplo, a chegada de um novo email, ou um companheiro no chat que se conectou), e expõe o estado de processos ativos do sistema (por exemplo, imprimindo um documento, ou o carregamento da bateria do laptop).

Seguir as diretrizes nesta seção irá ajudar a esclarecer a diferença na mente do usuário entre a informação apresentada na área de notificação, e controles e informações apresentadas em outras partes do painel.

A utilidade da área de notificação diminui rapidamente quando mais que aproximadamente quatro ícones são apresentados constantemente. Por essa razão, ícones que aparecem apenas temporariamente em resposta à eventos são preferíveis.

### Área de notificação ou miniaplicativo do painel?

Você provavelmente deve escrever um miniaplicativo ao invés de usar a área de notificação caso:

- clicar no ícone em sua área de notificação não faz nada além de abrir uma janela diretamente associada com o ícone (ex. uma janela de pasta de email para um ícone de novo email, ou a janela da fila de impressão para o ícone de notificação da impressora), ou

- há opções específicas do ícone no menu de contexto para fazer qualquer coisa além daquilo

- seu aplicativo alguma vez necessite exibir mais de um ícone de notificação ao mesmo tempo

### Aparência do ícone

#### Diretrizes

- Use a perspectiva em tabela para ícones que representam dispositivos físicos, com a fonte de luz acima e a esquerda do objeto representado. Por exemplo, o ícone de impressora durante a impressão. Veja para mais informações sobre a perspectiva em tabela.

- Use a perspectiva de prateleira, com iluminação suspensa, para todos os outros ícones. Por exemplo, um envelope exibido quando um novo email chega. Veja para mais informações sobre perspectiva de prateleira.

- Para monitores ou barras de progresso que mudam ao longo do tempo, como o monitor da carga da bateria, delimite claramente a borda da área.

#### Diretrizes

- Somente os programas de núcleo do GNOME podem exibir perpetuamente um ícone na área de estados.

- Non-core programs for which a perpetual icon may be useful must default to not perpetually showing the icon. Users may select to enable a perpetual icon for the application as a preference.

### Animação

#### Diretrizes

- Ícones normalmente não devem aparecer animados. Eles podem mudar para indicar uma mudança de estado, mas não deve fazer isso quando as mudanças ocorrem regular ou rapidamente. Um indicador do estado da bateria normalmente muda lentamente, portanto um ícone é apropriado. Em contraste, um medidor de carga sempre estaria carregando, portanto deve usar uma imagem plana.

- Qualquer ícone pode piscar para indicar um erro em deferência à mostrar um alerta. Por exemplo, um ícone de impressão em progresso pode piscar quando houver congestionamento de papel, mas não quando a impressora estiver pegando fogo - isso exibiria um alerta.

- Não dependa de animações ou de piscar como meio de alertar o usuário de algum evento em particular.

### Interação

Ícones devem responder às alções dos usuários. (Pressionamentos de tecla se aplicam apenas quando o ícone tem foco, claro)

#### Diretrizes

- O duplo clique ou a tecla espaço devem realizar a ação padrão do ícone. Normalmente isso deve abrir uma janela com informações relevantes, por exemplo:

  - a fila de impressão para um ícone de impressão em progresso.

  - a caixa de entrada para um ícone de um email recebido

  - a mensagem para uma mensagem recebida

- O clique com o botão direito ou a combinação Shift F10 deve exibir um menu para o ícone contendo pelo menos a ação padrão do ícone.

- Caso as propriedades do ícone possam ser alteradas, deve haver um item de menu Propriedades no menu, e mostra seu painel de propriedades em resposta a Alt+Enter

- Ícones devem obedecer a convenções normais de dicas de ferramenta.