Gerenciamento de Área de Trabalho
Uma área de trabalho no VMark é uma pasta aberta como raiz do seu projeto. Quando você abre uma área de trabalho, a barra lateral mostra uma árvore de arquivos, a Abertura Rápida indexa todos os arquivos markdown, o terminal inicia na raiz do projeto e as abas abertas são lembradas para a próxima vez.
Sem uma área de trabalho, você ainda pode abrir arquivos individuais, mas perde o explorador de arquivos, a pesquisa no projeto e a restauração de sessão.
Abrindo uma Área de Trabalho
| Método | Como |
|---|---|
| Menu | Arquivo > Abrir Área de Trabalho |
| Abertura Rápida | Mod + O, depois selecione Navegar... no final |
| Arrastar e soltar | Arraste um arquivo markdown do Finder para a janela — o VMark detecta sua raiz de projeto e abre a área de trabalho automaticamente |
| Áreas de Trabalho Recentes | Arquivo > Áreas de Trabalho Recentes e escolha um projeto anterior |
Quando você abre uma área de trabalho, o VMark mostra a barra lateral com o explorador de arquivos. Se a área de trabalho foi aberta antes, as abas abertas anteriormente são restauradas.
TIP
Se a janela atual tiver alterações não salvas, o VMark oferece abrir a área de trabalho em uma nova janela em vez de substituir seu trabalho.
Explorador de Arquivos
O explorador de arquivos aparece na barra lateral sempre que uma área de trabalho estiver aberta. Ele mostra uma árvore de arquivos markdown com raiz na pasta da área de trabalho.
Navegação
- Clique único em uma pasta para expandi-la ou colapsá-la
- Duplo clique ou Enter em um arquivo para abri-lo em uma aba
- Arquivos que não são markdown abrem com o aplicativo padrão do sistema
Operações de Arquivo
Clique com o botão direito em qualquer arquivo ou pasta para acessar o menu de contexto:
| Ação | Descrição |
|---|---|
| Abrir | Abrir o arquivo em uma nova aba |
| Renomear | Editar o nome do arquivo ou pasta inline (também F2) |
| Duplicar | Criar uma cópia do arquivo |
| Mover Para... | Mover o arquivo para uma pasta diferente via diálogo |
| Excluir | Mover o arquivo ou pasta para a lixeira do sistema |
| Copiar Caminho | Copiar o caminho absoluto do arquivo para a área de transferência |
| Revelar no Finder | Mostrar o arquivo no Finder (macOS) |
| Novo Arquivo | Criar um novo arquivo markdown neste local |
| Nova Pasta | Criar uma nova pasta neste local |
Você também pode arrastar e soltar arquivos entre pastas diretamente na árvore.
Alternâncias de Visibilidade
Por padrão, o explorador mostra apenas arquivos markdown e oculta dotfiles. Duas alternâncias mudam isso:
| Alternância | Atalho | O que faz |
|---|---|---|
| Mostrar Arquivos Ocultos | Mod + Shift + . (macOS) / Ctrl + H (Win/Linux) | Revela dotfiles e pastas ocultas |
| Mostrar Todos os Arquivos | (Configurações ou menu de contexto) | Mostra arquivos que não são markdown junto com seus documentos |
Ambas as configurações são salvas por área de trabalho e persistem entre sessões.
Pastas Excluídas
Certas pastas são excluídas da árvore por padrão:
.gitnode_modules
Esses padrões são aplicados quando uma área de trabalho é aberta pela primeira vez.
Abertura Rápida
Pressione Mod + O para abrir a sobreposição de Abertura Rápida. Ela fornece pesquisa fuzzy em três fontes:
- Arquivos recentes que você abriu antes
- Abas abertas na janela atual (marcadas com um indicador de ponto)
- Todos os arquivos markdown na área de trabalho
Digite alguns caracteres para filtrar — a correspondência é fuzzy, então rme encontra README.md. Use as teclas de seta para navegar e Enter para abrir. Uma linha Navegar... fixada na parte inferior abre um diálogo de arquivo.
| Ação | Atalho |
|---|---|
| Abrir Abertura Rápida | Mod + O |
| Navegar resultados | Cima / Baixo |
| Abrir arquivo selecionado | Enter |
| Fechar | Escape |
TIP
Sem uma área de trabalho, a Abertura Rápida ainda funciona — ela mostra arquivos recentes e abas abertas, mas não consegue pesquisar a árvore de arquivos.
Áreas de Trabalho Recentes
O VMark lembra até 10 áreas de trabalho abertas recentemente. Acesse-as em Arquivo > Áreas de Trabalho Recentes na barra de menus.
- As áreas de trabalho são ordenadas por hora da última abertura (mais recente primeiro)
- A lista sincroniza com o menu nativo a cada alteração
- Escolha Limpar Áreas de Trabalho Recentes para redefinir a lista
Configurações de Área de Trabalho
Cada área de trabalho tem sua própria configuração que persiste entre sessões. As configurações são armazenadas no diretório de dados do aplicativo VMark — não dentro da pasta do projeto — para que sua área de trabalho permaneça limpa.
As seguintes configurações são salvas por área de trabalho:
| Configuração | Descrição |
|---|---|
| Pastas excluídas | Pastas ocultas do explorador de arquivos |
| Mostrar arquivos ocultos | Se os dotfiles são visíveis |
| Mostrar todos os arquivos | Se arquivos que não são markdown são visíveis |
| Últimas abas abertas | Caminhos de arquivo para restauração de sessão na próxima abertura |
TIP
A configuração da área de trabalho está vinculada ao caminho da pasta. Abrir a mesma pasta na mesma máquina sempre restaura suas configurações, mesmo de uma janela diferente.
Restauração de Sessão
Quando você fecha uma janela que tem uma área de trabalho aberta, o VMark salva a lista de abas abertas na configuração da área de trabalho. Da próxima vez que você abrir a mesma área de trabalho, essas abas são restauradas automaticamente.
- Apenas abas com um caminho de arquivo salvo são restauradas (abas sem título não são persistidas)
- Se um arquivo foi movido ou excluído desde a última sessão, ele é silenciosamente ignorado
- Os dados de sessão são salvos no fechamento da janela e no fechamento da área de trabalho (Arquivo > Fechar Área de Trabalho)
Múltiplas Janelas
Cada janela do VMark pode ter sua própria área de trabalho independente. Isso permite trabalhar em múltiplos projetos simultaneamente.
- Arquivo > Nova Janela abre uma janela nova
- Abrir uma área de trabalho em uma nova janela não afeta outras janelas
- O tamanho e a posição da janela são lembrados por janela
Quando você arrasta um arquivo markdown do Finder e a janela atual já tem trabalho não salvo, o VMark abre o projeto do arquivo em uma nova janela automaticamente.
Integração com Terminal
O terminal integrado usa automaticamente a raiz da área de trabalho como seu diretório de trabalho. Quando você abre ou alterna áreas de trabalho, todas as sessões do terminal fazem cd para a nova raiz.
A variável de ambiente VMARK_WORKSPACE é definida como o caminho da área de trabalho em cada sessão do terminal, para que seus scripts possam referenciar a raiz do projeto.