# O Manual do &konsole;

## Introdução

### O que é um terminal?

O &konsole; é um emulador de terminais X, também referido como sendo um terminal ou consola. Ele emula uma interface de linha de comandos numa janela apenas com texto.

O &konsole; executa tipicamente uma linha de comandos, uma aplicação que executa os comandos que o utilizador escrever. A linha de comandos que o &konsole; executa depende da configuração da sua conta. Consulte a documentação do seu sistema operativo para saber qual é a linha de comandos, como configurá-la e como usá-la.

### Posicionamento

O &konsole; usa a noção de posicionamento ou deslocamento para permitir ao utilizador ver o resultado apresentado anteriormente. Por omissão, este está activo e configurado para guardar 1000 linhas de resultado para além do que está visível de momento. À medida que as linhas se deslocam para fora do topo do ecrã, estas poderão ser revistas se mover a barra de posicionamento para cima, com a ajuda da roda do rato ou com os atalhos de teclado &Shift;Page Up (para andar uma página para atrás), &Shift;Page Down (para andar uma página para a frente), &Shift;Cima (para subir uma linha) e &Shift;Baixo (para descer uma linha).

### Perfis

Os perfis permitem ao utilizador automatizar rápida e facilmente a execução dos comandos comuns. Os exemplos poderão incluir:

- 'ssh' para outra máquina

- iniciar uma sessão de IRC

- usar o 'tail' para vigiar um ficheiro

Estes são os procedimentos para criar um perfil novo:

1. Carregue no item do menu Configuração Gerir os Perfis...

2. Carregue no botão Novo Perfil....

3. Preencha o primeiro campo com um nome. Este é o nome que aparecerá no menu, e será o texto por omissão em vez de Linha de Comandos quando você iniciar uma sessão deste tipo.

4. Indique um comando tal e qual você faria, se abrisse uma nova linha de comandos e invocasse esse comando. Para o nosso primeiro exemplo, você poderia escrever ``ssh` `administracao``.

5. Nas outras páginas da janela, configure a aparência desta sessão. Você poderá ter um tipo de letra diferente, bem como um esquema de cores, um tipo $`TERM`, entre outras coisas, para cada sessão.

6. Carregue no botão OK. A sessão nova fica então disponível na janela para Gerir os Perfis....

Todos os perfis marcados como Mostrar no Menu são apresentados pelo seu nome no menu Ficheiro Nova Página. Não existirá nenhum submenu se só for para mostrar o perfil predefinido.

### Botões do Rato

Esta secção entra em detalhe com a utilização dos botões do rato para os botões de um rato destro. Para a ordem de um rato esquerdino, troque a esquerda e a direita no texto abaixo.

Esquerdo

- Se carregar com o &LMB;, esse evento será passado à aplicação a correr na emulação, se esta souber lidar com o rato. Se um programa reagir aos 'clicks' do rato, o &konsole; irá indicar isso ao mostrar um cursor em forma de seta. Caso contrário, é mostrado um cursor em I (barra).

  Se mantiver o &LMB; carregado e arrastar o rato pelo ecrã numa aplicação que não lide com o rato a correr, isso irá marcar uma região de texto. Enquanto arrasta, o texto marcado é mostrado com as cores invertidas para algum 'feedback' visual. Seleccione o Copiar do menu Editar para copiar o texto marcado na área de transferência, de modo a usá-lo posteriormente no &konsole; ou noutra aplicação. O texto seleccionado também poderá ser arrastado e largado noutras aplicações compatíveis. Carregue no texto seleccionado e arraste-o para a localização desejada.

  Normalmente, os caracteres de mudança de linha são inseridos no fim de cada linha seleccionada. Isto é melhor para o corte e colagem de código-fonte, ou para o resultado de um comando qualquer. Para o texto normal, as quebras de linha não são normalmente importantes. Uma pessoa poderá preferir, de qualquer forma, que o texto seja uma sequência contínua de caracteres que será formatada de novo automaticamente ao ser colada noutra aplicação. Para seleccionar o texto em modo de sequência, mantenha a tecla &Ctrl; carregada enquanto selecciona normalmente.

  Se carregar com as teclas &Ctrl; e &Alt;, em conjunto com o &LMB;, irá seleccionar o texto por colunas.

  Faça duplo-click com o &LMB;, para seleccionar uma palavra, e triplo-click para seleccionar uma linha inteira.

  Se o limite superior ou inferior da área de texto for alterado enquanto é feita a marcação, o &konsole; deslocar-se-á para cima ou para baixo, eventualmente expondo algum texto no 'buffer' do histórico. A deslocação pára quando o rato parar de se mexer.

  Depois de o rato ser largado, o &konsole; tenta manter o texto na área de transferência visível mantendo a área marcada invertida. A área marcada voltará ao normal, a partir do momento que o conteúdo da área de transferência se altere, o texto da área marcada se modifique ou o &LMB; seja carregado.

  Para marcar o texto numa aplicação que lide com o rato (como por exemplo, o Midnight Commander), a tecla &Shift; tem de ser pressionada enquanto carrega.

Meio

- Se carregar com o &MMB;, irá colar o texto que se encontra de momento na área de transferências. Se mantiver carregada a tecla &Ctrl; à medida que carrega no &MMB; irá colar o texto e adiciona um fim-de-linha. Isto conveniente para executar comandos colados rapidamente, mas poderá ser perigoso, pelo que use a opção com cuidado.

  Se você tiver um rato com apenas dois botões, basta carregar tanto no &LMB; como no &RMB; em conjunto para emular o &MMB; de um rato de três botões.

  Se tiver uma roda como botão do meio, ao rodá-la num programa que não reconheça o rato, irá mover a barra de posicionamento do &konsole;.

Direito

- Estes itens aparecem no menu quando carregar com o &RMB;: Copiar, Colar, Abrir o Gestor de Ficheiros, Mudar a Codificação, Limpar o Posicionamento, Ajustar o Posicionamento..., Mostrar o Menu, Mudar de Perfil, Editar o Perfil Actual... e Fechar a Página

  Numa aplicação que reconheça o rato, carregue na tecla &Shift;, em conjunto com o &RMB;, para obter o menu de contexto.

## Referência de Comandos

### A Barra de Menu

A barra do menu encontra-se no topo da janela do &konsole;. Se esta estiver escondida, poderá aceder à opção Mostrar o Menu se carregar com o botão direito na janela (desde que não esteja nenhuma aplicação a correr em todo o ecrã nessa janela, como o 'vi', 'minicom', etc.). O atalho por omissão aparece depois de cada item do menu.

#### O Menu Ficheiro

&Ctrl;&Shift;N Ficheiro Nova Janela

- Abre uma janela nova do &konsole; em separado com o perfil por omissão

&Ctrl;&Shift;T Ficheiro Nova Página

- Abre uma página nova com o perfil por omissão

  O &konsole; vem com o perfil de Linha de Comandos por omissão. Todos os perfis que sejam adicionados pelo utilizador terão o seu próprio item de menu no submenu. Não existirá nenhum submenu se só estiver visível o perfil predefinido.

Ficheiro Duplicar a Página

- Tenta duplicar a página actual para uma nova

Ficheiro Gravar o Resultado Como...

- Grava o histórico de posicionamento actual como um ficheiro de texto ou HTML

Ficheiro Abrir o Gestor de Ficheiros

- Abre o gestor de ficheiros do &kde; na pasta actual. Por omissão, este é o &dolphin;.

&Ctrl;&Shift;W Ficheiro Fechar a Página

- Fecha a página actual

&Ctrl;&Shift;Q Ficheiro Sair

- Sai do &konsole;

  O &konsole; irá mostrar uma janela, caso exista mais de uma página aberta. Esta janela poderá ser desactivada se assinalar a opção Não perguntar de novo.

#### O Menu Editar

&Ctrl;&Shift;C Editar Copiar

- Copia o texto seleccionado para a área de transferência

&Ctrl;&Shift;V Editar Colar

- Cola o texto da área de transferência na posição do cursor

Editar Seleccionar Tudo

- Selecciona todo o texto da janela actual

Editar Copiar a Entrada Para Todas as Páginas da Janela Actual

- Permite a introdução de dados da sessão actual ser enviada em simultâneo para todas as sessões da janela actual

&Ctrl;&Shift;. Editar Copiar a Entrada Para Seleccionar as Páginas...

- Permite que a introdução de dados da sessão actual seja enviada em simultâneo para as sessões escolhidas pelo utilizador

&Ctrl;&Shift;/ Editar Copiar a Entrada Para Nenhuma

- Parar a introdução dos dados da sessão actual para as outras sessões

&Ctrl;&Alt;S Ver Mudar o Nome da Página...

- Abre uma janela que lhe permitirá mudar o nome da página actual (mais informações)

&Ctrl;&Alt;U Editar Enviar por Z-Modem...

- Abre uma janela para seleccionar um ficheiro a enviar, caso esteja instalada a aplicação necessária

&Ctrl;&Shift;F Editar Procurar...

- Abre uma barra de pesquisa no fundo da janela do &konsole;

  Esta permite pesquisas com distinção de maiúsculas, para a frente ou para trás, ou ainda por expressões regulares.

F3 Editar Procurar o Seguinte

- Passa para a instância de pesquisa seguinte

&Shift;F3 Editar Procurar o Anterior

- Passa para a instância de pesquisa anterior

#### O Menu Ver

&Ctrl;( Ver Dividir a Janela Dividir a Janela Esquerda/Direita

- Divide todas as páginas em janelas esquerdas e direitas

  Todo o resultado de uma janela será duplicado na outra.

&Ctrl;) Ver Dividir a Janela Dividir a Janela Cima/Baixo

- Divide todas as páginas em janelas superiores e inferiores

  Todo o resultado de uma janela será duplicado na outra.

&Ctrl;&Shift;S Ver Dividir a Janela Fechar a Janela Activa

- Fecha a janela activa

&Ctrl;&Shift;O Ver Dividir a Janela Fechar as Outras Janelas

- Fecha todas as janelas não-actuais

&Ctrl;&Shift;] Ver Dividir a Janela Expandir a Janela

- Torna a janela actual maior

&Ctrl;&Shift;[ Ver Dividir a Vista Encolher a Vista

- Torna a janela actual menor

&Ctrl;&Shift;H Ver Dissociar a Página Actual

- Abre a página actual numa janela separada

  Se sair da janela anterior do &konsole;, não irá afectar a janela acabada de criar.

&Ctrl;&Shift;I Ver Monitorizar o Silêncio

- Activa ou desactiva a vigilância da falta de actividade da página actual

  Por omissão, ao fim de 10 segundos de inactividade, irá aparecer um ícone informativo na página da sessão. O tipo de alertas poderá ser configurado através da opção Configuração Configurar as Notificações Silêncio na sessão vigiada.

&Ctrl;&Shift;A Ver Monitorizar a Actividade

- Activa ou desactiva a vigilância de actividade da página actual

  Em caso de qualquer actividade, irá aparecer um ícone informativo na página da sessão. O tipo de alertas poderá ser alterado através da opção Configuração Configurar as Notificações Actividade na sessão vigiada.

&Ctrl;+ Ver Aumentar o Tipo de Letra

- Aumenta o tamanho do texto

&Ctrl;- Ver Diminuir o Tipo de Letra

- Diminui o tamanho do texto

Ver Escolher a Codificação

- Altera a codificação de caracteres

Ver Limpar o Posicionamento

- Limpa o texto no posicionamento

&Ctrl;&Shift;X Ver Limpar o Posicionamento e Reiniciar

- Limpa o texto na página actual e no posicionamento, reiniciando depois o terminal

#### O Menu Favoritos

&Ctrl;&Shift;B Favoritos Adicionar aos Favoritos

- Adiciona o local actual

Favoritos Marcar as Páginas como uma Pasta de Favoritos...

- Adiciona todas as páginas como uma pasta de favoritos

  Irá abrir uma janela para introduzir o nome da pasta de favoritos.

Favoritos Nova Pasta de Favoritos...

- Adiciona uma nova pasta à lista de favoritos

  Irá abrir uma janela para introduzir o nome da pasta de favoritos.

Favoritos Editar os Favoritos

- Abre o editor de favoritos

  Você poderá usar o editor de favoritos para adicionar manualmente URLs. De momento, o &konsole; suporta os seguintes formatos:

  - ssh://utilizador@máquina:porto

  - telnet://utilizador@máquina:porto

#### O Menu Configuração

Configuração Editar o Perfil Actual...

- Abre uma janela para configurar o perfil actual

Configuração Mudar de Perfil

- Mudar o perfil actual para um perfil da lista

Configuração Gerir os Perfis...

- Abre um editor para gerir os perfis

&Ctrl;&Shift;M Configuração Mostrar o Menu

- Activa ou desactiva a visibilidade do menu

Configuração Modo de Ecrã Completo

- Activa ou desactiva a ocupação de todo o ecrã pelo &konsole;

Configuração Configurar os Atalhos...

- Abre o editor de atalhos do teclado

Configuração Configurar as Notificações...

- Abre o editor de notificações

Configuração Configurar o &konsole;...

- Abre o editor da configuração do &konsole;

#### O Menu Ajuda

&help.menu.documentation;

### Janela de Mudança de Nome da Página

O nome da página actual poderá ser alterado com esta janela. A janela poderá ser invocada através do menu, da combinação de teclas &Ctrl;&Alt;S ou se fizer duplo-click no separador da página, na barra de páginas. Estas alterações poder-se-ão tornar permanentes ao editar o perfil actual.

O &konsole; irá substituir estes itens:

- %n : nome do programa

- %d : pasta actual (curta)

- %D : pasta actual (extensa)

- %w : título da janela definido pela linha de comandos

- %# : número da sessão

- %u : nome do utilizador

Exemplos:

- O `%d : %n`, com a '/usr/src' como pasta actual e a executar o bash irá mostrar usr/s : bash

- O `%D : %n`, com a '/usr/src' como pasta actual e a executar o top irá mostrar usr/src : top

- O `%w (%#)`, com a ~ como pasta actual e a executar o vim na primeira página, irá mostrar [Sem Nome] (~) - VIM(1)

### Janela de Cópia da Entrada

O texto introduzido numa página poderá ser enviado em simultâneo para as outras páginas. Esta janela permite-lhe seleccionar quais as páginas que irão receber esses dados introduzidos. A pasta actual irá ficar acinzentada.

### Janela de Ajuste do Deslocamento

As opções de deslocamento para o tamanho do histórico poderão ser alteradas nesta janela. Existe também uma opção para gravar essa configuração no perfil actual.

## Opções da Linha de Comandos

Quando o &konsole; é iniciado a partir da linha de comandos, várias opções poderão ser indicadas para alterar o seu comportamento.

`--help`

- Mostra as várias opções.

`--profile` `ficheiro`

- Inicia o &konsole; com o perfil indicado, em vez do predefinido.

`--list-profiles`

- Mostra todos os perfis disponíveis.

`--list-profile-properties`

- Apresenta todas as propriedades possíveis com o nome e tipo. Veja a opção `-p` .

  Para mais informações, por favor visite a Referência da API do &konsole;.

`--background-mode`

- Inicia o &konsole; em segundo plano e passa para a frente quando carregar na tecla &Ctrl;&Shift;F12 (por omissão).

`--new-tab`

- Cria uma página nova numa janela existente, em vez de criar uma janela nova.

`--tabs-from-file` `ficheiro`

- Cria páginas a partir dos dados definidos no ficheiro de configuração de páginas indicado.

  O ficheiro tem uma página por linha, no seguinte formato:

  title: COLOCAR UM TÍTULO ;; command: COLOCAR UM COMANDO ;; workdir: COLOCAR UMA PASTA

`--workdir` `directoria`

- Abre com a `directoria` como sendo a pasta de trabalho inicial.

`--show-menubar`

- Mostra a barra de menu, substituindo o comportamento predefinido.

`--hide-menubar`

- Esconde a barra de menu, substituindo o comportamento predefinido.

`--show-tabbar`

- Mostra a barra de páginas, substituindo o comportamento predefinido.

`--hide-tabbar`

- Esconde a barra de páginas, substituindo o comportamento predefinido.

`--notransparency`

- Desactiva os fundos transparentes, mesmo que o sistema os suporte.

`--hold, --noclose`

- Não fecha a sessão inicial automaticamente, quando esta terminar.

`-p` `propriedade=valor`

- Muda o valor de uma propriedade do perfil.

`-e` `comando`

- Executa o `comando` em vez da linha de comandos normal.

  Esta opção irá capturar todos os seguintes argumentos passados ao &konsole;, executando como um `comando`. Como tal, esta opção deverá ser sempre usada como sendo a última.

`--nofork`

- Não executa em segundo plano. Isto é normalmente necessário para imitar outros terminais.

O &konsole; também aceita as opções genéricas do &Qt; e do &kde;:

`--help-qt`

- Mostra as opções específicas do &Qt;

As seguintes opções do &Qt; não fazem efeito no &konsole;:

`--fn`, `--font` `tipo_letra`

- Define o tipo de letra da aplicação

`--bg`, `--background` `cor`

- Altera a cor de fundo por omissão

`--fg`, `--foreground` `cor`

- Altera a cor do texto por omissão

`--btn`, `--button` `cor`

- Altera a cor dos botões por omissão

`--help-kde`

- Mostra as opções específicas do &kde;

`--help-all`

- Mostra todas as opções

`--author`

- Mostra os nomes dos autores

`-v,--version`

- Mostra o número da versão

`--license`

- Mostra informações sobre a licença

## Programação no &konsole;

Para o &kde; 4, o antigo &DCOP; foi substituído pelo &DBus;. O &konsole; suporta diversos métodos para serem usados com o &DBus;.

Existem duas formas de usar a interface de &DBus;: a &GUI; do &Qt; qdbusviewer e o utilitário da linha de comandos qdbus.

Exemplos:

- O `%` `qdbus` irá mostrar todos os serviços disponíveis.

- O `%` `qdbus` `org.kde.konsole` irá mostrar a interface de &DBus; para o &konsole;.

- O `%` `qdbus` `org.kde.konsole /Windows/1` irá mostrar os métodos para controlar a janela 1.

  O /Konsole foi usado anteriormente para controlar a primeira janela, o que é um erro de arquitectura. Por favor, não o use mais para esse fim; pense também em actualizar quaisquer programas existentes.

- O `%` `qdbus` `org.kde.konsole /Sessions/1` irá mostrar os métodos para controlar a sessão 1.

Se iniciar o &konsole; a partir de um terminal, poderá ter de alterar o `org.kde.konsole` para `org.kde.konsole-`pidof -s konsole``.

Para mais informações, vá por favor ao tutorial sobre &DBus;.

## Sabia Que?, Assuntos Comuns e Mais

### Sabia Que?

- Se carregar no &Ctrl; enquanto selecciona texto, fará com que as quebras de linhas sejam convertidas para espaços quando colar o texto.

- Se carregar com as teclas &Ctrl;&Alt; enquanto selecciona o texto, irá seleccionar as colunas.

- A combinação &Ctrl;Roda irá ampliar o tamanho do texto, como no Konqueror e no Firefox.

- Quando um programa avalia qualquer um dos botões do rato, se carregar na tecla &Shift; fará aparecer um menu de contexto.

- A combinação &Ctrl;&Shift;F10 irá activar o menu.

- A combinação &Shift;Insert irá inserir o conteúdo da área de transferência.

- Se fizer duplo-click, irá seleccionar uma palavra inteira. Se continuar a manter o botão carregado e arrastar o rato, irá extender a selecção.

- Se fizer triplo-click, irá seleccionar uma linha inteira. Se continuar a manter o botão carregado e arrastar o rato, irá extender a selecção.

- Existe uma funcionalidade escondida para o formatador "%d" no título da página. Poderá indicar ao &konsole; para abreviar o nome de uma pasta para o seu primeiro carácter. Por exemplo, o "/local/do/konsole/codigo" pode ser abreviado para "konsole/c". Se quiser activar e controlar esta funcionalidade escondida, abra o '~/.kde4/share/config/konsolerc' e adicione as linhas seguintes:

      [ProcessInfo]
      CommonDirNames=nome1,nome2,nome3...

  Se estiver a usar o Yakuake, terá de editar o `~/.kde4/share/config/yakuakerc` em alternativa.

### Assuntos Comuns

- Por omissão, quando é iniciado a partir de um terminal, o &konsole; irá correr em segundo plano. Use a opção `--nofork` para obrigar o &konsole; a correr em primeiro plano.

  Isto é necessário para alguns programas e comandos funcionarem como seria de esperar:

  - `konsole --nofork -e sleep 3 ; echo 1`

  - `kdesu -u utilizador konsole --nofork`

- Alguns tipos de letra poderão estar indisponíveis no &konsole;, ainda que estejam noutras aplicações. Isto não significa que haja um erro no &konsole;. O &konsole; necessita de tipos de letra monoespaçados para oferecer o melhor resultado visual, pelo que pede ao &Qt; para apresentar apenas os tipos de letra monoespaçados.

  Se tiver a certeza que um tipo de letra é realmente monoespaçado, mas que esteja indisponível no &konsole;, então comunique por favor o problema ao &Qt;.

- No KDE3, cada página tinha o seu próprio ID de processo. Contudo, no KDE4, todas as páginas usam o mesmo ID de processo. Isto tem o problema que, se o processo de alguma página tiver problemas, todas as outras páginas também terão problemas.

  Isto é mais notório quando um comando que se ligue a um dispositivo ou sistema externo (SSH, NFS) tiver problemas.

- O &konsole; trata os argumentos a seguir à opção `-e` como um único comando, executando-o directamente, em vez de os processar e dividir em sub-comandos para a execução. Isto é diferente do 'xterm'.

  - `konsole -e "comando1 ; comando2"` não funciona

  - `konsole -e $SHELL -c "comando1 ; comando2"` funciona

- O &konsole; não fornece nenhuma capacidade para executar uma consola de autenticação, porque os programadores não gostam da ideia de executar consolas de autenticação num emulador de terminal.

  Obviamente, os utilizadores poderão à mesma executar consolas de autenticação no &konsole; se realmente necessitarem de tal. Edite o perfil usado e modifique o comando de forma a iniciar uma consola de autenticação de forma explícita, como por exemplo "`bash -l`" e "`zsh -l`".

- A opção `--new-tab` comporta-se algumas vezes de forma estranha. Poderá criar uma janela nova ou poderá criar uma página nova noutra janela existente do &konsole;, em vez da janela actual do &konsole;.

  Estes comportamentos são estranhos, mas não são necessariamente erros. A opção `--new-tab` tenta reutilizar as janelas existentes do &konsole;, mas nem todas as janelas do &konsole; podem ser reutilizadas. Todas as janelas do &konsole; abertas através do &krunner; podem ser reutilizadas, enquanto a maioria das janelas do &konsole; abertas a partir da linha de comandos não são.

## Créditos e Direitos de Cópia

O &konsole; é mantido de momento por &Kurt.Hindenburg; &Kurt.Hindenburg.mail;

Os responsáveis anteriores pela manutenção do &konsole; incluem: &Robert.Knight; &Robert.Knight.mail; e &Waldo.Bastian; &Waldo.Bastian.mail;

A aplicação &konsole; tem o 'copyright' © 1997-2008 de &Lars.Doelle; &Lars.Doelle.mail;

Este documento foi escrito originalmente pelo &Jonathan.Singer; &Jonathan.Singer.mail;

Este documento foi actualizado para o &kde; 4.x pelo &Kurt.Hindenburg; &Kurt.Hindenburg.mail;

Este documento foi actualizado para o &kde; 3.4 pelo &Kurt.Hindenburg; &Kurt.Hindenburg.mail;

Foi convertido originalmente para SGML de DocBook por &Mike.McBride; e &Lauri.Watts;

Tradução de José Nuno Pires zepires@gmail.com

&underFDL; &underGPL;

## Hiperligações

Para mais informações, visite estas páginas Web:

- Página Web do &konsole; na Base de Utilizadores do &kde;

- Página pessoal do &konsole;

- Lista de correio do &konsole;

- &kde; em FreeBSD

- &kde; em &Solaris;

&documentation.index;