NANO(1) General Commands Manual NANO(1) NOME nano - Nano's ANOther, editor de texto inspirado no Pico SINOPSE nano [opcoes] [[+linha[,coluna]] arquivo]... nano [opcoes] [[+[crCR]{/|?}string] arquivo]... NOTICES Since version 9.0, all lines are scrolled horizontally together (when the cursor approaches the edge), by just the amount needed, instead of scrolling only the current line by a large step. If you prefer the old behavior, you can use --solo on the command line or set solosidescroll in your nanorc. Also since version 9.0, keystrokes M-< and M-> have been reassigned to the `scrollleft` and `scrollright` functions. If you want those keystrokes to do what they did before version 9.0, add these two lines at the end of your nanorc file: bind M-< prevbuf main bind M-> nextbuf main Since version 8.0, to be newcomer friendly, ^F starts a forward search, ^B starts a backward search, M-F searches the next occurrence forward, and M-B searches the next occurrence backward. If you want those keystrokes to do what they did before version 8.0, add the following four lines at the end of your nanorc file: bind ^F forward main bind ^B back main bind M-F formatter main bind M-B linter main DESCRICAO nano e um editor de texto pequeno e amigavel. Ele copia a aparencia do Pico, mas e um software livre e implementa varios recursos que faltam no Pico, tais como: abrir varios arquivos, rolagem por linha, desfazer/refazer, coloracao de sintaxe, numeracao de linha e quebra automatica de linhas longas. Ao fornecer um nome de arquivo na linha de comando, o cursor pode ser colocado em uma linha especifica adicionando o numero da linha com um sinal de mais (+) antes do nome do arquivo, e ate mesmo em uma coluna especifica adicionando-o com uma virgula. Os numeros negativos contam a partir do final do arquivo ou linha. O cursor pode ser colocado na primeira ou na ultima ocorrencia de uma string especifica, especificando essa string apos +/ ou +? antes do nome do arquivo. A string pode ser diferenciada entre maiusculas e minusculas e/ou interpretada como uma expressao regular inserindo c e/ou r apos o sinal +. Esses modos de pesquisa podem ser desabilitados explicitamente usando a variante em maiusculas dessas letras: C e/ou R. Quando a string contem espacos, ela precisa ser colocada entre aspas. Para dar um exemplo: para abrir um arquivo na primeira ocorrencia da palavra "Foo", faria-se: nano +c/Foo arquivo Como um caso especial: se em vez de um nome de arquivo um travessao (-) for fornecido, nano lera os dados da entrada padrao. EDICAO Inserir texto e mover-se em um arquivo e simples: digitar as letras e usar as teclas normais de movimento do cursor. Os comandos sao inseridos usando as teclas Control (^) e Alt ou Meta (M-). Digitar ^K exclui a linha atual e a coloca no buffer-de-transferencia. ^Ks consecutivos colocam todas as linhas excluidas juntas no buffer-de-transferencia. Qualquer movimento do cursor ou execucao de qualquer outro comando fara com que o proximo ^K sobrescreva o buffer-de-transferencia. A ^U cola o conteudo atual do buffer-de-transferencia na posicao atual do cursor. Quando um trecho de texto mais preciso precisa ser recortado ou copiado, pode-se marcar seu inicio com ^6, mover o cursor ate o final (o texto marcado e destacado) e, em seguida, usar ^K para corta-lo ou M-6 para copia-lo para o buffer-de-transferencia. Tambem e possivel salvar o texto marcado em um arquivo com ^O, ou verificar a ortografia com ^T^T. Em alguns terminais, o texto tambem pode ser selecionado mantendo pressionada a tecla Shift enquanto usa as teclas de seta. Manter a tecla Ctrl ou Alt pressionada tambem aumenta o passo. Qualquer movimento do cursor sem a tecla Shift pressionada cancela essa selecao. Qualquer ponto de codigo Unicode valido pode ser inserido no buffer digitando M-V seguido pelos digitos hexadecimais do ponto de codigo (concluido com ou quando tiver menos de seis digitos). Um codigo de controle literal (exceto ^J) pode ser inserido digitando M-V seguido pelo pressionamento de tecla pertinente. As duas linhas na parte inferior da tela mostram alguns comandos importantes; a ajuda embutida (^G) lista todos os disponiveis. As combinacoes de teclas padrao podem ser alteradas por meio de um arquivo nanorc -- veja nanorc(5). OPCOES -A, --smarthome Torna a tecla Home mais inteligente. Quando Home e pressionada em qualquer lugar, exceto no inicio de caracteres que nao sejam de espaco em branco em uma linha, o cursor pula para aquele inicio (para frente ou para tras). Se o cursor ja estiver nessa posicao, ele salta para o verdadeiro inicio da linha. -B, --backup Ao salvar um arquivo, faz uma copia reserva da versao anterior dele, usando o nome do arquivo atual com o sufixo um til (~). -C diretorio, --backupdir=diretorio Faz e mantem nao apenas um arquivo reserva, mas faz e mantem um com numeracao unica sempre que um arquivo e salvo -- quando os backups estiverem habilitados (-B). Os arquivos numerados exclusivamente sao armazenados no diretorio especificado. -D, --boldtext Para a interface, usa negrito em vez de video reverso. Isso pode ser sobrescrito ao definir as opcoes titlecolor, statuscolor, promptcolor, minicolor, keycolor, numbercolor e/ou selectedcolor em seu arquivo nanorc. Veja nanorc(5). -E, --tabstospaces Converte cada tabulacao digitada para espacos -- para o numero de espacos que uma tabulacao naquela posicao ocuparia. (Observacao: tabulacoes coladas nao sao convertidas.) -F, --multibuffer Le um arquivo em um novo buffer por padrao. -G, --locking Usa trava de arquivos no estilo vim ao editar arquivos. -H, --historylog Salva as ultimas cem strings de pesquisa e strings de substituicao e comandos executados, para que possam ser facilmente reutilizados em sessoes posteriores. -I, --ignorercfiles Nao procura no nanorc do sistema nem no nanorc do usuario. -J numero, --guidestripe=numero Desenha uma faixa vertical na coluna fornecida para ajudar a avaliar a largura do texto. (A cor da faixa pode ser alterada com set stripecolor em seu arquivo nanorc.) -K, --rawsequences Interpreta sequencias de escape diretamente, em vez de pedir a ncurses para traduzi-las. (Se voce precisa dessa opcao para fazer algumas teclas funcionarem corretamente, isso significa que a descricao do terminal terminfo que e usada nao corresponde totalmente ao comportamento real do seu terminal. Isso pode acontecer quando voce faz ssh em uma maquina BSD, por exemplo.) Usar essa opcao desabilita o suporte a mouse do nano. -L, --nonewlines Nao adiciona automaticamente uma nova linha quando o texto nao terminar com uma. (Isso pode fazer com que voce salve arquivos de texto nao POSIX.) -M, --trimblanks Recorta o espaco em branco a direita da linha quebrada quando ocorrer a quebra automatica ou quando o texto for justificado. -N, --noconvert Desabilita a conversao automatica de arquivos do formato DOS/Mac. -O, --bookstyle Ao justificar, trata qualquer linha que comece com um espaco em branco como o inicio de um paragrafo (a menos que o recuo automatico esteja ativado). -P, --positionlog Para os 200 arquivos mais recentes, registra a ultima posicao do cursor e coloque-o nessa posicao novamente ao reabrir o arquivo. Tambem salva e restaura as posicoes de quaisquer ancoras. -Q "regex", --quotestr="regex" Define a expressao regular para corresponder a parte de citacao de uma linha. O valor padrao e "^([ \t]*([!#%:;>|}]|//))+". (Observa que \t representa uma tabulacao real.) Isso torna possivel reajustar blocos de texto citado ao redigir e-mail e embrulhar blocos de comentarios de linha ao escrever o codigo-fonte. -R, --restricted Modo restrito: nao le ou escreve em nenhum arquivo nao especificado na linha de comando. Isso significa: nao le ou escreve arquivos de historico; nao permite suspensao; nao permite verificacao ortografica; nao permite que um arquivo seja anexado ao final, anexado no inicio ou salvo com um nome diferente se ja houver um; e nao faz uma copia de arquivos. O modo restrito tambem pode ser ativado invocando nano com qualquer nome comecando com "r" (por exemplo, "rnano"). -S, --softwrap Exibe em varias linhas de tela, linhas que excedem a largura da tela. (Voce pode fazer com que essa quebra automatica ocorra em espacos em branco em vez de rudemente na borda da tela, usando tambem --atblanks.) -T numero, --tabsize=numero Define o tamanho (largura) de um tab para numero colunas. O valor de numero deve ser maior que 0. O valor padrao e 8. -U, --quickblank Faz com que as mensagens da barra de status desaparecam apos 1 pressionamento de tecla em vez de apos 20. Observe que as opcoes -c (--constantshow) substituem isso. Quando a opcao --minibar ou --zero esta em vigor, --quickblank faz uma mensagem desaparecer apos 0,8 segundos em vez do padrao de 1,5 segundos. -V, --version Mostra o numero da versao atual e sai. -W, --wordbounds Detecta os limites das palavras de maneira diferente, tratando os caracteres de pontuacao como parte de uma palavra. -X "caracteres", --wordchars="caracteres" Especifica quais outros caracteres (alem dos alfanumericos normais) devem ser considerados como parte de uma palavra. Ao usar esta opcao, voce provavelmente deseja omitir -W (--wordbounds). -Y nome, --syntax=nome Especifica o nome do realce de sintaxe a usar entre os definidos nos arquivos nanorc. -Z, --zap Deixa um Backspace ou Delete nao modificado apagar a regiao marcada (ao inves de um unico caractere, e sem afetar o buffer-de-transferencia). -a, --atblanks Ao fazer quebra de linha suave, quebra as linhas nos espacos em branco em vez de sempre na borda da tela. -b, --breaklonglines Nao aplica automaticamente a quebra rigida na linha atual quando ela se tornar muito longa, ou seja: quando ela se tornar mais longa que o valor fornecido com -r (--fill). O padrao para -r e a largura do terminal menos oito. (Esta opcao e o oposto de -w (--nowrap) -- o ultimo dado entra em vigor.) -c, --constantshow Mostra constantemente a posicao do cursor na barra de status. Observe que esta opcao substitui -U (--quickblank). -d, --rebinddelete Interpreta as teclas Delete e Backspace de maneira diferente para que Backspace e Delete funcionem corretamente. Voce so deve usar esta opcao quando em seu sistema o Backspace atua como Delete ou Delete atua como Backspace. -e, --emptyline Nao usa a linha abaixo da barra de titulo, deixando-a totalmente em branco. -f arquivo, --rcfile=arquivo Le apenas este arquivo para definir as opcoes do nano, em vez de ler os arquivos do nanorc do sistema e do usuario. -g, --showcursor Torna o cursor visivel no navegador de arquivos (colocando-o no item destacado) e no visualizador de ajuda. Util para usuarios de braille e pessoas com visao deficiente. -h, --help Mostra um resumo das opcoes de linha de comando disponiveis e sai. -i, --autoindent Recua automaticamente uma linha recem-criada com o mesmo numero de tabulacoes e/ou espacos que a linha anterior (ou como a proxima linha se a linha anterior for o inicio de um paragrafo). -j, --jumpyscrolling Rola o conteudo do buffer por meia tela em vez de por linha. -k, --cutfromcursor Faz o comando "Recort txt" (normalmente ^K) cortar da posicao atual do cursor ate o final da linha, em vez de cortar a linha inteira. -l, --linenumbers Exibe os numeros das linhas a esquerda da area de texto. (Qualquer linha com uma ancora tambem recebe uma marca na margem.) -m, --mouse Habilita o suporte ao mouse, se disponivel para o seu sistema. Quando habilitado, os cliques do mouse podem ser usados para posicionar o cursor, definir a marca (com um clique duplo) e executar atalhos. O mouse funciona no X Window System e no console quando o gpm estiver em execucao. O texto ainda pode ser selecionado arrastando, mantendo pressionada a tecla Shift. -n, --noread Trata qualquer nome fornecido na linha de comando como um novo arquivo. Isso permite que nano grave em encadeamentos nomeados: ele comeca com um buffer em branco e grava no pipe quando o usuario salvar o "arquivo". Desta forma, nano pode ser usado como um editor em combinacao com, por exemplo, gpg sem ter que gravar dados confidenciais no disco primeiro. -o diretorio, --operatingdir=diretorio Altera o diretorio fornecido, e permite ler e escrever arquivos soemnte neste diretorio e em seus subdiretorios. -p, --preserve Preserva as sequencias XOFF e XON (^S e ^Q) para que sejam capturadas pelo terminal. (parando e retomando a saida). Note que a opcao -/ (--modernbindings) substitui isso. -q, --indicator Exibe uma "barra de rolagem" no lado direito da janela de edicao. Mostra a posicao da janela de visualizacao no buffer e quanto do buffer e coberto pela janela de visualizacao. -r numero, --fill=numero Define a largura alvo para justificar e empacotamento automatico neste numero de colunas. Se o valor for 0 ou menos, a quebra ocorre na largura da tela menos numero colunas, permitindo que o ponto de quebra varie junto com a largura da tela se a tela for redimensionada. O valor padrao e -8. -s "programa [argumento ...]", --speller="programa [argumento ...]" Usa este comando para realizar a verificacao ortografica e correcao, em vez de usar o corretor integrado que chama hunspell(1) ou spell(1). -t, --saveonexit Salva um buffer alterado sem perguntar (ao sair com ^X). -u, --unix Salva um arquivo por padrao no formato Unix. Isso substitui o comportamento padrao do nano de salvar um arquivo no formato que ele tinha. (Esta opcao nao tem efeito quando voce tambem usa --noconvert.) -v, --view Basta visualizar o arquivo e proibir a edicao: modo somente leitura. Este modo permite ao usuario abrir tambem outros arquivos para visualizacao, a menos que --restricted tambem seja fornecido. -w, --nowrap Nao aplica automaticamente a quebra rigida na linha atual quando ela se tornar muito longa. Este e o padrao. (Esta opcao e o oposto de -b (--breaklonglines) -- o ultimo dado entra em vigor.) -x, --nohelp Nao mostra as duas linhas de ajuda na parte inferior da tela. -y, --afterends Faz com que Ctrl+Right e Ctrl+Delete parem no final das palavras em vez de no inicio. -z, --listsyntaxes Lista os nomes das sintaxes disponivel e sai. -!, --magic Quando nem o nome do arquivo nem sua primeira linha fornecem uma pista, tente usar libmagic para determinar a sintaxe aplicavel. -@, --colonparsing Quando um nome de arquivo fornecido na linha de comando termina em dois pontos mais digitos e esse nome de arquivo nao existe, entao corta os dois pontos mais digitos e entende os digitos como um numero de linha. Se o nome de arquivo aparado tambem nao existir, entao repite o processo e entenda os dois numeros obtidos como numero de linha e coluna. Mas se o nome de arquivo duplamente aparado tambem nao existir, entao esquece o corte e aceita o nome de arquivo original como esta. Para desabilitar essa analise de dois pontos para algum arquivo, use +1 ou similar antes do nome de arquivo relevante. -%, --stateflags Usa o canto superior direito da tela para mostrar alguns sinalizadores de estado: I ao recuar automaticamente, M quando a marca esta ativada, L ao aplica quebra rigida (quebrando linhas longas), R ao gravar uma macro e S ao aplicar quebra suave. Quando o buffer e modificado, um asterisco (*) e mostrado apos o nome do arquivo no centro da barra de titulo. -_, --minibar Suprime a barra de titulo e, em vez disso, mostre informacoes sobre o buffer atual na parte inferior da tela, no espaco da barra de status. Nesta "mini barra", o nome do arquivo e mostrado a esquerda, seguido por um asterisco se o buffer foi modificado. A direita sao exibidos a linha atual e o numero da coluna, o codigo do caractere sob o cursor (no formato Unicode: U+xxxx), os mesmos sinalizadores mostrados por --stateflags e uma porcentagem que expressa como ate onde o cursor esta dentro do arquivo (linha a linha). Quando um arquivo e carregado ou salvo, e tambem ao alternar entre buffers, o numero de linhas no buffer e exibido apos o nome do arquivo. Esse numero e apagado na proxima tecla ou substituido por um contador [i/n] quando varios buffers estao abertos. A linha mais os numeros das colunas e o codigo do caractere sao exibidos apenas quando --constantshow e usado e podem ser ativados e desativados com M-C. Os sinalizadores de estado sao exibidos apenas quando --stateflags e usado. -0, --zero Oculta todos os elementos da interface (barra de titulo, barra de status e linhas de ajuda) e usa todas as linhas do terminal para mostrar o conteudo do buffer. A barra de status aparece somente quando ha uma mensagem significativa e desaparece apos 1,5 segundos ou na proxima tecla pressionada. Com M-Z a barra de titulo mais a barra de status podem ser alternadas. Com M-X as linhas de ajuda. -1, --solosidescroll When the cursor approaches the right edge of the edit window, scroll only the current line sideways by a large amount, instead of scrolling all visible lines sideways by just the amount needed to keep the cursor in view. This latter whole-window smooth sideways scrolling is the new default behavior. The single-line jerky sideways scrolling enabled by this option was the old behavior -- the only behavior that nano knew. -/, --modernbindings Use key bindings similar to the ones that most modern programs use: ^X cuts, ^C copies, ^V pastes, ^Z undoes, ^Y redoes, ^F searches forward, ^G searches next, ^S saves, ^O opens a file, ^Q quits, and (when the terminal permits) ^H shows help. Furthermore, ^A sets the mark, ^B searches backward, ^D searches previous, ^R makes replacements, ^P shows the position, ^T goes to a line, ^W writes out a file, and ^E executes a command. Note that this option overrides option -p (--preserve). ALTERNADORES Varias das opcoes acima tambem podem ser ativadas e desativadas enquanto o nano esta em execucao. Por exemplo, M-L alterna a quebra rigida de linhas longas, M-S alterna a quebra suave, M-N alterna os numeros das linhas, M-M alterna o mouse, M-I recuo automatico e M-X as linhas de ajuda. Veja no final do texto de ajuda ^G uma lista completa. O botao de alternancia M-X e especial: ele funciona em todos os menus, exceto no visualizador de ajuda e no linter. Todos os outros botoes de alternancia funcionam apenas no menu principal. ARQUIVOS Quando --rcfile e fornecido, nano le apenas o arquivo especificado para definir suas opcoes, sintaxes e associacoes de teclas. Sem essa opcao, nano le dois arquivos de configuracao: primeiro o nanorc do sistema (se existir) e, em seguida, o nanorc do usuario (se existir), ~/.nanorc ou $XDG_CONFIG_HOME/nano/nanorc ou ~/.config/nano/nanorc, o que for encontrado primeiro. Veja nanorc(5) para obter mais informacoes sobre os possiveis conteudos desses arquivos. Veja /usr/share/nano/ e /usr/share/nano/extra/ para obter as definicoes de cores de sintaxe disponiveis. STATUS DE SAIDA 0 O editor foi finalizado normalmente. 1 Uma opcao invalida ou argumento invalido foi fornecido. 2 O ultimo buffer aberto foi descartado (com ^O^Q ou ^X^Q). NOTAS A suspensao e habilitada por padrao, acessivel via ^T^Z. (Se voce quiser um ^Z simples para suspender o nano, adicione bind ^Z suspend main ao seu nanorc.) Em um prompt Sim-Nao, ^Y pode ser usado para "Yes" (Sim), ^N para "No" (Nao) e ^A para "All" (Todos). (e ao sair, ^Q podem ser usados para "Sair com erro".) Essas ligacoes nao listadas funcionam em qualquer localidade. Quando voce quiser copiar o texto marcado de nano para a area de transferencia do sistema, veja um dos exemplos na pagina do manual nanorc(5). Se nenhum comando de verificacao ortografica alternativo for especificado na linha de comando nem em um dos arquivos nanorc, nano verifica a variavel de ambiente SPELL para encontrar um. Em alguns casos, o nano tenta despejar o buffer em um arquivo de emergencia. Isso vai acontecer principalmente se nano receber um SIGHUP ou SIGTERM ou ficar sem memoria. Ele escreve o buffer em um arquivo chamado nano.save se o buffer ainda nao tiver um nome, ou adiciona um sufixo ".save" ao nome do arquivo atual. Se um arquivo de emergencia com esse nome ja existir no diretorio atual, ele adiciona ".save" mais um numero (por exemplo, ".save.1") ao nome do arquivo atual para torna-lo unico. No modo multibuffer, nano escreve todos os buffers abertos em seus respectivos arquivos de emergencia. Se voce tiver alguma duvida sobre como usar nano em alguma situacao especifica, voce pode perguntar em help-nano@gnu.org. BUGS A escrita e reproducao de macros de teclado funcionam corretamente apenas em um emulador de terminal, nao em um console Linux (VT), porque o ultimo nao distingue por padrao as teclas de seta modificadas das nao modificadas. Relate quaisquer outros bugs que voce venha a encontrar via: https://savannah.gnu.org/bugs/?group=nano. Quando o nano trava, ele salva todos os buffers modificados em arquivos .save de emergencia. Se voce consegue reproduzir a falha e deseja obter um backtrace, defina a variavel de ambiente NANO_NOCATCH. SITE https://nano-editor.org/ VEJA TAMBEM nanorc(5) /usr/share/doc/nano/ (ou equivalente em seu sistema) TRADUCAO A traducao para portugues brasileiro desta pagina man foi criada por Rafael Fontenelle Esta traducao e uma documentacao livre; leia a Licenca Publica Geral GNU Versao 3 ou posterior para as condicoes de direitos autorais. Nenhuma responsabilidade e aceita. Se voce encontrar algum erro na traducao desta pagina de manual, envie um e-mail para a lista de discussao de tradutores . April 2026 version 9.0 NANO(1)