Работа с Ferret

Редактор и предпросмотр

Открывайте и редактируйте файлы проекта, просматривайте Markdown и Mermaid. Предпросмотр, открытый во встроенном браузере, можно записывать и проверять, как любую веб-страницу.

#Открытие и редактирование файлов

  • Файлы (дерево файлов): ⌘⇧E / CtrlShiftE, с кнопками Фильтр по имени файла, Обновить и Свернуть все.
  • Перейти к файлу…: ⌘P / CtrlP.
  • Сохранение — ⌘S / CtrlS. При закрытии изменённого файла появится вопрос Сохранить изменения в <name>? с кнопками Сохранить, Не сохранять и Отменить.
  • Если файл изменился на диске, пока у вас есть несохранённые правки, выберите Загрузить с диска или Оставить мои изменения.

Редактор — Monaco. Нетекстовые файлы открываются в просмотрщике: изображения (с масштабированием; SVG можно также показать как код), видео и аудио с полосой перемотки, PDF, а для любого другого двоичного файла — его размер и шестнадцатеричное представление первых байтов. Просмотрщики работают только для чтения; файлы вне папки проекта или доступные через символическую ссылку, ведущую за её пределы, не показываются.

#Создание, переименование и удаление файлов

Работайте с файлами прямо в разделе Файлы, как в VS Code. Имена вводятся прямо в дереве.

  • Новый файл / Новая папка: кнопки над деревом или щелчок правой кнопкой по папке (или по пустому месту под деревом). Новый элемент создаётся в выбранной папке, рядом с выбранным файлом или в корне проекта. Новый файл открывается в редакторе.
  • Переименовать: F2 / Enter / F2 или щелчок правой кнопкой. Открытые вкладки получают новое имя и сохраняют несохранённые правки.
  • Удалить: ⌘⌫ / Delete / Delete или щелчок правой кнопкой. Ferret сначала спрашивает подтверждение, затем перемещает элемент в Корзину, откуда его можно восстановить. Вкладки удалённых файлов закрываются; если в каких-то из них были несохранённые правки, об этом сказано в подтверждении.
  • Выберите несколько элементов с помощью ⌘ / Ctrl-щелчка или ⇧ / Shift-щелчка, чтобы удалить их вместе.
  • Esc отменяет ввод имени.

Ferret не перезаписывает существующий файл или папку с тем же именем и отклоняет всё, что выходит за пределы папки проекта (.., абсолютные пути, символические ссылки, указывающие наружу), всё внутри .git, а также имена, которые недопустимы в какой-либо ОС: / \ < > : " | ? *, управляющие символы, пробел или точка в конце и зарезервированные имена Windows, например CON или NUL.

#Предпросмотр Markdown и Mermaid

Предпросмотр работает для .md, .markdown, .mdx, .mmd и .mermaid. Mermaid входит в состав приложения, поэтому диаграммы отображаются без подключения к сети.

  • Открыть предпросмотр сбоку: рядом с редактором
  • Предпросмотр: во встроенном браузере (ade-preview://), чтобы его можно было записать и проверить

#Ревью документов с помощью записи

  1. Откройте файл Markdown и нажмите Предпросмотр.
  2. Записывайте как обычно. Проговорите спецификацию или дизайн-документ и обведите то, что неверно.
  3. Остановите запись. Вместо URL замечания ссылаются на путь к файлу относительно проекта.
  4. Нажмите Отправить агенту, чтобы документ исправили.
Предпросмотр Markdown во встроенном браузере
Предпросмотр Markdown во встроенном браузере

Помочь с переводом этой страницы на GitHub (откроется в новой вкладке)