Progetti e URL

#Aggiungere un progetto

1. File → Apri cartella progetto… (⌘O / CtrlO), Aggiungi progetto nella barra laterale, oppure Aggiungi progetto… nel menu dei progetti della barra del titolo.
2. Scegli da dove viene il progetto:
   • Su questo computer: scegli una cartella.
   • Clona da GitHub / GitLab: scegli uno dei tuoi repository (elencati tramite il tuo accesso a gh o glab) o incolla un URL, scegli la cartella superiore, e Ferret lo clona e lo apre.
   • Apri tramite SSH: scegli un host da ~/.ssh/config. Il terminale e gli agent girano sulla macchina remota; le revisioni restano su questo computer.

Il nome predefinito è quello della cartella. Se aggiungi una cartella già registrata, viene semplicemente aperta (su macOS e Windows i percorsi sono confrontati senza distinguere maiuscole e minuscole). Dal menu della barra laterale puoi usare Rinomina su un progetto oppure Rimuovi dall'elenco. La rimozione non elimina mai la cartella.

I terminali si aprono nella cartella del progetto, e le revisioni vengono salvate in <project>/.ferret/.

#Salvare gli URL

1. Apri la pagina nel browser integrato.
2. Fai clic su + (Salva URL corrente) nella barra degli strumenti del browser. L'URL corrente è già compilato.
3. Inserisci un Nome e fai clic su Salva.

Sono accettati solo URL http:// e https://. Se lasci il nome suggerito, viene dedotto dall'host:

#Pannello dei target di revisione

In modalità Feedback, il pannello Target di revisione a destra elenca tutto ciò che puoi rivedere nel progetto attuale. Cambiare target non ferma la registrazione. Mostra o nascondi il pannello con Vista → Mostra/nascondi target di revisione (⌘⇧K / CtrlShiftK) oppure con Nascondi pannello.

• Target: gli URL salvati del progetto. Sotto ciascuno c'è un albero delle pagine che hai visitato su quel sito. I siti visitati ma non salvati compaiono come gruppi a sé.
• File: la cartella del progetto. Un file si apre come anteprima (Markdown e Mermaid renderizzati, altro testo in sola lettura), quindi puoi rivedere anche la documentazione. La matita (Apri nell'editor) lo apre nell'editor.

Filtra target filtra insieme target, pagine e file, con la stessa ricerca approssimata di Vai al file…. Nell'elenco, ↑ ↓ Enter oppure 1–9 cambiano target. Apri URL… apre un URL occasionale, e Salva negli URL del progetto lo conserva.

I target provengono da projects[].urls in settings.json (vedi l'esempio). Ogni voce richiede un url, un launchCommand (eseguito in un terminale, ad es. per avviare un'app desktop) oppure un windowMatch (la finestra da registrare). Scegliere un target finestra lo imposta come sorgente di registrazione, quindi non si può fare durante la registrazione. Le pagine visitate vengono ricordate per progetto, solo su questa macchina (fino a 200).

#Aprire e cambiare ambiente

Fai clic su un URL salvato per aprirlo. Se la pagina attuale è sotto un altro URL salvato, Ferret mantiene percorso, query e hash e cambia solo l'origine. Per esempio, su http://localhost:3000/pricing?plan=pro, un clic su prd apre https://example.com/pricing?plan=pro.

Il chip corrispondente alla pagina attuale (il prefisso più lungo) è evidenziato. Fai clic destro su un chip o usa la sua icona a forma di matita per modificarlo, oppure per rimuoverlo con Elimina. Quando un progetto si apre e non c'è un URL precedente, viene caricato il suo primo URL salvato.