Pular para conteúdo

Primeiros passos

Um passeio rápido pela interface e pelo básico do trabalho com arquivos.

Requisitos de sistema

Plataforma Pacote Versão mínima
macOS Apple Silicon (arm64) macOS 14.4 Sonoma
Windows x64 Windows 10, versão 1809 (build 17763)

As compilações para macOS são apenas para Apple Silicon — todo Mac com um chip da série M é compatível. Macs com Intel não são atendidos.

No Windows, o OctoEdit também exige o Microsoft Visual C++ 2015–2022 Redistributable (x64) — na maioria dos sistemas ele já está instalado.

Qual download do macOS escolher

Para o macOS são publicados dois pacotes, que se diferenciam em uma única coisa: a visualização de HTML.

Download O que você recebe
OctoEdit com a visualização de HTML O editor completo, incluindo a visualização ao vivo de documentos HTML e PHP renderizados por um mecanismo de navegador de verdade. Um download consideravelmente maior.
OctoEdit O mesmo editor sem essa visualização e sem o mecanismo de navegador por trás dela.

Todo o resto é idêntico. Não há nada a acrescentar a um pacote depois de instalá-lo, então escolha logo o que você quer; se mudar de ideia, basta baixar o outro pacote e substituir o aplicativo: suas preferências e a sessão salva ficam fora dele e são preservadas.

Abrindo arquivos

Use Arquivo ▸ Abrir, arraste um arquivo para a janela ou passe caminhos na linha de comando. Cada arquivo abre em sua própria aba.

Arrastar e soltar e o modo administrador (Windows)

O Windows recusa que itens sejam soltos do Explorador em um programa executado com privilégios elevados (como administrador): o cursor mostra o sinal de "proibido" e nada é aberto. Essa é uma regra de segurança do sistema operacional, não algo que o editor possa contornar — execute o OctoEdit normalmente e arrastar e soltar funciona.

A interface

  • Barra de abas — uma aba por documento aberto; arraste para reordenar ou para mover uma aba para outro grupo dividido.
  • Área do editor — a superfície de edição baseada em Scintilla, com coloração de sintaxe, dobra de código e (opcionalmente) um minimapa.
  • Barra de status — informações passageiras, como a posição do cursor e notificações breves.
  • Painéis acopláveis — painéis laterais fornecidos por recursos e plugins (por exemplo, Estatísticas do documento).

Editando

O menu Editar reúne os comandos habituais da área de transferência: Recortar (Ctrl+X), Copiar (Ctrl+C), Colar (Ctrl+V) e Selecionar tudo (Ctrl+A).

Colar como Markdown (Ctrl+Shift+V, ⇧⌘V no macOS; também no menu de contexto do editor) serve para texto copiado de uma fonte formatada — uma mensagem de chat, um documento de processador de texto, uma página da web. Uma cópia assim carrega duas versões: o texto simples, em que uma lista com marcadores perdeu os marcadores e o aninhamento, e a versão formatada. Colar insere o texto simples. Colar como Markdown lê a versão formatada no lugar dele e a insere como Markdown: listas aninhadas com - e números de verdade, títulos, negrito e itálico, links, tabelas e blocos de código, um item por linha, nada quebrado. Quando a área de transferência contém só texto simples, ele faz exatamente o mesmo que Colar.

Recortar linha (Shift+Delete) é o que vale a pena conhecer:

  • com algo selecionado, ele recorta a seleção, exatamente como Ctrl+X;
  • sem nada selecionado, ele recorta a linha inteira em que o cursor está, incluindo a quebra de linha.

O que vai embora é a linha lógica, não uma linha visual quebrada: uma linha longa exibida em três linhas ainda é uma única linha e é recortada por inteiro. Nos dois casos o texto vai parar na área de transferência, então pode ser colado de volta ou levado para outro lugar, e um único Ctrl+Z desfaz a operação.

Todos esses atalhos podem ser remapeados no Mapeamento de atalhos.

Comandos que precisam de um documento para agir ficam esmaecidos quando não há nenhum. Uma aba que não é um documento de texto — uma comparação, uma visualização de log — deixa os comandos de edição indisponíveis, e o mesmo vale para um documento que só pode ser lido, como um arquivo aberto em modo de monitoramento ou uma janela iniciada com --viewer. Isso vale igualmente para os menus, a paleta de comandos e os atalhos de teclado, de modo que um comando que não faria nada nunca é oferecido como se fosse funcionar.

Salvando

Arquivo ▸ Salvar (Ctrl+S) grava o documento ativo; Salvar como (Ctrl+Alt+S, ⇧⌘S no macOS) permite escolher um novo nome ou local. Salvar tudo (Ctrl+Shift+S, ⌥⌘S no macOS) grava todos os documentos modificados em todos os painéis divididos. Fechar (Ctrl+W) fecha o documento ativo e Fechar tudo (Ctrl+Shift+W, ⇧⌘W no macOS) fecha todas as abas de todos os painéis, perguntando antes sobre as alterações não salvas. Imprimir… imprime o documento ativo (sem atalho padrão — Ctrl+P é Ir para arquivo) — veja Impressão.

Digitando caracteres nacionais no Windows

O Windows informa a tecla Alt direita (AltGr) como Ctrl+Alt. O OctoEdit distingue as duas: o AltGr continua digitando os caracteres do seu layout (ç, ã, €, µ …) mesmo em uma tecla que também carrega um atalho Ctrl+Alt, enquanto a mesma combinação com as teclas Ctrl+Alt esquerdas executa o comando.

Documentos que já têm nome de arquivo são gravados imediatamente; para cada documento que nunca foi salvo, o OctoEdit o traz para a frente e abre uma caixa de diálogo Salvar como, para que você veja o que está nomeando. Cancelar uma dessas caixas pula apenas aquele documento — os demais são salvos assim mesmo. Buffers não salvos também podem ser preservados entre sessões — veja o plugin Sessão.

O salvamento é atômico: o novo conteúdo é gravado ao lado do arquivo e depois ocupa o lugar dele em uma única etapa, de modo que um salvamento interrompido — um disco cheio, um compartilhamento de rede desconectado, uma queda de energia — nunca pode deixar para trás um arquivo escrito pela metade.

Próximos passos