Teclas e consola

Teclas

A barra de atalhos de duas linhas fica por baixo da linha de comando. A primeira linha mostra as teclas de função; a segunda mostra a pesquisa, as coleções e outros atalhos que dependem do que está a fazer. Pode clicar nas duas linhas. As notificações substituem a segunda linha durante uns instantes.

Tecla	Ação
Up, Down, PgUp, PgDn, Home, End	Mover
Enter, Right	Abrir uma pasta / executar ou ver um ficheiro
Left	Ir para a pasta pai
Ctrl-PgDn / Ctrl-PgUp	Abrir a pasta ou o arquivo sob o cursor / ir para a pasta pai
Tab	Alternar entre painéis, ou entrar na pré-visualização e voltar à lista de ficheiros
Ctrl-O	Mostrar a shell / voltar aos painéis
Alt-I	Contar tamanhos de pastas em segundo plano / parar a contagem
Ctrl-S	Localização rápida na pasta
Ctrl-\	Pastas favoritas: saltar para uma pasta fixada ou recente
Ctrl-Q	Pré-visualização: mostra o ficheiro sob o cursor (texto, imagem ou pasta) no outro painel
Ctrl-L	Informações: mostra tamanho, permissões, proprietário, datas, espaço livre e o disco no outro painel
Insert, Ctrl-T, Shift-Up/Down	Marcar ficheiros
+ - *	Selecionar, desselecionar ou inverter por padrão (*.rs, build/)
Alt-Enter	Colocar os nomes marcados (ou o atual) na linha de comando; em .., o caminho da pasta pai
Ctrl-Insert / Alt-Shift-Insert	Copiar os nomes marcados / os respetivos caminhos completos
Shift-F10	Menu de contexto: o que pode copiar do item sob o cursor e as teclas que atuam sobre ele
Shift-Enter, Ctrl-J	Inserir uma quebra de linha no cursor da linha de comando; Enter executa o comando, Ctrl-C limpa-o
Alt-A / Alt-Shift-A	Colocar na linha de comando o caminho da pasta deste painel / do outro painel
Shift-PgUp / Shift-PgDn	Percorrer a saída da consola para trás e para a frente
Shift-Home / Shift-End	Ir para a saída mais antiga da consola / voltar ao prompt ativo
Ctrl-P / Ctrl-N, Ctrl-R	Histórico da shell: comando anterior / seguinte, pesquisa (tratados pela sua shell)
Alt-.	Mostrar ficheiros ocultos
Alt-R	Recarregar o painel ativo: a pasta, os resultados de pesquisa ou a coleção
Alt-H	Hosts remotos: máquinas emparelhadas e as respetivas sessões
Alt-Shift-Left/Right	Redimensionar os painéis
Ctrl-U	Trocar os painéis
Alt-O	Abrir a pasta deste painel no outro painel; nos resultados de pesquisa ou numa coleção, a pasta do ficheiro sob o cursor
Alt-J	Tarefas: pausar ou cancelar cópias, movimentações e eliminações em curso
Alt-M	Monitor de atividade: processos e memória
Alt-C	Docker: projetos Compose e contentores
Alt-N	Rede: portas, ligações e tráfego
Alt-U	Itens de arranque: o que arranca sozinho, alteração mais recente primeiro
Alt-L	Alertas: o que o observador de processos encontrou
Alt-T	Time Machine: o que as cópias de segurança deixam de fora, no macOS
Alt-E	Editar o ficheiro selecionado neste painel, em vez dos seus ficheiros, ou no outro painel ao lado dos resultados
F1	Sobre
F2	Menu Ficheiro
F3	Ver (texto ou imagem)
F4 / Shift-F4	Editar no editor do Borg / em $VISUAL ou $EDITOR
F5 / F6	Copiar / mover para o outro painel
F7	Criar uma pasta
F8	Eliminar
F9	Barra de menus
F10	Sair

Tab, Enter, Home, End, Left e Right controlam os painéis enquanto a linha de comando está vazia. Assim que começa a escrever um comando, estas teclas passam para a shell. Ctrl-P, Ctrl-N e Ctrl-R usam o histórico de comandos da sua shell. Shift-Enter (ou Ctrl-J) insere uma quebra de linha sem executar o comando. Os comandos com várias linhas, escritos ou recuperados do histórico, tornam a área do prompt mais alta e os painéis mais baixos, para que o cursor fique sempre visível. Todas as teclas habituais de edição e de conclusão da sua shell continuam a funcionar.

Quando volta à pasta pai, o cursor fica na pasta de onde veio, na mesma linha do ecrã e com a lista na mesma posição em que estava quando entrou. Se entretanto surgiram ou desapareceram ficheiros, ou se o painel mudou de altura, o cursor fica na mesma pasta, tão perto da linha anterior quanto a lista permitir.

Alt-Enter escreve os nomes tal como a shell os vê a partir da pasta do painel. Em .. escreve o caminho completo da pasta pai, porque o nome da pasta pai, sozinho, apontaria para dentro da pasta atual. Nos resultados de pesquisa e nas coleções escreve caminhos completos, já que os ficheiros vêm de pastas diferentes.

O que copia chega à área de transferência do computador através do terminal, mesmo por SSH e num espelho que controle. O Borg guarda também as últimas 20 cópias: Ctrl-V ou Shift-Insert cola a mais recente nos campos do próprio Borg, como as caixas de diálogo e a pesquisa de memória, mesmo quando o terminal não tem acesso à área de transferência. Na linha de comando, Ctrl-V pertence à shell, por isso cole aí com o atalho de colar do terminal. O menu Ficheiro oferece as duas ações de cópia para teclados sem tecla Insert. As cópias demasiado grandes para o terminal transmitir ficam no Borg.

Se o terminal reservar as teclas F para si, prima Esc e depois um algarismo no espaço de 1,5 segundos: Esc 1 a Esc 9 equivalem a F1 a F9, e Esc 0 a F10. Por exemplo, Esc 9 abre os menus e Esc 5 copia. Enquanto o Borg espera pelo algarismo, a linha das teclas de função mostra qual premir. Se houver algo aberto (uma notificação, resultados, a pré-visualização ou Informações), o primeiro Esc fecha-o e um segundo Esc cancela. Alt-1 a Alt-0 também funcionam quando o terminal deixa passar a tecla Alt. No macOS, pode ser necessário ativar “Use Option as Meta key” (usar Option como tecla Meta) no terminal.

Os atalhos também funcionam com esquemas de teclado não latinos: russo, ucraniano, bielorrusso, cazaque, grego, hebraico, árabe, georgiano, coreano e tailandês. Uma letra de um destes esquemas premida com Ctrl ou Alt conta como a tecla que ocupa o mesmo lugar num teclado americano, tal como uma letra premida num ecrã ou numa caixa de diálogo que não está à espera de texto. Com o esquema russo ativo, Alt-M abre o monitor de atividade e Ctrl-C chega à shell. A linha de comandos, o editor e os campos do Borg mantêm as letras que escreve. As perguntas com os botões [ Sim ] e [ Não ] aceitam Y e N em qualquer idioma e também a primeira letra de cada botão no idioma do Borg, como S para Sim e N para Não em português.

Rato e consola

Clique numa linha para lhe mover o cursor, faça duplo clique para a abrir e clique com o botão direito para abrir o respetivo menu de contexto. Clique na barra de menus ou na barra de atalhos para as usar. A roda do rato percorre o painel.

As caixas de diálogo também funcionam com o rato. Clique numa linha de uma lista para a escolher; nos seletores de tema e de idioma, em Hosts remotos e em Acesso remoto, um segundo clique confirma. A roda percorre listas como as de temas, definições e tarefas. As teclas indicadas no contorno de uma caixa de diálogo podem ser clicadas: clique em Esc Fechar para fechar a caixa, ou num botão para responder a uma pergunta. Clicar fora de uma lista, de um seletor ou de Sobre fecha-os, enquanto os formulários e as perguntas ficam abertos até responder.

Ctrl-O alterna entre os painéis e a consola. Antes de escrever ou de abrir a consola, a shell muda para a pasta do painel ativo. No zsh isto acontece de forma silenciosa e o prompt é redesenhado; no bash e no fish, vê na consola um breve comando cd. Se tiver aberto a consola por iniciativa própria, ela continua aberta depois dos comandos e de Ctrl-C. “Regressar aos painéis após o comando” aplica-se apenas aos comandos executados a partir dos painéis. No prompt da shell, Option-Left e Option-Right (Alt no Linux) avançam palavra a palavra.

Na consola, a roda do rato percorre a saída para trás sem mexer no comando que está a escrever. Shift-PgUp e Shift-PgDn percorrem uma página de cada vez, Shift-Home salta para a saída mais antiga e Shift-End volta ao prompt ativo, tal como começar a escrever. Para copiar a saída visível, selecione-a da forma que o terminal permitir, normalmente arrastando com Shift, e use o atalho de copiar habitual.

Menu de contexto

Clique com o botão direito numa linha, ou prima Shift-F10, para ver o que pode fazer com o item sob o cursor. O menu mostra o nome do item no contorno, começa pelo que pode copiar dele e depois lista as teclas que atuam sobre ele, pelo que também lhas recorda. Up e Down escolhem uma entrada, Enter ou um clique executa-a e Esc fecha o menu. Os terminais que enviam a tecla Menu também o abrem. Um clique com o botão direito leva primeiro o cursor para a linha; para marcar linhas com o rato, escolha Marcar no menu.

O que o menu oferece depende da linha:

• Ficheiros e pastas: Copiar caminho, Copiar nome e Copiar caminho da pasta, depois Ver, Editar, Copiar, Mover e Eliminar, e Marcar, que marca a linha como Insert. Com ficheiros marcados, atua sobre todos eles e cada cópia tem uma linha por ficheiro. Nos resultados oferece também Revelar original, e Eliminar passa a Remover / ações. Num resultado de uma pesquisa no conteúdo, Copiar caminho e linha copia path:line da primeira ocorrência, pronto para um editor que abra um ficheiro numa linha.
• Processos no monitor de atividade: Copiar PID, Copiar nome e Copiar caminho do programa, depois Sinal ou prioridade… (K), Ficheiros abertos (2), Mapa de memória (1) e Tráfego de rede (Alt-N).
• Ficheiros abertos de um processo: Copiar caminho, e Ver para um ficheiro normal.
• Contentores: Copiar ID e Copiar nome, depois Iniciar, Parar, Reiniciar, Pausar, Ficheiros e Shell, como no menu Docker.
• Linhas da Rede: Copiar endereço, Copiar endereço remoto ou Copiar PID, conforme aquilo por que a linha é alcançada. Uma linha com um processo acrescenta Copiar PID, Mostrar no monitor de atividade e Sinal ou prioridade….
• Alertas: Copiar PID, Copiar caminho do programa e Copiar comando, depois Mostrar no monitor de atividade, Retomar, Terminar e Permitir.
• Itens de arranque: Copiar caminho, Copiar caminho do programa e Copiar comando, depois Mostrar no painel, Ver e Editar.

As cópias chegam à área de transferência tal como as de Ctrl-Insert, e a linha de avisos mostra o que foi copiado. Uma entrada atua apenas sobre o item que o menu indica. Se esse item deixar de estar sob o cursor enquanto o menu está aberto, por exemplo quando a lista de processos volta a ordenar-se, escolher uma entrada não faz nada e pede que abra o menu novamente. Eliminar, Terminar e os sinais continuam a perguntar antes de agir, tal como pelas respetivas teclas.

Saltar para pastas

Escreva cd na linha de comandos e o Borg mostra, logo acima dela, as pastas para onde pode saltar: primeiro as favoritas, marcadas com ★, depois as pastas que os painéis abriram, das mais recentes para as mais antigas. Cada palavra que acrescenta restringe a lista e pode corresponder a qualquer parte do caminho tal como a lista o mostra, por isso cd pro bo encontra ~/Projects/borg. A pasta pessoal aparece como ~, por isso uma palavra do caminho dela, como me em /home/me, não corresponde a nenhuma pasta lá dentro. Uma palavra que comece por / corresponde ao caminho completo. As pastas cujo nome corresponde à última palavra ficam em primeiro lugar, junto à linha de comandos. Prima Up para entrar na lista. Enquanto a lista está visível, Up e Down só se movem nela e param nas duas pontas, por isso o cursor do painel mantém a posição. Enter abre a pasta escolhida no painel ativo. Tab coloca-a na linha de comandos a seguir a cd sem executar o comando, com escapes nos espaços e noutros caracteres que a shell dividiria ou expandiria, e a lista passa para as pastas que ela contém. Um clique numa pasta também a abre. Para executar o seu próprio cd, continue a escrever e prima Enter.

Escreva um caminho e a lista começa pelas pastas que ele contém. cd /Volumes mostra os volumes montados, e cd ~/Projects/bo restringe a lista às pastas de ~/Projects com bo no nome, primeiro as que começam por essas letras. Qualquer outro comando mostra a mesma lista para um caminho com /, como cp notes.txt ~/Documents/. Aí, Tab ou Enter escreve o nome da pasta escolhida no caminho, com escapes ou dentro das suas aspas, como a shell precisa, e a lista passa para as pastas que ela contém. Esc oculta a lista e devolve Up e Down ao painel. A lista volta quando começa outra palavra ou apaga a que está a escrever, e Esc logo a seguir a um espaço oculta-a apenas até voltar a escrever. As pastas ocultas aparecem quando escreve um ponto, ou quando os painéis mostram ficheiros ocultos. O Borg lê até 10 000 subpastas de uma pasta, e só na linha de comandos desta máquina; a consola de um contentor ou de uma máquina remota mantém a conclusão da própria shell.

Uma linha de comandos que apenas muda de pasta é executada sem que os painéis saiam do ecrã, e o painel ativo acompanha a shell até à nova pasta. Quando a pasta não existe, um aviso indica-o e Ctrl-O mostra a mensagem da shell. Uma pasta que demora a abrir, como uma numa partilha de rede lenta, faz aparecer a consola até o comando terminar. Tudo o que vá além de um cd, como cd src && make, mostra a consola como habitualmente.

Ctrl-\ ou Comando → Pastas favoritas abre as favoritas com a pasta do painel ativo escolhida. Escreva para restringir a lista, escolha com Up e Down e prima Enter para abrir a pasta. Insert fixa a pasta escolhida nas favoritas, por isso Ctrl-\ seguido de Insert fixa a pasta onde está. F8 ou Delete retira uma pasta das favoritas ou das pastas recentes. Esc limpa o que escreveu e um segundo Esc fecha a janela. As favoritas guardam até 256 pastas.

Alt-O ou Comando → Mesma pasta no outro painel abre a pasta do painel ativo no outro painel, para que ambos mostrem o mesmo sítio. A pasta ocupa o lugar da pré-visualização, das Informações ou dos ficheiros de um contentor ou de uma máquina remota nesse painel. Se o outro painel mostrava resultados de pesquisa ou uma coleção, Alt-Shift-R nesse painel volta a mostrá-los. Nos resultados de pesquisa e nas coleções, Alt-O abre a pasta do ficheiro sob o cursor, com o cursor no ficheiro, tal como Revelar original. Enquanto uma pesquisa não encontra nada, Alt-O abre a pasta onde ela começou. As pastas de contentores e as remotas só abrem num painel, por isso nesses casos Alt-O mostra uma notificação, tal como acontece numa coleção vazia e quando o outro painel tem um editor. Enquanto escreve um comando, Alt-O passa para a shell.

As favoritas ficam guardadas em config.toml, na secção [folders]. O Borg lembra-se das últimas 64 pastas que os painéis abriram, na sua pasta de estado, num ficheiro que só o utilizador pode ler. Defina history = false em [folders] para deixar de as guardar.