Abas de Documento e Navegador

As abas do painel central não são apenas terminais. Este capítulo trata de outros dois tipos: as abas de documento (o editor de Markdown e de código integrado) e as abas de navegador (páginas da web incorporadas). Elas compartilham a barra de abas com as abas de sessão, e abrir uma sessão nunca as substitui.

1. Abas de documento

1.1 Abertura

Uma aba de documento é aberta quando você:

• executa vopen <file> em qualquer sessão (no Claude Code, a habilidade /vopen faz o mesmo depois que as "Vela Skills" são instaladas em Configurações ▸ Geral);
• clica duas vezes em um arquivo na aba Arquivos do painel direito ou escolhe "Abrir no editor";
• abre uma nota da base de conhecimento (consulte Bases de Conhecimento Locais);
• clica em "Novo documento" na extremidade direita da barra de abas.

A visualização é escolhida conforme o tipo de arquivo:

1.2 O editor Markdown

• Visual é um editor WYSIWYG, que mostra o documento já formatado enquanto você escreve. Digite / para abrir o menu de inserção (títulos, listas, listas de tarefas, citações, blocos de código, tabelas, fórmulas matemáticas, imagens e divisores). Os blocos de código delimitados do tipo mermaid são renderizados como diagramas abaixo do bloco.
• Código-fonte mostra o texto do arquivo exatamente como está armazenado, incluindo qualquer front matter YAML, com realce de sintaxe Markdown.
• Comparação mostra Visual e Código-fonte lado a lado e mantém os dois sincronizados enquanto você edita qualquer um deles.
• ⌘/ (Ctrl+/ no Windows e no Linux) alterna entre Visual e Código-fonte. Trocar de modo sem editar não altera o arquivo.
• Colar ou arrastar uma imagem para um documento salvo armazena a imagem em uma pasta assets ao lado do documento e insere um link relativo para ela.

1.3 Edição e salvamento

• ⌘S ou o botão "Salvar" grava o arquivo no disco. Um ponto na aba indica alterações não salvas.
• O documento ativo verifica o disco a cada dois segundos. Se outro programa alterar o arquivo, uma faixa oferece "Recarregar" e "Ignorar"; se você também tiver edições não salvas, o botão de recarregar passa a exibir "Recarregar (descartar minhas alterações)". Se o arquivo tiver mudado no disco depois que você começou a editar, o salvamento pede uma confirmação na caixa de diálogo "Conflito ao salvar" antes de sobrescrever o arquivo.
• Ao fechar uma aba com alterações não salvas, você escolhe entre "Salvar e fechar", "Fechar sem salvar" e "Cancelar".
• ⌘F abre a barra de busca com localizar, substituir, substituir tudo e "Diferenciar maiúsculas"; ela funciona da mesma forma em todos os modos.
• O botão "Barra lateral" mostra a "Estrutura" do documento e uma "Árvore de arquivos" da pasta dele; clique em um arquivo ali para abri-lo. A barra lateral pode ser redimensionada.
• Arquivos com mais de 10 MB abrem somente para leitura e mostram apenas os primeiros 10 MB, para que o salvamento não corte o restante do arquivo.
• Clicar com o botão direito em uma aba de documento oferece "Recarregar arquivo" e, para Markdown, "Exportar PDF", além das ações habituais de fechar.

1.4 Novos documentos e exportação para PDF

• "Novo documento" abre um rascunho vazio que ainda não está no disco e não aparece na árvore do projeto. O primeiro salvamento pergunta onde guardá-lo: o aplicativo desktop usa a caixa de diálogo Salvar como do sistema, e os clientes de navegador e as janelas de conexão remota mostram uma caixa de diálogo Salvar como para a máquina que executa a sessão. O realce de sintaxe segue o nome de arquivo escolhido. Clicar com o botão direito na aba de um rascunho também oferece "Salvar no disco…".
• "Exportar PDF" converte um documento Markdown em um PDF vetorial com quebras de página automáticas e fontes CJK incorporadas. O aplicativo desktop pergunta onde salvar o arquivo; os clientes de navegador fazem o download dele.

2. Abas de navegador (somente no aplicativo desktop)

As abas de navegador mostram páginas da web reais dentro do VelaTerm, o que é útil para manter documentação, páginas de issues ou uma pré-visualização local ao lado das suas sessões. Elas estão disponíveis apenas no aplicativo desktop, e não nos clientes de navegador, nas janelas de conexão remota nem no layout para dispositivos móveis.

Como abrir uma aba de navegador:

• o botão "Navegador integrado" na extremidade direita da barra de abas;
• o atalho ⌘⇧B;
• vopen <URL> em uma sessão;
• "Nova página de navegador" no menu de contexto de um projeto ou grupo na barra lateral.

Barra de ferramentas: "Voltar", "Avançar", "Recarregar" (ou "Parar o carregamento" enquanto uma página carrega), uma barra de endereço ("Digite uma URL ou termos de busca"; um texto que não é endereço é pesquisado no Google), "Abrir no navegador do sistema" e uma linha de "Acesso rápido" com ChatGPT, Claude, Gemini e Google.

Duas formas:

• Aba de navegador: aberta pelo botão, por ⌘⇧B ou por vopen <URL>. Ela não é salva na árvore do projeto e não é mantida após uma reinicialização.
• Nó de página de navegador: criado com "Nova página de navegador". É um nó na árvore do projeto que memoriza o endereço e continua lá após uma reinicialização.

Links que abrem novas janelas: quando uma página abre um link em uma nova janela (por exemplo, um link target="_blank"), o VelaTerm o abre em uma nova aba de navegador.

Páginas independentes: o botão "Central de jogos" na extremidade direita da barra de abas abre a central de jogos do VelaTerm como uma página independente. Uma página independente não tem barra de endereço nem linha de acesso rápido, apenas "Voltar", "Avançar" e "Recarregar"; os links que ela abre permanecem na mesma aba.

Limite de segurança: uma página incorporada é tratada como um site externo comum. Ela não recebe nenhuma permissão nem credencial do VelaTerm, e apenas endereços http e https podem ser abertos.

3. Como os tipos de aba convivem

• As abas de sessão, de documento e de navegador compartilham uma única barra de abas, e ⌘1–9 alterna entre todas elas.
• Abrir uma sessão pela árvore reutiliza apenas abas de sessão; as abas de documento e de navegador nunca são substituídas.
• As abas de documento e de navegador não podem ser divididas. ⌘W as fecha diretamente (um documento com alterações não salvas pergunta antes).