Wiki / Editor embutido

Editor embutido

Um editor estilo Vim dentro do lightyear, com cores, erros do compilador e autocomplete.

Canary: o editor está na série v1.3.0-canary. Instale a canary para usar (veja Instalação).

O lightyear tem um editor de código próprio, com edição modal como no Vim, realce de sintaxe (Tree-sitter) e os erros e o autocomplete de um language server. Ele aparece em três lugares:

lightyear edit main.c
lightyear edit ft_split.c libft.h    # vários arquivos, em buffers
lightyear edit --plain notas.txt     # editor sem modos

O mouse funciona: clique para posicionar o cursor, arraste para selecionar, role com a roda.

Modos

Modo Como entrar Para quê
NORMAL esc mover, apagar, copiar, rodar comandos
INSERT i a o I A O digitar texto
VISUAL v (caracteres), V (linhas), ou arrastando o mouse selecionar

Com --plain, não há modos: o editor funciona como um editor comum, com Ctrl-S salvar, Ctrl-Z/Ctrl-Y desfazer/refazer e Ctrl-Q sair.

Teclas do modo NORMAL

Movimentos

Tecla Movimento
h j k l esquerda, baixo, cima, direita
w b e próxima palavra, palavra anterior, fim da palavra
0 ^ $ início da linha, primeiro caractere não branco, fim da linha
W B E o mesmo para WORDs (tudo que não é espaço: a.b é uma WORD só)
ge gE fim da palavra (ou WORD) anterior
0 Home início da linha
$ End fim da linha
g_ último caractere não branco
N\| coluna N (4\|)
+ Enter - primeiro não branco da linha de baixo / de cima
gg G início e fim do arquivo; com número, vão à linha N (42G)
Ctrl-Home Ctrl-End início e fim do arquivo
{ } parágrafo anterior / próximo (a linha vazia antes ou depois)
% o par do ( [ { sob o cursor ou adiante na linha; 50% vai à metade do arquivo
H M L topo, meio e fim da tela
f F t T + caractere até o caractere na linha; ; repete, , repete ao contrário
ma … `a 'a marca a posição em a (de a a z); ` volta ao lugar exato, ' à linha (também com operador: d'a)

Rolar a tela

Tecla Ação
Ctrl-d Ctrl-u meia tela para baixo / para cima (o cursor vai junto)
Ctrl-f Ctrl-b, PgDn PgUp uma tela para baixo / para cima
Ctrl-e Ctrl-y uma linha, sem mover o cursor (só se ele sair da tela)
zz zt zb põe a linha do cursor no meio, no topo ou embaixo da tela

Contadores multiplicam: 3j, 10l, 2fa.

Editar

Tecla Ação
x X apaga o caractere sob o cursor / antes dele
s S troca o caractere / a linha inteira (entra no INSERT)
r + caractere substitui o caractere (3rx substitui três)
~ troca maiúscula e minúscula e anda (5~)
J gJ junta a linha de baixo (J com um espaço, gJ como está; 3J junta três)
>> << indenta / desindenta a linha com um tab (>j, >}, 3>>)
gU gu g~ + movimento maiúsculas, minúsculas, troca (gUw, guiw); gUU guu g~~ na linha
Ctrl-a Ctrl-x soma / subtrai do número sob o cursor ou adiante (5 Ctrl-a)
d + movimento apaga (dw, d$, dG, dt;); dd apaga a linha, D até o fim
c + movimento muda: apaga e entra no INSERT (cw, cb); cc muda a linha mantendo a indentação, C até o fim
y + movimento copia (yw, y$); yy e Y copiam a linha
p P cola depois / antes; o que d, x, c e D apagam também fica para colar (ddp troca duas linhas)
u Ctrl-r desfaz / refaz; uma sessão inteira de INSERT desfaz com um u
. repete a última mudança (dw., 3.)

Contadores valem com operadores: 3dd, 2d3w, 3x, 2u.

Text objects

Depois de d, c, y ou no VISUAL: iw aw (palavra), i" a" (e as outras aspas), i( a( ib, i{ a{ iB, i[ a[, i< a<. Exemplos: diw, ci", da(, yi{, viw. O di{ mantém as chaves nas linhas delas.

Busca

Tecla Ação
/texto ?texto busca para frente / para trás
n N próxima / anterior
* # a palavra sob o cursor, para frente / para trás
:noh apaga os destaques

A busca é por texto literal, não por expressão regular.

Macros

qa começa a gravar na macro a (a barra mostra “gravando @a”), q para, @a toca, @@ repete e 5@a toca cinco vezes. Vale qualquer letra de a a z.

VISUAL

Com a seleção feita: d ou x apagam, y copia, c ou s mudam, p troca pelo que foi copiado e o troca a ponta da seleção. U, u e ~ passam para maiúsculas, minúsculas ou trocam; > e < indentam as linhas; J junta as linhas selecionadas. Movimentos e contadores estendem a seleção (vjd, V3jd, v}d).

INSERT

Além de digitar: setas, Home End, Ctrl-Home Ctrl-End e PgUp PgDn movem o cursor; Ctrl-← Ctrl-→ andam uma palavra; Ctrl-w apaga a palavra antes do cursor e Ctrl-u apaga o que foi digitado na linha (até a indentação).

Comandos

Comando Ação
:w salva
:q fecha (avisa se há alterações não salvas)
:q! sai sem salvar
:wq, :x, ZZ salva e sai
ZQ sai sem salvar
:wa salva todos os arquivos
:wqa, :xa salva todos e sai
Ctrl-S, Ctrl-Q também salvam e saem

Arquivos só leitura (como o subject na aba Exam) recusam edição com E21: arquivo só leitura.

Buffers e janelas

Cada arquivo aberto é um buffer:

Comando Ação
:e arquivo abre outro arquivo
:bn :bp próximo / anterior
:b 2 vai ao buffer 2
:ls lista os buffers
:bd fecha o buffer

Copiar, colar, macros e busca valem entre os arquivos.

Janelas mostram buffers lado a lado:

Comando Ação
:vsp arquivo, Ctrl-w v divide na vertical (lado a lado)
:sp arquivo divide na horizontal (empilhadas)
Ctrl-w w, Ctrl-w h/j/k/l troca de janela (o clique também)
:close, :q fecha a janela
:only fecha as outras
Ctrl-w > < + - aumenta / diminui (aceita contador: 10 Ctrl-w >)
Ctrl-w = iguala os tamanhos
Ctrl-w \| maximiza a largura
:vertical resize 50, :resize N tamanho exato

Também dá para arrastar a borda │ entre janelas lado a lado, ou a linha de título nas empilhadas.

Terminal

:term abre um terminal embaixo do código, rodando o seu shell na pasta do arquivo. Dá para compilar, rodar a norminette ou os testes sem sair do editor. :term make (ou qualquer comando) roda só aquele comando.

Tecla Ação
:term, :terminal abre o terminal (com ele aberto, só volta para ele)
:term comando roda um comando no terminal (:term make re, :term norminette)
Ctrl-\ Ctrl-n volta ao código (como no Vim)
Ctrl-w k também volta ao código; Ctrl-w j desce para o terminal
clique no terminal ou no código, troca o foco

Com o terminal em foco, as teclas vão para o programa, até Ctrl-c, as setas e o Tab. A barra de status mostra TERMINAL. Quando o shell (ou o comando) termina, o título avisa o código de saída e qualquer tecla fecha o painel. Fechar o editor encerra o que estiver rodando.

Atenção: o terminal precisa de Linux ou macOS; no Windows, use o WSL.

Language server

Com um language server, o editor mostra os erros enquanto você digita, completa nomes e navega pelo código.

Linguagem Servidor
C, C++ clangd
Go gopls
Python pyright, pylsp ou ty (o primeiro que encontrar)
Rust rust-analyzer

Sem um compile_commands.json, o clangd usa as flags dos graders da 42: -Wall -Wextra -Werror (e -std=c++98 em C++). A barra de status mostra qual servidor está rodando. Se nenhum estiver instalado, o editor avisa como instalar.

Downloads automáticos

Nas máquinas da 42 não dá para usar sudo, então o lightyear baixa sozinho o que falta, só uma vez, conferindo o sha256:

Com o servidor instalado no sistema, nada é baixado.

O que o language server faz

Tecla Ação
mouse sobre um erro mostra a mensagem inteira do compilador, com as notas
K assinatura e documentação do que está sob o cursor, e os erros da linha
gd vai à definição (em outro arquivo, abre um buffer; Ctrl-o volta)
]d [d próximo / anterior erro
grn, :Rename nome renomeia no projeto inteiro
grr lista as referências
gra mostra as correções sugeridas (o ; que falta, o #include…)
:Format formata o arquivo

Os erros aparecem sublinhados, com um ● na margem e a contagem na barra de status (✖ 2 ⚠ 1). Quando o erro tem correção (“fix available”), passe o mouse e clique na caixa ▸ clique aqui para corrigir: com uma correção só, ela é aplicada na hora; com várias, aparece a lista.

Os arquivos alterados por grn ou gra abrem em buffers, para você conferir e salvar com :wa.

Atenção: em C e C++, o :Format só funciona com um .clang-format no projeto. O estilo padrão do clang-format quebraria a norminette.

Autocomplete

No INSERT, a lista abre sozinha enquanto você digita (e depois de ., -> e ::), filtrando pelo que já foi digitado. Ctrl-n abre na hora; Ctrl-n e Ctrl-p (ou as setas) escolhem; Tab ou Enter aceitam; esc fecha.

Temas

:colorscheme            lista os temas
:colorscheme dracula    troca o tema

Temas: lightyear (padrão), gruvbox, dracula, nord, tokyonight, monokai, catppuccin, onedark, solarized, github-light (para terminal claro) e off (sem cores).

Tab completa o nome (:colorscheme d + Tab); Tab e Shift-Tab andam pelas opções. A escolha fica salva no config.yaml e vale em todos os lugares onde o editor aparece.

Limites conhecidos

Editar esta página no GitHub