Arquivos, árvore e editor
Como o painel Arquivos, a árvore do workspace, o editor e os diffs se organizam dentro do projeto.
Trabalhar com arquivos no Elyra acontece em três lugares que se completam: o painel Arquivos (a árvore), o editor (o conteúdo) e o diff (o que mudou). Esta página dá o mapa; as páginas seguintes dão o passo a passo.
A pasta do projeto e a pasta do workspace
Duas coisas parecidas que não são a mesma:
- O git segue a pasta do projeto.
- Os arquivos seguem a pasta do workspace.
Um workspace é um nome e uma pasta; vários workspaces podem apontar para a mesma pasta. O painel Arquivos mostra a árvore do workspace selecionado, e é isso que determina o que você vê quando abre um arquivo.
O painel Arquivos
O painel Arquivos é a árvore do workspace:
- Pastas e arquivos em linhas, com expansão por pasta e estado de carregamento, vazio e erro.
- Barra de ações no topo, com recolher tudo, reler os arquivos, mostrar dotfiles, mostrar os ignorados pelo git e abrir em aplicativos externos.
- Menu de contexto por linha, com as ações do arquivo ou da pasta.
- Menu de contexto no vazio, para criar arquivo ou pasta na raiz.
A árvore é virtualizada: mesmo em repositórios grandes, ela desenha o que está à vista.
O editor
Abrir um arquivo abre uma aba de editor. O que aparece dentro da aba depende do tipo do arquivo:
| Tipo | O que você vê |
|---|---|
| Texto e código | Editor de código, com abas, busca, substituição e salvar |
| Markdown | Fonte, edição rica ou pré-visualização, com sumário e exportação |
| Imagem, PDF, CSV, notebook, Mermaid | Visualizador próprio, em geral somente leitura |
| Diff | Comparação lado a lado ou em linha |
O mesmo editor aparece em dois lugares: como aba e como painel lateral do Inspetor.
Diffs
Um diff compara o que está no disco com o que está no git — o arquivo antes e depois da sua alteração. Existem três formas de olhar para isso:
- Diff de um arquivo — o par original/modificado daquele arquivo.
- Diff combinado — todas as seções de uma vez, com árvore lateral para navegar.
- Modo Alterações — a própria aba de edição vira o diff, sem abrir uma aba separada.
Buscas
Há três buscas com alcances diferentes, e confundi-las é a fonte mais comum de resultado inesperado:
| Busca | Alcance |
|---|---|
| Filtrar por nome | Os nomes de arquivo e pasta da árvore |
| Buscar no conteúdo | O texto dentro dos arquivos do workspace |
| Ir para arquivo | Uma paleta que abre um arquivo pelo nome, com ranking |
O que é salvo e o que não é
- Autosave existe, mas não para todo tipo de aba: abas de diff combinado e de revisão de conflito não têm autosave.
- Alterações externas ao app interrompem o autosave e pedem decisão.
- Renomear move o arquivo; duplicar cria uma cópia; apagar remove. As três mexem no disco de verdade.