Ferret verwenden

Projekte und URLs

Ein Projekt ist ein Ordner (meist das Stammverzeichnis Ihres Repositorys). Jedes Projekt hat eigene gespeicherte URLs, sodass lokal, Dev und Produktion nur einen Klick voneinander entfernt sind.

#Projekt hinzufügen

  1. Ablage → Projektordner öffnen … (⌘O / CtrlO), Projekt hinzufügen in der Seitenleiste oder Projekt hinzufügen … im Projektmenü der Titelleiste.
  2. Wählen Sie, woher das Projekt kommt:
    • Auf diesem Computer: Wählen Sie einen Ordner.
    • Von GitHub / GitLab klonen: Wählen Sie eines Ihrer Repositorys (aufgelistet über Ihre Anmeldung bei gh oder glab) oder fügen Sie eine URL ein und wählen Sie den übergeordneten Ordner. Ferret klont das Repository und öffnet es.
    • Über SSH öffnen: Wählen Sie einen Host aus ~/.ssh/config. Terminal und Agents laufen auf dem entfernten Rechner; die Reviews bleiben auf diesem Computer.

Als Name wird standardmäßig der Ordnername verwendet. Fügen Sie einen bereits registrierten Ordner hinzu, wird stattdessen dieser geöffnet (unter macOS und Windows werden Pfade ohne Beachtung der Groß-/Kleinschreibung verglichen). Über das Menü in der Seitenleiste können Sie ein Projekt Umbenennen oder Aus Liste entfernen. Beim Entfernen wird der Ordner nie gelöscht.

Terminals öffnen sich im Projektordner, und Reviews werden unter <project>/.ferret/ gespeichert.

#URLs speichern

  1. Öffnen Sie die Seite im integrierten Browser.
  2. Klicken Sie in der Browser-Werkzeugleiste auf + (Aktuelle URL speichern). Die aktuelle URL ist bereits eingetragen.
  3. Geben Sie einen Name ein und klicken Sie auf Speichern.

Es werden nur URLs mit http:// und https:// akzeptiert. Wenn Sie den vorgeschlagenen Namen übernehmen, wird er aus dem Host abgeleitet:

HostName
localhost, 127.*, ::1, 0.0.0.0, *.localhostlocal
enthält dev, develop, developmentdev
enthält stg, stage, stagingstg
alles andereprd
Gespeicherte URLs in der Browser-Werkzeugleiste

#Bereich „Review-Ziele“

Review-Ziele und Seiten wechseln, ohne die Aufnahme zu stoppen.

Im Feedback-Modus listet der Bereich Review-Ziele rechts alles auf, was Sie im aktuellen Projekt prüfen können. Ein Wechsel des Ziels stoppt die Aufnahme nicht. Blenden Sie den Bereich mit Darstellung → Review-Ziele ein/aus (⌘⇧K / CtrlShiftK) oder Bereich ausblenden ein und aus.

  • Ziele: die gespeicherten URLs des Projekts. Unter jeder steht ein Baum der Seiten, die Sie auf dieser Site besucht haben. Besuchte Sites, die nicht gespeichert sind, erscheinen als eigene Gruppen.
  • Dateien: der Projektordner. Eine Datei öffnet sich als Vorschau (Markdown und Mermaid gerendert, anderer Text schreibgeschützt), sodass Sie auch Dokumentation prüfen können. Der Stift (Im Editor öffnen) öffnet sie im Editor.

Ziele filtern filtert Ziele, Seiten und Dateien gemeinsam, mit derselben unscharfen Suche wie Gehe zu Datei …. In der Liste wechseln ↑ ↓ Enter oder 1–9 das Ziel. URL öffnen… öffnet eine einmalige URL, und In Projekt-URLs speichern behält sie.

Die Ziele stammen aus projects[].urls in settings.json (siehe das Beispiel). Jeder Eintrag braucht eine url, einen launchCommand (wird in einem Terminal ausgeführt, z. B. um eine Desktop-App zu starten) oder ein windowMatch (das aufzunehmende Fenster). Die Auswahl eines Fensterziels legt es als Aufnahmequelle fest und ist daher während einer Aufnahme nicht möglich. Besuchte Seiten werden pro Projekt gespeichert, nur auf diesem Rechner (bis zu 200).

#Umgebungen öffnen und wechseln

Klicken Sie auf eine gespeicherte URL, um sie zu öffnen. Liegt die aktuelle Seite unter einer anderen gespeicherten URL, behält Ferret Pfad, Query und Hash bei und tauscht nur den Origin aus. Ein Beispiel: Auf http://localhost:3000/pricing?plan=pro öffnet ein Klick auf prd die Adresse https://example.com/pricing?plan=pro.

Der Chip, der zur aktuellen Seite passt (längstes Präfix), ist hervorgehoben. Klicken Sie mit der rechten Maustaste auf einen Chip oder verwenden Sie sein Stiftsymbol, um ihn zu bearbeiten oder zu Löschen. Wird ein Projekt geöffnet und gibt es keine vorherige URL, wird seine erste gespeicherte URL geladen.

Bei der Übersetzung dieser Seite auf GitHub helfen (öffnet in einem neuen Tab)