# Manual do &konsole;

## Introdução

### O que é um terminal?

&konsole; é um emulador de terminais X, frequentemente denominado como terminal, console ou shell. Emula uma interface de linha de comando em uma janela somente com texto.

Geralmente executa um comando do shell, um aplicativo que executa os comandos digitados. O shell que o &konsole; executa depende das configurações da sua conta. Consulte a documentação do seu sistema operacional para saber qual é o shell e como fazer para configurar e usá-lo.

### Histórico

O &konsole; usa um conceito de histórico para permitir que os usuários consultem os resultados apresentados anteriormente. Por padrão, o histórico está ativo e armazena 1.000 linhas de resultado, além do que já está sendo mostrado na tela.

Conforme as linhas se deslocam para a parte superior da tela, elas podem ser revistas ao mover a barra de rolagem para cima, com uso da roda do mouse ou através das teclas &Shift;Page Up (para mover para trás), &Shift;Page Down (para mover para frente), &Shift;Seta para cima (para mover uma linha acima) e &Shift;Seta para baixo (para mover uma linha abaixo).

A configuração de rolagem com uso das teclas &Shift;Page Up/Down pode ser alterada de meia página para uma página inteira, na aba Rolagem da janela de configuração do perfil (use a opção Configurações Editar o perfil atual... para abrir essa janela).

### Modo de seleção

O &konsole; possui um modo de seleção por teclado. Nesse modo, é possível navegar pela barra de rolagem e selecionar texto sem usar o mouse.

Entre e saia deste modo usando o atalho de teclado (&Ctrl;&Shift;D por padrão).

Esc também sai do modo de seleção de teclado.

Movendo o cursor: Setas, PageUp, PageDown, Home, End.

Movendo o cursor no estilo vi: h,j,k,l, para mover um caractere, Ctrl+b,f,u,d para página para cima/para baixo ou meia página para cima/para baixo.

Selecionar texto usando Ctrl ou Shift com as setas, ou usando V para iniciar a seleção, movendo o cursor e, em seguida, V novamente para finalizar a seleção. &Shift;V seleciona linhas inteiras, em vez de caracteres.

### Perfis

Os perfis permitem que o usuário automatize, de forma simples e rápida, a execução de comandos comuns. Podemos citar os exemplos:

- ssh para outra máquina

- iniciar uma sessão de IRC

- usar o 'tail' para monitorar um arquivo

Todos os perfis novos e alterados são salvos na pasta pessoal local em `$`XDG_DATA_HOME`/konsole`.

Procedimentos para criar um novo perfil:

1. Clique no item de menu Configurações Gerenciar perfis...

2. Mude para a página de Perfis.

3. Clique no botão Novo perfil...

4. Preencha o primeiro campo com um nome. Esse nome aparecerá no menu e será o texto padrão em substituição ao Shell, quando iniciar uma sessão desse tipo.

5. Insira um comando como você normalmente faria se abrisse um novo shell e digitasse esse comando. Para nosso primeiro exemplo acima, você pode digitar ``ssh` `administracao``.

6. Nas outras abas da janela, configure a aparência desta sessão. É possível configurar uma fonte diferente, um esquema de cores, o tipo $`TERM` e muitas outras definições para cada sessão.

7. Clique no botão OK. A nova sessão ficará disponível na caixa de diálogo Gerenciar perfis...

### Botões do mouse

Esta seção detalha o uso dos botões do mouse, na ordem normalmente usada por pessoas destras. Para canhotos, é necessário inverter a ordem dos botões no texto abaixo.

Esquerdo

- Todos os cliques com o &LMB; serão enviados para um aplicativo com suporte a mouse, que esteja em execução no &konsole;. Se um aplicativo reagir aos cliques do mouse, o &konsole; indicará isso mostrando um cursor em forma de seta. Caso contrário, será mostrado um cursor em forma de barra (I).

  Manter o &LMB; pressionado e arrastar o mouse sobre a tela que tenha em execução um aplicativo sem suporte a mouse, apenas marcará uma região de texto. Ao arrastar com o mouse, o texto marcado será exibido em cores invertidas para ser facilmente visto. Selecione o item Copiar no menu Editar para copiar o texto marcado para a área de transferência, de forma a poder usá-lo posteriormente dentro do &konsole; ou em outro aplicativo. Também poderá arrastar e soltar o texto selecionado em aplicativos compatíveis com esse recurso. Mantenha a tecla &Ctrl; pressionada e arraste o texto selecionado para o local desejado.

  Normalmente, os caracteres de mudança de linha são inseridos ao final de cada linha selecionada. Isso é melhor para recortar e colar de código-fonte ou o resultado de um comando qualquer. Para texto comum, as quebras de linha normalmente não são importantes. Você pode preferir, no entanto, que o texto seja uma sequência de caracteres que será automaticamente reformatada ao colar em outro aplicativo. Para selecionar em modo de sequência de texto, mantenha pressionada a tecla &Ctrl; enquanto efetua a seleção.

  Pressionar as teclas &Ctrl; e &Alt;, em conjunto com o &LMB;, irá selecionar o texto em colunas.

  O clique duplo com o &LMB; seleciona uma palavra e o clique triplo seleciona uma linha inteira.

  Se o limite superior ou inferior da área de texto for alterado enquanto é feita a marcação, o &konsole; rola para cima ou para baixo, eventualmente apresentando algum texto que estiver armazenado no histórico. A rolagem será interrompida para quando cessar o movimento do mouse.

  Após soltar o mouse, o &konsole; tenta manter o texto na área de transferência visível, mantendo a área marcada invertida. A área marcada voltará ao normal tão logo mude o conteúdo da área de transferência, o texto na área marcada seja alterado ou o &LMB; seja clicado.

  Para marcar o texto de um aplicativo com suporte a mouse (Midnight Commander, por exemplo), pressione a tecla &Shift; ao clicar.

Meio

- Pressionar o &MMB; cola o texto que estiver na área de transferência. Manter a tecla &Ctrl; pressionada enquanto pressiona o &MMB; cola o texto e adiciona uma nova linha. Isso é conveniente para executar de imediato o comando que for colado, mas por ser potencialmente perigoso, deve ser utilizado com cuidado.

  Se possuir um mouse com apenas dois botões e pressionar o botão esquerdo e o direito ao mesmo tempo, será emulado o botão do meio de um mouse com três botões.

  Caso tenha uma roda como botão do meio, ao girá-la em um programa que não tenha suporte a mouse irá mover a barra de rolagem do &konsole;.

Direito

- Estes itens aparecem no menu quando o &RMB; é pressionado:

  - Copiar

  - Colar

  - Com uma seleção de texto aparecerá um submenu Pesquisar por com uma lista dos Atalhos da Web preferidos, bem como uma opção para configurar os atalhos da Web.

  - Abrir gerenciador de arquivos

  - Definir codificação

  - Limpar histórico

  - Ajustar histórico...

  - Mostrar barra de menus, apenas quando o menu estiver oculto

  - Mudar o perfil

  - Editar o perfil atual...

  - Fechar aba

  Em um aplicativo com suporte a mouse, pressione a tecla &Shift; em conjunto com o &RMB; para ver o menu de contexto.

### Arrastar e soltar

Se soltar um arquivo, pasta ou &URL; em uma janela do &konsole;, irá aparecer um menu de contexto com estas ações:

Menu de contexto de arrastar e soltar Menu de contexto de arrastar e soltar

&Shift;Mover aqui

- Move o item solto para a pasta atual. Esse item só aparece no menu de contexto se você tiver permissão para excluir o arquivo ou pasta solto.

&Ctrl;Copiar aqui

- Copia o item solto para a pasta atual.

&Ctrl;&Shift;Criar link aqui

- Cria um link simbólico para o item solto.

Colar localização

- Insere o caminho completo do arquivo do item solto no cursor.

Alterar a pasta para

- Se soltar uma pasta, esta ação aparece no menu de contexto e permite-lhe alterar a pasta de trabalho da sessão do &konsole;.

&Esc;Cancelar

- Interrompe a ação de arrastar e soltar.

Em uma ação de arrastar e soltar, caso pressione as teclas de atalho antes de soltar o &LMB;, nenhum menu de contexto aparecerá e as ações serão executadas imediatamente.

Se quiser usar a tecla &Ctrl; para arrastar e soltar ou desativar o menu de contexto para inserir &URL;s como texto por padrão, ative as opções correspondentes na aba Mouse na caixa de diálogo de configuração do perfil.

### Integração com a semântica do shell

Um programa shell em execução no Konsole pode emitir sequências de escape que divide o texto exibido em três tipos: prompt do shell, entrada do usuário e saída do comando. O uso dessas informações semânticas permite vários aprimoramentos no Konsole.

- &Ctrl;&Shift;PgUp e &Ctrl;&Shift;PgDown rola para cima/baixo para o prompt de comando anterior/seguinte.

- Dicas visuais:

  - Uma linha é exibida acima de cada prompt, as cores do prompt são menos intensas e as cores da saída são mais intensas.

  - Uma barra vermelha é exibida à esquerda das linhas de entrada e saída dos comandos que resultaram em erro

  - Um fundo vermelho para as linhas de entrada e saída de comandos que resultaram em erro

  - Uma barra cinza é exibida à esquerda das linhas de entrada e saída de cada outro comando

  - Um fundo cinza para as linhas de entrada e saída de todos os outros comandos

  Cada um deles pode ser configurado para nunca aparecer, sempre aparecer ou apenas quando as dicas de URL forem exibidas. A configuração está na aba Integração semântica da página Geral da janela de configuração do perfil.

- As opções do menu de contexto Copiar entrada do usuário, Copiar saída do comando e Copiar exceto prompt podem ser usadas para filtrar a seleção quando ela for copiada para a área de transferência.

- Quando a seleção está vazia, a ação copiar para a área de transferência copia a entrada atual. Se não estiver vazia, copia a última saída se não houver entrada atual.

- Ao pressionar as setas para cima/para baixo durante a edição de um texto longo, o cursor será posicionado uma linha acima/abaixo, enviando o número apropriado de eventos de tecla para a esquerda/direita para o shell. Isso é configurável nas configurações do perfil.

- Clicar com o mouse na entrada de texto posicionará o cursor no local clicado. Configurável nas configurações do perfil.

- Pressionar a tecla &Ctrl; enquanto clica três vezes com o mouse na saída de um comando, seleciona toda a saída desse comando.

A integração semântica do shell precisa ser configurada no shell. Pressionar &Ctrl;&Alt;] irá colar os comandos necessários no bash. Para outros shells, como fish, zsh, python, etc., consulte a documentação do programa correspondente.

### Layout de texto complexo

Na aba Layout de texto complexo da página Aparência na caixa de diálogo Editar perfil, você encontrará opções que controlam a renderização do texto.

- Modo de palavra - neste modo, (algumas) strings são exibidas na tela como um todo, em vez de um caractere por vez. Isso permite que o Qt renderize o texto corretamente quando a forma de um caractere depende dos caracteres anteriores ou posteriores a ele. Isso pode resultar em posicionamento incorreto de alguns caracteres.

  Os espaços sempre quebram as sequências, garantindo que os caracteres estejam sempre nas posições corretas. Isso assegura que os caracteres nunca estejam muito longe de sua posição correta.

- Usar os mesmos atributos para cada palavra inteira - Quando esta opção está ativada, as palavras são renderizadas com os mesmos atributos (cor do texto, negrito, itálico, etc.). Se um atributo for alterado no meio de uma palavra, a alteração só terá efeito após o término da palavra. Quando esta opção está desativada, uma nova palavra começa quando os atributos são alterados. Isso resulta em caracteres que mudam de forma e posição ao mover o cursor ou selecionar o texto.

- Caracteres ASCII - Agrupa caracteres ASCII em palavras conforme descrito acima. O efeito mais notável desta opção é que habilitá-la mostra ligaduras de programação (para fontes que as suportam). Por exemplo, a string <= pode ser exibida como ⩽.

- Caracteres de escrita brâhmica - Agrupar caracteres brâhmicos conforme descrito acima. Sem esta opção (dependendo da fonte), algumas palavras podem não ser conectadas corretamente. Com esta opção ativada, os caracteres brâhmicos podem aparecer fora de posição. Por exemplo, o terceiro caractere da segunda linha pode não aparecer diretamente abaixo do terceiro caractere da primeira linha.

- Fonte de emoji: - Isso permite especificar a fonte a ser usada para os caracteres Emoji Unicode. Se não for definida, a fonte padrão do perfil será usada, ou alguma fonte alternativa poderá ser usada pelo sistema caso os glifos estejam ausentes.

- Renderização de texto bidirecional - Reordena caracteres da direita para a esquerda para que os textos em árabe e hebraico apareçam corretamente.

- Forçar direção da linha LTR - As linhas são sempre da esquerda para a direita. Sem isso, a direção de cada linha é determinada pelo primeiro caractere com forte direcionalidade.

- Substituição do modo BiDi para caracteres de tabela - Considerar caracteres gráficos de tabela como caracteres LTR fortes. Isso permite que tabelas contendo caracteres RTL sejam exibidas corretamente, mas pode causar ordem incorreta se esses caracteres forem usados ​​em textos RTL.

- Substituir wcwidth - Os caracteres problemáticos seguem o padrão Unicode, em vez do wcwidth() da glibc. Atualmente, apenas o hífen suave (Unicode 0x00AD), que tem wcwidth de 1 e largura Unicode de 0, é afetado por esta opção. Geralmente, esta opção deve ser desativada quando esses caracteres forem usados ​​principalmente na linha de comando e ativada quando forem apenas exibidos.

### Dicas visuais

Além das várias dicas visuais descritas em semantic-shell-integration, o &konsole; possui outras dicas visuais:

- Uma linha vertical na coluna 80 (ou outra). Isso é configurado na aba Diversos da página Aparência na caixa de diálogo Editar perfil.

- Os números de linha podem ser exibidos como uma sobreposição ao texto do terminal. Os números de linha aparecem em vermelho na extremidade direita de cada linha. As linhas são numeradas consecutivamente a partir da primeira (superior) linha na lista de rolagem. A exibição dos números de linha pode ser configurada na página Avançado na caixa de diálogo Editar perfil. A alternância entre os três modos de exibição também pode ser feita por um atalho de teclado. O atalho padrão é &Ctrl;&Alt;\

## Referência de comandos

### Barra de menus

A barra de menus encontra-se no topo da janela do &konsole;. Se ela estiver oculta, a opção Exibir barra de menus poderá ser acessada clicando com o botão direito na janela (desde que não esteja rodando nenhum aplicativo nessa janela, como o vi, minicom, etc.). O atalho padrão aparece ao lado de cada item de menu.

Alternativamente, pode ser usado o atalho &Ctrl;&Shift;M para mostrar ou ocultar a barra de menus.

#### Menu Arquivo

&Ctrl;&Shift;N Arquivo Nova janela

- Abre uma nova janela do &konsole; com o perfil padrão

&Ctrl;&Shift;T Arquivo Nova aba

- Abre uma nova aba com o perfil padrão

  O primeiro perfil no submenu será sempre "Padrão", que é o perfil integrado. Todos os outros perfis serão listados abaixo em ordem alfabética. O perfil padrão especificado pelo usuário estará em negrito.

Arquivo Duplicar aba

- Tenta duplicar a aba atual em uma nova aba

&Ctrl;&Shift;S Arquivo Salvar saída como...

- Salva o histórico atual como um arquivo de texto ou HTML

&Ctrl;&Shift;P Arquivo Imprimir tela...

- Imprime a tela atual. Por padrão, o tamanho do resultado é ajustado para caber no papel, sendo impresso com o texto em preto e sem fundo. Na caixa de diálogo de impressão, essas opções podem ser alteradas na aba Opções de saída.

Arquivo Abrir gerenciador de arquivos

- Abre o gerenciador de arquivos do &kde; na pasta atual. Por padrão, este é o &dolphin;.

&Ctrl;&Shift;W Arquivo Fechar sessão

- Fecha a sessão atual

&Ctrl;&Shift;Q Arquivo Fechar janela

- Sai do &konsole;

  O &konsole; exibirá uma caixa de diálogo de confirmação se houver mais de uma sessão aberta ou se determinados programas estiverem em execução em alguma sessão. Essas caixas de diálogo podem ser desativadas clicando na caixa de seleção Não perguntar novamente.

#### Menu Editar

&Ctrl;&Shift;C Editar Copiar

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

&Ctrl;&Shift;V Editar Colar

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

Editar Selecionar tudo

- Seleciona todo o texto na janela atual

Editar Copiar a entrada para Todas as abas da janela atual

- Permite que a inserção de dados da sessão atual seja enviada simultaneamente para todas as sessões da janela atual

&Ctrl;&Shift;. Editar Copiar a entrada para Selecionar abas...

- Permite que a inserção de dados da sessão atual seja enviada simultaneamente para todas as sessões escolhidas pelo usuário

&Ctrl;&Shift;/ Editar Copiar a entrada para Nenhuma

- Para de enviar a entrada da sessão atual para outras sessões

Editar Enviar sinal

- Envia o sinal indicado para o processo do console ou outro processo que tenha sido carregado quando a nova sessão foi iniciada.

  Os sinais disponíveis são:

  STOP | para interromper o processo
  CONT | para continuar, se estiver parado
  HUP | suspensão detectada no terminal em controle ou finalização do processo de controle
  INT | interrupção a partir do teclado
  TERM | sinal de finalização
  KILL | sinal de interrupção
  USR1 | sinal do usuário 1
  USR2 | sinal do usuário 2

  Consulte as páginas de manual do seu sistema para mais detalhes sobre o comando ``man` `7 signal``.

&Ctrl;&Alt;S Editar Configurar aba...

- Abre uma caixa de diálogo que permite alterar o formato do nome, o formato do título da aba remota e a cor da aba atual (mais informações)

&Ctrl;&Alt;U Editar Enviar por ZModem...

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

&Ctrl;&Shift;F Editar Localizar...

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

  Isso permite efetuar pesquisas com distinção entre maiúsculas e minúsculas, para a frente ou para trás, ou ainda por expressões regulares.

F3 Editar Localizar próxima

- Move para a próxima instância de pesquisa. Se a barra de pesquisa estiver em foco, você também pode usar a tecla &Enter;.

&Shift;F3 Editar Localizar anterior

- Move para a instância de pesquisa anterior. Se a barra de pesquisa estiver em foco, você também pode usar o atalho &Shift;&Enter;.

#### Menu Exibir

&Ctrl;( Exibir Dividir a exibição Dividir a exibição em esquerda/direita

- Divide todas as abas em janelas esquerdas e direitas

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

&Ctrl;) Exibir Dividir a exibição Dividir a exibição em superior/inferior

- Divide todas as abas em janelas superiores e inferiores

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

&Ctrl;&Shift;] Exibir Dividir a exibição Expandir exibição

- Torna a exibição atual maior

&Ctrl;&Shift;[ Exibir Dividir a exibição Reduzir exibição

- Torna a exibição atual menor

&Ctrl;&Shift;E Exibir Exibição dividida Alternar maximizar exibição atual

- Alterna a visualização atual entre o tamanho atual e o tamanho máximo

&Ctrl;&Shift;\ Exibir Exibição divida Tamanho igual para todas as abas

- Define o mesmo tamanho para todas as visualizações

&Ctrl;&Shift;L Exibir Desanexar a aba atual

- Abre a aba atual em uma janela separada

  Sair da janela anterior do &konsole; não afetará a janela recém-criada.

&Ctrl;&Shift;H Exibir Desanexar a exibição atual

- Abre a área dividida atual em uma janela separada

Exibir Salvar layout da aba para arquivo

- Permite salvar o layout de abas da visualização atual em um arquivo de layout especializado do &konsole;, que pode ser carregado para restaurar um de seus layouts favoritos.

Exibir Carregar layout de aba do arquivo

- Permite carregar um dos seus layouts de visualização favoritos a partir do arquivo de layout que foi salvo usando o item de menu Exibir Salvar layout da aba para arquivo anteriormente. Os layouts padrão (2x2, 2x1 e 1x2) podem ser carregados pela barra de ferramentas.

Exibir Monitores únicos

- Os seguintes monitores notificam apenas uma vez e depois são desativados.

&Ctrl;&Shift;R Exibir Monitor para prompt

- Ativa ou desativa o monitoramento da aba atual para um prompt do shell.

  Quando um prompt do shell é exibido, o &konsole; mostrará uma notificação. Esta opção é exibida somente quando a integração semântica está habilitada no shell.

&Ctrl;&Shift;I Exibir Monitor para silêncio

- Ativa ou desativa o monitoramento da ausência de atividade da aba atual

  Por padrão, após 10 segundos de inatividade, irá aparecer um ícone informativo na aba da sessão. O tipo de alerta poderá ser configurado através da opção Configurações Configurar notificações Silêncio em sessão monitorada.

&Ctrl;&Shift;A Exibir Monitor para atividades

- Ativa ou desativa o monitoramento de atividade da aba atual

  Em caso de qualquer atividade, irá aparecer um ícone informativo na aba da sessão. O tipo de alerta poderá ser alterado através da opção Configurações Configurar notificações Atividade em sessão monitorada.

Exibir Monitor para conclusão de processo

- Ativa ou desativa o monitoramento da aba atual pelo fim do processo.

  Se marcada, ao terminar o processo atual, o &konsole; exibirá uma notificação O processo '`nome do processo`' terminou de ser executado na sessão '`nome da sessão`'.

Exibir Somente leitura

- Ativa/desativa o modo somente para leitura para a sessão: não é aceito nenhuma introdução de dados e o arrastar e soltar fica desativado.

&Ctrl;+ Exibir Aumentar fonte

- Aumenta o tamanho da fonte do texto

&Ctrl;0 Exibir Restaurar o tamanho da fonte

- Restaura o tamanho da fonte do texto com o padrão do perfil

&Ctrl;- Exibir Diminuir fonte

- Diminui o tamanho da fonte do texto

Exibir Definir codificação

- Altera a codificação de caracteres

Exibir Limpar histórico

- Limpa o texto no histórico

&Ctrl;&Shift;K Exibir Limpar histórico e reiniciar

- Limpa o texto na aba atual e no histórico, reiniciando depois o terminal

F11 Exibir Modo de tela cheia

- Ativa ou desativa a utilização da tela cheia pelo &konsole;

#### Menu Favoritos

&Ctrl;&Shift;B Favoritos Adicionar favorito

- Adiciona o local atual

Favoritos Adicionar abas aos favoritos como pasta...

- Adiciona todas as abas como uma pasta de favoritos

  Será aberta uma janela para inserir o nome da pasta de favoritos.

Favoritos Nova pasta de favoritos...

- Adiciona uma nova pasta à lista de favoritos

  Será aberta uma janela para inserir o nome da pasta de favoritos.

Favoritos Editar favoritos

- Abre o editor de favoritos

  O programa keditbookmarks precisa estar instalado para que este item de menu fique visível.

  Você poderá usar o editor de favoritos para adicionar URLs manualmente. No momento, o &konsole; tem suporte aos seguintes formatos:

  - ssh://usuário@máquina:porta

  - telnet://usuário@máquina:porta

#### Menu Plugins

Os plugins instalados serão listados ou aparecerá a mensagem "Nenhum plugin disponível"

#### Menu Configurações

Configurações Editar o perfil atual...

- Abre uma caixa de diálogo para editar o perfil atual

Configurações Mudar o perfil

- Muda o perfil atual para um perfil listado

Configurações Gerenciar perfis...

- Abre um editor para gerenciar os perfis

Configurações Esquema de cores da janela

- Alterar a &GUI; do &konsole; para o esquema especificado

&Ctrl;&Shift;M Configurações Mostrar barra de menus

- Ativa ou desativa a visibilidade do menu

Configurações Barras de ferramentas visíveis

- Permite ativar/desativar a visibilidade das barras de ferramentas do &konsole;

Configurações Mostrar barra de status

- Ativa ou desativa a visibilidade da barra de status

Configurações Configurar idioma...

- Abre uma janela para escolher uma tradução da interface do &konsole;.

Configurações Configurar atalhos do teclado...

- Abre o editor de atalhos de teclado. Mais informações sobre a configuração de atalhos podem ser encontradas nos Fundamentos do &kde;.

  Além disso, o &konsole; tem alguns atalhos especiais que não possuem itens de menu correspondentes:

  Atalho | Descrição
  &Shift;Seta à direita | Próxima aba
  &Shift;Seta à esquerda | Aba anterior
  &Ctrl;&Alt;Seta à esquerda | Mover aba para a esquerda
  &Ctrl;&Alt;Seta à direita | Mover aba para a direita
  &Ctrl;&Shift;Ins | Colar a seleção

Configurações Configurar barras de ferramentas...

- Abre a janela de configuração da barra de ferramentas

Configurações Configurar notificações...

- Abre o editor de notificações

Configurações Configurar o &konsole;...

- Abre o editor de configurações do &konsole;

  Esta caixa de diálogo possui opções que influenciam a aparência e o comportamento da janela do &konsole;.

  - A página Geral permite configurar a visibilidade da barra de menus, memorizar o tamanho da janela do &konsole;, executar todas as janelas do &konsole; em um único processo, ativar atalhos de menu, exibir o título da janela na barra de título, remover a barra de título e a moldura da janela e focar os terminais quando o ponteiro do mouse for movido sobre eles. Também é possível configurar a diferenciação entre maiúsculas e minúsculas na pesquisa, o uso de expressões regulares, destacar todas as correspondências e a direção da pesquisa (Pesquisar para trás é o padrão). A página Geral também é o local onde você pode Reativar todas as mensagens "Não perguntar novamente" caso elas tenham sido desativadas anteriormente.

  - A página Perfis destina-se à criação e gestão de perfis.

  - Na página Barra de abas/Divisores, você pode configurar a visibilidade e o posicionamento da barra de abas, definir o comportamento das abas e ajustar as opções dos botões das abas. É possível configurar se você deseja Mostrar o botão 'Nova aba' e Expandir a largura das abas individuais para toda a janela ou configurar o Uso de uma folha de estilo definida pelo usuário. A aba Comportamento pode ser usada para definir o local das novas abas (No final ou Após a aba atual) e o fechamento das abas com um clique do &MMB;.

    Também é possível configurar a visibilidade dos cabeçalhos divididos (Quando necessário (padrão), Sempre ou Nunca) e definir o tamanho da alça de arrastar para as divisões (Pequeno (padrão), Médio ou Grande) usando a aba Divisões desta página de configuração.

  - A página Arquivos temporários é usada para definir a localização do arquivo scrollback.

  - A página Miniaturas pode ser usada para definir o tamanho da miniatura e as opções de ativação (você pode escolher a tecla de controle de ativação entre &Shift;, &Alt; e &Ctrl;).

    Para usar o recurso de miniaturas que exibe miniaturas de imagens em janelas pop-up ao passar o cursor do mouse sobre os itens de imagem, você deve ativar o sublinhado de arquivos para o seu perfil atual: Configurações Editar perfil atual...Mouse Diversos Sublinhar arquivos.

#### Menu Ajuda

O &konsole; tem alguns dos itens comuns do menu Ajuda do &kde;. Para mais informações, leia a seção Menu Ajuda nos Fundamentos do &kde;.

### Caixas de diálogo do &konsole;

#### Janela para configurar aba

O formato do nome, o formato do título da aba remota e a cor da aba atual podem ser alterados nesta janela, que poderá ser exibida através do menu, usando o atalho &Ctrl;&Alt; S ou com um clique duplo na aba. Essas alterações são temporárias e poderão se tornar permanentes se editar o perfil atual.

O &konsole; irá substituir estes itens para as abas locais:

- %n : nome do programa

- %d : pasta atual (curta)

- %D : pasta atual (completa)

- %h : máquina local (curta)

- %u : nome do usuário

- %B : sigilo da linha de comandos Bourne do usuário ($ = usuário normal, # = superusuário)

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

- %# : número da sessão

O &konsole; irá substituir estes itens para abas remotas:

- %c : programa atual

- %h : máquina remota (curta)

- %H : máquina remota (completa)

- %u : nome do usuário

- %U : nome do usuário (se indicado)

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

- %# : número da sessão

Exemplos:

- `%d : %n`, com /usr/src como pasta atual e executando o bash irá mostrar src : bash

- `%D : %n`, com /usr/src como pasta atual e executando o top irá mostrar usr/src : top

- `%w (%#)`, com ~ como pasta atual e executando o vim na primeira aba irá mostrar [Sem Nome] (~) - VIM(1)

#### Janela de Cópia da Entrada

O texto inserido em uma aba poderá ser enviado simultaneamente para as outras abas. Esta janela permite-lhe selecionar quais as abas irão receber esses dados inseridos. A aba atual ficará com uma tonalidade cinza.

#### Janela de ajuste do histórico

As opções do histórico poderão ser alteradas nesta janela. Qualquer alteração será apenas para a aba atual e não será salva no perfil.

## Opções da linha de comando

Quando o &konsole; é iniciado a partir da linha de comando, várias opções podem ser indicadas para modificar seu comportamento.

`--help`

- Lista diversas opções.

`--profile` `arquivo`

- Inicia o &konsole; usando o perfil indicado em vez do perfil padrão.

`--layout` `arquivo`

- Inicia o &konsole; usando um arquivo de layout &JSON; salvo.

`--builtin-profile`

- Usa o perfil integrado em vez do perfil padrão atual.

`--workdir` `pasta`

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

`--hold, --noclose`

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

`--new-tab`

- Cria uma nova aba em uma janela existente em vez de criar uma nova.

`--tabs-from-file` `arquivo`

- Cria abas a partir dos dados definidos no arquivo de configuração de abas indicado.

  O arquivo possui uma aba por linha, no seguinte formato:

  Cada linha define uma aba a abrir, usando até 4 campos para definir como será aberta. Os campos são separados com `;;` e o nome de um campo deverá ter um `:` adicionado. As linhas em branco ou que comecem com `#` serão ignoradas. Dessa forma, você pode usar uma linha que começa com `#` para adicionar comentários.

  - `title:` um nome para esta aba, sendo usado o valor padrão se estiver em branco ou não for indicado
  - `workdir:` pasta de trabalho, igual a `~` se estiver e branco ou não for indicada
  - `profile:` um perfil do &konsole; a ser utilizado, sendo usado o padrão se estiver em branco ou não for indicado
  - `command:` um comando a executar

  Cada linha deverá conter pelo menos um campo `command` ou `profile`.

  Exemplo: `title: %n;; command: /usr/bin/top ;; profile: Shell`

`--background-mode`

- Inicia o &konsole; em segundo plano e muda para primeiro plano ao pressionar &Ctrl;&Shift;F12 (atalho padrão).

`--separate`

`--nofork`

- Executa a nova instância do &konsole; em um processo separado.

`--show-menubar`

- Mostra a barra de menus, sobrepondo-se ao comportamento padrão.

`--hide-menubar`

- Oculta a barra de menus, sobrepondo-se ao comportamento padrão.

`--show-tabbar`

- Mostra a barra de abas, sobrepondo-se ao comportamento padrão.

`--hide-tabbar`

- Oculta a barra de abas, sobrepondo-se ao comportamento padrão.

`--fullscreen`

- Inicia o &konsole; no modo de tela cheia.

`--notransparency`

- Desabilita fundos transparentes mesmo se existir suporte no sistema.

`--list-profiles`

- Lista todos os perfis disponíveis.

`--list-profile-properties`

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

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

`-p` `propriedade=valor`

- Muda o valor de uma propriedade de perfil.

`-e` `comando`

- Executa o `comando` ao invés do shell normal.

  Esta opção irá capturar todos os argumentos seguintes passados ao &konsole; e executá-los como um `comando`. Por esse motivo, use esta opção sempre por último.

O &konsole; também aceita as opções genéricas do &Qt; e do &kf6-full;. Veja as páginas de manual para qt6options e kf6options.

## Criação de scripts no &konsole;

O &konsole; tem suporte a diversos recursos que podem ser usados com o &DBus;.

Existem duas formas de usar a interface &DBus;: a Interface Gráfica do &Qt; qdbusviewer e o utilitário de linha de comando qdbus.

Exemplos:

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

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

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

- `%` `qdbus` `org.kde.konsole $KONSOLE_DBUS_WINDOW` irá mostrar os métodos para controle da janela atual.

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

- `%` `qdbus` `org.kde.konsole $KONSOLE_DBUS_SESSION` irá mostrar os métodos para controle da sessão atual.

- `%` `qdbus` `org.kde.konsole $KONSOLE_DBUS_SERVICE $KONSOLE_DBUS_SESSION` irá mostrar os métodos para controle da sessão atual do &konsole;.

Se algum dos comandos acima apresentar: 'Service 'org.kde.konsole' does not ""exist' (O serviço 'org.kde.konsole' não existe), altere o `org.kde.konsole` para um dos seguintes:

- `org.kde.konsole-`pidof -s konsole`` (irá selecionar o primeiro PID)

- `$KONSOLE_DBUS_SERVICE` (isto pode ser usado a partir do &konsole; actual)

- `selecione um dos resultados do comando 'qdbus | grep konsole'`

Para obter mais informações, consulte o tutorial do &DBus;.

## Combinações de teclas do Terminal

### Como o &konsole; usa as combinações de teclas

#### Introdução

O &konsole; usa arquivos *.keytab para traduzir as combinações de teclas em caracteres de controle e sequências de escape que são enviadas para o shell ou para os programas interativos (normalmente os programas que usam o buffer da tela alternativa, ⪚ vim, less, screen) executados a partir da linha de comando.

Os usuários poderão personalizar a configuração das combinações de teclas no &konsole; com o Editor de Atalhos de Teclado. Poderá também configurar uma combinação de teclas para enviar um controle específico ou sequência de escape para o terminal.

Você poderá abrir o Editor de Atalhos de Teclado a partir do item de menu Configurações Editar o perfil atual e indo à página Teclado. Aqui aparecem enumerados os esquemas de Combinações de Teclas que disponibilizados por padrão no &konsole;.

#### Combinações de Teclas e Modos

As combinações de teclas seguem o padrão:

    Tecla (+|-) Modos

por exemplo:

    Up+Shift+AppScreen
    Down+Shift-AppScreen
    Space+Ctrl

Os nomes das teclas estão definidos no arquivo qnamespace.h, com o prefixo Qt::Key_ removido. Para obter uma lista com os nomes das teclas, consulte a enumeração Qt::Key na documentação do &Qt;.

Um + que antecede o nome de um Modo significa que esse modo está definido; para uma tecla modificadora, indicando que está pressionada, enquanto que para os outros modos significa que esse modo em particular está em efeito (&ie;, ativo). Por exemplo, o +Ctrl significa que a combinação de teclas só irá funcionar se a tecla &Ctrl; estiver pressionada.

Um - que antecede o nome de um Modo significa que esse modo está desativado; basicamente, este é o oposto de colocar um + antes do nome de um Modo. Assim, para uma tecla modificadora, isso significa que a tecla não está pressionada enquanto que, para todos os outros modos, significa que esse modo em particular está inativo. Por exemplo, o -Ctrl significa que a combinação de teclas só irá funcionar se a tecla &Ctrl; não estiver pressionada.

Se um nome de Modo não estiver presente em uma combinação de teclas, o seu estado será ignorado.

Os modos de Combinações de Teclas aparecem relacionados abaixo:

Alt, Ctrl, Shift

- Um ou mais Modos como estes poderão ser usados em uma combinação de teclas. Caso algum deles esteja definido, a combinação de teclas usa essa tecla modificadora, respectivamente, ou se não estiver definido, aplica-se o modo inverso.

AnyModifier

- Se este modo estiver definido, a combinação de teclas usa qualquer tecla modificadora (das acima mencionadas) e se não estiver definido, não utilizará

Ansi

- Se este modo estiver definido, o &konsole; irá enviar as sequências de controle e escape do ANSI

  Se este modo não estiver definido, o &konsole; irá enviar as sequências de controle e escape do VT52

AppScreen

- Se este modo estiver definido, a combinação de teclas só irá afetar os programas interativos que usam o buffer da tela alternativa

  Se este modo estiver desativado, a combinação de teclas só irá afetar o terminal quando estiver usando o buffer da tela norma

  O &konsole; utiliza dois buffers de tela:

  - O buffer de tela normal (padrão): permite-lhe rolar para ver as linhas de resultado anteriores. Este é o buffer padrão que normalmente usado para executar os comandos, &etc;

  - O buffer de tela alternativa: o terminal muda para este buffer quando você executar um programa interativo (⪚, less, vim, screen, tmux... &etc;)

KeyPad

- Se este modo estiver ativo, a combinação de teclas usa uma tecla no teclado numérico. Este modo é útil para distinguir entre as teclas no teclado normal e as equivalentes no teclado numérico. Por exemplo, quando o Num Lock está ligado, você poderá configurar duas combinações de teclas em separado, uma que usa a tecla 1 no teclado (normalmente abaixo da tecla F1) e a outra usando a tecla 1 no teclado numérico. O mesmo conceito se aplica quando o Num Lock está desligado para as teclas End, Home, Setas direcionais, etc., no teclado numérico

AppCursorKeys

- Este modo implementa o Modo das Teclas de Cursores (DECCKM) do VT100. Ele controla as sequências de escape que cada tecla de cursor (Para cima, Para baixo, Direita, Esquerda) envia, dependendo de este modo estar ativado ou desativado

  Por padrão, o &konsole; segue o comportamento do XTerm para tratar as teclas Home e End como teclas de cursores, no que diz respeito ao DECCKM

AppKeyPad

- Se este modo estiver ativo, a combinação de teclas só irá funcionar quando o teclado numérico estiver no Modo de Aplicativo (DECKPAM)

  Se este modo estiver desativado, a combinação de teclas só irá funcionar quando o teclado numérico estiver no Modo Numérico (DECKPNM)

NewLine

- Se este modo estiver ativo, a tecla Return (Enter) do teclado irá enviar ambos os caracteres de controle 'Carriage Return' "\r" e 'New Line' "\n"

  Se este modo estiver desativado, a tecla Return só irá enviar um 'Carriage Return' "\r"

  O mesmo se aplica à tecla Enter no teclado numérico

  Este modo emula o Modo LNM - Line Feed/New Line

Repare que cada combinação de teclas e modos (ativado/desativado) deverá ser única. Por exemplo, considerando as duas regras seguintes:

- A+Shift : A

- a : a

O &konsole; não aceitará a regra da letra minúscula a e você precisará adicionar um -Shift a essa regra para que ela funcione.

#### O campo Saída

No campo Saída, você poderá adicionar as sequências de escape ou caracteres de controle que deseja que o &konsole; envie para o terminal, quando a combinação de teclas associada for pressionada.

Você também poderá usar qualquer uma das seguintes palavras-chave, tendo cada uma delas um significado especial no &konsole;:

- scrollUpLine : sobe uma linha no buffer de rolagem do histórico do shell

- scrollUpPage : sobe uma página no buffer de rolagem do histórico do shell

- scrollDownLine : desce uma linha no buffer de rolagem do histórico do shell

- scrollDownPage : desce uma página no buffer de rolagem do histórico do shell

- scrollUpToTop : sobe até ao início do buffer de rolagem do histórico do shell

- scrollDownToBottom : desce até o final do buffer de rolagem do histórico do shell

Você também pode usar strings com sintaxes de texto em C, com as seguintes sequências de escape:

- \E : Escape

- \\ : Barra invertida

- \" : Aspas

- \t : Tabulação

- \r : Carriage Return

- \n : Nova linha

- \b : Backspace

- \xHH : onde HH são dois dígitos hexadecimais

  Isto poderá ser usado para enviar caracteres de controle em &ASCII;, ⪚, \x00 que corresponde ao caractere NUL

#### Outros recursos do sistema

Existem outros recursos do sistema que poderão afetar as combinações de teclas do terminal:

- Consulte o banco de dados do terminfo ou termcap para conhecer as sequências de escape e caracteres de controle esperados que cada combinação de teclas deve enviar.

- É provável que o seu sistema tenha outros bancos de dados de teclado que devem estar igualmente sincronizadas (⪚, /etc/inputrc e readline para a linha de comando BASH), pois afetam as operações (interações) associadas às combinações de teclas.

#### Leitura complementar

Para mais informações sobre as sequências de escape e caracteres de controle, consulte a seguinte documentação:

- Guia de usuário do VT100

- Guia de usuário do VT102

- Documentação abrangente e indispensável das Sequências de Controle do XTerm

## Usando uma folha de estilo para a barra de abas

A folha de estilo padrão da barra de abas define as larguras mínima e máxima das abas. O usuário pode criar um arquivo `.css` e usá-lo como folha de estilo para a barra de abas do &konsole;. No arquivo `.css`, o elemento a ser usado é o `QTabBar::tab`.

Para mais informações, leia Folhas de Estilo do &Qt;

Exemplos:

- Alterar o fundo da aba selecionada para cinza-claro

      QTabBar::tab:selected {
          background: #999999
      }

- Alterar o texto da aba selecionada para vermelho

      QTabBar::tab:selected {
          color: red
      }

- Todas as abas terão no mínimo 200 pontos de largura

      QTabBar::tab {
          min-width: 200px
      }

- Apenas a aba selecionada terá no mínimo 200 pontos de largura

      QTabBar::tab::selected {
          min-width: 200px
      }

- Qualquer um destes estilos pode ser combinado em um único arquivo

      QTabBar::tab::selected {
          background: #999999;
          color: red;
          min-width: 200px;
      }
      QTabBar::tab {
          min-width: 100px
      }

## Você sabia?, problemas comuns e outras informações

### Você sabia?

- Pressionar a tecla &Ctrl; ao selecionar um texto faz com que as quebras de linha sejam convertidas para espaços ao serem coladas.

- Pressionar as teclas &Ctrl;&Alt; ao selecionar um texto também irá selecionar as colunas.

- A combinação &Ctrl;Roda do mouse amplia ou reduz o tamanho do texto, como no Konqueror e Firefox.

- Quando um programa avalia os botões do mouse, pressionar a tecla &Shift; permitirá que o menu de contexto apareça.

- O atalho &Ctrl;&Shift;F10 ativará o menu.

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

- Um clique duplo selecionará uma palavra inteira. Continuar com o botão do mouse pressionado e mover o mouse estenderá a seleção.

- Um clique triplo selecionará uma linha inteira. Continuar com o botão do mouse pressionado e mover o mouse estenderá a seleção.

- Existe uma funcionalidade oculta para o formatador "%d" no título da aba. Você pode indicar ao &konsole; para abreviar o nome de uma pasta para o seu primeiro caractere. Por exemplo, o "/local/do/konsole/src" pode ser abreviado para "konsole/s". Se deseja ativar e controlar esta funcionalidade oculta, abra o `konsolerc` em ``qtpaths` `--paths GenericConfigLocation`` e adicione as seguintes linhas:

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

  Se estiver usando o Yakuake, edite o arquivo `yakuakerc` em ``qtpaths` `--paths GenericConfigLocation``.

### Problemas comuns

- Algumas fontes podem estar indisponíveis no &konsole;, mesmo que estejam disponíveis para outros aplicativos. Isto não significa que haja um erro no &konsole;. O &konsole; necessita de fontes monoespaçadas para oferecer o melhor resultado visual e, desta forma, solicita ao &Qt; para apresentar apenas as fontes monoespaçadas.

  A partir da versão 16.08 (agosto de 2016), o &konsole; pode ser configurado para permitir a seleção de qualquer fonte, mas pode ser que a apresentação não fique correta.

- Desde o KDE4, todas as abas usam o mesmo ID de processo. Isto tem um efeito colateral de que se o processo de uma aba tiver problemas, todas as outras abas podem experimentar o mesmo problema.

  Isto é particularmente percebido quando um comando que se conecta a um dispositivo externo ou sistema (ssh, nfs) apresenta problemas.

- O &konsole; trata os argumentos após a opção `-e` como um único comando, executando-o diretamente, em vez de os processar e dividir em subcomandos para execução. Isto é diferente no 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 shell de autenticação, porque os desenvolvedores não gostam da ideia de executar shell de autenticação em um emulador de terminal.

  Obviamente, os usuários podem ainda executar shell de autenticação no &konsole; se realmente necessitarem disto. Edite o perfil usado e modifique o comando de forma a iniciar um shell de autenticação de forma explícita, como por exemplo, "`bash -l`" ou "`zsh -l`".

- A opção `--new-tab` comporta-se algumas vezes de forma estranha. Ela pode criar uma nova janela ou aba em outra janela existente do &konsole;, em vez da janela atual.

  Esses 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 comando não podem.

## Créditos e Direitos Autorais

O &konsole; é atualmente mantido 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;

O aplicativo &konsole; tem o Copyright © 1997-2008 de &Lars.Doelle; &Lars.Doelle.mail;

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

Este documento foi atualizado para o &kde; 4.x por &Kurt.Hindenburg; &Kurt.Hindenburg.mail;

Este documento foi atualizado para o &kde; 3.4 por &Kurt.Hindenburg; &Kurt.Hindenburg.mail;

Convertido originalmente para DocBook SGML por &Mike.McBride; e &Lauri.Watts;

Tradução de Marcus Gama marcus.gama@gmail.com e André Marcelo Alvarenga alvarenga@kde.org

&underFDL; &underGPL;

## Links

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

- Site do &konsole; no &kde; UserBase

- Site do &konsole;

- Lista de discussão do &konsole;

- &kde; no FreeBSD

- &kde; no &Solaris;

&documentation.index;