Usando o Ferret

Editor e prévia

Abra e edite os arquivos do projeto e veja a prévia de Markdown e Mermaid. Uma prévia aberta no navegador integrado pode ser gravada e revisada como qualquer página web.

#Abrir e editar arquivos

  • Arquivos (a árvore de arquivos): ⌘⇧E / CtrlShiftE, com Filtrar por nome de arquivo, Atualizar e Recolher tudo.
  • Ir para arquivo…: ⌘P / CtrlP.
  • Salve com ⌘S / CtrlS. Ao fechar um arquivo modificado, aparece Salvar as alterações em <name>? com Salvar, Não salvar e Cancelar.
  • Se o arquivo mudar no disco enquanto você tem edições não salvas, escolha Recarregar do disco ou Manter minhas alterações.

O editor é o Monaco. Arquivos que não são texto abrem em um visualizador: imagens (com zoom; SVG também pode ser exibido como código), vídeo e áudio com barra de busca, PDF e, para qualquer outro arquivo binário, o tamanho e uma visualização hexadecimal dos primeiros bytes. Os visualizadores são somente leitura, e arquivos fora da pasta do projeto ou acessados por um link simbólico que sai dela não são exibidos.

#Criar, renomear e excluir arquivos

Trabalhe com os arquivos direto em Arquivos, como você faria no VS Code. Os nomes são digitados no próprio lugar, na árvore.

  • Novo arquivo / Nova pasta: os botões acima da árvore, ou clique com o botão direito em uma pasta (ou no espaço vazio abaixo da árvore). Um item novo vai para a pasta selecionada, ao lado do arquivo selecionado ou para a raiz do projeto. Um arquivo novo abre no editor.
  • Renomear: F2 / Enter / F2, ou clique com o botão direito. As abas abertas acompanham o novo nome e mantêm as edições não salvas.
  • Excluir: ⌘⌫ / Delete / Delete, ou clique com o botão direito. O Ferret pede confirmação e depois move o item para a Lixeira, então você pode restaurá-lo. As abas dos arquivos excluídos são fechadas; se alguma tinha edições não salvas, a confirmação avisa.
  • Selecione vários itens com ⌘ / Ctrl-clique ou ⇧ / Shift-clique para excluí-los juntos.
  • Esc cancela um nome que você está digitando.

O Ferret não sobrescreve um arquivo ou pasta existente com o mesmo nome e recusa tudo o que sairia da pasta do projeto (.., caminhos absolutos, links simbólicos que apontam para fora), qualquer coisa dentro de .git e nomes que algum sistema operacional não aceita: / \ < > : " | ? *, caracteres de controle, espaço ou ponto no final e nomes reservados do Windows, como CON ou NUL.

#Prévia de Markdown e Mermaid

A prévia funciona para .md, .markdown, .mdx, .mmd e .mermaid. O Mermaid vem embutido no app, então os diagramas são renderizados offline.

  • Abrir prévia ao lado: ao lado do editor
  • Abrir prévia: no navegador integrado (ade-preview://), para que você possa gravá-la e revisá-la

#Revisar documentos gravando

  1. Abra um arquivo Markdown e clique em Abrir prévia.
  2. Grave normalmente. Comente a especificação ou o documento de design e circule o que está errado.
  3. Pare. Os apontamentos fazem referência ao caminho do arquivo relativo ao projeto, em vez de uma URL.
  4. Use Enviar ao Agent para que o documento seja corrigido.
Prévia de Markdown no navegador integrado
Prévia de Markdown no navegador integrado

Ajude a traduzir esta página no GitHub (abre em uma nova aba)